Files
cbb-refresh-verify-795/API-FINDINGS.md
T
阿白叔 11a2b2e46e Import CBB refresh verify r4 stability baseline
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.
2026-09-29 15:05:20 +08:00

209 lines
15 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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` 直接接入生产。