Files
cbb-refresh-verify-795/README.md
T

285 lines
24 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# CBB 中心库上传后校验工具
当前补丁:**[v0.2.2-beta.1](docs/releases/v0.2.2-beta.1.md)(Beta 预发布,待现场验收)**,替代 0.2.1。数据库所有权或关闭状态不确定时停止批次、保留现场;不自动移走地址文件、接管带锁设计或强杀 PCB 进程树。已修复真实试跑发现的已验证块重复 Forward Annotation 问题,以及工程文件编码、目录越界、互斥和依赖漏洞。详见 [本地验证与安全审查](docs/releases/2026-10-26-local-validation-and-audit.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_<CBB_NAME>_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 <Work\\PCB\\name.pcb> -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 <pcb> -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_<CBB_NAME>_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/网络库已全部修复。