前言¶
DeepSeek Harness（DSH）採用插件化架構，擴展能力高度開放。在 Web 客戶端進行長對話開發時，對話輪次過多會導致上下文跳轉困難，難以快速定位到特定的歷史交互。dsh-turn-nav 插件正是爲了解決這個問題而生，它在對話界面右側邊緣提供了一種直觀的輪次導航方式。
插件簡介¶
插件名稱：dsh-turn-nav
維護者：xiaheng1
核心功能：爲 DeepSeek Harness Web 提供對話輪次直方圖導航軌。
許可證：MIT
該插件在對話右側邊緣渲染短條形圖，代表對話中的各個輪次。通過交互，它將靜態的條形圖轉化爲動態的導航工具，幫助開發者快速定位消息。
核心功能¶
- 多視覺變體支持：支持 Mixed、DeepSeek 和 Codex 三種視覺風格。
- 未聚焦狀態：未處於聚焦狀態的輪次以短條形式顯示在對話右側邊緣。
- 交互反饋：當鼠標懸停或鍵盤聚焦某個條形時，該條形會展開形成波浪狀（聚焦條最長），並顯示包含該輪次用戶消息的預覽卡片。
- 平滑滾動：點擊導航軌上的條形，對話界面會平滑滾動到對應的輪次位置。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add git+https://github.com/xiaheng1/dsh-turn-nav.git
dsh plugin --profile web install
安裝完成後，需要重啓 dsh web 進程，並在瀏覽器中執行硬刷新（通常是 Ctrl+F5）以加載新插件。
使用方法¶
- 打開一個工作區和對應的對話。
- 將鼠標指針移動到對話區域的右側邊緣，可以看到導航軌。
- 沿着導航軌移動鼠標，預覽卡片會跟隨當前高亮的條形平滑滑動，顯示對應的消息內容。
- 點擊任意條形，對話內容將平滑滾動到該輪次。
配置與注意事項¶
配置選項¶
插件默認在窄屏（max-width: 767px）下隱藏導航軌。若需在窄屏下保持顯示，可在配置中設置：
hideOnNarrow: false
編輯 $DSH_HOME/settings.yaml 文件即可針對當前部署覆蓋默認配置。
注意事項¶
- 該插件爲 AI 輔助生成，建議在生產環境使用前在安全環境中進行測試。
- 不同視覺變體（mixed、deepseek、codex）的默認樣式可能存在差異。
- 安裝後務必重啓服務並刷新瀏覽器。
總結¶
dsh-turn-nav 通過可視化的輪次導航軌，解決了 DSH Web 客戶端長對話的定位痛點。它提供了清晰的視覺反饋和流暢的交互體驗，適合需要頻繁在對話歷史中跳轉的開發者。
