docs: record actual maintenance button and user-selected recovery validation

This commit is contained in:
阿白叔 committed 2026-11-03 10:25:59 +08:00
1 parent 2085ec770f
commit f8f2dd53aa
1 file changed
+53 -2
@@ -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`。不合并发布、不自动关闭工单。