easyeda-agent

Name: easyeda-agent
Author: zhoushoujianwork

Verified

嘉立创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.

234stars

37forks

Installation

# Add to your Claude Code skills
git clone https://github.com/zhoushoujianwork/easyeda-agent

Getting Started

Guides for using ai agents skills like easyeda-agent.

Security ReportVerified

Last scanned: 8/19/2026

{
  "issues": [
    {
      "file": "CLAUDE.md",
      "line": 115,
      "type": "remote-install",
      "message": "Install command (remote install script piped to a shell — review the source before running): \"curl -fsSL https://raw.githubusercontent.com/zhoushoujianwork/easyeda-agent/main\"",
      "severity": "medium"
    },
    {
      "file": "README.md",
      "line": 106,
      "type": "remote-install",
      "message": "Install command (remote install script piped to a shell — review the source before running): \"curl -fsSL https://raw.githubusercontent.com/zhoushoujianwork/easyeda-agent/main\"",
      "severity": "low"
    },
    {
      "file": "README.md",
      "line": 155,
      "type": "dangerous-command",
      "message": "Dangerous command (writes to Claude config): \"> 下载 `skills.tar.gz` 解压到 `~/.claude/\"",
      "severity": "medium"
    }
  ],
  "status": "PASSED",
  "scannedAt": "2026-08-19T04:35:55.898Z",
  "npmAuditRan": true,
  "pipAuditRan": true,
  "promptInjectionRan": true
}

README.md

Frequently Asked Questions

What is easyeda-agent?

easyeda-agent is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by zhoushoujianwork. 嘉立创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. It has 234 GitHub stars.

Is easyeda-agent safe to use?

Yes. easyeda-agent passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install easyeda-agent?

Clone the repository with "git clone https://github.com/zhoushoujianwork/easyeda-agent" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is easyeda-agent written in?

easyeda-agent is primarily written in Go. It is open-source under zhoushoujianwork on GitHub, so you can review or fork the full source.

Are there alternatives to easyeda-agent?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh easyeda-agent against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

241,003

codex-settings google_ads_mcp

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.

Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.

Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

Read the Terms of Service

easyeda-agent workflow

当前版本:v1.0.0 —— 原理图功能正式上线。 AI Agent 通过类型化命令操作 EasyEDA Pro, 从一份客户口吻的需求文档出发,原理图全流程(S0–S6:方案书 → 分页 → 分区 → 摆放 → 布线 → 机械门禁 → 交付)已可正式交付;PCB 流程(P0–P10)持续演进中。真机成图见下方实战展示。

easyeda-agent 把官方 EasyEDA 扩展 API 变成一套有类型、可观测、Skill 友好的系统。EasyEDA 插件保持极薄——它连到本地 agent、只执行被批准的动作;Go CLI/daemon 掌管协议、状态、产物、校验和面向用户的工作流。

为什么做这个

上游 run-api-gateway 证明了关键入口:代码能跑在 EasyEDA 内、访问官方 eda 对象。但它把「裸 JavaScript 执行」当作主工作流——强大,但对 AI agent 太脆弱。

本项目的连接器是真实可用的:daemon 固定监听单端口 60832(0xEDA0,"EDA" 写进十六进制;0.15.0 起弃用与官方 gateway 冲突的 49620)(不外溢、被占用时自动接管旧 easyeda daemon)、连接器锁定该端口、校验握手、自愈重连、把一套有类型的动作目录分发到官方 eda.* API。裸 JS 仅作为需二次确认的 debug.exec_js 逃生口保留。

Skill 描述专家工作流和护栏;
Go CLI/daemon 暴露稳定的 typed actions;
EasyEDA 连接器插件 只做到官方 eda.* 的桥接;
产物、截图、DRC 结果、审计日志都是一等输出。

工作原理

Skill 或人跑一条 easyeda 命令;
Go CLI 校验输入、把 typed action 提交给本地 daemon;
daemon 跟踪已连接的 EasyEDA 窗口、经 WebSocket 路由每个动作、记录审计日志/产物/校验结果;
连接器扩展跑在 EasyEDA 内、调用官方 eda.* API;
结构化结果回流到 CLI 和 Skill,下一步基于真实编辑器状态来规划。

动作目录已覆盖原理图、PCB、文档导航、板级绑定、产物导出、诊断。完整清单与路线图见 docs/FEATURES.md。

