返回目錄

dsh-search-index

精選清單收錄維護狀態: 活躍

drscrewdriver/dsh-search-index

給 DeepSeek Harness 側邊欄加一個會話內容檢索——標題/內容一鍵切換,還能按使用者/回覆/工具篩選

前往 GitHub
$ dsh plugin --profile web add dsh-search-index

10

星數

3

Fork

JavaScript

語言

MIT

授權條款

2026-08-19

建立於

2026-11-18

最近推送

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 明寫「必須重啟宿主行程」

安裝步驟

  1. 01

    執行 `dsh plugin --profile web add dsh-search-index`(同一條命令也可用本機 `.tgz` 路徑取代套件名稱)

    $ dsh plugin --profile web add dsh-search-index

  2. 02

    重啟宿主行程;DRS 未啟用前內容檢索不可用,標題面仍可用

  3. 03

    若設定卡提示 DRS 未啟用,執行 `dsh plugin --profile <name> add dsh-reference-session-collector` 後重啟宿主

    $ dsh plugin --profile <name> add dsh-reference-session-collector

  4. 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 外掛:以 `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 是安全的。
2026-08-192026-11-10v0.7.18

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 投影庫)。

08資料與來源

  • 作者聲明github.com5e989ae7d15a…

    DSH 插件:**会话标题 / 内容全文检索**,自带独立 FTS5 索引;内容检索的语料与语义

  • 作者聲明github.com5e989ae7d15a…

    dsh plugin --profile web add dsh-search-index

  • 作者聲明github.com5e989ae7d15a…

    | **≥ 0.1.7** | 「插件页式」**主栏整页** |

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-15。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。