Passer au contenu principal
M

dsh-replay

mingozhou/dsh-replay

Rejoue des sessions sur une timeline rejouable avec utilisation des jetons par étape, audite les opérations sensibles, estime les coûts, affiche la lignée des forks, compare des sessions et exporte des replays HTML autonomes.

Installer

dsh plugin --profile web add github:mingozhou/dsh-replay

README

鲸小深 — dsh-replay 吉祥物

dsh-replay

轨迹看过程,Replay 看结论。
给 DeepSeek Harness 会话出一份复盘报告:花了多少钱、时间去哪了、哪里出了错、改了哪些文件、有没有危险操作——然后脱敏后一键分享。

ci npm license dsh-plugin

简体中文 | English

在线 Demo · 安装 · 常见问题 · 更新日志

会话复盘报告

它和官方【轨迹】是什么关系

Harness 自带的【轨迹】标签页已经把“逐轮、逐调用地看一次运行”做得很好。Replay 不重复这件事,它回答的是轨迹不回答的问题:

你想知道官方【轨迹】Replay
这一步发生了什么、耗时多久✅ 主场有时间线,够用
这次运行花了多少钱(人民币,分高峰 / 低谷)—✅
整体健康吗:失败、重试、死循环、异常结束—✅ 运行评分 + 需要关注
改了哪些文件,diff 是什么—✅
有没有危险命令、碰没碰密钥(含 PowerShell)—✅
这周一共花了多少、哪个项目最烧钱、哪个工具老失败—✅ 全部会话面板
发给别人看,对方不用装 Harness—✅ 脱敏后导出单个 HTML / Markdown 摘要
两次运行差在哪—✅ 工具序列并排对比

“Replay”指回看一次已经发生的运行,不会把会话重新发给模型,也不产生费用。想从某一步重新跑:在时间线里选中事件,点 从这里分叉,然后在 Harness 里继续那个新会话。

项目故事

dsh-replay 是怎么走到今天的:从“日志没人看得了”到“轨迹之上的复盘报告”

0.1 – 0.3:给一份没人看得了的日志做个查看器。 DeepSeek Harness 会把每个会话写进只追加的日志,送进模型的一切都能从里面还原。但当时它并没有提供查看这份日志的方式。每次跑完长任务,同样的问题总会冒出来:跑了几个小时、烧了几百万 Token,到底花在哪了?哪一步卡住了?有没有碰我的 .env?这次花了我多少钱? dsh-replay 一开始就是这个缺失的查看器:可拖动的时间线、Token 曲线、成本估算、基于规则的审计、分支树,以及一键导出单个 HTML。

0.4:被 awesome-dsh-plugins 收录。 插件发布到 npm,一条命令就能装,随后被 awesome-dsh-plugins 收录,知乎日报公众号也做了推荐。

Harness rc.8:官方推出【轨迹】。 之后 Harness 内置了【轨迹】标签页。它把 dsh-replay 最初做的那件事做得很好:逐轮查看、每条记录的耗时、实时跟随、长会话分页加载。正面竞争没有意义,插件在 0.4.x 修完兼容性后就停更了。

1.0:回答轨迹不回答的问题。 1.0 不再做第二个逐步查看器,而是变成跑完之后读的那份报告,叠在【轨迹】之上。下面这些官方标签页里都没有:

  • 人民币成本:按每一步实际用的模型、当时的高峰 / 低谷价格逐步计价,并按模型和输入 / 输出 / 缓存拆分。
  • 运行评分和“需要关注”列表:重复调用、失败的调用、慢调用、模型重试、异常结束的轮次,点一下就跳到对应事件。
  • 时间去哪了:按真实耗时画出模型时间、工具时间和空闲时间的泳道图。
  • 文件改动:从 write / edit / apply_patch 重建出的 diff。
  • 重新校准的审计:把 PowerShell 当作真正的 shell 来审;删除操作按删的是什么来判级。
  • 全部会话面板:按天、按项目、按模型的花费,以及哪个工具最常失败。
  • 脱敏分享:先遮蔽密钥和主目录路径,再导出单个 HTML 或 Markdown 摘要。
  • 对比两次运行的每一次调用,以及从任意事件分叉出新会话。

