easyeda-agent

name	easyeda-agent
description	Community EasyEDA Agent automation skill for EasyEDA Pro schematic and PCB work through the local easyeda-agent CLI/daemon/connector. Use when designing a board from scratch; inspecting, cleaning up, or safely refactoring an existing wired schematic; arranging multi-page functional modules; drawing page-scoped module frames and text labels; preserving and reconciling pin-to-net topology; placing/wiring real LCSC/JLC library parts; syncing schematic changes into PCB; laying out PCB components; running EasyEDA DRC/check/bridge-check/layout-lint; exporting BOM/netlists/artifacts; querying the embedded circuit-block library (`easyeda blocks ls/show/search`); or applying the bundled EasyEDA design workflows and conventions. 覆盖嘉立创EDA专业版原理图/PCB、混乱原理图整理、多页功能分区、框选文字标注、布线、铺铜、板框与机械门禁。适用于嘉立创EDA(JLC EDA / JLCEDA / LCEDA / EasyEDA Pro)与立创商城(LCSC)元件的电路板设计自动化。
license	MIT
compatibility	Requires the local easyeda-agent CLI and daemon (macOS/Linux/Windows) plus the EasyEDA Agent Connector extension installed in EasyEDA Pro with 'Allow external interaction' enabled. Bundled scripts need Python 3. Network access is needed only for LCSC part lookup and self-update.
metadata	{"author":"zhoushoujianwork","version":"1.3.0","homepage":"https://github.com/zhoushoujianwork/easyeda-agent"}

EasyEDA Agent

Use the local easyeda CLI and daemon to operate EasyEDA Pro through typed, observable actions. This is the community easyeda-agent workflow, not an official EasyEDA skill; the suffix is intentional so users can distinguish it from upstream EasyEDA tooling.

本 skill 单独装上没用 —— 它要驱动两个外部件:本机 easyeda CLI/daemon + EasyEDA Pro 里的连接器插件。 源码与文档:https://github.com/zhoushoujianwork/easyeda-agent

① 装 CLI/daemon(一行,自动识别平台;已装过则用 easyeda update 升级):

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

② 装连接器插件(.eext)—— 二选一,都要在 EasyEDA Pro 里操作:

• 立创EDA官方插件市场(推荐,一键装、平台可原地自动更新): https://jlc-ext.com/item/zhoushoujian/easyeda-agent-connector ⚠ 市场版本可能滞后 CLI 若干 minor。
• GitHub Release 直下(与 CLI 严格同版,四件套同版以它为准): https://github.com/zhoushoujianwork/easyeda-agent/releases/latest 下载其中的 easyeda-agent-connector.eext → EasyEDA 扩展管理导入。 同 uuid 更新必须先在「已安装」卸载旧的,否则导入静默失败;导入后完全退出重启 EasyEDA,否则已开窗口仍跑旧代码并抢 daemon。

③ 开权限:EasyEDA 里打开工程 → 启用「允许外部交互 / Allow external interaction」, 否则连接器的 WebSocket 到不了 daemon。装完用 easyeda health 验证(应看到 window 与 connectorVersion)。

升级:easyeda update(CLI 二进制 + skill 目录,sha256 校验后原地替换); easyeda update --check 只看不改,连接器只能人工重装 → environment-setup.md §0.5。

**MCP 可选入口:**若当前 agent 暴露 easyeda_* MCP tools,可优先用它们完成 health、 action discovery、typed calls、blocks 和 workflow 操作。MCP 只是同一 CLI/daemon 的 stdio 适配层;下方全部铁律、inspect-before-mutate、阶段门和存盘要求保持不变。

本 SKILL.md 顶部是「抗遗忘扫读区」——执行任何板级任务前先扫这几屏,别凭记忆走。 顺序:① 铁律(不可违反)→ ② 流程停点 / 档位默认 / 块地图 三张速查 → ③ 顺序硬约束。 具体细节不堆在这里——按下方 What To Read 的加载触发表按需读 reference(渐进式披露)。

① 铁律(不可违反)—— 抗遗忘扫读区

扫读式硬约束,任何模式都不问用户、不商量。违反 = 返工或坏板。每条带 → 指到细节文件。

