前言¶
用 DeepSeek Harness（DSH）的 web profile 時，側邊欄通常用來找歷史會話。標題搜索可以按目錄找，但如果你要定位某句話、某次工具調用或某段回覆，就需要內容檢索。
DSH 的理念是「一切皆插件」。dsh-session-search-toggle 就是在 DSH web 側邊欄增加一個“搜索”入口，讓標題搜索和內容搜索在同一個浮層裏切換，並支持按用戶、回覆、工具篩選內容命中。
這是什麼¶
dsh-session-search-toggle 是 drscrewdriver 維護的 DSH 插件，許可證爲 MIT。
它面向已安裝 DeepSeek Harness 並使用 web profile 的用戶，在不改官方源碼、不建派生庫的前提下，通過 DSH 現成的 sessionQuery 服務提供會話搜索增強。
核心功能¶
標題搜索與內容搜索¶
插件在 DSH web 側邊欄底部新增“搜索”入口。點擊後會打開浮層面板，面板裏可以在標題搜索和內容搜索之間切換。
標題模式按會話標題或工作目錄子串做即時過濾。
內容模式複用 DSH 自帶的 FTS5 全文索引，搜索會話消息正文。
內容結果按會話聚合¶
內容搜索的結果按會話聚合展示，不逐條堆消息。
每個會話一行，展示會話標題、最強命中片段和類型標籤。
內容類型篩選¶
內容模式提供以下篩選：
- 全部
- 用戶
- 回覆
- 工具
其中“工具”篩選覆蓋 tool/call 與 tool/result。
索引可用性提示¶
插件會在 Host 側通過 search-status 探測 sessionQuery 全文索引是否開啓。
如果全文索引未開啓，內容模式會給出配置指引；標題模式不受影響。
設置與結果定位¶
設置頁在“通用”裏新增“會話搜索”配置行，支持啓用開關和默認搜索模式。
搜索結果點擊後，會打開對應會話，並定位到命中內容所在上下文。
安裝與啓用¶
安裝插件¶
從 GitHub 直裝穩定版：
dsh plugin --profile web add github:drscrewdriver/dsh-session-search-toggle#release-v0.1.0
如果需要使用基線或開發分支，也可以分別安裝：
dsh plugin --profile web add github:drscrewdriver/dsh-session-search-toggle#master
dsh plugin --profile web add github:drscrewdriver/dsh-session-search-toggle#feat/type-filter-search
資料中給出多個可安裝分支，具體選擇分支應按使用場景決定。
重啓 DSH web¶
運行中實例不熱載 bundle 層，安裝後必須重啓 DSH web：
dsh web
也可以使用隨包腳本：
bash ~/.dsh/profiles/web/node_modules/dsh-session-search-toggle/restart-dsh-web.sh
開啓內容搜索所需的全文索引¶
DSH 官方 bundle 默認關閉全文索引，內容搜索需要覆蓋 session-query-sqlite 的 path 和 openAt。
可在 profile 的 cordis.patch.yml 或 overlay 中加入：
- id: session-query-sqlite
config:
path: ':memory:'
openAt: first-search
保存後重啓 DSH web。
未開啓全文索引時，內容模式會顯示配置指引，標題模式仍可使用。
典型用法¶
1、安裝插件並重啓 DSH web 後，側邊欄底部會出現“搜索”入口。
2、點擊“搜索”，打開浮層面板。
3、切到標題模式，輸入會話標題或工作目錄子串，查看過濾結果。
4、切到內容模式，輸入關鍵詞，再選擇 全部、用戶、回覆 或 工具 進行篩選。
5、查看按會話聚合的結果，包括會話標題、最強命中片段和類型標籤。
6、點擊某條結果，打開對應會話並定位到命中內容所在上下文。
適用場景與注意¶
- 需要已安裝 DeepSeek Harness，並使用 web profile。
- GitHub 直裝需要能連通
github.com；網絡受限時需配置可用代理或鏡像加速。 - 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。 - 許可證爲 MIT。
- 不改任何官方源碼、不建派生庫，數據經 DSH 現成
sessionQuery服務。 - 配置僅存於 DSH settings 命名空間與瀏覽器浮層狀態。
- 不讀取、不上傳會話內容以外的數據。
- 宿主 HTTP 路由
/switch-search/api的瀏覽器信任圍欄與 DSH/api網關一致，拒絕 cross-site。
結尾¶
dsh-session-search-toggle 把 DSH web 側邊欄的會話檢索補成標題和內容兩種模式，並加入用戶、回覆、工具的內容篩選。適合需要在 DSH web 裏快速查找歷史會話、工具調用和上下文片段的場景。
社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。資料中給出的目錄頁：
https://www.skillhub.cn/plugins/drscrewdriver/dsh-session-search-toggle
GitHub 倉庫：
https://github.com/drscrewdriver/dsh-session-search-toggle
