F03/F04 独立审查(Qwen)
- 日期:2026-11-17;审查人:Qwen(/root/qwen_report_review,只读审查 + 仓库外临时复现脚本)
- 范围:基线
b3c1783之上全部未提交改动(19 个修改文件 + PreviewPanel.tsx、preview-flow.test.ts、布局证据与脚本)。 - 结论:需修改后提交。架构与安全边界设计正确、测试与文档质量高,但我实证复现了 1 个中高严重度的 radio 撤销缺陷(C1),且它直接违反本批隐私政策/README/网站的新承诺,修复量小(先红后绿补 2 个测试 + 撤销逻辑约 20 行),建议本批修完再提交。另有 1 项中危保护语义问题(C2)建议同批处理或明确降级口径。
一、总体判断(先说值得保留的)
propose/apply 分离干净:propose-fill 走同意闸→scan→模型→build-preview,全程不写页(background.test 断言消息序列仅 get-form-context/build-preview);apply-fill 只转发不调模型,同意闸独立复查。buildPreview 纯读(测试断言 DOM 未变);applyPreview 的 stale 整体拒写 + 逐项表单签名复查 + 保护判定复查 + include 过滤四层齐全;“已有值默认不勾"在 Popup 决策初始化正确实现且有测试。撤销快照确实只在内容脚本模块内存、刷新即丢,与政策新段落一致。“当前值不发模型"属实:propose 链路中模型只见扫描摘要(checkbox/radio 仅 value 属性),currentValue 在模型返回之后才由 build-preview 读取,仅回传 Popup。文档双语对等、网站 5 步文案与实现一致(但见 C3 台账不实)。
二、发现(severity / 位置 / 证据 / 建议)
C1(中高,需修改)radio 撤销无法恢复原选中项,且虚报 restored
- 位置:
entrypoints/content.tssnapshotForUndo/applyValue(radio 分支)/undoLastFill。 - 机理:applyValue 把 checked 设在匹配到的组内 radio(可能是另一个元素),而快照只记录定位到的元素。撤销时只把定位元素设回 false,原选中项不会恢复;radio 组互斥导致整组全空。
- 实证(我在 %TEMP% 用仓库 vitest 配置外挂临时测试复现,未改仓库文件):A/B 组 B 默认选中,建议选 A → apply filled,checked=[true,false];undo 返回
{restored:1,skipped:0},checked=[false,false],期望 [false,true]。 - 为什么重要:直接违反本批新增承诺——README"只恢复本次写入且未被你改动的字段”、隐私政策"undo restores only fields written by that fill”、网站"本次写入可一键撤销"。用户数据(原选择)丢失且 UI 报成功。现有 8 项 preview-flow 测试全部只覆盖 text/textarea,radio/checkbox/select 撤销零覆盖(见 C6)。
- 建议:快照改为组级——apply 前记录同 form 同名组内全部可用 radio 的 checked 状态与被写元素;undo 时若组内当前状态仍等于写入后状态则整组恢复,否则 skip。同时补 checkbox 与 select(含 multiple)撤销测试。
C2(中,建议本批处理或明确降级口径)radio 的"已有值保护"被绕过
- 位置:
content.tsbuildPreview中readCurrentValue对 radio 只读定位元素自身的 checked。 - 实证(同上脚本):B 选中时,locator name=plan 定位到 A,preview 报
currentValue="" hasExistingValue=false→ Popup 默认勾选 → 一次点击即覆盖用户已选的 B。 - 为什么重要:本批核心承诺"已有值的字段默认不勾选,勾选后才覆盖"对 radio 组不成立;组内已有选中就是"已有值"。这不是注入漏洞(仍需用户点应用),但保护语义与文案不符。
- 建议:radio 的 currentValue/hasExistingValue 按组判定(组内有 checked 即已有值,展示选中项的 label/value),默认不勾。若认为改语义成本高,至少在本批文档中如实注明"单选组已有选中时仍默认勾选",但我不推荐——与商店文案冲突。
C3(低中,台账/证据口径)声称的"FEATURES 4→5 卡加预览复核"未发生
- 位置:
website/src/App.tsx:72-89FEATURES 仍为 4 卡(自然语言/文件导入/接口/本地记录),无预览卡;docs/execution/2026-11-17.md与任务描述称已加第 5 卡。f03-website-layout-check.json的 note 也写"features 5 cards",但实际页面是 5 步 WORKFLOW + 4 卡 FEATURES。 - 为什么重要:布局证据的验收对象与描述不符,台账把未做的改动记为已做。hero/WORKFLOW/Demo 说明的预览口径本身正确。
- 建议:二选一——补上第 5 卡并重跑布局检查,或改台账与 JSON note 为"5 步流程、4 卡不变"。不允许保留现状描述。
C4(低,口径决定)旧 fill-form-request/fill-form 路径:建议本批直接删除
- 现状:Popup 已不用;保留 background 旧 handler + content fill-form + 类型 + 1 个旧测试。
- 分析:
@webext-core/messaging走 runtime 消息,manifest 无 externally_connectable,网页与其他扩展无法调用,不构成实际安全暴露;且旧 fillForm 仍受 F01 保护判定约束。“保留兼容"没有真实兼容对象——扩展各组件同包发布、无外部 API 消费者,唯一效果是留一条"无预览直写"的可达代码路径与双份维护。 - 建议:本批删除旧路径(handler、content 监听、fillForm 导出、相关类型与旧测试),CHANGELOG 已写"保留兼容"需同步改。若父会话坚持保留,可接受但须在 architecture 文档写明"仅内部遗留、无调用方、计划 0.3.0 移除”,避免无限期悬置。我的推荐是删除。
C5(低,备注)撤销的次级边界
lastFillUndo仅在有条目时替换:第二次 apply 全部 skip 时旧快照仍在,“撤销本次填写"实际撤的是上一次——语义可辩(上一次写入仍未撤),但 undoHint 说"this fill”,建议全 skip 时清空或文案改为"撤销最近一次写入"。- undoLastFill 不复查保护判定:若字段在 apply 后被页面设为 readonly/disabled,undo 仍写入。风险低(恢复的是用户原值),可留 F04 后续。
- stale 判定依赖 href+签名,SPA 改 href 但表单未变也会整体拒写——保守方向,正确,无需改。
- orphan(form 外)控件无 formSignature,仅靠全局 scanToken 兜底;scanToken 含全部表单签名,实际覆盖足够,注明即可。
C6(低中,测试缺口清单)除 C1/C2 外建议补的必测场景
- radio/checkbox/select(multiple) 撤销各 1 项(C1 修复的验收)。
- radio 组已有选中时预览默认不勾(C2 修复的验收)。
- apply 后页面把字段改 readonly,undo 行为断言(无论选哪种语义,先固定下来)。
- 连续两次 apply 后 undo 只作用于最近一次(现有实现如此,缺测试固定)。
- PreviewPanel 编辑值后 decisions.value 传递(popup 测试已覆盖 include,编辑路径未断言)。
- 现有 74 tests 我全部复跑通过;上述缺口不推翻现有结论,但 C1 恰好落在零覆盖区,说明"先红后绿"选例偏窄。
C7(备注,非问题澄清)
- applyPreview 信任 Popup 回传的 items(含 status/formSignature),但 content 逐项重新定位+复查保护+复查签名,伪造 status=‘ok’ 不能绕过保护;scanToken 由 content 重新计算比对,伪造 token 只会导致拒写。信任边界成立。
- highlight 类 ff-ai-filled 在 undo 恢复时移除,skipped 字段不移除——与"只恢复未改动"一致。
- locales 新增 22 key 双语键相等由 i18n 测试保证,文案与行为一致(undoHint 明确不能撤网站自动保存,README 同口径,好)。
- AGENTS.md:38 仍写旧四消息清单,属仓库说明滞后,建议随本批或下批更新(不阻塞)。
三、验证与限制
- 我本地复跑:9 文件 74 tests 全过、compile 过、lint 0 errors/7 warnings(与基线一致,含 messaging.ts:91 既有 any)、website typecheck/build 过。
- C1/C2 用 %TEMP% 外挂 vitest 临时配置+测试实证(复用仓库 WxtVitest 插件与 setup,未改仓库任何文件);日志:
preview: ok current="" existing=false→apply: filled checked=[true,false]→undo {restored:1,skipped:0} checked=[false,false]。 - 全部为 vitest+JSDOM/mock 验证,不是真实浏览器 E2E;扩展 headless 加载 smoke 此前未通过,本审查不宣称真实加载已验证。radio 组互斥行为 JSDOM 与真实浏览器一致(HTML 标准语义),C1 结论可信度高;C2 的 UI 默认勾选链路含 Popup 代码审读,置信度高但未跑真实弹窗。
- 布局证据 f03-website-layout-check.json 18 组全过我采信(脚本审读合理),但注意 C3 的描述不符。
四、结论与提交条件
需修改:C1 必须本批修复(组级快照+补测试);C2 强烈建议同批修(组级已有值判定),否则须改文档口径;C3 台账/证据描述必须纠正。C4 建议删除旧路径(可辩论,非阻塞);C5/C6 其余项可列后续。修复后重跑全量测试+compile+lint,交我增量复核 C1/C2 修复 diff 即可,无需重审全批。
——交父会话汇总;未改仓库源码与既有报告,未执行 Plane,未提交。
第二轮增量复核(2026-11-17)
结论:同意提交。C1/C2/C3 修复到位,C4 删除完整,C5/C6 按建议落实,无新增阻塞问题。
逐项核验
- C1(radio 撤销)已修复。审读
snapshotForUndo/finalizeUndoEntry/undoLastFill的 radio-group 分支:快照记录同 form 同名组全部可用项的 {element, checked};undo 校验元素集合与逐项 checked 均等于写后状态才恢复(组 membership 变化即 skip,保守正确);恢复先清 before=false 再设 before=true 并派发事件,顺序正确避免互斥干扰。我用首轮同一 %TEMP% 外挂复现脚本重跑:原失败用例(B 默认选中→写 A→undo 期望 [false,true])现在通过。新增测试断言 undo 后 B 恢复选中、用户改选后 skip,语义完整。 - C2(组级已有值)已修复。
readCurrentValueradio 分支改为组内查 checked 返回其 value;测试断言 hasExistingValue=true、currentValue=‘b’、默认决策 skipped、B 保持选中。与 CHANGELOG"单选组按组判定已有选中"新口径一致。 - C3(台账)已纠正。FEATURES 实增第 5 卡「先预览再写入」(App.tsx:77-80),文案与实现一致无过度承诺;f03-website-layout-check.json 重新生成,note"5 steps + 5 cards"与页面相符,allPass=true。我复跑网站 typecheck/build 通过。
- C4(旧路径)删除完整。全仓 rg 无 fill-form-request/fill-form 处理器、fillForm/FillFormResult、三个旧类型残留(仅文档/测试注释中的历史说明,属正当);ProtocolMap 与 import 同步清理;AGENTS.md 消息协议更新并明令禁止恢复无预览直写路径,架构文档写明删除理由。content-script.test 迁移到 applyAll(preview→apply 全 include),逐项核对原保护断言语力保留:密码/隐藏/只读/禁用 fieldset/隐藏祖先仍拒写且原值不变、radio 不选 disabled 不跨 form、非法 CSS 计 failed、invalidCount 计入 skipped、学习采集仍为空。迁移未削弱断言。
- C5:
lastFillUndo = undoEntries无条件替换,全 skip→空快照有测试固定;readonly 恢复语义写入架构文档并有测试;连续两次 apply 只撤最近有测试。 - C6:新增用例覆盖 radio 组三项、checkbox+select 单/多选撤销、全 skip 清快照、连续 apply、readonly 语义、popup 编辑值传递(断言 decisions.value=‘Edited company’),首轮清单全部落实。
复跑验证
9 文件 82 tests 全过;compile 过;lint 0 errors/7 warnings(基线一致);扩展 build 过(1.06 MB);网站 typecheck/build 过;我的外挂 radio 复现用例由红转绿。布局 18 组 ALL PASS 采信父会话重跑结果(脚本与 JSON 审读一致)。仍为 vitest+JSDOM/mock,非真实浏览器 E2E,真实加载 smoke 未验证的口径不变。
残留备注(均不阻塞,供后续参考)
- radio-group 恢复时仅对恢复为 checked 的元素派发事件,被清除项不派发——组语义下通常足够(框架监听组 change),若真实浏览器验证发现某框架依赖逐项事件再补。
- 极端边界:undo 时 before 中某元素已被页面移除,仍计入 restored——影响仅计数口径,无数据风险,不值得本批处理。
- 预览中 radio 的 currentValue 显示 value 而非选项 label(如 “Current: b”),UX 打磨项,留后续。
——第二轮复核完成,同意按当前 diff 提交;未改仓库源码,未执行 Plane,未提交。
本文写作中使用了 AI 辅助。文字采用 CC BY-NC-SA 4.0 许可。