cransmathenia666-hash / dsh-message-finder

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-super-injector（开发环境，推荐）

dsh 环境内自带 dev_inject_plugin / dev_uninject_plugin 工具（超级模组注入器）：

npm install --no-audit --no-fund --legacy-peer-deps   # 首次安装 typescript / tsdown
./scripts/build.sh                                     # host: tsc；client: tsdown → lib/
dev_inject_plugin <本目录>                             # 注入运行
dev_uninject_plugin dsh-message-finder                 # 卸载

方式二：手动放入插件目录

把 lib/ 与 package.json 放入 dsh 插件的 node_modules（如 ~/.dsh/profiles/web/node_modules/@dsh-external/dsh-message-finder），在 profile 的 bundles 中声明后重启 dsh。

方式三：Release 安装包

GitHub Release 页面下载 dsh-external-dsh-message-finder-0.0.1.tgz（29.5 kB）。

它怎么工作的（写给好奇的人）

• 数据：conversation.session.header.utilities Slot 的 React 组件通过 useSession() 拿到官方 ConversationSnapshot，从 chat.order + chat.nodes 与 nodes（UserMessageNode / AssistantMessageNode）构建消息索引（key / kind / seq / time / text），灌入插件自有的共享 store
• 界面：shell.overlay Slot 渲染浮层面板，消费 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