前言¶
在 DeepSeek Harness（DSH）里长时间对话后，想找回某段说过的话，往往只能手动翻历史。宿主侧若已有全文索引，更适合做成「输入关键词 → 列出命中 → 点开跳到位置」，而不是再叠一层归档浏览器或侧栏改造。下面介绍社区插件 dsh-simple-search（维护者 luicarstar，社区目录分类为「记忆」）：它只做会话正文搜索，入口是会话头部一个按钮和一个查询框，点结果即可定位到命中处。
这是什么¶
dsh-simple-search 是 DSH 的一个极小客户端插件（版本 0.1.0，MIT 许可）。定位可以概括为 README 中的说明：Content-only session search for DeepSeek Harness: one header button, one query box, jump to the hit.
它不提供的功能同样明确：没有归档浏览器、没有侧栏改造、没有设置页、也没有第二种搜索模式。
核心功能¶
入口与搜索¶
- 入口在会话头部操作区（复制按钮旁）的搜索按钮。
- 输入即搜，280ms 防抖，调用宿主 API
ctx.sessions.search(query, signal)，使用宿主 FTS 索引。 - 结果列表展示：命中片段（关键词黄色高亮）+ 会话短 id。
交互¶
- ↑ / ↓ 选择条目，Enter 打开，Esc 关闭，点击空白处关闭。
- 打开会话后自动滚动到命中文本位置，并对该处闪烁约 2.6 秒。
定位边界（使用前需知晓）¶
- 命中落在尚未加载的历史页时，插件会先把会话视口顶到起点以触发分页加载，并在 600 / 1300 / 2200 / 3400ms 重试；若仍无法定位，会恢复原来的滚动位置。
- 命中在折叠的 thinking / 工具输出内时，只跳过不可见节点，不会自动展开。
- 对极短且高频的词，会跳到第一个命中，而不是结果列表里当前选中的那一条。
与 DSH 的衔接（0.2.1-rc.5 实测）¶
插件针对 0.2.1-rc.5 的客户端 Slot 契约编写，主要依赖包括：
| 依赖 | 说明 |
|---|---|
ctx.sessions.search(query, signal) |
返回 { ok, value: { items, hasMore } }，item 为 { sessionId, snippet } |
ctx.uiWorkspace.openSession(id) |
打开会话 |
ctx.slots.inject("conversation.session.header.actions", ...) |
注入头部按钮 |
ctx.locale.register + ctx.locale.bind |
自行 bind 后经 inject 传入文案 |
定位实现不依赖 CSS Module 类名，使用 rc.5 的稳定属性 data-chat-flow / data-chat-turn。
安装与启用¶
插件通过 plugin_manager 从本地目录安装（将 <本目录绝对路径> 换为你 clone 或解压后的插件根目录）。安装命令以仓库 README 为准：
plugin_manager({ action: "install_bundle", target: "<本目录绝对路径>" })
安装后若该插件行的 fiberPhase 不是 active，需要再启用一次：
plugin_manager({ action: "set_plugin", target: "include:simple-search", enabled: true })
README 说明：客户端半区由 dsh-client-hmr 热更新，主进程无需重启。
仓库内结构简要如下，便于核对安装的是完整包：
package.json dsh.bundle.patch + dsh.client.inject 声明
cordis.patch.yml 唯一一行：include:simple-search
lib/index.js Host 半区空实现（Loader 行要求）
lib/client.js 全部功能（ModuleLoader 格式）
典型用法¶
- 在 DSH 中打开任意会话，在头部操作区点击搜索按钮。
- 在查询框输入要找的关键词，等待防抖后的结果列表。
- 用方向键选中条目，Enter 或点击打开对应会话；界面会滚动并高亮闪烁命中位置。
- 搜完按 Esc 或点空白处关闭搜索层。
适用场景与注意¶
适合：需要在当前 DSH 工作区内快速检索全部会话正文，并一键跳转到命中片段的开发者或日常重度使用者；与目录「记忆」分类一致，侧重「找回说过什么」，而非文件系统或外部知识库。
注意：
- 插件以当前 DSH 进程的权限运行；安装前应阅读 GitHub 源码 与 MIT 许可证，自行判断是否信任维护者 luicarstar 的代码。
- 兼容性说明基于 0.2.1-rc.5；其它 DSH 版本若 Slot 或
sessions.search行为不同，可能需要自行验证。 - 社区插件目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系；星标等元数据以目录页为准（当前为 0）。
结尾¶
dsh-simple-search 把 DSH 里「找会话里说过的话」收成头部一个按钮和一条搜索框：借宿主 FTS，少 UI、少配置。需要安装步骤与行为细节时，可看社区目录页与 GitHub 仓库 README。
- 目录页：https://www.skillhub.cn/plugins/luicarstar/dsh-simple-search
- GitHub：https://github.com/luicarstar/dsh-simple-search
