前言¶
DeepSeek Harness（DSH）採用插件化架構，Web GUI 的會話窗口隨着對話輪次增加，快速定位到特定問題變得困難。針對這一痛點，dsh-client-ui-timeline 在聊天區左緣提供了一列導航條，旨在提供類似桌面端 ZCode TurnNavigator 的交互體驗。
是什麼¶
這是一個位於 DSH Web GUI 左側的會話問題導航條，由開發者 hhb1028 維護。它通過「一問一槓」的視覺形式，輔助開發者或用戶在長對話中快速跳轉、預覽上下文，是早期針對 DSH Web GUI 會話導航的社區參考實現。
核心功能¶
- 隨滾動高亮：導航條會自動高亮當前視口內的問題，當前槓會拉長（2.6×），相鄰槓按距離漸變拉伸。
- 懸停預覽：鼠標懸停在某根槓上時，右側會彈出該輪問答的預覽氣泡（包含用戶問題和助手回覆）。
- 平滑滾動：點擊導航條上的槓，對應的消息行會平滑滾動到視口頂部。如果目標消息尚未渲染，系統會自動觸發翻頁加載。
- 自動加載：對於未渲染的歷史記錄，點擊時會自動翻頁加載（上限 80 頁）。
- 視覺呈現：採用左緣 dash 版樣式，會話寬度小於 640px 時自動隱藏。
安裝與啓用¶
本插件已停止維護且被官方功能取代，僅作歷史記錄。
- 進入 DSH 的 profile 目錄（例如
profiles/desktop）。 - 編輯
package.json，在dependencies中添加：
"dsh-client-ui-timeline": "^0.1.0"
- 在
dsh.profile.bundles數組中添加"dsh-client-ui-timeline"。 - 執行
pnpm install安裝依賴。 - 重啓 DSH 客戶端。
典型用法¶
- 預覽：將鼠標移動到左側導航條的橫槓上，查看右側彈出的問答摘要。
- 跳轉：點擊左側對應的橫槓，聊天界面會平滑滾動到該問題的位置。
- 響應式：在移動端或窄窗口下（<640px），該導航條會自動隱藏，以免遮擋內容。
適用場景與注意¶
- 停止維護：插件已於 2026-10-01 停止維護，npm 包已標記
deprecated。 - 官方替代：DSH 官方客戶端（
@deepseek-ai/dsh-client-ui-chat0.2.0-rc.2 起）已內置同等能力的會話 turn rail，不建議再安裝本插件。 - 兼容性：依賴 DSH 大版本更新，若 DOM 結構變化，功能會靜默隱藏，不影響 DSH 本體運行。
- 權限提示：作爲 Web 插件，它運行在瀏覽器模塊空間，零構建，不觸碰 DSH 本體源碼。
總結¶
dsh-client-ui-timeline 曾是 DSH Web GUI 缺乏導航功能時的有力補充。隨着官方內置功能的完善，它更多保留了「在宿主未提供導航時如何自行實現」的技術記錄價值。若需導航功能，請直接使用官方內置的右緣 rail。
