前言¶
DeepSeek Harness（DSH）采用插件化架构，扩展能力高度开放。在 Web 客户端进行长对话开发时，对话轮次过多会导致上下文跳转困难，难以快速定位到特定的历史交互。dsh-turn-nav 插件正是为了解决这个问题而生，它在对话界面右侧边缘提供了一种直观的轮次导航方式。
插件简介¶
插件名称：dsh-turn-nav
维护者：xiaheng1
核心功能：为 DeepSeek Harness Web 提供对话轮次直方图导航轨。
许可证：MIT
该插件在对话右侧边缘渲染短条形图，代表对话中的各个轮次。通过交互，它将静态的条形图转化为动态的导航工具，帮助开发者快速定位消息。
核心功能¶
- 多视觉变体支持：支持 Mixed、DeepSeek 和 Codex 三种视觉风格。
- 未聚焦状态：未处于聚焦状态的轮次以短条形式显示在对话右侧边缘。
- 交互反馈：当鼠标悬停或键盘聚焦某个条形时，该条形会展开形成波浪状（聚焦条最长），并显示包含该轮次用户消息的预览卡片。
- 平滑滚动：点击导航轨上的条形，对话界面会平滑滚动到对应的轮次位置。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin --profile web add git+https://github.com/xiaheng1/dsh-turn-nav.git
dsh plugin --profile web install
安装完成后，需要重启 dsh web 进程，并在浏览器中执行硬刷新（通常是 Ctrl+F5）以加载新插件。
使用方法¶
- 打开一个工作区和对应的对话。
- 将鼠标指针移动到对话区域的右侧边缘，可以看到导航轨。
- 沿着导航轨移动鼠标，预览卡片会跟随当前高亮的条形平滑滑动，显示对应的消息内容。
- 点击任意条形，对话内容将平滑滚动到该轮次。
配置与注意事项¶
配置选项¶
插件默认在窄屏（max-width: 767px）下隐藏导航轨。若需在窄屏下保持显示，可在配置中设置：
hideOnNarrow: false
编辑 $DSH_HOME/settings.yaml 文件即可针对当前部署覆盖默认配置。
注意事项¶
- 该插件为 AI 辅助生成，建议在生产环境使用前在安全环境中进行测试。
- 不同视觉变体（mixed、deepseek、codex）的默认样式可能存在差异。
- 安装后务必重启服务并刷新浏览器。
总结¶
dsh-turn-nav 通过可视化的轮次导航轨，解决了 DSH Web 客户端长对话的定位痛点。它提供了清晰的视觉反馈和流畅的交互体验，适合需要频繁在对话历史中跳转的开发者。
