前言¶

在 DSH（DeepSeek Harness）Web 端處理多輪會話時，一輪對話裏可能同時包含用戶提問、助手回覆、工具調用、命令和壓縮點。會話越長，滾動查找某一輪越費力；如果頁面默認懶加載歷史，想要回到早期輪次時，還需要先補載歷史。

dsh-conversation-navigator 針對這個問題，在 DSH Web 端提供一個按輪摺疊的對話大綱面板：點擊節點跳轉，滾動時高亮當前閱讀位置，並採用與內置軌跡視圖一致的配色。

這是什麼¶

dsh-conversation-navigator 是由 gjj-star 維護的 DSH Web 端插件，License 爲 MIT。它是一個純瀏覽器插件（無宿主行爲），純 JavaScript、零構建、零 npm 依賴。

插件主要解決長會話中的三類問題：

• 查找某一輪對話或某個步次。
• 快速跳轉到對應位置。
• 手動滾動時知道當前閱讀到哪一輪。

核心功能¶

下面是已覈實的插件能力：

• 按輪摺疊大綱：默認只顯示“第 N 輪 + 你的問題”列表。
• 關鍵詞過濾：僅按用戶提問與助手實際回覆文本匹配，並高亮命中詞。
• 展開/摺疊步次明細：包括助手回覆、工具調用、命令、壓縮點等。
• 懸停查看全文：氣泡顯示該輪用戶提問完整原文。
• 四種形態切換：顯示輪次、隱藏輪次、極簡·右、極簡·左。
• 面板可拖動：支持默認右側停靠與上次拖動位置切換。
• 點擊定位：點擊輪次主體或步次條目，平滑滾動到對應位置。
• 歷史補載：支持“加載更早 / 加載全部歷史輪次”。
• 位置跟蹤：手動滾動對話時，自動高亮並跟隨當前閱讀位置。
• 快捷操作：底部支持“回到最新 / 全部摺疊”。
• 配色：與內置軌跡視圖一致，並適配明暗主題。
• 會話跟隨：切換工作區或會話時，自動跟隨並重建大綱。

安裝與啓用¶

使用官方 CLI 安裝：

dsh plugin --profile web add dsh-conversation-navigator

dsh plugin 在 profile 目錄內轉發給 pnpm，因此官方 CLI 安裝需要 pnpm 在 PATH 上。安裝完成後，重啓 dsh web 後生效，面板默認展開。

如果不依賴 pnpm，可以使用手動方式：把倉庫放進下面路徑，並在對應 profile 的 cordis.patch.yml 頂層數組追加 example.patch.yml 的內容。

<DSH_HOME>\profiles\<profile>\node_modules\dsh-conversation-navigator

更新¶

修改 lib/client.js 後重啓 dsh web 即可更新。

插件的界面狀態分爲兩類持久化：

• 持久化於 localStorage：位置、停靠狀態與極簡左/右對齊選擇，鍵名爲 dsh-cnvnav:ui:v1。
• 僅存於當前頁面會話：展開/摺疊、模式、搜索關鍵詞等。

典型用法¶

1、安裝並重啓 dsh web，在 DSH Web 端聊天頁使用導航面板。

2、切換四種形態，循環順序爲：

顯示輪次 → 隱藏輪次 → 極簡·右 → 極簡·左

3、輸入關鍵詞進行過濾。插件只按用戶提問與助手實際回覆文本匹配，並高亮命中詞。

4、點擊輪次主體或步次條目，對話會平滑滾動到對應位置；手動滾動對話時，面板會自動高亮當前閱讀位置。

5、需要更早的歷史輪次時，使用“加載更早 / 加載全部歷史輪次”；頁面默認仍懶加載，只有點擊按鈕才補載。

6、拖動面板可改變位置；插件支持默認右側停靠與上次拖動位置切換。

適用場景與注意¶

適合使用 DSH Web 端處理較長會話、多輪工具調用和命令輸出的場景，尤其是需要頻繁定位早期輪次、助手回覆或步次明細時。

使用前需要注意：

• 目標平臺爲 DSH Web 端。
• 依賴 react、slots、sessions 服務與 @deepseek-ai/dsh-client-ui-primitives，以及 dsh-client-runtime、dsh-client-ui-conversation。
• 版本敏感點：[data-chat-anchor-key] / [data-conversation-scroll] 是當前 DSH 聊天視圖 DOM 錨點約定。DSH 升級後若錨點變化，需要調整 lib/client.js 中的 findAnchor / computeActiveKey。
• 未聲明 timer 硬依賴；客戶端 timer 服務不存在時，自動退化爲未節流模式。
• 插件以當前 dsh 進程權限運行。安裝前應檢查源碼與許可證。

鏈接¶

• GitHub：https://github.com/gjj-star/dsh-conversation-navigator
• 目錄頁（該 URL 來自插件線索，未在本篇已覈實正文中確認）：https://www.skillhub.cn/plugins/gjj-star/dsh-conversation-navigator