DSH 插件:對話指示器,在 Web GUI 滾動條旁標記用戶消息

前言

在 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 中已經渲染出來的對話區域做一個輔助面板。

主要能力如下:

  1. 在對話區右側顯示面板
    面板緊貼滾動條,視覺上類似一個豎向指示軌。

  2. 標記用戶消息
    默認標記 data-chat-flow-kind 爲 user 的行。助手回覆默認不標記。

  3. 點擊跳轉
    點擊某條指示條後,對話區會平滑滾動到該行附近。

  4. 懸停查看摘要
    鼠標停在指示條上時,可以看到對應內容的摘要信息。

  5. 避免遮擋正常交互
    面板在滾動或流式輸出時隱藏,只有鼠標靠近時才顯示,移開後淡出。

安裝與啓用

從 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

典型用法

經過上面的安裝步驟後,可以按下面方式使用:

  1. 打開一個當前內容超過一屏的會話。
  2. 把鼠標移到對話區右側、滾動條附近的位置,指示面板會出現。
  3. 懸停某條指示條,查看該行對應的摘要。
  4. 點擊指示條,對話區平滑滾動到該行附近。
  5. 鼠標移開後,面板會淡出,不影響正常閱讀和滾動。

如果當前會話內容沒有超過一屏,面板不會出現。

配置與生效方式

偏好設置保存在瀏覽器中,鍵名爲:

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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