前言¶

在 DeepSeek Harness（DSH）里接硬件设计，常见困境是：模型只能看截图或零散描述，无法对准具体元件、引脚和网络；即便给出修改建议，也很难在本地编辑器里「预览 → 确认 → 回读验证」闭环。boardwise 把审查规则、几何解析和与 EasyEDA Pro 的桥接放在本机离线引擎里，通过短命令（CLI、skill 或 DSH 插件）供智能体调用，结论带证据，写入必须经过授权与读回。

下面介绍它是什么、能做什么、如何安装与典型用法。

这是什么¶

boardwise 是面向硬件工程师的智能体 harness：让 Claude Code、DeepSeek、Kimi Code 等助手直接读取原理图结构（元件、网络、引脚，而非截图），完成审查、标注问题、在征得同意后改图，以及导出 fab 包。当前深度支持 EasyEDA Pro；架构从设计上支持多平台，KiCad 在路线图中。

• 维护者：XiangyuYue
• 社区目录：skillhub.cn/plugins/XiangyuYue/boardwise
• 源码：github.com/XiangyuYue/boardwise
• 分类：模型推理（目录归类）
• DSH 插件包：boardwise-dsh（package.json 版本 0.6.0，MIT 许可证），说明为面向 DeepSeek Harness 的薄 CLI/JSON 适配层，判断逻辑仍在 Python 引擎中。

DSH 生态的理念是「一切皆插件」；社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。

架构：三层都在本机¶

数据不经过云端，结构如下：

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)

约定包括：检查与交付验证在工具内完成；每条结论附带证据；写入流程为预览 → 授权 → 读回；超时或断连时先读回，不盲目重试。

核心功能（已文档化能力）¶

审查（Review）¶

编辑器打开后，一条命令即可跑审查：

boardwise checkup

报告覆盖 ERC/DRC、23 条设计规则、缺 datasheet 的器件等；每条发现指向具体元件、引脚和网络，并在画布上标出。另有 intent audit：对仅存在于工程师脑海中的 rail 电压，intent set-rail 写入设计意图契约后不再重复询问。PCB 审查分阶段推进，已在真实板上发现布局类问题（README 以 motor driver exposed pad 等为例说明类型，不展开个案数据）。

较新的能力包括：

• 离线几何渲染：checkup --file 从归档几何绘制 canvas-<board>.svg（双视图、高亮发现项），非截图。
• parts accept-unknown：工程师登记某器件未知项可接受，datasheet 门禁不再「欠账」，不等于通过，结论仍统计已接受器件。
• 分阶段可中断审查：一次 checkup 先交付首个检查点（环境、版本、report.conclusion、ERROR / host DRC、未完成项、产物路径），再小批量深入（每批最多 3 条发现）；已有报告可读盘复用，中断运行以磁盘已有内容汇总为 partial。

编辑（Edit）¶

发现问题后可看变更预览；未经批准不会动图；批准后读回并重新审查以确认问题消失。当前编辑类型包括：改元件值、补器件、修单 pin 连接、插入 RC/分压子电路、移动功能块等。

导出（Export）¶

boardwise export-fab

一次写出 fab 包：Gerber、贴装与 BOM。README 明确：没有 netlist 导出命令；netlist 在内部用于审查，不写成文件。

绘制（Draw）¶

用自然语言描述电路意图（分压、RC 低通、LDO 等），drawing compiler 生成可读原理图页；连接错误、空间不足或与锁定布局冲突时会拒绝而非交出坏图。可离线编译，也可落入已打开的编辑器（布局、拉线前 pin 读回、保存与渲染）。多模块可合页；draw discard 可撤销已落入的页。

安装与启用¶

官方在 Releases 提供三类产物（版本号以 Release 页为准）：

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

最快路径见仓库 docs/install.md（中文逐步说明）。若赶时间，可按 README 摘要依次做：

1. 在源码目录按文档执行 pip install .
2. 在编辑器中导入 .eext 扩展
3. 运行 boardwise doctor，直至全部通过
4. 运行 boardwise checkup 验证审查链路

把审查清单装进 AI 助手：

boardwise install-skill

可为 Kimi Code 或 Claude Code 单侧安装（--harness kimi 或 --harness claude）；若目标文件已存在会备份为 SKILL.md.bak-<时间戳>，同日二次安装会另存新文件而非静默覆盖。其他 agent 可用 boardwise install-skill --agent 打印短 prompt 并按其 skill 路径安装。

DSH 用户从 Release 取得 boardwise-dsh-x.x.x.tgz 后，按 docs/install.md 中与 DSH 相关的步骤启用；勿凭插件名臆造 dsh plugin add 命令——以 install 文档为准。

典型用法¶

连通性自检（桥接异常时 README 常见三类原因：daemon 未起、扩展未授予 external interaction、扩展未激活；扩展 About 菜单可查看状态）：

boardwise doctor

打开工程后的设计审查：

boardwise checkup

离线对归档板文件出 SVG 报告图：

boardwise checkup --file

导出制造文件：

boardwise export-fab

智能体在 DSH 中调用的是插件暴露的薄适配命令，具体子命令与 JSON 字段以仓库 dsh-plugin 与 cordis patch 为准；业务判定仍在 Python offline engine。

适用场景与注意¶

适合：已在 Windows + EasyEDA Pro 上画板，希望 AI 基于真实 netlist/几何做 schematic/PCB 审查、带画布标记的问题定位，以及 preview → approve → readback 的本地修改；需要一次性 fab bundle 导出；或配合 install-skill 把 SOP 交给 Claude / Kimi / DeepSeek 等 harness。

路线现状（README 表格摘要）：原理图审查、review-to-edit、drawing compiler 多模块落页等已可用或维护中；PCB 审查 A–D 阶段已完成，E（device checks + report）未启动；KiCad 平台为 planned；完整 capture → PCB → SPICE 按该顺序在 roadmap 中。

安全与权限：DSH 插件与当前 dsh 进程同权限运行。安装 boardwise-dsh 或从源码 pip install 前，应自行阅读源码与 MIT 许可证，确认 daemon、扩展与本地写盘行为符合你的环境策略。插件不替代人工 sign-off；所有写入以你批准为准。

结尾¶

boardwise 把「能读原理图、能审查、能改、能导出」收进本机三层架构，并通过 DSH 插件包把同一套能力接到 DeepSeek Harness。若要选版与逐步截图级说明，以仓库中文安装文档为准。

• 目录页：https://www.skillhub.cn/plugins/XiangyuYue/boardwise
• GitHub：https://github.com/XiangyuYue/boardwise