前言¶
在 DeepSeek Harness（DSH）里跑多任务、多工作区时，历史对话会分散在不同 session 里。仅靠当前聊天窗口翻页，很难快速找到某句关键词或某轮上下文。常见做法是手动切换任务、逐条浏览，成本高且容易漏掉跨会话的关联。dsh-chat-search 是面向 DSH Web 端的对话搜索插件，由维护者 helo060228 发布，在已登录的 DSH 宿主内提供全局跨会话检索与当前会话内实时搜索，并支持点击结果跳转、滚动定位与高亮。本文基于其 GitHub README 与 package.json 整理安装方式与用法要点。
这是什么¶
dsh-chat-search（DSH chat search plugin）的定位是：在 DSH 中做 global cross-session & in-chat search with context navigation——即跨任务/跨工作区扫描会话历史，以及在当前活跃会话内做关键词搜索，并带上下文片段与导航高亮。
- 维护者：helo060228
- 仓库：https://github.com/helo060228/dsh-chat-search
- 社区目录：https://www.skillhub.cn/plugins/helo060228/dsh-chat-search
- 分类（目录）：联网工具
- 当前包版本（package.json）：1.0.1
- 许可证：MIT
插件以 DSH 的 Cordis 补丁与 Web 客户端注入方式集成；dsh.client.platform 为 web，最低 DSH 版本为 0.2.1-rc.2。
核心功能¶
下列能力均来自官方 README 功能列表与安全说明，未另行扩展。
全局跨会话搜索¶
- 扫描多个工作区下的全部 task session 与历史记录。
- 按关键词提取匹配片段作为上下文摘要。
- 按 session 分组、可折叠展示命中；显示角色（user/assistant）、轮次索引与时间戳。
- 点击某条结果可自动切换到对应 session，并配合平滑滚动与高亮动画定位到目标消息。
当前会话内搜索（In-Chat Search）¶
在当前活跃 session 内实时搜索关键词；支持用快捷键在上一条/下一条匹配之间跳转。
上下文高亮与定位¶
通过多级 DOM 锚点解析（data-chat-anchor-key / data-chat-node-key / data-chat-turn），将视口滚动到目标消息，并用约 2.5 秒的脉冲描边动画（dsh_cs_flash）标出位置。
快捷键¶
| 操作 | 快捷键 |
|---|---|
| 打开全局搜索面板 | Ctrl + Shift + F 或 Alt + F |
| 打开当前会话内搜索 | Ctrl + F |
| 下一条 / 上一条匹配（当前聊天） | Enter / Shift + Enter |
| 关闭搜索面板 | Esc |
界面与主题¶
客户端使用 DSH 主题 CSS 变量，适配明暗模式；右下角提供玻璃态浮动搜索按钮（🔍）。
安全与兼容性¶
README 明确：1.0.1 需要 DSH 0.2.1-rc.2 或更高版本。搜索通过 DSH 受保护的 Connection Fetch 分发器注册，且仅限已认证的所有者访问；认证缺失或失败时，会在 session 发现或读取之前关闭访问，没有公开的 WebServer 路由回退。插件响应使用 Cache-Control: no-store，不附带跨域许可头，错误信息为通用表述，不包含内部路径或会话正文。浏览器端仍走同源请求与常规 DSH 登录流程。
更新插件后，需重新加载宿主并在浏览器中刷新以加载新代码。仓库提供 npm test 合成回归测试；说明中注明这些测试不使用个人聊天记录。
安装与启用¶
通过 DSH CLI 安装（命令摘自 README，勿自行改写仓库路径格式）：
dsh plugin --profile web add helo060228/dsh-chat-search
也可在 DSH Plugin Market 内直接搜索 dsh-chat-search 安装。
安装前建议自行查看仓库源码与 MIT 许可证；插件在当前 dsh 进程权限下运行，与宿主共享同一安全边界。
典型用法¶
安装并刷新 Web 宿主后，可按下面流程使用（与 README 描述一致，无额外配置项出现在已抓取资料中）。
- 跨会话找历史：按
Ctrl + Shift + F（或Alt + F）打开全局搜索，输入关键词，在分组结果中查看片段与角色/轮次/时间，点击条目跳转到对应 session 并高亮消息。 - 只在当前聊天里找：按
Ctrl + F打开会话内搜索，输入关键词；用Enter/Shift + Enter在匹配项间移动。 - 结束搜索：按
Esc关闭搜索面板。 - 入口：除快捷键外，可使用页面右下角搜索浮动按钮。
开发者本地验证插件逻辑时，可在插件目录执行：
npm test
适用场景与注意¶
适合：长期在 DSH Web 端维护多个任务与会话、需要按关键词回溯用户/助手发言、或要在当前长对话中快速定位某段内容的开发者与智能体使用者。
注意：
- 依赖 DSH Web profile；最低版本 0.2.1-rc.2，与 README 安全模型一致，未登录或非所有者无法通过插件路径读取会话。
- 社区目录（skillhub.cn）为独立插件索引，与 DeepSeek / 幻方无官方从属关系；星标与传播数据以各站点当时展示为准（目录线索中 GitHub 星标为 0）。
- 无已抓取资料中的额外环境变量或配置文件说明时，不必臆造配置项；以仓库
cordis.patch.yml与lib/为准做二次确认。
结尾¶
dsh-chat-search 把「跨 session 扫历史」和「当前聊天内搜关键词」收进同一套快捷键与 UI，并强调认证边界与 no-store 响应，适合作为 DSH「一切皆插件」生态里的一类联网/检索向工具。进一步了解可访问社区目录页 https://www.skillhub.cn/plugins/helo060228/dsh-chat-search 与 GitHub https://github.com/helo060228/dsh-chat-search 。