站在巨人的肩膀上

我们不重造轮子,而是把成熟的一层层能力叠起来,让 AI agent 直接可用:

官方 eda.* API —— 嘉立创 EDA 专业版自己暴露的 86 个命名空间,是真正的能力底座;
上游 run-api-gateway —— 证明了「代码能跑在 EasyEDA 内、访问 eda 对象」这条关键入口;
成熟的 AI Agent Skill 范式 —— 用 Skill 描述专家工作流 + 护栏,用 typed action 让每一步可观测、可验收、可回放,而不是把「裸 JS 执行」丢给模型硬扛。

在这三层之上,easyeda-agent 补齐了工程化的中间层:自愈连接器、有类型的动作目录、真实 bbox 校验、门控设计流程,以及下面这个核心特色——电路块库。

核心能力 & 特色

能力总览(完整清单见 docs/FEATURES.md):

能力域	做什么
电路块库(旗舰特色)	社区共建、署名可追的成熟外设电路库(`easyeda blocks`,37 块:19 ready / 13 verified / 5 draft):CH340 USB 串口、ESP32 自动下载、按键去抖、USB-HUB、降压…`sch block-apply` 一条命令放件 + 连线 + 网表对账,照抄拓扑、只重绑引脚网络即可复用
原理图(v1.0.0 正式上线)	全流程 S0–S6 可交付:库优先放件(真实 LCSC/JLC 器件)、编组、布线、netflag/netport;三层布局体系 Sheet→Zone→Group——分区框 + 区名 + 电路说明由算法计算落位,生成与校验用同一把尺
机械门禁与审计	`sch gate --strict` 一条命令过五关(layout-lint→clusters→check→bridge-check→drc),bridge-check 新增 orphan-tree 悬空树判据(连接器 ≥0.26.1);跨页网名审计 `sch nets --strict` + 块对账 `sch reconcile` + netlist 黄金表逐脚比对
PCB	自动布局、板框、禁布区、规则感知短线布线、4 层电源平面、铺铜、丝印避让、DRC/`pcb check`
设计流程	从客户口吻需求到成品的门控主脊(S0–S6 + P0–P10),里程碑确认,存盘检查点
产物	BOM(补 LCSC C 号)、网表、导出、原生截图、审计日志、录制→回放

特色:电路块库(一次贡献,永久收益)

固定模块的外设电路可以直接照抄。 ESP32 自动下载电路、CH340 USB 烧录、按键去抖、 USB-HUB…这些电路的内部拓扑是死的,每次重画等于重趟坑。电路块库把它们沉淀成验证过的、可复用的电路块(当前 37 块:19 ready / 13 verified / 5 draft)—— sch block-apply 一条命令完成放件 + 连线 + 网表对账,你只需重绑对外的几根线(ports) 到主控网络,引脚用功能名引用所以零改号,器件直接指回标准器件库(BOM 就绪)。

社区共建 + 署名可追:每个块带 author/contributors,一次学习贡献、永久收益;
验证门禁:块必须跑过 place → wire → check → DRC=0 才入库,不是「看着对」的散文堆;
三维知识:器件(可替换选择)+ 原理图链接注意 + PCB 布局电气特性,一块讲全;
AI 直接消费:agent 放外设前先查块库,命中即抄,省掉一整个模块的选型与接线。

库已内嵌进 CLI:easyeda blocks ls/show/search 离线可查(无需 daemon/窗口) · 贡献指南 standard-blocks-contributing.md

安装

完整上手 & 使用注意事项见快速开始 → —— 四件套 (CLI / 连接器 .eext / Skill / EasyEDA)的安装、版本对齐、启动 daemon、升级纪律与常见卡点速查,一页讲清。下面是精简版。

easyeda-agent 是一套四件套,四者需同版本、同时在位:CLI/daemon、连接器 .eext 插件、easyeda-agent Skill、开启「允许外部交互」的 EasyEDA Pro。升级时三方(CLI + 连接器 + Skill)要一起升到同一版本,否则 easyeda daemon health 会把落后的连接器标成 stale。

先装 easyeda CLI/daemon,再装 EasyEDA 连接器 —— 两条通道任选:安装器会打印与 CLI 严格同版的 GitHub Release .eext 下载地址(导入即用),或从立创官方插件市场一键安装(平台可原地自动更新,但市场版本可能滞后 CLI,严格四件套同版时以 Release .eext 为准):

