zhoushoujianwork/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.

什么是 easyeda‑agent？

easyeda‑agent 是 EasyEDA Pro（JLC EDA 在线设计套件的专业版）的 AI 驱动自动化层。它让您用自然语言与 AI 助手对话，并让它 读取数据手册、创建符号/封装、绘制原理图、布局 PCB、调整丝印、运行 DRC/DFM 检查，最后保存设计 – 全部通过 EasyEDA 公开的官方 eda.* API 完成。

核心能力

领域	代理能做什么
库创建	从 PDF 或机械图纸中提取零件编号、引脚和封装尺寸，然后在您的个人 EasyEDA 库中创建完整的符号、封装、器件（以及可选的 3D 模型），并在写入前提供证据页面和验证。
端到端板卡创建	根据自然语言需求（例如“ESP32‑S3 最小系统，4 层，USB‑C 下载，电源轨，天线禁布区”），代理选择零件、构建原理图、划分板卡、放置组件、布线、铺铜、生成丝印，并在保存前运行完整的 DRC/DFM。
组件标准化	扫描现有原理图，查找非标准零件，用精确的 LCSC C 编号或官方封装替换它们，同时保留引脚编号、位置和关联的 PCB 实例。
原理图清理	检测悬空网络、短路、跨页网络名称、NC 引脚、引脚编号不匹配，并可自动重新排列原理图并重新运行检查。
PCB 布局与布线	模块感知的自动放置、板框适配、规则感知的短走线布线、过孔插入、铺铜、4 层电源平面生成、天线禁布区等。
丝印编辑	将丝印项移离焊盘、组件和禁布区，添加板卡注释、连接器名称、LED 极性标记，甚至 SVG 徽标。
复用已验证模块	内置常用电路库（CH340、ESP32、电源稳压器、USB 集线器等）可拖入设计，自动接线并与原理图协调。
验证与交付	生成 BOM、网表、制造文件、截图、审计日志，并在每一步后执行显式保存。

使用方法

安装 EasyEDA CLI/守护进程和 AI 技能，使用一行脚本（macOS/Linux 的 install.sh 或 Windows 的 install.ps1）。安装程序验证校验和、设置环境变量，并检测您拥有的 LLM 客户端（Codex、Claude 等）。
添加连接器 到 EasyEDA Pro，从 JLC 插件市场（或从 GitHub releases 下载 .eext 文件），并在 EasyEDA 设置中启用 允许外部交互。
启动守护进程：easyeda daemon start。
与代理对话 – 通过支持的聊天客户端或向技能提供提示。README 中提供了示例提示，用于从 PDF 创建库、构建 ESP32‑S3 板卡、修复丝印、标准化组件或进行完整设计审计。
代理将请求转换为 类型化操作，CLI 将其发送到连接器，连接器再调用官方 eda.* API 读取/写入项目。每个操作都有前置检查和后读验证，守护进程在成功步骤后自动保存项目。

安装快照

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/zhoushoujianwork/easyeda-agent/main/install.sh | bash
# Windows PowerShell
irm https://raw.githubusercontent.com/zhoushoujianwork/easyeda-agent/main/install.ps1 | iex

脚本验证 SHA‑256 校验和，将 CLI 安装到 $HOME/.local/bin（Windows 上为 %USERPROFILE%\.local\bin），并将技能文件放置到 LLM 客户端可以加载的位置。

当前限制

布线：完全密集的迷宫式自动布线仍需要外部工具，如 Freerouting；内置布线器处理短而清晰的连接。
撤销：EasyEDA 的 API 缺乏程序化撤销，因此代理依赖写入前保护、写入后验证和显式保存来保持设计安全。
阻抗：API 无法读取所有叠层参数（介电常数、铜厚），因此代理无法自动保证阻抗受控的走线。
PDF 库创建：当 PDF 包含清晰的型号、引脚表和焊盘尺寸时效果最佳。模糊或低质量的扫描会导致代理暂停并请求澄清。

了解更多

快速入门指南 – docs/quick-start.md
CLI 参考 – docs/cli/schematic.md 和 docs/cli/pcb.md
功能列表 – docs/FEATURES.md
架构与协议 – docs/architecture.md / docs/protocol.md
展示项目 – ESP32‑S3 4 层板卡、AS07‑M1101D SMA 库创建、JLC PCB 考试布局等。

许可证

MIT（美化模块包含一些 Apache‑2.0 组件）。

简而言之

easyeda‑agent 让 LLM 在 EasyEDA Pro 中充当 设计助手：您描述需求，它读取数据手册、构建库、绘制原理图、放置和布线 PCB、清理丝印、运行检查并保存结果 – 全部通过类型化操作 API 完成，保持工作流安全且可审计。