在 DeepSeek Harness 中調試 Agent 時,完整的執行軌跡(工具調用、思考過程、steering、workflow 運行、上下文注入等)往往佔據大量篇幅,容易干擾對最終結果的查看。dsh-trace-collapse 插件針對這一場景,提供了一種在不丟失關鍵信息的前提下簡化界面的方案。
插件定位¶
這是一個 DeepSeek Harness Web 客戶端插件,由 AwesomeHou 維護。它通過摺疊中間的執行步驟,讓用戶始終能聚焦於用戶提問與 Agent 的最終回覆。
核心功能¶
1. 按輪次摺疊¶
摺疊操作以輪次爲單位。每個已完成的 Agent 輸出頂部會出現一個摺疊按鈕。點擊後,該輪次下的中間軌跡會被隱藏,需要時可以隨時展開。
2. 保留最終輸出¶
無論是否摺疊,該插件始終保留用戶提問與 Agent 的最終輸出內容。只有中間的輔助軌跡會被隱藏。
3. 支持摺疊的類型¶
插件支持對以下類型的軌跡進行摺疊:
- tool-call:工具調用
- assistant-step:思考步驟(非最終輸出)
- steering:steering
- workflow:workflow 運行
- context:上下文注入
- unknown:未知類型
4. 默認摺疊設置¶
在 設置 → 通用 中,有一個勾選項 Collapse agent trace by default after final output。該選項默認勾選。勾選後,每次 Agent 輸出完成後,軌跡會自動摺疊;取消勾選則默認保持展開。
安裝¶
該插件需要安裝到 web profile 的永久 bundle 中。
dsh plugin --profile web add <本倉庫路徑>
安裝完成後重啓 Harness。
使用方式¶
- 手動摺疊:在聊天界面中,點擊每條 Agent 回覆頂部出現的「Collapse trace」按鈕即可摺疊當前輪次的軌跡。
- 默認摺疊:在設置中勾選默認摺疊選項,後續輪次會自動應用此行爲。
- 查看效果:參考文檔中的演示 GIF,對比摺疊前後的界面差異。
注意事項¶
- 插件以瀏覽器端功能爲主,Host 半邊僅爲空操作。
- 插件遵循 MIT 許可證。
- 安裝前請確認倉庫來源與許可證。
總結¶
dsh-trace-collapse 提供了一種輕量級的方式來清理 DeepSeek Harness 的 Web 界面,特別適合調試需要大量中間步驟的長流程 Agent。
- 插件目錄:https://www.skillhub.cn/plugins/AwesomeHou/dsh-trace-collapse
- 源碼地址:https://github.com/AwesomeHou/dsh-trace-collapse