easyeda-agent

让 AI 直接操作嘉立创 EDA 专业版：读数据手册、画原理图、布局 PCB、整理丝印并完成检查。

GitHub · 立创插件市场 · 快速开始 · English

easyeda-agent 是 EasyEDA Pro（嘉立创 EDA 专业版）的 AI 自动化层。你可以直接描述想做的 电路或要修的问题，Agent 会读取真实工程数据，通过官方 eda.* API 完成操作，并在写入前后 检查器件身份、引脚网络、几何、DRC 和保存状态。

它能做什么

完整能力与状态见 功能清单，命令索引见 原理图 CLI 和 PCB CLI。

直接这样告诉 Agent

安装完成后，不需要先学习 CLI。把需求和必要的文件交给支持 Skill 的 Agent，并明确使用 easyeda-agent。

用 PDF 创建器件库

请使用 easyeda-agent，根据附件 ABC123.pdf 为完整型号 ABC123-QFN 建库。
先检查 EasyEDA 和 LCSC 库是否已有完全匹配的器件；没有再通读整份数据手册，核对订购
后缀、引脚表、封装尺寸图和推荐焊盘。自动创建 Symbol、Footprint 和 Device，保留证据页码，
先运行离线规格校验，再写入个人库。完成后回读 pin↔pad 映射并放置一个实例检查 Pin-1。
只有手册确实存在多个无法消歧的封装或缺少关键尺寸时再问我。

这个流程使用 easyeda lib device validate --spec … 在打开或修改 EasyEDA 前检查数据手册 证据、几何和引脚映射，再由 lib device build 创建完整资产。规格契约见 数据手册驱动的自动建库。

做一块 ESP32 最小系统板

请使用 easyeda-agent，在项目 ceshi 中完成一块 ESP32-S3-WROOM-1 最小系统板：
5V 端子输入，降压到 3V3，CH340 USB 下载，BOOT/RESET 按键，一颗 GPIO 控制的 LED，
四角 M3 固定孔。做 4 层板，GND 内电层，模组天线区域所有层 keepout。
请自行选型并核对数据手册，从原理图、布局、布线、铺铜、丝印一直做到 DRC 和保存完成。

完整实战与真实截图见 一份需求文档 → ESP32-S3 四层板。

调整当前 PCB 的丝印

请使用 easyeda-agent 检查当前 PCB 的全部位号和自由丝印。把压焊盘、超板框、重叠、
朝向不一致和底层未镜像的问题整理好；保留 LED 正负极、接口名称和必要板注。
完成后运行 pcb check 和官方 DRC，导出一张复核图并保存。

标准化原理图器件

请使用 easyeda-agent 扫描当前原理图，把无准确料号、非标准符号或封装不一致的器件列出来。
优先匹配标准器件库和准确 LCSC C 号，核对型号、封装及引脚后再替换。
替换时保留位号、位置和 uniqueId；如果 pinDiff 非空，修复接线并重新运行 sch check、
bridge-check 和官方 DRC。最后输出替换清单和仍无法确定的器件。

检查并修复已有工程

请使用 easyeda-agent 全面检查当前原理图和 PCB。先读取真实器件、引脚、网络、板框、叠层和
DRC 规则，再修复可以确定的问题。不要凭截图猜连接；所有修改完成后回读对账、运行连接/几何/DRC 检查、
保存，并把仍需人工决策的问题单独列出。

效果展示

从模块尺寸图到个人私有库

需求： 按用户提供的 AS07-M1101D-SMA 尺寸与引脚图创建个人库，原理图保持双排引脚的 左右顺序；封装标注引脚名和型号，丝印全部放在模块覆盖区域外，安装后仍可查看，并收紧、对齐。

结果： 已创建并保存 Symbol、Footprint 和 Device，核对 8 个引脚与 8 个通孔焊盘映射； 修正符号边框闭合和引脚方向。封装左侧用两列脚号＋名称，列间距约 0.5 mm，靠框一列距框 约 0.6 mm；型号居中放在框外上方，实际文字包围盒回读无重叠。 最终按用户要求使用普通引脚线和未定义类型，1 脚使用独立圆形标记；保留用户清理 NC 后的状态。

