前言¶
在 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 仓库。
