嘉立创EDA专业版 AI SKILL：让AI直接操控PCB设计工具

想象这样一个场景：你对 Claude Code 说一句"帮我设计一个STM32最小系统板"，几秒后 EasyEDA Pro 客户端里已经摆放好了所有元器件、连接好了原理图走线——这不是科幻，这是 easyeda-api-skill 正在做的事。

嘉立创EDA（EasyEDA）官方出品的 AI 编程工具集成包

一、项目起源：为什么需要让AI操控EDA？

PCB设计（印制电路板设计）是硬件工程师最耗时的日常工作之一。一块中等复杂度的电路板，从原理图绘制到元器件布局布线，往往需要数小时甚至数天。传统的AI辅助方案，如截图+点击自动化，响应缓慢，体验糟糕。

嘉立创EDA团队（EasyEDA/JLCEDA）意识到：既然EasyEDA Pro提供了完整的JavaScript扩展API，AI编程工具完全可以绕过模拟点击，直接调用EDA内核——就像使用官方插件一样，以毫秒级响应完成操作。这就是 easyeda-api-skill 的设计初衷。

该仓库于2026年3月创建，由嘉立创EDA官方团队维护，支持 Claude Code、OpenCode、QwenCode 等所有兼容 Agent Skills 标准的AI编程工具。

二、核心架构：三层桥接的秘密

项目的架构设计非常精妙，通过一个 WebSocket Bridge Server 实现三层桥接：

┌──────────────┐   HTTP/WS     ┌────────────────┐   WebSocket   ┌───────────┐
│   AI Agent   │ ◄───────────► │  Bridge Server │ ◄───────────► │  EasyEDA  │
│(Claude Code等)│  Port Range   │  (Node.js)      │  Port Range   │(Pro客户端) │
└──────────────┘  49620-49629  └────────────────┘  49620-49629  └───────────┘

第一层：HTTP/WebSocket服务端。Bridge Server 用 Node.js 实现，监听 49620-49629 端口范围，自动检测可用端口，提供 /health 和 /eda-windows 两个 HTTP 端点。AI 编程工具通过 HTTP POST /execute 提交 JavaScript 代码片段，服务端通过 WebSocket 转发给已连接的 EasyEDA Pro 客户端执行，并将结果异步返回。

第二层：握手与多窗口管理。Bridge Server 支持同时管理多个 EasyEDA 客户端窗口，通过 windowId 区分活跃窗口，AI 可以查询当前连接状态并选择操作目标窗口。握手协议使用 { service: "easyeda-bridge" } 标识，防止误连。

第三层：API索引构建。项目从原始 API 文档自动生成结构化文档，包含120+个类、62个枚举、70个接口、19个别名类型，供 AI 快速检索调用——无需遍历全部文档。

三、主要功能：从原理图到PCB的完整AI控制

3.1 文档树与项目管理

通过 DMT_Board、DMT_Schematic、DMT_Project、DMT_Folder 等类，AI 可以创建、打开、保存、关闭项目，获取当前项目信息，管理文档树结构。

// 获取当前项目信息
return await eda.dmt_Project.getCurrentProjectInfo();

// 创建新PCB板
return await eda.dmt_Board.createBoard();

3.2 PCB布局布线操作

通过 IPCB_Primitive* 系列类，AI 可以精确操控PCB上的所有图元：直线（IPCB_PrimitiveLine）、铜区域（IPCB_PrimitivePour）、过孔（IPCB_PrimitiveVia）、铜填充（IPCB_PrimitivePoured）、焊盘（IPCB_PrimitivePad）等。此外还支持多边形（IPCB_ComplexPolygon）和区域（IPCB_PrimitiveRegion）操作。

3.3 原理图编辑

通过 DMT_Schematic 和 sch_PrimitiveComponent 等类，AI 可以操作原理图器件、连线、网络标签，进行层次化原理图管理和仿真参数设置。

3.4 元器件库管理

提供封装（Footprint）和符号（Symbol）管理接口，支持从 LCSC 元器件库搜索和导入器件，获取元器件数据手册信息。

3.5 在线调试能力

SKILL.md 中包含完整的错误处理指南、稳定性和重连策略文档。AI 可以实时调试扩展代码、验证 API 调用结果，显著加速 EasyEDA 扩展开发流程。

四、技术栈与代码质量

项目采用纯 JavaScript（Node.js ESM模块），核心依赖仅有一个 ws（WebSocket）库，代码量轻、依赖少。Bridge Server 约 500 行代码，结构清晰：端口检测、HTTP服务、WebSocket管理、EDA客户端路由、请求超时控制、握手协议验证。

类型定义完整（TypeScript类型通过 pro-api-types npm 包提供），SKILL.md 格式规范，文档构建自动化（npm run build:docs），一键打包发布（npm run pack）。无测试文件目录，但作为工具库而非应用库，这个选择可以理解。

五、快速上手

安装与启动：

git clone https://github.com/easyeda/easyeda-api-skill.git
cd easyeda-api-skill
npm install
npm run server   # Bridge Server 在后台启动，端口 49620-49629

安装 EasyEDA 扩展：在 EasyEDA Pro 客户端中安装 run-api-gateway.eext 扩展（下载地址：https://jlc-ext.com/item/oshwhub/run-api-gateway），扩展加载后自动连接 Bridge Server。

验证连接：

curl http://localhost:49620/health
curl http://localhost:49620/eda-windows

发布到 ClawHub：AI 编程工具生态的技能包分发平台，通过 npx clawhub@latest publish dist/easyeda-api/ 一键发布。

六、局限与风险

依赖 EasyEDA Pro 桌面客户端：项目本质上是桥接工具，必须配合 EasyEDA Pro 才能工作，无法在纯服务器/无头环境中运行，限制了批量自动化场景的适用性。

本地网络端口独占：Bridge Server 独占 49620-49629 端口范围，与其他可能使用相同端口的服务存在冲突风险，多人协作场景下端口管理需要额外协调。

安全边界：Bridge Server 监听 127.0.0.1，安全性仅靠本地端口隔离，没有认证机制，多用户共用一台机器时需注意权限隔离。

功能覆盖度：120+类API覆盖了大部分常用操作，但复杂3D模型处理、高级仿真（信号完整性、电源完整性分析）等专业领域的功能支持尚不完整。

七、行业意义与生态定位

easyeda-api-skill 代表了 AI 赋能硬件设计的重要方向——将AI Agent从软件代码生成领域拓展到物理世界硬件设计。结合 MCP（Model Context Protocol）服务器生态（已有多个EasyEDA MCP实现），AI操控PCB设计的工具链正在快速成熟。

从增长曲线看，2026年3月创建至今已有559 stars，增长势头强劲。随着 Claude Code、Cursor 等 AI 编程工具的普及，将 EDA 工具链接入 AI 工作流将成为硬件工程师提升效率的标准配置。

一句话总结：easyeda-api-skill 是嘉立创EDA官方出品的AI-EA桥接工具，通过WebSocket协议让AI编程工具直接调用EasyEDA Pro内核API，以毫秒级响应完成原理图、PCB、元器件库的创建与编辑，是硬件设计AI自动化的重要里程碑。