前言¶
DSH 的扩展方式强调插件化，Web 客户端可以加入新的会话视图。dsh-agent-replay 是 forrestsweet 维护的一个 DSH 插件，采用 MIT 许可证，用于回放并分享脱敏后的 DeepSeek Harness 会话，最终导出为独立 HTML。
Harness 会话中通常包含消息、工具、命令、错误、时间戳与耗时。若需要按时间回看一次会话，或把一次会话整理成可分享的材料，就需要一个结构化的回放视图。下面介绍 dsh-agent-replay 的定位、功能、安装方式，以及导出分享页时的注意事项。
这是什么¶
dsh-agent-replay 为 DeepSeek Harness 增加一个原生、会话级 conversation.view 标签页。
它完全使用 Harness 真实快照，读取消息、工具、命令、错误、时间戳与耗时，并提供搜索、筛选、检查、回放和独立 HTML 导出能力。它的目标不是替代 Harness 内已有视图，而是增加“回放”和“生成分享页”这两层使用路径。
核心功能¶
- 原生、会话级
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。
直接从 GitHub 安装¶
把插件安装到 web profile：
dsh plugin --profile web add github:forrestsweet/dsh-agent-replay
安装后，打开任意非空 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
这一步先在本地完成安装、检查和 profile 注册，然后启动 dsh web。
经过上面的步骤，打开任意非空 Harness 会话，选择「回放」，即可进入插件提供的会话视图。
移除¶
如果不再使用，可以移除：
dsh plugin --profile web remove dsh-agent-replay
pnpm 10 注意¶
pnpm 10 可能要求在 profile 的 pnpm-workspace.yaml 中明确允许该包构建。
遇到这种情况时，先检查源码，再允许 dsh-agent-replay，并重新运行安装命令。
典型用法¶
1、打开任意非空 Harness 会话，选择「回放」。
2、搜索、类型筛选、检查事件，或按 1×、2×、4× 记录时间播放。
3、选择「生成分享页」，导出一个可交互的 .html 文件。
分享页内容¶
导出的 .html 文件是独立文件，包含：
Trajectory风格事件账本- 概览轨道
- 详情检查器
- 深色模式
- 无运行时依赖
这意味着分享页不依赖插件运行时的额外脚本，适合作为静态 HTML 文件或页面查看。
隐私与脱敏¶
Agent Replay 运行在 Harness Web 客户端中，只读取浏览器里已经存在的会话快照，不上传会话内容，也不需要额外模型密钥。
导出前会排除系统/上下文事件与助手隐藏推理，并自动脱敏 macOS/Windows 用户路径、常见 Token、Bearer Token 和键值型凭据。
自动脱敏是安全网，不是绝对保证。公开发布前请人工检查导出文件。若发现脱敏绕过，请按 SECURITY.md 私下报告，不要创建公开 Issue。
兼容性¶
当前版本面向 DeepSeek Harness 0.1.0-rc.5+，并使用 0.1.0-rc.6 开发依赖验证。
Harness 仍处于 1.0 之前，客户端 slot 或快照契约可能变化。
适用场景与安装前检查¶
dsh-agent-replay 适合这些场景：
- 需要按时间回看一次 Harness 会话
- 需要检查消息、工具、命令、错误、时间戳与耗时
- 需要导出一个可交互、可分享的独立 HTML 文件
- 需要在不上传会话内容的前提下，生成脱敏后的分享页
安装前建议检查源码与 MIT 许可证。它会运行在当前 DSH/Harness 客户端环境中，并读取当前浏览器中已存在的会话快照，因此不应把它当作无权限的静态文件。
结尾¶
dsh-agent-replay 把 Harness 会话整理成可回放、可检查、可分享的独立 HTML，适合在需要说明一次会话过程、检查事件细节或导出分享材料时使用。
- GitHub：https://github.com/forrestsweet/dsh-agent-replay
- 目录页：资料中未提供具体 URL，可按
dsh-agent-replay在 DSH 插件目录中查找。
