前言¶
在 DSH「一切皆插件」的生态里，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。这里介绍的 dsh-turn-index 是面向 DeepSeek Harness Web GUI 的第三方插件。
如果你经常在 Web GUI 中处理长会话，会发现聊天流越来越长，想快速回到某一轮用户提问并不方便。dsh-turn-index 解决的问题比较具体：在 Web GUI 右侧增加一条轮次索引，把每一轮用户提问列出来，点击条目即可跳转到对应位置。
这是什么¶
dsh-turn-index 是一个对话轮次索引插件，用于 DeepSeek Harness Web GUI。
它由 Simon314620 维护，采用 MIT 许可证。插件无配置项，安装后在右侧边栏显示索引；每条索引对应一轮用户提问，点击后定位到聊天流中的对应消息行。
核心功能¶
逐轮索引¶
索引栏按轮次列出用户提问。每条索引对应一轮用户提问的开场消息。
如果某一轮内部穿插了补充提问，这些补充提问会以 ↳ 缩进显示，不打断轮次编号。
点击跳转¶
点击索引条目后，插件会定位聊天流中对应的消息行，执行平滑滚动，并对目标位置做闪烁高亮。
阅读联动¶
滚动阅读聊天流时，索引栏会同步高亮当前轮次。
如果索引栏处于展开状态，列表也会自动跟随当前阅读位置，让当前轮次保持在可见范围内。
历史分页¶
当会话历史窗口还没有加载完时，索引栏顶部会出现「加载更早的轮次」。
点击后继续向前加载更早的轮次。索引只覆盖当前已加载的历史窗口，不是一次性加载全部历史。
轨迹视图兜底¶
如果你当前停留在轨迹视图，而不是普通对话视图，点击索引条目时会给出提示，并支持一键切回对话。
避让右侧详情面板¶
当右侧工具详情面板打开时，索引栏会自动左移避让，避免遮挡详情内容。
响应式¶
插件会跟随视口宽度调整：
- 视口
≤1024px时，自动收成44px窄条。 1280px以下，面板收窄。- 面板高度贴合聊天流区域。
双语文案¶
插件通过 harness 的 locale 服务提供中文 / English 文案，跟随界面语言。
安装与启用¶
在 web profile 下安装插件：
dsh plugin --profile web add dsh-turn-index
安装完成后，重启 dsh web，然后刷新页面。
刷新后可以在 Web GUI 右侧看到索引栏。
移除插件：
dsh plugin --profile web remove dsh-turn-index
移除后重启 dsh web，并硬刷新页面（Ctrl+Shift+R）。
典型用法¶
1、安装后打开一段较长会话，右侧索引栏会列出当前已加载窗口中的用户提问轮次。
2、点击某一条索引，聊天流平滑滚动到对应轮次，并闪烁高亮。
3、手动滚动聊天流时，侧边栏会同步高亮当前轮次。
4、如果当前历史窗口还没加载完，点击顶部「加载更早的轮次」继续向前加载。
5、如果当前停在轨迹视图，点击索引会提示并支持一键切回对话。
适用场景与注意¶
适合需要频繁回查用户提问、整理长会话、复盘多轮交互的 DSH Web GUI 使用者。
使用前提需要注意：插件会以当前 dsh 进程权限运行。安装前建议检查源码与 MIT 许可证。
数据与权限¶
根据已核实资料：
- 宿主侧零运行时逻辑，不读写文件系统、不发起网络请求、不访问凭据。
- 会话数据只读，仅用于渲染轮次索引，不上传、不外发。
- 面板偏好仅存于浏览器
localStorage。 - 无遥测、无埋点、无第三方脚本。
兼容性¶
- 支持版本：
DSH 0.1.0-rc.6（webprofile，mainline）。 - 最后验证：2026-08-14 · Windows 11 · Node 24 · pnpm 11。
react为可选 peer：^18.0.0 || ^19.0.0。
限制¶
- 索引只覆盖当前已加载的历史窗口，更早的轮次需要通过「加载更早」逐页加载。
- 跳转依赖 harness 聊天流的 DOM 契约；harness 大版本升级若改动这些属性，插件可能需要适配。
安全问题¶
安全问题通过 GitHub Issues 联系维护者私下报告，避免公开披露。
链接¶
- GitHub：https://github.com/Simon314620/dsh-turn-index
- 目录页：已核实资料未提供可核验 URL，可按插件名
dsh-turn-index在社区目录中查找。
