dsh-navbar DSH plugin

This plugin adds a vertical node strip on the right edge of the chat area, one node per user message. It provides hover preview, click-to-scroll, and an active pill that follows the reading position. It automatically hides when there are fewer than two user messages and supports a sliding window for more than 11 nodes.

ui-productivity

How to install the dsh-navbar DSH plugin

dsh plugin --profile web add "github:vlln/dsh-navbar#main

Copying does not run this command. Review the repository and version before installing the dsh-navbar DSH plugin.

dsh-navbar DSH plugin data source

dsh-navbar DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-navbar DSH plugin can do

Node navigation bar with one dot per user message
Active pill (blue capsule) follows current reading position
Hover preview card (6-line truncated) for each node
Continuous hover handling across nodes and gaps
Scroll wheel on the navbar to switch between nodes
Click anywhere on the navbar to jump to nearest node
Sliding window when >11 nodes to avoid overflow
Auto-hide when <2 user messages or not on chat page
Message pin feature: pin a reply as favorite via 📌 button on assistant action bar
Pinned nodes appear as golden ellipses with preview badge and click-to-jump

Where the dsh-navbar DSH plugin fits

Quickly navigate to a specific user message in a long conversation
Preview message content without scrolling
Mark and revisit favorite assistant replies using the pin feature
Efficiently scroll through conversation node-by-node with mouse wheel
Use on high-node-count conversations without losing overview

Who the dsh-navbar DSH plugin is for

DSH users who frequently navigate long chat histories
Users managing multiple assistant replies and needing quick access to pinned responses

dsh-navbar DSH plugin limitations

Browser-only; no Node.js half (pure client-side)
Requires DSH web version that supports `data-time-hover-root` attribute (0806+ user rows)
Plugin must be restarted via web reload after installation
No polling, routing, or tool integration – relies solely on official anchor attributes
Auto-hides when conversation has fewer than 2 user messages

dsh-navbar DSH plugin: from the repository README

Quoted from the vlln/dsh-navbar README, the upstream source of the dsh-navbar DSH plugin. Copyright remains with the original authors.

对话区右缘的等距节点串（每 user 消息一节点）——激活药丸跟随阅读位置、悬停预览卡（6 行截断）、点击平滑滚动 + 品牌蓝高亮环、超过 11 节点自动滑动窗口、平时隐形悬停浮现、少于 2 条 user 消息自动隐藏。实现 dsh-external/issues#144 规格。形态：官方 **bundle 插件**（`dsh.bundle` + dshClient 通道，**纯浏览器端**，Node half 为空），0 patch。 ## 效果 ![navbar 节点导航条（真实运行截图：右缘节点串 + active 高亮）](docs/preview/navbar.png) ## 能力 | 功能 | 说明 | |---|---| | 节点导航条 | 对话区右缘纵向节点串，每 user 消息一个圆点节点 | | 跟随阅读位置 | 激活药丸（22px 品牌蓝胶囊）随当前阅读位置移动 | | 悬停预览 | 悬停节点显示消息预览卡（6 行截断，对齐官方 HoverCard 视觉） | | 连续悬停 | 整条导航条（含节点间隙）连续响应悬停：预览随最近节点切换 + 对应药丸加长（灰色）指示点击落点，无死区 | | 滚轮切换 | 光标悬停导航条时滚动滚轮：向上滚=上一条、向下滚=下一条（阻止对话区滚动） | | 点击跳转 | 整条导航条可点（含间隙，按最近节点跳转）+ 药丸命中区放大，无需精确瞄准小圆点 | | 滑动窗口 | >11 节点时只显示窗口内节点（避免溢出） | | 自动隐藏 | <2 条 user 消息或非对话页不显示 | | 消息精选 pin | assistant 操作条（copy 与 Good response 之间）📌 按钮；精选轮次在导航条渲染为金色细长椭圆盘（恒可见、预览卡带 📌 徽标、点击直达被精选的回复），状态按会话持久化 | 零数据通道依赖：只靠官方锚点属性（`data-time-hover-root`，0806 起 user 行）驱动，无轮询、无路由、无工具。 ## 安装 **推荐：git 源一行安装**（构建产物已入库，git 源不触发构建）： ```sh dsh plugin --profile web add "github:vlln/dsh-navbar#main" ``` 或本地目录（有源码时）：`git clone` 后 `cd dsh-navbar && dsh plugin --profile web add .`。装完 **重启 web** 生效；设置页「插件」面板可停用/启用。 ## 使用安装即用，无命令、无工具。对话页（Chat 视图）右缘出现节点条；悬停看预览、点击跳转。`prefers-reduced-motion` 下禁用动画。 **精选 pin**：hover assi

Read the full READMERepository license: MIT

dsh-navbar DSH plugin questions

How do I install the navbar plugin?

Run `dsh plugin --profile web add "github:vlln/dsh-navbar#main"` in your terminal. After installation, restart your DSH web interface for the plugin to take effect. You can also clone the repo and run `dsh plugin --profile web add .` from the local directory.

Why don't I see the node bar on my chat page?

The navbar automatically hides when the conversation has fewer than two user messages. It also only appears on the Chat view (not other pages). If you have more than one user message and are still not seeing it, try restarting the web interface and ensure the plugin is enabled in the settings panel.

Can I use the navbar with keyboard navigation?

No, the navbar is designed for mouse/touch interaction. It supports hover preview, click to jump, and scroll wheel switching. There is no keyboard shortcut built in. However, you can still use DSH's built-in keyboard navigation alongside the navbar.

How do I pin a favorite assistant reply?

Hover over the assistant message's action bar (where Copy and Good response buttons are). You'll see a 📌 button. Click it to pin the reply. The corresponding node in the navbar will turn into a golden ellipse. Click on that node to jump directly to the pinned reply. The pin state is saved per conversation in your browser's localStorage.

Does the plugin work on mobile or tablet?

The plugin is designed for DSH web on desktop browsers. It may work on tablets with a mouse, but mobile touch interactions are not optimized. The hover preview and scroll wheel features depend on a pointer device. The plugin is a pure browser extension and does not require any server-side components.