前言¶
在 DeepSeek Harness（DSH）裏跑智能體，會話會跨工作區、跨天累積。想找回某次提問或某段回答，只能靠翻側欄、點進單條會話——沒有統一入口時，「記得寫過什麼、在哪個目錄下」往往不成體系。社區插件 dsh-super-search（維護者 pengfeis）在 Harness 保存的全部會話上提供全局搜索，且有意收窄檢索面：只索引用戶提問、助手回答和會話標題，不把推理塊、工具調用與輸出算進語料。下面介紹它是什麼、怎麼用，以及安裝與配置時要注意的點。
這是什麼¶
dsh-super-search 是 DSH 生態中的「記憶」類插件（目錄頁：skillhub.cn/plugins/pengfeis/dsh-super-search）。一句話定位：Global search over DeepSeek Harness conversations: user questions and assistant answers only——在 Harness 會話全局搜索，範圍僅限人與助手可見的對話正文和標題。
按設計排除的內容包括：
- 思考過程（reasoning）塊；
- 工具調用及其參數；
- 工具輸出；
- Harness 以 user 角色投遞的運行時通知（上下文、時間戳、技能目錄、後臺任務提示等）。
源碼與說明見 GitHub：github.com/pengfeis/dsh-super-search。當前資料中的包版本爲 1.1.2，許可證 MIT。
核心功能¶
三類入口¶
| 入口 | 作用 |
|---|---|
| 搜索面板 | ⌘⇧K 或側欄底部入口；可搜所有工作區的所有會話，回車跳到命中會話；範圍欄可收窄到某一工作區。 |
super_search 工具 |
智能體用相同規則檢索過往會話，支持跨會話；workspace 可限定目錄，傳 "all" 覆蓋全部工作區。 |
ctx.superSearch |
Host 側共用服務：search({ query, workspace?, sessionId?, limit? })，另有 workspaces()。 |
每次新打開搜索面板都會開始一輪全新搜索：上一次的關鍵詞、結果與仍在飛行中的請求不會殘留；面板已打開時再按 ⌘⇧K 則保留當前這一輪。
匹配與排序¶
- 英文詞可命中更長詞（如
install命中installation）；中文連續片段整段匹配，詞語不相鄰時通過相鄰字對匹配（如搜索插件可找到搜索會話插件）。 - 多詞默認 AND；無法全部命中時退化爲部分匹配並提示。
- 結果按得分排序，考慮詞頻與精確度、消息是提問還是回答、會話標題是否命中；標題與正文一併檢索。
- 匹配不區分大小寫。
搜索範圍¶
語料覆蓋本 Harness 下所有在線會話與已存儲會話、所有工作目錄。面板範圍欄、工具的 workspace 參數或 Host 的 workspace 可收窄範圍。工具默認 workspace 爲調用方智能體所在工作區；workspace: "all" 可搜全部工作區。
實現概要（便於排錯）¶
索引是會話日誌的派生緩存，日誌仍爲唯一事實來源；語料來自 ctx.sessions（在線）與 ctx.sessionPersistence（已存儲）。瀏覽器側請求 /api/super-search 與 /api/super-search/workspaces，經 ctx.connection.admit() 與主應用同一套瀏覽器鑑權。
安裝與啓用¶
插件在 Harness 進程內加載，安裝前宜自行閱讀倉庫源碼與 MIT 許可證，確認符合你對第三方插件的信任要求。
圖形界面：在 Plugins → Add plugin 中安裝並啓用；啓用後側欄底部出現搜索面板，快捷鍵 ⌘⇧K。已在打開的頁面需重新加載後纔會掛上客戶端模塊。
命令行 / 包規格（以 README 原文爲準）：
# 智能體側
plugin_manager install_bundle target=git+https://github.com/pengfeis/dsh-super-search.git#v1.1.2
# CLI
dsh plugin --profile <profile> add git+https://github.com/pengfeis/dsh-super-search.git
v1.1.2 Release 附帶 dsh-super-search-1.1.2.tgz 及 sha256，可供離線安裝。
典型用法¶
人在瀏覽器裏搜¶
- 啓用插件後，側欄底部打開搜索面板，或按
⌘⇧K。 - 輸入關鍵詞；需要時用範圍欄限定工作區。
- 在結果列表中選一條，回車進入對應會話。
智能體調用工具¶
智能體在對話中可調用 super_search，規則與面板一致。限定當前工作區時用默認 workspace；要跨全部工作區時傳 workspace: "all"。
Host 側編程調用¶
插件向 Host 暴露 ctx.superSearch，例如：
search({ query, workspace?, sessionId?, limit? })執行檢索；workspaces()列出可用工作區範圍。
未傳 limit 時，返回條數受插件配置 maxResults 約束（默認見下一節）。
配置¶
| 字段 | 默認值 | 含義 |
|---|---|---|
maxResults |
50 |
調用方未指定 limit 時，一次搜索返回的結果條數上限。 |
示例（README）：
- id: super-search
name: 'dsh-super-search'
config:
maxResults: 100
適用場景與注意¶
適合誰：長期在 DSH 中保留大量會話的開發者或智能體使用者，需要按關鍵詞找回「自己問過什麼、助手答過什麼」，或按標題定位會話，且不希望被工具軌跡和推理噪聲淹沒結果。
注意：
- 檢索面刻意變窄，查工具輸出或思考過程本插件不會覆蓋，需回到原會話日誌或其它能力。
- 插件與當前 DSH 進程權限一致，能訪問的會話範圍即 Harness 已加載與持久化的語料；跨機或未同步的目錄不在此索引內，除非它們屬於同一 Harness 實例的工作區模型。
- 社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；安裝來源以維護者倉庫與目錄頁說明爲準。
開發與維護者自測時，README 提供針對真實 session.jsonl 的測試命令；會話日誌路徑爲 $DSH_HOME/sessions/<工作區>/<會話 id>/session.v4.jsonl.zstd，可用 zstd -dc 解壓後餵給 node test/search.test.mjs 等腳本。
結尾¶
dsh-super-search 解決的是 Harness 多工作區、多會話下的「對話級」找回問題：面板快捷鍵、智能體工具與 Host API 共用同一套索引與匹配規則。需要安裝或查版本時，可看目錄頁 pengfeis/dsh-super-search，代碼與發行物在 GitHub 倉庫。
