前言¶

在本地使用 DeepSeek Harness（DSH）時，隨着會話數量的增加，檢索特定歷史記錄會變得困難。管理這些歷史數據，尤其是需要快速定位過去討論過的內容、代碼片段或決策記錄時，需要一個高效的檢索手段。dsh-session-search 插件解決了在本地所有會話中按關鍵詞進行全文搜索的問題。

插件簡介¶

dsh-session-search 是一個記憶類插件，用於在所有本地 DSH 會話中執行全文搜索。它支持 DSH 默認的 zstd 壓縮存儲格式和明文存儲格式。該插件由 uckkk 維護，使用 MIT 許可證。

核心功能¶

1. 關鍵詞全文搜索：輸入關鍵詞後，插件返回命中的會話信息（包括標題、ID、工作目錄）、命中行號以及具體的行內容。
2. 排序與範圍控制：結果按最近使用排序。默認掃描最近 20 個會話；通過 maxSessions 或 limit 參數可以調整掃描範圍。
3. 大小寫敏感度：搜索默認不區分大小寫；可通過配置項 caseSensitive 開啓區分大小寫模式。
4. 存儲格式支持：同時支持 zstd 壓縮的 .jsonl.zstd 文件和明文的 .jsonl 文件。

安裝與啓用¶

使用 DSH 的插件管理命令安裝此插件。以下命令將其添加到 web 配置文件中：

dsh plugin --profile web add dsh-session-search

安裝後，插件即可在當前 DSH 實例中生效。

典型用法¶

插件提供 session_search 工具，用於執行搜索操作。

• 基礎搜索：
  調用 session_search 並傳入關鍵詞，即可檢索所有本地會話。
• 指定搜索：
  在命令中傳入 query 參數進行精確搜索，例如：

    session_search query=<函數名>

• 使用場景：
  當需要找回之前討論過的內容或查找特定函數的上下文時，直接調用該命令即可。

技術細節¶

• 依賴關係：該插件爲純 Node 實現，運行時零第三方依賴。它使用 peer-only 依賴，隨 DSH 宿主加載。
• 許可證：MIT License © istone。

適用場景與注意¶

此插件適合需要在本地 DSH 歷史會話中快速檢索信息，尤其是涉及跨項目或跨會話的知識管理場景。安裝前建議查看源碼以確認其行爲符合預期。

結語¶

通過 dsh-session-search，可以更有效地管理本地會話歷史。更多細節和更新請參考其社區目錄或 GitHub 倉庫。

• 社區目錄
• GitHub 倉庫