嘉立创EDA审查助手 XiangyuYue/boardwise

boardwise

面向硬件工程师的智能体框架。

它让 AI 助手（Claude Code、DeepSeek、Kimi Code——随便哪个都行）真正读懂你的原理图——元件、网络、引脚，而不是截图——并在上面干实事：审查板子、标出问题、经你签字后修改、导出制造文件。EasyEDA Pro 是我们目前摸得最透的平台；KiCad 是下一个，而架构从第一天起就是多平台的。

它能做什么

审查。 打开编辑器，一条命令：

boardwise checkup

你会拿到一份报告：ERC/DRC、23 条设计规则、哪些元件还缺数据手册，每条发现都指向具体的元件、引脚和网络——画布上还会在出问题的地方画出标记。在真实板子上，它抓到过设计师漏掉的问题——比如一个没有偏置的电流检测电路，这类问题。靠拿规则去匹配网表是找不到这些的；你得检查整体架构是否说得通。当某条电源轨的电压只存在你脑子里时，intent audit 会列出这些网络并问一次；答案写进设计意图契约（intent set-rail），之后不再追问。已经落地的 PCB 审查阶段在真实板子上标出过真实的布局缺陷——比如一块四层 FOC 驱动板上，电机驱动器的散热焊盘铺铜被留成了热岛，这类问题。

修改。 找到问题，拿到变更预览；你不批准，什么都不动；改完之后它会回读并重新审查，确认问题真的没了。目前支持的修改类型：改元件值、补缺失元件、修复单条引脚连接、插入 RC/分压子电路、移动功能块。

导出。 一条 export-fab 写出整套制造文件——Gerber、贴片坐标和 BOM 一起出。（没有网表导出命令；网表只在内部读取用于审查，不写成文件。）

绘制。 你说出电路意图——分压器、RC 低通、LDO；元件、参数、哪个引脚接哪个网络——绘图编译器把它变成人能看懂的一张图：元件放哪、线怎么走、文字放哪才不会压在线上。连接关系错了、空间不够、和你锁定的布局冲突——它会拒绝，而不是塞给你一张烂图。它离线编译，也能直接落到打开的编辑器里——布局、布线前回读引脚、保存、渲染结果。多个模块可以组合到一页上：页面上已有的内容变成禁布区，你锁定的布局会被尊重，每条电源轨都加上网络标签，一条 draw discard 就能把落地的页面撤掉。

值得了解的新东西：

- 离线几何渲染——checkup --file 把每块板画成 canvas-<board>.svg（两个视图，发现的问题高亮）；画的是归档的几何数据，不是截图。
- parts accept-unknown——工程师把某个元件的未知项记录在案可以接受，所以数据手册这道闸不再卡它；这不算通过，结论里仍然计入已接受的部分。
- KiCad 裸网络 id —— 没有名字的 (net 3) 会被读取（读成 net#3），而不是因为整块板没有网络名就拒掉整块板。
- 分阶段、可中断的评审 —— 跑完一次 checkup 后，先交付第一个检查点（initial/partial：环境与版本、report.conclusion、ERROR / 主机 DRC、未决项、产物路径），之后才做更深的挖掘；更深的工作再小批量推进（每批最多 3 条发现）。已有报告可以重读，不必重跑；中断的运行按磁盘上已有的内容汇总为 partial。首检查点的顺序和全局重算去重仍然是流程约束，不是运行时闸门 —— 见 docs/review-sop.md §3.0a。这里不声称工具会自动强制执行任何一条。

架构与路线图

三层，全在你自己的机器上 —— 不经过云端：

AI assistant
│ calls short commands (CLI / skill / dsh plugin)
▼
offline engine parse · review rules · drawing compiler · change plans │ loopback only ▼ daemon + editor extension reads design data; writes go preview → approve → readback ▼ EasyEDA Pro (today) · KiCad (planned)

常设规则：检查和交付校验放在工具里；还没有运行时闸门的编排约束，在 SOP 里就照实说明；每条结论都带证据；写入走预览 → 授权 → 回读；超时或断连时先回读，绝不盲目重试。

