7.5 KiB
原生器件采集接入与替换接口续查
接入结果(开发版,未打包)
位号采集和 BOM 库存校验优先使用本机官方 icdb2ascii.exe,完整身份沿用现有工程、原理图、图页、UID、位号、旧料号和原 Value 模型。不构造假 UID,不修改模板或替换策略。
本机安装路径:D:/Mentor/7.9.5EE/SDD_HOME/iCDB/win32/bin/icdb2ascii.exe。程序从已安装 Designer 路径定位同套 iCDB 工具,不随应用分发厂商二进制。
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 的内部符号替换方法。见 动态取证记录。下文为前一轮的检索结论。
尚未找到本机 7.9.5 可验证的独立替换 CLI,不能把下面线索当作已可用的后端。
icdb2ascii、icdb2csv、icdb2bom、icdb2wir的本机帮助确认的是导出用途;icdbPartsLister也只验证了清单导出。icscript.bat、mgcscript.bat是脚本启动/环境转发入口,脚本自身没有定义料号替换、位号范围或 Library Wins 参数合同。- 在自有桌面对
viewdraw.exe --help做有界探针,未取得可用文本帮助;退出及桌面清理已确认。不能据此证明程序不存在其他命令行能力。 - 再次离线读取本机
viewdraw.tlb:版本 1.0,SHA25609323c8940f1acf3f469d887dcfdf7bcd114164a29b01ebeb9a7f978fa1a0df7,没有直接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。