1. 窗口操作前先 easyeda health — 否则打到错窗口 / 无连接器;它带 versionGate 判定块,版本错位时后续动作当场被拒(拒绝消息自带修法;明知故犯:--skip-version-check / EASYEDA_SKIP_VERSION_CHECK=1,会写审计)。撞门先对版本,别怀疑电路或工具坏了。→ environment-setup.md §0.5
2. 只用 typed easyeda action — 只有无对应 typed action 且用户明确接受 debug 路径时才 debug.exec_js。
3. mutate 前先 inspect — 放/移/连/同步/存之前先读 doc/页/器件/引脚/板层/网络/规则,别盲改;破坏性操作(clear/delete/bulk import)先确认。
4. 无图纸不摆放/布线 — 找不到 sheet 立即停,让用户建/批准 A4(默认 A4)。→ design-flow S1
5. PCB mutation(rip-up/route/delete/via/track)后先 easyeda doc reload 再读/判/DRC — 机械强制:不 reload 就读,daemon 直接拒(STALE_READ)并告诉你下一步该跑什么;同网 Connection Error 暴增先 pour-rebuild,不是真断。正常修法永远是 doc reload;确需读旧状态才用逃生口 --force-stale-read "<理由>"(入审计、只放 PCB 读、解不开布线门;不是 --force——那是布线阶段门)。→ pcb.md「PCB mutation → doc reload 门」
6. 判对错只看 list/check/drc/layout-lint/layout-score,不看截图 — 截图会 stale/blank;data 有内容但截图空 = 窗口没渲染(切前台),不是设计错。(layout-score 是诊断视角不是门——门只有 layout-lint --gate 一个;且它的 skipped 维是「没测」不是「满分」。)pcb drc/check 这类重画布计算需 PCB 在前台,超时=切前台单发一次、绝不循环重试(重发被 ACTION_BUSY 拒)。录制/演示模式例外:截图变交付物 → design-flow 录制/演示模式。
7. 每过一个阶段门显式 save(sch/PCB) — place/wire/modify 只改内存,autosave 只兜底;整板每 ~10 件 save 一次。→ design-flow S 段 💾
8. 手工连任何已知外围前先查块库 easyeda blocks(离线,无需 daemon/窗口)— blocks ls 看全量,照抄验证过的块只重绑端口。查不到 → 起草 block-gap issue;块用出问题(脚名不符/拓扑错/停产)→ 起草 block-bug issue 带证据 —— 都必须经用户确认后才 gh issue create,绝不自动上报。→ ② 块地图速查 · standard-blocks-contributing.md §七
9. netflag 必须经真 wire 连、离 pin 非零距 — 重叠坐标 EasyEDA 不认作连接;禁零长 wire;多脚同名 pin 要全连(如多 GND、AMS1117 双 VOUT)。→ schematic.md
10. RF/天线 keepout 覆盖每一层 — top+bottom no-copper + 内层 no-inner-electrical;top-only 会被底层 pour 灌到失谐。→ pcb-routing.md「Keep-out / rule regions」
11. — 端子塑料罩/卡座壳/按键帽会盖住 footprint 内的丝印 = 等于没标。→ design-flow P9

② 流程停点 + 档位默认 + 块地图速查

执行前先定位自己在哪个阶段、这一步是不是停点、走哪个档、这阶段要不要先查块。 完整流程 S0–S6 / P0–P10 见 references/design-flow.md;非平凡板(>~10 件或要交付/排 PCB)一律走它的 gated flow。 这里是执行时扫读用的顶层速查。

何时必须停手交回用户(里程碑档 = 真实用户默认)

