droboticflow/docs/review-problem-flow-validation-2026-09-23.md
2026-09-23 07:14:56 +08:00

7.1 KiB
Raw Permalink Blame History

审查批注流程修订验证报告(2026-09-23)

状态:整合验证完成。规格:.scratch/review-problem-flow/spec.md;说明书:review-workspace-guide.zh-CN.md。产品最终基线:根 1a0b2fe9(含 02 编辑器 + 9c349944/da3c19cc 修复、03 c8aa7300/7310d6a1)。本报告只记录实际运行结果。

环境

  • 本地隔离 API http://127.0.0.1:3013,数据库 review_pi_integration_20260923;写入仅限 project-review-focused-20260922。
  • Vite 5195(VITE_DEV_API_BASE_URL=http://127.0.0.1:3013,__VITE_ADDITIONAL_SERVER_ALLOWED_HOSTS=review-session.test);Edge 无头 --no-proxy-server;1413×615(专注)/1413×1000(普通)。
  • 夹具 local-data/verification/review-focused-20260922;原始输出与全量日志在同目录及 logs-05/。
  • 基线提交 25ccd0bc;既有失败基线:前端 13 项(upstream-baseline-frontend-failures.txt,14 行名称)、Go 107 叶子。

场景矩阵(实际运行)

# 场景 覆盖 结果
1 F→范围→Enter→文本→Ctrl+Enter;保存后输入空且只读、焦点回工作台、Space 可用 review-problem-workflow.mjs S1,两角色×普通/专注 ✅ PASS
2 同对象第二次 F 独立第二条;API 回读两条、首次保存顺序;刷新保持 S2 ✅ PASS
3 回查(Ctrl+↑/↓、点击)不自动编辑;Enter 改旧条身份不变、不换位、不影响同对象另一条 S3 ✅ PASS
4 输入框内 Ctrl+↑/↓ 文字导航、Shift+Delete 不触发删除 S4 ✅ PASS
5 Shift+Delete:Esc 取消无变更;确认即删一条并回读;鼠标“删除选中问题”同路径 S5 ✅ PASS
6 Esc 覆盖范围选择/新增输入/旧条编辑;脏文字按 F → 保存并继续/放弃文字/继续编辑守卫,放弃后进入新捕获 S6 ✅ PASS(02 修复后)
7 未保存文字时播放/点击视频/拖时间轴/切片动作导航/回查:文字保留、保存目标仍是 F 捕获帧 S7 ✅ PASS
8 空白 Ctrl+Enter 不保存不发请求;IME 候选/自动重复不产生写入 S8 ✅ PASS
9 迟到写入:处理中 Esc 可退出、不二次发送;迟到成功不抢焦点;迟到失败提供“恢复未保存内容”恢复原文;同操作原样重放返回 200 且不重复建条 S9;review-draft-latency.mjs 两角色 ✅ PASS
10 整体问题 viewAnchor:质检 capture-seconds;终审 slice-seconds、按聚合来源隔离;跨成员点击回查回到原来源画面 S10 ✅ PASS(02 修复后)
11 无“原始记录 JSON”入口;无“无效动作”旧文案 S11;另见 review-captions 行 ✅ PASS
12 主动进入自动连续审查一次等 03 行为 review-automatic-entry.mjs(真实 API + 浏览器) ✅ PASS:质检 10 项、终审 5 项;夹具重置后无新增启动
13 正式决定门禁/接管/版本校验不回退 review-session.mjs 两角色、review-decision-confirmation.mjs、review-focus-layout.mjs ✅ PASS;recovery 见下行说明
14 1413×615 左/右/双目截图 + 每相机字幕几何断言 review-camera-captions.mjs 四组合 ✅ PASS + K3 读图

浏览器套件明细(本 worktree 实际运行,日志在 logs-05/)

  • review-problem-workflow.mjs:quality ordinary/focus、acceptance ordinary/focus 全 PASS(主代理复核的最终日志同结论)。暴露并由 02 修复两个产品缺陷:脏文字守卫“放弃文字”后新 F 捕获不继续(9c349944 修复);终审跨成员整体问题回查忽略 viewAnchor(同修复)。修复后矩阵无豁免项。
  • review-camera-captions.mjs(新,自有):4/4 PASS。显式期望 专注 左1/右1/双2;普通质检双路、普通终审左单路(实测稳定行为)。每路字幕必须在自身画面内水平居中且贴近底部。重拍截图 K3 读图:problem-workflow-acceptance-focus-both.png 现为两路两字幕(先前单字幕截图为 ResizeObserver 重排前瞬态,非产品缺陷);quality-focus-both、quality-ordinary 布局整洁、无 JSON、文案正确。
  • review-drafts.mjs:quality、acceptance PASS(保存/回读/刷新/目标范围/未保存守卫/失败保留/接管文字保留,已按新契约更新 F 入口与只读回查)。
  • review-draft-latency.mjs:quality、acceptance PASS(迟到回读围栏、接管围栏、未知结果核对后保存、写入串行)。
  • review-session.mjs:两角色 PASS(普通 HTTP、接管、旧页/缺头 409 围栏)。
  • review-decision-confirmation.mjs:PASS(确认/取消/单次提交)。
  • review-decision-recovery.mjs:本轮未通过(夹具限制,非产品回归)。默认 qc-09 已被确认套件消耗(accepted);改用 qc-02 后服务器正确拒绝重复正式决定 409 quality_review_already_submitted(门禁保持,未弱化);qc-03/04 未领取而脚本无领取路径。2026-09-22 基线证据 review-decision-recovery.json 尚存,本轮不声称通过。
  • review-captions.mjs:本轮未通过(环境/旧 harness)。组件 harness 页 10 秒内未完成渲染(模块均 200、无页面错误,Vite 冷转换可疑);无 JSON/无效片段契约已由 workflow S11 真实页面断言覆盖。

完整套件(主代理在根 1a0b2fe9 运行,结果照录)

  • npx tsc --noEmit PASS;npm run build(Vite+Go)PASS(仅既有 chunk 体积警告)。
  • 前端 node --test tests/frontend/*.test.mjs:609 总 / 596 通过 / 13 失败;与基线名称集比较 newFailures=[](基线文件 14 名称中 theme utilities 一项不再失败)。证据:根 logs final-frontend-comparison.json、final-frontend.tap。
  • Go(仅跟踪包)go test -json ./cmd/... ./internal/...:107 叶子失败 = 基线 107,newFailures=[]、missingBaseline=[](仅归一化自动生成供应商默认组织 hex 后缀);失败包 internal/api、internal/worker。证据:根 logs final-go-comparison.json、final-go-tracked.jsonl。./... 初次运行的构建失败来自未跟踪 local-data 公司旧脚本,非产品回归。

截图清单(已产出并 K3 读图核查)

  • problem-workflow-{quality,acceptance}-focus-{left,right,both}.png(1413×615,字幕几何断言后置拍摄)
  • problem-workflow-{quality,acceptance}-ordinary.png(1413×1000)

截图为布局证据;行为结论以浏览器断言与公开 API 回读为准。

执行记录

  • 2026-09-23 准备:说明书、本报告骨架、workflow 重写、旧测试契约更新(提交 6d01e1cf)。
  • 2026-09-23 整合运行:上述实测结果;两个 02 缺陷暴露→修复→复测通过;环境处理(Vite allowedHosts、普通 HTTP 主机名、字幕瞬态)。未运行完整套件(主代理已在根完成并照录于此)。
  • 03 入口浏览器票已在整合根版本重跑通过;review-decision-recovery 本轮仍因默认夹具已被确认套件消耗而未通过,重复正式决定正确返回 409,未弱化门禁。后续若需重跑,应准备新的未消耗夹具。