dsh-session-navigator: DeepSeek Harness 会话导航与缩略图插件

前言¶

DeepSeek Harness (DSH) 是用于构建智能体的平台。在长对话场景下，面对几十轮的 Prompt-Response 和工具执行输出，单纯滚动浏览来定位特定轮次非常低效。官方 DSH Web UI 缺少会话缩略图或快速导航轮廓。

dsh-session-navigator 为 DSH Web UI 增加了一个全高的会话导航轨和刻度图。它通过在聊天流右侧边缘添加导航轨，解决了长对话定位困难的问题，同时保持了界面的简洁性。

插件定位¶

这是一个为 DeepSeek Harness 提供会话导航和轮次刻度图的客户端插件。由开发者 wuxiangru915 维护。

该插件的核心价值在于：
* 零侵入：无需修改官方核心包，通过官方 shell.overlay 槽位挂载。
* 可视化：将长对话流转化为可视化的垂直刻度。
* 交互增强：提供悬浮预览、平滑跳转和统一滚动条。

核心功能¶

该插件包含以下具体能力：

1. 全高极简导航轨
   在对话流右侧边缘提供 1px 宽的垂直导航轨，无需额外胶囊样式，完全融入 UI。
2. 比例刻度标记
   自动根据用户轮次在滚动容器中的物理高度，生成比例刻度。
3. 当前轮次指示器
   显示当前视口的垂直高亮药丸，配合 ScrollSpy 实现平滑跟随。
4. 统一拖拽滚动条
   提供一个可拖拽的统一滚动条，用于在导航轨上直接滚动会话，避免原生滚动条重复出现。
5. 悬浮预览卡片
   悬停在刻度标记上时，显示预览卡片。卡片包含：
   • 轮次编号（如 #2 Prompt）。
   • 3 行截断的 Prompt 摘要。
   • 快捷操作按钮：导出 Markdown、一键复制文本、上一轮/下一轮跳转。
6. 平滑跳转与脉冲
   点击标记或卡片后，视图会平滑滚动至目标消息，并伴随高亮脉冲动画。

安装与启用¶

安装该插件需要 DeepSeek Harness >= 0.1.0-rc.5 (Cordis 4.x) 以及 Node.js >= 22。

通过官方命令行工具安装：

dsh plugin --profile web add github:wuxiangru915/dsh-session-navigator

安装后，重启 Web 服务器并刷新页面即可生效。本地开发时，可直接使用本地路径安装：

dsh plugin --profile web add /path/to/dsh-session-navigator

插件为纯 Bundle 插件，安装时无需构建步骤。

典型用法¶

在 DSH Web 中打开任意会话后：

1. 查看导航轨
   在聊天流右侧会出现垂直导航轨，每个用户轮次对应一个刻度标记。
2. 悬浮预览
   将鼠标悬停在刻度标记上，会弹出悬浮预览卡片，显示轮次摘要和状态。
3. 快速跳转
   点击标记或预览卡片，视图会平滑滚动到对应的消息气泡处。
4. 操作与滚动
   在预览卡片上点击按钮可导出 Markdown 或复制文本；拖拽导航轨上的滚动条可滚动会话内容。

注意事项¶

• 版本要求：必须使用 DeepSeek Harness >= 0.1.0-rc.5，确保 Cordis 版本为 4.x。
• 运行权限：插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证（MIT）。
• 架构：插件通过 dsh.bundle 补丁层挂载，不涉及对官方包的修改。

结语¶

dsh-session-navigator 通过提供直观的导航轨和交互式预览，显著提升了长对话场景下的操作效率。对于需要频繁在大量轮次中定位 Prompt 或 Response 的开发者，该插件能减少手动滚动的操作成本。

插件目录页
GitHub 仓库