前言¶
DeepSeek Harness (DSH) 在会话日志中保留了每个 token 的精确到达间隔（dt），但上游界面并未提供回放功能。该插件提供了一个内联的播放剧场，用于在浏览器中以原始时序回放会话。它由 ItBayMax 维护，旨在解决日志中保留的精确时序信息无法在界面上可视化的问题。
核心功能¶
- 原始 token 时序回放：助手回答按记录的毫秒间隔逐 token 生长，而非静态文本。
- 内联播放剧场：在 DSH 界面内提供播放、暂停、单步、速度和跳转控制。
- 传输控制：支持播放/暂停、单步（前后）、重启（保持速度）、跳转（绝对位置）和速度控制（0.5x 到 8x）。
- 静音处理：可配置的最大静音上限（默认 200ms - ∞）。压缩的静音会显示在传输栏上。
- 对比运行：支持侧边对比运行，高亮显示分歧点。
- 工具调用：工具调用显示为累积 JSON 加上工具名称。
安装¶
使用官方 CLI 安装插件：
dsh plugin --profile web add dsh-replay-theater
重启 dsh web 后，在会话页面旁边会出现一个 Theater 标签页。
使用方法¶
- 控制栏：
- ▶ / ❚❚：播放或暂停。播放到结尾会从头开始。
- ⏴ / ⏵：单步（一个 token）向前或向后。单步会暂停。
- ⤾：重启，保持当前速度。
- 跳转：跳到绝对位置。
- 速度：0.5× 到 8×。
- 最大暂停：压缩长于该值的静音（200 ms … ∞）。设为 ∞ 以保持真实时序。
- 加载更早：加载旧窗口。播放位置会保持。
- 静音压缩：当任何静音被压缩时，传输栏会说明压缩量。
- 对比：加载记录的
session.jsonl与活动会话并排，插件会报告两个运行停止匹配的位置。
技术限制¶
- 无随机访问：历史记录仅限向后翻页（一次一个窗口）。
- 静音压缩：长静音默认被压缩（2000 ms 上限）。设为 ∞ 以保持真实时序。
- 活动会话：窗口跟随，播放位置在帧被追加时保持。
- 粒度：跳转坐标基于 attempt（尝试）粒度。
- 类型：类型是镜像，不是导入。
- 兼容性：开发针对 dsh
0.2.0-rc.2。 - 文件读取：读取磁盘生成（v2+，当前是 v4）。
- Transient 条目：客户端
transient条目被忽略。
适用场景¶
适合需要分析推理过程、流式输出或调试 agent 行为的开发者。
结语¶
dsh-replay-theater 允许开发者以精确的 token 时序回放会话，用于分析和演示。更多细节请参考 catalog_url 或 github_url。
