前言¶

在 DSH 的长对话里，用户消息越多，定位某一条旧消息越不方便。手动滚动容易越过目标，尤其在消息和回复交错时。dsh-plugin-msg-nav 为这类场景提供一个轻量入口：在对话区右缘渲染一列短横线节点串，把每条真实用户消息映射为一个节点，并支持悬停预览、点击跳转和滚动浏览。

这是什么¶

dsh-plugin-msg-nav 是一个 DeepSeek Harness（DSH）插件，维护者为 SherUnlocked-4869，许可证为 MIT。它安装在 DSH 的 web profile 中，面向对话视图提供导航能力。插件核心目标是让长会话中的用户消息可以快速定位、预览和跳转。

核心能力¶

• 在对话区右缘渲染纵向短横线节点串，每条真实用户消息一个节点。
• 节点激活状态随阅读位置实时更新。
• 鼠标进入节点串区域时，节点条变形为单行消息预览面板；移出后恢复。
• 预览面板每条消息一行，最多显示 10 条；超过时可在悬停区域内用滚轮上下滑动列表。
• 点击预览可平滑跳转到对应消息，并显示高亮横线。
• host 侧会话投影使进入会话时无需逐页拉取即可覆盖全部用户消息。
• 点击尚未入窗的旧消息节点时，按需拉取更早历史后再跳转。
• 用户消息少于 2 条、空白会话或非对话视图时自动隐藏。

安装与启用¶

下面以 web profile 为例。先执行安装命令：

dsh plugin --profile web add github:SherUnlocked-4869/dsh-plugin-msg-nav

随后启动或重启部署，使 bundle 变更生效：

dsh web

如果页面已经打开，刷新页面通常即可拿到新 bundle。

更新到最新版本：

cd ~/.dsh/profiles/web && pnpm update dsh-plugin-msg-nav

卸载：

dsh plugin --profile web remove dsh-plugin-msg-nav

使用方式¶

先打开一个处于对话视图的会话。当前会话至少要有 2 条真实用户消息，右缘才会出现节点串。

1、滚动对话区，观察右侧节点串的激活状态是否跟随阅读位置变化。

2、鼠标进入节点串区域，查看弹出的单行消息预览面板。

3、如果预览超过 10 条，在悬停区域内使用滚轮上下滑动列表。

4、点击目标消息，页面平滑跳转到对应消息，并显示高亮横线。

5、如果目标消息是尚未入窗的旧消息，插件会按需拉取更早历史后再跳转。

运行细节与注意¶

• 插件以当前 dsh 进程权限运行；安装前应检查源码与许可证。
• package.json 声明 peerDependencies 中 react ^18.2.0 且为 optional。
• bundle 变更需重启部署；刷新页面通常即可拿到新 bundle。
• 未挂载投影注册表的部署会自动回退到后台逐页加载，每页 50 条、至多 120 页。
• 节点串不会在以下情况显示：用户消息少于 2 条、空白会话、非对话视图。

链接¶

目录页：

• https://www.skillhub.cn/plugins/SherUnlocked-4869/dsh-plugin-msg-nav

GitHub：

• https://github.com/SherUnlocked-4869/dsh-plugin-msg-nav