asukasec/dsh-message-preview

dsh-message-preview

License: MIT
awesome · DSH plugin

DeepSeek Harness Web UI 的右侧消息导航条。它为当前会话中的每条用户消息生成一个导航块，可悬停预览、显示当前阅读位置，并点击跳转到对应消息。

DeepSeek Harness Web UI 的右侧用户消息导航条，支持悬停预览、阅读位置跟踪和点击跳转导航。

功能

- 只索引用户直接发送的消息，排除工具通知、后台任务和注入上下文。
- 当前阅读位置随会话滚动自动高亮。
- 悬停显示消息序号、相对时间和文本预览。
- 点击后自动加载较早的会话历史，平滑滚动并高亮目标消息。
- 导航块会根据消息数量和文本长度自适应排布；少于两条用户消息时自动隐藏。
- 默认仅显示当前位置指示，鼠标靠近会话右侧时展开完整导航条。
- 中英文界面文案随 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。 |

数据按以下优先级获取：

1. 宿主端 dshMessagePreview 投影，提供完整且轻量的消息索引。
2. 当前已加载的会话节点，用于首屏回退。
3. 投影尚未就绪时，通过 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 中验证：导航条展开、鼠标与键盘预览、滚动高亮、较早消息补载和点击跳转。

License

MIT