dsh-turn-index

对话轮次索引：在 DeepSeek Harness Web GUI 右侧挂一条侧边栏，按顺序列出每一轮「你问过的话」。点击任意一条，聊天流平滑滚动到那一轮并闪烁高亮；滚动阅读时侧边栏同步高亮当前轮次。

A turn-index sidebar for the DeepSeek Harness web GUI: one entry per user turn, click to jump, scroll-spy keeps the current turn highlighted.

┌──────────────────────────────┬───────┐
│  聊天流                       │ 轮次 2│
│                              │ ─────│
│  ▸ #1 帮我查一下……（点击跳转） │  #1   │
│                              │  #2 ▸ │
└──────────────────────────────┴───────┘

功能

• 逐轮索引：每条索引 = 一轮用户提问的开场消息；轮次内穿插的补充提问（steering）以 ↳ 缩进显示，不打断轮次编号。
• 点击跳转：直接定位聊天流里对应的消息行，平滑滚动 + 1.6 秒闪烁高亮（尊重系统的减少动效偏好）。
• 阅读联动：滚动阅读时索引自动高亮当前轮次，展开态的列表自动跟随，当前轮次始终可见。
• 历史分页：会话历史窗口未加载完时，顶部出现「加载更早的轮次」，点一下继续向前加载。
• 轨迹视图兜底：停留在轨迹视图时点击索引，给出提示并一键切回对话。
• 避让右侧详情面板：工具详情（details）打开时索引栏自动左移避让。
• 响应式：视口 ≤1024px 自动收成 44px 窄条（只留轮次圆点）；1280px 以下面板收窄；面板高度贴合聊天流区域（不遮 Session log、不压输入框）；偏好记忆在 localStorage。
• 双语文案：通过 harness 的 locale 服务提供 中文 / English 文案，跟随界面语言。

Compatibility

项	值
支持版本	DSH 0.1.0-rc.6（web profile，mainline）
最后验证	2026-08-14 · Windows 11 · Node 24 · pnpm 11
依赖	宿主标准 web bundle（slots / sessions / locale 客户端服务 + shell.overlay 槽位）；react 为可选 peer

安装

# npm（推荐，已发布 v0.1.1）
dsh plugin --profile web add dsh-turn-index

# GitHub tag tarball
dsh plugin --profile web add https://github.com/Simon314620/dsh-turn-index/archive/refs/tags/v0.1.1.tar.gz

# 本地目录（开发调试）
dsh plugin --profile web add file:D:/path/to/dsh-turn-index

安装后重启 dsh web，刷新页面即可在右侧看到索引栏。默认的 dsh web profile 已具备全部所需服务。

卸载

dsh plugin --profile web remove dsh-turn-index

移除后重启 dsh web 并硬刷新（Ctrl+Shift+R）。回滚方式同上：卸载后重装旧版本即可（如 dsh plugin --profile web add dsh-turn-index@）。浏览器侧偏好（折叠状态等）仅存于 localStorage，卸载后是无害残留，可在开发者工具中清除。

实现原理

纯客户端插件：宿主侧（Node）无运行时逻辑，浏览器半边通过 shell.overlay 槽位（AppFrame 的加性浮层席位）挂载面板。会话数据取自 ctx.sessions.binding(currentId).session（ 的可观察快照），索引条目从 中筛出 kind 为 / 的可见节点；跳转时按节点 key 查找聊天流里带 属性的 DOM 行（聊天流无虚拟化，行都在 DOM 里），因此跳转天然可靠。面板几何（上下界、details 避让）动态测量 、 与 AppFrame 的 grid 第三轨。