前言¶
在 DeepSeek Harness (DSH) 的開發與調試流程中,回溯歷史會話、復現特定交互或分析邏輯跳轉是常見需求。Bites the DSH 是一個插件,它將原生會話界面轉換爲只讀的回放視圖,無需打開額外的面板。它允許在不修改原始會話數據的情況下,通過 UI 或腳本控制時間線。
核心功能¶
該插件提供了以下能力:
- 原生入口與控件:在 DSH 原生會話頭部提供入口和緊湊的回放控件。
- 完整的回放控制:支持暫停、快進、倒放、單步調試、速度選擇、空閒間隙壓縮以及直接跳轉到事件/回合/時間點。
- 腳本控制接口:每個會話暴露一個可觀察控制器
ctx.sessionPlayback,用於通過腳本控制回放進度。 - 預覽與投影:提供可選的模擬打字預覽下一個用戶消息;通過 DSH 原生
ChatView進行歷史投影,源會話和當前活動狀態獨立運行。
安裝與啓用¶
在終端執行以下命令安裝插件並檢查狀態:
dsh plugin --profile web add @ch4acko3/bites-the-dsh
dsh harmony status --profile web
確認所有四個補丁報告爲 bound。隨後重新加載 WebUI,打開一個會話,在原生會話頭部使用 Replay session 進入回放模式。
腳本控制示例¶
其他 DSH 插件可以通過 ctx.sessionPlayback 服務控制回放:
const playback = ctx.sessionPlayback
playback.enter(sessionId)
playback.seekTime(sessionId, Date.parse('2026-08-20T12:00:00Z'))
playback.play(sessionId, 1)
playback.pause(sessionId)
playback.exit(sessionId)
seekTime 的參數使用 Unix 毫秒時間戳,與 JavaScript Date 對象和記錄的事件時間戳一致。該服務還支持事件/回合跳轉、倒放、速率和空閒間隙設置、訂閱以及位置讀取。
注意事項¶
- 只讀限制:回放期間,原生編輯器、模型控制、停止、分支和助手寫入操作被禁用,但查看控件保持可用。
- 兼容性:當前兼容性目標爲 DSH
0.1.0-rc.8。 - 運行環境:需要 Node.js
^22.22.3 || >=24.11.1和 pnpm 11。
總結¶
Bites the DSH 在 DSH 原生界面內提供了完全只讀、可腳本控制的歷史回放能力。它適合需要在開發過程中安全地審查或重放會話流程的場景。插件目錄與源碼倉庫見下方鏈接。