前言¶
在使用 DeepSeek Harness 进行长对话时，经常会遇到需要回溯历史消息的情况。面对堆叠的上下文，手动滚动查找特定指令或回复非常低效。dsh-msg-index 插件旨在解决这个问题，通过提供一个悬浮的索引面板，帮助用户快速定位到当前会话中的任意一条用户消息。
插件简介¶
这是一个客户端插件，通过一个悬浮在对话窗口的类磨砂玻璃圆球，提供当前会话用户消息的索引和快速定位功能。
核心功能¶
- 消息索引：展开后列出当前会话的用户消息，包含编号和内容预览。
- 点击定位：点击索引条目，页面会平滑滚动到对应的消息位置。
- 搜索功能：支持按消息编号（数字）或内容（不区分大小写）实时搜索，并高亮匹配片段。
安装与启用¶
使用官方 CLI 安装最新版本：
dsh plugin --profile web add -w https://github.com/stnt04/dsh-msg-index/releases/latest/download/dsh-msg-index.tgz
安装后重启 dsh web。在对话窗口右下角即可看到悬浮圆球。
典型用法¶
- 展开索引：点击右下角的悬浮圆球展开当前会话的用户消息索引列表。
- 快速定位：点击列表中的任意条目，页面会平滑滚动到对应的消息。
- 加载历史：点击列表顶部的“加载更早消息”按钮，逐页加载未渲染的历史数据（插件不会一次性加载全部历史以避免卡顿）。
- 搜索高亮：使用标题栏的搜索框，输入编号或内容进行实时预览和高亮。
适用场景与注意事项¶
该插件适合需要在长对话中频繁查找特定指令或回复的用户。
在使用时需要注意以下几点：
* 依赖项：页面行定位依赖 DSH 运行时提供的 data-chat-anchor-key 属性与主滚动容器的 _scrollBody 类后缀。若 DSH 版本更新导致这些选择器失效，需同步调整。
* 项目性质：这是一个纯自用/留档项目，代码以满足“能跑”为标准。
* 性能影响：加载较多消息可能导致网页渲染变慢，但输入输出速度未受影响。
结语¶
该插件通过可视化的索引和定位功能，简化了长对话的导航过程。更多技术细节和使用反馈，请参考 GitHub 仓库。
