在 DeepSeek Harness Web 的開發過程中,長對話往往導致上下文冗長,快速定位用戶輸入的指令變得繁瑣。爲了解決這個問題,社區開發了導航輔助工具。下面介紹 DSH User Message Minimap,它通過在對話左側顯示用戶消息導航軌,讓快速定位指令變得簡單。
插件簡介¶
DSH User Message Minimap(用戶消息導航軌)是一個可隨時安裝和卸載的 Web 客戶端插件。它會在長對話左側顯示一個緊湊的導航軌,映射用戶消息的位置,方便開發者快速辨認當前輪次並跳回之前的指令。
核心功能¶
- 導航軌顯示:對話中至少有 4 條用戶消息時,左側會顯示導航軌。
- 標記對應:每條用戶消息對應一個標記,順序與對話內容一致。
- 交互定位:點擊標記或使用鍵盤,可跳轉到對應的用戶消息。
- 智能滾動:
- 距離不超過 5 條消息時使用短距離平滑滾動。
- 更遠距離和拖動導航時保持即時定位。
- 高亮與動效:到達目標後使用當前 DSH 主題色突出消息,並尊重系統的“減少動效”設置。
- 連續瀏覽:拖動導航軌時可連續瀏覽長對話。
安裝與啓用¶
使用以下命令將插件安裝到 DSH Web profile,然後啓動 Web 客戶端:
dsh plugin --profile web add dsh-user-message-navigation
dsh web
如果使用的 profile 不是 web,請將命令中的 web 替換爲實際名稱。
使用方式¶
- 打開一段至少包含 4 條用戶消息的 Chat 對話。
- 在對話左側找到豎向的消息標記。
- 懸停可查看對應消息的文本預覽。
- 點擊標記即可定位;也可以沿導航軌拖動,連續瀏覽不同輪次。
注意事項與兼容性¶
- 依賴實現細節:插件依賴現有 DOM 屬性(
data-chat-flow、data-chat-flow-kind、data-chat-anchor-key、data-conversation-scroll)。這些是 DSH Web 的實現細節,不是穩定的第三方插件接口。 - 版本兼容:插件當前面向 DeepSeek Harness
0.1.1-rc.2。 - 故障排查:升級 DSH 後如果導航軌不再顯示或無法定位,建議先停用插件。
獲取與反饋¶
更多細節和源碼請訪問 GitHub Repository。