Files
dxdesigner-part-replacement/docs/testing/2026-11-11-complex-native-netlist.md
T

4.7 KiB
Raw Blame History

复杂原生连接图归一化验证(2026-11-11)

本次修改 native_netlist.py 及对应测试、原始报告摘录;没有修改工程原件或 BOM/CAD 的 UID 选择协议。

实现范围

  • effective ASCII 的实例路径进入器件及端点身份,同一源 UID 在不同路径中分别保留;源位号与实例生效位号同时保留,物理连接以生效位号与原始 Keyin 独立核对。
  • 根据 HIER 报告展开每个可达实例,核对 effective 符号数量与身份;原生 flat 报告省略的子块伪符号不当作器件。只有父边界端点、子实例路径、同名子端口及唯一网络相互一致时才折叠边界端点。
  • 使用原生 ForwardPCB 标志识别物理器件,避免把带有残留 Part Number 的逻辑端口当作 PCB 器件。多个 gate 可以共用位号及料号,但物理脚号必须互斥,完整 Keyin 覆盖必须一致。
  • 目标符号仍须匹配绑定回执中的准确名称、明确指定的后缀和类型;数字 slot 后缀须落在声明范围内,正常化后所有物理脚及其网络仍须逐项相同。仅声明 slot 数量不能授权不同符号。
  • 重复非物理 GND 符号按语义实例多重集保留全部属性及数量,不编造独立 UID;电气身份或引脚不一致时仍拒绝。
  • 非身份重复属性以 ambiguous_attributes 多重集保留,不任意挑选一个值;未声明变化必须完全相同,选中项只有明确声明的精确结果才能消解歧义。重复位号/料号身份属性仍拒绝。
  • Keyin Part 段支持原生 * 续行;不存在有效器件、没有任何端点且料号为空的独立行保留为诊断,不冒充物理器件。非空多余料号、额外连接、缺失脚号和不完整层级仍失败。

真实证据

输入为 F:/Sync Tool Skyworth/Work Maps/Project_接入网/5800-2ATDY0B-3103/PON.prj。只读捕获已保存数据库,使用本机 icdb2ascii(hier/effective)与 KeyinNetlist 对副本重新导出。三次工具均 exit 0、自有进程回收确认、没有创建桌面。

产物位于 outputs/completion-validation-20261111/complex-netlists/:

  • pon-capture/capture.json:固定输入及源文件 SHA256。
  • pon-export/:首次未通过旧解析器的原始完整输出,未重写。
  • pon-export-normalized/netlist.json:修改后重新执行三项 CLI 的完整成功结果。
  • validation.json、validate_native_exports.py:独立锚点、前后真实导出对比、源文件未变检查与明确标记的内存图故障注入。
  • extract_native_cases.py:从原始输出摘录测试案例,Keyin 端点直接过滤自真实 Keyin,未由 ASCII 重建预期脚号;摘录不是完整工程导出。

完整 PON 图含 1013 个归一化条目、434 个网络、717 个物理符号、712 个物理位号、126 个子实例条目。D4A8 的六个异构 gate 共覆盖 384 个互斥物理脚;49 个 GND 符号全部保留;18 个层级边界端口有独立对应证明。源 UID $4I3552 在两条路径中分别对应 2CP10 与 3CP10。源位号 R? 的 $13I1996 生效位号为 RV33,与原始 Keyin 一致。

原始 PON 中 CG16 的重复 Part Name(空值与 CAPC1005X61N)完整保留。Keyin 的 U1A7 没有料号、没有任何端点,且不在完整 HIER/effective 图中,单列为 isolated_empty_parts 诊断。原始工程、icdb.dat、AugmentedPins.txt、speccomp.ini 的 SHA256 均未改变。

首次完整输出与新一轮完整 CLI 输出归一化比较为 verified、零差异。更改物理脚、未选逻辑脚、GND 数量、歧义属性或删除重复实例的五项内存图故障均被拒绝;这些故障注入不是实际工程写入或 CAD 换料。

普通工程另有完整 CLI 回归:57 个符号,三项工具 exit 0,结果成功。测试命令及最新输出保存在同目录 tests.txt。

另对固定 PON 副本实际运行 NativeInventoryReader,请求根块唯一物料 53DR-02M344-0000,返回 UG02 / $8I10289 / PON / 05_PON。原实现因无关器件重复属性/子实例而失败;现在校验完整层级后,仅向现有写入协议提供全局唯一的根块 UID/位号。请求子实例物料 4100-CA3438-2200 仍明确拒绝,不把路径限定的只读图身份伪装成可安全写入的裸 UID。证据为 root-inventory-validation.json 及各 root-inventory-*、nested-inventory-rejected 目录中的原始 CLI 报告。

验证边界

本次没有执行复杂 PON 的实际 CAD 替换,也没有放宽 BOM/CAD 选择器的重复 UID 安全限制。真实 PON 的层级深度为一个子块跳转;更深的 slash 路径有解析器测试,尚无真实深层导出样本。网表比对不等于 ERC、PCB 同步或制造验证。