# CBB 中心库上传后校验工具 当前补丁:**[v0.2.3-beta.1](docs/releases/v0.2.3-beta.1.md)(Beta 预发布,待现场验收)**,替代 0.2.2-beta.1。数据库所有权或关闭状态不确定时停止批次、保留现场;不自动移走地址文件、接管带锁设计或强杀 PCB 进程树。新增全库 ICDB 维护、同名 CBB 完整备份恢复弹窗及严格的原生复核流程。详见 [v0.2.3-beta.1 发布说明](docs/releases/v0.2.3-beta.1.md)。下方日期记录描述历史版本,以本补丁说明为准。 本目录是独立的 CBB 中心库上传后校验工具,不属于 Part Replacement,也不负责 CBB 工程复制或中心库上传。 针对 `The last server session ... lost the connection to the database`,修复分支增加 `ICDB_REPAIR_REQUIRED` 专项识别、共享符号库路径诊断及停止批次处理。现场原生修复步骤及实现边界见 [iCDB 旧服务器会话失联分析](docs/diagnostics/2026-10-27-icdb-lost-server-session.md)。 当前分支会在目标明确、完整备份和所有权释放证据齐全时尝试一次同版本原生 Repair;共享符号库没有 PRJ 入口时停止并要求人工处理。 ## 功能边界 | 工具 | 处理对象 | 核心动作 | 结果 | | --- | --- | --- | --- | | `dxdesigner-part-replacement` | 普通器件 Part Number | 旧 Part 替换为新 Part | 原理图器件被替换 | | `cbb-upload-795` | CBB 工程/中心库 | 复制、Packager、上传、Verify | 中心库新增或更新 CBB | | 本工具 | 已上传到中心库的 CBB 条目 | 在 Library Manager 中执行/确认 Verify,检查条目和 CBB 状态标志 | 中心库 CBB 校验完成且结果可追溯 | 这里的“刷新检验”指 CBB 上传中心库后的收尾校验。当前生产路径打开 ReusableCircuit PCB,执行 Project Integration、保存和关闭,再读取中心库权威状态。它不替换 Part Number,也不负责上传动作本身。 本工具会通过 Mentor 原生接口更新和保存 CBB 工程,并可能修正 `PCB/pcb.prj` 的 CentralLibrary 路径(保留原文件副本)。这不是只读检查;不要将“校验”理解为工程数据完全不变。 ## 当前实现 运行时只依赖目标工作机器上可用的 Mentor/DMS 环境、中心库 `.lmc`、CBB 名称、LibSpec 和 DMS 登录配置。历史试跑记录、截图和旧版本探针不参与判定。 入口: ```powershell powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\CBBRefresh.ps1 ` -StatusJson .\examples\project-integration-before.json ` -OutputJson .\runs\sample-report.json ``` 输出会给出下一项应执行的 Verify 动作、是否已经全部通过、阻断原因和证据摘要。 ### 已定位的正式 Verify 入口 运行真实校验前可先检查本机环境: ```powershell powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\Test-CbbVerifyEnvironment.ps1 ` -DmsRoot 'C:\path\to\dms' ` -DmsLoginConfig 'C:\path\to\dms-login-config' ``` `ready=false` 时不要尝试 Verify;这表示 DMS 运行时或登录配置尚未就绪。 Library Manager 的安装脚本 `upc_utils.tcl` 使用 `ReuseBlockImporter.exe -chkContents` 完成 Logical-Physical CBB 内容校验,不需要通过坐标点击菜单。可直接调用: ```powershell powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\Invoke-CbbVerify.ps1 ` -LmcFile 'F:\path\mentor_lib.lmc' ` -BlockName 'CBB_NAME' ` -LibSpec 'YOUR_LIBSPEC' ` -DmsLoginConfig 'C:\path\dms-login-config' ` -EvidenceJson .\runs\cbb-name-verify.json ``` 命令使用固定的 `-logicalType LP` 和 `-chkContents`,输出报告默认落在 `.lmc` 同目录的 `LogFiles\restorerb_RULP__contents.log`(非法文件名字符会转成下划线)。`pass` 必须看到 `content checking completed successfully` 且没有错误文本;缺少 DMS 登录配置、DMS 未连接、内容检查失败或超时都会阻断。`-LibSpec` 与 `-DmsLoginConfig` 没有默认值,避免把未认证的测试误判为成功。 注意:该 CLI 是 Library Manager 内部的内容检查入口;它是否在当前站点版本中同步更新树节点的红/黄/绿色标志,仍需在已连接 DMS 的实际中心库上读取状态确认,工具不会仅凭进程退出码宣布“四绿”。 现场只读探针(在 Library Manager 已打开并选中刚上传的 CBB 条目时运行): ```powershell powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\CBBRefresh.UiProbe.ps1 ` -WindowTitlePattern 'Library Manager' ` -OutputJson .\evidence\library-manager-ui.json ``` 探针只读窗口控件,不执行点击;输出中的 `patterns` 用于确认 Verify 菜单项、Verify 对话框按钮和状态节点是否支持语义化 `InvokePattern`。 离线回归测试: ```powershell powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\tests\CBBRefresh.Core.Tests.ps1 ``` ## 现场流程 1. 确认中心库上传动作已经完成,并记录中心库文件、CBB 名称和源工程。 2. 在 Library Manager 中定位刚上传的 CBB 条目,确认名称和来源匹配。 3. 对该条目执行原生 `Verify`,按对话框要求完成检查。 4. 每一步完成后重新读取条目状态;错误、红色标志或状态未知时停止。 5. 确认 Verify 结果、CBB 条目标志和错误状态全部为绿色。 6. 保存并关闭 Library Manager,保存校验证据和报告。 ## 不允许的路径 - 不把校验当成 `Replace Symbol` 或 Part Number 替换。 - 不直接改写中心库、`.prj`、PCB、CES 或网表文件来伪造绿色状态。 - 不使用 `SendKeys`、屏幕坐标点击或无条件等待。 - 不把“弹窗关闭”或“没有报错”当作四绿成功。 后台触发说明:生产路径不会监听或注入用户真实键盘,也不会移动用户鼠标。它在私有桌面启动与 CBB 目录绑定的 `common\\win32\\bin\\ExpeditionPCB.exe -ReusableCircuit`,再绑定其 `wg` 子进程执行 Project Integration、保存和关闭;Library Manager 菜单路线仅保留为显式诊断路径。 ## 2026-09-15 现场试跑记录 已在 `Skyworth_CBB_Lib\Mentor_lib_EE7.9\mentor_lib.lmc` 上完成一次只针对 CBB 校验的试跑: - COM 只读枚举确认 `Logical-Physical` 中已有 `1GPHY_8211`、`1GPHY_RTL8211F_A`;未覆盖或删除任何条目。 - 目标条目采用用户截图所示的右键菜单 `Verify` 路径尝试执行。 - 当前版本的 Library Manager 树节点在未展开时不会通过 UI Automation 暴露 `Logical-Physical` 子项;上传工具因此在定位阶段超时。 - 两次 Verify 触发均没有出现可识别的完成对话框或状态变化,最终不得判定为绿色,报告为 `BLOCKED`。 完整证据见 `evidence\library-com-probe.json`、`evidence\library-manager-ui-after-verify.json`、`runs\verify-report-1GPHY_RTL8211F_A.json` 和 `runs\add.log`。后续自动化必须先语义化展开树节点,并为 `Verify` 建立可读的完成信号;没有完成信号时状态保持 `unknown`。 ## 本地样本库验证 为区分“中心库不存在”和“Verify 接口不可用”,已在 `fixtures\sample-library` 创建隔离样本: - `kFLOW_NONE=4` 创建的空库打开时提示 `Unable to determine flow type`,不可用于验证。 - 改用 `kFLOW_DX=1` 后生成的 `sample_verify_dx.lmc` 可以正常打开,但空库没有 CBB 条目。 - 复制生产库 `.lmc` 和 `ReusableBlocksLP` 到 `fixtures\cloned-library` 后,副本可以正常打开;对副本尝试键盘导航展开树并发送 `Verify`,仍没有可识别的 Verify 完成窗口或状态信号。 因此问题不是单纯“没有中心库”:有效 `.lmc` 能打开,真正缺口是 Library Manager CBB Verify 没有公开 COM 方法,且树节点/菜单的完成信号尚未稳定暴露。样本操作证据见 `evidence\sample-library-dx-create.json`、`evidence\sample-library-dx-ui.json`、`evidence\cloned-verify-run.json` 和 `evidence\sample-reusable-block-create.json`。 重启复测后,COM 在没有预先打开 Library Manager 的情况下仍能打开生产 `.lmc` 并枚举 CBB;随后直接启动 `.lmc` 得到 `Ready` 状态和可用的 `ATL:SysTreeView32`。因此可以排除中心库缺失,后续工作集中在树展开和 Verify 完成信号。 # CBB Refresh Verify 独立的中心库 CBB 上传后刷新校验工具。选择 `.lmc` 后自动读取 Reusable Blocks(Logical-Physical)并列出 CBB,点击校验即对每个 CBB 执行一次真实刷新: 1. 只读确认中心库条目与 `.lmc` 存在; 2. 如填写了 `LibSpec` 与 DMS 登录配置,先执行一次 `ReuseBlockImporter.exe -chkContents` 内容检查(失败即阻断,不触碰 PCB); 3. 在私有桌面上用**命令行**启动该 CBB 的 ReusableCircuit PCB(`ExpeditionPCB.exe -ReusableCircuit`,即 Library Manager `Verify` 菜单内部执行的动作); 4. 通过 COM 核对文档身份、执行 Project Integration(四项 InSynch)、保存 Reusable Block cell 并关闭; 5. 确认中心库 `Cert` 工程已更新,并只读读取条目状态标志作为证据。 运行: ```powershell python -m cbb_refresh_verify ``` 或在本目录执行 `pip install -e .` 后使用 `cbb-refresh-verify`。 ## 操作边界(不碰你的桌面) - **不注入鼠标或键盘输入,不切换 Windows 桌面,不改写中心库源文件。** 生产路径在本次运行创建的私有桌面内启动中心库目录绑定的 ReusableCircuit PCB,随后用 COM 完成刷新、保存和关闭;只读状态桥在结束后确认 LMC 的 READY。Library Manager 菜单派发仅作为显式诊断路径保留。`tests/test_safety.py` 会在离线测试中阻止真实输入注入 API 重新进入生产代码。 - 所有自动化都跑在本进程创建的**私有 Windows 桌面**上:用户看不到窗口,光标不会被移动。 - 弹窗只认领本次运行的私有桌面/进程,依据已知规则投递 `BM_CLICK`。数据库恢复、会话失联和设计锁接管提示会阻断并保留现场;不会自动选择恢复或接管。未知弹窗也会阻断,Project Integration 进度窗保持观察。动作/错误弹窗和实际控件 ID 写入 `dialogs.jsonl`。 - 超时或失败时停止自动化客户端,保留可能仍在写库的原生会话并停止批次。内容检查超时也不再强杀整个进程树;监督器核对进程是否退出,记录 `process_exit_confirmed` 或 `process_retained`;无法确认释放时输出 `recovery-required.json`,不以强杀代替数据库安全关闭。已确认身份且原生调用返回的失败文档会通过 32 位助手执行 `Close(False)`,再确认进程和 iCDB 地址释放。 ## 环境要求 | 依赖 | 说明 | | --- | --- | | Mentor EE 7.9.5 | `SDD_HOME`(默认 `D:\Mentor\7.9.5EE\SDD_HOME`);PCB Verify 入口优先取 `common\win32\bin\ExpeditionPCB.exe`,由其派生 `wg\win32\bin\ExpeditionPCB.exe`,仅在 common 不存在时回退到 wg | | 设计数据库服务器端口 | iCDB 服务器必须在 **10000–10100** 内绑定一个 TCP 端口。若该区间被 Windows 保留(Hyper-V/WSL 动态预留,绑定报 `WinError 10013`),PCB 会提示 "could not bring it alive";工具会立即阻断并给出修复命令:以管理员执行 `net stop winnat && net start winnat` | | DMS(仅可选内容检查) | 需要 `LibSpec` 与 DMS 登录配置文件;两者留空时跳过内容检查,只做 PCB 刷新 | ### Win10 / Win11 兼容性边界 Win11 不能仅凭当前开发机的离线 smoke test 宣称“Verify 已成功”;必须在安装了同一 Mentor EE 版本、同一中心库和 DMS/端口配置的机器上完成单个 CBB 的现场验收。Win10 现场失败的最新证据不是 Project Integration 或保存失败,而是 UIA `InvokePattern` 返回后只关闭了原生菜单,没有出现新的 `ExpeditionPCB.exe`;这表示 LMC 的 Verify 命令没有进入 Mentor 的 MFC 命令路由。另有一类 Win10 环境失败来自 iCDB 端口被 Hyper-V/WSL 保留,工具会在启动 PCB 前报告 `BLOCKED`。 每个条目的 `evidence/runtime.json` 会记录 Windows 产品版本、Build/UBR、Python 位数、Mentor 路径和 UIA 后端;`events.jsonl` 会同时记录 PCB 启动和清理阶段。只有同时出现 `pcb_worker_started`、`integration_status`、`saved_and_closed`、`complete`,并由状态桥复核为 `READY`,才算该机器上的成功。 Windows 版本判断以 Build 为准:`22000` 及以上归为 Win11,`10240–21999` 归为 Win10;`ProductName` 在 Win11 上可能仍显示为 `Windows 10 Pro`,不能单独用来判断系统版本。每个 worker 还会写入 `verify_mode`:默认是 `reusable_circuit_direct`。若 Win10 现场需要验证 Library Manager 原生菜单链,可在高级设置勾选“使用 Library Manager 原生 Verify(Win10 兼容测试)”,然后以单个 CBB 复测;该模式必须出现 `verify_invoke`、新的 `pcb_worker_started` 和最终 `READY`,菜单消失本身不算成功。 高级设置中的 `Mentor bin` 可填写 `lm\win32\bin`、`SDD_HOME` 或 `ReuseBlockImporter.exe` 的完整路径;工具会据此同时解析内容检查器和 `ExpeditionPCB.exe`。留空时会自动检查 `SDD_HOME`、`SDD_LM_BIN`、`CBB_MENTOR_BIN` 以及各本地盘符下常见的 `Mentor/<版本>/SDD_HOME`、`MentorGraphics/<版本>/SDD_HOME` 目录,并要求目录中至少存在一个 Mentor 可执行文件。发现结果在本次进程内缓存, 安装位置变更后重启工具即可重新扫描。 ## 批量策略 每个 CBB 独立执行并写入自己的 evidence 和结果行。可确认安全的单项失败允许继续;遇到 `ICDB_REPAIR_REQUIRED`、超时、原生会话释放未确认等情况,会停止整批并把后续项目标为 `SKIPPED`。点击“当前项完成后停止”或执行器返回 `QUEUE_STOP` 也会停止队列。 GUI 中状态为 `绿色 / Ready` 的条目不能勾选、也不会进入批量队列。 ### 批量状态桥(只读、默认启用) `tools/status_bridge/bin/CbbStatusBridge32.exe` 是与 Mentor EE 7.9 x86/MFC ABI 匹配的只读桥。它通过 `--server` 常驻 JSONL 读取 `IsVerifiedReuseBlock`,每个 LMC 默认只启用一个串行桥进程,每 500 条自动轮换;超时、桥崩溃或非法响应只影响当前 CBB,并立即写入检查点。桥不可用时状态是 `UNAVAILABLE/UNKNOWN`,绝不会被当成 `READY`。主 UI 默认启用 `authoritative_status`;如需临时兼容旧版图标/文件证据,设置 `CBB_STATUS_BRIDGE_MODE=legacy`。状态桥子进程会由工具自动设置只读调用所需的 `CBB_STATUS_BRIDGE_ALLOW_PRIVATE=1`,直接在命令行运行桥时仍需显式设置该变量。 合成基线(不调用 Mentor,不代表现场耗时)如下: | 条目数 | 完成 | 错误 | 进程轮换 | 总耗时 | | ---: | ---: | ---: | ---: | ---: | | 180 | 180 | 0 | 0 | 0.958 s | | 3000 | 3000 | 0 | 5 | 16.786 s | 原始结果保存在 `runs/benchmark-180.json` 和 `runs/benchmark-3000.json`;现场 Mentor 桥耗时需在目标机器另行测量。 ## 证据与日志 每次校验在 evidence 目录生成: - `events.jsonl`:`backup` → `pcb_launch`/`pcb_worker_started`(中心库绑定的 ReusableCircuit)→ `identity_verified` → `integration_status`(四项状态流转)→ `save_helper` → `saved_and_closed`(保存标记)→ `complete`; - `dialogs.jsonl`:被认领的弹窗及其控件 ID,未知弹窗原样记录; - `save.log`:`LICENSE_OK / SAVE_OK / IS_SAVED / POST_SAVE_SYNCHRONIZED / CLOSE_OK / QUIT_OK`; - `result.json`:状态、中心库标志读取结果、阻断原因; - `image-status-map.json`:按中心库路径隔离的本机动态 `image_id` 校准快照(当前格式 `schema_version=2`);旧版本或无版本缓存会自动忽略并重新校准,日志会记录当前样本、缓存样本、Ready 主 ID、未映射 ID 和逐项决策原因; - `backup/`:仅本地盘操作前的稳定文件副本;网络盘/UNC 跳过前置递归备份(`backup_skipped`);`database/LogFiles/tmp` 等易变目录和日志文件会排除,备份超时或失败不会阻断 PCB 校验。仅在成功且确认安全后清理该目录,失败时保留已有副本及日志;它不是完整数据库回滚备份。 超时采用无进展计时:界面和批量请求默认 600 秒无进展超时;它不是整个 CBB 的固定总时限,而是连续 600 秒没有可观察进展时才终止。PCB/COM 阶段切换、Project Integration 状态变化、保存标记变化和弹窗处理都会刷新计时器;重复的状态轮询不算进展。需要更快失败时仍可在界面将单项预算调低,但 30 秒只适合已确认 PCB 启动稳定的环境。 结果不会把“内容检查 PASS”冒充为中心库绿色状态:`library_flag` 只来自对条目状态的只读读取,读不到就是 `UNKNOWN`。Mentor 的树节点 `iImage` 是本机资源列表索引,不能跨安装固定写死为绿色;工具会在日志中为每个 CBB 记录 `image_id`,并从独立的 `Cert/Work` 持久化证据动态校准本机 ID。树 ID 可读时用于交叉核对,冲突不允许标记 Ready;LM 忙导致树 ID 暂时读不到时,完整的持久化证据仍可保留 Ready,缺少持久化证据的条目仍进入待校验。右键菜单文字(包括 `Unverify`)不参与状态判定。 ### 状态接口审计 本机 `SDD_HOME\lm\win32\bin\LibraryManager.tlb` 的官方 COM 类型库已做只读审计。`IMGCLMReuseBlock` 公开的成员只有 `type`、`Name`、`PartitionName`,没有 `Verified`、`Ready`、`Status` 或 `IsVerified` 属性;因此不能从官方 Library Manager COM 直接读取绿色标志。 `LMCDLL70.dll` 和 `LibManagerDBPI.dll` 的导出表中可以看到 Mentor 的实际状态链:`IsVerifiedReuseBlock`、`GetStatusRBInContextOfCL`、`VerifyReuseBlock`、`UnVerifyReuseBlock` 以及 `GetReusableCircuitVerificationStatus`。反汇编确认 `IsVerifiedReuseBlock` 会调用 `GetReusableCircuitVerificationStatus`,再根据输出状态返回布尔值。这已经证明 Mentor 内部存在正式的 Verify 判定逻辑,而不是单纯依赖图标。 这些导出是 32 位 MFC/C++ ABI,参数包含 `CStringT`、内部枚举和数据库对象;当前工具是 64 位 Python,不能直接用 `ctypes` 安全调用。公开可调用的 `-chkContents` 只返回 CBB 内容检查结果,不等价于树节点 Verify 状态,也不保证刷新图标。工具现在通过同 Mentor 位数和 MFC ABI 的 C++ 只读桥接进程调用 `IsVerifiedReuseBlock`,主程序通过 JSON/标准输入输出读取状态,不伪造 `CStringT` 或按地址调用。 主 UI 默认以 `IsVerifiedReuseBlock` 返回值作为 Ready/Pending 的唯一权威状态;桥不可用、超时或错误不会变成 Ready。旧版官方文件证据、TreeView 的 `iImage`/`iSelectedImage` 和状态图标仍保留在 legacy 模式中,用于兼容和诊断,不参与默认 Ready 判定。 ## 早期 CLI 入口(单独内容检查) `Invoke-CbbVerify.ps1` 仍然可用,只做 Logical-Physical 内容检查,不做 PCB 刷新: ## 早期 CLI 入口(内容检查) 安装包自带的 Tcl 脚本 `upc_utils.tcl` 使用 `ReuseBlockImporter.exe -chkContents` 做 Logical-Physical 内容校验。这条 CLI 仍可用于快速内容检查,但它**不等于** Library Manager 的条目 Verify: ```powershell powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\Invoke-CbbVerify.ps1 ` -LmcFile 'F:\path\mentor_lib.lmc' ` -BlockName 'CBB_NAME' ` -LibSpec 'YOUR_LIBSPEC' ` -DmsLoginConfig 'C:\path\dms-login-config' ` -EvidenceJson .\runs\cbb-name-verify.json ``` 命令使用固定的 `-logicalType LP` 和 `-chkContents`,输出报告默认落在 `.lmc` 同目录的 `LogFiles\restorerb_RULP__contents.log`。`pass` 必须看到 `content checking completed successfully` 且没有错误文本;缺少 DMS 登录配置、DMS 未连接、内容检查失败或超时都会阻断。CLI 结果不会自动冒充 Library Manager 的绿色状态。 ## 2026-09-28 r3 效率对比版 本轮只调整同步策略、减小高频调试落盘并增加现场计时,不更改 Mentor 启动路径、中心库路径修正、iCDB 地址处理或保存流程。 - 初始四项 `InSynch=2`:只执行一次 `ForwardAnnotate`。返回后重读四项,全部仍绿则直接 Save;若某项真正变为 `Required=1`,仅补做该项。错误、拒绝或未知状态仍阻断,不能把初始四绿当作 Verify 成功。 - 初始不是四绿:保留原来的完整四项同步路线。 - 取消弹窗代理逐次追加请求/响应文件。代理在同一台机器通过 `127.0.0.1` 的临时端口进行内存通信(随机令牌、请求关联和有界超时),不会连接网络库服务器;只写一次启动配置。 - 正常流程不生成连续窗口快照;`dialogs.jsonl` 只保存实际操作/错误,失败/超时时才保存最后的窗口现场。必要的弹窗监督仍运行,不能关闭它,否则许可/保存确认会卡住。 - `integration_status` 只在状态变化时落盘,不重复记录相同的四绿快照。 ### 现场时间读法 每项的 `result.json` 和新增 `performance.json` 都包含 `timings_seconds`。批量报告和界面结束摘要也展示时间,单位为秒。 | 键 | 含义 | | --- | --- | | `preflight` | 前置文件/工程检查 | | `worker_setup` | worker 启动到 Mentor 启动请求,含准备动作 | | `pcb_startup` | Mentor 启动到 COM 文档身份确认 | | `integration` | 整体同步阶段 | | `forward_annotation` | 第一项调用加等待稳定的实际耗时 | | `forward_annotation_call` | 第一项 COM 调用本身耗时,用于区分 Mentor 工作和外层等待 | | `synch_ces` / `load_ces` / `back_annotation` | 实际执行的后续动作,跳过的项不会写成假测量的 0 秒 | | `save` | 32 位保存 helper 中 `doc.Save()` 本身耗时 | | `post_save_check` | 保存后四项同步状态确认耗时 | | `close` / `quit` | 文档关闭 / 应用退出调用耗时 | | `save_close` | 整段保存关闭,含许可、确认、状态检查 | | `pcb_exit` | 保存关闭后到 PCB 退出和 Cert 检查 | | `library_flag` | 最终权威状态读取 | | `total` | 本项真实总耗时,包含清理(不含写最终报告的微小开销) | 阶段总计与动作/调用子计时重叠,不能把所有字段直接相加。父/worker 用单调时钟;helper 使用 VBScript Timer,处理午夜跨日,并明确记录计时来源。失败/超时的 `incomplete_timing_phases` 表示尚未结束的阶段,其数值只是已等待时间,不是完成耗时。 本机人工操作也约需 12 分钟,暂不将全部耗时归因于程序。界面、批量请求和同步函数的默认无进展预算统一为 **600 秒**,不是 10 分钟总时长上限;单个 Save 调用若超过 600 秒又没有任何新进展,仍会超时。重点比较 `forward_annotation_call`、`save` 和 `total`;本地测试通过不等于真实网络库已提速。 ## 2026-09-29 r4 稳定性修复 - 正常执行 Save/IsSaved/Close 完成后,必须由状态桥 `IsVerifiedReuseBlock` 返回 READY/raw=1 才确认 PASS/GREEN。Cert 不参与成功门禁,成功路径不再读取 Cert 文件状态。 - 最终桥读到 PENDING 或暂时不可用时,按立即、等 3 秒、再等 5 秒进行最多三次只读查询;不重复 Verify,不把 PENDING/未知/图标假装成 READY。 - 严格过滤现场发现的无控件 IME 语言栏。原生数据库打开失败归类为 Mentor 数据库错误,仅点 No,不打开额外日志窗口。 - 启动前一次性采集已知 JobPrefs/目录诊断;临时目录缺失只警告,绝不自动修复/删除数据库或锁文件。 - 仅失败时留存已知 Mentor 原生日志的最后 128 KiB/文件及多行错误,清理后的补采集 helper 最多 8 秒,不加成功流程的日志扫描。 - 每次批次自动输出完整 `batch-*.log` 和只包含失败项的 `failures-*.log`;两者共享批次标识,界面结果摘要展示两个路径。 - 保留 600 秒无进展预算、初始四绿只点第一项、网络盘不递归备份、内存 IPC 和真实阶段计时。 变更细节、已知原生错误的边界及现场复测清单见 `docs/2026-09-29-stability-r4.md`。本地回归测试通过不代表真实 Win10/网络库已全部修复。