前言¶
用 DeepSeek Harness（DSH）做智能体开发或长对话调试时，会话一多、单条对话一长，靠肉眼翻左侧列表很难找回某句配置、某次工具输出或某段报错。客户端自带的浏览方式通常要先打开会话再上下滚动，跨会话检索更费时间。下面介绍社区插件 dsh-conversation-search（维护者 itstartstosnow）：在桌面端 Web GUI 里做全会话全文搜索，并在当前对话内提供类似编辑器的查找条，点结果即可跳到对应消息。
这是什么¶
dsh-conversation-search 是 DSH 的会话全文搜索插件（npm 包名 @itstartstosnow/dsh-conversation-search，当前版本 0.1.1，MIT 许可证）。它通过 Cordis patch 注入左侧栏「搜索会话」面板，并接管对话内的 Cmd+F / Ctrl+F 查找体验：一边搜所有会话的内容，一边在当前会话里上下翻命中并高亮。
插件以 DSH 插件机制运行，需 DeepSeek Harness 桌面客户端 0.2.1-rc.3 或更新（见 package.json 中 dsh.engines.dsh）。社区目录页：skillhub.cn/plugins/itstartstosnow/dsh-conversation-search；源码与说明：GitHub 仓库。SkillHub 为独立社区目录，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
左侧栏：搜索全部会话¶
输入关键词即可检索全部对话，无需先打开某个会话。结果按会话分组，展示命中片段与高亮；点会话标题可展开该会话下的全部命中位置。点任意一条命中会打开对应会话并落到那句话；若历史很深，加载过程有进度提示，也可取消。直接点会话行则跳到该会话的第一条命中。
默认搜索范围是用户提问与助手回复的文字。点搜索框右侧「范围」，可额外纳入工具输出或思考过程。
对话内查找条¶
在当前会话内用查找条上下浏览命中，黄色高亮标出位置，并显示「当前/总数」计数。
| 操作 | 快捷键 |
|---|---|
| 打开查找条 | Cmd+F（Windows / Linux：Ctrl+F） |
| 下一个 / 上一个 | Enter / Shift+Enter |
| 关闭 | Esc |
打开查找条时会自动加载完整会话，因此很早的消息也能搜到；加载期间查找条下方有提示，不影响继续输入。「Aa」开关区分大小写；「全词」只匹配完整英文单词（两侧不能是字母、数字或下划线，例如全词 foo 不会命中 foobar）。中文无词边界，全词对中文不产生额外限制。
中英文、数字与 emoji 均可搜索；英文默认不区分大小写。
索引与跳转¶
索引缓存在 ~/.dsh/cache/dsh-conversation-search/，自动保持更新，不修改会话源文件。面板顶部提供「重建索引」用于手动重建。
安装与启用¶
环境：DeepSeek Harness 桌面客户端 ≥ 0.2.1-rc.3。
推荐通过 npm 包名安装，在 Harness 对话中让 Agent 执行（或按你环境支持的等价插件管理入口）：
plugin_manager install_bundle target: @itstartstosnow/dsh-conversation-search
若已有插件源码目录，也可指定本机绝对路径：
plugin_manager install_bundle target: /absolute/path/to/dsh-conversation-search
亦可在 Harness 插件管理界面从本地目录安装。安装成功后左侧栏应出现「搜索会话」，一般无需重启；若未出现，刷新页面或重新打开 Harness。
卸载并恢复官方搜索与快捷键：
plugin_manager remove_bundle target: @itstartstosnow/dsh-conversation-search
安装前建议自行查看仓库源码与 MIT 许可证；插件与当前 DSH 进程同权限运行，只安装你信任的来源。
典型用法¶
跨会话找一句配置或回复¶
- 点左侧栏「搜索会话」，输入关键词。
- 在分组结果中点会话标题展开全部命中，点某条片段打开会话并定位到该消息；或点会话行跳到第一条命中。
- 需要搜工具输出或思考过程时，在「范围」中勾选相应类型。
在当前对话里精确定位¶
- 打开目标会话，按
Cmd+F或Ctrl+F打开查找条。 - 输入关键词，用
Enter/Shift+Enter在命中间切换。 - 需要严格匹配英文单词或大小时，打开「Aa」或「全词」。
可选：高亮颜色¶
默认荧光笔黄色（普通命中淡黄、当前命中亮黄、跳转落位琥珀色描边）。在开发者工具控制台写入后刷新页面即可覆盖：
localStorage.setItem('dsh-conversation-search.highlight', JSON.stringify({
matchBg: 'rgba(255, 212, 32, 0.45)', // 普通命中
currentBg: '#ffd43b', // 当前命中
currentFg: '#241d00', // 当前命中文字色
flash: '#f5a623', // 跳转落位描边
}));
适用场景与注意¶
适合谁：长期在 DSH 里维护多会话、需要按关键词回溯配置、报错或某轮 Agent 回复的开发者；需要在单条长对话里快速跳转多处命中的场景。
使用时需知：
- 工具输出的完整正文在官方「查看」详情里；对话界面只显示紧凑工具行，因此搜到工具内容时会定位到对应工具调用行。
- 页内查找只匹配已渲染的文字：折叠的思考过程、未展开的工具卡片不会被查找条命中；从全局搜索跳转时会自动展开目标块。
实现细节与索引契约见仓库内 docs/development.md、docs/api-contract.md；维护者用 node --test 跑测试（README 记载 87 条）。
结尾¶
dsh-conversation-search 把「找一句说过的话」拆成两层：左侧栏扫全会话并一键跳转，对话内查找条补当前会话的细粒度翻查。若你在 DSH 插件生态里补齐检索能力，可从社区目录或 GitHub 获取 @itstartstosnow/dsh-conversation-search 并按上文 plugin_manager install_bundle 安装。
- 目录页：https://www.skillhub.cn/plugins/itstartstosnow/dsh-conversation-search
- GitHub：https://github.com/itstartstosnow/dsh-conversation-search
