前言¶
在使用 DeepSeek Harness (DSH) 進行智能體開發時，長對話的管理與內容定位是常見痛點。官方 Turn Rail 導航軌雖然提供了刻度，但在查看歷史記錄時往往缺乏內容預覽和精細過濾能力，導致在長對話中難以快速定位關鍵信息。dsh-chat-toc 插件旨在解決這一導航與大綱增強問題，通過深度賦能原生 Turn Rail，提供輕量級、高性能的對話瀏覽體驗。
是什麼¶
dsh-chat-toc 是一款 DSH Web GUI 的對話導航與大綱增強插件，由開發者 a792883583 維護。它 100% 融合官方原生 Turn Rail 導航軌，移除冗餘軌道，提供雙向懸停卡片、收藏過濾及 Markdown 導出功能，無需額外配置即可在 Web 界面中運行。
核心功能¶
- 原生融合與視覺優化：100% 融合官方 Turn Rail 導航軌，移除冗餘軌道，不破壞界面原有留白。
- 懸停卡片：鼠標滑過軌道刻度時，優雅彈出預覽卡片，清晰呈現用戶提問與 AI 回答。
- 穩定性機制：採用 300ms 黃金防抖，鼠標從軌道移入卡片時卡片保持穩定懸浮，便於選中文本或點擊操作。
- 交互操作：卡片支持一鍵收藏對話與複製內容。
- 持久化存儲：基於會話 ID 和消息指紋進行跨會話持久化，刷新頁面不丟失收藏狀態。
- 工具條功能：右上角提供扁平工具條，包含關鍵詞搜索（支持 Enter 觸發深度回溯搜索）、代碼/工具膠囊過濾、Markdown 大綱導出。
- 主題適配：支持多語言與明暗主題自適應。
安裝與啓用¶
安裝插件：
dsh plugin --profile web add dsh-chat-toc
安裝或更新後，刷新 dsh web 頁面即可生效。
典型用法¶
- 本地開發調試時，可使用鏈接方式安裝：
dsh plugin --profile web add link:/path/to/dsh-chat-toc
- 在長對話中，按 Enter 鍵可觸發全會話深度回溯搜索，系統會自動加載更早的消息並定位目標。
- 點擊工具條中的代碼過濾膠囊，可快速過濾出代碼變更或工具調用輪次。
- 點擊收藏按鈕開啓收藏過濾模式，已收藏項會呈金色高亮。
- 點擊大綱導出按鈕，可將整場對話的 Markdown 結構大綱複製到剪貼板。
適用場景與注意¶
該插件適合需要頻繁查閱長對話歷史、進行代碼或工具調用定位、以及對對話內容進行歸檔分享的開發者。
注意：
* 需要使用帶有官方 Turn Rail 導航軌的 DSH Web 版本（已在 @deepseek-ai/dsh@0.1.5-rc.2 測試通過）。
* 插件依賴 @deepseek-ai/dsh-client-locale 和 @deepseek-ai/dsh-client-runtime。
* 純前端增強，無需宿主側服務，無需額外配置。
短結尾¶
dsh-chat-toc 通過增強原生 Turn Rail，爲長對話提供了輕量級、高性能的導航與大綱工具。它不改變 DSH 的核心架構，而是作爲客戶端插件無縫集成。更多細節可在 GitHub 查看。
