前言¶
DeepSeek Harness（DSH）遵循“一切皆插件”的理念，社区生态丰富。在智能体开发或调试过程中，面对动辄数百条记录的对话，在 Web GUI 中快速定位特定内容（如某条工具调用、特定错误或用户指令）往往依赖浏览器自带的查找功能，体验有限。dsh-client-ui-session-search 插件在会话标题栏提供了搜索入口，对当前会话的全部历史节点进行全文检索，支持键盘操作和精确跳转。
这是什么¶
这是一个 In-session full-text search client plugin for the DeepSeek Harness web GUI（会话内全文搜索客户端插件）。插件覆盖全部历史记录，支持类型过滤、多关键词 AND 匹配和键盘导航。插件由 2275803244-cpu 维护，开源协议为 MIT。
核心功能¶
插件提供以下能力：
- 全文搜索：支持用户消息、AI 回复、工具调用（名称、参数、结果）、命令、压缩摘要、错误、重试等节点类型的文本检索。
- 多关键词 AND：输入空格分隔的多个词，全部命中才算匹配（例如输入“插件 搜索”，需同时包含这两个词）。
- 类型过滤：支持按全部/我/AI/工具/命令/错误/其他进行筛选，并附带实时计数。
- 键盘导航：使用
↑/↓键选择结果，Enter键跳转，Esc键关闭搜索框。 - 一键复制：鼠标悬停在结果上时，会出现“复制”按钮，可复制该节点的完整文本。
- 结果计数：搜索框内显示“N 条结果”。
- 全命中高亮：在搜索片段内，所有匹配的词都会标亮显示。
- 跳转定位：点击结果后，视图会平滑滚动到目标消息，目标消息会有蓝色描边持续 1.6 秒。
- 槽位集成：挂载于
conversation.session.header.actions（order=30），与后台任务列表并列。
安装与启用¶
插件同时支持 CLI / Web 版（web profile）与 桌面版（desktop profile）。安装或更新后必须重启程序，因为 bundle rev 会在启动时哈希进 boot 图。
CLI / Web 版安装命令：
dsh plugin --profile web add github:2275803244-cpu/dsh-session-search
桌面版安装命令：
桌面版默认不包含该插件，需手动添加。桌面应用自带 CLI，位于 <安装目录>\resources\runtime\cli\bin\dsh.cmd。
& "<桌面版安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add github:2275803244-cpu/dsh-session-search
注意事项：
* 桌面版需 @deepseek-ai/dsh-desktop-runtime 0.2.0-rc.2 及以上版本支持。
* 安装完成后请重启对应程序（Web 端重启 dsh web，桌面版重启应用）。
典型用法¶
- 触发搜索：点击会话标题栏右侧的 🔍 按钮。
- 输入关键词：输入空格分隔的多个词进行多关键词 AND 搜索（如
插件 搜索）。 - 选择与跳转：使用键盘
↑/↓选择结果，Enter键跳转定位。 - 复制文本：鼠标悬停在某条结果上，点击出现的“复制”按钮。
适用场景与注意¶
- 适用场景：适合 DSH Web GUI 用户和桌面版用户，用于快速在海量对话中定位特定信息，提高调试和智能体开发效率。
- 权限与安全：插件以当前 DSH 进程的权限运行。在安装前，建议检查插件源码与许可证（MIT）。
- 技术实现：插件为纯浏览器侧实现，不依赖服务端全文搜索能力。
- 依赖关系：桌面版依赖
react和react/jsx-runtime，与 DSH 内部包解耦。
结语¶
该插件通过浏览器端实现的全文检索能力，填补了 Web GUI 在会话内快速定位信息的空白。对于需要频繁查阅长对话细节的开发者，能够显著提升操作效率。
