前言¶
DeepSeek Harness（DSH）採用插件化架構，允許開發者擴展其功能。在智能體開發過程中，調試特定步驟或重試已完成的操作是常見需求。dsh-session-rerun 旨在解決這一痛點，提供一種在不影響原始會話數據的前提下，檢查歷史步驟並重新執行的能力。
插件簡介¶
這是一個 DeepSeek Harness 的 Web 插件，由用戶 liuyangdongdong 維護。它主要用於檢查和重放已完成的會話步驟，幫助開發者分析模型回覆、工具調用結果以及執行過程中的耗時。
核心功能¶
- 會話時間線分組：按回合和步驟對持久會話時間線進行分組，便於梳理交互過程。
- 詳細狀態展示：顯示模型回覆、工具調用、技能使用、失敗狀態以及每一步的經過時間。
- 文件引用標記：在步驟右側顯示腳本和 Markdown 文件名的緊湊徽章，方便定位相關文件。
- 頂層步驟重放：在不修改源會話的情況下，在新會話中重放選定的頂層步驟。
- 子代理步驟重放：通過新主會話在原始工作區中重放選定的子代理步驟。新主會話僅重建委託調用，等待新子代理結果並繼續執行。
安裝與啓用¶
安裝插件需要使用 DeepSeek Harness 的命令行工具。
- 安裝插件：
npx @deepseek-ai/dsh plugin --profile web add github:liuyangdongdong/dsh-session-rerun
- 啓動 Web 界面：
npx @deepseek-ai/dsh web
- 安裝或替換插件後，必須重啓已運行的 Web 進程才能使插件生效。
典型用法¶
在 Web 界面中，插件會展示會話的歷史步驟。開發者可以點擊特定的步驟進行重放：
* 對於普通步驟，新代理將接收到選中步驟之前的持久歷史記錄和該步驟記錄的用戶輸入。
* 對於子代理步驟，插件會創建新的主會話和子會話，子會話重放選中的步驟，主會話則重建委託調用並等待子會話結果。
適用場景與注意事項¶
適用場景¶
- 需要回溯已完成的會話並驗證結果。
- 需要調整特定步驟的輸入或參數。
- 需要分析工具調用的具體參數和返回值。
注意事項¶
- 數據安全：插件從不修改源會話，重放操作會生成全新的會話。
- 嵌套限制：故意不支持嵌套子代理重放。
- 步驟完整性：重放的步驟必須存在，並且擁有匹配的
step/end事件。 - 開發者預覽：DeepSeek Harness 處於開發者預覽階段，對等依賴版本可能需要隨上游發佈而移動。
總結¶
dsh-session-rerun 爲 DeepSeek Harness 用戶提供了檢查和重放歷史會話步驟的實用工具。通過清晰的界面展示和靈活的重放機制，它有助於提升智能體開發和調試的效率。
