docs: explain explicit maintenance for existing ICDB addresses

This commit is contained in:
阿白叔 committed 2026-11-03 09:15:06 +08:00
1 parent e39dc63ded
commit 4cbca0b5a6
1 file changed
+38
@@ -0,0 +1,38 @@
# 既存地址记录下的明确 ICDB 维护入口
2026-11-03 的现场报告显示,点击“非 READY ICDB 检查与修复”后,IP101GR 在
0.172 秒内返回 BLOCKED,没有启动官方 Repair。原先维护按钮和普通校验使用
相同请求;普通校验对任何 sAddress.adr 的阻止条件也挡住了明确维护入口。
随后保留的库协调检查点使重新读取与维护都无法继续。
本次为用户明确确认的维护增加独立入口。普通校验遇到地址记录仍停止,不依据
文件日期、TCP 不通或本机无 PCB 进程判断地址失效,不删除、移动或隔离地址。
没有地址阻止时,维护继续沿用原有校验及本轮失联后的自动修复流程。
存在地址记录时,明确维护需要唯一可确认的工程 PRJ/database 映射。共享符号库
地址、多个地址、外部引用、歧义目标、不完整工程均会阻止执行。工具检查相关
原生程序和保留工作进程,并同时独占读取库中的原生数据库文件;记录目标工程
引用指纹和地址字节哈希,检查期间及完整备份后重新核对。完整工程备份保留
原地址文件,再由官方 iCDB Project Backup 打开工程。只有其实际 Output 明确
报告 `Project is not in use. Full iCDB Project Backup's functionality is available.`,
且没有占用或未知窗口时才请求 Repair。
库旁已有协调检查点时,明确维护可以接续有效的同库记录,条件是原监督进程
已退出,或当前进程确实持有已闲置的保留锁。相关所有者和目标独占访问检查
必须先全部通过,再原样归档旧检查点并建立本次检查点;库 sidecar 和全局 mutex
期间始终持有。未知、损坏、其他库的记录或仍存活的外部监督进程不会被接管。
普通释放检查的地址要求没有放宽,上传锁文件不删除。
重启后有有效同库检查点时,界面仅按工程目录显示 UNKNOWN 状态,明确标注
“状态未确认,不代表损坏”。此视图不调用原生状态读取,只允许明确维护或严格
释放检查;普通校验、上传/更新/移除及备份恢复均禁用。安全完成维护后再重新
读取权威状态,保留当前搜索条件。
Repair、原生退出、地址消失和最终校验仍是不同的判据。只有完整原生修复证据、
所有者与地址释放及同一工程后验 PASS/GREEN 全部成立才计为修复通过。缺健康
备份、恢复旧版本、占用、超时或不完整证据不会提升为成功,也不会盲目重试。
协调端在保留旧地址字节的用户工程副本上观察到:官方工具报告数据库曾在服务器
运行时被复制、工程当前未使用,随后官方 Repair 自行清除副本地址并返回成功。
这证明了明确维护入口的必要性;原始用户库没有由本次开发或测试修改。实际按钮、
冻结包及最终全套回归由协调端在提交后的隔离副本继续验收。