前言¶
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 插件目錄中查找。