ℹ️ 插件更名说明(2026-08):应市场管理规范要求,插件显示名改为 EDA Agent Connector(不再含 "easyeda" 字样)。经与市场管理员确认,内部包名 easyeda-agent-connector 与 uuid 均保持不变,同一条目重新上传即可 —— 已装用户的原地自动更新不受影响,无需任何操作。

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

一键脚本会：安装/更新 easyeda CLI/daemon;自动检测已安装的客户端并把 easyeda-agent skill 安装/更新到对应目录 —— Codex(~/.codex/skills/easyeda-agent)、Claude Code(~/.claude/skills/easyeda-agent);打印连接器 .eext 导入地址。

装过之后升级不必再跑脚本 —— 用 easyeda update:

easyeda update              # CLI 二进制(sha256 校验 + 原子替换)+ skill 目录 → latest
easyeda update --check      # 只读:cli / skill / connector 三方版本对齐表
easyeda update --check --exit-code   # 有落后退出码 10(CI/agent 可 gate)
easyeda update --version <x.y.z>     # 钉版本;--skill-only / --cli-only 缩范围

连接器 .eext 不在自动升级范围内(侧载无原地更新)—— update 会报出它落后并打印重导地址。 dev 构建(git-describe 版本号)默认不覆盖,--force 才强升;二进制在 root 目录时用 sudo easyeda update。

可用环境变量控制 skill 安装:

EASYEDA_INSTALL_SKILLS=codex,claude curl -fsSL .../install.sh | sh  # 指定目标
EASYEDA_INSTALL_SKILLS=none          curl -fsSL .../install.sh | sh  # 跳过 skill
EASYEDA_SKILL_PRESERVE=1             curl -fsSL .../install.sh | sh  # 保留本地改动
EASYEDA_VERSION=<vX.Y.Z>              curl -fsSL .../install.sh | sh  # 指定版本(跳过 API 查询)

遇到 403 / GitHub API 限流:脚本默认要调一次 api.github.com 解析 latest release,匿名调用每个 IP 每小时只有 60 次 —— 公司出口 / NAT / CI 很容易撞满。两条出路(脚本报错时也会打印):

export GITHUB_TOKEN=<token>   # 或 GH_TOKEN;已登录 gh CLI 时会自动取 `gh auth token`
gh auth login                 # 等价做法,额度提升到 5000/小时

EASYEDA_VERSION=<vX.Y.Z> curl -fsSL .../install.sh | sh   # 或者直接锁版本,完全不碰 API

可用 tag 见 Releases。

Skill slug 为 easyeda-agent(后缀有意为之,区分于官方 EasyEDA 工具)。只从 registry 装 skill:

# ClawHub(make release 时自动同步发布,版本与 repo 对齐)
clawhub install easyeda-agent

国内用户注意:skillhub.cn 目前是纯网页社区,未实现 CLI 安装接口 (/api/cli/v1 返回的是网页而非 API),skillhub install --registry https://skillhub.cn 无法工作。请改用上面的一键脚本,或从 GitHub Release 下载 skills.tar.gz 解压到 ~/.claude/skills/ 或 ~/.codex/skills/。

EasyEDA 需开启「允许外部交互」,连接器的 WebSocket 才能连到本地 daemon。

可选:MCP 接入

仓库内的 mcp/ 是一个本地 stdio MCP 适配层,方便 Codex 等支持 MCP 的 agent 直接发现并调用 easyeda_* 工具。它复用现有 easyeda CLI/daemon,不会绕过 typed action、审计、workflow gate 或官方 eda.* API;任意 JavaScript 的 debug.exec_js 域不会通过 MCP 暴露。

npm --prefix mcp ci --ignore-scripts
codex mcp add easyeda-agent \
  --env EASYEDA_BIN="$(command -v easyeda)" \
  -- node "$(pwd)/mcp/src/server.mjs"

重启 agent 客户端后即可使用。其他 MCP 客户端使用同一 stdio command/env 配置; 详细工具清单与开发验证见 mcp/README.md。

效果演示

实战展示:一份需求文档 → 三页原理图正式交付

