插件目录 / Knowledge / dsh-agent-replay
dsh-agent-replay
已验证 · 实测可装 forrestsweet
功能简介
会话回放与脱敏分享插件
可用 — 实测通过,早期项目
会话回放与脱敏分享插件 实测能干净安装、正常启动。早期项目,但功能可用。
「已验证」表示我们的自动化 CI 在干净 profile 里实际执行了 dsh plugin add 并启动成功——仅此而已。功能描述与版本兼容性均为作者声明。这不是安全审计,也不代表对第三方代码的背书。
README
DeepSeek Harness Agent Replay
English | 简体中文
回放 Agent 真正做过的事情,再导出一个更适合分享的版本。 Agent Replay 为 DeepSeek Harness 增加原生的 回放 标签页,把真实会话中的消息、模型回复、工具调用、命令、错误和耗时转换为可搜索时间线,并可导出为独立 HTML 回放。
10 秒看懂
| 回放真实会话 | 生成适合分享的脱敏版本 |
|---|---|
![]() |
![]() |
- 打开任意非空 Harness 会话,选择 回放。
- 搜索、筛选、检查事件,或按记录时间播放。
- 选择 生成分享页,导出一个可交互的
.html文件。
为什么需要它
Harness 已经内置了很优秀的开发诊断界面 Trajectory(轨迹)。Agent Replay 不替代它,而是补齐分享与沟通这一层:
| Harness Trajectory | Agent Replay | |
|---|---|---|
| 主要目标 | 检查和调试完整事件账本 | 回放并讲清楚一次会话 |
| 主要读者 | Agent 开发者 | 团队成员、维护者、文档读者 |
| 数据 | 原始请求、用量、耗时和事件细节 | 经过选择的消息、工具、命令、错误和耗时 |
| 分享方式 | 产品内诊断 | 脱敏、独立、可交互 HTML |
| 隐私边界 | 完整本地诊断上下文 | 排除系统事件;脱敏常见路径和密钥 |
功能
- 原生、会话级
conversation.view标签页 - 完全使用 Harness 真实快照:消息、工具、命令、错误、时间戳与耗时
- 1×、2×、4× 记录时间回放
- 搜索、类型筛选、详情检查、复制和加载更早历史
- 独立 HTML 导出:Trajectory 风格事件账本、概览轨道、详情检查器、深色模式,无运行时依赖
- 分享时排除系统/上下文事件与助手隐藏推理
- 自动脱敏 macOS/Windows 用户路径、常见 Token、Bearer Token 和键值型凭据
- 中英文 UI,跟随 Harness 当前语言
- 复用 Harness 官方组件、语义 Token、尺寸、交互状态、图标与明暗色行为
安装
从源码安装
要求:Node.js 22.19+(或 24+)、pnpm,以及可正常运行的 DeepSeek Harness。
git clone https://github.com/forrestsweet/dsh-agent-replay.git
cd dsh-agent-replay
pnpm install
pnpm check
dsh plugin --profile web add .
dsh web
打开非空会话,在「对话」和「轨迹」旁选择 回放。
直接从 GitHub 安装
dsh plugin --profile web add github:forrestsweet/dsh-agent-replay
Git 依赖会执行本仓库的 prepare 构建。pnpm 10 可能要求在 profile 的 pnpm-workspace.yaml 中明确允许该包构建;请先检查源码,再允许 dsh-agent-replay 并重新运行命令。对可复现性有要求时,请固定 commit SHA。细节见 Harness 官方插件发布指南。
移除
dsh plugin --profile web remove dsh-agent-replay
隐私模型
Agent Replay 运行在 Harness Web 客户端中,只读取浏览器里已经存在的会话快照,不上传会话内容,也不需要额外模型密钥。
导出 HTML 前会:
- 排除系统/上下文事件以及尚未完成的实时事件;
- 只导出助手最终文本,不导出隐藏推理;
- 替换
/Users/<name>和C:\\Users\\<name>路径前缀; - 脱敏常见 GitHub/OpenAI/Slack 形式的 Token、Bearer Token 和凭据赋值。
自动脱敏是安全网,不是绝对保证。公开发布前请人工检查导出文件。若发现脱敏绕过,请按 SECURITY.md 私下报告,不要创建公开 Issue。
开发
pnpm install
pnpm typecheck
pnpm test
pnpm build
npm pack --dry-run --ignore-scripts
项目结构:
src/index.ts:Harness 宿主端 bundle 入口。src/client/index.tsx:注册回放视图并渲染会话数据。src/privacy.ts:经过独立测试的公开事件选择与脱敏逻辑。cordis.patch.yml:将插件组合进 Harness profile。
UI 明确跟随 DeepSeek Harness 的 ui-trajectory 与 ui-primitives。贡献代码应优先复用 Harness 官方组件和 --dsw-* 语义 Token,不另造一套视觉系统。
兼容性
当前版本面向 DeepSeek Harness 0.1.0-rc.5+,并使用 0.1.0-rc.6 开发依赖验证。Harness 仍处于 1.0 之前,客户端 slot 或快照契约可能变化。兼容问题请同时提供 Harness 与插件版本。
欢迎提交 Issue 和 PR。请先阅读 CONTRIBUTING.md,版本记录见 CHANGELOG.md。
许可证
MIT © Agent Replay contributors.
安装
装一次目录插件,之后本站所有插件都能让 DeepSeek Harness 自动找、自动装:
dsh plugin add dshbase-catalog 然后对 agent 说「帮我装 dsh-agent-replay」,它会在目录里找到并自动安装。文档:dshbase-catalog · 已验证场景包。
该插件是 GitHub 源码(未发 npm)——直接从仓库装:
Web profile:
dsh plugin --profile web add github:forrestsweet/dsh-agent-replay Headless(CLI)profile:
dsh plugin --profile headless add github:forrestsweet/dsh-agent-replay 实测报告
验证通过:从 GitHub 源码完成 L1 安装 + L2 加载 + L3 运行(dsh 0.1.0-rc.6)。
使用场景
给 agent 一套记忆、知识库或检索层,让它不再跨会话丢上下文。
适合谁
跑长项目、想让 agent 记住决策、文档和偏好而不用每次重讲的人。
二次开发建议
记忆/检索后端是缝——插新存储、调蒸馏策略,或加引用与审计轨迹。

