Design Diff — 原理图差异与 ECN

Design Diff 用于比较嘉立创 EDA 专业版中当前原理图与一个本地保存的设计基线，生成可审阅的 ECN（工程变更通知）报告。

它适合在“首次投板 → 修改 → 再次投板”或设计交接前，快速确认改动范围。所有快照、比较和报告均在本机完成；插件不会上传原理图、BOM 或网络数据。

功能演示

在真实原理图中运行插件，先导出当前设计作为版本基线：

基线导出完成后，插件会显示已采集的元件、逻辑网络、网络标识/端口与引脚网络数量：

完成设计修改后，选择该 .ediff.json 基线进行比较，即可得到按风险等级归类的 HTML ECN 报告和 CSV ECN 清单。

功能

• 导出当前原理图为 .ediff.json 基线文件；
• 按元件位号比较基线与当前原理图；
• 识别元件新增、删除，以及器件名称、符号、封装、制造商编号、供应商编号、自定义属性、引脚定义变化；
• 识别原理图逻辑网络的新增、删除，以及电源/地网络标识、网络端口和跨页连接标识的新增、删除；
• 通过嘉立创 EDA 原生网表识别元件引脚换网、接入网络和断开网络，原生格式不可用时回退 Protel2；
• 根据关键网络、连接器、主 IC、删除与封装变化分为严重、高、中、低风险；
• 导出便于浏览的 HTML ECN 报告与可筛选归档的 CSV ECN 报告。

使用流程

1. 在一个准备作为里程碑的原理图版本中，打开顶部菜单 Design Diff → 导出原理图基线...。
2. 输入版本名称，例如 V1.0-首次投板，并选择保存位置。生成的 .ediff.json 是后续比较的基线。
3. 完成设计修改后，打开 Design Diff → 比较基线并生成 ECN...。
4. 选择之前导出的 .ediff.json。插件读取当前原理图并依次保存 HTML、CSV 两份 ECN 报告。
5. 重点复核报告中的“严重”和“高”风险项，再把确认结论填写进项目的变更记录。

风险规则

关键网络采用名称关键词识别：GND、VCC、VDD、VBUS、VIN、RESET、NRST、EN、CLK、USB、DP、DM、CANH、CANL、SCL、SDA、SWDIO、SWCLK。风险等级用于提示审查优先级，不代替工程师确认。

已知限制

• 当前第一版仅支持原理图，不比较 PCB 元件坐标、旋转、走线或覆铜几何；
• 不单独比较文字网络标签图元；标签造成的逻辑网络增删或器件引脚换网仍会通过网络与引脚网络差异体现；
• 元件通过“位号 + 子单元名”匹配。位号重命名会表现为“删除 + 新增”，需要人工确认；
• 嘉立创 EDA 当前 SDK 的原理图引脚对象未直接提供网络名，插件通过 EDA 导出的官方 .enet JSON 网表建立“器件引脚 → 网络名”映射；
• 引脚网络差异依赖 EDA 成功导出网表；导出或解析失败时，导出提示与 ECN 警告会显示原因，该次比较不会生成引脚换网结论；
• 同一设计中存在重复位号时，插件会在报告中给出警告，结果需要人工复核；
• .ediff.json 包含器件及网络快照，请与工程文件一起妥善保管。

安装与构建

npm install
npm run build

构建产物位于 build/dist/，可在嘉立创 EDA 专业版的扩展管理中安装。

上架前检查

• 在 extension.json 中确认发布者、分类、版本和自定义图标；
• 用真实工程完成一次“导出基线 → 修改 → 比较 → 检查 HTML/CSV”的演示；
• 为上架页面准备功能截图及一个包含高风险变更的演示案例；
• 不在报告、README 或配置中放入个人隐私信息。

许可证

Apache-2.0