这次输入是用户尺寸图，不是完整原厂 PDF；焊盘与部分偏移采用明确假设计算。 尚未验证实物装配、放置实例和 PCB DRC，不作为生产就绪证明。 查看原始需求图、封装预览、规格与回读结果。

ESP32-S3 四层板

Agent 完成原理图到 PCB 的完整流程，包括模块布局、圆角板框、4 层电源结构、天线净空、 规则感知布线、铺铜和丝印整理。

数据驱动的原理图组合

Agent 先在本地连接数据中核对器件、引脚和网络，再计算模块内部布局并写回 EasyEDA；粉色虚线框 表示独立功能区，Apply 后逐脚回读，而不是仅凭截图判断成功。

安装与开始使用

easyeda-agent 由三部分组成：easyeda CLI/daemon、运行在 EasyEDA 内的 EDA Agent Connector，以及安装在 AI 客户端中的 easyeda-agent Skill。

1. 安装 CLI 和 Skill

curl -fsSL https://raw.githubusercontent.com/zhoushoujianwork/easyeda-agent/main/install.sh | bash

安装器会识别 Codex、Codex Desktop 和 Claude Code，并打印连接器下载地址。

2. 安装连接器

从 立创插件市场 安装，或从 最新 GitHub Release 下载 easyeda-agent-connector.eext 后在 EasyEDA Pro 的扩展管理器中导入。

3. 启动并连接

easyeda daemon start

打开目标 EasyEDA 工程，并启用 设置 → 允许外部交互。开始操作前运行健康检查；需要安装对账时再显式运行版本检查：

easyeda health
easyeda update --check --exit-code  # 可选：安装版本对账

版本差异会作为诊断输出，不作为设计动作的许可。Connector 若缺少当前动作或协议不兼容， 按诊断升级对应组件；Skill 内容更新后让客户端重新加载它。

更详细的安装、升级、代理和排障步骤见 快速开始。

为什么它适合 Agent

直接把任意 JavaScript 丢进编辑器很难审查，也难确认部分失败。easyeda-agent 把常用能力封装成 有明确输入输出的 typed actions，并在工作流中加入：

• 写入前检查目标工程、页面、器件身份和源数据；
• 写入后回读引脚、网络、几何和对象绑定；
• 原理图 layout-lint → check → bridge-check → DRC 分项报告事实与差异；
• PCB 使用真实 DRC 规则完成布局、布线、铺铜和制造检查；
• 对部分成功、超时和无法确认的结果停止盲目重试；
• 自动保存作为安全网，关键节点仍显式保存。

AI Agent / Skill
       │
       ▼
easyeda CLI + local daemon
       │ typed actions / audit / artifacts
       ▼
EDA Agent Connector (.eext)
       │ official eda.* API
       ▼
EasyEDA Pro project

架构与协议细节见 架构说明 和 协议说明。

能力边界

• 稠密板的完整迷宫自动布线需要外部 Freerouting；内置路由器适合短线和清晰局部连接。
• EasyEDA 扩展 API 不提供编程式 undo，项目通过源数据、写前守卫、回读和失败回滚降低风险。
• 受控阻抗所需的介质厚度、Er 和铜厚无法从当前 eda.* API 完整读取，不能自动声称阻抗合格。
• PDF 自动建库仍以具体型号和原厂证据为准；扫描模糊、封装后缀不明或缺少焊盘依据时会暂停询问。

完整边界和路线图见 市场能力覆盖 与 功能清单。

开发与贡献

• 开发环境：docs/dev-environment.md
• 电路块贡献：standard-blocks-contributing.md
• Skill 入口：skills/easyeda-agent/SKILL.md
• 仓库结构与开发约定：AGENTS.md

感谢嘉立创 EDA 专业版开放扩展接口，也感谢 @jlceda/pro-api-types、 Freerouting 及 EasyEDA 官方开源扩展 提供的基础与参考。

许可证

MIT。extension/src/beautify/ 中移植自 Easy_EDA_PCB_Beautify 的文件沿用 Apache-2.0，详见 NOTICE。