Preserve tested Verify source, authoritative READY checks, bounded bridge retries, diagnostics and failure-only reporting. Include 336-test suite and packaging assets; exclude live Mentor samples, field logs, backups and distributions.
15 KiB
Library Manager 接口与树节点结论
1. 中心库激活
LibraryManager.Application 需要在 STA PowerShell 进程中创建。当前工作站的实测结果:
$app = New-Object -ComObject 'LibraryManager.Application'
$lib = $app.OpenLibrary('F:\Sync Tool Skyworth\Work Maps\Skyworth_CBB_Lib\Mentor_lib_EE7.9\mentor_lib.lmc')
$parts = $lib.Partitions(7)
可以读取库名称、完整路径、Reusable Blocks 分区和条目名称;不需要打开 DxDesigner 工程。若 .lmc 不存在、被锁定或 Library Manager 未完成初始化,COM 激活可能返回 0x80004005 (E_FAIL),必须记录 HRESULT 并停止。
2. 树节点操作
Library Navigator 使用原生 ATL:SysTreeView32(AutomationId 1022)。
Reusable Blocks和Logical-Physical未展开时,UI Automation 不会返回其子TreeItem;直接等待Logical-Physical会超时。- 可靠流程是先定位并展开
Reusable Blocks,再展开Logical-Physical,然后重新枚举子项。 - 当前控件的跨进程
TVM_GETITEM/TVM_EXPAND不能作为唯一生产路径:TVM_GETITEM需要目标进程内存,部分TVM_EXPAND调用会阻塞。生产实现应优先使用 UI Automation 的ExpandCollapsePattern;若模式不可用,报告unknown,不要盲点坐标。
3. Verify 接口
对 EE 7.9.5 Library Manager 类型库(LibraryManager.tlb)和已记录的 COM 接口进行检查:
ILibraryManagerApp:有OpenLibrary、ActiveLibrary、LMCModify等方法,没有Verify或 reusable-block 校验方法。IMGCLMLibrary:有Partitions(type)、Close、编辑器属性,没有Verify。IMGCLMReuseBlock:只有type、Name、PartitionName属性,没有校验方法。VerifyAutomation.dll中的IVerifyControl是 SI/PI 仿真 Verify 控制接口,不是 Library Manager CBB 条目 Verify,不能拿来替代。
因此 LibraryManager.Application 没有公开的 CBB Verify() COM 方法。正式的内容检查入口存在于安装包自带的 Tcl 脚本 D:\Mentor\7.9.5EE\SDD_HOME\lm\win32\lib\upc_utils.tcl:
补充检查 LMCDLL70.dll 和 LibManagerDBPI.dll 的导出表后,确认了真实的内部状态链:
LMCDLL70.dll导出IsVerifiedReuseBlock、GetStatusRBInContextOfCL、VerifyReuseBlock、UnVerifyReuseBlock;LibManagerDBPI.dll导出GetReusableCircuitVerificationStatus;- 反汇编确认
IsVerifiedReuseBlock会调用GetReusableCircuitVerificationStatus,并根据输出状态返回布尔值。
这不是猜测的图标映射,而是 Mentor 自己用于判断 Verify 状态的实现链。但是函数使用 32 位 MFC/C++ ABI(装饰名、CStringT、内部数据库对象),不能从当前 64 位 Python 进程直接安全调用。一次隔离桥接实验也证明,手工伪造 CStringT 内存布局会在 DLL 内部异常,因此不能用 ctypes 拼结构体绕过 ABI。正确接入方式是使用与 Mentor 同位数、同 MFC ABI 的 C++ 只读桥接进程,先封装 GetReusableCircuitVerificationStatus,再替换当前图标/文件回退判断;在桥接完成前,生产工具不调用这些导出函数。
proc runReuseBlockChkContents { rbType rbName lmcFile libspec dmsloginconf } {
# RULP (Logical-Physical) maps to LP
ReuseBlockImporter.exe \
-lmcFile $lmcFile -blockName $rbName -logicalType LP \
-chkContents -libSpec $libspec -dmsLoginConfig $dmsloginconf
}
该过程由 processReuseBlockChunk 在需要更新/验证的 RULP 条目上调用。它会把标准输出和错误输出重定向到:
LogFiles\restorerb_RULP_<名称>_contents.log(safeName 会把键名中的冒号等非法字符替换为下划线)。成功文本是 Reuse Block's content checking completed successfully!,失败文本是 Reuse Block's content checking failed!。实测缺少 DMS 登录配置时返回进程码 1,并输出 Login config switch is empty!,所以不能只看进程启动或窗口关闭来判定成功。
本工具的 Invoke-CbbVerify.ps1 已封装这条接口:COM 只负责确认 .lmc 和条目身份,ReuseBlockImporter.exe -chkContents 负责实际检查,结果必须同时满足成功文本且无错误文本才标记 pass;否则为 fail、timeout 或 unknown。当前证据尚不能证明脱离 Library Manager 的 CLI 调用会单独更新树节点颜色;最终红/黄到绿仍需在有 DMS 的工作站读取 Library Manager 状态确认。UI Automation 仅作为状态读取补充,不再作为 Verify 的触发机制。
4. 本地样本验证结果
CreateLibrary(path, 4)(kFLOW_NONE)生成的空库打开时报Unable to determine flow type。CreateLibrary(path, 1)(kFLOW_DX)生成的sample_verify_dx.lmc可以正常打开,但没有 CBB 条目,无法执行条目 Verify。- 将生产库文件和
ReusableBlocksLP复制到fixtures\cloned-library后,副本可打开并显示生产条目;对副本发送树导航和Verify菜单动作没有出现可读完成窗口。Library Manager 会重写副本.lmc,因此样本操作必须始终使用副本,不能用于生产库。
5. 2026-09-15 重启复测
重启后不预先打开 Library Manager,COM 仍可成功激活并执行 OpenLibrary():返回 mentor_lib,Reusable Blocks 分区数量为 2,条目包含 1GPHY_8211 和 1GPHY_RTL8211F_A。随后直接启动 .lmc 也能得到主窗口,状态栏为 Ready,树控件 ATL:SysTreeView32 存在且可用。结论:当前问题不是中心库文件缺失,而是树展开/Verify 完成信号的自动化契约尚未建立。
6. 后台菜单触发探针结果
Library Manager 的 CBB 右键菜单可通过目标树控件的消息路径后台触发:先向 ATL:SysTreeView32 投递 WM_MOUSEMOVE,再投递 WM_RBUTTONDOWN/WM_RBUTTONUP,最后通过 UI Automation InvokePattern 调用菜单项 Verify(AutomationId 194)。只投递右键按下/抬起会被路由到停靠面板菜单;只发送 VK_APPS 键盘消息不会打开 CBB 菜单。
生产实现只向本次启动的目标树窗口发送定向消息,不监听、不注入用户真实键盘,也不调用 SendInput 或切换用户前台桌面。命中点使用 UI Automation 的屏幕矩形;发送后必须同时找到唯一且启用的 Verify 菜单项。若 Win10 的 UIA InvokePattern 只返回成功但未关闭原生弹出菜单,则向该私有菜单窗口投递相对坐标的鼠标消息作为兜底,并记录 verify_menu_fallback,不执行其它菜单命令。
7. 2026-09-17 触发机制复测(结论修正)
第 6 节的结论不成立:在 7.9.5 的实际 Library Manager 上,消息路径无法打开 CBB 菜单。复测方式与证据:
| 触发方式 | 结果 |
|---|---|
投递鼠标消息(客户区坐标,含 ScreenToClient 换算) |
打开停靠面板菜单(Allow Docking / Hide / Properties…,AutomationId 43040/43041/12001) |
用 AttachThreadInput 真正把焦点设到树后再投递 |
同上,仍是停靠面板菜单 |
WM_CONTEXTMENU + 屏幕坐标(树 / 框架窗口) |
停靠面板菜单 / 无菜单 |
WM_CONTEXTMENU + lParam=-1(键盘调用标记) |
停靠面板菜单 / 无菜单 |
VK_APPS 键盘消息 |
无菜单 |
WM_COMMAND 194 广播到 LM 全部窗口(含 AfxWnd90 / AtlAxWin90 / 树) |
无任何反应 |
SendMessage 同步变体 |
LM 线程不处理,调用方阻塞挂起(已用看门狗确认堆栈) |
真实输入(pywinauto click_input)+ 输入桌面切换 |
✅ 成功打开 CBB 菜单并执行 Verify(12:13 的 private-click-result.json,连带拉起 ExpeditionPCB) |
键盘激活:VK_APPS 投递到树 / AtlAxWin90 / 停靠面板 / 框架窗口 |
无菜单(2026-09-17 23:43 复测,build/keyboard-menu.json) |
键盘激活:Shift+F10(WM_SYSKEYDOWN VK_F10 + 上下文位)同四个目标 |
无菜单 |
键盘激活:WM_CONTEXTMENU(-1) 投递到树 / ATL 宿主 |
仍是停靠面板菜单(与鼠标路径同一根因:回退到物理光标 (0,0)) |
键盘激活:WM_CONTEXTMENU(-1) 投递到停靠面板 / 框架窗口 |
无菜单 |
根因:LM 的导航器用物理光标位置(GetCursorPos)决定右键菜单归属,不读消息 lparam。在私有桌面上:
SetCursorPos返回False,光标恒为(0,0)(GetCursorPos实测),因此消息路径永远命中 (0,0) 处的停靠面板;- 要让真实输入生效,必须先把私有桌面切换为输入桌面(
SwitchDesktop)。
本机 2026-09-17 实测 SwitchDesktop 到新建桌面在多种进程上下文下均返回 False(agent 进程、非沙箱 shell、计划任务进程;GetLastError=0),因此生产代码不保留真实输入兜底。当前实现只在私有桌面内发送定向树消息,并要求唯一启用的 Verify 菜单项通过 UI Automation 调用;若菜单未出现,当前 CBB 失败并保留完整窗口/菜单证据,不会误点其它命令。
结论:鼠标与键盘两条 UI 触发路线都无法在用户输入桌面上安全复现。历史上曾验证过直接启动 ReusableCircuit PCB,但它只能完成 PCB 保存,不能把 LMC 的 Verify 状态提交为 READY。因此当前生产实现已改为在私有桌面内定位 LMC 树节点并调用原生 Verify;后续仍复用同一 PCB/COM/保存链路。该路线同样需要 iCDB 设计服务器端口(10000-10100)。
8. 2026-09-17 跑通流程复现与真实阻断点
build/background-trials/verify-54a3af873736 是一次完整跑通的记录(生产中心库,Audio_D2128_ESD)。它的流程没有任何 Library Manager 菜单步骤:
23:03:40 backup
23:03:41 pcb_launch D:\Mentor.9.5EE\SDD_HOME\wg\win32in\ExpeditionPCB.exe <pcb> -ReusableCircuit
23:05:13 identity_verified COM 文档身份 = Work\Audio_D2128_ESD.prj / Audio_D2128_ESD.pcb
23:05:13 integration_status {ForwardAnnotation:2, SynchCES:2, LoadCES:2, BackAnnotation:2}
23:05:26 saved_and_closed LICENSE_OK/SAVE_OK/IS_SAVED/POST_SAVE_SYNCHRONIZED/CLOSE_OK/QUIT_OK
23:05:27 complete PASS,中心库 Cert 工程已更新
历史结论:Library Manager 的 Verify 菜单内部会启动同一个 ReusableCircuit PCB,因此直接命令行启动曾经可以复现 PCB 内部动作,但无法替代 LMC 菜单本身的状态提交。当前生产主线(mentor_adapter.execute_job)改为 library_manager_verify.launch_library_verify 的原生 Verify 调用,再绑定其创建的 PCB 进程:
| 环节 | 证据 |
|---|---|
| PCB 命令行 | pcb_launch 事件(含 wg\win32in 路径与 -ReusableCircuit 开关) |
| 启动期弹窗 | dialogs.jsonl:Select the desired product license(控件 1)、Tip of the Day(控件 1)、Do you want to save the Reusable Block cell?(控件 6=IDYES) |
| 保存/关闭 | cscript 助手输出六个标记,缺一不可 |
| 提交确认 | 中心库 Cert\<prj>.prj 的 mtime 必须变化,且 Cert\PCB\Layout\LayoutDB.lyt 存在 |
真实阻断点:iCDB 设计服务器端口被系统保留
2026-09-17 之后的复跑全部失败,Work\PCB\LogFiles\PCBLogFile.txt 写明:
No server is running for the project and could not bring it alive (Could not run server)
对应 Work\database\cdbsvr\log\<时间>/<日期>.txt 的根因:
ERROR: Could not listen for client connections: Socket Exception ... BindFailed
ERROR: NoNetworkPortAvailable ... No free network port in range [10000 - 10100]
本机 netsh int ipv4 show excludedportrange protocol=tcp 显示 9930-10029、10030-10129 等保留区间把 10000–10100 全部覆盖,Python 直接 bind() 也返回 WinError 10013(而 12000 可绑定)。这是 Hyper-V/WSL 的动态端口预留,不是工具缺陷。
修复(需管理员):net stop winnat && net start winnat。工具已内置该检测:命中时立即以 BLOCKED 结束并给出上述命令,不再等到超时。
目录/数据问题的条目
同一中心库里 1GPHY_8211(Work 下无唯一 PRJ)与 1GPHY_RTL8211F_A(PRJ 指向不存在的 1GPHY_RTL8211F.pcb)在 preflight 阶段即 BLOCKED,与刷新流程无关,属条目数据问题。
9. 2026-09-24 Verify 导出只读探测
新增 tools/status_bridge/bin/VerifyProbe32.exe --probe-exports。探测桥使用与
Mentor EE 7.9 相同的 x86 进程加载 LMCDLL70.dll 和 LibManagerDBPI.dll,只调用
GetProcAddress,不调用任何 Verify/UnVerify 写接口。
本机实测返回五个导出:
IsVerifiedReuseBlock:找到,地址0x100544E0;GetStatusRBInContextOfCL:找到,地址0x1006DDC0;VerifyReuseBlock:找到,地址0x10057840;UnVerifyReuseBlock:找到,地址0x10061B40;GetReusableCircuitVerificationStatus:找到,地址随模块加载基址变化。
探测响应明确标记 write_call.enabled=false。首次实现曾在结束时主动卸载 DLL,进程
出现 0xC0000374;移除 FreeLibrary 后正常退出,说明 Mentor 的 MFC/DBPI 模块
状态不能由短桥主动卸载,只能让操作系统在进程退出时回收。
这次探测确认了“写导出存在”,但没有确认 CFilename 的构造 ABI。因此正式工具仍
只使用 IsVerifiedReuseBlock 读取状态;VerifyReuseBlock 需要继续在隔离 .lmc
副本上完成 ABI 构造和前后状态验证后,才可讨论接入。
10. 2026-09-25 原生 CLibServer 生命周期与 Verify 阻断点
在隔离目录
diagnostics/native-verify-probe-20260925/ 中新增了 Win32
NativeVerifyProbe32.exe。它复现 Mentor 自带 RFSymMergeUtility.exe 的只读
生命周期:
operator new(0xC)
CLibServer(path)
Init()
Load(path, 1)
Close()
~CLibServer()
实机输出为 init_return=0、load_return=0、closed=true、destroyed=true,
隔离 LMC 的 SHA256 在 probe 前后保持
7701DC9661088BAF7AB3A08861B7BE0E2C9B016E0BF158B60AF6597E73246A73 不变。这
确认了 x86 __thiscall、12 字节对象大小、窄字符路径和 Load 模式 1,但没有
调用任何 Verify/Save 写接口。
进一步静态审计确认:
SetVerifyRCCellsFlag(int)只是把值写到this的首字段;VerifyRCCells(int)的唯一直接调用点在CLibServer::Save内部;vbcam_tl.exe只调用构造/Init/Load 和分区枚举,没有 Verify/Save;RFSymMergeUtility.exe的保存顺序是Save(NULL,0,0)后检查数据库再Close(), 但它没有调用 Verify 导出本身。
随后在隔离副本上执行了一次受保护的 Save 驱动实验:
SetVerifyRCCellsFlag(1)、Save(NULL,0,0),并在进程退出后重新读取状态。结果为:
Init=0、Load=0、Save=0,关闭和析构正常;- 只改写了副本
mentor_lib.lmc,ReusableBlocksLP未变化; - 状态桥仍返回
IP101GR=PENDING。
这证明低层 CLibServer Save 成功并不等于 CBB Verify 状态提交成功。缺失的提交
上下文仍由 Library Manager 的 reusable-block/PCB certificate 链路持有。因此生产
工具继续只使用只读 IsVerifiedReuseBlock 状态桥和原有 LMC/PCB Verify 流程;不再
尝试把 VerifyRCCells(0/1) 或 SetVerifyRCCellsFlag 直接接入生产。