文档

Breadboard Studio 是一个开源的面包板与洞洞板布局工具：在浏览器里拼面包板或洞洞板、摆元件、自动接线，再按图搭建你的电路。

下面这些文档说明它怎么用、文件格式长什么样、元件怎么建模，以及怎么让 Agent 通过 CLI 参与搭建。

• 面包板与洞洞板布局工具

  在浏览器里拼面包板或洞洞板、摆元件、自动接线，再按图搭建电路。支持 400/830 孔面包板、5×7 与 7×9 cm 洞洞板、ESP32-S3，以及导通向导与 SVG/PNG 导出。

• Agent 使用指南：用 CLI 和 JSON 驱动布局

  不依赖浏览器和截图定位，用命令行与 JSON 设计文件创建工程、放置元件、自动排线和校验接线。所有命令支持 --json 稳定输出，便于程序解析。

• 元件目录与建模指南

  如何为面包板与洞洞板工具新增元件定义：外形尺寸、引脚坐标、安装方式、电气属性、正反面绘图，以及 geometry_status / electrical_status 证据等级。

• 设计文件格式 .breadboard.json

  .breadboard.json（schema 1.1）字段说明：板件、元件、导线、导通网络与校验，全部长度为整数微米，JSON Schema 2020-12 定义可直接输出。

• 架构与建模约定

  Breadboard Studio 的实现约定：孔位与导通模型、几何引擎、布局与布线的职责边界，以及面包板、洞洞板共用同一套内核的方式。

• 可编程仿真器设计方案

  在隔离沙箱里真实执行主控程序：驱动板载 RGB、打印串口、经真实 I²C 总线写入 OLED，并按虚拟时间暂停与单步。

• 定义证据与实测协作

  元件定义的证据等级与复核流程：documented、measured、verified 各要求什么，以及如何提交实测报告而不必写代码。

打开编辑器 · GitHub 源码