287 lines
25 KiB
Markdown
287 lines
25 KiB
Markdown
# CBB 中心库上传后校验工具
|
||
|
||
当前临时分支的备份策略(2026-11-03):应用不再自动备份中心库或 CBB 工程。新增、替换、移除、校验、ICDB 维护和恢复在执行前提示手动备份;请自行保留可用副本。导入暂存、恢复用隔离验证库和轻量操作证据仍会生成,Mentor 原生 Repair 自身的备份行为保持不变。详见[自动备份检查与调整](docs/releases/2026-11-03-manual-backup.md)。此条优先于下方历史版本的备份说明。
|
||
|
||
当前补丁:**[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_<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/`:历史版本的辅助文件副本;当前分支不再生成,所有路径记录 `backup_skipped / manual_backup_policy`。已有历史副本不由本轮改动清理。
|
||
|
||
超时采用无进展计时:界面和批量请求默认 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/网络库已全部修复。
|