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.
209 lines
15 KiB
Markdown
209 lines
15 KiB
Markdown
# Library Manager 接口与树节点结论
|
||
|
||
## 1. 中心库激活
|
||
|
||
`LibraryManager.Application` 需要在 STA PowerShell 进程中创建。当前工作站的实测结果:
|
||
|
||
```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`,再替换当前图标/文件回退判断;在桥接完成前,生产工具不调用这些导出函数。
|
||
|
||
```tcl
|
||
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` 的只读
|
||
生命周期:
|
||
|
||
```text
|
||
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` 直接接入生产。
|