前言¶
DeepSeek Harness (DSH) 的插件生态旨在丰富客户端的交互能力。在长对话中，当助手输出包含层级结构（如 #, ##, ###）的长文本时，快速定位和记忆关键章节往往需要手动滚动。dsh-section-nav 是一个将 “Section Nav for ChatGPT” 体验移植到 DSH Web 客户端的插件，它为当前的助手回答提供侧边栏导航，并支持本地章节书签。
插件定位¶
- 开发者：jolaaa999
- 功能：为 DSH 聊天窗口提供章节导航轨道和本地书签管理。
- 核心价值：解决长答案的导航痛点，提供类似原生应用的侧边栏体验，且完全本地化运行，不依赖服务器。
核心能力¶
该插件在浏览器端实现，主要包含以下功能：
- 章节导航轨道：在助手回答文本的右侧始终显示一个轨道，列出当前对话中包含标题的章节。轨道宽度随窗口变化，标题截断在最小宽度时进行。
- 阅读位置追踪：随着用户在对话中滚动阅读，导航轨道会自动高亮当前所在的章节。
- 点击跳转与悬停：点击轨道条目可滚动至对应标题并高亮；鼠标悬停时显示两部分的悬浮卡片，包含用户请求和模型回答的摘要。
- 本地书签：点击轨道条目旁的星标可收藏该章节。点击轨道头部的星标/计数按钮可打开书签抽屉，支持快速跳转。
- 翻页稳定与历史加载：
- 翻阅更早历史记录时，视图不会因为翻页而跳动，导航会自动恢复到目标章节。
- 默认加载最新 8 轮对话，支持通过顶部控件或向上滚动加载更多历史。
- 主题跟随：轨道自动读取宿主页面的文本和表面颜色，适配 DSH 的深色/浅色主题。
- 会话缓存：每个访问过的会话目录会缓存在内存中，切换会话时渲染速度较快。
安装与启用¶
通过命令行安装该插件：
dsh plugin --profile web add github:jolaaa999/dsh-section-nav
安装后，该插件会作为一个纯浏览器端插件挂载到 DSH 客户端中，无需额外配置。
使用方法¶
- 打开一个包含标题（
#,##,###）的 DSH 对话。 - 观察右侧出现的导航轨道，它始终可见。
- 点击轨道中的条目，页面会滚动到对应的标题位置。
- 点击条目旁的星标，将该章节加入本地书签。
- 点击轨道头部的星标/计数按钮，打开书签抽屉。
- 在抽屉中点击书签，或按
Escape、点击抽屉外部或关闭按钮来关闭抽屉。 - 当轨道只显示最新 8 轮对话时，点击列表顶部的加载控件或继续向上滚动，可按页加载更早的历史记录。
注意事项与限制¶
- 数据来源：导航目录的条目来源于用户对话记录，当前版本不重新解析助手的标题内容。
- 历史限制：当宿主没有更多页面可返回，或目录已完全加载时，翻页停止，无法访问更早的记录。
- 书签定位：如果书签指向当前未渲染窗口外的章节，插件会按需加载历史记录以到达目标位置。
- 内容过滤：推理折叠（reasoning disclosures）内部的标题会被忽略，章节归属于助手回答的文本。
- 存储与同步：书签仅保存在浏览器的
localStorage下，键名为dshSectionNav.bookmarks.v1，不支持跨设备同步，也不使用服务器存储。
总结¶
dsh-section-nav 专注于提升 DSH Web 客户端处理长文本的交互体验。它通过本地存储和浏览器 DOM 操作实现了轻量级的导航与书签功能，适合需要在长对话中反复查阅特定章节的开发者。
- 插件目录：https://www.skillhub.cn/plugins/jolaaa999/dsh-section-nav
- 源码仓库：https://github.com/jolaaa999/dsh-section-nav