停点	触发	要点
① S0 方案书	进 S1 前	架构/叠层/地策略/接口取向每条摊选项+坑+推荐让用户拍板;必须落成磁盘文件才算过门,不能停在对话里
② sch→PCB 前	原理图完成	逐页 easyeda sch gate --strict --doc <page> 出 verdict=pass(一条命令跑完 layout-lint→check→bridge-check→drc 四关,顺序与阻塞判据固定在代码里,别自己拼)+ pin→net 黄金表对齐(gate 判不了「接对没有」,只判「接得合不合法」);verdict=blocked 是检查器没跑成,不是板子有问题——先修 health/doc 再重跑,别去改电路;DRC 聚合 WARN 必须审阅并报告；多页/多模块板还需确认分区框+区名标注已画(sch zones status 看认领、sch zone-draw 补画——手工摆放路径不会像 autolayout --apply 那样自动画,容易漏)+每模块电路说明已放(sch note 放、sch text-list 核——分区框只命名,说明才让人读懂) → design-flow S5
③ 发板/交付前	导出制造	交付摘要说清偏差(降级决策/遗留 WARN)
S2/S3 page-too-small	块/组比整页可用区还大	工具只停手不建页:摊给用户拍板 ①独立成页 ②继续分页 ③改标签朝向收小组(A4-only 不换纸)→ design-flow S3
P2 摆放前	布局起手	先问单/双面布局 + 焊接工艺;立即用 pcb stage set-assembly 落盘,手焊默认 min-gap=40mil/大焊盘通道 60mil
P2 边缘接口件	端子/USB/SD/排针/按键/IPEX	朝向 + 边序 = 装配体验,agent 猜不了,必须用户确认;先 blocks show 读块 placement 摊给用户
P2 分档落状态	每档摆完确认后	pcb stage confirm-tier <1-4> --parts … 逐档落盘(#125 机械化):档1孔→档2边缘件→档3主芯片+RF→档4卫星(缺省=其余);跳档被拒、动某档件只作废该档及其后;四档未齐 confirm-layout 拒绝封章
P7 稠密板布线	见下档位 + P7 迷你清单	停下请用户在 EasyEDA 菜单点「布线→自动布线」;交出去前必做两步见下方 P7 迷你清单,跑完再接手
破坏性操作 / 门禁失败	clear/delete/bulk;pcb new-board --force(已绑板会搬走原理图=旧板原理图丢失);layout-lint ERROR / DRC fatal	停在失败数据,不带病往下

里程碑档只有这几处停,不是每步都停(逐步档才每步停);全自动仅用于回归/CI/operator/录制。

档位默认(别自作主张改)

维度	默认	备注
交互模式	milestone(里程碑)	非逐步、非全自动
布线档	按 layout-lint ratsnest 密度选	稀疏(交叉<100)→ route-short;稠密 → 请用户点原生自动布线(默认);全 headless 才 Freerouting(pcb autoroute,兜底,不顶替默认)。交出去前先跑 ↓P7 迷你清单
摆放优先级	孔 → 边缘件 → 主芯片+RF → 卫星件	只有卫星件交 auto-place;孔最先放 + 锁定
图纸 / 板框	A4 / compact	无尺寸信息时 compact;compact 时主芯片按紧凑网格播种(模块中心距≈包络+300~400mil,别撒 2000mil 外),摆位/判尺寸只信 pcb list --include-bbox 实测 bbox(含 courtyard,常比封装大 40%+),不猜标称 → design-flow P1/P2
原理图组织	分页+区框+说明,见铁律 15	分页 = 每页一个功能域(电源/主控/接口…),跨页 net_port 同名同网;autolayout --apply 自动画框;说明写作用+关键参数(「LDO: 5V→3V3 1A」「BOOT: GPIO0 拉低进烧录」),放模块框下/旁不压电路 → design-flow S1–S3 · schematic-layout-conventions.md
GND 内层	power-planes --gnd-plane → 终态 PLANE	SIGNAL 铺→翻 PLANE→rebuild,不停在 SIGNAL
pour-fit --replace	true(会清跨层同网 pour)	顶/底 GND pour 要显式 --replace=false
线宽档(net-class)	按角色:信号=live默认 / 支线(3V3/1V8)10 / 主干(+5V)15 / 大电流(VBUS/VIN)20mil	pcb net-classes 查当前表;route-short 自动按角色给宽;偏细电源线被 pcb check width-under-spec 逮(§7.8)
电源走铺铜	2层 power-pour / 4层 power-planes	电源走铜面不走细线(#1 DRC 源);别拿细线穿焊盘阵布电源,裸电源网被 pcb check power-not-poured 逮
布局质量档	门=layout-lint --gate(唯一);质量表=pcb layout-score --spec <s0>(诊断,不落确认)	只有一个门,别跑成两个。layout-score 九维各 0-100+逐器件归因;默认不设 --min-score(只有 blocking=短路/重叠/出板框才非零退出),要当门用才显式给(建议 75=good 档下沿)。带 --spec 才解锁 flow-order 与 internal 连接器判定,否则这两维 skipped(「没测」≠「满分」) → design-flow P6。原理图侧对应 sch layout-score(五维:标签折叠/标签反向/外围贴核心/长链挤压/版面整洁)——同样诊断视角,;门仍是 +

P7 交自动布线前必做两步(常被遗忘,已实测踩坑)

稠密板停手交用户点原生自动布线之前,这两步不做完就交出去 = 关键网被路由器冲掉或整个交给它不擅长的活:

1. 关键网先自布并锁定 — 一条命令 pcb route-critical(#127:电源按层数 planes/pour → 差分对双源识别+成对布线+skew 实测 → 自动 track-lock);单步手工同旧法(pcb fill/power-planes/pcb track-lock) 锁死(否则自动布线器 / pour-rebuild 会把手布的关键线冲掉)。
2. 停手时必念「自动布线对话框」4 条(漏一条毁掉第 1 步):① 「已有导线/过孔」选保留、绝不选「移除」 ② 「布线图层」只勾顶层+底层、取消内层 1/2 ③ 「忽略网络」加已在平面的电源网(GND、3V3/VDD) ④ 其余默认。→ 细节 design-flow P7.0 + 自动布线对话框清单

块地图速查(块携带多维知识,按阶段读对应 map)

命中块后,不同阶段读块里不同的 map;每行统一先 easyeda blocks show <id> 读对应 map:

阶段	读块的 map	内容
S0 / S3	internal_nets · ports · parts	照抄拓扑(引脚用功能名零改号)/ 重绑边界网络 / 选型免做(parts 指回 standard-parts)
P2	placement	板边 / 朝向(edge/side/orientation,须用户确认)
P2 / P8	pcb_layout(*-adjacency / ep-*)	去耦·晶振贴脚距离(P2)/ EP 热过孔·接地缝合(P8)
P4	pcb_layout(rf-keepout / balun-mirror)	RF 禁布 / 巴伦镜像(severity=must)
P7.0	signals	差分对 / 阻抗(impedance_ohm+impedance_kind)/ 等长(length_match_mm)
P9	silk	逐脚标注(pins/label/note)

搜索策略:blocks search 命中 id/desc/category/port/part——按功能(rs485/buck/gnss)、芯片(ch340/cc1101)、 端口网(5V/USB_DP)三维轮换搜;一词没中换维度别急着手接;或 blocks ls --category <power|usb|usb-serial|rf|comms|storage|sensing|mcu|mcu-support|indicator|button|audio|display> 浏览整类(类目以 blocks ls 实际输出为准,别信这里的枚举过期与否)。

③ 顺序硬约束(反了必返工)

每条带 → design-flow 锚点;这些是同级铁律级的强顺序约束,散在深处易漏,汇总于此:

1. 摆放过 assembly+routability gate 前不布线(手焊先持久化 profile;layout-lint --gate 必须 0 tight)→ design-flow P2/P6
2. P6 可布性门在 P7 布线之前(≥目标分、0 overlap、ratsnest 可控)→ design-flow P6
3. P7.0 电源/差分先布并 track-lock,再交自动布线(见上方 P7 迷你清单)→ design-flow P7.0
4. 禁布区 / 丝印(P4/P5)在布线 P7 之前(布完再加会逼返工重绕)→ design-flow P4/P5
5. 改层数 / outline-fit 在铺铜布线之前 → design-flow P8
6. PLANE 先铺 SIGNAL 再翻;PLANE 翻好后禁打异网 via(官方缺陷 #32 不挖 anti-pad、pour-rebuild 不补救;换层先删 via 走外层,pcb check via-crosses-plane 会标出)→ design-flow P8
7. 布完必过 post-route check 门再进丝印/交付(workflow advance 跑 pcb check,ERROR/power-not-poured/width-under-spec 清零才过;WARN 挂着不处理曾致 5V 细线违规漏到人工评审才被抓)→ 铁律 14

What To Read(加载触发索引 —— load-more)

按走到的场景/阶段按需读对应 reference(渐进式披露),别预加载全部:

• health 显示 windows: [] / NO_CONNECTOR,或改了连接器(extension/),或 版本对不齐(connectorVersionOk:false、UNKNOWN_ACTION、用户问「怎么升级」):读 references/environment-setup.md(§0.5 用 easyeda update --check 一次看清 CLI/skill/连接器三方版本)。 web 编辑器(pro.lceda.cn)+ chrome-devtools MCP 时 agent 可自举全环境;桌面客户端 chrome-devtools 够不到窗口,需用户手动开/切工程(连接器照常附着,typed action 一样)。
• 整板 / 从零 / >~10 件,或走到某阶段拿不准:先读 references/design-flow.md(流程脊柱 S0–S6 / P0–P10,顶部有阶段 TOC)。含 S0 事前摸底子步 references/design-pre-analysis.md(轻量摸底,可选、非门禁)。S0 方案书 spec 写完必跑 easyeda spec validate(无 ERROR 才算过门,--strict 交付前用)——字段形状(含 flow/modules[].kind/interfaces[].ref·edge·facing·internal)在 design-flow S0。
• 布线阶段(P7)选档 / 关键网先行 / 自动布线对话框清单:读 references/design-flow.md P7 三档阶梯——别停在 pcb-routing.md 的命令手册(那里只给命令,布线档默认在 design-flow)。
• 架构权衡坑(真选择,非唯一答案——叠层、地策略、接口取向、成本档、单/双面、焊接工艺):读 references/design-decisions.md;S0 从中产出方案书让用户确认。(RF/天线 keepout 是 guardrail 铁律 10,不进这张决策表。)
• Schematic work:先读 references/schematic.md(入口:器件放置 / Actions 目录 / 电气铁律 / guardrails)。按需再读——不要一次全拉:连线细则 → references/schematic-wiring.md; 摆放命令(三层布局体系 / autolayout / autoplace-free)→ references/schematic-placement.md。
• 混乱/已连线原理图整理、多页高质量布局、功能框和文字标注:同时读 references/design-flow.md 的 S1–S6、references/auto-layout-sop.md 的 “已连线页安全整理”，以及 references/schematic-placement.md 的 “Functional frames + text labels”。先保存 pin→net/NC 黄金表，任何布局重构后必须逐页对账。
• PCB work:先读 references/pcb.md(入口:「块的 PCB 约束(先查)」+ 坐标系 + Workflow + doc reload 门 + guardrails + 命令目录)。按需再读——不要一次全拉:动铜(布线 / 过孔 / 铺铜 / 禁布区 / 填充区域)→ references/pcb-routing.md;摆放(sch→PCB 同步 / 器件 CRUD / align·distribute·grid-snap / 板框 / 自动布局)→ references/pcb-layout.md。
• 查任一 typed action 签名、或 >5 步批量操作要用 playbook(easyeda apply):读 references/actions.md。
• :读 (live 优先,此表作 fallback seed + clamp floors,)。

Bundled Scripts

Scripts live in scripts/ and are intended to be run directly when useful:

• scripts/lint.sh <project>: live schematic lint with optional diff baseline.
• scripts/tests/run.py: linter rule-trust harness; run after changes to orientation.json, linter rules, fixtures, or connector orientation facts.
• scripts/bom-enrich.py <bom.tsv/csv>: fill EasyEDA BOM Supplier Part values from standard-parts.json.
• scripts/parts-add.py: append resolved library parts into standard-parts.json.
• scripts/parts-select.py: deterministic part-selection helper.
• scripts/calibrate.js: live bbox calibration for netflag/netport orientation after importing a new connector build.

(电路块库的浏览/查找是离线 CLI easyeda blocks,不是 scripts/ 脚本;块校验是 Go 测试 go test ./internal/blocks/,跟 make test/CI 跑。)

Deliverables

Summarize changed primitives, commands run, DRC/check/lint status, saved checkpoints, and artifact paths. If a gate cannot pass, stop at the failing data, explain the next repair step, and do not claim the design is complete. 录制/演示模式下,额外列出每张阶段图并 标注 native EasyEDA 截图 或 data-rendered 图,显式报告任何 stale/替换帧。

PCB 交付摘要额外必报布局质量(#167)——只报一个综合分等于什么都没说: ① 逐维分(九维各自 0-100 + 加权综合 + verdict);② 每个弱维「是哪几个器件拉低了它」 (pcb layout-score --all 的归因,penalty 就是「先动谁」的排序);③ N skipped 及其原因 ——skipped 是「没测」不是「满分」,不写出来就是把 7 维体检报成全面体检; ④ blocking[](短路/重叠/出板框)必须是 0,非 0 就停在失败数据别宣称完成。 degraded 维(compact / rf 恒为 degraded)要连同降级理由一起报,别把近似当实测。

收尾回流(块库共建):若本板含手工搭建且已跑通 sch check + DRC=0 / 网表逐网核实的标准外围(库里没有的), 按 references/standard-blocks-contributing.md 顺手回流一个块(署名 + validated = 本次证据)——验证刚过正是入库时机, 一次设计同时是一次贡献。