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

15 KiB
Raw Blame History

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 直接接入生产。