返回目录
开发工具 基础设施

dsh-agent-replay

forrestsweet/dsh-agent-replay

DeepSeek Harness 会话回放与脱敏分享插件:将真实 Agent 轨迹导出为独立交互 HTML,用于文档、演示和问题反馈。

Stars
1
Forks
0
Issues
0
更新
4 天前

PROJECT TOPICS

项目标签

PROJECT README

README

DeepSeek Harness Agent Replay

English | 简体中文

Agent Replay 将 Harness 会话转换为可回放时间线和脱敏的独立 HTML

CI GitHub stars MIT License DeepSeek Harness plugin

回放 Agent 真正做过的事情,再导出一个更适合分享的版本。 Agent Replay 为 DeepSeek Harness 增加原生的 回放 标签页,把真实会话中的消息、模型回复、工具调用、命令、错误和耗时转换为可搜索时间线,并可导出为独立 HTML 回放。

10 秒看懂

回放真实会话 生成适合分享的脱敏版本
DeepSeek Harness 中的回放标签页 带隐私摘要和 HTML 导出的分享页
  1. 打开任意非空 Harness 会话,选择 回放
  2. 搜索、筛选、检查事件,或按记录时间播放。
  3. 选择 生成分享页,导出一个可交互的 .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-trajectoryui-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.

CLASSIFICATION EVIDENCE

分类依据

项目类型基础设施
功能分类开发工具
规则置信度

系统优先读取 GitHub Topics,再与站内分类词典和词根规则比对。当前命中: observability、agent-observability、ai-coding-agent、developer-tools、privacy、session-replay。