前言¶
在 DeepSeek Harness Web 界面查看推理和工具調用時，信息層級可能變得複雜。dsh-turn-fold 插件通過將相關的推理步驟和工具調用分組爲可摺疊的結構，解決了這一問題。它安裝爲本地配置文件層，允許用戶在保持最終回覆可見的同時，摺疊已完成輪次的過程細節。
插件定位¶
- 名稱：dsh-turn-fold
- 維護者：ruisenbai
- 類別：客戶端
- 核心功能：將推理和工具調用分組爲可摺疊步驟；已完成的輪次摺疊其過程但保留最終回覆；支持 Diff 可視化、路徑複製和偏好設置持久化。
安裝與配置¶
此插件需要 DeepSeek Harness 0.1.5-alpha.1。源碼開發需要 Node.js 環境（^22.19.0 || >=24.0.0）。
在 DeepSeek Harness 倉庫根目錄下執行以下命令：
cd dsh-turn-fold
npm run dev:link
npm run build
dsh plugin --profile web add "$PWD" --offline
安裝完成後，刷新正在運行的 Web 頁面以激活插件。
使用說明¶
基本摺疊與展開¶
- 流式回覆期間：連續的推理和工具調用會共享一個摺疊條，文本內容在步驟間可見。
- 回覆完成後：一個輪次的完整過程會摺疊爲一個條。點擊該條以查看步驟，再點擊單個步驟以展開原始的推理卡片和工具卡片。
摘要與路徑複製¶
- 摘要信息：顯示工具類型圖標、文件名、以及讀取、編輯、搜索、命令、其他工具和失敗的計數。
- 複製路徑：點擊摘要中的文件名可複製其完整工作區路徑，不會改變摺疊狀態。
- Diff 可視化：成功的編輯操作會顯示添加和移除的行（Diff），排除未改變的上下文。
配置入口¶
進入 Settings → Plugins，點擊 Conversation folding 卡片。在此處可以配置摺疊行爲、自動摺疊選項以及顯示的指標（如持續時間、Token 使用量、緩存命中率等）。
功能細節¶
- 多語言支持：包含英文和中文設置。
- 交互反饋：展開、摺疊和內容增長使用過渡動畫；支持系統“減少運動”偏好設置。
- 狀態管理：偏好設置會跨刷新持久化；關閉插件會恢復安裝前的原生摺疊狀態。
- Diff 細節：多塊內容會累積顯示；失敗或未完成的編輯沒有行統計；匹配的文件名會顯示其路徑以示區分。
注意事項¶
- 插件通過 Bundle patch 注入 Host 插件，並接管了原生的摺疊狀態管理。
- 插件擁有派生的呈現方式和臨時的查看選擇權，不發佈運行時不變量伴侶。
- 在使用前請確保本地環境滿足 Node.js 版本要求，並檢查與 DeepSeek Harness 版本的兼容性。
