如何实现PCB版本管理与可视化Diff:Backplane硬件设计评审完整指南

原创2026-10-29 20:46:451,433 阅读

如何实现PCB版本管理与可视化Diff:Backplane硬件设计评审完整指南

Backplane 是一款面向 AI 硬件开发的开源工作空间,内置 PCB 版本管理与可视化 Diff 对比能力:像 AllSpice 一样对 KiCad 设计做红黄绿三色变更高亮,再配合设计历史时间线、BOM 差异、设计检查与评审评论,帮助工程师快速完成硬件设计评审。

Backplane 工作空间:AI 对话、3D 板卡视图与手机端 Diff 总览

为什么硬件评审需要专门的 Diff 工具

软件工程师早已习惯用 git diff 审查代码,但硬件设计的"代码"是原理图与 PCB 文件(.kicad_sch、.kicad_pcb)——纯文本 Diff 既难读,也无法回答关键问题:

  • 这次改版加/删了哪些走线和过孔?
  • 某个铺铜变化会不会影响 DRC?
  • 器件的阻值、封装、MPN 换成了什么?

AllSpice 常被称为"硬件界的 GitHub",但它依赖云端服务。Backplane 的思路是在本地实现同款能力,并且每一步 AI Agent 的修改都可追溯、可对比。官方对 AllSpice 各功能的本地化清单见 docs/design-review.md。

一键对比任意两个版本:红黄绿三色高亮

Backplane 的 Diff 视图是对象级的:在任意两个版本之间对比时,被删除的对象标红、被修改的标黄、新增的标绿,其余内容自动变暗,让你一眼锁定变化。

Backplane 的 PCB 可视化 Diff:底部 Old/Diff/New 切换条,Removed/Changed/Added 三色图例

几个实用的操作细节:

  • 对比任意引用:对比菜单里列出分支、提交、标签与分支点(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)。板卡视图底部会出现一条时间线:

Backplane 板卡视图:底部设计历史时间线,标注 Live - 4 steps,可逐步回放

  • 点击时间线上的任意刻度,就能回放 AI 在该步之前的板卡状态;
  • 再点 Compare,直接打开"这一步改动前后"的可视化 Diff;
  • 每个 step 还保留了 Agent 当时的说明文字,评审时可以对照"它为什么这么改"。

Review 标签页:BOM 差异、设计检查与发布门禁

除了图形 Diff,评审闭环还需要清单与数据。Backplane 的 Review 标签页提供四个页面:

Backplane Review 标签页:BOM/Checks/Comments/Release 四个页面,显示 ERC、DRC 通过项与 DRC 警告表格

页面 作用
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。

安装与快速上手

  1. 克隆或安装 Backplane:

    git clone https://gitcode.com/gh_mirrors/bac/Backplane
    

    仓库 README.md 的 Install 一节提供官方一键安装脚本,安装后运行 backplane 启动;

  2. 打开一个 KiCad 项目,让 Agent 修改板卡(或直接自己编辑后提交);

  3. 在板卡/原理图视图底部打开 Compare,选择分支、commit 或 tag 作为对比版本;

  4. 用红/黄/绿高亮定位改动,需要时切换到 Old / Diff / New 视图;

  5. 在 Review 标签页跑 BOM 差异与 Checks,确认无误后再走 Release 发布。

适合谁用

  • 需要评审 AI Agent 改板结果的硬件工程师——每步都可回放、可对比;
  • 希望本地替代 AllSpice 类云端硬件评审服务的团队——数据不出本机;
  • 多人协作中想把DRC 警告、BOM 变更、检查清单写进 PR 的维护者。

更多功能规划与实现细节,可阅读 docs/design-review.md 与 docs/git.md。

登录后查看全文
Backplane