2026-11-20 16:50:48 +08:00

CBB 中心库上传后校验工具

当前临时分支的备份策略(2026-11-03):应用不再自动备份中心库或 CBB 工程。新增、替换、移除、校验、ICDB 维护和恢复在执行前提示手动备份;请自行保留可用副本。导入暂存、恢复用隔离验证库和轻量操作证据仍会生成,Mentor 原生 Repair 自身的备份行为保持不变。详见自动备份检查与调整。此条优先于下方历史版本的备份说明。

当前测试版本:0.2.4b3(待现场验收)。ICDB 批量检查在后台逐项运行,普通校验、管理和恢复可排队;READY 工程在实际执行前再次排除。检查不自动 Repair、Restore 或选择历史版本,也不代表中心库 READY。

管理写入因无法完成占用确认而未执行,或恢复安装前选择跳过,结果为 SKIPPED;取消为 CANCELLED,与实际操作失败区分。文件身份核对失败保留“需要恢复”,后续独立 CBB 依据各自会话释放和写前检查决定是否继续,不自动重放失败目标。

停止、超时或应用失联只停止后续原生动作,不结束正在 Save/Close 的调用进程。普通停止等待 5 秒,可能正在写入时最多等待 120 秒后交给后台观察;这不是强制结束时限。保存结果、关闭结果和资源释放分别记录。相关库等待释放,独立库可以排队继续;界面、筛选和日志保持可用。重启只核对未完成会话,不重放管理写操作。legacy 状态读取只观察已打开且匹配库的 LM,不启动 LM 或回答弹窗;无法读取保持 UNKNOWN。

历史释放记录会触发实际占用复核,确认释放后归档继续;会话释放不等于历史数据恢复。释放结果逐项保存;记录保存失败会单独显示,不把已确认释放的会话重新标成占用。可查看后台窗口的原生提示;仅对当前可识别的原生取消按钮提供确认操作。

自动流程不强杀原生会话;释放入口默认正常关闭。另有单独确认的“强制结束客户端”操作,仅限属于当前 Windows 用户和会话、归属及进程身份已确认的 PCB、Library Manager、DxDesigner/viewdraw、iCDB Project Backup 客户端。ICDB 数据库服务器、后台导入器和归属未知的进程不允许强制结束,即使命令指向当前库也不例外。客户端中其他已打开工程可能一并退出、未保存更改可能丢失;必须先记录确认名单,结束后重新证明库已释放,不能宣称数据库已修复。详见 操作规程 与 版本说明。下方日期记录为历史行为,以本说明为准。

本目录是独立的 CBB 检验、ICDB 维护和中心库管理工具,不属于 Part Replacement;管理入口接收已整理好的完整 PRJ/PCB 工程。

导入不运行 ASCII、CSV 或 EDIF 导出。新增/替换确认原生注册、目录复读、工程关联、顶层块及 Layout;顶层块允许保持来源名,或由原生导入改为本次 CBB 注册名,映射会单独记录。其余工程文件差异保留清单供核对,不以原生改写 PRJ 或运行历史判定导入失败。原生重写 ICDB 后不比较其原始字节,也不宣称已证明原理图语义等价。上传后自动校验可独立勾选,只有完整原生 Verify 和权威 READY 才显示校验通过。无效来源或已释放的单项失败逐项报告,不影响后续独立条目。

针对 The last server session ... lost the connection to the database,修复分支增加 ICDB_REPAIR_REQUIRED 专项识别、共享符号库路径诊断及停止批次处理。现场原生修复步骤及实现边界见 iCDB 旧服务器会话失联分析。 当前应用入口仅检查工程打开情况,不自动 Repair。需要修复或回退时由用户在原生版本与备份界面选择,操作前请手动备份;共享符号库故障不得通过修复无关的 CBB 工程替代。

当前验证范围与已知限制

Windows 11 / Mentor EE7.9.5 隔离库已完成原生更新、备份恢复、校验到 READY 和释放验证,记录见 2026-11-12 验证。历史候选包仅证明对应提交,后续代码合并不等同于现场验收或正式发布。

  • A/B 输入的独立 EDIF 导出曾返回 0xC0000005,根因尚未定位;该导出已从普通导入流程移出,不能据此判定导入失败或 ICDB 损坏。
  • Windows 10、跨机器共享库和现场服务器会话失联的一致故障副本尚未验收。跨机器释放依赖 SMB 共享模式语义,目前没有跨机器实测证明。
  • 自动 ICDB Repair 保持关闭。共享库原生服务器若无法删除自身地址文件,或早停后仍有原生弹窗,需要继续核对;不以进程列表为空或端口不可达代替释放证明。
  • 验收文档中的本机路径、原始日志、截图、测试 XML 和冻结包不随 Git 分发;仓库保留说明及摘要,原始材料须在验收机器查看或另行归档。

功能边界

工具 处理对象 核心动作 结果
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.exe -NoProfile -ExecutionPolicy Bypass -File .\CBBRefresh.ps1 `
  -StatusJson .\examples\project-integration-before.json `
  -OutputJson .\runs\sample-report.json

输出会给出下一项应执行的 Verify 动作、是否已经全部通过、阻断原因和证据摘要。

已定位的正式 Verify 入口

运行真实校验前可先检查本机环境:

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.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.exe -NoProfile -ExecutionPolicy Bypass -File .\CBBRefresh.UiProbe.ps1 `
  -WindowTitlePattern 'Library Manager' `
  -OutputJson .\evidence\library-manager-ui.json

探针只读窗口控件,不执行点击;输出中的 patterns 用于确认 Verify 菜单项、Verify 对话框按钮和状态节点是否支持语义化 InvokePattern。

离线回归测试:

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 工程已更新,并只读读取条目状态标志作为证据。

运行:

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。
  • 超时或失败时请求合作停止,保留可能正在原生调用的 worker 和保存/关闭助手,并交后台观察。内容检查超时同样不强杀进程树。保存结果未知时不再自动丢弃关闭;无保存助手且身份、空闲状态已确认的启动/集成失败仍可正常收尾。无法确认释放时保留 recovery-required.json 和相关库租约。

环境要求

依赖 说明
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 错误本身不等于占用。用户取消或执行器明确返回 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 秒没有可观察进展时进入停止与观察流程,不强杀正在进行的调用。PCB/COM 阶段切换、Project Integration 状态变化、保存标记变化和弹窗处理都会刷新计时器;重复的状态轮询不算进展。需要更快失败时仍可调低单项预算,但 30 秒只适合已确认 PCB 启动稳定的环境。

结果不会把“内容检查 PASS”冒充为中心库绿色状态。默认权威桥读取 READY/raw=1;桥失败保留未知/不可用。显式 legacy 模式只观察已有匹配 LM 的树图标,图标不可读时保持 UNKNOWN,不以 Cert/Work 文件直接推断 READY 或 PENDING,也不自动回答原生提示。右键菜单文字(包括 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.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/网络库已全部修复。

S
Description
Mentor EE7.9.5 CBB refresh/verify tool - tested r4 stability baseline
Readme
8.9 MiB
0 Stars 8 Watchers 0 Forks
Languages
Python 97.6%
C++ 1.1%
PowerShell 1%
VBScript 0.3%