v1.0.0 的原理图全流程真机成图(esp32Mini 固定回归用例):输入只是一份不含 BOM/网表的客户口吻需求文档,agent 沿 S0–S6 自己完成选型、放置、连线、分区与门禁—— 3 页原理图 / 26 个真实 LCSC 库件 / 18 网黄金表逐脚全对 / 复用 6 个电路块 / 8 个分区框 + 7 条电路说明,分区框、区名与电路说明全部由算法计算落位,逐页 sch gate --strict 通过。

P1 电源页:AMS1117 LDO 降压,分区框 + 区名 + 电路说明由算法落位

P1 电源页:AMS1117 LDO(5V→3V3)分区框 + 区名 + 电路说明,全部算法计算落位。

P2 主控页:ESP32 WROOM 最小系统 + 按键 + LED,三个分区框

P2 主控页:WROOM 最小系统、BOOT/RESET 按键、指示 LED 三个功能分区。

P3 USB 页:CH340 + USB-C + 自动下载电路,四个分区框

P3 USB 页:CH340 USB 串口、USB-C 接口、自动下载等四个功能分区。

完整实战案例:一份需求文档 → AI 全自动画完 ESP32-S3 四层板 —— 19 器件原理图 + 四层 PCB(GND 内电层/VCC 电源层/天线禁铜/四角 M3), pcb drc Connection/Clearance 双归零、pcb check 0、layout-lint 100/100,附原生截图与全流程复盘。

下面两段录屏来自真实 EasyEDA 画布:AI 从空白页开始生成原理图,再切到 PCB 完成布局、板框、铺铜和丝印。它不是生成一张电路图图片,而是在编辑器里一步步执行 typed actions:

原理图从空白页生成	PCB 布局与铺铜

下面这块板由 agent 驱动完整 PCB 流程产出——自动布局 → 板框贴合 → 规则感知布线 → 4 层电源平面 → 丝印碰撞避让——并在真实 EasyEDA 画布上验证(DRC 31 → 3、No-Connection 归零):

几个单步的真机前后对比(同一块板):

`pcb outline-fit` 板框贴合(利用率 17% → 71%)	`pcb silk-align` 丝印碰撞避让
→	→ 对齐后见上方成品板

上面 GIF 和截图都来自回归板真机流程(原理图 → 导入 PCB → 4 层叠层 → 布局 → GND 内电层/VCC 信号 plane → 天线禁区+检查 → 丝印/LED 极性 → 挖槽),非 mockup。这也是项目的固定端到端回归用例(拿原始需求从零跑),见 esp32MiniRequire.md。

原理图自动放置:两个引擎(模板 vs 官方)

同一个 ESP32-S3R8 最小系统块,两种放置引擎的真机对比(都 sch check 0 悬空导线、已连线):

`--engine template`(默认,推荐)	`--engine official`(官方 autoLayout 兜底)

块 `schematic_layout` 模板驱动:去耦帽贴电源脚一字排开、上拉靠引脚、晶振/FLASH 分列,信号流左入右出,功能分组、紧凑可读;原点自动避碰、落后真实 bbox 自检	平台 `eda.sch_Document.autoLayout()`(@beta):连通性聚类放射状,较散、留白大;是破坏性长操作(移件不移线),封装加了安全管线(已连线守卫/吸附 5 格/`--rewire` 重连/`sch check` 自检)

两版都能用、都还有少量重叠(模板版当前还会碰标题栏右下角,官方版散件间距不均),放置的正确性由机械门禁保证:sch layout-lint(真实 bbox 查重叠)+ sch check/bridge-check(查断线/短路)。多页工程/长操作用 --doc <page> flag 机制性地钉住目标页,不再靠人工切页(避免长命令落错页)。

官方引擎在真正调用 autoLayout() 前会二次核对同一页的部件姿态、sheet 与全部 connectivity（wire/bus/net marker），并在启动变异的同一个 JS action 内再锁一次 document/input；--rewire 还核对完整网表，输入漂移立即拒绝。bus 目前无法可靠重建，即使 --rewire 也拒绝。后续 snap/重连/save 继续钉在同一 UUID；几何回读、sch check、重连或持久化任何一步不可用，或残留 overlap / pin 重合 / dangling 等结构性问题，都会非零退出。官方 API 没有事务回滚，因此 post-check 失败表示“页面已变但未过门”，必须先修复或撤销。

优先级铁律:命中电路块 → sch block-apply 模板;有 S0 分区 spec → --engine template;都没有才