完整改动见 CHANGELOG.md。

为什么它适合 vibe coding

vibe coding 就是让 Agent 自己开,你一路点“允许”。这样很爽,直到你想回忆刚才到底发生了什么。一次长会话下来,通常有三件事已经记不清了,dsh-replay 就是帮你把它们找回来:

  • 你都批准了什么。 点了二十次“允许”之后,它们就混在一起了。审计会按严重程度列出这次运行里所有有风险的操作(递归删除、curl | sh 和 iwr | iex、sudo、强制推送、命令行里出现的凭据、写入 .env 或 ~/.ssh),每一条都能直接打开对应事件,看清到底执行了什么、是不是你批准的。
  • AI 在哪一步最耗时。 泳道图和“需要关注”列表直接告诉你:同一套测试用相同参数重复跑了四次、一次安装花了两分钟、还有一个小时其实是你不在电脑前。
  • 钱都花到哪了。 Token 被拆成未缓存输入、缓存读、缓存写和输出,再按模型和时段计价。你会看到账单大头是不是某个贵模型在高峰时段跑的,缓存又帮你省了多少。上下文图能看出提示词每一步怎么涨、在哪里被压缩。

全部会话面板再给你一个更长的视角:这周花了多少、哪个项目最贵、哪个工具最容易失败。

功能

报告

打开会话先看到结论,而不是几百行事件。

  • 运行评分(0–100):只由列出来的扣分项构成——严重/较高审计发现、工具失败、重复调用、模型重试、异常结束。没有扣分项就是 100。
  • 六个指标:成本、活跃时长、Token、缓存命中率、工具调用、轮次/步数。每个都和你最近 10 次会话的中位数对比。
  • 时间去哪了:按真实耗时画的泳道图(用户 / 模型 / 工具),失败的调用标红,轮次之间的空闲被折叠。点任何色块跳到时间线。
  • 累计成本 / Token、每步上下文大小(能直接看到压缩发生在哪)。
  • 需要关注:死循环(同工具同参数连续调用)、失败的调用、慢调用、重试、异常结束的轮次,全部可点击定位。

成本按人民币算

  • DeepSeek 默认价格取自官方人民币价格页,区分高峰 / 低谷时段,按每一步实际使用的模型和发生时间计价。
  • 价格表可在界面里改(⚙),支持美元报价的模型按汇率折算,也可以整体切到美元显示。
  • 所有金额都是估算,以账单为准。
价格设置

全部会话

花费、Token、活跃时长、缓存命中率、工具失败率;每日花费按模型堆叠;星期 × 小时热力图;最贵的会话;按项目汇总;各工具的失败占比。汇总在宿主侧计算并缓存,浏览器不会下载每个会话的完整日志。

全部会话面板

时间线

虚拟滚动,长会话不卡。支持推理过程、Markdown 渲染、JSON 折叠、edit / write / apply_patch 的 diff 视图。

键盘:J/K 上下,[/] 上一轮/下一轮,E 下一个失败,Space 播放,/ 搜索,输入 #123 跳到序号。

时间线

文件改动

从日志里的 write / edit / apply_patch 调用重建“这次改了哪些文件”,带逐次 diff。(通过 shell 命令做的改动看不到。)

文件改动

审计

  • bash 和 pwsh / powershell 都是一等公民:rm -rf、Remove-Item -Recurse、curl | sh、iwr | iex、sudo、Set-ExecutionPolicy、强推、命令行里的凭据……
  • 递归删除看的是删什么:清 node_modules / dist 是信息级,删工作区外的路径才是严重。
  • 普通 shell 命令只是信息级,按规则分组折叠;不想看的规则可以一键忽略。
