前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」，将 AI 能力以插件形式嵌入到本地工作流中。对于智能体开发者而言，让模型真正「看见」并理解工程数据、而非仅依赖截图，是提升落地方案可信度的关键。boardwise-dsh（0.1.3）正是为此构建的 AI harness：它面向硬件工程师，将模型与本地设计工具桥接，让 Claude Code、DeepSeek、Kimi Code 等助手以命令方式完成原理图/PCB 审查、变更预览、导出等操作。
是什么¶
- 名称：boardwise-dsh（DSH 插件，0.1.3）
- 维护者：xianyuyijinban
- 平台：EasyEDA Pro（3.2.149 / 3.2.186 / V4.1.60 已验证；macOS/Linux 未测试）
- 运行环境：Windows；Python ≥ 3.10（仅源码安装，3.9 及以下不支持）
- 许可证：MIT
- 定位：AI 辅助硬件设计审查与编辑工具，通过离线引擎 + daemon + 编辑器扩展，将模型判断与本地设计数据闭环。
核心能力¶
1. 原理图与 PCB 审查¶
在编辑器打开工程后，执行：
boardwise checkup
系统会给出报告：ERC/DRC、23 条设计规则、缺少数据表的元器件，并将每个问题定位到具体元器件、引脚与网络，在画布上标记问题位置。典型场景如电流采样电路缺少偏置等架构性问题，单纯用规则匹配 netlist 难以发现。
对于只在设计者脑海中的电压轨，可用 intent audit 列出对应网络并确认一次，结果写入设计意图契约（intent set-rail），之后不再重复询问。
2. 审查到本地编辑¶
发现问题后，模型给出变更预览；只有在工程师确认后，编辑器才会实际执行变更。变更类型包括：修改元器件数值、添加缺失元器件、修复单引脚连接、插入 RC 分压/RC 低通子电路、移动功能模块等。变更完成后系统会读回并重新审查，确认问题是否消除。
3. 导出与绘图编译¶
- 导出制造套件：
boardwise export-fab可一次性输出 Gerber、贴片与 BOM（netlist 仅在内部读取，不作为文件导出）。 - 绘图编译：定义电路意图（分压、RC 低通、LDO 等）及引脚连接关系，编译器在本地生成可读的原理图页；若存在错误连接、空间不足或与已锁定布局冲突，会拒绝而非生成错误图纸。编译器支持将页面落地到编辑器，落地后可执行 placement、引脚读回、保存与渲染；
draw discard可将已落地的页面移除。
4. 离线几何渲染¶
使用 checkup --file，系统会从归档几何绘制各板 canvas-<board>.svg（两视图，高亮问题），而非截图。
5. 管理未明确参数的元器件¶
对于部分元器件的未知参数，工程师可执行 parts accept-unknown，将「可接受未知」记录在案；这不会使问题通过，仍然计入结论统计。
安装与启用¶
1. 准备环境¶
- 操作系统：Windows
- Python：≥ 3.10（仅源码安装，3.9 及以下不支持）
- EasyEDA Pro：3.2.149 / 3.2.186 / V4.1.60 已验证；更早版本无保证
2. 获取组件¶
在 GitHub Releases 页面下载对应平台与用途的文件：
| 文件 | 用途 |
|---|---|
boardwise-windows-x.x.x.exe |
无需 Python 的单文件 CLI，元器件库已内置 |
boardwise-connector-x.x.x.eext |
导入 EasyEDA Pro 的扩展文件 |
boardwise-dsh-x.x.x.tgz |
DeepSeek 用户可选的 DSH 插件包 |
3. 安装与启用¶
- 源码安装（推荐）：
pip install . - 导入扩展：在 EasyEDA Pro 中导入
boardwise-connector-x.x.x.eext - 检查健康状态：
boardwise doctor（确保所有检查为绿色） - 启动审查：
boardwise checkup
4. 获取审查清单到 AI¶
- 为 Kimi Code 安装：
boardwise install-skill --harness kimi - 为 Claude Code 安装：
boardwise install-skill --harness claude - 为其他智能体安装：
boardwise install-skill --agent（打印提示词并放置到技能目录）
典型用法¶
审查工程¶
boardwise checkup
查看报告与画布上的问题标记。
设置设计意图¶
boardwise intent set-rail 3V3 3.3V
后续 intent audit 不会再针对该网络询问。
落地编译页并确认¶
- 定义意图与参数；2. 编译生成页面；3. 在编辑器中执行 placement、引脚读回、保存与渲染；4. 如需移除，执行
draw discard。
导出制造套件¶
boardwise export-fab
适用场景与注意¶
- 适合：使用 EasyEDA Pro 的硬件工程师、希望让 AI 真正理解设计而非仅看截图的场景。
- 注意：插件以当前 DSH 进程的权限运行，安装前应查看源码与许可证（MIT），确认与自身工作流与安全策略兼容。
- 环境依赖：macOS/Linux 未测试，仅 Windows 经验证；Python ≥ 3.10 且仅支持源码安装。
总结¶
boardwise-dsh 将 AI 的逻辑判断与本地设计工具的能力结合，通过离线引擎、daemon 与编辑器扩展的分层架构，让 Claude Code、DeepSeek 等助手能够以命令方式完成从审查、编辑到导出的闭环工作。它不依赖云端，所有决策与证据均留在本地，适合需要在 DSH 生态中落地硬件设计审查能力的智能体开发者。
- 插件目录：https://www.skillhub.cn/plugins/xianyuyijinban/boardwise
- GitHub：https://github.com/xianyuyijinban/boardwise
