前言¶
在 DeepSeek Harness (DSH) 構建的智能體系統中，歸檔的會話轉錄是重要的長期記憶。當數據量增加時，如何快速定位歷史對話中的特定信息成爲痛點。dsh-plugin-transcript-search 插件通過讀取 dsh-plugin-transcript 生成的 JSONL 邊車文件，爲這些歸檔數據提供了全文檢索能力。
簡介¶
這是一個專注于歸檔會話轉錄全文搜索的 DSH 插件。它直接讀取 dsh-plugin-transcript 插件輸出的 JSONL 邊車數據，不依賴其他插件導入。插件由 121212165 維護，採用 MIT 開源協議。
核心功能¶
- 多關鍵詞 AND 搜索：支持輸入多個關鍵詞，系統會查找同時包含這些詞的會話記錄。
- 按會話分組與排序：搜索結果按會話分組，並可根據命中數量進行排序。
- 命中位置摘錄：對命中內容進行上下文截斷摘錄，方便快速預覽。
- session_search 模型工具：爲 Agent 提供自動查詢歷史對話的工具。
- 容錯處理：支持空查詢、無命中、缺目錄或文件行損壞等異常情況，不會導致程序崩潰。
安裝與配置¶
安裝過程分爲三步。
- 安裝插件包
執行以下命令將插件安裝到指定的 profile：
dsh plugin --profile web add github:121212165/dsh-plugin-transcript-search
-
合併配置文件
將插件倉庫根目錄下的cordis.patch.yml內容合併到$DSH_HOME/profiles/web/cordis.patch.yml中。
注意：不要直接追加。由於該文件默認爲空數組，應將insert條目放入同一個數組，否則會導致 YAML 解析錯誤，報錯failed to parse overlay ... end of the stream or a document separator is expected。 -
重啓服務
重啓 dsh。配置層與 client 均需要重啓才能使配置生效（客戶端按啓動時算出的內容下發，硬刷新瀏覽器無效）。
使用方法¶
- 命令行搜索：在對話中輸入
/find 關鍵詞1 關鍵詞2進行檢索。 - 工具調用：使用
session_search模型工具查詢歷史對話。
注意事項¶
- 建議與
dsh-plugin-transcript一起安裝以獲取數據。 - 安裝後需重啓 dsh。
- 配置修改後需重啓生效。
- 需正確合併
cordis.patch.yml配置。 - 未在運行中的 dsh 裏進行 live mount 驗證。
總結¶
該插件爲 DSH 環境下的歷史對話檢索提供了基礎能力。開發者可以通過簡單的命令或工具調用，快速在歸檔數據中定位信息。更多細節可參考其 GitHub 倉庫。
