前言¶
在 DeepSeek Harness (DSH) 的使用場景中，思維導圖通常需要手動繪製或與源文件分離。dsh-mindmap 插件將兩者合二爲一：Markdown 文件即思維導圖，聊天窗口即編輯器，AI 通過工具逐步修改 .md 文件，右側面板實時渲染導圖。插件處於 pre-1.0 階段，核心功能已覆蓋並通過測試。
核心功能¶
該插件通過四個核心工具 (mindmap_create / mindmap_open / mindmap_get / mindmap_update) 驅動工作流。
-
文件與根節點同步
Markdown 文件的根節點標題與文件名保持同步。當 AI 修改根節點名稱時，文件名也會隨之更新（需處理衝突）。 -
實時渲染與狀態恢復
插件使用零額外通道的實時渲染機制，基於會話快照 (mindmap_*工具結果) 更新視圖。它具備可靠的打開機制和可恢復的加載狀態，即使在結構指紋變化或路徑不匹配時也能恢復。 -
畫布與交互
- MarkGrove 風格映射：支持標題層級、嵌套列表、代碼塊以及段落作爲獨立節點。
- 操作：支持居中畫布、縮放（25%-300%）、平移、節點搜索與快速導航、摺疊子樹。
- 佈局：支持浮動面板（280px~80% 視口）或原生側邊欄（需安裝
dsh-better-sidebar）。
-
草稿與刷新保護
- 草稿保護：使用主機輸入快照保護草稿、引用和附件。
- 從磁盤刷新：可在不發送模型請求的情況下刷新文件，保留草稿和附件，且不會讓舊請求覆蓋新視圖。
-
導出與安全
- 導出：支持一鍵導出 PNG 圖片，以及將當前導圖複製全文爲 Markdown 源碼。
- 安全性：默認寫入審批爲“單次會話/文檔”，避免 AI 持續寫入打斷工作流。客戶端無直接文件系統寫入權限，所有編輯通過 AI 工具進行。
安裝與啓用¶
此插件依賴 DSH 主環境及可選的側邊欄插件。
-
依賴項：
@deepseek-ai/dsh-tools(需滿足特定版本要求)dsh-better-sidebar(可選，用於原生側邊欄集成，版本 >= 0.10.0)@deepseek-ai/schemastery(>= 3.18.0)
-
獲取方式：
插件源碼位於 GitHub 倉庫：https://github.com/guhanfei-ai/dsh-mindmap
典型用法¶
- 打開與渲染：在會話工作目錄中打開一個 Markdown 文件，插件將其解析爲思維導圖。根節點標題自動對應文件名。
- 迭代編輯：在聊天中輸入指令，AI 調用
mindmap_update工具修改文件，右側面板即時跟隨變化。 - 導出：點擊工具欄的“導出圖片”生成 PNG，或點擊“複製全文”將 Markdown 源碼複製到剪貼板。
- 導航：使用縮放條或快捷鍵（⌘/Ctrl+F）搜索節點，按 Enter 鍵在匹配項間跳轉。
適用場景與注意¶
- 適用場景：適合需要將結構化文檔（如大綱、筆記）轉化爲可視化導圖的場景，以及通過 AI 協作逐步完善思維導圖結構的場景。
- 注意：
- 項目處於 pre-1.0 階段，跨版本兼容性尚未認證。
- 寫入審批默認爲單次會話/文檔，需注意安全性設置。
- Markdown 文件的層級結構、嵌套列表和代碼塊均支持 MarkGrove 風格映射。
結尾¶
dsh-mindmap 提供了一種將 Markdown 文件與思維導圖緊密結合的工作流。通過工具鏈和實時渲染機制，它降低了從文本到結構的轉換成本。項目地址：https://github.com/guhanfei-ai/dsh-mindmap
