Files
dxdesigner-part-replacement/docs/research/2026-10-17-internal-module-cli.md
T

5.6 KiB
Raw Blame History

内部模块能否通过 CLI 调用

已验证本机存在可工作的 厂商脚本 CLI → VBS → 内部 COM DLL 调用链。当前跑通的是指定符号的库引脚映射查询,尚未取得可直接完成精确料号替换的调用合同。

已跑通的入口

安装的两个脚本宿主都支持并实际执行了 VBS:

D:\Mentor\7.9.5EE\SDD_HOME\wv\win32\bin\icscript.exe "<library-query.vbs>"
D:\Mentor\7.9.5EE\SDD_HOME\common\win32\_bin\mgcscript.exe "<library-query.vbs>"

脚本的核心调用为:

Set part = CreateObject("CentralLibSvr.LibPart.1")
part.CentralLibraryPath = "<中央库完整路径.lmc>"
part.PartNumber = "4100-CA0000-T0"
Set maps = part.PinMaps("skyworth:res01", 1)

脚本通过 FSO 把查询结果写到任务输出目录,不依赖厂商脚本宿主提供 WScript.Echo。测试环境设置了 SDD_HOME、SDD_PLATFORM=win32,并把本套安装的 common/win32/lib、common/win32/bin 加入该子进程的 PATH;没有修改用户环境变量。

实际宿主 退出码 完整启动、查询与收尾耗时 结果
icscript.exe 0 1.172 秒 指定符号返回 2 个引脚映射
mgcscript.exe 0 0.844 秒 指定符号返回 2 个引脚映射
32 位 cscript.exe 0 1.016 秒 同一 COM 类可创建,读取映射 1→1、2→2

它们不需要启动 CAD。本次每个调用都在自有私有桌面与 Job 中运行,15 秒有界等待;本轮均正常退出并释放。两个厂商宿主查询前后的中央库 .lmc SHA256 未变。

同一个库对象中,PinMaps("skyworth:res01", 1) 返回 2 项;skyworth:res01.1 和 res01 返回 0 项。这说明已经验证的名称合同是带分区、不带 .1 的形式,不能混用。

这还不是料号存在性校验。 独立对照发现,合法料号和不存在的 DX_RESEARCH_PART_DOES_NOT_EXIST 都得到 HasPins=1 且无错误;PartNumber 的回读也不能排除只是返回刚设置的属性。不能用它替代 DataBook 的精确料号匹配。这里确认的是 COM 调用和指定符号的引脚映射读取。

注册的内部 COM 类

32 位注册表与文件内类型库一致,关键类为:

模块 ProgID 已确认的暴露方式
dxdatabook.ocx DxDataBook.AddinCtrl.1 进程内 ActiveX;本轮只检查注册与接口,未独立实例化运行中的 CAD 控件
CentralLibSvr.dll CentralLibSvr.LibPart.1 进程内 COM;上述脚本已实际调用
CentralLibSvr.dll CentralLibSvr.PinMaps.1、CentralLibSvr.PinMap.1 注册的映射对象;本轮从 LibPart 的返回对象读取
CentralLibSvr.dll CentralLibSvr.ExpProjEditor.1 注册的工程编辑器对象;未调用其打开工程方法

这些类使用 InprocServer32,不是各自带参数的替换 EXE。可以用支持对应位数的脚本宿主封装调用;本机 32 位 cscript.exe 的路径是 C:\Windows\SysWOW64\cscript.exe。普通 rundll32 的回调合同与内部 COM / C++ 方法不同,不能据 DLL 导出存在就直接调用。

对替换核心候选的断点验证

针对上一轮发现的 ICE70!CICEController::replaceSymbols,在新的可丢弃工程副本上设置一次性导出入口断点。先在独立 32 位 PowerShell 测试进程中显式调用 KernelBase!GetCurrentProcessId,验证断点命中、读取寄存器、恢复原指令字节及 EIP、继续执行并正常退出。该控制探针验证通过后才用于 CAD。

本轮 CAD 验证完成:RV05 从 4100-CA0000-T7 换为 4100-CA0000-T0,RV11 保持旧料号;开启 PartLabel 复制,两者 Value 均为 0R。保存、重开核验、独立磁盘读回均通过,来源工程哈希不变,CAD 和私有桌面均已释放。调试器记录 7,021 个事件,所有跟踪进程正常退出。

导出入口的断点命中次数为 0。 运行中对地址映射做了补充检查:临时加载的第一处 ICE 地址后来已被 BusContents.dll 使用;当前有效 ICE 映射仍保留所设断点。因此不能把临时模块地址当作始终有效的调用地址。

还有两个必须保留的范围限制:

  • 此次新旧料号使用相同的 skyworth:res01 符号,不能推断更换不同符号时也不经过该入口。
  • 导出 RVA 0x17c800 起始指令为 mov ecx,[ecx+4],随后直接跳转至 RVA 0x17bd80。本轮只在导出入口设断点,未在后者设断点;内部调用可能直接进入后者或其他实现,不能用入口零命中证明内部方法未参与。

因此,当前不能把这个候选发布为可调用替换 CLI,也不能从几个布尔参数推断 Library Wins。继续研究应优先核对内部跳转目标的调用栈,以及原生替换窗口如何从 DataBook 的选中事件取得库件对象和映射。

对工具的意义

内部模块并非无法调用:库查询已经存在实际可用的脚本 CLI 路径,可以继续研究批量读取中央库符号和引脚映射。执行替换的精确范围、Library Wins、连接保持、Undo 和保存回读仍需要单独证明;本轮没有修改正式替换后端,也没有打包。

取证摘要:内部模块 CLI 证据。一次性探针和原始输出保存在 build/internal-module-script-hosts-20261017/、build/native-internal-breakpoint-20261017/;脚本为 build/probe_library_module.vbs、build/debug_internal_replace.py、build/oneshot_native_breakpoint.py。早期断点控制探针的失败记录也保留,后续复用探针时需继续核对模块卸载、重载及实际地址。