前言¶
在 DSH 中运行 agent 任务后,经常会遇到一类具体问题:会话跑完后,怎样快速看出时间和 token 花在哪里,哪些工具调用值得关注,是否出现敏感路径或危险命令,fork 之后两条会话从哪一步开始分叉,以及如何把一次完整会话交给同事查看。
dsh-replay 是一个 DSH 插件,由 MingoZhou 维护,许可证为 MIT。它用于为 DeepSeek Harness 会话提供 replay、fork-tree、audit 和 compare 可视化。插件的一句话描述是:
Session replay, fork-tree, audit & compare visualization for DeepSeek Harness — time machine for your agent sessions
这是什么¶
dsh-replay 面向需要查看、审计和比较 agent 会话记录的 DSH 用户。它把会话记录转成可操作的界面,覆盖时间线回放、概览、费用估算、安全审计、fork 树、对比、导出、搜索和语言切换。
核心功能¶
下面按已提供的能力列出:
- Timeline replay:查看会话过程。
- Overview dashboard:查看会话概览。
- Cost estimate:提供费用估算。
- Security audit:提供安全审计。
- Fork tree:查看 fork 结构。
- Compare:对会话进行对比。
- One-click HTML export:导出 HTML。
- Filter & search:提供过滤和搜索。
- EN / 中文:界面支持英文和中文。
先在线试用¶
可以先到在线 demo 查看效果:
https://mingozhou.github.io/dsh-replay/
该 demo 提供三个样例会话,并且不需要安装。
安装与启用¶
npm 包发布的是预构建版本:不需要 clone,不需要 build,也不涉及 allowBuilds approval。
安装命令如下:
dsh plugin --profile <your-profile> add @mingozhou/dsh-replay
这里的 <your-profile> 是当前 DSH profile 名称,需要替换为实际值。
安装后先验证配置:
dsh --profile <your-profile> --dump-config
输出中应出现一个类似下面的 section:
# == @mingozhou/dsh-replay
然后重启 harness:
dsh web --profile <your-profile>
如果使用本地 harness 仓库运行,也可以用:
pnpm dsh web
启动后打开:
http://127.0.0.1:3080
启用后有两个入口:
- 侧边栏左下角的 Session Replay 按钮;
- 每个打开的会话中的 Replay 标签。
从源码运行 demo¶
如果你已经有 dsh-replay 仓库,可以先构建,再运行 demo:
npm install && npm run build
npm run demo
仓库地址为:
https://github.com/MingoZhou/dsh-replay
适用场景与注意¶
dsh-replay 适合希望查看会话过程、排查工具调用、审计敏感操作、比较 fork 会话,或将会话导出为 HTML 的场景。
安装前建议检查源码与许可证。插件以当前 dsh 进程权限运行,因此不要只看界面效果,也要确认插件代码本身。
已核实的注意点如下:
- peer dependencies 包括
react ^18.2.0和@deepseek-ai相关包;自 v0.2.0 起,所有 harness 包均为 optional peers。 - client plugin sets 只在启动时扫描,并且负向结果会被缓存;因此客户端相关变化后通常需要重启 harness。
- 预览阶段 plugin API 可能变动;按插件说明,修复会落在 thin adapter files。
- 深色模式跟随 harness 主题。
- 插件不在自身 package 外保存状态。
- 许可证为 MIT。
结尾¶
dsh-replay 把 DSH 会话记录整理成可查看、可审计、可对比、可导出的界面。适合把它作为 agent 会话排查和复盘时的一个补充工具。
项目仓库:
https://github.com/MingoZhou/dsh-replay
插件目录线索中的地址为:
https://www.skillhub.cn/plugins/MingoZhou/dsh-replay
该目录页地址在本次资料中被标记为未确认,访问前建议先以 GitHub 仓库信息为准。