前言¶

在 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