前言¶
DeepSeek Harness（DSH）的 Web 界面自帶側欄搜索（放大鏡）。在未啓用內容檢索後端時，該搜索通常只匹配會話標題與工作區名稱，無法按消息正文裏的詞句找回某次對話。官方文檔裏已有基於 SQLite FTS5 的 @deepseek-ai/dsh-session-query-sqlite 能力，但默認配置爲 openAt: never，即不自動打開全文索引。社區插件 dsh-session-fulltext-search 按後端文檔建議的方式部署該能力，並針對中文檢索補充子串回退，使側欄能搜到用戶消息與助手回覆正文。下面介紹插件定位、能力與安裝方式。
這是什麼¶
dsh-session-fulltext-search 是 DSH 社區插件，維護者爲 amd47802574，在 SkillHub 目錄中歸類爲「記憶」。一句話定位：在 Web 側欄啓用對會話歷史的全文搜索（SQLite FTS5），並對含 CJK 字符的查詢使用子串掃描，避免 FTS5 unicode61 分詞把連續中文當成單一 token 導致的漏檢問題。
核心功能¶
經 README 說明，安裝並重啓 DSH 後可獲得以下能力：
- 側欄放大鏡可跨工作區搜索消息正文（用戶消息與助手回覆），命中時展示內容片段。
- 對含中文等 CJK 的查詢走子串匹配，例如搜「福州大學」可以命中「已保研至福州大學」這類正文，而不必整段中文與分詞邊界對齊。
- 非 CJK 查詢仍使用 FTS5 分詞邏輯（例如
pytho不會匹配python，與 FTS5 行爲一致）。 - 索引在
$DSH_HOME下持久化，隨會話增長增量更新；插件將session-query-sqlite的openAt設爲first-search，在首次搜索時打開索引。
查詢細節（來自文檔 Notes）：
- 用引號包裹查詢（如
"two words"）可做短語檢索；FTS5 操作符（OR、*）會被當作普通文本。 - CJK 子串回退通過只讀 SQLite 連接讀取派生索引；索引缺失或重建中時，單次查詢可能結果偏少。
- 若你在 profile 的
cordis.patch.yml中手動覆蓋同層配置，後加載的 patch 仍優先於本插件。
當前 package 版本爲 0.2.2，許可證 MIT。
安裝與啓用¶
向指定 profile（示例爲 desktop）安裝：
dsh plugin --profile desktop add github:amd47802574/dsh-session-fulltext-search
dsh plugin add 會把包登記進 dsh.profile.bundles（patch 層棧）。安裝後需重啓 DSH。
手動等價方式：在 <profile>/package.json 中加入依賴並在 dsh.profile.bundles 中追加 bundle 名，於 profile 目錄執行 pnpm install 後重啓。字段示例見倉庫 README。
卸載：
dsh plugin --profile desktop remove dsh-session-fulltext-search
重啓後側欄恢復爲僅標題級搜索。派生索引文件 $DSH_HOME/session-query-index.sqlite3 可自行刪除；切勿將索引 path 指向會話持久化庫本身。
典型用法¶
無需單獨 CLI：重啓 DSH 後，在 Web 側欄使用放大鏡輸入關鍵詞即可。
- 搜英文或按 FTS5 分詞的短語：直接輸入；需要精確多詞短語時用引號包裹。
- 搜中文短語：直接輸入正文中的連續字串，插件會對 CJK 查詢走子串掃描。
- 若懷疑索引過舊或損壞：刪除
$DSH_HOME/session-query-index.sqlite3後再次搜索，觸發重建（索引爲派生數據）。
適用場景與注意¶
適合誰： 經常在多個工作區之間切換、需要按對話內容而非標題找回歷史記錄的 DSH 用戶；尤其依賴中文關鍵詞在消息正文裏檢索的場景。
運行與信任： 插件以當前 DSH 進程權限運行，會參與 Cordis patch 棧與索引路徑配置。安裝前建議在 GitHub 閱讀 cordis.patch.yml 與 lib/index.js，確認行爲與 MIT 許可證可接受。
生態說明： DSH 採用「一切皆插件」的擴展方式；SkillHub 等爲社區目錄站點，與 DeepSeek / 幻方無官方從屬關係，本文僅作技術介紹。
結尾¶
dsh-session-fulltext-search 解決的是 Web 側欄「只能搜標題、中文正文難命中」兩類問題：打開 FTS5 會話索引，併爲 CJK 查詢補上子串回退。目錄頁與源碼：
- SkillHub：https://www.skillhub.cn/plugins/amd47802574/dsh-session-fulltext-search
- GitHub：https://github.com/amd47802574/dsh-session-fulltext-search
