前言¶
用 DeepSeek Harness（DSH）做長對話時，主區域往往是消息流；把結構化的想法記在別處再貼回來，容易和當前會話脫節。大綱類工具能解決層次問題，但若要和對話並排對照，又希望節點能配圖、拖位置、最後收成一篇可餵給模型的 Markdown，通常要換兩三個應用。
下面介紹社區維護的客戶端插件 dsh-mindmap（stzyk）：在會話右側抽屜裏打開思維導圖，數據落在 Host 本地，畫布與 Markdown 可雙向同步，並支持一鍵導出。
這是什麼¶
dsh-mindmap 是 DSH 的思維導圖插件，分類爲客戶端，通過 @deepseek-ai/dsh-client-ui-sidebar 等注入點在 Web 界面掛載。維護者爲 stzyk，源碼與說明見 GitHub 倉庫，社區目錄頁爲 skillhub.cn/plugins/stzyk/dsh-mindmap。當前 package 版本爲 0.35.5，許可證 MIT，運行要求 Node ≥ 20。
插件解決的核心問題：在不離對話的前提下，用樹形大綱記錄與整理思路，持久化到 ~/.dsh/storages/dsh-mindmap.json，並可轉爲標題式或列表式 Markdown。
核心功能¶
界面與存儲¶
- 在右側欄首頁點「思維導圖」卡片打開；導圖與對話並排，不佔主聊天區。
- 自動保存：防抖 0.6 秒，離開頁面前強制落盤，失敗按 2/5/10/30 秒重試；工具欄右上角顯示保存狀態。
- 關閉後再次打開同一份導圖，視口位置與縮放記在瀏覽器
localStorage，不寫進文檔文件。
鍵盤化編輯與畫布操作¶
常用快捷鍵（節選）：
| 按鍵 | 動作 |
|---|---|
Tab |
加子節點 |
Enter |
加同級節點 |
Alt+← / → |
調整層級 |
| 方向鍵 | 在樹上移動光標 |
Cmd/Ctrl+Z |
撤銷（深度 100 步） |
Cmd/Ctrl+D |
複製節點及子樹 |
節點可自由拖動並持久化位置；工具欄提供「重新排版」恢復自動佈局。畫布縮放約 25%–300%，支持框選多節點批量改樣式。屬性面板需點工具欄「屬性」顯式打開，選中節點不會自動彈出。
多主題、連線與節點標識¶
- 多主題：在畫布空白處雙擊可新增並列中心主題；導出時每個主題對應一個
#一級標題。多主題導圖暫不支持從 Markdown 反向合併（會提示拒絕），單主題不受影響。 - 層級連線：點線可選中；拖線端點可改掛載關係；雙擊可加連線說明（上限 120 字，目前不導出到 Markdown）。斷開連線時節點升到第 1 級，可成爲新的中心主題。
- 關係線：節點右側連接點拖到另一節點，不改變樹結構；線型、粗細、顏色可單獨設置。若一端仍是 1 級節點，會自動變成父子關係並取消關係線。
- 節點標識：如 ⭐ 重點、⚠️ 易錯、❓ 疑問等，單節點最多 4 個，隨數據保存與導出。
配圖與 Markdown¶
- 粘貼或拖入 PNG / JPEG / GIF / WebP（單張上限 8MB，不支持 SVG）；文字留空即爲純圖片節點，單節點最多 24 張。
- 右側 Markdown 欄可收起：畫布改動實時同步到側欄；改 Markdown 後點「應用修改」合併回畫布，保留圖片、位置與摺疊狀態。
- 兩種 Markdown 形態：標題形態（每層
#，超過 6 層降爲列表）適合文章骨架；列表形態（嵌套無序列表）適合大綱工具或模型輸入。支持相對路徑導出、內嵌單文件，以及複製 / 下載.md；倉庫 README 還說明可在命令行導出（不開網頁）。
工程與質量¶
package.json 中提供 gates（node scripts/gates/run.mjs）與多組 node --test 腳本（core、store、history、parse、style、tools 等）。安裝時因 lib/ 爲構建產物，會執行 prepare 現場編譯。
安裝與啓用¶
前提：dsh 已在 PATH 中，Node 版本滿足 ≥ 20。下面示例 profile 名爲 web（內置 profile）；自定義 profile 一般在 ~/.dsh/profiles/ 下，裝到平時用的那個即可。
從 GitHub 安裝¶
dsh plugin --profile web add git+https://github.com/stzyk/dsh-mindmap.git
pnpm 默認可能攔截來自 git 的構建腳本，首次失敗時按終端提示，將類似下面一行加入 $DSH_HOME/profiles/web/pnpm-workspace.yaml（無文件可新建，只寫 allowBuilds 段亦可）：
allowBuilds:
dsh-mindmap@git+https://github.com/stzyk/dsh-mindmap.git#<commit>: true
然後重新執行上面的 add 命令。
本地 link 安裝（改源碼時）¶
在已 clone 的源碼目錄中先構建，再以絕對路徑 link（README 中的完整步驟如下）：
npm install && npm run bundle
dsh plugin --profile web add link:$PWD
之後改客戶端只需 npm run bundle 並刷新頁面；改 lib/index.js（Node 半區）需重啓 DSH。
重啓與確認¶
dsh web
# 或其它 profile，例如：
dsh --profile desktop-web web
確認 bundle 已裝配：
dsh --profile web --dump-config | grep -A1 mindmap
輸出中出現 - id: dsh-mindmap 即表示已加入 profile 的 dsh.profile.bundles。界面上在會話右側欄首頁應能看到「思維導圖」卡片。
卸載：
dsh plugin --profile web remove dsh-mindmap
數據文件仍留在 ~/.dsh/storages/，需徹底刪除時請自行清理。
典型用法¶
- 右側欄首頁點「思維導圖」→ 填寫標題 → 新建。
- 用
Tab/Enter擴樹，空格或F2在保留原文前提下編輯，選中後直接打字可整段替換。 - 需要配圖時直接粘貼或拖文件進畫布；要統一外觀時選中節點或連線，點「屬性」改配色、字號、邊框等。
- 整理完成後點「Markdown」，在側欄微調大綱，點「應用修改」回寫；或複製 / 下載
.md用於寫作或後續 prompt。
搜索節點正文用 Cmd/Ctrl+F；大畫布拖遠後用工具欄「居中」回到內容。
適用場景與注意¶
適合：在 DSH 對話旁快速搭結構、標註重難點、配圖備忘，並導出 Markdown 與對話或智能體工作流銜接的開發者。
注意：
- 插件隨當前 dsh 進程權限運行，安裝前請自行審閱 源碼 與 MIT 許可證。
- 社區目錄 skillhub.cn 爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係；DSH 本身以「一切皆插件」方式擴展能力。
- 多主題 + Markdown 反向編輯有限制；連線說明、視口記憶等行爲以 README 當前說明爲準。
結尾¶
dsh-mindmap 把思維導圖收進 DSH 右側抽屜：鍵盤樹編輯、自由佈局、連線與多主題、配圖，以及與 Markdown 的雙向合併和本地持久化，適合需要「邊聊邊捋結構、最後收成文稿或大綱」的場景。
