前言¶
在 DeepSeek Harness(DSH)的 Web GUI 裏跑長會話時,一條用戶消息後面可能跟着大量工具調用、上下文輸出和回覆內容。想找某一次用戶輸入,往往要反覆拖動滾動條,跨過幾屏無關內容。
DSH 的擴展方式是「一切皆插件」。社區目錄中的插件由維護者發佈,和 DeepSeek / 幻方沒有官方從屬關係,也不應把它理解爲官方應用商店。本文介紹的是其中一類 Web 客戶端插件:@smanx/dsh-conversation-indicator,它在對話區右側顯示一個緊湊的指示條面板,用來快速定位用戶消息。
這是什麼¶
@smanx/dsh-conversation-indicator 是面向 DeepSeek Harness Web GUI 的對話指示器插件,由 smanx 維護,MIT 許可證。
它做的事情很具體:
- 在對話區右側、緊貼滾動條的位置顯示一個緊湊膠囊面板。
- 標記用戶消息,點擊指示條後平滑滾動到對應位置。
- 懸停指示條時顯示對話摘要。
- 面板在滾動或流式輸出時保持隱藏,鼠標靠近時顯示,移開後淡出。
- 純瀏覽器端 bundle,無服務端邏輯。
- 不增加 Token 消耗、工具調用、會話日誌或提示詞片段。
- 偏好設置保存在瀏覽器
localStorage。
核心能力¶
這個插件不改變模型行爲,也不改變請求內容。它只針對 Web GUI 中已經渲染出來的對話區域做一個輔助面板。
主要能力如下:
-
在對話區右側顯示面板
面板緊貼滾動條,視覺上類似一個豎向指示軌。 -
標記用戶消息
默認標記data-chat-flow-kind爲user的行。助手回覆默認不標記。 -
點擊跳轉
點擊某條指示條後,對話區會平滑滾動到該行附近。 -
懸停查看摘要
鼠標停在指示條上時,可以看到對應內容的摘要信息。 -
避免遮擋正常交互
面板在滾動或流式輸出時隱藏,只有鼠標靠近時才顯示,移開後淡出。
安裝與啓用¶
從 GitHub 倉庫安裝:
dsh plugin --profile web add github:smanx/dsh-conversation-indicator#main
首次安裝後,需要重啓一次 Web 服務器,讓新的客戶端 bundle 進入啓動清單,然後刷新頁面。
更新插件時,重新執行同一條命令即可。
如果是在本地目錄開發這個插件,可以把 profile 指向本地路徑。例如:
dsh plugin --profile web add file:C:/mydata/codes/dsh-conversation-indicator
典型用法¶
經過上面的安裝步驟後,可以按下面方式使用:
- 打開一個當前內容超過一屏的會話。
- 把鼠標移到對話區右側、滾動條附近的位置,指示面板會出現。
- 懸停某條指示條,查看該行對應的摘要。
- 點擊指示條,對話區平滑滾動到該行附近。
- 鼠標移開後,面板會淡出,不影響正常閱讀和滾動。
如果當前會話內容沒有超過一屏,面板不會出現。
配置與生效方式¶
偏好設置保存在瀏覽器中,鍵名爲:
localStorage["dsh-conversation-indicator.options"]
它的值是一個 JSON 對象。可以在 DevTools 中設置後刷新頁面,配置在下次插件掛載時應用。
需要注意的是,配置是在插件掛載時讀取的。運行時直接修改 localStorage,通常需要刷新頁面,或者等視圖重新掛載後才生效。
對模型與會數據的影響¶
這個插件屬於純客戶端 UI 層,不進入模型請求鏈路。
已覈實的事實包括:
- 不增加 Token 消耗。
- 不增加工具調用。
- 不寫入會話日誌。
- 不註冊提示詞片段。
- 客戶端只觀察已渲染的 DOM,不復制、不存儲對話內容。
- 不註冊面向模型的功能。
因此,它的主要作用是在瀏覽器端提升長會話的瀏覽效率,而不是改變 DSH 的運行邏輯或模型行爲。
使用限制¶
使用前需要知道幾個邊界:
- 面板只在當前會話內容超過一屏時存在。
- 指示條反映的是當前已加載的歷史窗口;Web 端尚未渲染的極早行無法標記。
- 助手回覆默認不標記,默認只標記
user類型行。 - 配置在插件掛載時讀取,運行時修改
localStorage需要刷新頁面或視圖重掛載才生效。 - 快速連續點擊多個指示條時,可能無法打斷當前正在進行的平滑滾動動畫。
適用場景與安裝注意¶
它適合以下情況:
- 長會話中需要頻繁回看某次用戶輸入。
- 對話區包含大量工具調用、上下文輸出和回覆內容。
- 希望在 Web GUI 中少拖動滾動條,用右側指示條做快速定位。
- 只需要一個輕量、純瀏覽器的輔助面板,不想增加模型側成本。
安裝前仍要按第三方插件處理:先檢查源碼、依賴和 MIT 許可證。從運行角度看,插件運行在 DSH 宿主環境中,使用當前 dsh 進程權限;如果是在生產環境或團隊環境使用,建議先在自己的環境中驗證安裝命令、頁面刷新和重啓 Web 服務器的完整流程。
相關鏈接¶
GitHub 倉庫:
https://github.com/smanx/dsh-conversation-indicator
社區目錄頁:
https://www.skillhub.cn/plugins/smanx/dsh-conversation-indicator