DeepSeek Harness 插件：对话轮次导航与 Codex 风格时间轴 (dsh-conversation-nav)

在 DeepSeek Harness 的 Web GUI 中进行智能体开发时，面对长对话流，快速定位特定轮次、查看消息发送时间以及管理对话进度往往较为困难。dsh-conversation-nav 插件通过引入 Codex 桌面版风格的左侧导航栏，解决了这些问题。

这是一个纯客户端插件，由 Jaeger0624 维护。它为 DeepSeek Harness Web GUI 提供了 Codex 风格的对话轮次导航。插件将一个垂直的“钢琴键导轨”挂载在对话区左侧，每条用户消息对应一个刻度。它支持鼠标悬浮查看详情、点击跳转，并能持久化轮次标记。

核心功能¶

• 钢琴键导轨：对话区左侧的垂直刻度列，每条用户消息（含 steering）对应一个刻度，长对话会自动压缩间距。
• 悬浮阶梯与详情卡：鼠标悬停刻度时，显示详情悬浮卡，包含消息摘要、模型回复预览、发出时间（按日期格式）、轮次耗时和输出 token 数。
• 点击跳转：点击刻度平滑滚动至该轮次，目标行会短暂高亮。对于虚拟滚动未挂载的行，插件会按比例预估并做有界重试兜底。
• 当前轮追踪：滚动时，正在阅读的轮次刻度会自动深色高亮。
• 多色轮次标记：支持右键点击刻度循环切换标记颜色（琥珀/红/蓝/绿），并在悬浮卡中添加备注。标记数据保存在浏览器的 localStorage 中，刷新页面不丢失。
• 主题自适应：支持明暗主题切换，并兼容 prefers-reduced-motion 减少动画偏好设置。

安装与启用¶

使用官方 CLI 安装该插件：

dsh plugin --profile web add github:Jaeger0624/dsh-conversation-nav

典型用法¶

1. 查看详情：鼠标悬浮在对话左侧的刻度上，查看消息摘要、模型回复预览以及时间、耗时和 token 指标。
2. 跳转定位：点击刻度，页面平滑滚动至该轮次，并短暂高亮该行。
3. 标记与备注：右键点击刻度可循环切换标记颜色；在悬浮卡中点击「☆ 标记」或添加备注。

技术实现与注意事项¶

• 技术栈：纯客户端插件，零依赖，手写单文件 bundle，无构建步骤。
• 数据源：直接读取官方 ctx.sessions 会话快照。
• 挂载方式：挂载于官方 shell.overlay 槽位（点击穿透层，内部自行处理 pointer-events）。
• 持久化：标记数据存储于 localStorage，键名为 dcn:marks:<sessionId>。
• 注意：该插件运行在客户端，不涉及后端权限。安装前建议检查源码与许可证（MIT）。

该插件通过纯前端实现，降低了长对话管理的门槛。更多细节请查阅插件目录页或源码仓库。