AI 画电路板终于不用点鼠标了！开源 Copperhead 把 PCB 当代码改

让 AI 帮你设计电路板，这个想法最近终于落地了。但先问一句：AI 到底该怎么操作 KiCad 这种专业软件？按人的路子来，截屏、识别界面、挪鼠标？之前让 AI 把 GUI 操作写成代码的 OpenGCUA 走的就是这条路。而今天要聊的开源项目 Copperhead，思路更彻底：它压根不碰屏幕。

Copperhead 是一个 Apache-2.0 协议开源的 TypeScript 项目，官方自述一句狠话：「Cursor for circuit boards」，电路板界的 Cursor。它能从自然语言需求出发，直接设计、记录并验证真实 PCB，还直接在已有的 KiCad 仓库上干活。截至发稿，仓库 627 星、135 fork、264 个 open issues。

结论先放前面：AI 画电路板最稳的路子，不是点鼠标，而是把电路板当代码库。理解了这句话，你就理解了 Copperhead 的全部。

为什么对着像素干活是条死路

截屏加点击的方案看着直观，其实脆得不行。你想想那个画面：模型盯着一张电路板软件的截图，猜每个按钮在哪，点偏了就重来。一次两次还行，几百步操作叠下来，错误率是连乘的，根本没法看。界面一更新，元素位置一挪，脚本就废了；点错一个坐标，可能把网络删了都不知道。给 CLI 装 Agent 接口的 CLI-Anything 也印证了同一件事：文本才是 AI 的母语，对着文本干活，远比对着像素干活可靠。Copperhead 把这个思路推到了电路板设计上：KiCad 的工程文件，本质上就是文本。

核心机制：直接读写 KiCad 源文件

翻开任何一个 KiCad 工程，.kicad_sch 和 .kicad_pcb 都是 S 表达式格式的纯文本文件。对人来说可读性一般，对 AI 来说是天生的代码库。Copperhead 直接读写这些文件，用 markdown 设计文档充当长期记忆，改完电路就调用 kicad-cli 跑 ERC 和 DRC 检查。说白了，ERC 和 DRC 就是电路板的编译器报错，过不过，工具说了算。万一哪次改动搞砸了，还有 git 快照兜底，改电路像改代码，说回滚就回滚。

顺带补一个供应链细节：npm 上的 copperhead 最新版本是 0.12.0，累计发布了 11 个版本（截至发稿），迭代速度肉眼可见，安装前认准官方包名就行。

两条铁律，把 AI 关进笼子

光能读写还不够，Copperhead 给 agent 立了两条铁律：

spec 门禁：没有通过验证的变更提案，agent 连 KiCad 文件都碰不到。
验证门禁：每次文件改动后必须跑 ERC 和 DRC，工具不点头就不算完成。

这两条铁律看着朴素，其实把人机分工讲透了：人负责拍板要不要改，agent 负责执行并自证清白。AI 提的每个方案都得先写清楚改什么、为什么改，过得了验证才配碰工程文件。

官方把它浓缩成一句口号：drift is a build failure，设计漂移就是构建失败。文档里说改了、原理图没跟上？检查直接亮红灯。它把「文档和实物对不上」这种硬件团队的老毛病，变成了机器能自动抓的构建错误。这种「工具不点头就不算完成」的安全思路，和之前聊过的 Perplexity SPACE 沙箱给 AI 加护栏是一个逻辑：先设边界，再放 AI 进场。

安装就一行命令

安装就一行命令：npm install -g copperhead。前置要求不复杂：Node.js 20 以上、KiCad 8 以上（保证 kicad-cli 在 PATH 里），再加一个模型后端，Claude Code、Cursor Agent CLI、Codex CLI 任一已登录，或者直接配 ANTHROPIC_API_KEY 或 OPENAI_API_KEY 也行。装完先跑 copperhead doctor 做环境体检，不调大模型、不联网，哪里没配好直接告诉你。

