SherUnlocked-4869/dsh-plugin-msg-nav
40Last commit Aug 15, 2026
dsh-plugin-msg-nav DSH plugin
This plugin adds a vertical node bar to the right edge of the conversation area, with one node per real user message. Hovering reveals a single-line message preview panel; clicking any preview smoothly scrolls to and highlights that message. The host-side session projection delivers the full user message list instantly, requiring zero pagination requests on initial load.
How to install the dsh-plugin-msg-nav DSH plugin
dsh plugin --profile web add github:SherUnlocked-4869/dsh-plugin-msg-navCopying does not run this command. Review the repository and version before installing the dsh-plugin-msg-nav DSH plugin.
dsh-plugin-msg-nav DSH plugin data source
dsh-plugin-msg-nav DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-plugin-msg-nav DSH plugin can do
- Renders a vertical node bar on the right edge of the chat view, with one node per real user message
- Hovering over the node bar expands it into a single-line message preview panel with 0.18s animation
- Clicking a preview smoothly scrolls to the message and applies a brand-blue highlight line that fades out in 1.5s
- Supports scroll-wheel navigation within the preview panel when more than 10 messages are present
- Automatically hides when there are fewer than 2 user messages or in non-chat views
- Uses host-side session projection (msgNavMessages) to deliver the full message list instantly, without pagination requests
Where the dsh-plugin-msg-nav DSH plugin fits
- Quickly navigate through long chat histories without scrolling manually
- Jump to a specific user message by its position in the conversation
- Preview messages near the current reading position without leaving the current view
- Efficiently access older messages that are not yet rendered in the chat window
- Maintain context by seeing the full list of user messages at a glance
Who the dsh-plugin-msg-nav DSH plugin is for
- DSH users who frequently review long chat sessions
- Power users who need fast navigation and preview of conversation history
dsh-plugin-msg-nav DSH plugin limitations
- Requires DSH environment with bundle support and the host-side projection registry (msgNavMessages)
- May fall back to client-side pagination (up to 120 pages, 50 messages each) if the projection registry is not mounted, which could cause performance impact
- Only works in the 'conversation' view; automatic hiding in other views or blank sessions
- At least 2 real user messages are required for the node bar to appear
dsh-plugin-msg-nav DSH plugin: from the repository README
Quoted from the SherUnlocked-4869/dsh-plugin-msg-nav README, the upstream source of the dsh-plugin-msg-nav DSH plugin. Copyright remains with the original authors.
**简体中文** | [English](./README.en.md) [](https://awesome-dsh-plugin.com) # dsh-plugin-msg-nav DeepSeek Harness 对话节点导航条插件：在对话区右缘渲染一列短横线节点串（每条真实用户消息一个节点），跟随阅读位置；鼠标靠近节点串时，节点条「变形弹出」为单行消息预览面板（覆盖原位置，移开复原），点击任意预览平滑跳转 + 高亮横线，节点过多时可在悬停区域内用滚轮滑动浏览。host 侧会话投影让节点串**进入会话即覆盖整段历史**的全部用户消息——零翻页请求、无初始卡顿。  以 **bundle** 形式发布：`dsh plugin` 安装后自动接入 profile 层栈，无需手改任何配置文件。架构参考 dsh-chat-timeline 的 host 会话投影 + 客户端按需加载模式。 ## 安装（DSH 官方命令） ```bash # 直接从 GitHub 安装 dsh plugin --profile web add github:SherUnlocked-4869/dsh-plugin-msg-nav ``` `dsh plugin` 会转发给 pnpm 安装到 profile 目录，并自动把声明了 `dsh.bundle` 的包加入 `dsh.profile.bundles` 层栈。随后启动（已在运行则重启）部署即可： ```bash dsh web # 或 dsh --profile <你的 profile> ``` 更新到最新版本： ```bash cd ~/.dsh/profiles/web && pnpm update dsh-plugin-msg-nav ``` 卸载： ```bash dsh plugin --profile web remove dsh-plugin-msg-nav ``` ## 功能 | 功能 | 行为 | | --- | --- | | 节点导航条 | 对话区右缘纵向短横线串，每条**真实用户消息**一个节点（系统注入的 goal 自动延续等不计入），恒定 20px 间距 | | 悬停弹出面板 | 鼠标进入节点串区域：节点条短横线淡出、左侧**单行预览面板弹出**（0.18s 放大动画，覆盖节点条原位置，行内短横线落在原节点条短横线的横坐标上，如节点条变形展开）；移出后节点条恢复 | | 面板排版 | 每条消息一行（左文字 + 右短横线），24px 行距、上下 8px 对称留白；悬停行时文字与
Read the full READMERepository license: MIT
dsh-plugin-msg-nav DSH plugin questions
How do I install dsh-plugin-msg-nav?
Run `dsh plugin --profile web add github:SherUnlocked-4869/dsh-plugin-msg-nav` in your terminal. This will install the plugin via pnpm into your profile directory. After installation, restart your DSH deployment and refresh the page to activate the bundle.
The node bar is not showing up. What should I do?
First, ensure your DSH deployment has been restarted after installing the plugin and the page is refreshed. Second, verify that you are in a 'conversation' view with at least 2 real user messages. The node bar automatically hides when there are fewer than 2 messages or in non-chat views.
Can I customize the appearance of the node bar?
The plugin does not provide built-in customization options. The visual style is fixed: brand blue for active node, white in dark mode, with 8px rounded background on hover. If you need custom styling, you may fork the repository and modify the CSS in the bundle.
Does it work with very long conversations (thousands of messages)?
Yes, the plugin is designed to handle long conversations. The host-side projection delivers the full list of user messages instantly, so there is no initial pagination overhead. For older messages not yet rendered in the window, clicking on a node triggers on-demand loading (up to 120 pages of 50 messages each). The node bar can become dense, but the preview panel supports scrolling via the mouse wheel.
What if my deployment doesn't support the host-side projection registry?
If the `msgNavMessages` projection registry is not mounted, the plugin automatically falls back to client-side pagination. It will load older messages page by page (50 per page, up to 120 pages) in the background. This may cause a slight delay when clicking on very old nodes, but the node bar will still work.