From 4f741cd17680ff4eb98f444c6458ea00f77cc66d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=98=BF=E7=99=BD=E5=8F=94?= <11794527+absfan@user.noreply.gitee.com> Date: Mon, 2 Nov 2026 22:59:50 +0800 Subject: [PATCH] docs: record final issue 2 candidate evidence and acceptance gaps --- ...2026-11-02-issue-2-candidate-validation.md | 77 +++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 docs/releases/2026-11-02-issue-2-candidate-validation.md diff --git a/docs/releases/2026-11-02-issue-2-candidate-validation.md b/docs/releases/2026-11-02-issue-2-candidate-validation.md new file mode 100644 index 0000000..78213fa --- /dev/null +++ b/docs/releases/2026-11-02-issue-2-candidate-validation.md @@ -0,0 +1,77 @@ +# 工单 #2 候选包验收记录 + +分支:`codex/temp-issue-2-icdb-recovery`。本记录区分软件回归、隔离原生试验和现场验收;未合并、发布或关闭工单。 + +最终候选程序源码提交:`8e486c1`。新增和同名更新保持禁用;原生新增虽已成功注册并复读,但原理图数据库被原生工具重写,尚未证明内容等价。移除已在新建隔离库通过完整管理流程验证。 + +最终全量回归:`python -m pytest -q` 在 `122bafc` 上 **887 passed,1 个已有 pywinauto STA 模式警告,68.62 秒**。`122bafc` 只调整安全测试,`src` 和 `packaging` 的 Git 树与打包提交 `8e486c1` 完全一致。编译检查及 `git diff --check` 通过;整分支审查和后续修正复审均无未处理问题。 +日志:`build/issue2-final-tests-122bafc.log`。安全测试明确保留工程文件、上传锁以及损坏/外来检查点,只有本工具拥有且验证通过的运行时检查点允许清理。 + +## 已实现范围 + +- ICDB 启动失败后,仅在任务进程、工程路径、私有桌面、空闲窗口及地址释放可确认时正常关闭 PCB;同时等待启动器退出。Repair 区分缺少健康备份、原生失败、占用、未知窗口和释放超时。最终重新打开、校验及 READY 状态共同决定修复成功。 +- 名称/分区搜索和状态筛选使用已加载数据;隐藏条目清除勾选。READY 可以用于管理,不能进入默认校验、维护和恢复队列。受影响条目刷新后重新判断资格。 +- 完整备份保留全部文件;版本化清单对主要工程文件和库依赖计算 SHA-256,复制时同时核对文件集合、大小和时间。日志及其他运行时变化不再等同于工程内容变化。 +- 管理请求、逐项结果、完整旧库备份、检查点、来源暂存、共享锁和安全释放入口已集成。新增/更新未达到原生验收门槛时禁用。重启只展示未完成任务,不自动重放写操作。 + +## 原生证据与边界 + +| 场景 | 实际观察 | 限制 | +| --- | --- | --- | +| 最终冻结程序启动失败退出 | `8e486c1` 的 PCB 和启动器自动正常退出、无数据库地址;`startup-close.json` 为 CLOSED,safe_to_continue=true | 人工损坏副本,不是现场服务器失联 | +| 最终冻结程序 Repair 缺少健康备份 | `8e486c1` 返回 MISSING_HEALTHY_BACKUP,原生工具自动退出、地址为空、允许安全继续 | 验证明确失败和释放,不代表修复成功 | +| 官方原生移除 | 独立副本中 CleanWGLib/F4 返回 0,之后原生目录重新读取为空 | 旧库升级存在告警;生产读取遇到升级必须拒绝 | +| 隔离新增首次完整探测 | 新建库后打开编辑器失败,尚未提交新增;来源保持不变,保留失败证据及协调阻止记录 | 不启用新增或同名更新,不作为成功验收 | +| 最终移除适配器命令 | 实际捕获 `# Note: Removed REUSE_BLOCK 'IP101GR' from partition 'Logical-Physical'.`,释放确认成功,来源清单未变 | 随后的旧库复读拒绝 Select flow type;不能宣称该库完整自动移除验收通过 | +| 新建隔离库完整移除 | 管理引擎完成原生读取、完整旧库备份、原生删除、重新读取确认缺失;最终 REMOVED,safe_to_continue=true | 仅代表此安装版本、库流程和 Logical-Physical 分区 | +| 新建隔离库原生新增 | 收到成功消息,正常关闭、重新打开仍有正确名称/分区,原始来源不变;布局哈希一致 | 原理图数据库哈希改变,identity_matches=false;新增/更新不启用,未执行同名更新和重新导入恢复验收 | + +原始证据位于 `diagnostics/issue2-frozen-20261102/`、 +`diagnostics/issue2-management-native-20261102/` 和 +`C:/Users/ABS_Windows/.cbb-management-e2e-20261102-a/`。 +首次新增失败后,仅向已确认的隔离 Library Manager 主窗口发送正常 WM_CLOSE; +随后进程查询为空,没有强制终止数据库所有者。 + +第二次新增探测的 `dispatch-diagnostics.jsonl` 在加载 pywinauto 前记录方法 +DISPID 17/26/6,加载后全部返回 `CO_E_OBJNOTCONNECTED`(-2147220995)。 +这证明失效发生在 UI 自动化依赖初始化边界,尚未提交新增;来源未变。 +第二次隔离会话同样正常关闭。移除适配器及旧库拒绝证据保存在 +`diagnostics/issue2-remove-adapter-20261102/`;旧库拒绝流程后出现的 +“Unable to determine flow type”通知由协调端确认后正常退出,不能记为无人值守释放通过。 + +`ffa7e84` 冻结包的 GUI 冒烟通过,但真实批处理在启动 Mentor 前报 +`No module named 'win32timezone'`。此包不能作为最终可用包交付;必须补齐打包依赖并重建验证。 +`1f69480` 补齐依赖后运行了真实 PCB 流程;`8e486c1` 又收紧了隐藏基础设施窗口的精确识别条件,最终冻结测试自动通过退出分支。 + +最终证据: + +- `diagnostics/issue2-frozen-20261102/full-8e486c1-startup/evidence/verify-97173dae8a21/startup-close.json` +- `diagnostics/issue2-frozen-20261102/full-8e486c1-nohistory/repair-result.json` +- `diagnostics/issue2-management-final-20261102/probe-result.json` +- `diagnostics/issue2-management-final-20261102/full-remove-result.json` +- 移除前完整旧库保留在 `C:/Users/ABS_Windows/.cbb-management-e2e-20261102-e/full-remove/management-e90d69ad7f624fb18f5401119b96856d/library-before/`。 + +冻结启动失败试验的批处理退出码为 2,因为输入是损坏工程;通过项是自动安全退出,而不是工程校验成功。缺少健康备份的 Repair 同样是已验证的明确失败分支。 + +## 仍需现场验收 + +工单附件只有日志,没有现场 `1GPHY_8211` 故障工程及其必要共享库的一致副本。 +因此现场服务器会话失联尚未复现,也没有完成该现场故障经应用实际维护按钮触发的完整自动链路验收。 +必须取得副本、记录来源/工程身份/主要文件哈希,在隔离环境记录失败、退出、Repair 调用、重新打开、保存关闭和 READY 查询的完整证据,并核对来源未改变。 +复制后不能复现时应记录“未复现”,不能用数据库文件头损坏试验替代。 + +Windows 10 尚未验证。现有原生试验环境为 Windows 11 / Mentor EE 7.9.5。 +历史备份恢复保持“已恢复,版本待核对”,不宣称无损修复。 + +## 候选包 + +`dist/issue2-repair-candidate-877e3b4.zip` 保留独立修复候选包及构建清单。 +完整候选程序位于 `dist/issue2-full-candidate-8e486c1/`,由 `git archive 8e486c1` 的不可变源码构建。构建与 GUI 冒烟通过,真实冻结原生证据见上。 +分发压缩包:`dist/issue2-full-candidate-8e486c1.zip`。解压后运行 `CbbRefreshVerify-Background/CbbRefreshVerify.exe`;包根目录保留构建清单、本文及关键验证证据。 +`dist/issue2-full-candidate/` 和 `dist/issue2-full-candidate-1f69480/` 是被后续修正取代的中间试验构建,不作为交付包。 + +## 后续验收顺序 + +1. 取得现场故障工程及必要共享库一致副本,优先完成实际维护按钮触发的完整自动链路验收。 +2. 针对原生导入会重写 ICDB 的行为,使用经过验证的 Mentor 语义读取/导出建立工程内容等价证据;不能只放松哈希检查。之后才能启用新增,并验证重复冲突、同名更新、部分失败及备份重新导入。 +3. 在 Windows 10 / EE 7.9.5 重跑冻结关键路径,并在具备网络测试环境时验证真实断网、取消和恢复场景。现有模拟测试不能替代这些环境验收。