中文 | English
navbar
对话节点导航条：对话区右缘节点串快速跳转 user 消息，悬停预览、点击跳转
对话区右缘的等距节点串（每 user 消息一节点）——激活药丸跟随阅读位置、悬停预览卡（6 行截断）、点击平滑滚动 + 品牌蓝高亮环、超过 30 节点固定窗口 + 端点计数徽标、平时隐形悬停浮现、无 user 消息时自动加载更早历史直到出现 ≥1 条。实现 dsh-external/issues#144 规格。形态：官方 **bundle 插件**（`dsh.bundle` + dshClient 通道，**纯浏览器端**，Node half 为空），0 patch。
## 效果
## 能力
| 功能 | 说明 |
|---|---|
| 节点导航条 | 对话区右缘纵向节点串，每 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 源不触发构建）：
```sh
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 视觉），加载中显示「加载中…」。点击转发给官方加载更早控件，当前阅读位置保持不变（不跳动）。
## 开发
```sh
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 生态示例插件）。