| 阶段 | 状态 |
| 原理图评审（规则族 + 数据手册闸 + 评测框架） | 可用，维护中 |
| 评审到本地编辑（预览 / 授权 / 回读 / 复审） | 可用 |
| 绘图编译器（分压 / RC / LDO / IC 外围 / 电源入口） | 模块和多模块页面已进入编辑器；反激（UC3845）按锁定布局落到页面上，带电源轨/地标志，lint 干净；自由自动布局仍低于我们要求的标准 |
| PCB 评审（DRC 收敛 → 逐模块布局 → 器件检查） | 阶段 A–D 已完成（环路/回流路径、电源、MCU、FOC 规则包）—— 阶段 E（器件检查 + 报告）未开始；路线图在 tasks/122-pcb-review-roadmap.md |
| 完整原理图捕获 → PCB 生成 → SPICE 仿真 | 按此顺序 |
| KiCad 平台 | 计划中 |

一句话说明评审规则怎么打分：带标注的评测集签名后分成调参堆和验收堆，框架的设计保证验收堆不会泄漏进分数 —— --split 默认 dev，留出记录不进任何分母。有两个调参常量早于这套切分纪律；它们的注释写明了各自的证据板，tests/test_doc_claims.py 负责让这段话保持诚实。细节见 outputs/017_generalization.md。

安装与支持的环境

Releases 里有三个产物：

| 文件 | 适用对象 |
| boardwise-windows-x.x.x.exe | 不想装 Python 的人：单文件命令行，内置元件库 |
| boardwise-connector-x.x.x.eext | 所有人：导入 EasyEDA 的扩展 |
| boardwise-dsh-x.x.x.tgz | DeepSeek 用户：dsh 插件，可选 |

环境：Windows。Python ≥ 3.10（仅源码安装；不支持 3.9 及以下）。EasyEDA Pro 3.2.149 / 3.2.186 / V4.1.60 均已在真机验证；更早版本不保证可用。macOS/Linux 未测试——离线审查大概率能跑，桥接未验证。

最快路径：docs/install.md（中文，每一步都写明你应该看到什么）。急性子版：pip install . → 在编辑器里导入 .eext → boardwise doctor 全绿 → boardwise checkup。

把审查清单装进你的 AI：boardwise install-skill 会为 Kimi Code 和 Claude Code 安装（只装一边：--harness kimi 或 --harness claude；那里已有不同文件会备份为 SKILL.md.bak-<YYYYMMDD-HHMMSS>，绝不悄悄替换；同一天第二次安装会另起一个文件，不会顶掉第一个）。用别的智能体——Codex、Hermes 或任何其他？boardwise install-skill --agent 会打印一段短提示词，粘进你的 AI 即可；它还会把文件放到该 AI 查找技能的位置，这一点它比我们清楚。如果你的 AI 正在本仓库的克隆里工作，AGENTS.md 已经指向清单——无需安装。

常见错误与说明

- 什么都连不上——十有八九是三种情况之一：守护进程没跑、扩展的外部交互权限没授予、扩展从未激活。扩展的 About… 菜单会告诉你属于哪种。守护进程会自己照顾自己：任何需要桥接的命令发现它不在，就会启动一个并等待（它写的日志在 ${BOARDWISE_HOME:-~/.boardwise}/log/daemon-<date>.log，打印的失败信息里会点名这个文件）。如果还是起不来，在前台运行 boardwise bridge start，读它说了什么；BOARDWISE_NO_AUTO_DAEMON=1 会关掉自动启动，适合自己管理守护进程的环境。
- 开了好几个项目窗口——指定一个：--project <name>。它拒绝猜。
- 加密的 .epro2 导出——读不了；关掉加密重新导出。
- .eprj2 文件里没有图纸——它只是项目外壳。通过桥接读实时状态，或导出 .epro2 备份。
- 退出码 3 不是「板子干净」——它表示在线状态无法陈述。没能跑的部分标为 {checked: false}，不带计数。
- 它动你的图纸之前总会先预览。 别习惯性跳过确认——你说「是」之后的回读才是重点，不是走过场。
- 在 3.2.186 上，画布截图返回的是缓存帧——需要真实截图时，请用系统自带的截图工具。

致谢

很高兴这些项目存在：

- easyeda-agent
（zhoushoujianwork）——感谢它在细节上给我们的思路和启发。正是它持续推进，让我们绕开了坑，更快、更高效地达成自己的目标。
- @jlceda/pro-api-types——连接器所依赖的官方 API 类型定义。
- EasyEDA 团队——向社区开放真实的扩展 API，才让这一切成为可能。谢谢。

许可证

MIT

硬件工程师的 Agent Harness。

让 AI 助手（Claude Code、DeepSeek、Kimi Code……哪个都行）真正读懂你的原理图——器件、网络、引脚，不是截图——然后替你干活：审板子、标问题、按你的授权改图、导出制板文件。目前吃透的是立创 EDA 专业版，KiCad 是下一个平台，架构从一开始就按多平台设计。

