easyeda-agent

<p align="center"> <img src="docs/assets/easyeda-agent-logo.png" width="96" alt="easyeda-agent logo" /> </p> <h1 align="center">easyeda-agent</h1> <p align="center"> 让 AI 直接操作嘉立创 EDA 专业版：读数据手册、画原理图、布局 PCB、整理丝印并完成检查。 </p> <p align="center"> <a href="https://github.com/zhoushoujianwork/easyeda-agent"><b>GitHub</b></a> · <a href="https://jlc-ext.com/item/zhoushoujian/easyeda-agent-connector"><b>立创插件市场</b></a> · <a href="docs/quick-start.md"><b>快速开始</b></a> · <a href="docs/cli-STATUS.md"><b>CLI Status</b></a> · <a href="README.en.md">English</a> </p>  `easyeda-agent` 是 EasyEDA Pro（嘉立创 EDA 专业版）的 AI 自动化层。你可以直接描述想做的 电路或要修的问题，Agent 会读取真实工程数据，通过官方 `eda.*` API 完成操作，并在写入前后 检查器件身份、引脚网络、几何、DRC 和保存状态。 ## 它能做什么 | 使用场景 | 能力 | |---|---| | **拿 PDF / 尺寸图建库** | 读取型号、引脚和封装证据，创建 Symbol、Footprint、Device 和可选 3D Model；校验来源、焊盘依据和 pin↔pad 映射。[实战：AS07 私有库与框外丝印](docs/examples/as07-m1101d-sma/README.md) | | **从需求做到一块板** | 从自然语言需求完成选型、原理图、分区布局、PCB、板框、叠层、布线、铺铜、丝印、DRC 和制造检查 | | **原理图器件标准化** | 用 LCSC C 号或准确型号替换非标准器件，保留位号、位置和 PCB 同步身份；报告引脚差异并指导重新接线 | | **原理图整理与修复** | 读取完整连接图，检查悬空、短路、跨页网名、NC、位号和模块归属，重新排版并回读验证 | | **PCB 布局与布线** | 模块感知自动布局、板框贴合、规则感知短线布线、过孔、铺铜、4 层电源平面、天线 keepout | | **丝印调整** | 自动避开焊盘、器件体、禁区、板框和其他标签；添加板注、接口名、LED 极性及 SVG Logo | | **复用成熟电路** | 从内置电路块库复用 CH340、ESP32 自动下载、按键、USB Hub、降压等拓扑，放件、连线并对账 | | **检查与交付** | 原理图连接与几何检查、PCB DRC/DFM、BOM、网表、制造文件、截图、审计日志和显式保存 | 当前可用范围与检查进度见 [CLI Status](docs/cli-STATUS.md)，完整能力见 [功能清单](docs/FEATURES.md)，命令索引见 [原理图 CLI](docs/cli/schematic.md) 和 [PCB CLI](docs/cli/pcb.md)。 ## 直接这样告诉 Agent 安装完成后，不需要先学习 CLI。把需求和必要的文件交给支持 Skill 的 Agent，并明确使用 `easyeda-agent`。 ### 用 PDF 创建器件库 ```text 请使用 easyeda-agent，根据附件 ABC123.pdf 为完整型号 ABC123-QFN 建库。 先检查 EasyEDA 和 LCSC 库是否已有完全匹配的器件；没有再通读整份数据手册，核对订购 后缀、引脚表、封装尺寸图和推荐焊盘。自动创建 Symbol、Footprint 和 Device，保留证据页码， 先运行离线规格校验，再写入个人库。完成后回读 pin↔pad 映射并放置一个实例检查 Pin-1。 只有手册确实存在多个无法消歧的封装或缺少关键尺寸时再问我。 ``` 这个流程使用 `easyeda lib device validate --spec …` 在打开或修改 EasyEDA 前检查数据手册 证据、几何和引脚映射，再由 `lib device build` 创建完整资产。规格契约见 [数据手册驱动的自动建库](.agents/skills/easyeda-agent/references/library-authoring.md)。 ### 做一块 ESP32 最小系统板 ```text 请使用 easyeda-agent，在项目 ceshi 中完成一块 ESP32-S3-WROOM-1 最小系统板： 5V 端子输入，降压到 3V3，CH340 USB 下载，BOOT/RESET 按键，一颗 GPIO 控制的 LED， 四角 M3 固定孔。做 4 层板，GND 内电层，模组天线区域所有层 keepout。 请自行选型并核对数据手册，从原理图、布局、布线、铺铜、丝印一直做到 DRC 和保存完成。 ``` 完整实战与真实截图见 [一份需求文档 → ESP32-S3 四层板](docs/showcase-esp32-mini.md)。 ### 调整当前 PCB 的丝印 ```text 请使用 easyeda-agent 检查当前 PCB 的全部位号和自由丝印。把压焊盘、超板框、重叠、 朝向不一致和底层未镜像的问题整理好；保留 LED 正负极、接口名称和必要板注。 完成后运行 pcb check 和官方 DRC，导出一张复核图并保存。 ``` ### 标准化原理图器件 ```text 请使用 easyeda-agent 扫描当前原理图，把无准确料号、非标准符号或封装不一致的器件列出来。 优先匹配标准器件库和准确 LCSC C 号，核对型号、封装及引脚后再替换。 替换时保留位号、位置和 uniqueId；如果 pinDiff 非空，修复接线并重新运行 sch check、 bridge-check 和官方 DRC。最后输出替换清单和仍无法确定的器件。 ``` ### 检查并修复已有工程 ```text 请使用 easyeda-agent 全面检查当前原理图和 PCB。先读取真实器件、引脚、网络、板框、叠层和 DRC 规则，再修复可以确定的问题。不要凭截图猜连接；所有修改完成后回读对账、运行连接/几何/DRC 检查、 保存，并把仍需人工决策的问题单独列出。 ``` ## 效果展示 ### 从模块尺寸图到个人私有库 **需求：** 按用户提供的 AS07-M1101D-SMA 尺寸与引脚图创建个人库，原理图保持双排引脚的 左右顺序；封装标注引脚名和型号，丝印全部放在模块覆盖区域外，安装后仍可查看，并收紧、对齐。 **结果：** 已创建并保存 Symbol、Footprint 和 Device，核对 8 个引脚与 8 个通孔焊盘映射； 修正符号边框闭合和引脚方向。封装左侧用两列脚号＋名称，列间距约 0.5 mm，靠框一列距框 约 0.6 mm；型号居中放在框外上方，实际文字包围盒回读无重叠。 最终按用户要求使用普通引脚线和未定义类型，1 脚使用独立圆形标记；保留用户清理 NC 后的状态。  这次输入是用户尺寸图，不是完整原厂 PDF；焊盘与部分偏移采用明确假设计算。 尚未验证实物装配、放置实例和 PCB DRC，不作为生产就绪证明。 [查看原始需求图、封装预览、规格与回读结果](docs/examples/as07-m1101d-sma/README.md)。 ### 嘉立创 PCB 初级考试第十八期：AT32F415 Layout 当前参数化 Layout 基线包含 69 个器件、15 个功能区和 90 × 50 mm 圆角板框，用于验证 “样例关系 → 算法候选 → AI 选择 → typed 写入 → 回读”的布局方法。该图展示布局阶段结果， 不代表整板布线或生产检查已经完成。 <p align="center"> <img src="docs/assets/demo-at32f415-exam-layout.png" width="820" alt="嘉立创 PCB 初级考试第十八期 AT32F415 学习板参数化 Layout" /> </p> 标准考试来源：**嘉立创 PCB 初级考试题第十八期**。执行步骤、参数和验证边界见 [260919 AT32F415 考试执行指导](docs/260919-exam-execution-guide.md)。 ### ESP32-S3 四层板（历史案例） Agent 完成原理图到 PCB 的完整流程，包括模块布局、圆角板框、4 层电源结构、天线净空、 规则感知布线、铺铜和丝印整理。  | 板框贴合 | 丝印避让 | |---|---| | <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="丝印整理前"/> → 整理结果见成品板 | ### 数据驱动的原理图组合 Agent 先在本地连接数据中核对器件、引脚和网络，再计算模块内部布局并写回 EasyEDA；粉色虚线框 表示独立功能区，Apply 后逐脚回读，而不是仅凭截图判断成功。   ## 安装与开始使用 easyeda-agent 由三部分组成：`easyeda` CLI/daemon、运行在 EasyEDA 内的 **EDA Agent Connector**，以及安装在 AI 客户端中的 `easyeda-agent` Skill。 ### 1. 安装 CLI 和 Skill macOS / Linux： ```bash curl -fsSL https://raw.githubusercontent.com/zhoushoujianwork/easyeda-agent/main/install.sh | bash ``` 原生 Windows（Windows PowerShell 5.1 或 PowerShell 7）： ```powershell 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)。 ### 2. 安装连接器 从 [立创插件市场](https://jlc-ext.com/item/zhoushoujian/easyeda-agent-connector) 安装，或从 [最新 GitHub Release](https://github.com/zhoushoujianwork/easyeda-agent/releases/latest) 下载 `easyeda-agent-connector.eext` 后在 EasyEDA Pro 的扩展管理器中导入。 ### 3. 启动并连接 ```bash easyeda daemon start ``` 打开目标 EasyEDA 工程，并启用 **设置 → 允许外部交互**。开始操作前运行健康检查；需要安装对账时再显式运行版本检查： ```bash easyeda health easyeda update --check --exit-code # 可选：安装版本对账 ``` 项目主线要求 **EasyEDA Pro V4**，推荐升级到已验证的 **V4.1.60 或更新 V4**。 `easyeda health` 会在 `hostCompatibility` 中单独报告宿主产品版本；V3 环境应先升级再做现场写入。 V4 适配进度和边界见 [V4 开发台账](docs/v4-development.md)。 版本差异会作为诊断输出，不作为设计动作的许可。Connector 若缺少当前动作或协议不兼容， 按诊断升级对应组件；Skill 内容更新后让客户端重新加载它。 更详细的安装、升级、代理和排障步骤见 [快速开始](docs/quick-start.md)。 ## 为什么它适合 Agent 直接把任意 JavaScript 丢进编辑器很难审查，也难确认部分失败。easyeda-agent 把常用能力封装成 有明确输入输出的 typed actions，并在工作流中加入： - 写入前检查目标工程、页面、器件身份和源数据； - 写入后回读引脚、网络、几何和对象绑定； - 原理图 `layout-lint → check → bridge-check → DRC` 分项报告事实与差异； - PCB 使用真实 DRC 规则完成布局、布线、铺铜和制造检查； - 对部分成功、超时和无法确认的结果停止盲目重试； - 自动保存作为安全网，关键节点仍显式保存。 ```text AI Agent / Skill │ ▼ easyeda CLI + local daemon │ typed actions / audit / artifacts ▼ EDA Agent Connector (.eext) │ official eda.* API ▼ EasyEDA Pro project ``` 架构与协议细节见 [架构说明](docs/architecture.md) 和 [协议说明](docs/protocol.md)。 ## 能力边界 - 稠密板的完整迷宫自动布线需要外部 Freerouting；内置路由器适合短线和清晰局部连接。 - EasyEDA 扩展 API 不提供编程式 undo，项目通过源数据、写前守卫、回读和失败回滚降低风险。 - 受控阻抗所需的介质厚度、Er 和铜厚无法从当前 `eda.*` API 完整读取，不能自动声称阻抗合格。 - PDF 自动建库仍以具体型号和原厂证据为准；扫描模糊、封装后缀不明或缺少焊盘依据时会暂停询问。 当前能力与边界见 [功能清单](docs/FEATURES.md) 和 [CLI 索引](docs/cli/README.md)。 过往调研和实测结果集中在 [历史证据索引](docs/reviews/README.md)。 ## 开发与贡献 - PCB 算法贡献：[四个公共 Go 包、数学问题与可认领任务](docs/pcb-solver-community-design.md)；`make pcb-solver-test` 可离线运行，无需 EDA。 - 文档导航与信息归属：[docs/README.md](docs/README.md) - 跨项目查询、维护 Skill 和多客户端兼容：[Agent 协作设计](docs/agent-collaboration.md) - 开发环境：[docs/dev-environment.md](docs/dev-environment.md) - 电路块贡献：[standard-blocks-contributing.md](.agents/skills/easyeda-agent/references/standard-blocks-contributing.md) - Skill 入口：[.agents/skills/easyeda-agent/SKILL.md](.agents/skills/easyeda-agent/SKILL.md) - 仓库结构与开发约定：[AGENTS.md](AGENTS.md) 感谢嘉立创 EDA 专业版开放扩展接口，也感谢 [@jlceda/pro-api-types](https://www.npmjs.com/package/@jlceda/pro-api-types)、 [Freerouting](https://github.com/freerouting/freerouting) 及 [EasyEDA 官方开源扩展](https://github.com/easyeda) 提供的基础与参考。 ## 许可证 [MIT](LICENSE)。`extension/src/beautify/` 中移植自 [Easy_EDA_PCB_Beautify](https://github.com/m-RNA/Easy_EDA_PCB_Beautify) 的文件沿用 Apache-2.0，详见 [NOTICE](NOTICE)。