前言¶

DeepSeek Harness (DSH) 是一个基于插件架构的智能体开发框架。在实际使用中，开发者常需要将对话记录导出为便于分享和回放的格式。DSH 原生的 /export 命令下载的是原始日志压缩包，适合机器处理。本插件旨在解决这一痛点，将 DSH 会话转化为自包含的 HTML 文件。

插件定位¶

本插件由 zoyluoblue 维护，是一个 DSH 客户端插件。它将 DSH 会话导出为无依赖的 HTML 文件，支持毫秒级真实回放、可搜索的完整对话记录以及忠实呈现工具卡片。

核心功能¶

1. 自包含文件：导出为 HTML 文件（无依赖），CSS、JavaScript 和图片内联。双击即可在任何静态主机上打开，支持离线工作（零外部请求）。
2. 真实回放：包含流式输出的毫秒级真实回放。播放器支持速度调节，长暂停会自动压缩以避免卡顿。
3. 对话记录：页面默认以完整对话形式展示，支持搜索和 Ctrl+F 快捷键。即使不运行 JavaScript，也能查看标题、时间戳和统计信息。
4. 工具卡片：忠实呈现终端输出、搜索结果、文件读取、Web 结果等工具调用，并在同一作用域下解析。
5. 子代理会话：委托会话以内联折叠块的形式展示在主时间轴中，包含自身的工具调用。
6. 敏感信息脱敏：默认对凭证、路径等进行脱敏预览。导出前可在预览列表中检查并取消误报。
7. 主题适配：支持亮色、暗色及系统主题，适配手机屏幕。

安装与启用¶

执行以下命令安装插件。安装后需要重启 dsh web 进程，设置页面左侧导航才会出现 “Replay” 入口。

dsh plugin --profile web add @zoytown/dsh-replay

典型用法¶

1. 通过设置页面：打开设置 -> 回放，选择会话，预览脱敏内容，选择 HTML 或 Markdown 格式并导出。
2. 通过命令行：在对话中使用 /share 导出当前会话为 HTML，或 /share markdown 导出为 Markdown。
3. 通过工具：让代理执行 session_export 工具，它会将会话记录写入本地文件并返回路径。

适用场景与注意¶

• 环境依赖：需要 Node.js 22.19 或 24+ 版本，并配置提供 ctx.sessionQuery 的 web profile。
• 输出目录：默认输出目录为 $DSH_HOME/replay/（即 ~/.dsh/replay/），文件命名格式为 <session-title>-<UTC timestamp>.<ext>。
• 隐私与安全：插件纯本地运行，无网络访问或遥测。导出的 HTML 文件本身也不包含任何外部请求，可在断网环境下打开。
• 许可证：采用 MIT 许可证。

总结¶

经过上面的步骤，你可以在本地将 DSH 会话转化为自包含的 HTML 文件。该插件通过本地化处理和自包含文件格式，解决了 DSH 会话分享与回放的需求，同时保证了数据隐私。更多信息请查阅插件目录 链接 或 GitHub 仓库。