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

9.9 KiB
Raw Blame History

替换 CLI 替代:核心调用与无弹窗实验

这份记录继续验证本机 Mentor 7.9.5EE 的实际替换路径。同符号、单 gate、相同引脚映射的无弹窗替换已有真实验证路径:原生 DLL 查询物料 → COM 在原 UID 上应用库属性和引脚号 → 保存重开 → 原生 CLI 独立读回。它需要 CAD 进程,并非独立编辑数据库的替换 EXE。正式替换后端未切换,没有打包或发布。

已确认的原生提交链

在全新 Audio 测试副本中,只替换 RV05,保留同料号 RV11。多断点跟踪完成原生替换、保存重开和独立磁盘读回,全部跟踪进程退出,私有桌面释放,来源工程哈希未变。

实际命中顺序(均为本机二进制 RVA):

阶段 模块与入口 证据
打开替换窗口 viewdraw.exe 0x207bd0 → 0x167880 WM_COMMAND 33977 的 MFC handler 与委托函数均命中
接收选料 viewdraw.exe 0x168190 返回地址位于 PlaceDevice.dll 0x1e67b
提交替换 viewdraw.exe 0x432f90 返回地址为 viewdraw.exe 0x262676,对应调用点 0x262671

0x432f90 也是旧 ccomp 命令静态引用的核心。命令 handler 传入多个空字符串,原生选料提交路径传入目标数据;存在共同核心不代表 ccomp 已提供完整的料号替换参数。

本次提交栈的 flags 为 9。提交后只读检查相关内存,取得目标料号 4100-CA0000-T0、Part Name RESC1608N、Part Label 0R,与实际读回一致。该检查发生在函数返回之后,仅作辅助证据,不能用于认定完整参数类型或对象生命周期。

ICE70.dll 的 replaceSymbols 导出入口 0x17c800 及内部跳转目标 0x17bd80 均未命中。调试器跟踪了模块卸载和重载;结论仅适用于这次同符号替换,不能推广到所有替换。

PlaceDevice.dll 有 NotifySelectionObservers、SelectLibrarySymbol、CreatePDController 等 C++ 导出,当前没有取得可用类型库。它传递选择事件并需要已初始化的 CAD、库服务及回调对象,不能作为独立替换 EXE 调用。

公开 API 的实际边界

  • AddPartInstance("skyworth", "4100-CA0000-T0", "res01.1", x, y) 已无弹窗创建库件,取得真实 Part Name 和 Part Label。第一个参数在此安装中需要符号分区。
  • ChangeComponentPreserveRefdes 的两个参数均为字符串。传精确 UID 报未找到器件;传符号名时,即使只选择 RV05,也实际改变页内 19 个同符号器件,包含 RV11,并清空部分物料属性,不能用作精确位号替换。
  • 创建新器件后删除旧器件,即使坐标与方向一致,也会失去旧引脚网络连接;零长度 AddNet 未能恢复。这条实验路径已排除。

直接接口的范围证据见 JSON。

同符号原位实验与属性层级

原型通过 AddPartInstance 创建远处未连接的目标模板,从库模板取得属性,再应用到原器件;删除模板,保留原器件 UID、坐标、方向和连接。仅覆盖单 gate、同符号、同引脚编号集合。

首个原型只写 InstanceValue。CAD 保存重开核验通过;当前工具的分层清单却仍返回旧料号。进一步用 icdb2ascii 的 flat 和 instance 报告核实:新料号和封装已写到实例属性,基础属性仍旧。不能把该现象误判为完全没有保存,也不能忽略分层采集与有效实例值的差别。

该原型与原生替换的 flat 输出已逐器件、逐引脚比较:57 个器件、103 个引脚、22 个网络一致。比较保留引脚对应的连接,仅忽略同层属性顺序。分层输出仍有差别,因此尚未将它认定为等价的正式后端。

只改 Value 的对照实验在 Part Name 的有效值断言处失败,说明已有实例值会覆盖基础值。同时写基础与实例属性后,料号独立读回通过;再把目标引脚的 Pin Number 基础值和实例值一起同步,才补齐原生替换在分层输出中的引脚号。

最终批量实验只修改三个目标,使用同一个真实库模板,覆盖旋转及 Value/NC 选项:

位号 原方向枚举 新料号 最终 Value 核验
RV05 0 4100-CA0000-T0 0R 与原生 GUI 基准完整比较
RV14 1 4100-CA0000-T0 0R/NC 保留旧 NC、检查预期字段变化
RV02 3 4100-CA0000-T0 2.2K 保留旧 Value、检查预期字段变化

保存重开后,三个 UID、位置、方向、比例、属性显示样式与引脚网络均通过核验,独立清单返回上述结果,RV11、RV08、RV19 等未选中同料号器件不变。分层和展开的完整输出均核验 57 个器件、103 个引脚、22 个网络:54 个未选中器件不变,所有连接保持一致;RV05 与原生 GUI 基准相同。RV14/RV02 没有各自再跑一轮 GUI 对照,不能宣称所有选项均已证明与 GUI 等价。

