zhoushoujianwork / easyeda-agent

easyeda-agent 
 让 AI 直接操作嘉立创 EDA 专业版：读数据手册、画原理图、布局 PCB、整理丝印并完成检查。
 GitHub ·
 立创插件市场 ·
 快速开始 ·
 CLI Status ·
 English 
`easyeda-agent` 是 EasyEDA Pro（嘉立创 EDA 专业版）的 AI 自动化层。你可以直接描述想做的
电路或要修的问题，Agent 会读取真实工程数据，通过官方 `eda.*` API 完成操作，并在写入前后
检查器件身份、引脚网络、几何、DRC 和保存状态。
## 它能做什么
| 使用场景 | 能力 |
|---|---|
| **拿 PDF / 尺寸图建库** | 读取型号、引脚和封装证据，创建 Symbol、Footprint、Device 和可选 3D Model；校验来源、焊盘依据和 pin↔pad 映射。实战：AS07 私有库与框外丝印 |
| **从需求做到一块板** | 从自然语言需求完成选型、原理图、分区布局、PCB、板框、叠层、布线、铺铜、丝印、DRC 和制造检查 |
| **原理图器件标准化** | 用 LCSC C 号或准确型号替换非标准器件，保留位号、位置和 PCB 同步身份；报告引脚差异并指导重新接线 |
| **原理图整理与修复** | 读取完整连接图，检查悬空、短路、跨页网名、NC、位号和模块归属，重新排版并回读验证 |
| **PCB 布局与布线** | 模块感知自动布局、板框贴合、规则感知短线布线、过孔、铺铜、4 层电源平面、天线 keepout |
| **丝印调整** | 自动避开焊盘、器件体、禁区、板框和其他标签；添加板注、接口名、LED 极性及 SVG Logo |
| **复用成熟电路** | 从内置电路块库复用 CH340、ESP32 自动下载、按键、USB Hub、降压等拓扑，放件、连线并对账 |
| **检查与交付** | 原理图连接与几何检查、PCB DRC/DFM、BOM、网表、制造文件、截图、审计日志和显式保存 |
当前可用范围与检查进度见 CLI Status，完整能力见 功能清单，命令索引见
原理图 CLI 和 PCB CLI。
## 直接这样告诉 Agent
安装完成后，不需要先学习 CLI。把需求和必要的文件交给支持 Skill 的 Agent，并明确使用
`easyeda-agent`。
### 用 PDF 创建器件库
 [code] 
这个流程使用 `easyeda lib device validate --spec …` 在打开或修改 EasyEDA 前检查数据手册
证据、几何和引脚映射，再由 `lib device build` 创建完整资产。规格契约见
数据手册驱动的自动建库。
### 做一块 ESP32 最小系统板
 [code] 
完整实战与真实截图见
一份需求文档 → ESP32-S3 四层板。
### 调整当前 PCB 的丝印
 [code] 
### 标准化原理图器件
 [code] 
### 检查并修复已有工程
 [code] 
## 效果展示
### 从模块尺寸图到个人私有库
**需求：** 按用户提供的 AS07-M1101D-SMA 尺寸与引脚图创建个人库，原理图保持双排引脚的
左右顺序；封装标注引脚名和型号，丝印全部放在模块覆盖区域外，安装后仍可查看，并收紧、对齐。
**结果：** 已创建并保存 Symbol、Footprint 和 Device，核对 8 个引脚与 8 个通孔焊盘映射；
修正符号边框闭合和引脚方向。封装左侧用两列脚号＋名称，列间距约 0.5 mm，靠框一列距框
约 0.6 mm；型号居中放在框外上方，实际文字包围盒回读无重叠。
最终按用户要求使用普通引脚线和未定义类型，1 脚使用独立圆形标记；保留用户清理 NC 后的状态。
这次输入是用户尺寸图，不是完整原厂 PDF；焊盘与部分偏移采用明确假设计算。
尚未验证实物装配、放置实例和 PCB DRC，不作为生产就绪证明。
查看原始需求图、封装预览、规格与回读结果。
### 嘉立创 PCB 初级考试第十八期：AT32F415 Layout
当前参数化 Layout 基线包含 69 个器件、15 个功能区和 90 × 50 mm 圆角板框，用于验证
“样例关系 → 算法候选 → AI 选择 → typed 写入 → 回读”的布局方法。该图展示布局阶段结果，
不代表整板布线或生产检查已经完成。
标准考试来源：**嘉立创 PCB 初级考试题第十八期**。执行步骤、参数和验证边界见
260919 AT32F415 考试执行指导。
### ESP32-S3 四层板（历史案例）
Agent 完成原理图到 PCB 的完整流程，包括模块布局、圆角板框、4 层电源结构、天线净空、
规则感知布线、铺铜和丝印整理。
| 板框贴合 | 丝印避让 |
|---|---|
| → | → 整理结果见成品板 |
### 数据驱动的原理图组合
Agent 先在本地连接数据中核对器件、引脚和网络，再计算模块内部布局并写回 EasyEDA；粉色虚线框
表示独立功能区，Apply 后逐脚回读，而不是仅凭截图判断成功。
## 安装与开始使用
easyeda-agent 由三部分组成：`easyeda` CLI/daemon、运行在 EasyEDA 内的
**EDA Agent Connector**，以及安装在 AI 客户端中的 `easyeda-agent` Skill。
### 1. 安装 CLI 和 Skill
macOS / Linux：
 [code] 
原生 Windows（Windows PowerShell 5.1 或 PowerShell 7）：
 [code] 
两个脚本行为一致：先取 `checksums.txt`，全部资产校验 SHA-256、核对 CLI `--version`
与 Skill `metadata.version` 之后才替换已安装文件；环境变量 `EASYEDA_VERSION`、
`EASYEDA_INSTALL_DIR`、`EASYEDA_INSTALL_SKILLS`、`EASYEDA_SKILL_PRESERVE`、
`EASYEDA_GITHUB_PROXY` 同样生效。安装器会识别 Codex、Codex Desktop 和 Claude Code，
并打印连接器下载地址。
install.ps1 默认装到 `%USERPROFILE%\.local\bin`，不会自作主张改 PATH：目录不在用户
PATH 上时只打印添加命令，需要自动添加用 `-AddToPath`（下载成文件运行）或
`$env:EASYEDA_ADD_TO_PATH=1`（管道运行）；机器级 PATH 始终不动。手工安装步骤见
快速开始。
### 2. 安装连接器
从 立创插件市场 安装，或从
最新 GitHub Release 下载
`easyeda-agent-connector.eext` 后在 EasyEDA Pro 的扩展管理器中导入。
### 3. 打开工程并检查
打开目标