W03/W04 独立审查(Qwen)
- 日期:2026-11-17;审查人:Qwen(/root/qwen_report_review,只读审查)
- 范围:W01/W02 审查后的增量改动(App.tsx Demo 守卫与文案、SiteChrome.tsx、PrivacyPolicy.tsx 锚点、styles.css 响应式、两页 favicon、index.html)+ 证据 w03-w04-browser-check.json 与 4 张截图。
- 结论:可以与 W01/W02 一起提交(同意父会话建议:共享 App.tsx/SiteChrome,分开提交反而要拆 hunk)。W01/W02 的 A1/A2/A4 确认已修;本批无阻塞问题,1 项低危视觉建议、1 项提交操作注意(见 B3,重要)。
一、验收核对
| 检查项 | 结果 | 依据 |
|---|---|---|
| A1 复查:Demo 内部备忘删除 | 通过 | App.tsx:204 现为"演示在浏览器内用本地规则模拟字段匹配,不上传任何输入;扩展的真实填写由你配置的模型服务完成";全仓无"借鉴同类工具站/后续可接后端"残留 |
| A2 复查:privacy 页 #top 锚点 | 通过 | PrivacyPolicy.tsx:13 <span id="top" />;证据 privacyTopAnchor=1 |
| A4 复查:favicon | 通过 | 两页 <link rel="icon" href="/icon/128.png">;website/public/icon/128.png 与扩展 public/icon/128.png SHA256 一致(复用属实);dist/icon/128.png 已产出,finalLayoutPass httpFailures=[] |
| Demo 竞态守卫 | 通过 | handleDemoFill 快照 prompt+递增 runId,await 后 runId !== runIdRef.current 即丢弃;handleExampleClick/clearDemo 均递增 runId、重置 pending/formValues/filledKeys/trace;提交按钮 disabled={pending};结果 {...EMPTY_FORM, ...result.values} 整体替换,杜绝跨示例混主体。证据四项断言 invoiceHasNoStaleSubject / submitDisabledWhilePending / clearStaysEmpty / switchCancelsPending 全 true,且记录了先复现三缺陷(发票混入张三手机号/职位、pending 重复提交、清空后回写)再修复的顺序 |
| 响应式零溢出 | 通过 | finalLayoutPass:9 断点 320–1440 scrollWidth==viewport、overflowing=[]、navVisible 全 true;privacy 4 断点同过。styles.css 核对:grid 子项 min-width:0、断点列 minmax(0,1fr)、atlas 装饰 inset 右侧改 0、长邮箱/clone 命令 overflow-wrap:anywhere、720 下导航保留为第三行。我目验 w04-home-390 / w04-privacy-390 / w04-home-1061 截图与数据一致 |
| axe 可访问性 | 通过 | 修前 home/privacy 各 1 项 label-content-name-mismatch(.brand),修后 accessibilityFinal 两页 0 violations(40/27 passes)。修法正确:删除与可见文本不符的 aria-label,让可见文本充当名称。brand-mark “F” 恢复计入可访问名称(“F FormFill AI form operator”),可见文本包含关系成立,比 aria-hidden 方案更稳妥 |
| 键盘入口 | 通过 | firstTabFocus=“跳到主要内容”(skip-link),两页均有 |
| 扩展不受影响 | 通过(见 B3) | 本批网站+已审 popup 改动范围内,我复跑 vitest:既有 8 文件 62 tests 全过 |
二、发现(severity / 位置 / 建议)
B1(低,视觉建议,可延后)1060–1100 区间装饰区排版拥挤
w04-home-1061.png 显示:atlas 左列 source-card 中邮箱被 anywhere 断行成"zhangsan @exampl e.com"逐行堆叠,h1 在左列折成四行且字重极大,观感拥挤。这是"零溢出"达成的代价,非功能缺陷(无横向滚动、内容完整可读)。建议后续在 1060 断点附近微调 hero/atlas 列宽比或提前切单列,属打磨项,不阻塞提交,可并入后续视觉走查。
B2(备注,证据口径)证据 JSON 含修复前中间态
w03-w04-browser-check.json 顶层 viewports 带 overflowing(CODE./mapped-fields),accessibility 带 violations;这些是修复前复现记录,最终结论应以 finalLayoutPass 与 accessibilityFinal 为准。文件如实保留过程是好做法,但建议在 JSON 加一个 finalSections: ["finalLayoutPass","accessibilityFinal"] 之类的说明字段或在执行记录注明,避免后续读者把中间态当现状。非阻塞。
B3(提交操作注意,重要)工作区已混入 F03 在制品,勿用 git add -A
审查期间我复跑测试发现第 9 个文件 tests/preview-flow.test.ts(8 tests 全失败,缺 buildPreview/applyPreview/undoLastFill 导出),且 utils/messaging.ts、utils/messenger.ts 出现未提交的 F03 类型/接口新增(scanToken/PreviewItem/ApplyDecision 等,文件时间 02:21)。这是父会话按"测试先写"启动的 F03 在制品,不属于 W01–W04 范围,失败是预期的红测。提交 W01–W04 时必须按文件清单显式暂存(website/*、popup/App.tsx、locales、README、docs 政策与执行记录、docs/execution 证据与审查文件、删除 utils/constants.ts),排除 tests/preview-flow.test.ts 与 utils/messaging.ts、utils/messenger.ts 的当前改动;否则会把红测和半成品类型推上远端,破坏"每提交全绿"的约定。建议提交前用 git status 再核对一次暂存清单。
B4(备注,沿承)A3 版本口径
0.2.0 政策口径已记入发布 checklist(父会话确认),发布时同步 bump package.json 即可,无新增问题。
三、验证与限制
- 我本地复跑:website typecheck/build 通过(dist 双页 + icon 产出);根 vitest 既有 62 tests 全过(另 8 个失败为 F03 红测,见 B3,非本批回归)。
- 浏览器断言与 axe 结果采信父会话 headless Playwright 证据(w03-w04-browser-check.json),我目验了 3 张截图交叉核对;未独立重跑 Playwright/axe。
- 全部为本地 mock/headless 验证,不构成真实模型 E2E(留 F02/W05);真机移动端浏览器(iOS Safari/安卓 WebView)渲染未验证,零溢出结论限于 headless Chromium。
- OG 元数据仍缺(W01/W02 审查 A4 仅补了 favicon),维持"域名确定后补"的既定安排。
四、结论
W03/W04 达到批准计划门槛(Demo 独立可操作、断点零溢出、axe 0 violations、键盘入口),W01/W02 遗留项已闭环。同意与 W01/W02 合并为一次提交,条件是按 B3 显式暂存、排除 F03 在制品。B1/B2 为非阻塞打磨项。
——交父会话汇总;本审查未修改源码与既有报告,未执行 Plane。
本文写作中使用了 AI 辅助。文字采用 CC BY-NC-SA 4.0 许可。