Skip to content
Back to search

easyeda-agent

嘉立创EDA专业版(EasyEDA Pro)自动化:给 AI harness 装上画板的「手」—— 一套 typed 原理图/PCB 动作,CLI / Agent Skill / stdio MCP 三形态融合接入。承接嘉立创「不以卖板赚钱,以培养中国工程师为己任」 | EasyEDA Pro automation: the hands of your AI harness — typed schematic/PCB actions via CLI, Agent Skill and stdio MCP.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/zhoushoujianwork/easyeda-agent with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/zhoushoujianwork/easyeda-agent'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zhoushoujianwork--easyeda-agent/badge.svg)](/listings/zhoushoujianwork--easyeda-agent)

HTML

<a href="/listings/zhoushoujianwork--easyeda-agent"><img src="/api/listings/zhoushoujianwork--easyeda-agent/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

macOS / Linux:

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

原生 Windows(Windows PowerShell 5.1 或 PowerShell 7):

irm https://raw.githubusercontent.com/zhoushoujianwork/easyeda-agent/main/install.ps1 | iex

两个脚本行为一致:先取 `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 始终不动。手工安装步骤见 [快速开始](docs/quick-start.md)。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 292 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="docs/assets/easyeda-agent-logo.png" width="96" alt="easyeda-agent logo" />
  3. </p>
  4. <h1 align="center">easyeda-agent</h1>
  5. <p align="center">
  6. 嘉立创 EDA 专业版(EasyEDA Pro)的开源 AI 自动化工具:从数据手册、原理图到 PCB 布局与检查。
  7. </p>
  8. <p align="center">
  9. <a href="https://easyeda-agent.daboluo.cc"><b>项目官网</b></a> ·
  10. <a href="https://eda.daboluo.cc/#desktop"><b>下载 Desktop 内测版</b></a> ·
  11. <a href="https://github.com/zhoushoujianwork/easyeda-agent/releases"><b>Releases</b></a> ·
  12. <a href="https://jlc-ext.com/item/zhoushoujian/easyeda-agent-connector"><b>立创插件市场</b></a> ·
  13. <a href="docs/quick-start.md"><b>快速开始</b></a> ·
  14. <a href="docs/cli-STATUS.md"><b>CLI Status</b></a> ·
  15. <a href="README.en.md">English</a>
  16. </p>
  17. ![easyeda-agent workflow](docs/assets/easyeda-agent-workflow.svg)
  18. `easyeda-agent` 是 EasyEDA Pro(嘉立创 EDA 专业版)的 AI 自动化层。你可以直接描述想做的
  19. 电路或要修的问题,Agent 会读取真实工程数据,通过官方 `eda.*` API 完成操作,并在写入前后
  20. 检查器件身份、引脚网络、几何、DRC 和保存状态。
  21. ## 推荐体验:EdaDesk Desktop
  22. 想在一个窗口里管理工程、与 AI 对话、查看原理图和 PCB?推荐先下载配套的
  23. **[EdaDesk Desktop 内测版 →](https://eda.daboluo.cc/#desktop)**。
  24. | 使用方式 | 适合谁 | 从哪里开始 |
  25. |---|---|---|
  26. | **EdaDesk Desktop** | 希望直接使用桌面工作台,集中查看工程、对话与工具执行 | [官网下载安装包与查看安装说明](https://eda.daboluo.cc/#desktop) |
  27. | **easyeda-agent CLI / Skill / MCP** | 已使用 Codex、Claude Code 等 AI 客户端,或需要脚本与工具集成 | [下方安装步骤](#安装与开始使用) · [快速开始](docs/quick-start.md) · [MCP 接入](mcp/README.md) |
  28. 当前 Desktop **0.1.0 内测版**内置 easyeda-agent **1.16.0**,提供 **macOS Apple Silicon**
  29. 和 **Windows x64** 安装包;文件托管在本项目的
  30. [GitHub Release](https://github.com/zhoushoujianwork/easyeda-agent/releases/tag/v1.16.0#edadesk-desktop),
  31. 无需访问私有仓库即可下载。后续版本与支持平台以 [Desktop 官网](https://eda.daboluo.cc/) 为准。
  32. Desktop 源码暂不公开,开源时间待定;本仓库的 easyeda-agent 继续按下方开源许可提供。
  33. macOS 包尚未开发者签名和公证,Windows 包尚未签名或完成真机验收。
  34. 可使用自行安装并登录的本机智能体或自定义模型;官方 Token 赠送与统一模型服务尚未开放,
  35. 下载安装不代表获得额度。首次体验建议使用可丢弃的测试工程。
  36. ## 它能做什么
  37. | 使用场景 | 能力 |
  38. |---|---|
  39. | **拿 PDF / 尺寸图建库** | 读取型号、引脚和封装证据,创建 Symbol、Footprint、Device 和可选 3D Model;校验来源、焊盘依据和 pin↔pad 映射。[实战:AS07 私有库与框外丝印](docs/examples/as07-m1101d-sma/README.md) |
  40. | **从需求做到一块板** | 从自然语言需求完成选型、原理图、分区布局、PCB、板框、叠层、布线、铺铜、丝印、DRC 和制造检查 |
  41. | **原理图器件标准化** | 用 LCSC C 号或准确型号替换非标准器件,保留位号、位置和 PCB 同步身份;报告引脚差异并指导重新接线 |
  42. | **原理图整理与修复** | 读取完整连接图,检查悬空、短路、跨页网名、NC、位号和模块归属,重新排版并回读验证 |
  43. | **PCB 布局与布线** | 模块感知自动布局、板框贴合、规则感知短线布线、过孔、铺铜、4 层电源平面、天线 keepout |
  44. | **丝印调整** | 自动避开焊盘、器件体、禁区、板框和其他标签;添加板注、接口名、LED 极性及 SVG Logo |
  45. | **复用成熟电路** | 从内置电路块库复用 CH340、ESP32 自动下载、按键、USB Hub、降压等拓扑,放件、连线并对账 |
  46. | **检查与交付** | 原理图连接与几何检查、PCB DRC/DFM、BOM、网表、制造文件、截图、审计日志和显式保存 |
  47. 当前可用范围与检查进度见 [CLI Status](docs/cli-STATUS.md),完整能力见 [功能清单](docs/FEATURES.md),命令索引见
  48. [原理图 CLI](docs/cli/schematic.md) 和 [PCB CLI](docs/cli/pcb.md)。
  49. ## 直接这样告诉 Agent
  50. 安装完成后,不需要先学习 CLI。把需求和必要的文件交给支持 Skill 的 Agent,并明确使用
  51. `easyeda-agent`。
  52. ### 用 PDF 创建器件库
  53. ```text
  54. 请使用 easyeda-agent,根据附件 ABC123.pdf 为完整型号 ABC123-QFN 建库。
  55. 先检查 EasyEDA 和 LCSC 库是否已有完全匹配的器件;没有再通读整份数据手册,核对订购
  56. 后缀、引脚表、封装尺寸图和推荐焊盘。自动创建 Symbol、Footprint 和 Device,保留证据页码,
  57. 先运行离线规格校验,再写入个人库。完成后回读 pin↔pad 映射并放置一个实例检查 Pin-1。
  58. 只有手册确实存在多个无法消歧的封装或缺少关键尺寸时再问我。
  59. ```
  60. 这个流程使用 `easyeda lib device validate --spec …` 在打开或修改 EasyEDA 前检查数据手册
  61. 证据、几何和引脚映射,再由 `lib device build` 创建完整资产。规格契约见
  62. [数据手册驱动的自动建库](.agents/skills/easyeda-agent/references/library-authoring.md)。
  63. ### 做一块 ESP32 最小系统板
  64. ```text
  65. 请使用 easyeda-agent,在项目 ceshi 中完成一块 ESP32-S3-WROOM-1 最小系统板:
  66. 5V 端子输入,降压到 3V3,CH340 USB 下载,BOOT/RESET 按键,一颗 GPIO 控制的 LED,
  67. 四角 M3 固定孔。做 4 层板,GND 内电层,模组天线区域所有层 keepout。
  68. 请自行选型并核对数据手册,从原理图、布局、布线、铺铜、丝印一直做到 DRC 和保存完成。
  69. ```
  70. 完整实战与真实截图见
  71. [一份需求文档 → ESP32-S3 四层板](docs/showcase-esp32-mini.md)。
  72. ### 调整当前 PCB 的丝印
  73. ```text
  74. 请使用 easyeda-agent 检查当前 PCB 的全部位号和自由丝印。把压焊盘、超板框、重叠、
  75. 朝向不一致和底层未镜像的问题整理好;保留 LED 正负极、接口名称和必要板注。
  76. 完成后运行 pcb check 和官方 DRC,导出一张复核图并保存。
  77. ```
  78. ### 标准化原理图器件
  79. ```text
  80. 请使用 easyeda-agent 扫描当前原理图,把无准确料号、非标准符号或封装不一致的器件列出来。
  81. 优先匹配标准器件库和准确 LCSC C 号,核对型号、封装及引脚后再替换。
  82. 替换时保留位号、位置和 uniqueId;如果 pinDiff 非空,修复接线并重新运行 sch check、
  83. bridge-check 和官方 DRC。最后输出替换清单和仍无法确定的器件。
  84. ```
  85. ### 检查并修复已有工程
  86. ```text
  87. 请使用 easyeda-agent 全面检查当前原理图和 PCB。先读取真实器件、引脚、网络、板框、叠层和
  88. DRC 规则,再修复可以确定的问题。不要凭截图猜连接;所有修改完成后回读对账、运行连接/几何/DRC 检查、
  89. 保存,并把仍需人工决策的问题单独列出。
  90. ```
  91. ## 效果展示
  92. ### 从模块尺寸图到个人私有库
  93. **需求:** 按用户提供的 AS07-M1101D-SMA 尺寸与引脚图创建个人库,原理图保持双排引脚的
  94. 左右顺序;封装标注引脚名和型号,丝印全部放在模块覆盖区域外,安装后仍可查看,并收紧、对齐。
  95. **结果:** 已创建并保存 Symbol、Footprint 和 Device,核对 8 个引脚与 8 个通孔焊盘映射;
  96. 修正符号边框闭合和引脚方向。封装左侧用两列脚号+名称,列间距约 0.5 mm,靠框一列距框
  97. 约 0.6 mm;型号居中放在框外上方,实际文字包围盒回读无重叠。
  98. 最终按用户要求使用普通引脚线和未定义类型,1 脚使用独立圆形标记;保留用户清理 NC 后的状态。
  99. ![AS07 原理图符号:与用户引脚图一致的左右顺序](docs/examples/as07-m1101d-sma/symbol.png)
  100. 这次输入是用户尺寸图,不是完整原厂 PDF;焊盘与部分偏移采用明确假设计算。
  101. 尚未验证实物装配、放置实例和 PCB DRC,不作为生产就绪证明。
  102. [查看原始需求图、封装预览、规格与回读结果](docs/examples/as07-m1101d-sma/README.md)。
  103. ### 嘉立创 PCB 初级考试第十八期:AT32F415 Layout
  104. 当前参数化 Layout 基线包含 69 个器件、15 个功能区和 90 × 50 mm 圆角板框,用于验证
  105. “样例关系 → 算法候选 → AI 选择 → typed 写入 → 回读”的布局方法。该图展示布局阶段结果,
  106. 不代表整板布线或生产检查已经完成。
  107. <p align="center">
  108. <img src="docs/assets/demo-at32f415-exam-layout.png" width="820" alt="嘉立创 PCB 初级考试第十八期 AT32F415 学习板参数化 Layout" />
  109. </p>
  110. 标准考试来源:**嘉立创 PCB 初级考试题第十八期**。执行步骤、参数和验证边界见
  111. [260919 AT32F415 考试执行指导](docs/260919-exam-execution-guide.md)。
  112. ### ESP32-S3 四层板(历史案例)
  113. Agent 完成原理图到 PCB 的完整流程,包括模块布局、圆角板框、4 层电源结构、天线净空、
  114. 规则感知布线、铺铜和丝印整理。
  115. ![AI 在 EasyEDA 中完成 PCB 布局、板框和铺铜](docs/assets/demo-pcb-layout.gif)
  116. | 板框贴合 | 丝印避让 |
  117. |---|---|
  118. | <img src="docs/assets/demo-outline-before.png" width="300" alt="板框贴合前"/> → <img src="docs/assets/demo-outline-after.png" width="300" alt="板框贴合后"/> | <img src="docs/assets/demo-silk-before.png" width="300" alt="丝印整理前"/> → 整理结果见成品板 |
  119. ### 数据驱动的原理图组合
  120. Agent 先在本地连接数据中核对器件、引脚和网络,再计算模块内部布局并写回 EasyEDA;粉色虚线框
  121. 表示独立功能区,Apply 后逐脚回读,而不是仅凭截图判断成功。
  122. ![门禁控制板的电源与 RF 主控原理图](docs/images/access-control-power-rf.png)
  123. ![原理图实际 Apply 过程](docs/assets/access-control-sch-apply.gif)
  124. ## 安装与开始使用
  125. 本节面向 CLI / Skill / MCP 用户;桌面工作台用户可先按 [Desktop 官网](https://eda.daboluo.cc/#desktop) 的说明安装。
  126. easyeda-agent 由三部分组成:`easyeda` CLI/daemon、运行在 EasyEDA 内的
  127. **EDA Agent Connector**,以及安装在 AI 客户端中的 `easyeda-agent` Skill。
  128. ### 1. 安装 CLI 和 Skill
  129. macOS / Linux:
  130. ```bash
  131. curl -fsSL https://raw.githubusercontent.com/zhoushoujianwork/easyeda-agent/main/install.sh | bash
  132. ```
  133. 原生 Windows(Windows PowerShell 5.1 或 PowerShell 7):
  134. ```powershell
  135. irm https://raw.githubusercontent.com/zhoushoujianwork/easyeda-agent/main/install.ps1 | iex
  136. ```
  137. 两个脚本行为一致:先取 `checksums.txt`,全部资产校验 SHA-256、核对 CLI `--version`
  138. 与 Skill `metadata.version` 之后才替换已安装文件;环境变量 `EASYEDA_VERSION`、
  139. `EASYEDA_INSTALL_DIR`、`EASYEDA_INSTALL_SKILLS`、`EASYEDA_SKILL_PRESERVE`、
  140. `EASYEDA_GITHUB_PROXY` 同样生效。安装器会识别 Codex、Codex Desktop 和 Claude Code,
  141. 并打印连接器下载地址。
  142. install.ps1 默认装到 `%USERPROFILE%\.local\bin`,不会自作主张改 PATH:目录不在用户
  143. PATH 上时只打印添加命令,需要自动添加用 `-AddToPath`(下载成文件运行)或
  144. `$env:EASYEDA_ADD_TO_PATH=1`(管道运行);机器级 PATH 始终不动。手工安装步骤见
  145. [快速开始](docs/quick-start.md)。
  146. ### 2. 安装连接器
  147. 从 [立创插件市场](https://jlc-ext.com/item/zhoushoujian/easyeda-agent-connector) 安装,或从
  148. [最新 GitHub Release](https://github.com/zhoushoujianwork/easyeda-agent/releases/latest) 下载
  149. `easyeda-agent-connector.eext` 后在 EasyEDA Pro 的扩展管理器中导入。
  150. ### 3. 打开工程并检查
  151. 打开目标 EasyEDA 工程,并启用 **设置 → 允许外部交互**,然后运行:
  152. ```bash
  153. easyeda health
  154. ```
  155. 它逐项列出 daemon、连接器、版本、EasyEDA 宿主、工程与标签页是否就绪,未就绪项直接给出下一步。
  156. daemon 不用手动常驻:任何 `easyeda` 命令发现它没在运行时会自动在后台启动(日志在
  157. `~/.easyeda-agent/daemon.log`;`EASYEDA_NO_AUTOSTART=1` 关闭)。需要安装对账时再运行
  158. `easyeda update --check --exit-code`。
  159. 项目主线要求 **EasyEDA Pro V4**,推荐升级到已验证的 **V4.1.60 或更新 V4**。
  160. `easyeda health` 会在 `hostCompatibility` 中单独报告宿主产品版本;V3 环境应先升级再做现场写入。
  161. V4 适配进度和边界见 [V4 开发台账](docs/v4-development.md)。
  162. 版本差异会作为诊断输出,不作为设计动作的许可。Connector 若缺少当前动作或协议不兼容,
  163. 按诊断升级对应组件;Skill 内容更新后让客户端重新加载它。
  164. 更详细的安装、升级、代理和排障步骤见 [快速开始](docs/quick-start.md)。
  165. ## 为什么它适合 Agent
  166. 直接把任意 JavaScript 丢进编辑器很难审查,也难确认部分失败。easyeda-agent 把常用能力封装成
  167. 有明确输入输出的 typed actions,并在工作流中加入:
  168. - 写入前检查目标工程、页面、器件身份和源数据;
  169. - 写入后回读引脚、网络、几何和对象绑定;
  170. - 原理图 `layout-lint → check → bridge-check → DRC` 分项报告事实与差异;
  171. - PCB 使用真实 DRC 规则完成布局、布线、铺铜和制造检查;
  172. - 对部分成功、超时和无法确认的结果停止盲目重试;
  173. - 自动保存作为安全网,关键节点仍显式保存。
  174. ```text
  175. AI Agent / Skill
  176. │
  177. ▼
  178. easyeda CLI + local daemon
  179. │ typed actions / audit / artifacts
  180. ▼
  181. EDA Agent Connector (.eext)
  182. │ official eda.* API
  183. ▼
  184. EasyEDA Pro project
  185. ```
  186. 架构与协议细节见 [架构说明](docs/architecture.md) 和 [协议说明](docs/protocol.md)。
  187. ## 能力边界
  188. - 稠密板的完整迷宫自动布线需要外部 Freerouting;内置路由器适合短线和清晰局部连接。
  189. - EasyEDA 扩展 API 不提供编程式 undo,项目通过源数据、写前守卫、回读和失败回滚降低风险。
  190. - 受控阻抗所需的介质厚度、Er 和铜厚无法从当前 `eda.*` API 完整读取,不能自动声称阻抗合格。
  191. - PDF 自动建库仍以具体型号和原厂证据为准;扫描模糊、封装后缀不明或缺少焊盘依据时会暂停询问。
  192. 当前能力与边界见 [功能清单](docs/FEATURES.md) 和 [CLI 索引](docs/cli/README.md)。
  193. 过往调研和实测结果集中在 [历史证据索引](docs/reviews/README.md)。
  194. ## 开发与贡献
  195. - PCB 算法贡献:[四个公共 Go 包、数学问题与可认领任务](docs/pcb-solver-community-design.md);`make pcb-solver-test` 可离线运行,无需 EDA。
  196. - 文档导航与信息归属:[docs/README.md](docs/README.md)
  197. - 跨项目查询、维护 Skill 和多客户端兼容:[Agent 协作设计](docs/agent-collaboration.md)
  198. - 开发环境:[docs/dev-environment.md](docs/dev-environment.md)
  199. - 电路块贡献:[standard-blocks-contributing.md](.agents/skills/easyeda-agent/references/standard-blocks-contributing.md)
  200. - Skill 入口:[.agents/skills/easyeda-agent/SKILL.md](.agents/skills/easyeda-agent/SKILL.md)
  201. - 仓库结构与开发约定:[AGENTS.md](AGENTS.md)
  202. 感谢嘉立创 EDA 专业版开放扩展接口,也感谢
  203. [@jlceda/pro-api-types](https://www.npmjs.com/package/@jlceda/pro-api-types)、
  204. [Freerouting](https://github.com/freerouting/freerouting) 及
  205. [EasyEDA 官方开源扩展](https://github.com/easyeda) 提供的基础与参考。
  206. ## 许可证
  207. [MIT](LICENSE)。`extension/src/beautify/` 中移植自
  208. [Easy_EDA_PCB_Beautify](https://github.com/m-RNA/Easy_EDA_PCB_Beautify) 的文件沿用
  209. Apache-2.0,详见 [NOTICE](NOTICE)。
  210. ## Star History
  211. 感谢每一颗 star。
  212. [![Star History Chart](https://api.star-history.com/svg?repos=zhoushoujianwork/easyeda-agent&type=Date)](https://www.star-history.com/#zhoushoujianwork/easyeda-agent&Date)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.