前言¶
DeepSeek Harness（DSH）遵循“一切皆插件”的理念，社區生態豐富。在智能體開發或調試過程中，面對動輒數百條記錄的對話，在 Web GUI 中快速定位特定內容（如某條工具調用、特定錯誤或用戶指令）往往依賴瀏覽器自帶的查找功能，體驗有限。dsh-client-ui-session-search 插件在會話標題欄提供了搜索入口，對當前會話的全部歷史節點進行全文檢索，支持鍵盤操作和精確跳轉。
這是什麼¶
這是一個 In-session full-text search client plugin for the DeepSeek Harness web GUI（會話內全文搜索客戶端插件）。插件覆蓋全部歷史記錄，支持類型過濾、多關鍵詞 AND 匹配和鍵盤導航。插件由 2275803244-cpu 維護，開源協議爲 MIT。
核心功能¶
插件提供以下能力：
- 全文搜索：支持用戶消息、AI 回覆、工具調用（名稱、參數、結果）、命令、壓縮摘要、錯誤、重試等節點類型的文本檢索。
- 多關鍵詞 AND：輸入空格分隔的多個詞，全部命中才算匹配（例如輸入“插件 搜索”，需同時包含這兩個詞）。
- 類型過濾：支持按全部/我/AI/工具/命令/錯誤/其他進行篩選，並附帶實時計數。
- 鍵盤導航：使用
↑/↓鍵選擇結果，Enter鍵跳轉，Esc鍵關閉搜索框。 - 一鍵複製：鼠標懸停在結果上時，會出現“複製”按鈕，可複製該節點的完整文本。
- 結果計數：搜索框內顯示“N 條結果”。
- 全命中高亮：在搜索片段內，所有匹配的詞都會標亮顯示。
- 跳轉定位：點擊結果後，視圖會平滑滾動到目標消息，目標消息會有藍色描邊持續 1.6 秒。
- 槽位集成：掛載於
conversation.session.header.actions（order=30），與後臺任務列表並列。
安裝與啓用¶
插件同時支持 CLI / Web 版（web profile）與 桌面版（desktop profile）。安裝或更新後必須重啓程序，因爲 bundle rev 會在啓動時哈希進 boot 圖。
CLI / Web 版安裝命令：
dsh plugin --profile web add github:2275803244-cpu/dsh-session-search
桌面版安裝命令：
桌面版默認不包含該插件，需手動添加。桌面應用自帶 CLI，位於 <安裝目錄>\resources\runtime\cli\bin\dsh.cmd。
& "<桌面版安裝目錄>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add github:2275803244-cpu/dsh-session-search
注意事項：
* 桌面版需 @deepseek-ai/dsh-desktop-runtime 0.2.0-rc.2 及以上版本支持。
* 安裝完成後請重啓對應程序（Web 端重啓 dsh web，桌面版重啓應用）。
典型用法¶
- 觸發搜索：點擊會話標題欄右側的 🔍 按鈕。
- 輸入關鍵詞：輸入空格分隔的多個詞進行多關鍵詞 AND 搜索（如
插件 搜索）。 - 選擇與跳轉：使用鍵盤
↑/↓選擇結果，Enter鍵跳轉定位。 - 複製文本：鼠標懸停在某條結果上，點擊出現的“複製”按鈕。
適用場景與注意¶
- 適用場景：適合 DSH Web GUI 用戶和桌面版用戶，用於快速在海量對話中定位特定信息，提高調試和智能體開發效率。
- 權限與安全：插件以當前 DSH 進程的權限運行。在安裝前，建議檢查插件源碼與許可證（MIT）。
- 技術實現：插件爲純瀏覽器側實現，不依賴服務端全文搜索能力。
- 依賴關係：桌面版依賴
react和react/jsx-runtime，與 DSH 內部包解耦。
結語¶
該插件通過瀏覽器端實現的全文檢索能力，填補了 Web GUI 在會話內快速定位信息的空白。對於需要頻繁查閱長對話細節的開發者，能夠顯著提升操作效率。
