简体中文 | English | 繁體中文 | 日本語 | Русский

PowerBridge

将 Simulink / Simscape 功率电路（.slx 模型）转换为 嘉立创EDA专业版 / EasyEDA Pro 可编辑原理图的扩展。

采用两阶段生成架构：先放置器件，再自动连线。链路全程可控、可检查，器件创建与连线彻底解耦。

[!NOTE]

本项目基于 pro-api-sdk 扩展开发框架构建，使用嘉立创EDA专业版扩展 API 实现。

功能特性

• 两阶段生成：Step 1 仅放置器件（不创建任何导线），用户检查后 Step 2 才自动连线，问题定位更清晰。
• Connectivity Preflight：连线前全面检查 IGBT 引脚映射、端点解析与 Gate 排除，存在未解析端点时阻断连线，绝不生成半残电路。
• 语义化 Pin 映射：开关器件（IGBT, LCSC C47967303）按引脚名/引脚号判定 Collector / Emitter / Gate，不依赖空间位置猜测；Gate 为硬性禁止端口（不接线、不建网）。
• 手动引脚设置：在 UI 中为 C47967303 指定 Collector / Emitter / Gate，下拉来自实际读取的引脚，保存后所有同型号器件共用。
• 确定性位号：按类型前缀（Q/D/C/L/R/U）加相对位置字典序，为每个器件分配稳定且可复现的位号（如 Q1、C2、R3）。
• 测量块智能过滤：Voltage Measurement / Current Measurement 不生成图元，且不把不同电气节点错误短路。
• 几何感知布线：优先复用 Simulink 原始连线几何，并确保所有导线轴对齐（水平/垂直），符合 EasyEDA 导线规范。
• 可重复连线：再次自动连线时检测并仅删除 PowerBridge 生成的导线，不影响用户其它原理图线路。

使用方式

1. 在嘉立创EDA专业版中打开或新建一个原理图页。
2. 打开菜单 PowerBridge → PowerBridge 两阶段生成。
3. 在窗口中点击 选择 .slx 文件，选择本地的 .slx 功率电路模型。
4. Step 1 — 放置器件：点击「放置器件」，此时仅创建器件、不生成任何导线，检查器件布局与位号。 5.（可选）器件引脚设置：为 IGBT C47967303 指定 Collector / Emitter / Gate。
5. Step 2 — 自动连线：点击「连线预检查」确认 Preflight 为 PASS，再点击「自动连线」生成导线。

提示：

• Step 1 未完成时，「自动连线」按钮为禁用状态。
• 存在未解析端点或 Gate 违规时，自动连线会被阻断并具体提示问题。
• Gate 端口保持悬空，不参与主功率 Net 连接。

使用演示

DEBUG / 开发功能

Core MVP Test、Device Validation、Pin Inspection、Routing Audit 等开发功能已移入 UI 的 DEBUG / Developer Tools 面板，仅当 DEBUG_MODE = true（见 src/state.ts）时显示，正式版本默认隐藏。

构建

npm install
npm run build

构建产物生成于 ./build/dist/powerbridge_v1.0.0.eext，在嘉立创EDA专业版中通过「高级 → 扩展管理器」导入即可。

技术架构

.slx 模型 (OPC/ZIP)
   │  slxParser：解析块 / 端口 / 连线树
   ▼
中立 IR (PowerBridgeCircuit)
   │  slxExporter：过滤测量块、继承布局、确定性位号
   ▼
Step 1 放置器件 (placeComponents)
   │  仅创建器件，不建 Wire
   ▼
Step 2 自动连线
   │  Connectivity Preflight（IGBT Pin / 端点 / Gate）
   │  → PASS → 几何路由 → 绘制导线 → Endpoint & Topology Audit
   ▼
EasyEDA 可编辑原理图

开源许可

本扩展使用 Apache License 2.0 开源许可协议。