fix: 固化 Workbench Trace 可读性探针

This commit is contained in:
Codex
2026-07-10 18:00:24 +02:00
parent 92686ff213
commit b6f5e5efd4
21 changed files with 1378 additions and 16 deletions
+9
View File
@@ -47,6 +47,15 @@ description: UniDesk Web 开发与浏览器验证技能。用户处理 UniDesk/H
- 切换原始事件标签不得新建第二条产品 EventSource
- 旧 UI 缺少新 DOM 合同时保持明确的 `legacy-ui` 兼容证据。
- `observe analyze` 的 archive/history findings 可能包含旧样本或旧规则误判;关闭用户入口问题前同时核对最新 sample 字段、DOM 几何和截图。若 top-level findings、latest sample 和 archive red 冲突,说明冲突并补工具反馈 issue,不要只凭 archive red 或单张截图下结论。
- Workbench 产品 Trace 可读性验收使用 `observe command --type validateWorkbenchTraceReadability`
- 开关、运行卡片等待、展开、轮询和 DOM 稳定窗口全部来自独立 owning YAML
- 只在 `#conversation-list` 内定位当前产品 `WorkbenchMessageCard`
- 明确排除隔离 Kafka debug panel,禁止把隔离卡片行计入产品 Trace;
- 必须先命中新运行卡片并按合法 traceId 固定定位,禁止回退旧终态卡片;
- 在命令点击展开前记录 `openBefore` 与默认运行中可读性;
- 命令可展开卡片补充诊断,但不得把强制展开后的可读性冒充默认通过;
- 非窗口化 Trace 用行身份重叠验证保留;窗口化 Trace 用 event count 与 source sequence 边界前进验证;
- 同一命令等待终态并输出 report SHA 与 screenshot SHA,失败时仍保留已采集阶段证据。
## 高频工作流
@@ -15,3 +15,12 @@
- 原始事件标签必须复用同页产品 EventSource,切换标签不得新增产品 SSE 请求;
- 旧 UI 缺少新 DOM 合同时报告 `legacy-ui`,不伪造新合同;
- 禁止通过 URL/IP 或一次性脚本替代该命令。
- Workbench 产品 Trace 可读性规则:
- 使用 `observe command --type validateWorkbenchTraceReadability`
- 功能开关与全部等待/轮询/稳定窗口由独立 owning YAML 提供;
- 命令只读取 `#conversation-list` 内的当前产品卡片,排除隔离 debug panel
- 只接受新运行卡片,命中后按 traceId 固定定位,不回退旧终态卡片;
- 报告必须区分命令前默认展开状态和命令驱动展开状态;
- 默认运行中可读、source-authority 行和终态保留必须分别成立;
- 窗口化 Trace 以 event count 和 source sequence 边界前进替代可见行身份交集;
- 失败仍保留有界 DOM 诊断、report SHA 和 screenshot SHA。