它能做什么

审板子。 编辑器开着，一条命令：

boardwise checkup

输出一份报告：ERC/DRC、23 条设计规则、哪些器件还缺数据手册、每条问题各自指着具体的器件、引脚和网络；顺手把问题标记在画布上。它在真板子上抓到过设计者自己没注意到的问题——比如一个该做偏置而没做的电流采样电路。这类问题不是查规则书能查出来的，得先理解整个架构自不自洽。
有些电源网的电压只在你脑子里——intent audit 会把这些网列出来问一次，答案用 intent set-rail 写进设计意图契约，以后不再问。PCB 审查已落地的阶段也在真板子上抓到过真缺陷：一块四层 FOC 驱动板上，电机驱动器的散热焊盘铺铜成了孤岛。

改图。 发现问题后，它给修改预览，你点头它才动，动完自己回读、再跑一遍审查确认问题真的消失。已经支持的改法：改器件值、补一颗缺失的器件、修单个引脚连接、插入 RC/分压子电路、局部移动一个功能块。

导出。 一条 export-fab 同时出 Gerber、坐标文件和 BOM 三样。
（网表没有单独的导出命令；它在内部读取供审查，不落文件。）

画图。 你写电路意图——分压、RC 低通、LDO，器件、参数、哪个脚接哪个网——画法编译器负责把它变成一张能给人看的图：器件怎么摆、线怎么走、字放哪不压线。接法错、空间不够、和你的锁定冲突，它宁可拒绝也不交出一张烂图。离线出图之外，它已经能直接落进开着的编辑器——放件、拉线前先回读引脚、保存、再出一张渲染图。多个模块能组合进同一页：页上已有的图元自动变成禁布区、你锁定的位置被尊重、每条电源轨都有旗标，一条 draw discard 能把落好的整页撤下来。

几件新东西值得知道：

- 离线几何渲染——checkup --file 给每块板出 canvas-<board>.svg（顶/底两个视窗、finding 高亮）；它是按归档几何画出来的，不是截图。
- parts accept-unknown——工程师当面记下「这颗器件的未知我接受」，数据手册闸不再欠它；它不是审过，结论里照样数着这些被接受的器件。
- KiCad 裸网序号——没有名字的 (net 3) 照读（记成 net#3），不再因为一块板网名全丢就整盘读不出来。
- 分阶段、可中断的审查——一次 checkup 之后，先把首轮检查点（initial/partial：环境与版本、report.conclusion、ERROR / 宿主 DRC、待确认项、产物位置）交付出去，再分批深挖；每批最多 3 条 finding。已有报告可以复读而不必重跑，中止的 run 基于已在盘上的产物整理成 partial。首轮顺序与「全局重算去重」目前仍是 流程约束，不是运行时硬闸——见 docs/review-sop.md §3.0a。这里没有一句说工具会自动执行它。

架构和规划

三层，全跑在你自己电脑上，不经过任何云端：

AI 助手 │ 调很短的命令（CLI / skill / dsh 插件） ▼ 离线引擎 解析工程文件 · 审查规则 · 画法编译 · 修改计划 │ 本机回环 ▼ daemon + 编辑器扩展 读工程数据，写之前先预览、你授权、它回读 ▼ 立创 EDA 专业版（现在） · KiCad（规划）

规矩就几条：检查与交付校验住在工具里；尚未形成硬闸的编排约束在 SOP 里明确披露，不当成工具已自动执行；每个结论带证据；写操作一律预览 → 授权 → 回读；超时断连先读回，绝不盲目重试。

路线图：

| 阶段 | 状态 |
| 原理图审查（规则族 + 数据手册闸 + 评测体系） | 可用，维护中 |
| 审查到局部修改（预览/授权/回读/复查） | 可用 |
| 画法编译器（分压/RC/LDO/IC 外围/电源入口） | 单模块与多模块整页均已能落进编辑器；反激（UC3845）带锁定落点+电源/地旗标已能落页且 lint 零错误；自由自动摆放目前达不到我们要求的及格线 |
| PCB 审查（DRC 闭环 → 按模块布局 → 器件检查） | A–D 阶段完成（环路/回流路径、电源、MCU、FOC 规则包），E 阶段（器件检查+报告整合）未开——路线图见 tasks/122-pcb-review-roadmap.md |
| 完整原理图绘制 → PCB 生成 → SPICE 仿真 | 按序推进 |
| KiCad 平台 | 规划中 |

