跳至内容
F03/F04 独立审查(Qwen)

F03/F04 独立审查(Qwen)

所属专题:FormFill 浏览器扩展复盘
  • 日期: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.ts snapshotForUndo/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.ts buildPreview 中 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-89 FEATURES 仍为 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 外建议补的必测场景

  1. radio/checkbox/select(multiple) 撤销各 1 项(C1 修复的验收)。
  2. radio 组已有选中时预览默认不勾(C2 修复的验收)。
  3. apply 后页面把字段改 readonly,undo 行为断言(无论选哪种语义,先固定下来)。
  4. 连续两次 apply 后 undo 只作用于最近一次(现有实现如此,缺测试固定)。
  5. 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(组级已有值)已修复。readCurrentValue radio 分支改为组内查 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 未验证的口径不变。

残留备注(均不阻塞,供后续参考)

  1. radio-group 恢复时仅对恢复为 checked 的元素派发事件,被清除项不派发——组语义下通常足够(框架监听组 change),若真实浏览器验证发现某框架依赖逐项事件再补。
  2. 极端边界:undo 时 before 中某元素已被页面移除,仍计入 restored——影响仅计数口径,无数据风险,不值得本批处理。
  3. 预览中 radio 的 currentValue 显示 value 而非选项 label(如 “Current: b”),UX 打磨项,留后续。

——第二轮复核完成,同意按当前 diff 提交;未改仓库源码,未执行 Plane,未提交。

本文写作中使用了 AI 辅助。文字采用 CC BY-NC-SA 4.0 许可。

最后更新于