From 4cbca0b5a69a3602ab10f360a6d1ffef22212ede 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: Tue, 3 Nov 2026 09:15:06 +0800 Subject: [PATCH] docs: explain explicit maintenance for existing ICDB addresses --- .../2026-11-03-explicit-icdb-maintenance.md | 38 +++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 docs/releases/2026-11-03-explicit-icdb-maintenance.md diff --git a/docs/releases/2026-11-03-explicit-icdb-maintenance.md b/docs/releases/2026-11-03-explicit-icdb-maintenance.md new file mode 100644 index 0000000..470b896 --- /dev/null +++ b/docs/releases/2026-11-03-explicit-icdb-maintenance.md @@ -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 自行清除副本地址并返回成功。 +这证明了明确维护入口的必要性;原始用户库没有由本次开发或测试修改。实际按钮、 +冻结包及最终全套回归由协调端在提交后的隔离副本继续验收。