前言¶

在 DSH（DeepSeek Harness）Web 端处理多轮会话时，一轮对话里可能同时包含用户提问、助手回复、工具调用、命令和压缩点。会话越长，滚动查找某一轮越费力；如果页面默认懒加载历史，想要回到早期轮次时，还需要先补载历史。

dsh-conversation-navigator 针对这个问题，在 DSH Web 端提供一个按轮折叠的对话大纲面板：点击节点跳转，滚动时高亮当前阅读位置，并采用与内置轨迹视图一致的配色。

这是什么¶

dsh-conversation-navigator 是由 gjj-star 维护的 DSH Web 端插件，License 为 MIT。它是一个纯浏览器插件（无宿主行为），纯 JavaScript、零构建、零 npm 依赖。

插件主要解决长会话中的三类问题：

• 查找某一轮对话或某个步次。
• 快速跳转到对应位置。
• 手动滚动时知道当前阅读到哪一轮。

核心功能¶

下面是已核实的插件能力：

• 按轮折叠大纲：默认只显示“第 N 轮 + 你的问题”列表。
• 关键词过滤：仅按用户提问与助手实际回复文本匹配，并高亮命中词。
• 展开/折叠步次明细：包括助手回复、工具调用、命令、压缩点等。
• 悬停查看全文：气泡显示该轮用户提问完整原文。
• 四种形态切换：显示轮次、隐藏轮次、极简·右、极简·左。
• 面板可拖动：支持默认右侧停靠与上次拖动位置切换。
• 点击定位：点击轮次主体或步次条目，平滑滚动到对应位置。
• 历史补载：支持“加载更早 / 加载全部历史轮次”。
• 位置跟踪：手动滚动对话时，自动高亮并跟随当前阅读位置。
• 快捷操作：底部支持“回到最新 / 全部折叠”。
• 配色：与内置轨迹视图一致，并适配明暗主题。
• 会话跟随：切换工作区或会话时，自动跟随并重建大纲。

安装与启用¶

使用官方 CLI 安装：

dsh plugin --profile web add dsh-conversation-navigator

dsh plugin 在 profile 目录内转发给 pnpm，因此官方 CLI 安装需要 pnpm 在 PATH 上。安装完成后，重启 dsh web 后生效，面板默认展开。

如果不依赖 pnpm，可以使用手动方式：把仓库放进下面路径，并在对应 profile 的 cordis.patch.yml 顶层数组追加 example.patch.yml 的内容。

<DSH_HOME>\profiles\<profile>\node_modules\dsh-conversation-navigator

更新¶

修改 lib/client.js 后重启 dsh web 即可更新。

插件的界面状态分为两类持久化：

• 持久化于 localStorage：位置、停靠状态与极简左/右对齐选择，键名为 dsh-cnvnav:ui:v1。
• 仅存于当前页面会话：展开/折叠、模式、搜索关键词等。

典型用法¶

1、安装并重启 dsh web，在 DSH Web 端聊天页使用导航面板。

2、切换四种形态，循环顺序为：

显示轮次 → 隐藏轮次 → 极简·右 → 极简·左

3、输入关键词进行过滤。插件只按用户提问与助手实际回复文本匹配，并高亮命中词。

4、点击轮次主体或步次条目，对话会平滑滚动到对应位置；手动滚动对话时，面板会自动高亮当前阅读位置。

5、需要更早的历史轮次时，使用“加载更早 / 加载全部历史轮次”；页面默认仍懒加载，只有点击按钮才补载。

6、拖动面板可改变位置；插件支持默认右侧停靠与上次拖动位置切换。

适用场景与注意¶

适合使用 DSH Web 端处理较长会话、多轮工具调用和命令输出的场景，尤其是需要频繁定位早期轮次、助手回复或步次明细时。

使用前需要注意：

• 目标平台为 DSH Web 端。
• 依赖 react、slots、sessions 服务与 @deepseek-ai/dsh-client-ui-primitives，以及 dsh-client-runtime、dsh-client-ui-conversation。
• 版本敏感点：[data-chat-anchor-key] / [data-conversation-scroll] 是当前 DSH 聊天视图 DOM 锚点约定。DSH 升级后若锚点变化，需要调整 lib/client.js 中的 findAnchor / computeActiveKey。
• 未声明 timer 硬依赖；客户端 timer 服务不存在时，自动退化为未节流模式。
• 插件以当前 dsh 进程权限运行。安装前应检查源码与许可证。

链接¶

• GitHub：https://github.com/gjj-star/dsh-conversation-navigator
• 目录页（该 URL 来自插件线索，未在本篇已核实正文中确认）：https://www.skillhub.cn/plugins/gjj-star/dsh-conversation-navigator