前言¶

在 DeepSeek Harness (DSH) 中開發或調試智能體時，面對長會話的對話軌跡，往往難以快速理清邏輯脈絡。@nydsg/dsh-mindmap 把對話渲染成一張橫向層級樹：最左側是唯一的起始總標題（內容是第 1 輪提問），之後每一輪從它向右逐層展開。卡片表面只顯示提問，插件通過比較每輪提問與前序提問的相似度（信號詞閾值 0.50）自動續接分支，也支持手動修改父節點。全部分析在瀏覽器本地完成，無網絡請求、無模型調用、無構建步驟。

安裝與啓用¶

安裝插件後重啓 Harness，會話頂部會出現第三個頁籤「導圖」，與「對話」「軌跡」平級。

dsh plugin --profile web add @nydsg/dsh-mindmap

核心功能¶

橫向層級樹與總標題¶

導圖視圖採用列 = 深度、行 = 排布的佈局方式。最左側列固定爲起始總標題，內容取第 1 輪提問。它不是一輪對話，沒有模塊、不可選中，也不產生自己的連線。所有分支起點都掛在總標題下，形成單一入口的樹狀結構。

自動分支與接上一輪¶

插件通過比較提問詞面的相似度決定分支走向。規則如下：
1. 詞面命中：本輪提問與之前某一輪的提問共享足夠的信號詞（閾值 0.50），則接到那一輪下面（回溯）。
2. 接上一輪：提問詞面沒有命中任何更早的輪次時，本輪就作爲上一輪的子節點。這是基於對話順序的結構判斷，不是猜測。
3. 新分支：既不命中更早提問，也不屬於接上一輪時，作爲新的起始分支。

層級上限與換行¶

默認最大層級爲 5。當一輪按原規則會落在第 6 層時，它不再向下，而是在上一輪旁邊並列（換行新建）。這防止了長會話的橫向無限延伸。可在工具欄將最大層級設爲 0 以不限層級。

手動控制與持久化¶

選中卡片後，可在右側面板手動指定該輪接到任意更早的問題下面或改爲新分支。手動指定的連接會按會話存本地，重載後仍在，且不會被自動重算覆蓋。

模型判定（可選）¶

1.4.0 版本起支持「模型判定」。它利用 DSH 裏配置好的模型，根據系統提示詞判斷當前輪次應「下推 / 換行 / 回溯」。判定結果通過本地 HTTP 橋 (/plugin-mindmap/*) 調用，默認關閉，點擊「運行模型判定」時生效。手動指定永遠壓過模型結論。

導出與離線¶

插件支持一鍵導出整張導圖爲 Markdown 大綱。所有分析均在瀏覽器本地完成，零網絡請求、零模型調用、零構建步驟。離線判定默認行爲是按對話順序下推。

判定邏輯說明¶

插件使用信號詞（會話內出現 ≤2 次或高於自身 IDF 中位數）而非餘弦相似度計算分數。真實追問（如「那接下來呢」）幾乎不重複上一輪迴復裏的名詞，因此無法靠相似度判斷「接上一輪」。插件將「接上一輪」定義爲結構延續，將「回溯」定義爲詞面證據確鑿的舊話題迴歸。

適用場景¶

適合需要梳理長對話邏輯、調試智能體規劃能力、或對會話結構進行可視化的開發者。

資源¶

• 倉庫地址：https://github.com/nydsg/dsh-mindmap