docs: refine workbench probe projection guidance

.agents/skills/unidesk-webdev/SKILL.md

@@ -46,6 +46,7 @@ bun scripts/cli.ts hwlab nodes web-probe script --node D601 --lane v03 <<'JS'
 export default async ({ page, gotoStable, screenshot, fetchJson, fetchApiMatrix, recordStep, safeEvaluate }) => {
   await page.route('**/v1/agent/conversations**', route => setTimeout(() => route.continue(), 1000));
   await gotoStable('/workbench');
+  const workspaceResponse = await fetchJson('/v1/workbench/workspace?projectId=prj_hwpod_workbench');
   const apiMatrix = await fetchApiMatrix([
     '/v1/workbench/workspace?projectId=prj_hwpod_workbench',
     '/auth/session'
@@ -53,7 +54,8 @@ export default async ({ page, gotoStable, screenshot, fetchJson, fetchApiMatrix,
   recordStep('workbench-ready', { url: page.url(), apiMatrixOk: apiMatrix.ok });
   return {
     url: page.url(),
-    workspace: await fetchJson('/v1/workbench/workspace?projectId=prj_hwpod_workbench'),
+    workspaceOk: workspaceResponse.ok,
+    workspace: workspaceResponse.body,
     screenshot: await screenshot('workbench.png')
   };
 };
@@ -65,7 +67,7 @@ JS
 - `web-probe script` 不运行默认探针，必须通过 stdin heredoc 或 `--script-file <path>` 提供脚本；只需要 repo-owned 标准 DOM probe 时使用 `web-probe run`。
 - web-probe 由 UniDesk CLI 从 YAML 声明的 bootstrap admin sourceRef 读取凭据并建立同源 `hwlab_session`；脚本不得自行读取、打印或复制 Web 登录凭据、cookie、token 或完整 API key。
 - 脚本构造 URL 时使用 `new URL(path, baseUrl).toString()`；不要拼出 `//v1/...`。
-- 先通过 `gotoStable`、`waitWorkbenchReady` 或等价导航进入目标 origin，再用 `fetchJson` 读同源 API；不要在 `about:blank` 上请求 `/v1/...`。
+- 先通过 `gotoStable`、`waitWorkbenchReady` 或等价导航进入目标 origin，再用 `fetchJson` 读同源 API；不要在 `about:blank` 上请求 `/v1/...`。`fetchJson` 返回包装对象 `{ ok, status, body, failureKind, ... }`，业务字段必须从 `.body` 读取，并同时记录 `ok/status/failureKind`；如果返回 `status=0` 且页面还不是目标 origin，先按 probe 脚本误用处理，不要归因成 Cloud API 或 Workbench 投影失败。
 - Workbench 有 SSE/长轮询时不要用 `networkidle` 判断通过；用明确 DOM/API 条件，如 final URL、route conversationId、active tab、message card、trace row 或 workspace `selectedConversationId`。
 - Playwright `page.evaluate` 只能传一个可序列化参数；多个值包成对象，或用 `safeEvaluate(fn, { a, b })`。
 - `safeEvaluate` 返回结构化包装对象；脚本断言前必须解包，例如 `const evaluated = await safeEvaluate(...); const dom = evaluated?.value ?? evaluated;`。`recordStep` 可以记录包装对象用于诊断，但行为断言不要直接读包装对象的业务字段，避免把已通过的 DOM 误判成 `undefined`。
@@ -113,6 +115,7 @@ Workbench 至少覆盖：
 ## Workbench 判定口径
 
 - Workbench API 的 GET 路径不是修复入口。若 session/messages/turn/trace 出现状态不一致，应登记为投影唯一性或投影延迟问题，修 backend projector/read model；不得用前端轮询、session 切换、reload、read-through sync 或 GET 内部修复把问题掩盖。
+- Workbench durable projection 验收必须覆盖同一 session/trace 的 list、detail、messages、turn、trace events 和 DOM session tab/message card；尤其要用 fresh browser 或 runtime 重启后的历史 terminal 样本证明 read model 能从 durable trace events 恢复终态。若内存 trace 仍显示 running 而 durable trace 已 terminal，应修唯一 read model 的投影对象，不得在 GET handler、前端 reducer 或 probe 脚本里做临时状态仲裁。
 - Session rail 会话集合只消费 `/v1/agent/conversations`；当前 conversation 消息本体只消费 `/v1/agent/conversations/{conversationId}`；turn 状态只消费 `/v1/agent/turns/{traceId}`；trace 阅读只消费 trace event page/result snapshot。不要让 workspace snapshot、列表摘要、localStorage、trace polling 或 result polling 互相覆盖。
 - 空消息 session 回收验收必须同时证明：未超过 TTL 的空 session 保留，有消息、running/admitting、terminal result 或 active trace 的 session 不被回收；超过 TTL 的空 idle session 由后端 GC 归档/删除后，rail/list/detail/messages/deep link 都按同一 canonical lifecycle 状态表现。
 - UI transient state 只保存 route、显式选择、composer draft、scroll、展开状态和临时交互状态；服务端事实进入 server-state/reducer/projection。