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

安装

# 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（ConversationSnapshot 的可观察快照），索引条目从 chat.order 中筛出 kind 为 user / steering 的可见节点；跳转时按节点 key 查找聊天流里带 data-chat-anchor-key 属性的 DOM 行（聊天流无虚拟化，行都在 DOM 里），因此跳转天然可靠。面板几何（上下界、details 避让）动态测量 [data-conversation-scroll]、[data-composer-seat] 与 AppFrame 的 grid 第三轨。

配置

无配置项。开箱即用；面板偏好（收起状态、窄条模式）仅存于浏览器 localStorage。

权限与数据

• 宿主侧（Node）零运行时逻辑：不读写文件系统、不发起网络请求、不访问凭据。
• 会话数据只读：仅订阅当前会话的可观察快照（ctx.sessions.binding(currentId).session）用于渲染轮次索引，不上传、不外发。
• 浏览器持久化：唯一落盘数据是 localStorage 中的 UI 偏好。
• 无遥测、无埋点、无第三方脚本。

开发

pnpm add -D jsdom     # 测试依赖
node tests/edge.mjs   # 24 项边界单测（120 轮渲染、跳转命中/未命中、响应式、空态等）
node smoke.mjs        # 装配冒烟测试

已知限制

• 面板悬浮在聊天区右侧：宽屏下覆盖的是消息流的空白区，窄窗口下请用头部按钮收起（自动窄条在 ≤1024px 生效）。
• 跳转依赖 harness 聊天流的 DOM 契约（data-chat-anchor-key / data-conversation-scroll 等）；harness 大版本升级若改动这些属性需要适配。
• 索引只覆盖当前已加载的历史窗口，更早的轮次通过「加载更早」逐页加载。

License

MIT

安全问题请通过 GitHub Issues 联系维护者私下报告，避免公开披露。