DSH Web 的對話窗口在運行時間較長時,滾動查找之前的用戶提問會變得繁瑣。dsh-conversation-jump 插件通過一組導航按鈕,將“按時間順序逐條查看”變爲可點擊操作,並在目標超出當前可視窗口時自動加載歷史記錄。
插件定位¶
該插件爲 DSH Web 客戶端提供導航控制,用於快速跳轉到對話的頂部、底部或前後用戶消息。它不提供縮略圖或目錄,而是專注於按語義單位(用戶消息)進行跳轉。
核心功能¶
- 導航控制:提供四組圓形按鈕,分別對應“回到頂部”、“上一個”、“下一個”和“回到底部”。
- 智能分頁:當點擊的導航目標(用戶消息或引導條目)位於當前已加載窗口之外時,插件會自動觸發宿主的“加載更多”功能,直到目標出現。
- 目標範圍:僅針對
user和steering兩種類型的條目進行跳轉,跳過工具調用、上下文注入等過程節點。 - 位置與顯示:
- 懸浮於對話內容右側,輸入框上方 16px 處。
- 默認隱藏;當向上滾動速度超過 200px/s 時出現。
- 出現後 3 秒無操作自動隱藏;點擊任何按鈕會重置計時。
- 消息錨點:跳轉落點位於視口頂部約 1/12 處。
安裝與啓用¶
通過 DSH 的插件命令進行安裝。安裝後需要重啓 dsh web 進程才能生效。
dsh plugin --profile web add dsh-conversation-jump
重啓命令:
dsh web
限制與說明¶
- 僅限 Web 客戶端:該插件爲 Web UI 插件,宿主端(host half)爲空,不提供任何後端或存儲服務。
- 狀態管理:僅維護頁面內存狀態,不依賴
localStorage、IndexedDB 或其他持久化存儲。 - 分頁依賴:分頁功能依賴於宿主界面渲染“加載更多”按鈕。如果宿主從未渲染該按鈕,導航操作將在當前已加載的歷史記錄內停止,不會無限循環。
生態信息¶
- 維護者:uigdwunm
- 許可證:MIT
- 目錄頁:dsh-conversation-jump
- 源碼倉庫:uigdwunm/dsh-conversation-jump