DeepSeek Harness plugin

dsh-message-finder

DSH 会话内消息搜索:搜索历史消息并点击跳转定位(ChatGPT 式小地图)

Jump to install

Source facts

Repository
cransmathenia666-hash/dsh-message-finder
Latest update
Aug 19, 2026
Category
Memory
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/cransmathenia666-hash/dsh-message-finder
Plugin: dsh-message-finder
Author: cransmathenia666-hash

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer2 files
README.mdSource · read only

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.yamlallowBuilds 中再执行一次即可;prepare 脚本会自动执行 npm run build 产出 lib/。当前临时 profile dshmf-test 仅用于本地装配验证,可随时 rm -rf ~/.dsh/profiles/dshmf-test 移除。

它怎么工作的(写给好奇的人)

  • 数据:conversation.session.header.utilities Slot 的 React 组件通过 useSession() 拿到官方 ConversationSnapshot,从 chat.order + chat.nodesnodes(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