前言¶
用智能體梳理流程或畫結構圖時，常見做法是：在聊天裏口述步驟，再另開繪圖工具重畫一遍，或在截圖與文字之間來回粘貼。圖形往往是靜態圖片，改一處就要整圖重做。
DeepSeek Harness（DSH）支持通過客戶端插件擴展界面與能力。Fantasy421 維護的 dsh-whiteboard 在會話右側欄嵌入基於 Excalidraw 的可編輯白板：AI 可通過工具新建節點、連線並局部修改；你仍可用鼠標拖動、改字、換線型。生成的是矢量圖形對象，不是一張不可編輯的位圖。
下面介紹插件定位、能力與安裝方式，並給出可復現的聊天提示示例。
這是什麼¶
- 名稱：dsh-whiteboard（倉庫 Fantasy421/dsh-whiteboard）
- 維護者：Fantasy421
- 分類：客戶端插件（
dsh.client注入側欄等 UI 槽位） - 當前版本：0.3.0（README 寫明基於 DSH
0.2.1-rc.3公開插件接口開發） - 許可證：MIT
一句話：Human + AI collaborative Excalidraw whiteboard for DeepSeek Harness——人與 AI 共用同一張本機白板，在聊天旁邊聊邊畫。
社區目錄頁：skillhub.cn/plugins/Fantasy421/dsh-whiteboard（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。
核心功能¶
兩種創作方式¶
- 自然語言搭框架：在原聊天框描述想法，AI 可新建節點、補充文字、連接步驟，或先讀取已有內容再局部修改。
- 鼠標打磨細節：AI 生成的節點與連線可選中、拖動、編輯；人機可接力（你先畫起點，AI 再補；或 AI 出草圖你再排版）。
能力與限制（據 README）¶
| 能力 | 說明 |
|---|---|
| 閱讀模式 | 從「更多」進入；點節點高亮其一跳相連的節點與連線；點空白或 Esc 清除高亮。 |
| 多白板 | 按主題新建、重命名、搜索、切換；同一對話可多張圖。 |
| 側欄與大屏 | 聊天旁隨手畫；複雜內容可切大屏；次要操作默認收起。 |
| 曲線與折線 | 原生可編輯連線；AI 可指定線型；選中連線可在「更多」中轉換。 |
| 保存與導出 | 按會話與白板本地保存；可導出 PNG、SVG、.excalidraw。 |
| 增量修改 | 不必每次重畫整圖；同對象衝突時暫停同步並保留草稿，避免靜默覆蓋。 |
使用說明中的邊界：白板數據保存在本機；「協作」指人與 AI 共用白板，不是多人遠程實時協作；目前不支持網頁嵌入；撤銷限於本次編輯器打開期間；字體加載不保證完全離線。草稿恢復、軟刪除與容量限制見倉庫內 docs/data-and-safety.md。
AI 側涉及白板時有四個工具，多白板場景應明確 boardId 與版本；詳見 docs/ai-tools.md。
安裝與啓用¶
安裝或升級前，插件隨當前 DSH 進程與界面運行，建議先瀏覽倉庫源碼與 MIT 許可證，再決定是否安裝。
在 DSH 插件管理器中粘貼完整 Release 地址（勿只填 dsh-whiteboard——npm 上同名 0.0.1 爲其他作者的佔位包）：
https://github.com/Fantasy421/dsh-whiteboard/releases/download/v0.3.0/dsh-whiteboard-0.3.0.tgz
或使用 CLI：
dsh plugin --profile desktop add https://github.com/Fantasy421/dsh-whiteboard/releases/download/v0.3.0/dsh-whiteboard-0.3.0.tgz
安裝或升級後保存工作並重啓 DSH，在會話右側欄打開「協作白板」。更完整的安裝、升級與故障排查見 docs/installation.md。
典型用法¶
快速開始（四步）¶
- 從右側欄進入白板，直接繪圖或讓 AI 從空白開始。
- 繼續用原聊天框描述節點、關係和佈局。
- 拖動節點、改字、調整線型；頂部白板名稱可管理多張白板。
- 在「更多」中進入閱讀模式，或導出圖片與源文件。
可試用的提示詞（摘自 README）¶
整理流程
在當前白板畫一個發佈流程：準備 → 檢查 → 發佈。檢查失敗時回到準備，並給分支加上說明。
單獨開一張圖
在當前會話新建一張「系統架構」白板，畫出界面、服務和存儲的關係，不要修改其他白板。
只改局部
先讀取我指定的白板，把服務到存儲的連線改成折線，保留其他節點、文字和佈局。
倉庫 examples/ 提供流程圖、系統架構、人機接力起點等 .excalidraw 及增量操作 JSON，見 examples/README.md。
適用場景與注意¶
適合誰
- 需要在 DSH 對話旁用流程圖、架構圖、待辦結構表達思路，且希望 AI 參與建圖與增量改圖的開發者。
- 已使用 DSH
0.2.1-rc.3系客戶端插件接口、並願從 Release 包安裝預構建產物的用戶。
注意
- 必須使用上述 v0.3.0 Release
.tgz，不要用倉庫源碼 ZIP 代替預構建包。 - 數據本地存儲；無多人實時協同與網頁嵌入。
- 插件以當前 DSH 客戶端權限運行，安裝前請自行審閱源碼與第三方聲明（
THIRD_PARTY_NOTICES.md）。
結尾¶
dsh-whiteboard 把 Excalidraw 放進 DSH 右側欄，讓人與 AI 在同一張可編輯白板上接力：聊天裏搭結構，畫布裏調細節，並可分主題管理多張圖與導出源文件。
