Files
dxdesigner-part-replacement/docs/research/2026-10-16-native-cli-integration.md
T

82 lines
7.5 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.
# 原生器件采集接入与替换接口续查
## 接入结果(开发版,未打包)
位号采集和 BOM 库存校验优先使用本机官方 `icdb2ascii.exe`,完整身份沿用现有工程、原理图、图页、UID、位号、旧料号和原 Value 模型。不构造假 UID,不修改模板或替换策略。
本机安装路径:`D:/Mentor/7.9.5EE/SDD_HOME/iCDB/win32/bin/icdb2ascii.exe`。程序从已安装 Designer 路径定位同套 iCDB 工具,不随应用分发厂商二进制。
```text
icdb2ascii.exe -project=<临时 input.prj> -icdb=<临时 database>
-snap=DxD -h -t -offline -file=<临时 output/scope.txt>
```
不传 `-blks`,读取报告内的全部原理图块,包括不连通的块。验证报告是未筛选的 FREEFORM / HIER BLOCKS,且包含文本属性。逐器件读取真实 UID、图页及属性;引脚属性不能覆盖器件属性。筛选请求的旧料号后交给原计划校验、BOM 错误报告和缓存。
器件报告不枚举空图页,因此返回 `complete_sheet_manifest=False`。它可以缓存组件库存,但不能作为完整图页查询的缓存命中;完整图页枚举仍使用原 CAD 接口。
## 工程隔离、取消及回退
官方导出工具可能更新运行数据库。本实现先将 `.prj` 与 `database/icdb.dat` 复制到短路径临时目录,改写临时工程的数据库目录并清除专用服务器名称,不复制运行服务器地址文件。CLI 只访问副本,源工程与源数据库在调用前后核对 SHA256。
每次调用使用自有私有桌面及 Job,工具等待上限 30 秒,等待期间检查取消;确认进程和桌面释放后才解析结果或回退。工具缺失、不支持的工程/报告、超时或非零退出码在安全收尾后使用原 COM 采集。取消、源工程变化和清理不确定均阻断,不继续回退。
诊断保存在 `data/quick-run-history/native-inventory-*/native-inventory.json` 和对应 `output`,含状态、退出码、分段耗时、清理记录及原生输出。正常收尾删除临时数据库;清理不确定时保留副本和诊断。
运行前保存并关闭本次目标工程,避免采集到未保存编辑以外的磁盘状态。此后端不执行替换;替换前的目标核验、备份、Library Wins、属性恢复、保存及重开回读继续使用已有执行链。
## 两工程 BOM 实测
在已有测试工程的另一份副本中完成:创建两任务 → 导出默认同批模板 → 填入有效替换和一个不存在的位号 → 导入报错 → 修正后重导入 → 保存计划。
| 项目 | 结果 |
| --- | --- |
| 首次导入 | 5.281 秒;通过 2 行、失败 1 行;未保存预览 |
| 修正后重导入 | 1.093 秒;通过 2 行、失败 0 行;保存成功 |
| 工程一器件采集 | 1.360 秒,4 个目标位号;CLI 本身 0.891 秒 |
| 工程二器件采集 | 0.797 秒,2 个目标位号;CLI 本身 0.734 秒 |
| 工程路径长度 | 141、296 字符 |
| 导入时启动 CAD | 无;两次均使用单个 `icdb2ascii`,未回退 COM |
| 来源工程 | `.prj` 与 `icdb.dat` 哈希未变 |
本地证据:`build/native-cli-bom-offline-final-20261016/report.json`。这只是两个工程的数据,不能据此承诺 400 个工程或 400 条规则的吞吐量。重导入收益包含库存缓存,并非第二次完整 CLI 采集。
原生协议、运行监管、取消、超时、源身份变化、清理失败、图页缓存边界,以及原有 BOM/桌面隔离的针对性回归:128 项通过(26.52 秒)。只读复核另跑原生与缓存测试:56 项通过;未发现未解决的 P1/P2。
## 接入后实际替换回归
只执行上述长路径 Audio 副本:将 `RV05` 从 `4100-CA0000-T7` 替换到 `4100-CA0000-T0`,`RV11` 保持旧料号。任务完成 1 步、保存并重开核验 1 步、失败 0 步。独立 CLI 和另起 COM 会话读取的 UID、位号、料号及 Value 完全相同,来源工程哈希未变。
| 执行阶段 | 耗时 |
| --- | --- |
| 队列准备(包含原 COM 图页枚举与稳定性重读) | 186.393 秒 |
| 工程备份 | 0.677 秒 |
| 进度持久化 | 0.141 秒 |
| 执行接口总耗时(包含上述阶段及 CAD 替换、重开核验、释放) | 372.219 秒 |
CLI 改进的是导入与组件采集;当前执行准备仍有多次 CAD 启动,执行耗时没有同等降低。后续可单独研究从精确位号计划建立执行页范围,不能在此直接取消原有工程稳定性与目标核验。
本轮关闭了 PartLabel 复制:旧 `RV05.Value=0R`,新库件的 Value 为空,最终仍为空;`RV11.Value=0R` 不变。原执行逻辑中的 `preserve` 指保留原生替换后的库件 Value,而不是保留旧器件 Value。初版探针错误地要求选中件 Value 不变,断言失败;补充独立 COM 读取及代码核对后修正测试预期,未修改生产策略,也未以 PartLabel 代填原生清单。
五个 CAD 私有桌面均有正常退出及释放记录,并通过另一个进程枚举桌面确认已消失。初版前台观察器因测试输出目录嵌套,未采集到自有进程句柄,因此不能宣称完成了整轮自有 PID 的独立前台跟踪;该限制保留在验证报告中。
本地证据:`build/native-cli-bom-offline-final-20261016/replacement-acceptance/verified-report.json`、`com-readback.json`,以及任务的 `events.jsonl`、`quick-run/private-desktop.json`。初版失败断言记录仍保留。
## 直接替换 CLI 续查
2026-10-17 补充:已实际跟踪替换时的进程树和模块加载,确认多进程辅助服务,并发现 DataBook ActiveX、中央库类型库及 `ICE70.dll` 的内部符号替换方法。见 [动态取证记录](2026-10-17-native-replacement-process-trace.md)。下文为前一轮的检索结论。
尚未找到本机 7.9.5 可验证的独立替换 CLI,不能把下面线索当作已可用的后端。
- `icdb2ascii`、`icdb2csv`、`icdb2bom`、`icdb2wir` 的本机帮助确认的是导出用途;`icdbPartsLister` 也只验证了清单导出。
- `icscript.bat`、`mgcscript.bat` 是脚本启动/环境转发入口,脚本自身没有定义料号替换、位号范围或 Library Wins 参数合同。
- 在自有桌面对 `viewdraw.exe --help` 做有界探针,未取得可用文本帮助;退出及桌面清理已确认。不能据此证明程序不存在其他命令行能力。
- 再次离线读取本机 `viewdraw.tlb`:版本 1.0,SHA256 `09323c8940f1acf3f469d887dcfdf7bcd114164a29b01ebeb9a7f978fa1a0df7`,没有直接 `ReplacePart`。工作区版本 119.0 wrapper 的同名方法不能证明实装版本支持。
- `viewdraw.exe` 中存在 `ccomp`、`Change Component`、`Preserve REFDES Value` 字符串;已有 TypeLib 包含 `ChangeComponentPreserveRefdes`。这些只证明内部线索,没有验证参数、目标范围、中央库、引脚网络及 Library Wins 语义。
- 本机 CHM 中 `ccomp` 等页仍是跳转 InfoHub 的占位页。对安装样例及 `standard/ee_utils` 的脚本检索未找到可靠替换调用样例。
- 公开搜索没有取得可复核的命令合同;Siemens 社区链接只返回动态通用页面,未获取正文,不能作为替换语义证据。
后续最有价值的方向仍是匹配本机版本的命令/API 手册,或在独立可丢弃工程验证 `ccomp` / `ChangeComponentPreserveRefdes` 的实际语义。在这些证据齐备前,保留当前已验证的原生对话框替换链。
相关证据:`build/native-replacement-cli-20261016/`、`build/native-cli-integration-20261016/current-capabilities.json`;厂商帮助内容和工程数据库不加入 Git。