dsh-message-finder
> 长会话动辄上百轮,回找自己说过的一句话只能疯狂滚屏?把会话变成一张小地图,点哪里跳哪里。
ChatGPT-style in-conversation message search for DeepSeek Harness (dsh) Web GUI. 纯前端插件,零 host 依赖。
它解决什么问题
用 dsh 写代码、查资料的时候,一个会话会拉得很长。你突然想起「前面是不是提过那个方案」「它当时是怎么回的」,只能手动往上滚,滚半天还容易滚过头。这个插件把当前会话折叠成一张对话小地图钉在窗口右缘:
- 一眼看到整场对话的轮廓——按「轮」聚合(你发一条 → agent 整轮回复),不是逐条消息堆砌
- 点任意一条摘要,对话流直接滚动到那条消息并高亮
- 记不清原文?
Ctrl+K全文搜索,搜你和助手的每一句话(含 reasoning)
> 📷 演示动图待补充:展开大纲 → 点击某轮 → 对话流跳转高亮(30 秒以内,仓库首页最缺的就是这个)
功能
- 🔍 会话内全文搜索:匹配当前会话已加载窗口内所有用户消息与助手回复(含 reasoning 内容)
- 🎯 点击即达:选中结果立即滚动定位到对话流对应消息节点,并短暂高亮
- 🗺 常驻消息大纲:右缘一列逐条列出消息摘要,点击直达;可收起成一条带刻度的窄条,刻度也支持点击跳转
- 🧭 回到最新:一键滚回对话最底部
- ⌨️ 快捷键:
Ctrl+K开/关搜索,Esc关闭,↑/↓/Enter键盘导航,中文输入法组合键不会误触发 - 🏷 筛选:全部 / 我发的 / 助手回复,排序方向可切换
- 📦 零 host 依赖:数据全部来自客户端会话快照(官方
ConversationSnapshot),视觉跟随 DSH 主题令牌,深浅色自动适配
安装(原生 dsh 插件)
改造后已是标准的 DSH bundle(dsh.bundle.patch + dsh.client),直接用官方 dsh plugin 命令安装即可,不再需要任何自定义注入器。
方式一:从 Git 仓库安装(推荐)
# web 是 Web GUI 的 profile 名
dsh plugin --profile web add git+https://github.com/cransmathenia666-hash/dsh-message-finder.git装完重启 dsh web:会话头部出现搜索按钮(Ctrl+K),右缘是常驻会话大纲(小地图)。
方式二:从本地目录安装(开发调试)
dsh plugin --profile web add D:/path/to/dsh-message-finder卸载
dsh plugin --profile web remove @dsh-external/dsh-message-finder> 说明:dsh plugin 底层用 pnpm 管理。从 Git 安装时若 pnpm 提示某个构建脚本被阻止,把提示里给出的 key 加到 profile 的 pnpm-workspace.yaml 的 allowBuilds 中再执行一次即可;prepare 脚本会自动执行 npm run build 产出 lib/。当前临时 profile dshmf-test 仅用于本地装配验证,可随时 rm -rf ~/.dsh/profiles/dshmf-test 移除。
它怎么工作的(写给好奇的人)
- 数据:
conversation.session.header.utilitiesSlot 的 React 组件通过useSession()拿到官方ConversationSnapshot,从chat.order+chat.nodes与nodes(UserMessageNode / AssistantMessageNode)构建消息索引(key / kind / seq / time / text),灌入插件自有的共享 store - 界面:
shell.overlaySlot 渲染浮层面板,消费 store 做过滤与排序 - 定位:官方 ChatView 每个消息节点带
data-chat-flow-key属性,点击结果后scrollIntoView并加短暂高亮 class - 生命周期:全部通过
ctx.effect管理(样式、Slot 注册、快捷键监听),卸载即净
已知限制(说实话的时间)
- 索引与搜索范围 = 当前已加载的会话窗口;更早的历史可通过官方「加载更早」滚动后重建索引,折叠区/窗口外的消息会定位到最近的可见位置并提示
- 当前聚焦单会话内搜索;跨会话全局搜索(host
sessions.search索引)是下一步
兼容性
- DeepSeek Harness Web GUI(
dsh web),2026-08 developer preview 版本 - 依赖官方 Slot:
conversation.session.header.utilities/shell.overlay(若未来官方移除这些 seat 需适配)
License
BSD-3-Clause