前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在超長對話場景下，快速定位歷史提問是智能體開發中的常見需求。dsh-query-jump 是由社區開發者 SocFeng 提供的一個輕量級插件，旨在解決長會話中查找特定提問的問題。
它在對話區右側邊緣繪製一條淡色短橫線，通過懸停交互展示歷史提問列表，並提供平滑滾動定位功能。
核心功能¶
- 僅收錄真實用戶提問：列表中僅包含用戶發送的 Query，附帶日期與時間，不包含注入消息或工具事件。
- 平滑跳轉：點擊列表條目，頁面會平滑滾動至對應的對話氣泡。
- 當前位置高亮：當前正在閱讀的條目會以浮起樣式高亮顯示。
- 低調軌道設計：平時幾乎不佔據視覺空間，僅當鼠標懸停時才展開列表。
- 自定義前綴：支持自定義列表前綴，例如使用符號或序號。
- 設置頁集成：提供完整的配置界面。
- 同步歷史提問：安裝後，插件會嘗試從會話日誌中補全安裝前未記錄的歷史提問。
- 刪除會話：提供永久刪除會話的入口（可通過設置開關），這是對官方未暴露能力的補充。
- 緩存同步：在刪除會話、刪除工作區或分叉操作時，緩存會自動對齊。
- 持久化：重啓 WebUI 或更新插件後，列表狀態通常會保留。
安裝¶
使用以下命令通過 DSH CLI 安裝插件：
dsh plugin --profile web add github:SocFeng/dsh-query-jump
安裝完成後，建議重啓 dsh web 進程，並在瀏覽器中執行硬刷新（Ctrl + F5）以加載最新資源。
使用方法¶
- 打開任意會話，觀察對話區右側邊緣的淡色短橫線。
- 將鼠標移動到短橫線區域，列表會自動展開，顯示該會話中的歷史提問。
- 點擊列表中的某一項，頁面會平滑滾動至對應的提問氣泡。
- 點擊完成後，列表保持展開狀態，移開鼠標後列表會自動收起。
配置¶
進入 DSH WebUI 的 設置 -> 插件 -> Query 定位 頁面進行配置。
可用選項包括：
- 啓用面板：總開關。
- 同步歷史提問：是否按時間線補全未記錄的 Query。
- 顯示刪除會話：控制標題欄垃圾桶圖標與側欄刪除入口的顯示。
- 自定義符號 / 序號：設置列表前綴樣式。
- 符號內容：最多 8 個字符，默認爲 🤗。
配置也可寫入 profile 文件：
config:
enable: true
markerStyle: emoji
markerSymbol: "🤗"
syncHistoricalQueries: true
showDeleteSession: true
適用場景與注意¶
該插件適合需要頻繁在超長對話中回溯上下文的智能體開發場景。
需要注意以下幾點：
- 建議在本地 127.0.0.1 訪問 WebUI。
- 遇到很早的歷史提問時，系統會先自動加載更早的內容，稍等片刻即可。
- 安裝時若出現 peer 依賴的 WARN 提示，通常可以忽略。
- 插件不收錄注入消息或工具事件。
- 它可以與其他插件（如 Trajectory）共存。
結語¶
dsh-query-jump 通過極簡的右緣軌道設計，解決了長對話中的導航痛點。對於習慣在 DSH 中進行多輪調試的開發者，這是一個提升效率的實用工具。
