12 KiB
V1.1.0 DxDesigner 7.9.5 原生替换接口调研
调研日期:2026-10-14。范围为现有工作区源码、已有测试、本机注册的 7.9.5 COM TypeLib 与安装帮助;本次没有附着、启动或修改任何 CAD 工程,也没有做写入式 live probe。
安装版 TypeLib 复核更正: 本机实际注册的 viewdraw.tlb 是版本 1.0,不含 ReplacePart、OpenReplacePartDialog、ReplacePartCompleted 或 SelectExactSet。工作区保存的一份同名 designer_ifc.py 是声明版本 119.0 的 makepy wrapper,虽然含 IVdApp.ReplacePart(SourcePart, Scope, DestinationPart, PinMapping, PropertyMapping)、SRP_Selection=5 和 PropMT_LibraryWins=3,但不能用于证明本机 7.9.5 有这些成员。下文旧桥中的这些名称应按候选/模拟接口理解。本机真实接口结果以 离线 TypeLib 证据 为准。
结论
现有的 Viewdraw.Application COM 接口足以读取工程/图页/器件,按 UID 精确选中指定器件,并在替换前后核对选中集合。V1.1.0 的“一个旧料号只替换部分位号”可沿用这条选择链路。写入路径仍应调用原生 Replace Symbol / Replace Part 并明确核验 Library Wins。目前没有证据表明 Block.ChangeComponentPreserveRefdes 或 ExecuteCommand("ccomp ...") 能完整实现中央库选件、Library Wins、引脚及网络保持、Undo 和 Packager 通过。两者只适合作为可丢弃工程上的隔离探针,不能注册为默认执行后端。
这里的“原生接口”需要分清层次:现行自动执行使用 COM 读写选中状态,再从 viewdraw.exe 菜单资源识别 Replace Symbol 命令并发送 WM_COMMAND,随后通过 DxDesigner 原生对话框选择库行及选项。这是原生 UI 工作流的自动化,不是已证明存在的“传入旧件、新料号、Library Wins 参数的一次性 COM API”。
现有证据
| 路线 | 已有证据 | 当前判断 |
|---|---|---|
Viewdraw.Application |
QuickPartReplace.vbs:184,402,416 附着/创建对象;native_helper.py:196-204 从活动对象取得 IVdApp;一叶知秋 integration/dxdesigner795/CompatibilityProbe.vbs:122-132 使用 GetProjectData 和 DesignComponents 枚举全工程。 |
可用作工程上下文、清单和选中控制;实际环境、精确 build 和 32/64 位组合仍需现场验收。 |
| 按器件精确选择 | native_helper.py:214-249 以 UID 设置 Selected 并重新读取选中 UID;本机 TypeLib 有 IVdComp.Selected/_SetSelected 和 IVdApp.SelectComponent;旧桥 PartReplaceBridge.vbs:2097-2150 所用的 SelectExactSet 不在安装版 TypeLib。一叶知秋 core/Mailbox.vbs:365-375 已用 SelectByName 定位单件。 |
位号应在扫描阶段绑定项目、图页、UID、旧料号;执行前重查完整身份和选中集合。仅用 RefDes 文本不能跨图页唯一定位。 |
| 原生 Replace Part + Library Wins | native_helper.py:165-193,437-445 从 Viewdraw 菜单资源识别 Replace Symbol;:450-517 打开原生对话框、选择精确库行、检查目标 Part Number/符号、确认原生选项,再执行;:519-553 验证结果及未选中件未变。QuickPartReplace.vbs:780-815 调用 helper;:837-865 对未保存失败做原生 Undo 和快照验证。 |
是已有的自动写入路线;需在现场 build/中央库上回归,并以证据确认每个控件 ID 对应的选项,不能只依赖 ID。 |
Application.OpenReplacePartDialog |
旧桥 PartReplaceBridge.vbs:2260-2261,2341-2384 调用该名称并读 ReplacePartCompleted;旧 probe PartReplaceProbe.vbs:951-985 将其列为候选,ccomp_research 明确 production_enabled=false。本机 7.9.5 IVdApp TypeLib 没有这两个成员。 |
旧桥属于未证实候选/模拟路径;不能注册为本机可调用 COM 接口。 |
Block.ChangeComponentPreserveRefdes |
本机 7.9.5 TypeLib 的 IVdBlock 确有 DISPID 42,参数 OldComp, NewComp,返回 VARIANT_BOOL;保存的 wrapper designer_ifc.py:5005,9943 也有相同名称。现有设计 docs/superpowers/specs/2026-09-01-dxdesigner-795-part-replacement-design.md:50-61 记录符号原点及 Packager 失败的社区线索。 |
存在方法不等于可用于库料号替换;签名没有 Library Wins 参数,也未说明只作用于选中位号、如何选库及连接语义。 |
ExecuteCommand("ccomp ...") |
类型库包装 designer_ifc.py:1385,2974,3926 暴露 ExecuteCommand(CommandString);现有脚本只在 QuickPartReplace.vbs:845,1143 对 undo 使用它。旧设计 ...part-replacement-design.md:50-60 仅记载 ccomp :component_name 候选,旧 probe 将 Application.CComp 标为研究项。全工作区未找到执行 ExecuteCommand("ccomp ...") 的生产调用或成功报告。 |
命令存在性、准确语法、选择范围及 Library Wins 行为均未证实。不能用 undo 可执行推断 ccomp 可执行。 |
已有文档 docs/user/part-replacement.md:5,129-142 对生产边界、精确选择与硬不变量作了明确约束。旧设计 ...part-replacement-design.md:37 曾写“Python 不直接附着 COM”,但当前 native_helper.py:196-204 已直接附着。V1.1.0 文档应以当前实现和 live 证据为准,修正这处历史差异;不要把旧设计中的未验证候选当作生产能力。模拟测试 tests/integration/test_part_replace_probe.py:498-562 与 test_part_replace_bridge.py:336-355 只能证明协议和错误处理,不构成真实 7.9.5 行为证据。
本机安装版 TypeLib 细查
注册表 HKLM\SOFTWARE\Classes\TypeLib\{4ADEF4E1-690A-11CE-9261-0020C5E26659}\1.0\0\win32 指向 D:\Mentor\7.9.5EE\SDD_HOME\wv\win32\bin\viewdraw.tlb,SHA-256 为 09323c8940f1acf3f469d887dcfdf7bcd114164a29b01ebeb9a7f978fa1a0df7,共 223 个 TypeInfo。离线脚本 tools/research/probe-native-capabilities.py 直接调用 pythoncom.LoadTypeLib(path) 读这个文件,并与保存的 wrapper 比较;它不调用 GetActiveObject 或 CreateObject。输出 docs/research/v1.1.0-native-typelib-evidence.json 的 wrapper_matches_installed_version=false。
安装版真实可见成员包括 IVdApp.ExecuteCommand(CommandString) DISPID 29、SelectComponent(sSchName, sSheetName, sCompUID) DISPID 266、QueryPages DISPID 46、DesignComponents DISPID 59、GetProjectData DISPID 228;IVdComp.Selected 和 _SetSelected;IVdBlock.DeSelectAll、ChangeComponent DISPID 24、ChangeComponentPreserveRefdes DISPID 42。没有任何名称含 Replace 的 TypeLib 函数。旧桥引用的 SelectExactSet、OpenReplacePartDialog、ReplacePartCompleted 在安装版各接口中均未出现;目前测试里的同名 mock 不能当作原生接口。
外部 wrapper 的 IVdApp.ReplacePart 确有 DISPID 300、两个 BSTR、三个 32 位整数/枚举、布尔返回,以及 SRP_Selection=5、PinMT_ByPinNumber=2、PropMT_LibraryWins=3。它的声明版本是 119.0,与安装版 1.0 不同。因此可作为未来版本接口线索,但本机 V1.1.0 后端 capability 必须返回 unavailable,不能尝试按 DISPID 300 盲调。只有安装的 TypeLib 与运行时真实包含该方法,且 Selection + 精确 UID 选中 + Library Wins 的现场语义全部验证,才能为对应 build 启用直接 API 后端。
安装版 automate.chm 尝试用系统 hh.exe -decompile 提取,但没有得到可读文件;工作区的 designer_auto_ref.pdf 为较新 Xpedition Designer Automation Reference,页 696-697 解释 PinMapping/PropertyMapping 枚举,却不能代表本机 7.9.5 的接口集。故本结论优先依据安装版二进制 TypeLib,帮助材料只用于理解候选语义。
建议的 live probe
- 准备已关闭、可丢弃的完整工程副本,记录 DxDesigner 版本/build、中央库身份、工程树哈希;选择同一旧料号的两个以上器件,其中仅一个目标位号需要替换。另选一个多单元或引脚较多的代表件。
- 先只读探测
ProjectPath、QueryPages、DesignComponents、每个器件的 UID/RefDes/层级/图页/旧料号/Value/引脚/网络;在不同图页和同页重复位号场景验证身份是否唯一。记录 COM 调用返回值与错误号。 - 在副本上单独验证
IVdComp.Selected与IVdApp.SelectComponent:只选目标 UID,重新枚举选中集合。若集合不一致则停止。记录目标与同旧料号未选中器件的完整前快照。SelectExactSet不作为本机 7.9.5 探针调用。 - 建立基准:使用现行原生对话框路线对目标位号执行一次 Replace Part + Library Wins,记录库行、目标符号、控件文本/状态、替换后全图页快照、Undo、保存关闭再打开回读、Packager/ERC/网表结果。
- 对
ChangeComponentPreserveRefdes和ccomp分别使用新的副本做最小写入探针。先只读确认签名和命令语法;确认可恢复后仅改一个目标件。记录实际作用范围、库控制字段、RefDes/位置/方向、引脚号与网络、非目标件、Undo、保存回读和 Packager。任一步不确定就关闭副本且不保存,并留证;不能把属性值或 Part Number 单字段变化视为通过。 - 只有候选路线在多类器件、多图页、现场中央库上满足与基准相同的硬不变量,且有可重复证据和精确 build 绑定,才考虑提升为可选后端。选择一组目标位号后,必须证明未选中的同料号位号保持原样。
现行代码核验目标及未选中件料号(native_helper.py:519-547),但后端晋级标准还要使用 docs/user/part-replacement.md:140 的完整保护字段,并核对 NC/Value 策略、保存回读和独立 Packager/ERC/网表结果。现场报告应保存命令、参数、返回值/错误、前后快照、差异及文件 SHA-256,而不是只保存“成功”布尔值。
V1.1.0 后端边界建议
将计划和身份验证留在任务层;替换后端只负责一组已冻结的目标 UID。在单工程任务内按图页、旧料号、新料号及 Value/NC 策略分组,后端逐组处理。最小契约可表达为:
ReplacementRequest:
project_path, project_fingerprint, sheet_identity
targets: [{uid, refdes, old_part_number, baseline_fingerprint}]
new_part_number, library_identity, policy, command_id
ReplacementBackend:
capability(build, library_identity) -> supported / research_only / unavailable
inspect(request) -> current target identities and full-sheet baseline
replace(request, evidence_dir) -> result with attempted/committed/uncertain status
verify(request, result) -> selected and unselected differences
recover(request, result) -> verified undo or close_without_save evidence
生产后端先封装当前 native dialog/helper 路线。ChangeComponentPreserveRefdes 与 ccomp 应放入独立研究适配器,并强制 research_only、可丢弃副本和显式试验入口。后端不能自行扩大目标集合;命令中无 UID、旧料号或工程指纹匹配失败时,必须在写入前失败。结果须区分“未开始”“已变更但未确认”“已验证”和“已恢复”,使批次调度器遇到不确定状态时停下。
外部资料与证据等级
现有设计在 ...part-replacement-design.md:69 引用了 Siemens 社区关于 ChangeComponentPreserveRefdes 导致封装失败的讨论。此次网络可访问 Siemens 支持门户首页(HTTP 200),但未取得公开的 7.9.5 API 正文或可复核的 ccomp/Library Wins 参数说明;搜索请求超时。因此报告中对这两条路线的判断以本机类型库、工作区源码与设计记录为依据,没有宣称公开资料证明其替换语义。下一轮应优先取得站点安装包里的 Automation Reference、命令手册和现场 build 录屏/日志,再做写入试验。