在使用 DeepSeek Harness (DSH) Web GUI 处理长对话时，面对大量文本，快速定位已加载的轮次、查看摘要以及回溯历史内容需要频繁滚动页面。dsh-ui-turn-rail 是一个为 DSH Web GUI 设计的插件，它在对话滚动区域旁添加了一个常驻的进度指示条，帮助用户直观地管理对话进度。
插件简介¶
该插件由 HenryHwong 维护，属于 DSH 插件生态中的客户端组件。它通过在会话快照中读取数据，在浏览器端进行推导，将对话的轮次进度以点的形式展示在界面上。
核心功能¶
- 常驻进度条：进度条固定在对话滚动区域旁，即使对话内容很长，进度条也会保持可见，不会随页面滚动消失。
- 点与占位符：每个已加载的对话轮次对应一个实心点。对于尚未加载的轮次（问题不在当前窗口内），显示虚线占位符。AI 的回复和推理过程不计入已加载的提问点。
- 摘要预览：鼠标悬停在点上时，会显示该轮次第一个问题的单行摘要。无论是用户输入还是 AI 选项选择，都会生成摘要。
- 深度历史加载：点击未加载的虚线占位符，插件会自动分页加载所有旧批次，直到目标轮次的问题出现在窗口中，然后自动跳转到该问题所在的行。
- 点击跳转：点击已加载的实心点，直接滚动对话记录到该轮次的问题位置。
- 可滚动窗口：进度条显示约十个点，内部支持滚动。当读者移动阅读位置时，当前轮次的点会自动跟随进入视野。
安装与启用¶
安装该插件需要两个步骤：通过 DSH 插件管理器安装插件包，以及应用主机 instrumentation（源码级补丁）。
1. 安装插件¶
在命令行中执行以下命令将插件添加到 Web 配置文件中：
dsh plugin --profile web add @huanghanheng/dsh-ui-turn-rail
2. 应用主机 Instrumentation¶
该插件需要在 DSH 的 Web 客户端中注册一个只读插槽。由于这涉及源码层面的修改，dsh plugin 命令无法自动完成。需要在 DSH 的代码检出目录中应用补丁，然后重新构建。
执行以下脚本应用补丁并构建：
scripts/apply-instrumentation.sh /path/to/harness-checkout
(cd /path/to/harness-checkout && pnpm run build)
3. 手动安装支持¶
如果需要手动安装，也可以直接使用 npm/pnpm 安装包，并在 profile 的 package.json 中声明 bundle。安装完成后，仍需执行上述步骤 2 以应用 instrumentation 并构建。
安全与权限¶
该插件设计为纯展示组件：
* 无网络请求：不向服务器发送任何请求，不写入会话日志，不触碰凭据。
* 无新权限：仅为主聊天视图添加了一个只读插槽，不引入新的 RPC 或权限。
* 本地计算：所有数据推导（轮次顺序、节点映射、摘要）均在客户端的 ChatSnapshot 上运行，插件自身不持有会话状态。
生态背景¶
DeepSeek Harness 遵循「一切皆插件」的理念。该插件目录位于社区托管平台（SkillHub），与 DeepSeek 官方无直接隶属关系，仅供技术社区参考。
总结¶
dsh-ui-turn-rail 通过在 Web GUI 中引入可视化的进度条，解决了长对话中的导航难题。它提供了悬停查看摘要、一键加载历史以及点击跳转等功能，所有操作均在本地进行，不会影响模型请求或缓存。对于需要频繁处理长上下文对话的开发者而言，这是一个实用的辅助工具。
