DeepSeek Harness (DSH) 的 Web 界面在調試智能體時會生成大量日誌。這些日誌在 Turn 運行時和結束後會佔據大量屏幕空間,導致界面難以閱讀。dsh-reasoning-fold 插件引入了一種 Codex 風格的摺疊機制,將連續的操作流壓縮爲摘要行,在保持日誌可追溯性的同時,提升 Web 界面的整潔度。
插件介紹¶
這是一個爲 DSH Web 界面設計的摺疊插件,由 Iwwww 維護。它通過摺疊已完成操作和推理過程,將 Web 界面從雜亂的日誌堆中解放出來。
核心功能¶
- 保持最新操作可見:運行中的 Turn 僅顯示最近 3 個操作,其餘操作摺疊在摘要行下。
- 完成狀態摺疊:已完成的 Turn 會摺疊爲時長行(例如 “Worked 42s · 17 earlier actions”)。
- 精準摺疊類型:僅摺疊
tool-call、context、model-retry和reasoning類型的行,錯誤或未知節點類型保持原樣。 - 保留助手文本:摺疊推理正文時,不隱藏助手原本的文本內容;若步驟同時包含文本和推理,僅摺疊推理行。
- 保持滾動位置:摺疊操作不會讀取或修改頁面的滾動位置。
安裝與啓用¶
在終端執行以下命令安裝插件:
dsh plugin --profile web add dsh-reasoning-fold
安裝完成後刷新頁面即可生效。
使用方法¶
安裝後,在 Web 界面的 General 設置 中找到 Fold steps 選項,可選擇 Off、1、3、5 或 10。默認值爲 3。
注意事項¶
- 插件不干擾 DeepSeek Harness 自身的摺疊功能。
- 隱藏的單元使用
display: none樣式,不處理錨點跳轉。 - 運行環境需滿足 Node 22 或更新版本。
- 插件以當前 dsh 進程的權限運行,安裝前建議檢查源碼與許可證。
結語¶
通過 dsh-reasoning-fold,開發者可以在保持日誌可追溯的前提下,大幅提升 Web 界面的閱讀體驗。相關文檔與源碼可在 GitHub 查看。