审计

分享

导出前先看脱敏预览:API Key、令牌、凭据赋值、URL 里的密码、主目录里的用户名都会被遮蔽(邮箱可选)。可以只导出某一轮或一段序号区间。

  • 导出 HTML:单个文件,离线可看,对方不需要 Harness。
  • Markdown 摘要:贴进 issue、群聊或文章。

脱敏基于规则,尽力而为;公开发布前请自己再看一眼。

分享与脱敏

还有

  • 实时跟随:会话还在运行时,Replay 每 2.5 秒拉取新事件,报告和时间线跟着更新;可暂停。
  • 对比:两次运行的指标成对比较,工具调用序列并排对齐,标出从哪一步开始不同。
  • 分支:分叉家族与子 Agent。Harness 0.2 起分叉不再记录来源,这类连线由“首条提示相同”推断,并标注为“推断”。
  • 中英双语;明暗主题跟随 Harness。

安装

不想装?先试 在线 Demo,用的是示例会话。

按你使用 Harness 的方式,选一种:

A. 桌面端用户(下载安装包使用 Harness)
  1. 打开 Harness 桌面端,进入 插件 页面的插件商店。
  2. 搜索 @mingozhou/dsh-replay。
  3. 点 安装,按提示重启 Harness。

不需要命令行,也不需要装 Node.js。

B. 源码用户(clone 了 Harness 仓库,用 pnpm dsh web 启动)

在 Harness 仓库目录里执行(pnpm dsh web 挂载的 profile 名是 web):

pnpm dsh plugin --profile web add @mingozhou/dsh-replay

确认装上了:

pnpm dsh --profile web --dump-config
# 输出里应出现一段 `# == @mingozhou/dsh-replay`

然后完全重启:

pnpm dsh web

打开 http://127.0.0.1:3080 。

C. 命令行用户(npm i -g @deepseek-ai/dsh 装的发行版 CLI)
ls ~/.dsh/profiles                                  # 查看有哪些 profile
dsh plugin --profile <你的profile> add @mingozhou/dsh-replay
dsh --profile <你的profile> --dump-config           # 确认出现 # == @mingozhou/dsh-replay
dsh web --profile <你的profile>                     # 重启

Windows 下 profile 目录是 C:\Users\<用户名>\.dsh\profiles\。

D. 想改代码 / 试未发布版本:从本仓库源码安装
git clone https://github.com/MingoZhou/dsh-replay && cd dsh-replay
npm install && npm run build      # lib/ 是构建产物,每次重新 clone 后都要构建
npm run demo                      # 本地 demo → http://localhost:4173

# 让 profile 指向这个文件夹,而不是 npm 上的包(路径写绝对路径)
pnpm dsh plugin --profile web add <插件绝对路径>/dsh-replay

装好之后在哪里

重启后有两个入口:

  1. 侧栏左下角的“会话回放”按钮:全屏打开“全部会话”面板,可以点进任何一个会话。
  2. 每个会话视图里的 Replay 标签页(和【轨迹】并排):直接打开当前会话的报告。

从旧版升级到 1.0

  • 桌面端:在插件商店里卸载 dsh-replay,再搜索 @mingozhou/dsh-replay 重新安装。

  • 源码 / 命令行:先 remove 再 add:

    pnpm dsh plugin --profile web remove dsh-replay
    pnpm dsh plugin --profile web add @mingozhou/dsh-replay
    

装好后标签栏里出现“报告”“文件改动”,就是 1.0 了。旧版保存在浏览器里的美元价格表不会沿用,1.0 默认按人民币计价。

兼容性

1.0 按会话日志格式 v4(Harness 0.2.x)编写,同时兼容更早格式的日志。Harness 仍在 preview 阶段,插件 API 会变;如果升级后出问题,请带上 Harness 版本号开 issue。

配置

cordis.patch.yml 里可调两项:

