如何实现PCB版本管理与可视化Diff:Backplane硬件设计评审完整指南
如何实现PCB版本管理与可视化Diff:Backplane硬件设计评审完整指南
Backplane 是一款面向 AI 硬件开发的开源工作空间,内置 PCB 版本管理与可视化 Diff 对比能力:像 AllSpice 一样对 KiCad 设计做红黄绿三色变更高亮,再配合设计历史时间线、BOM 差异、设计检查与评审评论,帮助工程师快速完成硬件设计评审。
为什么硬件评审需要专门的 Diff 工具
软件工程师早已习惯用 git diff 审查代码,但硬件设计的"代码"是原理图与 PCB 文件(.kicad_sch、.kicad_pcb)——纯文本 Diff 既难读,也无法回答关键问题:
- 这次改版加/删了哪些走线和过孔?
- 某个铺铜变化会不会影响 DRC?
- 器件的阻值、封装、MPN 换成了什么?
AllSpice 常被称为"硬件界的 GitHub",但它依赖云端服务。Backplane 的思路是在本地实现同款能力,并且每一步 AI Agent 的修改都可追溯、可对比。官方对 AllSpice 各功能的本地化清单见 docs/design-review.md。
一键对比任意两个版本:红黄绿三色高亮
Backplane 的 Diff 视图是对象级的:在任意两个版本之间对比时,被删除的对象标红、被修改的标黄、新增的标绿,其余内容自动变暗,让你一眼锁定变化。
几个实用的操作细节:
- 对比任意引用:对比菜单里列出分支、提交、标签与分支点(
base),输入框还支持直接键入任意 commit、分支或 tag,等价于 AllSpice 的"任意两个提交对比"; - 按图层过滤:可以只对比指定图层,配合每块板、每张原理图下方的操作条使用;
- Old / Diff / New 三视图:同一画布可在"旧版、差异、新版"之间切换,选中某张原理图(sheet)后对比会保持在该页进行;
- 全客户端一致:桌面窗口、Web、iOS、Android 四个端行为相同。
Diff 的标记逻辑实现在 src/core/hist.bend(变更对象被绘制到专用图层并高亮),文本级 Diff 解析在 src/core/diff.bend,git 操作在 src/server/git.bend,对应测试 test/cmp_test.bend 与 test/hist_test.bend。
设计历史时间线:回放 AI 的每一步修改
如果你让 Agent 迭代改板(例如"把 +5V 走线加宽到 0.8mm 并跑 DRC"),每次工具调用后 Backplane 都会给 KiCad 文件打一个快照(step)。板卡视图底部会出现一条时间线:
- 点击时间线上的任意刻度,就能回放 AI 在该步之前的板卡状态;
- 再点 Compare,直接打开"这一步改动前后"的可视化 Diff;
- 每个 step 还保留了 Agent 当时的说明文字,评审时可以对照"它为什么这么改"。
Review 标签页:BOM 差异、设计检查与发布门禁
除了图形 Diff,评审闭环还需要清单与数据。Backplane 的 Review 标签页提供四个页面:
| 页面 | 作用 |
|---|---|
| BOM | 生成工作副本的 BOM,或对比两个版本间的器件变更(谁换了值、封装、MPN),输出 CSV 与 Markdown 表格 |
| Checks | 对 kicad-cli 的 ERC/DRC JSON 结果、BOM 规则、.backplane/checklist.md 检查清单逐项打勾,汇总为门禁(gate) |
| Comments | 评审者或 Agent 可在板/图的具体位置(文件、commit、图层、mm 坐标)钉上评论,回复、解决、重开 |
| Release | 打 tag 前先用 Checks 做门禁,然后从干净检出导出 Gerber、钻孔、CPL、BOM、PDF 与 STEP,存入 .backplane/releases/<tag>/ |
相关纯逻辑模块:src/core/bom.bend(BOM 与 BOM diff)、src/core/checks.bend(设计检查)、src/core/release.bend(发布)、src/core/review.bend(评论锚点),端到端服务在 src/server/review.bend。
安装与快速上手
-
克隆或安装 Backplane:
git clone https://gitcode.com/gh_mirrors/bac/Backplane仓库
README.md的 Install 一节提供官方一键安装脚本,安装后运行backplane启动; -
打开一个 KiCad 项目,让 Agent 修改板卡(或直接自己编辑后提交);
-
在板卡/原理图视图底部打开 Compare,选择分支、commit 或 tag 作为对比版本;
-
用红/黄/绿高亮定位改动,需要时切换到 Old / Diff / New 视图;
-
在 Review 标签页跑 BOM 差异与 Checks,确认无误后再走 Release 发布。
适合谁用
- 需要评审 AI Agent 改板结果的硬件工程师——每步都可回放、可对比;
- 希望本地替代 AllSpice 类云端硬件评审服务的团队——数据不出本机;
- 多人协作中想把DRC 警告、BOM 变更、检查清单写进 PR 的维护者。
更多功能规划与实现细节,可阅读 docs/design-review.md 与 docs/git.md。



