前言¶
在 DeepSeek Harness（DSH）里長時間對話後，想找回某段說過的話，往往只能手動翻歷史。宿主側若已有全文索引，更適合做成「輸入關鍵詞 → 列出命中 → 點開跳到位置」，而不是再疊一層歸檔瀏覽器或側欄改造。下面介紹社區插件 dsh-simple-search（維護者 luicarstar，社區目錄分類爲「記憶」）：它只做會話正文搜索，入口是會話頭部一個按鈕和一個查詢框，點結果即可定位到命中處。
這是什麼¶
dsh-simple-search 是 DSH 的一個極小客戶端插件（版本 0.1.0，MIT 許可）。定位可以概括爲 README 中的說明：Content-only session search for DeepSeek Harness: one header button, one query box, jump to the hit.
它不提供的功能同樣明確：沒有歸檔瀏覽器、沒有側欄改造、沒有設置頁、也沒有第二種搜索模式。
核心功能¶
入口與搜索¶
- 入口在會話頭部操作區（複製按鈕旁）的搜索按鈕。
- 輸入即搜，280ms 防抖，調用宿主 API
ctx.sessions.search(query, signal)，使用宿主 FTS 索引。 - 結果列表展示：命中片段（關鍵詞黃色高亮）+ 會話短 id。
交互¶
- ↑ / ↓ 選擇條目，Enter 打開，Esc 關閉，點擊空白處關閉。
- 打開會話後自動滾動到命中文本位置，並對該處閃爍約 2.6 秒。
定位邊界（使用前需知曉）¶
- 命中落在尚未加載的歷史頁時，插件會先把會話視口頂到起點以觸發分頁加載，並在 600 / 1300 / 2200 / 3400ms 重試；若仍無法定位，會恢復原來的滾動位置。
- 命中在摺疊的 thinking / 工具輸出內時，只跳過不可見節點，不會自動展開。
- 對極短且高頻的詞，會跳到第一個命中，而不是結果列表裏當前選中的那一條。
與 DSH 的銜接（0.2.1-rc.5 實測）¶
插件針對 0.2.1-rc.5 的客戶端 Slot 契約編寫，主要依賴包括：
| 依賴 | 說明 |
|---|---|
ctx.sessions.search(query, signal) |
返回 { ok, value: { items, hasMore } }，item 爲 { sessionId, snippet } |
ctx.uiWorkspace.openSession(id) |
打開會話 |
ctx.slots.inject("conversation.session.header.actions", ...) |
注入頭部按鈕 |
ctx.locale.register + ctx.locale.bind |
自行 bind 後經 inject 傳入文案 |
定位實現不依賴 CSS Module 類名，使用 rc.5 的穩定屬性 data-chat-flow / data-chat-turn。
安裝與啓用¶
插件通過 plugin_manager 從本地目錄安裝（將 <本目錄絕對路徑> 換爲你 clone 或解壓後的插件根目錄）。安裝命令以倉庫 README 爲準：
plugin_manager({ action: "install_bundle", target: "<本目錄絕對路徑>" })
安裝後若該插件行的 fiberPhase 不是 active，需要再啓用一次：
plugin_manager({ action: "set_plugin", target: "include:simple-search", enabled: true })
README 說明：客戶端半區由 dsh-client-hmr 熱更新，主進程無需重啓。
倉庫內結構簡要如下，便於覈對安裝的是完整包：
package.json dsh.bundle.patch + dsh.client.inject 聲明
cordis.patch.yml 唯一一行：include:simple-search
lib/index.js Host 半區空實現（Loader 行要求）
lib/client.js 全部功能（ModuleLoader 格式）
典型用法¶
- 在 DSH 中打開任意會話，在頭部操作區點擊搜索按鈕。
- 在查詢框輸入要找的關鍵詞，等待防抖後的結果列表。
- 用方向鍵選中條目，Enter 或點擊打開對應會話；界面會滾動並高亮閃爍命中位置。
- 搜完按 Esc 或點空白處關閉搜索層。
適用場景與注意¶
適合：需要在當前 DSH 工作區內快速檢索全部會話正文，並一鍵跳轉到命中片段的開發者或日常重度使用者；與目錄「記憶」分類一致，側重「找回說過什麼」，而非文件系統或外部知識庫。
注意：
- 插件以當前 DSH 進程的權限運行；安裝前應閱讀 GitHub 源碼 與 MIT 許可證，自行判斷是否信任維護者 luicarstar 的代碼。
- 兼容性說明基於 0.2.1-rc.5；其它 DSH 版本若 Slot 或
sessions.search行爲不同，可能需要自行驗證。 - 社區插件目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；星標等元數據以目錄頁爲準（當前爲 0）。
結尾¶
dsh-simple-search 把 DSH 裏「找會話裏說過的話」收成頭部一個按鈕和一條搜索框：借宿主 FTS，少 UI、少配置。需要安裝步驟與行爲細節時，可看社區目錄頁與 GitHub 倉庫 README。
- 目錄頁：https://www.skillhub.cn/plugins/luicarstar/dsh-simple-search
- GitHub：https://github.com/luicarstar/dsh-simple-search
