dsh-message-preview
DeepSeek Harness Web UI 的右侧消息导航条。它为当前会话中的每条用户消息生成一个导航块，可悬停预览、显示当前阅读位置，并点击跳转到对应消息。
> Right-side user-message navigator for the DeepSeek Harness Web UI, with hover previews, reading-position tracking, and click-to-jump navigation.
功能
- 只索引用户直接发送的消息，排除工具通知、后台任务和注入上下文。
- 当前阅读位置随会话滚动自动高亮。
- 悬停显示消息序号、相对时间和文本预览。
- 点击后自动加载较早的会话历史，平滑滚动并高亮目标消息。
- 导航块会根据消息数量和文本长度自适应排布；少于两条用户消息时自动隐藏。
- 默认仅显示当前位置指示，鼠标靠近会话右侧时展开完整导航条。
- 中英文界面文案随 DSH locale 自动切换。
安装
要求：
- DeepSeek Harness
0.1.0-rc.6或更高版本 - Node.js 22 或更高版本
从 GitHub 安装：
dsh plugin --profile web add "github:asukasec/dsh-message-preview#main"
安装完成后完整重启 Web UI：
dsh web
也可以克隆仓库后从本地目录安装：
git clone https://github.com/asukasec/dsh-message-preview.git
cd dsh-message-preview
dsh plugin --profile web add .
Windows 用户还可以在克隆后的目录中双击 install.cmd。该脚本会定位 DSH_HOME、复制插件，并以幂等方式更新指定 profile 的 cordis.patch.yml：
.\install.ps1 -Profile web -DshHome "D:\path\to\dsh-data"
使用
打开至少包含两条用户消息的会话。会话右侧会显示一枚当前位置指示；将鼠标移到右缘即可展开导航条。
- 悬停导航块：查看消息序号、发送时间和文本预览。
- 点击导航块：跳转到该条用户消息。
- 滚动会话：高亮块会跟随当前阅读位置。
- 键盘导航：按
Tab聚焦当前位置，使用↑/↓、Home/End选取消息，按Enter跳转。
插件没有设置项，安装后即可使用。
工作原理
插件由宿主端和浏览器端两部分组成：
| 部分 | 文件 | 作用 |
|---|---|---|
| 宿主端 | lib/index.js |
注册 dshMessagePreview 会话投影，维护用户消息的序号、时间、短预览和持久 ID。 |
| 浏览器端 | lib/client.js |
挂载到 conversation.input.dock，通过 React Portal 渲染导航条，并负责预览、滚动定位和历史补载。 |
| Bundle | cordis.patch.yml |
让 dsh plugin add 自动把插件加载到 Web profile。 |
数据按以下优先级获取：
- 宿主端
dshMessagePreview投影，提供完整且轻量的消息索引。 - 当前已加载的会话节点，用于首屏回退。
- 投影尚未就绪时，通过
loadOlder()补载更早的历史。
插件不会向第三方服务发送请求，也不会修改会话内容。消息预览只在本地 DSH 进程和浏览器之间传递，宿主端预览最多保留 80 个字符。
卸载
如果使用 dsh plugin 安装：
dsh plugin --profile web remove dsh-message-preview
如果使用 install.cmd / install.ps1 安装，请删除：
$DSH_HOME/profiles/node_modules/dsh-message-preview$DSH_HOME/profiles/web/cordis.patch.yml中id: message-preview对应的插入项
然后重启 dsh web。
故障排查
导航条没有出现
- 确认当前会话至少有两条用户消息。
- 确认正在 Chat 会话视图中；其他页签不会挂载聊天 DOM。
- 完整停止并重新启动
dsh web，仅刷新浏览器不足以加载宿主端插件。 - 检查目标 profile 的
cordis.patch.yml是否包含dsh-message-preview。
点击后没有跳转
目标消息可能尚未加载。插件会自动请求较早历史；超长会话可能需要稍等片刻。如果目标已被宿主永久移除或对应 DOM 锚点不可用，则不会执行跳转。
开发与检查
仓库提交的是可直接加载的构建产物，不需要安装开发依赖即可做语法检查：
npm run check
npm pack --dry-run
发布前还应在 DSH Web UI 中验证：导航条展开、鼠标与键盘预览、滚动高亮、较早消息补载和点击跳转。
