在可播放的时间线上回放会话并显示逐步 token 用量,审计敏感操作,估算成本,查看 fork 血缘,对比会话,并可导出独立 HTML 回放。
安装
# npm 包(预构建)
dsh plugin --profile web add @mingozhou/dsh-replay
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:MingoZhou/dsh-replay
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
dsh-replay
轨迹看过程,Replay 看结论。 给 DeepSeek Harness 会话出一份复盘报告:花了多少钱、时间去哪了、哪里出了错、改了哪些文件、有没有危险操作——然后脱敏后一键分享。
简体中文 | English
它和官方【轨迹】是什么关系
Harness 自带的【轨迹】标签页已经把“逐轮、逐调用地看一次运行”做得很好。Replay 不重复这件事,它回答的是轨迹不回答的问题:
| 你想知道 | 官方【轨迹】 | Replay |
|---|---|---|
| 这一步发生了什么、耗时多久 | ✅ 主场 | 有时间线,够用 |
| 这次运行花了多少钱(人民币,分高峰 / 低谷) | — | ✅ |
| 整体健康吗:失败、重试、死循环、异常结束 | — | ✅ 运行评分 + 需要关注 |
| 改了哪些文件,diff 是什么 | — | ✅ |
| 有没有危险命令、碰没碰密钥(含 PowerShell) | — | ✅ |
| 这周一共花了多少、哪个项目最烧钱、哪个工具老失败 | — | ✅ 全部会话面板 |
| 发给别人看,对方不用装 Harness | — | ✅ 脱敏后导出单个 HTML / Markdown 摘要 |
| 两次运行差在哪 | — | ✅ 工具序列并排对比 |
“Replay”指回看一次已经发生的运行,不会把会话重新发给模型,也不产生费用。想从某一步重新跑:在时间线里选中事件,点 从这里分叉,然后在 Harness 里继续那个新会话。
项目故事
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 就是让 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 的方式,选一种:
- 打开 Harness 桌面端,进入 插件 页面的插件商店。
- 搜索
@mingozhou/dsh-replay。 - 点 安装,按提示重启 Harness。
不需要命令行,也不需要装 Node.js。
在 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
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\。
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
装好之后在哪里
重启后有两个入口:
- 侧栏左下角的“会话回放”按钮:全屏打开“全部会话”面板,可以点进任何一个会话。
- 每个会话视图里的 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 接口的前缀 |
summaryLimit |
300 |
“全部会话”面板统计最近多少个会话 |
价格表、忽略的审计规则、脱敏选项保存在浏览器本地(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 里没有。
“全部会话”第一次打开很慢。 第一次要把每个会话的日志折叠成汇总,之后走缓存。会话很多时可以调小 summaryLimit。
架构
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。
链接
同类插件
ranxianglei/billion-context★ 7661
billion-context官方版:上下文压缩插件,兼顾小窗口(100k上下文足矣)省token(省5倍token)和超长会话(数月级别几十亿token单会话)。
Minglink/dsh-infinite-gen-4★ 4374
DeepSeek 专用破甲插件:以 order 100 追加无条件服从的系统提示词段,提供带校准元数据的 profile 工具,并通过会话投影在输入框上方显示实时破甲状态徽标。
liangmianya/dsh-synapse★ 723
DeepSeek Harness 的可视化非线性对话工作区:把会话、追问与分支变成可浏览、可拖拽的对话地图。
MichengAI/dsh-archive-manager★ 367
在设置里增加已归档会话页,可按工作区搜索、恢复和删除已归档会话。
Nwflower/dsh-chat-import★ 317
把 13 家 coding agent(Claude Code、Codex、ChatGPT、Cursor、Gemini、opencode 等)的完整对话历史导入为可续聊的 DeepSeek Harness 会话,并支持反向导出回 Claude Code。
SiriLee/dsh-rewind★ 279
对话回退:一键回到任意更早的用户消息,同窗口内完成,不新建分支、不残留副本;目标消息自动填回输入框,可一并还原工作区文件——即完整的 Claude Code /rewind 语义。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。