前言¶
用 DeepSeek Harness（DSH）做智能體開發或長對話調試時，會話一多、單條對話一長，靠肉眼翻左側列表很難找回某句配置、某次工具輸出或某段報錯。客戶端自帶的瀏覽方式通常要先打開會話再上下滾動，跨會話檢索更費時間。下面介紹社區插件 dsh-conversation-search（維護者 itstartstosnow）：在桌面端 Web GUI 裏做全會話全文搜索，並在當前對話內提供類似編輯器的查找條，點結果即可跳到對應消息。
這是什麼¶
dsh-conversation-search 是 DSH 的會話全文搜索插件（npm 包名 @itstartstosnow/dsh-conversation-search，當前版本 0.1.1，MIT 許可證）。它通過 Cordis patch 注入左側欄「搜索會話」面板，並接管對話內的 Cmd+F / Ctrl+F 查找體驗：一邊搜所有會話的內容，一邊在當前會話裏上下翻命中並高亮。
插件以 DSH 插件機制運行，需 DeepSeek Harness 桌面客戶端 0.2.1-rc.3 或更新（見 package.json 中 dsh.engines.dsh）。社區目錄頁：skillhub.cn/plugins/itstartstosnow/dsh-conversation-search；源碼與說明：GitHub 倉庫。SkillHub 爲獨立社區目錄，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
左側欄：搜索全部會話¶
輸入關鍵詞即可檢索全部對話，無需先打開某個會話。結果按會話分組，展示命中片段與高亮；點會話標題可展開該會話下的全部命中位置。點任意一條命中會打開對應會話並落到那句話；若歷史很深，加載過程有進度提示，也可取消。直接點會話行則跳到該會話的第一條命中。
默認搜索範圍是用戶提問與助手回覆的文字。點搜索框右側「範圍」，可額外納入工具輸出或思考過程。
對話內查找條¶
在當前會話內用查找條上下瀏覽命中，黃色高亮標出位置，並顯示「當前/總數」計數。
| 操作 | 快捷鍵 |
|---|---|
| 打開查找條 | Cmd+F（Windows / Linux：Ctrl+F） |
| 下一個 / 上一個 | Enter / Shift+Enter |
| 關閉 | Esc |
打開查找條時會自動加載完整會話，因此很早的消息也能搜到；加載期間查找條下方有提示，不影響繼續輸入。「Aa」開關區分大小寫；「全詞」只匹配完整英文單詞（兩側不能是字母、數字或下劃線，例如全詞 foo 不會命中 foobar）。中文無詞邊界，全詞對中文不產生額外限制。
中英文、數字與 emoji 均可搜索；英文默認不區分大小寫。
索引與跳轉¶
索引緩存在 ~/.dsh/cache/dsh-conversation-search/，自動保持更新，不修改會話源文件。面板頂部提供「重建索引」用於手動重建。
安裝與啓用¶
環境：DeepSeek Harness 桌面客戶端 ≥ 0.2.1-rc.3。
推薦通過 npm 包名安裝，在 Harness 對話中讓 Agent 執行（或按你環境支持的等價插件管理入口）：
plugin_manager install_bundle target: @itstartstosnow/dsh-conversation-search
若已有插件源碼目錄，也可指定本機絕對路徑：
plugin_manager install_bundle target: /absolute/path/to/dsh-conversation-search
亦可在 Harness 插件管理界面從本地目錄安裝。安裝成功後左側欄應出現「搜索會話」，一般無需重啓；若未出現，刷新頁面或重新打開 Harness。
卸載並恢復官方搜索與快捷鍵：
plugin_manager remove_bundle target: @itstartstosnow/dsh-conversation-search
安裝前建議自行查看倉庫源碼與 MIT 許可證；插件與當前 DSH 進程同權限運行，只安裝你信任的來源。
典型用法¶
跨會話找一句配置或回覆¶
- 點左側欄「搜索會話」，輸入關鍵詞。
- 在分組結果中點會話標題展開全部命中，點某條片段打開會話並定位到該消息；或點會話行跳到第一條命中。
- 需要搜工具輸出或思考過程時，在「範圍」中勾選相應類型。
在當前對話裏精確定位¶
- 打開目標會話，按
Cmd+F或Ctrl+F打開查找條。 - 輸入關鍵詞，用
Enter/Shift+Enter在命中間切換。 - 需要嚴格匹配英文單詞或大小時，打開「Aa」或「全詞」。
可選：高亮顏色¶
默認熒光筆黃色（普通命中淡黃、當前命中亮黃、跳轉落位琥珀色描邊）。在開發者工具控制台寫入後刷新頁面即可覆蓋：
localStorage.setItem('dsh-conversation-search.highlight', JSON.stringify({
matchBg: 'rgba(255, 212, 32, 0.45)', // 普通命中
currentBg: '#ffd43b', // 當前命中
currentFg: '#241d00', // 當前命中文字色
flash: '#f5a623', // 跳轉落位描邊
}));
適用場景與注意¶
適合誰：長期在 DSH 裏維護多會話、需要按關鍵詞回溯配置、報錯或某輪 Agent 回覆的開發者；需要在單條長對話裏快速跳轉多處命中的場景。
使用時需知：
- 工具輸出的完整正文在官方「查看」詳情裏；對話界面只顯示緊湊工具行，因此搜到工具內容時會定位到對應工具調用行。
- 頁內查找只匹配已渲染的文字：摺疊的思考過程、未展開的工具卡片不會被查找條命中；從全局搜索跳轉時會自動展開目標塊。
實現細節與索引契約見倉庫內 docs/development.md、docs/api-contract.md；維護者用 node --test 跑測試（README 記載 87 條）。
結尾¶
dsh-conversation-search 把「找一句說過的話」拆成兩層：左側欄掃全會話並一鍵跳轉，對話內查找條補當前會話的細粒度翻查。若你在 DSH 插件生態裏補齊檢索能力，可從社區目錄或 GitHub 獲取 @itstartstosnow/dsh-conversation-search 並按上文 plugin_manager install_bundle 安裝。
- 目錄頁：https://www.skillhub.cn/plugins/itstartstosnow/dsh-conversation-search
- GitHub：https://github.com/itstartstosnow/dsh-conversation-search
