前言¶
在 DeepSeek Harness (DSH) 中，會話往往很長，關鍵信息（結論、決策、待辦事項）分散在數十輪對話中，復盤時閱讀完整記錄效率較低。dsh-session-mindmap 插件旨在解決這個問題，它根據當前會話生成一個獨立的 HTML 腦圖文件，讓重要信息一目瞭然。
這是什麼¶
dsh-session-mindmap 是一個 DSH 客戶端插件，由 jianyuepei 維護。它的核心功能是將 DeepSeek Harness 會話轉換爲獨立的 HTML 腦圖。生成的文件無需網絡、字體或 CDN，完全離線可用。它通過增量生成和狀態緩存，在保證準確性的同時減少對模型調用的消耗。
安裝與啓用¶
在安裝前，請確保 DSH 版本爲 0.2.0-rc.2 或更高。通過插件管理器安裝：
dsh plugin add dsh-session-mindmap
安裝後，插件會註冊 /mindmap 命令及相關工具。
典型用法¶
插件支持通過命令行或直接與模型對話來觸發。以下是可用的命令示例：
/mindmap：爲當前會話生成腦圖。/mindmap last：爲最近一次會話生成腦圖。/mindmap session-abc --reveal：爲指定會話 ID 生成腦圖，並自動在文件管理器中選中。/mindmap --no-open：靜默生成文件，不自動打開。/mindmap --focus=發佈方案：僅針對特定主題生成腦圖。/mindmap --kinds=topic,file：包含文件類型的節點。/mindmap --lang=en：指定輸出語言（默認爲配置中的語言）。/mindmap list：列出最近的會話 ID 及標題。
核心能力¶
- 離線與獨立：生成的 HTML 文件完全自包含，使用內聯 SVG 繪製，不依賴外部資源，可離線查看或發送給他人。
- 交互功能：支持節點摺疊、拖拽平移、滾輪縮放、搜索高亮以及懸停查看節點來源（如 conversation segment）。
- 導出功能：支持將腦圖導出爲 PNG、Markdown 和 Mermaid 格式。
- 增量生成：如果會話已有生成記錄，再次運行會顯示節點變更（如 13 → 18 nodes · +6 · -1），並標記新增節點。
- 智能緩存：基於會話狀態緩存結果，在會話未新增內容時跳過模型調用，避免重複成本。
配置與緩存¶
插件支持在配置文件中設置參數。例如，設置默認語言和最大節點數：
- id: session-mindmap
name: 'dsh-session-mindmap'
config:
language: en
maxNodes: 120
結果文件默認存儲在 <session workspace>/.dsh/mindmap/ 目錄下。插件會自動處理增量更新，並在 .cache 目錄中保存狀態。
注意事項¶
- DSH 版本要求：必須使用 DSH 0.2.0-rc.2 或更高版本。
- Mermaid 渲染限制：DSH Web GUI 不支持渲染 Mermaid 代碼塊，因此插件生成的腦圖本身不包含 Mermaid 渲染，但支持將其導出爲 Mermaid 代碼。
- 數據讀取：會話數據通過
ctx.sessionQuery讀取，磁盤日誌需解壓後才能獲取完整信息。 - 錯誤處理：如果模型返回失敗，插件會報錯並終止，不會生成後備大綱。
- 隱私與權限：插件僅讀取會話內容併發送給已配置的模型，數據僅寫入會話工作區，不涉及其他外部傳輸。
結尾¶
dsh-session-mindmap 提供了一種將長對話轉化爲結構化文檔的高效方式。通過離線文件、增量更新和交互式查看，它幫助開發者更好地梳理會話脈絡。更多詳情可查看插件目錄或 GitHub 倉庫。