项默认说明
routePrefix/replay/api只读 HTTP 接口的前缀
summaryLimit300“全部会话”面板统计最近多少个会话
maxResultChars12000每条工具结果最多传给浏览器多少字符,超出部分点“加载完整结果”再取;超大会话会自动再缩短

价格表、忽略的审计规则、脱敏选项保存在浏览器本地(localStorage)。

卸载

  • 桌面端:在插件商店里卸载。

  • 源码 / 命令行:

    pnpm dsh plugin --profile web remove dsh-replay        # 源码用户
    dsh plugin --profile <你的profile> remove dsh-replay   # 命令行用户
    

然后重启 Harness。插件不在其他任何地方写入状态。手动兜底:打开 profile 目录,在 package.json 里把 dsh-replay 从 dependencies 和 dsh.profile.bundles 两处删掉,在该目录执行 pnpm install 后重启。

常见问题

“回放”是把会话重新发给模型吗? 不是。Replay 只读日志,不调用模型,不产生费用。要重跑,用时间线里的 从这里分叉。

金额和账单对不上。 金额是按价格表估算的。先在 ⚙ 里核对价格和高峰时段;缓存写入、服务商的赠送额度和折扣都可能造成差异。

商店里搜不到。 搜完整的包名 @mingozhou/dsh-replay(带 @ 和斜杠)。还是没有的话,可能是你的桌面端版本较旧,先升级 Harness,或改用上面的命令行方式安装。

GET /replay/api/sessions 返回 404。 配置层没生效。Harness 对无法解析的插件名是静默失败:重跑 plugin add,并用 --dump-config 确认。

启动报 Cannot find module '…/dsh-replay/lib/index.js'。 profile 指向的是源码目录,而 lib/ 是构建产物。进插件目录跑 npm install && npm run build。

接口正常但没有侧栏按钮或 Replay 标签页。 确认 lib/client.js 存在,然后完全重启 Harness:客户端插件只在启动时扫描。

启动报 EADDRINUSE: 127.0.0.1:3080。 上一个 Harness 实例还开着,先关掉。

看不到“从这里分叉”按钮。 这个按钮只在 Harness 里出现,并且需要宿主提供客户端 sessions 服务;Demo 和导出的 HTML 里没有。

“全部会话”第一次打开时数字在慢慢变。 正常:第一次要在后台把每个会话统计一遍,统计好的会先显示,顶部有进度条,这期间 Harness 照常可用。之后走缓存,只统计新增的会话。会话很多时可以调小 summaryLimit。

有的工具结果后面显示“结果过长,只显示了前 N 个字符”。 为了让超大会话也能打开,传给浏览器的工具结果会被截短。点 加载完整结果 即可看全文,或者调大 maxResultChars。

架构

src/core/      零依赖分析层:解码、时间线、成本、审计、体检、文件改动、脱敏、汇总、对比
src/index.ts   宿主半:只读 HTTP 接口(会话、增量事件、汇总缓存、查看器)
src/client/    浏览器半:React 界面,图表为手写 SVG,无第三方图表库
demo/          独立 Demo 与示例日志(也是测试夹具)

core 可以单独使用:import { parseSessionJsonl, buildTimeline, estimateCost, auditSession } from '@mingozhou/dsh-replay/core'。

界面的底色、文字、边框、悬停全部使用 Harness 的 --dsw-alias-* 主题变量,所以换主题、切暗色都会跟着变;只有图表里的数据色是插件自己的。

npm test             # 单元测试
npm run screenshots  # 重新生成 README 截图(需要先 npm run demo)

许可与致谢

MIT。鲸小深是为本项目创作的原创角色,不是 DeepSeek 官方 logo。界面里嵌入的是 assets/mascot-192.webp(192 px,约 8 KB);换成你自己的图后 npm run build 会自动嵌入,超过 60 KB 会被拒绝并回退到内置 SVG。

Plugins associés