DeepSeek Harness 插件

MingoZhou/dsh-replay

Star 数 ★ 17 下载量(近 30 天) 1,989 分类 会话与消息 收录于 2026-08-18 npm @mingozhou/dsh-replay

在可播放的时间线上回放会话并显示逐步 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 会话出一份复盘报告:花了多少钱、时间去哪了、哪里出了错、改了哪些文件、有没有危险操作——然后脱敏后一键分享。

ci

简体中文 | English

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

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

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 的方式,选一种:

  1. 打开 Harness 桌面端,进入 插件 页面的插件商店。
  2. 搜索 @mingozhou/dsh-replay。
  3. 点 安装,按提示重启 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

打开 http://127.0.0.1:3080 。

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

装好之后在哪里

重启后有两个入口:

  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 接口的前缀
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。

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。