审查规则的评测方式说一句人话：我们有一套签名标注过的评测集，分成调参用和验收用两摞；harness 在结构上堵死验收摞混进分数——--split 默认 dev，验收摞不进任何分母。有两条调参常量先于分堆制度诞生，它们的注释里写明了取证板，tests/test_doc_claims.py 盯着这段话不许它过期。
细节在 outputs/017_generalization.md。

安装包和环境支持

Releases 里三样：

| 文件 | 给谁 |
| boardwise-windows-x.x.x.exe | 不想装 Python 的人：单文件命令行，器件库已内嵌 |
| boardwise-connector-x.x.x.eext | 所有人：立创 EDA 里导入的扩展 |
| boardwise-dsh-x.x.x.tgz | DeepSeek 用户：dsh 插件，可选 |

环境：Windows；Python ≥ 3.10（仅开发/源码安装需要，3.10 以下不支持）；立创 EDA 专业版 3.2.149 / 3.2.186 / V4.1.60 都真机验证过，更低版本不保证。macOS/Linux 没测过——理论上离线审查能跑，桥没验证。

最快的路：docs/install.md（给朋友看的版本，全程中文，每步写了 "应该看到什么"）。熟手：pip install . → 编辑器导入 .eext → boardwise doctor 全绿 → boardwise checkup。

把审查清单装进你的 AI：boardwise install-skill 给 Kimi Code 和 Claude Code 装上（只装一侧加 --harness kimi 或 --harness claude；目标位置已有别的版本会先备份成 SKILL.md.bak-<年月日-时分秒>，不会静默覆盖；同一天装两次是两个备份文件，第二个不覆盖第一个）。用的不是这两个智能体——Codex、Hermes 之类——跑 boardwise install-skill --agent：它打印一段引导指令，粘给你在用的 AI，放哪儿由它自己定，它比我们清楚。AI 就在本仓库 clone 里干活的话，根目录 AGENTS.md 已经指到了清单，不用装。

常见错误和注意事项

- 连不上，九成是三件事之一：daemon 没起、扩展的"外部交互"权限没给、扩展没激活。扩展菜单里的 About… 会直接告诉你卡在哪步。daemon 这一条现在会自己解决：任何需要桥的命令发现它不在，自己把它拉起来并等它就绪（它的输出写在
${BOARDWISE_HOME:-~/.boardwise}/log/daemon-<日期>.log，拉起失败时报错会点名这个文件）。
还是没起来就跑 boardwise bridge start（前台运行，原因直接打在窗口里）；自己管 daemon 的部署（计划任务/服务）用 BOARDWISE_NO_AUTO_DAEMON=1 关掉自动拉起。
- 开了好几个工程窗口：命令要指名，--project <名字>，否则它拒绝猜。
- .epro2 导出时勾了加密：读不了，重新导一次别勾加密。
- .eprj2 单文件里没有图纸：那只是工程壳，图纸要么在线走桥读，要么导出 .epro2 备份。
- 退出码 3 不是"板子干净"：是说不清——在线状态读不出来（daemon 没起、扩展没连上），或者 completion.verdict 是 incomplete（没读到模型 / 有器件缺手册未审 / 骨架没生成 / 覆盖有缺口）。review --live 拿到了模型、但模型是空的（0 器件 0 网络）也算（075）——它与"根本没拿到模型"是两句话，两句都不许读成通过。审查没跑成的部分报告里会写 {checked: false}，不带计数。CI 里别把 3 当通过（073 起 review / checkup 都这样；有 ERROR 仍是 1，complete-with-open-items 仍是 0）。
- 它要改你的图之前一定会先给预览，别图快跳确认——确认完它自己还会回读验证，这一步省不掉也不该省。
- 画布截图在 3.2.186 上返回的是缓存帧，要真实截图请用系统截图工具。

致谢

站在这些项目的肩膀上，我们很庆幸它们存在：

- easyeda-agent（zhoushoujianwork）——感谢 EasyEDA-Agent 提供的一些思路和细节上的灵感。正是他们的不断前进，才让我们少踩了坑，能够以更高效、更快速的方式接近自己的目标。
- @jlceda/pro-api-types——官方 API 类型定义，connector 开发站在它上面。
- 立创 EDA 团队——愿意把扩展接口真正开放给社区，这个项目才有机会存在。谢谢。

License

MIT