前言¶
在本地使用 DeepSeek Harness（DSH）时，随着会话数量的增加，检索特定历史记录会变得困难。管理这些历史数据，尤其是需要快速定位过去讨论过的内容、代码片段或决策记录时，需要一个高效的检索手段。dsh-session-search 插件解决了在本地所有会话中按关键词进行全文搜索的问题。
插件简介¶
dsh-session-search 是一个记忆类插件，用于在所有本地 DSH 会话中执行全文搜索。它支持 DSH 默认的 zstd 压缩存储格式和明文存储格式。该插件由 uckkk 维护，使用 MIT 许可证。
核心功能¶
- 关键词全文搜索：输入关键词后，插件返回命中的会话信息（包括标题、ID、工作目录）、命中行号以及具体的行内容。
- 排序与范围控制：结果按最近使用排序。默认扫描最近 20 个会话；通过
maxSessions或limit参数可以调整扫描范围。 - 大小写敏感度：搜索默认不区分大小写；可通过配置项
caseSensitive开启区分大小写模式。 - 存储格式支持：同时支持 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 仓库。
