前言¶
在 DeepSeek Harness (DSH) Web 界面中，調試智能體時會產生大量連續的步驟卡片，包括工具調用、推理過程和上下文注入。這些內容堆疊在一起會佔據大量垂直空間，干擾視線。dsh-plugin-collapsible-steps 插件通過將連續的步驟卡片摺疊爲單個條目，來減少視覺噪音。
插件介紹¶
這是一個 DSH Web 插件，由 mervyn-teo 維護。它的核心作用是將消息之間連續的 collapsible-card 步驟運行摺疊爲一個 + N steps 的行。點擊該行即可摺疊或展開該組步驟。
核心功能¶
- 會話頭部控制：在會話頭部添加了“Collapse steps / Expand steps”控制按鈕。
- 步驟分組摺疊：在連續的步驟節點運行前添加
- N steps行。點擊該行可摺疊該組的所有卡片，只保留最新的一條卡片；再次點擊則展開。 - 步驟類型定義：插件定義了“step”類型，包括 tool-call、workflow-run、command、command-input、compaction、context、manual-compaction、model-retry 以及助手消息的 Think 摺疊區。用戶/助手消息和回合通知作爲分組邊界。
- 默認設置：在 Settings → Plugins → Collapsible steps 卡片中，可以控制
collapseByDefault（默認爲true），決定運行步驟是否默認摺疊。
安裝與啓用¶
使用 DSH 官方插件命令安裝。安裝後需重啓 dsh web 以加載主機端代碼。
dsh plugin --profile web add github:mervyn-teo/dsh-plugin-collapsible-steps
典型用法¶
- 在會話界面中，連續的步驟卡片前會出現
- N steps的行。 - 點擊該行，界面會摺疊該組所有卡片，僅保留最新的一條，下方顯示
+ N steps。 - 點擊
+ N steps可重新展開。 - 進入 Settings → Plugins → Collapsible steps 卡片，關閉
collapseByDefault以保持展開狀態。
適用場景與注意事項¶
依賴要求：該插件要求 DSH 掛載了基礎對話 UI (@deepseek-ai/dsh-client-ui-conversation)，它會將括號頭插入該 UI 的聊天流中。
實現方式：由於插槽系統的限制，插件無法包裹已發貨的對話卡片，因此它通過註解現有 DOM 來實現，即讀取會話鉤子中的節點順序，計算連續運行，並將括號頭插入現有 DOM，不移動節點本身。
安全性：插件以當前 dsh 進程權限運行，安裝前建議檢查源碼與許可證（MIT）。
兼容性：已發貨的對話卡片和 markdown 渲染保持不變，不受影響。
結語¶
該插件通過簡單的註解方式優化了 DSH Web 界面的步驟展示，適合需要在大量調試信息中保持界面整潔的開發者。
