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

70 lines
5.6 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.
# 内部模块能否通过 CLI 调用
已验证本机存在可工作的 **厂商脚本 CLI → VBS → 内部 COM DLL** 调用链。当前跑通的是指定符号的库引脚映射查询,尚未取得可直接完成精确料号替换的调用合同。
## 已跑通的入口
安装的两个脚本宿主都支持并实际执行了 VBS:
```text
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>"
```
脚本的核心调用为:
```vbscript
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 证据](2026-10-17-internal-module-cli-evidence.json)。一次性探针和原始输出保存在 `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`。早期断点控制探针的失败记录也保留,后续复用探针时需继续核对模块卸载、重载及实际地址。