EasyEDA API Skill

🔌 AI 驱动 PCB 自动化设计

通过 WebSocket 桥接实时控制 EasyEDA Pro,提供 120+ API 类、扩展开发支持与代码级 PCB/原理图自动化操作。

收藏
15.1k
安装
6.1k
版本
1.0.5
CLS 安全扫描中
预计需要 3 分钟...

使用说明

EasyEDA Pro API Skill 综合评估

核心用法

本 Skill 为 AI Agent 提供完整的 EasyEDA Pro(嘉立创EDA专业版)程序化控制能力,涵盖 PCB 设计、原理图编辑、封装/符号管理及项目操作。核心架构采用 Node.js Bridge Server 作为中间层,通过 WebSocket 与运行中的 EasyEDA Pro 客户端建立双向通信,支持在端口 49620-49629 范围内自动发现和连接。AI Agent 可通过 HTTP API 向 Bridge 发送 JavaScript 代码,代码在 EasyEDA 的浏览器运行时中执行并返回结果。

主要功能模块包括:

  • 完整 API 参考:120 个类、62 个枚举、70 个接口、19 个类型别名
  • 实时调试:支持在 EasyEDA 中直接执行代码进行 live debugging
  • 扩展开发:提供扩展开发文档,支持基于 sys_IFrame 的自定义面板开发
  • 多窗口管理:支持同时连接多个 EasyEDA 窗口并动态切换

显著优点

1. 官方生态整合:由 JLCEDA(嘉立创)维护,API 与 EasyEDA Pro 版本同步更新
2. 零侵入架构:无需修改 EasyEDA 源码,通过官方扩展机制(.eext)加载 Bridge Gateway

3. 类型完备:提供完整的 TypeScript 风格类型定义,降低 AI 代码生成错误率

4. 双向通信:WebSocket 实时通道支持事件监听和状态推送

5. 生产就绪:MIT 开源协议,提供详细的错误处理指南和常见陷阱说明

潜在缺点与局限性

1. 环境依赖严格:要求 Node.js 18+ 和 EasyEDA Pro 桌面版,不支持 Web 版
2. 单点故障风险:Bridge Server 为单节点架构,崩溃后需手动重启

3. 安全边界模糊:代码在 EasyEDA 浏览器上下文中执行,可访问完整 eda 对象,存在潜在的恶意代码执行风险(尽管需要本地 Bridge 授权)

4. 单位陷阱:PCB(1mil)与原理图(0.01inch)坐标单位不同,极易导致定位错误

5. 异步模式复杂:修改图元需使用 toAsync() 模式,API 设计不够直观

适合人群

  • 硬件自动化开发者:需要将 PCB 设计流程集成到 CI/CD 或自动化工作流
  • EDA 扩展开发者:开发 EasyEDA Pro 插件、自定义工具面板
  • AI 辅助设计研究者:探索 LLM 在电子设计自动化中的应用边界
  • 批量操作需求用户:需要批量生成封装、批量修改设计规则、批量导出生产文件

常规风险

| 风险类别 | 具体描述 | 缓解建议 |
|---------|---------|---------|
| 数据安全 | Bridge 无身份验证,局域网内任何进程可连接 | 仅在受控本地环境运行,避免公网暴露 |
| 数据丢失 | `openProject()` 会丢弃当前未保存更改 | 执行前明确提示用户保存 |
| 执行安全 | 远程代码执行(RCE)能力,可删除项目、修改设计 | 审计所有 `POST /execute` 请求,沙箱化 Bridge 进程 |
| 版本兼容 | API 随 EasyEDA 更新变化,文档可能滞后 | 锁定 EasyEDA 版本,验证 API 签名后再调用 |

总结

EasyEDA Pro API Skill 是目前最完整的国产 EDA 程序化控制方案,适合技术型用户构建自动化设计管线。使用时需特别注意 坐标单位文档状态验证异步修改模式 三大陷阱。建议生产环境增加 Bridge 服务监控和代码审计层。

EasyEDA API Skill 内容

guide文件夹
ancillary-projects文件夹
references文件夹
classes文件夹
enums文件夹
interfaces文件夹
types文件夹
scripts文件夹
user-guide文件夹
手动下载zip · 359.1 kB
pro-api-sdk.mdtext/markdown
请选择文件