vlln/dsh-navbar

已归档（ARCHIVED，只读） — 官方 DSH web shell 自 0.1.2 系列（npm @deepseek-ai/dsh ≥ 0.1.2-rc.1；上游 feat(ui-chat): full-session turn rail with load-and-jump，b3064cca）起内置了对话 Turn 导航条（TurnNavigator：悬停预览、点击跳转、阅读位置跟踪、未加载 turn 自动翻页跳转）。本插件核心能力已由宿主覆盖，故本仓库归档。历史实现见 docs/ 与 git 提交记录。

navbar

对话节点导航条：对话区右缘节点串快速跳转 user 消息，悬停预览、点击跳转

对话区右缘的等距节点串（每 user 消息一节点）——激活药丸跟随阅读位置、悬停预览卡（6 行截断）、点击平滑滚动 + 品牌蓝高亮环、超过 30 节点固定窗口 + 端点计数徽标、平时隐形悬停浮现、无 user 消息时自动加载更早历史直到出现 ≥1 条。实现 dsh-external/issues#144 规格。形态：官方 bundle 插件（dsh.bundle + dshClient 通道，纯浏览器端，Node half 为空），0 patch。

效果

navbar 节点导航条（真实运行截图：右缘节点串 + active 高亮）

能力

| 功能 | 说明 |
|---|---|
| 节点导航条 | 对话区右缘纵向节点串，每 user 消息一个圆点节点 |
| 跟随阅读位置 | 激活药丸（22px 品牌蓝胶囊）随当前阅读位置移动 |
| 悬停预览 | 悬停节点显示消息预览卡（6 行截断，对齐官方 HoverCard 视觉） |
| 连续悬停 | 整条导航条（含节点间隙）连续响应悬停：预览随最近节点切换 + 对应药丸加长（灰色）指示点击落点，无死区 |
| 滚轮切换 | 光标悬停导航条时滚动滚轮：向上滚=上一条、向下滚=下一条（阻止对话区滚动） |
| 点击跳转 | 整条导航条可点（含间隙，按最近节点跳转）+ 药丸命中区放大，无需精确瞄准小圆点 |
| 固定窗口 + 计数徽标 | >30 节点时显示固定 30 节点窗口（激活尽量居中、到端点钳制）；窗口两端计数徽标（↑N / N↓）显示隐藏条数——可见点数恒定。精选金色盘恒可见（窗口扩到包含精选） |
| 加载更早历史 | 导航条最上方的 ↑ 按钮（仅当会话还有更早历史时显示）：点击加载更早的消息——转发给官方加载更早控件，保持当前阅读位置不跳动；悬停立即显示与节点预览同款的提示卡（官方 HoverCard 视觉） |
| 自动隐藏 | 无 user 消息加载时（或非对话页）不显示。0 条 user 消息时会自动加载更早历史直到出现 ≥1 条（或历史耗尽）——导航条始终有可导航内容 |
| 消息精选 pin | assistant 操作条（copy 与 Good response 之间）📌 按钮；精选轮次在导航条渲染为金色细长椭圆盘（恒可见、预览卡带 📌 徽标、点击直达被精选的回复），状态按会话持久化 |

零数据通道依赖：只靠官方锚点属性（data-time-hover-root，0806 起 user 行）驱动，无轮询、无路由、无工具。

安装

推荐：git 源一行安装（构建产物已入库，git 源不触发构建）：

dsh plugin --profile web add "github:vlln/dsh-navbar#main"   # git 源一行（构建产物已入库）
或 npm 源：dsh plugin --profile web add @vlln/dsh-navbar@0.4.0

或本地目录（有源码时）：git clone 后 cd dsh-navbar && dsh plugin --profile web add .。

装完 重启 web 生效；设置页「插件」面板可停用/启用。

使用

安装即用，无命令、无工具。对话页（Chat 视图）右缘出现节点条；悬停看预览、点击跳转。prefers-reduced-motion 下禁用动画。

精选 pin：hover assistant 消息操作条，点 📌 把该回复选为精选——对应轮次的导航节点变为金色细长椭圆盘（点击直达该回复；预览卡显示 📌 徽标与回复文本）。精选状态按会话保存在浏览器 localStorage，刷新后保留；再点一次取消精选。

加载更早历史：当前会话还有更早消息（历史窗口未加载完）时，导航条最上方出现 ↑ 按钮。点击加载更早的消息——导航条顶部随之新增节点。全部历史加载完后按钮自动隐藏；加载进行中按钮禁用。悬停按钮立即显示与节点预览同款的提示卡（官方 HoverCard 视觉），加载中显示「加载中…」。点击转发给官方加载更早控件，当前阅读位置保持不变（不跳动）。

开发

pnpm install
pnpm run build      # tsdown：client bundle (lib/client.js)

- client：src/client/index.ts（自渲染 DOM + 官方锚点契约；pin 按钮走官方 conversation.chat.assistant-actions 插槽，React 由 client runtime 提供；访问的 ctx 服务须在插件对象 inject 中声明）
- Node half：src/index.mjs（空 apply，bundle 挂载载体）

许可

MIT License（DSH 生态示例插件）。