前言¶

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 倉庫。