前言¶
在 DeepSeek Harness 的 Web 界面調試 Agent 時,完整的軌跡往往包含大量中間步驟,如工具調用、steering、workflow 運行和上下文注入等,導致界面雜亂。下面介紹一個插件,可以在摺疊這些中間軌跡的同時,始終保留 Agent 的最終輸出。
插件介紹¶
名稱:awesomehou/dsh-trajectory-collapse
維護者:AwesomeHou
定位:DeepSeek Harness Web 界面永久插件
核心價值:摺疊 Agent 軌跡,同時始終保留 Agent 的最終輸出。
核心功能¶
-
逐輪次摺疊 Agent 軌跡
插件在每個已完成的 Agent 輸出頂部注入了一個Expand trace / Collapse trace按鈕。摺疊是以輪次爲單位的,你可以單獨控制每一次輸出的軌跡摺疊狀態。 -
始終保留最終輸出
即使摺疊後,用戶消息與收尾的助手輸出也始終可見,只有中間的軌跡被隱藏。 -
支持多種軌跡類型
支持摺疊的類型包括:tool-call、assistant-step、steering、workflow、context以及unknown行。 -
默認摺疊設置
在設置中可以配置默認摺疊行爲。進入 設置 -> 通用,勾選Collapse agent trace by default after final output即可開啓。該項默認勾選。
安裝與啓用¶
該插件是永久插件,必須安裝到 web profile。
- 在 DeepSeek Harness 的
webprofile 目錄下執行安裝命令:
dsh plugin --profile web add <本倉庫路徑>
安裝完成後重啓 Harness。
- 其他安裝方式:
- 命令行:直接叫 Agent 幫你安裝,例如:
幫我安裝這個插件:https://github.com/AwesomeHou/dsh-trajectory-collapse
- 插件市場:先安裝插件市場(https://github.com/AwesomeHou/dsh-plugin-marketplace),然後從市場內搜索安裝。
典型用法¶
-
開啓默認摺疊:
進入 設置 -> 通用,勾選Collapse agent trace by default after final output。這樣在 Agent 輸出完成後,軌跡會自動摺疊。 -
手動摺疊/展開:
在聊天界面中,點擊軌跡頂部的小按鈕(Expand trace/Collapse trace)即可手動控制特定輪次的軌跡顯示。
適用場景與注意¶
- 適用場景:適用於需要在 DeepSeek Harness Web 界面查看長軌跡、但希望保持界面整潔的開發者。
- 注意:
- 插件以當前 DSH 進程權限運行。
- 安裝前建議檢查源碼與許可證(MIT)。
- 這是一個永久插件,需安裝到
webprofile。
結語¶
該插件通過提供逐輪次的摺疊控制,解決了長軌跡帶來的界面雜亂問題。更多細節與源碼可參考其目錄頁或 GitHub 倉庫。