实际研究命令为 python build/probe_headless_batch.py build/<新的输出目录>,会复制固定 Audio 测试工程,在自有私有桌面打开新副本;不是面向任意生产工程的正式命令。来源测试工程的 .prj 与 icdb.dat 哈希核验通过,CAD 正常退出,桌面释放。

料号有效性与真实库接口

负例证实:AddPartInstance 接受不存在的 DX_RESEARCH_PART_DOES_NOT_EXIST,生成空 Part Name/Part Label 的器件。因此必须先查真实库,不能靠设置 PartNumber 后回读、HasPins、GetSlotsCount 或创建模板成功判断料号有效。

已验证安装自带命令:

ListWGLib.exe <中央库副本.lmc> PDB <输出.txt>

本次在只含中央库文件及 PartsDBLibs 的副本上执行,退出码 0,列出 20 个分区、9,436 条料号,来源库哈希未变。它返回 分区:料号,可以精确匹配料号,不能单独证明料号关联哪个符号。

进一步将 PartsDB40.dll 实际导出封装成 32 位研究 CLI,已成功读取关联符号。可复用查询源码保留在 native_parts_query.cpp,编译说明见 README:

native_parts_query.exe <原生DLL目录> <分区副本.pdb> <料号>

调用 GetPartsDBPtr 创建对象,再调用导出的 Loader、GetPartEnum、GetPartNumber、GetPartName、GetPartLabel、GetSymDfnList、GetSymDfnName;枚举与数据库对象均 Release。使用简单指针和整数参数,没有构造厂商 STL/MFC 对象,也没有调用未导出的进程地址。

查询 真实返回 单次子进程调用耗时
4100-CA0000-T0 RESC1608N / 0R / skyworth:res01 0.313 秒
不存在料号 matches 为空 0.359 秒
4300-CC1040-7100 CAPC0603X30N / C/100NF/16V +/-10% X5R / skyworth:cap01 0.391 秒

这三个进程退出码为 0,PDB 副本字节不变。matches=[] 是未找到料号,调用方必须处理,退出码 0 只表示查询完成。以上是库查询耗时,不能当作替换或全流程耗时。接口 ABI 只在本机 x86 DLL 上验证,不是厂商承诺的公开接口。

复核后补齐属性读取失败返回、符号指针/数量校验、UTF-8 输出及对象/模块释放。最终源码重新编译,前三种实际查询及中文请求名回传均通过,耗时 0.297~0.375 秒;缺少 DLL 的负例返回非零退出码 2。中文回传验证的是参数与序列化,不等于已验证所有中文 PDB 元数据的实际代码页。

命令边界与后续接入条件

带前导冒号的 ccomp :skyworth:cap01.1 仍弹出 Change Component。附加 1 的实验返回 True,却触发“提交数据库事务被拒,正在重新导入项目”,当前视图丢失。因此 ExecuteCommand 的 True 也不是替换成功证据;这两种写法均排除。该实验未主动保存,视图丢失后不能认证副本的最终器件状态;来源测试工程哈希未变。见 边界证据。

适合接入的受限路线是:精确验证料号存在及关联符号 → 冻结工程/图页/UID → 拒绝多 gate 或符号、引脚映射不一致 → 在原 UID 上应用模板属性,同时同步基础值和实例值、引脚号 → 按现有策略处理 Value/NC、显示样式 → 删除未连接模板 → 验证范围、连接、保存重开和独立读回。可按目标料号复用一个模板。

后续 性能评估 已取得一对多的有效 GUI 对照:本次完成替换阶段缩短 32.2%,含 CAD 启停、复核及独立读回的总耗时反而增加 7.2%。分层与展开图完整一致;多规则 GUI 基准未完成且仍有逐项保存重开流程差异,不能计算多规则加速倍数。该单次结果不能外推到任意 BOM。

正式切换前仍需要补齐:

  • 原生采集对实例覆盖值的读取已在本轮巡检补齐:分层与展开清单按完整 UID 范围核对,读取生效值;嵌套、重复或范围无法对应时回退 CAD。复杂层级实例仍未覆盖。
  • 不同符号、多 gate、不同引脚映射、重复层级实例及任意库的属性策略。这些不能直接使用此次受限路径。
  • 打包/PCB 同步、Undo/取消恢复、连续多工程和重复执行的正式回归。完整原生图数据一致并不代替 PCB 打包实测。

对不同符号等范围,当前可用路径仍是已有原生替换窗口;没有确认可安全直调的通用替换 CLI。内部核心已定位,但其对象生命周期与完整 ABI 尚不具备正式封装条件。替换实验脚本、工程副本与原始报告保存在忽略目录 build 中,均为研究原型。保留的查询源码不参与应用构建或发布。

核心调用证据见 JSON,批量与库查询结果见 JSON。所有内部地址都需要匹配模块哈希,不能写成跨版本正式接口。