zoahdev/dsh-replay

dsh-replay — DeepSeek Harness 智能体的时间旅行调试器

npm

直接从 session.jsonl.zstd 回放、可视化并对比 DeepSeek Harness 会话的完整轨迹——这是 ground-truth 事件日志。无需 @deepseek-ai/dsh 依赖；只需 Node ≥ 22.19（其内置的 zstd）。

dsh-replay 渲染的时间线

为什么

通过在终端中滚动来调试智能体只能看到最后 N 行。dsh 的会话日志已经包含了一切——每一个推理增量、每一次工具调用、每一个结果，都带有 seq + 时间戳——但它是一种拼接式 zstd、打包行的格式，没人能手工阅读。dsh-replay 解码该格式并将其渲染为可读的时间线。

它能做什么

- 解码拼接式 Zstandard 容器以及打包的 text-chunks/reasoning-chunks/tool-call-chunks 行（即精确的 @deepseek-ai/dsh-session 线格式，以零依赖重新实现）。
- 重建轮次 → 步骤 → 用户消息 → 推理 → 助手文本 → 带结果的工具调用（成功/错误）。
- 渲染一个自包含的深色模式 HTML 时间线。
- 对比两个会话的逐轮差异（两次运行在哪里出现分歧？）。
- 汇总每个工具调用次数、错误数和延迟为 JSON（--stats）。

安装 / 运行

从 npm
npx dsh-replay  --out replay.html
或从源码
node bin/replay.mjs  --out replay.html
或直接指向一个文件
node bin/replay.mjs --file ~/.dsh/sessions/.../session.jsonl.zstd
以 JSON 打印轮次/工具/错误汇总
node bin/replay.mjs  --stats
比较两次运行
node bin/replay.mjs diff
比较两次运行并渲染并排 HTML 差异
node bin/replay.mjs diff   --diff-html

在任何浏览器中打开 replay.html。

示例

node bin/replay.mjs session-94b0ee6a-dbbe-4497-bf31-3d5e90a01d6a
-> session-94b0ee6a...replay.html

正确性

解码器镜像了上游的 scanZstdFrames + decodeStorageRecord 格式。测试覆盖了打包行展开、工具调用/结果重建以及差异汇总器。

npm test

相关

- dsh-shelf — 会话生命周期 CLI（list/stats/export/trash/rescue）。
- dsh-plugin-doctor — 插件 + 配置文件预检。

dsh-replay — DeepSeek Harness agent 的"时间旅行调试器"

从 session.jsonl.zstd 直接回放、可视化、对比一个会话的完整轨迹。这是 dsh 的 ground-truth 事件日志，包含每次推理分片、每次工具调用、每次结果。零依赖，只需 Node ≥ 22.19。

node bin/replay.mjs  --out replay.html
node bin/replay.mjs diff

打开 replay.html 即可看到按 turn → step 组织的轨迹：用户消息、推理（可折叠）、回复文本、工具调用（参数 + 成功/失败结果）。