diff --git a/docs/releases/2026-11-03-explicit-icdb-maintenance.md b/docs/releases/2026-11-03-explicit-icdb-maintenance.md index 6af832b..79e50c9 100644 --- a/docs/releases/2026-11-03-explicit-icdb-maintenance.md +++ b/docs/releases/2026-11-03-explicit-icdb-maintenance.md @@ -10,7 +10,8 @@ 没有地址阻止时,维护继续沿用原有校验及本轮失联后的自动修复流程。 存在地址记录时,明确维护需要唯一可确认的工程 PRJ/database 映射。共享符号库 -地址、多个地址、外部引用、歧义目标、不完整工程均会阻止执行。工具检查相关 +地址、所选工程内多个地址、外部引用、歧义目标、不完整工程均会阻止执行。 +其他独立 CBB 的 Work 数据库地址不纳入当前修复目标,原文件保持不变。工具检查相关 原生程序和保留工作进程,并同时独占读取库中的原生数据库文件;记录目标工程 引用指纹和地址字节哈希,检查期间及完整备份后重新核对。完整工程备份保留 原地址文件,再由官方 iCDB Project Backup 打开工程。只有其实际 Output 明确 @@ -35,7 +36,7 @@ Repair、原生退出、地址消失和最终校验仍是不同的判据。只 协调端在保留旧地址字节的用户工程副本上观察到:官方工具报告数据库曾在服务器 运行时被复制、工程当前未使用,随后官方 Repair 自行清除副本地址并返回成功。 这证明了明确维护入口的必要性;原始用户库没有由本次开发或测试修改。实际按钮、 -冻结包及最终全套回归由协调端在提交后的隔离副本继续验收。 +冻结包及最终全套回归的实际验收结果见下。 ## 修复后的本地读写访问提示 @@ -69,3 +70,53 @@ Yes6/No7 按钮。专用代理在自己的私有桌面再次读取实际窗口 `pcb-version-choice.json` 保存完整窗口和候选状态。维护摘要显示“ICDB 已修复 / PCB 版本待选”,原生状态仍为 REPAIRED,但整项保持未完成、需人工决定,不能 计为 PASS/GREEN。工具也不会因为显示了某个默认选中项就认可该版本。 + +## 最终验证(2026-11-03) + +程序源码提交 `d76475a`:全量 `python -m pytest -q` **969 passed,1 条已有 +pywinauto STA 模式警告,107.69 秒**;编译、diff 检查和代码复审通过。 +由不可变 `git archive d76475a` 构建的 EXE 通过 GUI 冒烟。 + +在第二份完整隔离库上,通过打包 EXE 的实际“非 READY ICDB 检查与修复”按钮 +确认并运行 IP101GR:有效旧阻止记录接续、旧地址完整备份、官方 Repair 成功并 +正常释放、一次受约束的读写确认均实际执行。之后准确停在原生 PCB 版本选择, +显示 `version_choice_required=1`、`repair_unconfirmed=0`、`repaired=0`。 +这是维护入口和结果分类通过验收,不代表未经用户选版本就达到 READY。 + +原始证据: + +- 用户最初 0.172 秒失败:`diagnostics/issue2-user-maintenance-20261103/user-reports/`。 +- 冻结 EXE 实际按钮:`diagnostics/issue2-user-maintenance-20261103/actual-button-frozen-d76475a/outcome.json`。 +- 原生版本选项:上述目录的 `data/evidence/verify-8fa461b6d6fe/pcb-version-choice.json`。 +- 全量测试:`build/issue2-maintenance-final-tests-d76475a.log`。 + +### 用户明确选择最后手动保存版本后的副本验证 + +用户选择“用最后手动保存版本继续验证”,授权范围仅为隔离副本。诊断续跑使用 +真实校验器、原生工作进程、对话框代理及权威状态读取;只为这次用户决定提供 +版本动作:先点击 6213,重新观察其已选中且 6206 未选中,再确认 OK 1。 +选择前保留完整工程副本;没有改变程序的默认版本选择规则。 + +工程成功打开并核对身份,但在原长路径下两次 Project Integration 均产生本轮 +JobPrefsDB.jpf / local Cell Library 加载错误。原文件、临时目录及备份中的 JPF/CEL +可读且哈希一致,日志前缀与时间证明是本轮错误,不能断言二进制数据已损坏。 + +随后保持同一工程数据,通过临时本地 `T:` 短路径进行对照,完成原生 Integration、 +保存关闭、进程释放及权威状态查询,结果为 **PASS / GREEN / READY +(IsVerifiedReuseBlock, raw=1),safe_to_continue=true**。所有原生进程退出后已移除 +该临时盘符。此结果说明短路径试验可通过,尚不能证明确切路径长度限制或永久 +解决原长路径下的 JobPrefs/Cell Library 兼容问题;产品没有自动增加短路径映射。 + +这是**用户指定历史版本后的恢复与验证**,不是无人值守或无损自动修复验收。 +验证后的完整库副本保留在 `diagnostics/issue2-user-maintenance-20261103/frozen-library/`, +原用户库没有被替换。结果和选择证据分别位于: + +- `user-authorized-last-saved-r2/user-selection-events.jsonl`(实际 6213 → 复读 → OK 1)。 +- `user-authorized-last-saved-short-path/result.json`(最终 PASS/GREEN)。 +- `short-path-trial.json`(临时盘符及正常退出后清理记录)。 +- `source-unchanged-after-user-choice.json`(全部试验后原库 21,013 个主要文件清单仍一致,原地址字节哈希未变)。 + +以上相对路径均位于 `diagnostics/issue2-user-maintenance-20261103/`。 +现场原工单其他工程、网络共享读写确认和 Windows 10 仍不能由此验收代替。 + +交付候选包为 `dist/issue2-maintenance-20261103-d76475a.zip`。不合并发布、不自动关闭工单。