前言¶

在 DSH 會話裏，Agent 通常已經能讀取文章並給出理解。但有些工作不只要“看完”，還要把內容整理成可繼續改的圖：補充節點、調整連線、按報告或架構說明重新排版。dsh-diagram 面向這個需求：它把當前 Agent Session 中的文章內容轉換爲 Excalidraw 畫布，之後你可以在 DSH 的 Canvas 中繼續編輯、自動保存並導出。

這是什麼¶

dsh-diagram 是由 hanzhangzzz 維護的 DSH 插件。當前資料給出的描述是：把 DeepSeek Harness 中的文章轉成可編輯的 Excalidraw 畫布。

它運行在 web profile，內置的編輯器是 Excalidraw 0.18.1，數據存儲在插件擁有的 DSH storage-domain sidecar 中。插件不負責抓取文章，也不向任意網站注入 UI；文章獲取仍由 DSH 會話、文件工具或 Web 工具完成。

核心功能¶

下面介紹它與會話、編輯和導出相關的幾個入口。

圖創建與讀取¶

• diagram_create：根據一份緊湊的語義規格，爲當前 Agent Session 創建圖。
• diagram_read：把當前可編輯場景的有界摘要讀入會話記錄，便於 Agent 在你手動修改後繼續工作。

路由與預覽¶

• canvas-diagram 是內置的雙語路由入口，可以從 composer 或菜單中選擇，也能匹配通用的畫圖請求。
• diagram_create 完成後，會話中會出現內聯預覽卡片，把當前圖內容渲染爲靜態 SVG。

編輯、保存與導出¶

• Canvas 標籤頁在被選中時纔打開 Excalidraw 編輯器，避免進入普通聊天啓動路徑。
• 圖列表用於在不同圖之間切換；在窄屏上會成爲選擇器。
• 自動保存提供防抖的持久寫入，並帶 revision 衝突保護與標籤頁本地 pending-draft 恢復。
• 導出可下載 .excalidraw、SVG 或 PNG 文件。

支持的圖類型¶

資料中列出的類型包括：報告看板、流程圖、架構圖、時間線、層級結構、對比圖和關係圖。

安裝與啓用¶

先確認環境滿足以下要求：

• DeepSeek Harness：0.1.0-rc.6
• Node.js：^22.19.0 或 >=24.0.0
• pnpm：>=10 且在 PATH 中
• DSH Web：綁定到 127.0.0.1

資料給出的安裝命令如下：

npx -y @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add dsh-diagram@latest

這條命令會把插件添加到 web profile。添加或更新插件後，如果 DSH Web 已在運行，需要重啓 DSH Web。

安裝產物是預構建的 npm 包，或帶 SHA-256 校驗值的 GitHub Release tarball；npm 包沒有 install 生命週期腳本。刪除插件 bundle 不會刪除已保存的圖 sidecar 數據。

典型用法¶

下面是一個可復現的使用路徑：

1、打開一個已經包含文章的 DSH 會話。

2、在 composer 中輸入 /，選擇 canvas-diagram。也可以使用自然語言請求，例如：

把這篇文章畫成架構圖

3、如果想讓 Agent 明確執行創建動作，可以使用顯式提示：

Create one clear diagram for this article. Choose the most suitable diagram type, call diagram_create, and keep the title and node labels concise.

4、工具完成後，選擇 Canvas 標籤頁。

5、在畫布中編輯圖，然後導出結果；如果希望 Agent 基於你修改後的場景繼續工作，可以要求它調用 diagram_read。

適用場景與注意¶

適合在 DSH 會話中處理文章、報告、架構說明等長內容，並且希望把輸出保留爲可編輯畫布的人。

安裝和使用前需要注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 圖數據綁定到其 Session id 和 {createdAt, cwd} 生命週期指紋；複用 Session id 不能讀取舊數據。
• Session fork 和 Session export 不會複製或包含圖 sidecar 數據。
• 編輯器資產和字體由 bundle 自託管，畫布不依賴外部 CDN。
• 社區插件目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不要把它理解成官方應用商店。

結尾¶

經過上面的步驟，dsh-diagram 可以把 DSH 會話中的文章理解轉成一張可繼續維護的 Excalidraw 畫布：創建、預覽、編輯、保存和導出都在同一個會話工作流中完成。

項目鏈接：

• GitHub：https://github.com/hanzhangzzz/dsh-diagram
• 目錄頁（資料中給出，使用前請確認站點可用）：https://www.skillhub.cn/plugins/hanzhangzzz/dsh-diagram