在 DeepSeek Harness (DSH) 的調試與演示場景中,對話流通常包含大量的工具調用卡片和思考塊。這些內容對於排查問題很有價值,但在查看最終結果時往往造成視覺干擾。本文介紹 dsh-tool-fold 插件,它的核心作用是將所有處理內容摺疊爲單個開關,默認隱藏,僅保留用戶消息和助手回覆,從而提供更乾淨的視圖。
核心功能¶
- 最大摺疊模式:默認狀態下,所有工具調用卡片(
[data-chat-flow-kind="tool-call"])和思考塊([data-variant="think"])完全隱藏。對話界面僅顯示用戶消息和助手回覆。 - 全局開關控制:通過設置中的全局開關控制顯示與隱藏。開啓開關後,所有內容恢復原生渲染,保證零內容丟失。
- 狀態持久化:摺疊狀態會保存到瀏覽器的
localStorage中,刷新頁面後狀態保持不變。 - 渲染適配:自動適應流式傳輸和虛擬化渲染,無需修改主機代碼。
- 視覺區分:處理塊(如思考塊)在展開時會使用品牌藍色高亮顯示,以在視覺上區分“處理過程”與“最終結果”。
安裝與啓用¶
該插件爲純客戶端插件。安裝前需確保環境滿足以下依賴:
- 需要
@deepseek-ai/dsh-client-runtime - 需要
@deepseek-ai/cordis(^4.0.1)
安裝與啓用步驟如下:
- 將插件代碼下載到本地路徑,例如
/path/to/dsh-tool-fold。 - 執行安裝命令:
dsh plugin --profile web add /path/to/dsh-tool-fold
- 重啓
dsh web進程,並刷新頁面。 - 打開 設置 -> 通用設置(第 15 位),找到“全局摺疊開關”進行控制。
典型用法¶
- 查看原始流:在通用設置中開啓全局摺疊開關,此時對話中的所有工具調用卡片和思考塊會以品牌藍色高亮顯示,恢復完整的處理流程。
- 獲取乾淨視圖:關閉全局摺疊開關,隱藏所有工具調用和思考塊,僅保留用戶提問和助手回覆,界面更加簡潔。
注意事項¶
- 生態說明:本插件由社區維護,與 DeepSeek 官方無直接從屬關係。
- 許可證:基於 MIT 許可證。
- 安全檢查:安裝前建議檢查源碼與許可證,確保符合使用規範。
通過上述配置,開發者可以在保持對話完整性的同時,靈活切換“純淨模式”與“調試模式”。