前言¶
DeepSeek Harness（DSH）遵循“一切皆插件”的理念。在长对话中快速定位上下文或查看历史细节，是智能体开发中的常见需求。dsh-msgrail 是一款针对这一场景的客户端插件，它在对话区右侧边缘提供垂直分布的消息索引圆点，支持悬停预览与点击跳转。
插件定位¶
这是一款提供消息索引功能的轨道插件，由 futongxu9-maker 维护。它通过右缘圆点列展示对话结构，支持悬停预览、点击跳转及自动加载历史，且采用纯插件（shell.overlay）架构，不修改宿主代码，升级 DSH 无忧。
安装与启用¶
使用官方插件命令安装即可：
dsh plugin --profile web add github:futongxu9-maker/dsh-msgrail
安装完成后刷新页面，圆点列将自动出现在对话区右缘。
核心功能¶
该插件实现了以下核心能力：
- 消息索引：对话右缘显示垂直圆点列，每条真实用户消息对应一个圆点（自动排除插件注入的上下文节点）。
- 悬停预览：鼠标悬停时，圆点放大高亮，左侧弹出包含时间和文本的预览卡片，文本超过 3 行会自动省略，伴随淡入上浮动画。
- 点击跳转：点击圆点可跳转至对应消息。若该消息尚未加载，插件会自动触发“加载更早”操作，逐页追载直至目标消息。
- 全量历史：数据直接读取自会话日志，不依赖前端当前已加载的窗口内容，因此能索引所有历史记录。
- 皮肤适配：颜色完全基于 DSH 的语义 token，随 DeepSeek 主题或任意皮肤（如 Pinkie、龙裔）变化。
- 最新消息常亮：最新一条圆点会显示得更亮、更醒目。
- 滚动索引：当消息量巨大时，圆点列支持内部滚动，且上下两端有渐变淡出效果。
典型用法¶
在长对话中，使用滚轮在圆点列内部滚动即可快速浏览历史消息。悬停在某个圆点上，即可在左侧查看该消息的详细内容。点击圆点，如果消息在当前视图外，系统会自动加载历史并跳转过去。
适用场景与限制¶
该插件适合需要频繁在长对话中切换上下文的开发者。需要注意两点限制：首先，跳转到非常老的未加载历史时，受限于 DSH 前端分页机制（每次 50 条）和无虚拟滚动限制，可能需要逐页加载并伴随短暂卡顿；其次，圆点列锚定在对话区右缘，在窄窗口或超宽布局下位置可能偏右，建议在窗口宽度大于 800px 时使用。
结语¶
dsh-msgrail 为 DSH 用户提供了轻量级的导航辅助。插件源码与文档位于：GitHub，社区目录页面为：SkillHub。