还有更省事的玩法：在 Claude Code、Cursor 或 Codex 里，直接贴一句「Install copperhead for this repo using https://raw.githubusercontent.com/copperheadhq/copperhead/main/agent-install-prompt.md」，AI 助手就会自动把环境装好配好，连这一步都能交给 AI 自己办。macOS 和 Linux 用户还有官方 install.sh 一键体检可用，README 里写得很清楚：它从不 sudo、不改 shell 配置，能安全处理的它自己来，处理不了的就把命令原样打印出来，让你自己决定跑不跑。

KiCad 工程文件本质是 S 表达式纯文本，AI 直接改源码，改完跑 ERC 和 DRC，工具点头才算完成

核心命令走一遍

README 里给出的核心命令就这几条：

copperhead init
copperhead do "add reverse-polarity protection on VIN"
copperhead check
copperhead create --brief brief.md
copperhead export bom --supplier jlcpcb

copperhead init 会从原理图脚手架生成 docs/ 目录，幂等，跑多少次都一样。copperhead do 是核心，它的六步循环值得展开讲：先读设计文档再动手，不瞎猜；跟你来回讨论方案，而不是闷头改；编辑真实文件时，全篇统一器件名和网络名；改动自动传播到所有引用它的文档和原理图；然后跑 ERC 和 DRC，读报错、修报错；最后，每条真正的决策都在旁边留一行理由，防止下次改动悄悄推翻之前的判断。一个循环走完，代码和文档一起往前走。

copperhead check 是给工程化玩家准备的：ERC、DRC、文档漂移、spec 校验一次跑完，全程零 LLM，可以直接挂进 CI。更狠的是 copperhead create，扔给它一份产品简报，它就从 spec、架构、选型一路跑到原理图、初版布局、Gerber，连固件脚手架和开发计划都备好。仓库的 examples/ 目录里还放着按难度分级的现成简报，官方特意注明其中一个是故意设计成会失败的，专门用来演示检查怎么拦住坏设计，拿它练手最直观。

另外两条命令也值得一提：copperhead sync 用来校验整个设计状态、消解漂移，还支持 –dry-run，先预演一遍会发生什么，确认没问题再真动手。copperhead demo –tour 更友好，完全不调 LLM，就能看到 agent 平时都在干什么，想先围观再上手的，从这里进。

画完板要打样？copperhead export bom 能把 docs/BOM.md 转成嘉立创、得捷、Mouser 可用的下单文件，同样是确定性转换，零 LLM 零网络。数量算法也替你想好了：–boards 参数默认 1，–spares 备件率默认 10%，下单量按每板用量乘板数再乘备件率向上取整；电阻电容电感这类被动件保底再多加 2 个，官方解释相当接地气：镊子夹丢几颗 0402 是常态。质量门禁更严：没有 MPN 或者还标着 UNVERIFIED 的行，根本不会进供应商文件，只在警告里点名让你补。要是 BOM 和原理图对不上，它会直接拒绝导出。还有个实验性的 copperhead mcp，向 MCP 宿主暴露 5 个粗粒度工具。

从产品简报到 Gerber 与 BOM 下单文件，流水线终点直接对上嘉立创、得捷、Mouser

泼点冷水：官方自己的成熟度自白

吹了这么多，得讲讲风险，这回是官方自己承认的。init 和 check 这类工具是确定性代码，零 LLM，有离线测试覆盖，可以放心用；但 do、sync 的冲突解决、create 这些 agent 循环，官方原话是「已实现，尚未被证明」，验收测试需要真模型，他们还没观察过端到端跑通。加上 264 个 open issues，项目还在快速迭代期，别急着拿它上生产线。

还有个安全细节：如果你用 Codex 当后端，它的只读沙箱并不限制读取，项目里的 .env 这类敏感文件可能被读到；会话日志也不受脱敏边界保护。密钥文件该挪还是挪。