25 KiB
CBB 中心库上传后校验工具
当前临时分支的备份策略(2026-11-03):应用不再自动备份中心库或 CBB 工程。新增、替换、移除、校验、ICDB 维护和恢复在执行前提示手动备份;请自行保留可用副本。导入暂存、恢复用隔离验证库和轻量操作证据仍会生成,Mentor 原生 Repair 自身的备份行为保持不变。详见自动备份检查与调整。此条优先于下方历史版本的备份说明。
当前开发版本:v0.2.4-beta.1(待评审、待现场验收)。ICDB 批量检查在后台逐项运行,普通校验、管理和恢复可排队;READY 工程在实际执行前再次排除。检查不自动 Repair、Restore 或选择历史版本,也不代表中心库 READY。
自动流程不强杀原生会话;释放入口默认正常关闭。另有单独确认的“强制结束客户端”操作,仅限属于当前 Windows 用户和会话、归属及进程身份已确认的 PCB、Library Manager、DxDesigner/viewdraw、iCDB Project Backup 客户端。ICDB 数据库服务器、后台导入器和归属未知的进程不允许强制结束,即使命令指向当前库也不例外。客户端中其他已打开工程可能一并退出、未保存更改可能丢失;必须先记录确认名单,结束后重新证明库已释放,不能宣称数据库已修复。详见 操作规程 与 版本说明。下方日期记录为历史行为,以本说明为准。
本目录是独立的 CBB 中心库上传后校验工具,不属于 Part Replacement,也不负责 CBB 工程复制或中心库上传。
针对 The last server session ... lost the connection to the database,修复分支增加
ICDB_REPAIR_REQUIRED 专项识别、共享符号库路径诊断及停止批次处理。现场原生修复步骤及实现边界见
iCDB 旧服务器会话失联分析。
当前应用入口仅检查工程打开情况,不自动 Repair。需要修复或回退时由用户在原生版本与备份界面选择,操作前请手动备份;共享符号库故障不得通过修复无关的 CBB 工程替代。
功能边界
| 工具 | 处理对象 | 核心动作 | 结果 |
|---|---|---|---|
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
现场流程
- 确认中心库上传动作已经完成,并记录中心库文件、CBB 名称和源工程。
- 在 Library Manager 中定位刚上传的 CBB 条目,确认名称和来源匹配。
- 对该条目执行原生
Verify,按对话框要求完成检查。 - 每一步完成后重新读取条目状态;错误、红色标志或状态未知时停止。
- 确认 Verify 结果、CBB 条目标志和错误状态全部为绿色。
- 保存并关闭 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 执行一次真实刷新:
- 只读确认中心库条目与
.lmc存在; - 如填写了
LibSpec与 DMS 登录配置,先执行一次ReuseBlockImporter.exe -chkContents内容检查(失败即阻断,不触碰 PCB); - 在私有桌面上用命令行启动该 CBB 的 ReusableCircuit PCB(
ExpeditionPCB.exe <pcb> -ReusableCircuit,即 Library ManagerVerify菜单内部执行的动作); - 通过 COM 核对文档身份、执行 Project Integration(四项 InSynch)、保存 Reusable Block cell 并关闭;
- 确认中心库
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。 - 超时或失败时停止自动化客户端,保留可能仍在写库的原生会话并停止批次。内容检查超时也不再强杀整个进程树;监督器核对进程是否退出,记录
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.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/网络库已全部修复。