MIT 授權的 DSH 外掛:為過去的 DeepSeek Harness 會話加上標題檢索與 FTS5 全文檢索,一條 `dsh plugin add` 安裝,入口在側欄、整頁或終端 `/sfind`。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-15
授權條款
MIT
01它能幫你完成什麼?
依標題找回過去的 DeepSeek Harness 會話,或找出某句話出現在哪個會話裡
標題模式輸入即出結果;內容模式按會話彙整顯示命中片段,並支援類型(使用者/回覆/工具)、檢索範圍(全部/活躍/歸檔)、日期區間、排序(相關度/時間)與命中展開
會話歷史長到在側欄裡翻不動的 DSH 使用者
修好過期或缺內容的索引,讓命中真的跳到目標行
重建本機 FTS5 索引(影子庫建置 → 原子切換 → 有界歸檔);DRS 投影庫落後時先用深度同步慢速重掃再整理
結果缺漏或陳舊、或點了命中只開啟會話卻不跳到目標行的 DSH 使用者
02如何將外掛接入 DeepSeek Harness?
先決條件
- 具備 `dsh plugin` CLI 的 DSH 宿主 —— README 的安裝命令針對名為 `web` 的 profile
- `dsh-reference-session-collector`(DRS):作為本套件的正式相依隨套件安裝,使用者不需另外下載;但作為遞移相依,宿主可能不會掛載它
- 安裝後需重啟宿主行程 —— README 明寫「必須重啟宿主行程」
安裝步驟
- 01
執行 `dsh plugin --profile web add dsh-search-index`(同一條命令也可用本機 `.tgz` 路徑取代套件名稱)
$ dsh plugin --profile web add dsh-search-index
- 02
重啟宿主行程;DRS 未啟用前內容檢索不可用,標題面仍可用
- 03
若設定卡提示 DRS 未啟用,執行 `dsh plugin --profile <name> add dsh-reference-session-collector` 後重啟宿主
$ dsh plugin --profile <name> add dsh-reference-session-collector
- 04
從合併套件 `dsh-session-steward`(≤0.5.x,內含 search)遷移時,先用 `dsh plugin remove dsh-session-steward` 移除它,再安裝 `dsh-manage-session` 與本外掛
$ dsh plugin remove dsh-session-steward
驗證整合成功
- 在 dsh-tui 執行 `/sfind`,讀取檢索通道狀態:DRS 可用性、會話數與是否正在建立索引
- Web 宿主下兩條通道都不可用時,`search-status` 會回傳 `available:false` 與具體原因碼;`/switch-search/api/index-status` 回傳 200 且 `available:true` 代表索引面已就緒
復原
- 把 `switch-search` 設定裡的 `enabled` 設為 false:不再註冊任何方法,入口整個消失
03DSH 整合程度與能力邊界
原生 DSH 外掛:以 `dsh plugin add` 裝進 DSH profile,自帶 `/switch-search/api` 路由面;宿主 ≥ 0.1.7 時註冊側欄面板列+主欄整頁,較早的宿主則是底欄按鈕+彈窗,另有設定卡與宿主斜線命令
標題模式檢索
在搜尋入口輸入的查詢字;`defaultMode` 預設為 `title`→包含該查詢字的會話標題,輸入即出結果
內容全文檢索與篩選
關鍵字,加上類型(使用者/回覆/工具)、檢索範圍(全部/活躍/歸檔)、日期區間、依相關度或時間排序、命中展開→按會話彙整的命中結果與命中片段,可展開檢視
語料取自 `dsh-reference-session-collector` 投影庫,走同源 HTTP 路由或行程內唯讀直連命中定位(跳到目標行)
一筆內容檢索命中結果→開啟會話並巡邏定位到目標行,附診斷徽章;冷資料先跳確認,確認後依實測頁寬回溯翻頁,HUD 浮窗顯示進度
目標距會話最新回合 >40 的冷資料會先跳確認再回溯翻頁索引生命週期:增量同步、非破壞性整理、深度同步、快照
整理時讀宿主 `sessionQuery` 全量;深度同步讀 DRS 投影庫→影子庫建置後原子切換的本機 FTS5 索引與有界歸檔,外加 JSON Lines 快照匯出/匯入
寫入 `~/.dsh-switch-search/`:獨立 FTS5 索引庫、歷史索引份數與墓碑台帳對 `~/.dsh/storages/workspace.json` 唯讀 —— 僅取歸檔集合與工作區成員表終端斜線命令 `/sfind`
dsh-tui 中的 `/sfind`、`/sfind <q>` 或 `/sfind <q> --content`→檢索通道狀態、標題模式命中或內容模式 FTS 命中,依 TUI 單行格式輸出
04適合誰?何時不該用?
適合
- 會話歷史長到在側欄裡翻不動的 DSH 使用者
- 結果缺漏或陳舊、或點了命中只開啟會話卻不跳到目標行的 DSH 使用者
不適合
- 不能與合併套件 `dsh-session-steward`(≤0.5.x,內含 search)同時安裝:兩者都註冊 `/switch-search/api` 前綴,0.1.5 線宿主會直接啟動失敗(duplicate prefix route)。遷移時先移除舊套件,再安裝 `dsh-manage-session` 與本外掛。
- 內容檢索相依於 DRS 投影庫(`dsh-reference-session-collector`)。它作為遞移相依隨套件安裝,而宿主啟用 bundles 只掃 profile 頂層 `dependencies`,因此投影庫可能永遠不更新;此時設定卡會提示執行 `dsh plugin --profile <name> add dsh-reference-session-collector` 再重啟宿主。DRS 缺席時標題檢索照常可用。
- 與 drsc 0.2.6 有版本耦合:低於 0.7.15 的本套件會把「時間預算用完」當成掃完(`syncing=false` 但 `deferred` 不為 0),接著拿殘缺語料重建本機索引。升級時先升本套件、再升 drsc;本套件 ≥0.7.15 搭配舊版 drsc 是安全的。
05相容性、維護與安全提醒
- 不能與合併套件 `dsh-session-steward`(≤0.5.x,內含 search)同時安裝:兩者都註冊 `/switch-search/api` 前綴,0.1.5 線宿主會直接啟動失敗(duplicate prefix route)。遷移時先移除舊套件,再安裝 `dsh-manage-session` 與本外掛。
- 內容檢索相依於 DRS 投影庫(`dsh-reference-session-collector`)。它作為遞移相依隨套件安裝,而宿主啟用 bundles 只掃 profile 頂層 `dependencies`,因此投影庫可能永遠不更新;此時設定卡會提示執行 `dsh plugin --profile <name> add dsh-reference-session-collector` 再重啟宿主。DRS 缺席時標題檢索照常可用。
- 與 drsc 0.2.6 有版本耦合:低於 0.7.15 的本套件會把「時間預算用完」當成掃完(`syncing=false` 但 `deferred` 不為 0),接著拿殘缺語料重建本機索引。升級時先升本套件、再升 drsc;本套件 ≥0.7.15 搭配舊版 drsc 是安全的。
MIT · latest release v0.7.18 (2026-11-14), last push 2026-11-10
06常見問題
要怎麼把它裝進 DeepSeek Harness?
執行 `dsh plugin --profile web add dsh-search-index`(同一條命令也可用本機 `.tgz` 路徑取代套件名稱),然後重啟宿主行程 —— README 明寫必須重啟。宿主 ≥ 0.1.7 時外掛變成側欄面板列+主欄整頁,可用 `Ctrl/⌘+K` 開啟;較早的宿主仍是底欄按鈕+彈窗。
外掛裝好了,內容檢索卻不可用,為什麼?
內容檢索需要 DRS 投影庫 `dsh-reference-session-collector`。它作為本套件的正式相依隨套件安裝,但宿主啟用 bundles 只掃 profile 頂層 `dependencies`,作為遞移相依可能不會被掛載,投影庫也就不再更新。此時設定卡會給出啟用命令 `dsh plugin --profile <name> add dsh-reference-session-collector`,執行後重啟宿主即可。DRS 缺席時標題檢索照常可用。
DSH NEXT 桌面版能用嗎?
可以。桌面宿主在 web 層對非渲染行程請求一律回 `403 Browser access is disabled`,因此 HTTP 通道在桌面版永遠不可用;`contentTransport` 預設為 `auto` 時外掛會自行改走行程內唯讀臂,使用者無需任何操作。只有兩臂都不可用時 `search-status` 才回傳 `available:false` 並給出具體檔位碼。
它往磁碟寫什麼?整理索引會毀掉資料嗎?
索引寫在自己的目錄 `~/.dsh-switch-search/`:獨立 FTS5 索引庫、歷史歸檔份數與墓碑台帳;`~/.dsh/storages/workspace.json` 為唯讀,僅取歸檔集合與工作區成員表。整理索引是非破壞性的:影子庫建置 → 原子切換 → 有界歸檔。行程內臂不建目錄、不跑 DDL、不寫 `meta`;資料庫 schema 與本套件預期不符時只報錯,絕不清庫。
可以在終端檢索,不開 Web 介面嗎?
dsh-tui 不載入外掛的 client 半邊(面板/卡片/設定頁),也呼叫不到外掛自有 RPC,但命令由外掛自己在宿主側註冊:`/sfind` 看檢索通道狀態,`/sfind <q>` 走標題模式,`/sfind <q> --content` 走內容模式(依 DRS 投影庫)。
07相關的 DSH 工作流程
dsh-univer-office
作者 dream-num
在 DSH 內預覽、建立與編輯表格、文件和幻燈片,由 Univer 驅動
clearai-dsh
作者 clearailhc
ClearAI:以本體為綱的原生 DSH 外掛 —— 經證據核驗的研究長成可瀏覽的領域本體。 · ClearAI: an ontology-first DSH agent preset — evidence-checked research that grows into a domain ontology.
dsh-fish-memory
作者 yuuyuko-uu
🐋 DSH 魚的記憶:給會話一份會淡忘的長期記憶,每條都帶時間。名字裡的「魚」來自 DeepSeek 的鯨魚。
dsh-trading
作者 zhu1090093659
基於 DeepSeek Harness 的智慧體原生交易終端,三欄介面聚合幣圈、美股、A股與港股,內建 19+ 可熱插拔聯結器,預設模擬交易並需人工確認。
08資料與來源
DSH 插件:**会话标题 / 内容全文检索**,自带独立 FTS5 索引;内容检索的语料与语义
dsh plugin --profile web add dsh-search-index
| **≥ 0.1.7** | 「插件页式」**主栏整页** |
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-15。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
