前言¶
DeepSeek Harness 的侧边栏搜索目前仅能匹配会话标题和元数据。当对话历史较长或会话未被命名时，查找特定指令或回复会变得困难。dsh-session-search 插件通过在本地构建全文索引，解决了这一问题，允许你直接在消息正文中检索内容并跳转到具体位置。
插件介绍¶
这是一个隶属于「记忆」分类的 DeepSeek Harness 插件。它利用 MiniSearch 引擎在宿主机端构建索引，提供基于 Option+K 调色板的搜索体验，支持正则模糊匹配，并能直接定位到包含匹配文本的具体消息。
核心功能¶
- 全文检索：对每一轮会话的消息正文（包括用户的 Prompt 和助手的回复）进行索引。
- 本地索引：使用 MiniSearch 作为宿主机索引，无需上传数据。
- 快捷跳转：通过
Option+K打开搜索，选择结果后直接打开会话并滚动至目标消息。 - 结果分组：搜索结果按会话分组，按时间倒序排列，并高亮显示匹配的关键词。
- 隐私保护：无网络请求，无遥测数据，所有数据处理均在本地完成。
- 分支去重：自动处理 Fork 会话，避免重复索引。
安装与启用¶
在终端或命令行中执行以下命令安装：
dsh plugin --profile web add github:ivanearisty/dsh-session-search
安装完成后需要重启 Harness，宿主机会在启动时构建索引。插件会在「设置 → 插件」中显示一个名为 dsh-session-search 的卡片，并在 settings.yaml 中注册配置项。
使用方法¶
安装并重启后，通过以下快捷键进行操作：
⌥K/Alt+K：打开搜索面板。↑↓或Ctrl+N/Ctrl+P：在搜索结果中上下移动。↵（回车）：打开对应的会话，并滚动定位到匹配的消息。Esc：关闭搜索面板。
注意事项与配置¶
- 兼容性：当前版本针对 DeepSeek Harness
0.1.x（开发环境为0.1.1-rc.2）和webprofile。运行环境需为 Node.js^22.19 || >=24。 - 索引内容：目前仅索引纯文本内容。图片、工具调用参数和推理块不会参与索引。
- 快捷键固定：触发搜索的快捷键（
⌥K）在当前版本中不可重新绑定。 - 配置项：在
settings.yaml中可调整以下参数：
dsh-session-search:
resultLimit: 60 # 单次查询返回的最大结果数
indexAssistant: true # 是否索引助手的回复内容
- 权限：插件通过 Harness 的 session-store 服务读取本地会话日志，不会向外部发送任何数据。
总结¶
dsh-session-search 为 DeepSeek Harness 用户提供了一个轻量级、完全离线的会话全文检索方案。它弥补了原生侧边栏搜索在内容检索上的不足，适合需要在长对话历史中快速定位特定上下文的场景。
