BonovaVanro/dsh-mega-chat-nav

mega 导航

English · 中文

DSH（DeepSeek Harness）的会话提问导航条：在会话一侧显示整场对话的提问导航，无论会话多长都不会触发历史加载，随时跳回任意一轮提问，并支持全文搜索包括未加载历史在内的所有内容。
属于 mega 系列家族成员之一，支持四种视觉风格（简约 / Codex / 蓝鲸 / 虎鲸），风格配置各自独立、可随时切换。

功能一览

- 零扩窗全量索引：host 侧投影折叠整段会话日志为紧凑索引，进入会话零翻页、正文零驻留，绝不触发历史扩窗；
- 四种风格：简约（圆点轨）/ Codex（刻度轨）/ 蓝鲸（用户消息面板）/ 虎鲸（复刻 dsh 原生回合导航刻度轨），风格可在导航条设置中随时切换，每种风格独立保存自己的配置；
- 跳转与跟随：点击任意节点直达对应提问；当前阅读位置在导航条中实时高亮并自动居中跟随，点击跳转后仍继续跟随正文滚动；
- 翻页浏览：节点栏条带高度可配（紧凑/标准/高），▲/▼ 或滚轮翻页浏览；
- 全文搜索（含未加载历史）：host 侧路由读持久化日志，防抖 + 请求中断，命中词高亮，一次直达，不触发历史扩窗；
- 收藏筛选：⭐ 只看已收藏提问，收藏数据按会话本地保存；
- 停靠与镜像：导航条可停靠会话左侧/右侧并自动镜像，支持 0–32px 偏移微调；
- 显示模式：轮次总数/搜索/设置/翻页标记均支持 常显 / 浮现（停留 1 秒）/ 隐藏 三态；
- 配置持久化：嵌套 schema（通用 + 风格专属），写回持久化，刷新不丢；
- 国际化：界面词条支持中文 / English，跟随 dsh 通用设置的语言偏好即时切换。

流程展示

视频 1 · 流程展示

界面预览

简约（Minimal）—— 圆点轨

每轮提问一个圆点，悬停弹出级联卡片（1/3/5 张可配）预览提问内容，点击直达；阅读位置圆点实心高亮、实时居中。

图 1 · 简约风格

Codex —— 刻度轨

时间线风格：一条引导线贯穿条带，每轮一个水平刻度；悬停刻度横向展开成波纹，阅读位置刻度常亮、柔和档常态跟随主题色。

图 2 · Codex风格

蓝鲸（Chat）—— 用户消息面板

常态一条窄轨（每轮行首短横把手），悬停展开成用户消息列表面板：面板内显示用户消息、当前行高亮、行首短横即跳转把手；支持收藏筛选与就地全文搜索。

图 3 · 蓝鲸风格

虎鲸（Harness）—— 复刻官方回合导航刻度轨

复刻 dsh 原生回合导航栏（TurnNavigator）的紧凑刻度轨形态，并叠加增强：每轮一个短横刻度、带内滚动 + 上下渐隐；悬停刻度波纹展开（本尊 + 邻居逐级衰减）、阅读位置常亮、跳转目标品牌脉冲；未加载的历史回合显示超短横线；支持柔和/深邃色调档。点击刻度直达对应回合提问（自动分页加载历史）。

图 4 · 虎鲸风格

搜索

图 5 · 简约/Codex风格搜索

图 6 · 蓝鲸风格搜索

设置

图 7 · 简易设置

图 8 · 总配置页

当页面宽度小于 1024px 时，导航栏轻量化为搜索功能，在正文左/右上角点击搜索按钮可呼出搜索抽屉

图 9 · 搜索抽屉

安装

已适配 dsh v0.1.5-rc.\（锁定 0.1.5 rc 线）。提供 npm / GitHub tag / 本地包三种安装方式。

npm

dsh plugin --profile web add dsh-mega-chat-nav@0.1.5-rc.2-update.1

GitHub tag

dsh plugin --profile web add github:BonovaVanro/dsh-mega-chat-nav#v0.1.5-rc.2-update.1

本地包

dsh plugin --profile web add dsh-mega-chat-nav-0.1.5-rc.2-update.1.tgz

卸载：

dsh plugin --profile web remove dsh-mega-chat-nav

说明：插件分 host 与 client 两半。改动 host 侧需要重启 dsh web；纯界面（client）改动刷新页面即可生效。

快速上手

1. 在导航条设置中切换风格：简约 / Codex / 蓝鲸 / 虎鲸（各风格独立保存配置）；
2. 跳转：点击导航条任意节点/把手/刻度直达对应提问，阅读位置自动高亮跟随；
3. 搜索：点 🔍 全文搜索（含未加载历史），可按用户/助手/工具范围过滤；命中词高亮，点击直达；
4. 收藏：点 ⭐ 只看已收藏提问（在悬停卡或消息面板行首切换收藏）；
5. 停靠侧：设置中对齐左/右，随停靠侧自动镜像；
6. 收纳：安装了 mega-settings 时，完整设置页自动收纳进其成员列表（名称 mega 导航）；未安装时提供自足完整设置页。

适用 dsh 版本与兼容性

- 已适配 dsh 版本：0.1.5-rc.\（0.1.5 rc 线通配：rc.1 / rc.2 …；不含 alpha 线与正式版；0.1.2 线由 0.1.2 分支负责，0.1.1 维护线由 0.1.1 分支负责）；
- 宿主启动会按版本策略自检（默认 = 0.1.5-rc.*）；检测到其他版本控制台会打印
dsh-mega-chat-nav 可能不适配 dsh  版本，请慎重使用，插件仍可加载使用；
- 维护者可自行调整 src/index.ts 的 DSCH_COMPAT_POLICY（支持 > / < / = 与通配、数组）。

常见问题

搜索没反应？ 搜索依赖 host 侧路由（webServer/sessions）。若部署环境缺少这些服务，搜索不可用，导航条的跳转等其余功能不受影响。

助手消息的思考（think）内容能搜到吗？ 暂不参与搜索。

助手回复很长，为什么搜不到后半段？ 助手消息仅索引前 400 字，超长回复的后段不参与搜索；提问侧不截断（整段可搜）。