dsh-thought-fold：DeepSeek Harness 的原生執行過程摺疊與樣式增強插件

前言¶

DeepSeek Harness (DSH) 在處理長任務或高頻代碼重構時，中間的思考過程與工具調用往往會佔據大量屏幕空間。這使得閱讀核心結論和與輸入區交互變得困難，閱讀節奏容易被打斷。

dsh-thought-fold 是一個用於解決這一問題的插件。它通過摺疊長過程、整理中斷狀態以及提供隨行浮動收起功能，讓長對話更易閱讀，同時保持數據完整性和零指令侵入。

插件概覽¶

該插件由 new-Beginner 維護，屬於客戶端類別，採用 MIT 許可證。它不涉及模型提示詞注入，也不改寫消息 DOM 或破壞 React 節點生命週期，僅作爲 UI 增強層運行。

核心功能¶

1. 長過程智能收起
   默認自動摺疊已完成的思考與工具調用。用戶消息、最終回答與關鍵狀態提示始終完整保留。在加載老會話或歷史延遲補載時，同樣自動生效。需要細節時，可一鍵展開。

2. Codex 兩級摺疊
   運行期間，普通正文持續實時顯示，默認每段正文之間只有一個“過程”入口。原生思考摘要、工具調用、上下文等非正文過程默認統一收起。展開長內容後，默認限高並可內部滾動。

3. 中斷過程安全整理
   當任務手動停止、出錯或觸達長度限制時，插件會自動整理已結束的過程內容，完整保留中斷前最後輸出的有效正文卡片與錯誤狀態，避免誤判斷網等待或重試。

4. 雙端收起與隨行浮動
   展開過程底部設有“收起過程”按鈕。當過程較長被輸入框遮擋時，唯一的浮動收起按鈕會自適應吸附在輸入區上方。多輪同時展開時互不衝突。

5. 狀態持久且完全可恢復
   頁面重繪、窗口尺寸變化不會打亂用戶手動展開的選擇。原生緊湊與標準模式切換雙向保留選擇狀態。停用插件時即刻撤銷所有顯示代理，零殘留。

6. 純 UI 增強，零指令侵入
   不向模型注入任何 System Prompt，完全遵循模型原有習慣。僅使用安全的 CSS 標記與局部會話作用域觀察，不掃描 document.body。

安裝與啓用¶

在終端中執行以下命令即可安裝該插件（以桌面端爲例）：

dsh plugin --profile desktop add github:new-Beginner/dsh-thought-fold

安裝完成後，需要重啓 DeepSeek Harness 才能生效。

配置與用法¶

設置面板¶

插件會在 DeepSeek Harness 的設置中心注入專屬管理頁。你可以在此直接控制插件、視覺增強以及思考與工具的默認摺疊狀態。

配置項¶

通過 settings.yaml 文件或設置面板進行配置，支持以下選項：

dsh-thought-fold:
  enabled: true        # 啓用插件核心功能
  showLiveHud: true    # 開啓視覺增強樣式
  foldReasoning: true  # 默認收起思考（包括原生思考摘要）
  foldTools: true      # 默認收起工具、上下文等其他非正文過程
  foldStyle: codex     # 按鈕外觀風格：codex | minimal | clean

快捷指令¶

在輸入框中可直接使用斜槓指令進行控制：

• /fold status：查看插件當前啓用狀態、HUD 樣式與外觀模式。
• /fold toggle：一鍵切換插件的開啓與關閉。
• /fold help：查看指令幫助說明。

技術細節與質量¶

• 環境要求：需要 Node.js >= 20.0.0。
• 架構設計：採用會話插槽掛載，不破壞 React 節點生命週期。
• 測試覆蓋：包含 26 項 Node.js 測試（涵蓋完成態總包絡判定、設置異步生命週期等）與 42 項真實 Edge 瀏覽器測試（涵蓋真實 React 18 節點掛載、流式外露與準確計時等）。
• 可搜索隱藏：兼容摺疊採用 hidden="until-found" 機制，摺疊狀態下依然支持瀏覽器原生 Ctrl + F 查找。

適用場景與注意¶

該插件適合處理長任務、高頻代碼重構或多輪工具調用的場景。使用前請確認插件以當前 DSH 進程權限運行，並建議檢查源碼與許可證。

結語¶

dsh-thought-fold 提供了一種剋制且可恢復的思考與工具過程摺疊方案。它通過 UI 層面的優化，解決了長對話閱讀困難的問題，同時保持了與宿主系統的低耦合。

• 插件目錄頁
• GitHub 倉庫