4.6 KiB
Issue 3:真实写保护使 mutation marker 发布失败
2026-10-23,在 Windows 本机独占 CAD 验收窗口,使用全新复制的 Audio_D2128 工程运行源码生产 TaskCenterService → execute_task_queue → QuickPartReplace.vbs → native_helper。替换意图为 RV05 的 4100-CA0000-T7 → 4100-CA0000-T0,不勾选复制料号到 Value。中央库为 mentor_lib.lmc。未修改 src、生产 VBS 或根代理的 build/issue-3-ui-acceptance。
实际工作目录为 build/issue-3-marker-failure/run-e361ef90cd1d4145b1c68cdfb067f4a6。工程从原 checkout 的 build/cbb-bom-import-live-20261015/projects/Audio_D2128 单独复制。执行前检查没有其他 CAD 实机测试进程,并与冻结 UI 验收协调串行进行。
测试进程仅包装 BatchCadRuntime._prepare_attempts:生产方法返回并发布 prepared 记录后,对该 JSON 调用真实 win32file.CreateFile,以 GENERIC_READ、FILE_SHARE_READ | FILE_SHARE_WRITE 打开,明确不允许 FILE_SHARE_DELETE。该句柄不妨碍读取 prepared 记录,但阻止 helper 的 os.replace 原子发布。句柄保持到该次生产队列退出,并在 finally 关闭;没有添加生产故障开关。
实际证据:
| 检查 | 结果 |
|---|---|
| prepared 发布与读取 | 成功;真实测试句柄 1524,可读取原 JSON |
| helper 首次发布 mutation marker | PermissionError: [WinError 5],拒绝原子替换 |
| 真实调用栈 | run_native → mark_snapshot_mutation → mark_mutation_possible → _publish → os.replace |
| 原生提交边界 | 失败发生于 mark_snapshot_mutation,在原生 Replace 按钮 click(...) 之前 |
| VBS 状态 | awaiting_native_replace → batch_failed,失败工程关闭且未保存 |
| 队列结果 | blocked、paused=true,没有 saved_ok |
| 重复执行 | _prepare_attempts 只调用 1 次;本批 retries={};没有再次执行替换 |
| 标记内容 | 保持 state=prepared,执行前后 SHA256 完全一致 |
| 资源 | 批次 session 为 released;CAD 退出与桌面消失均已确认 |
| 独立回读 | 私有 CAD 枚举工程全部图页,并读取所有器件属性、位置、方向、缩放及引脚位置、编号、net UID/name;前后结构化数据完全相同 |
| 对照范围 | 1 图页 Audio-D2128:S905L CVBS-LR,57 器件,103 引脚 |
| RV05 | UID $2I2014、料号 4100-CA0000-T7、Value 0R,属性及两条引脚连接保持原样 |
| 原始输入 | 源工程目录完整文件哈希与中央库 LMC 哈希保持不变 |
| 可见性 | 输入桌面前后均为 Default;自有 CAD 未出现在输入桌面或成为前台 |
prepared 文件前后 SHA256 为 a2ee4d65d953613c50fa14fb49a22159a7d4cc3b9c3685281ffb672962c41d17。
native report 的 stage=native_replace_started 在源码中位于 marker 写入之前,不能仅凭该 stage 判断已提交原生修改。本轮以真实异常调用栈、prepared 标记未变化、未保存状态,以及完整原理图前后独立对照共同判定。
首轮工具错误地要求出现后置 VBS guard 文案 durable mutation proof failed。实际上 native helper 更早的 marker guard 已经失败,因此该工具文案断言退出码为 1;原始 report.json 保留此失败,未删除或改写。修正测试识别真实 helper _publish/os.replace 异常后,只对同一次已执行工程运行 --verify-existing 只读回读,退出码为 0;该分支没有导入或队列执行调用,没有重放业务。
主要证据文件:
report.json:生产队列结果、唯一 attempt、真实拒绝删除共享句柄、prepared 前后哈希、原输入不变及首轮工具断言失败记录。data/tasks/*/quick-run/status.tsv与snapshot-*.tsv.native.json:真实生产状态、WinError 5 与调用栈。data/batch-resources/*/session.json:释放确认与空重试记录。before.json、readback-only/after.json:完整结构化读取结果;JSON 对象内容比较一致,属性枚举顺序可能不同,不以文本字节哈希代替结构比较。readback-only/verification.json:verified=true、graph_identical=true、marker_unchanged=true、resources_released=true、business_replayed=false。- 两阶段的
desktop-observation.json:真实 CAD 退出、桌面消失及前台/输入桌面观察。 source-under-test.json:本轮源代码与 VBS 哈希清单。
本例覆盖源码服务/队列/真实 VBS/helper/真实私有 CAD 的实际 Windows 写保护失败。通过测试进程包装方法实施故障注入,没有覆盖冻结 EXE 的同类注入;冻结 UI 正常流程由另一轮验收单独覆盖,不混记为本例通过。