前言¶
DeepSeek Harness (DSH) 採用插件架構，旨在通過模塊化擴展功能。在 WebUI 對話中，隨着交互輪次增加，界面內容會變得冗長。本插件通過引入 Codex-Desktop 風格的摺疊機制，將每個已完成 turn 的 Agent activity 壓縮爲摘要欄，同時保持最終答覆可見，從而保持對話界面的整潔。
插件簡介¶
- 名稱: dsh-turn-fold
- 定位: 爲 DSH WebUI 對話添加 Codex-Desktop 風格的回合摺疊
- 維護者: memorax-ai
- 許可: MIT
- 依賴: dsh-harmony
核心功能¶
- 摺疊機制: 自動摺疊已完成、已停止和被中斷的 turn。每種狀態擁有獨立的標籤。摺疊後的摘要欄默認顯示牆鍾時間、工具調用次數以及輸入/輸出 token 數量。
- 狀態保留: 插件會記住每個會話和具體 turn 的展開/摺疊狀態。
- 可訪問性: 支持鍵盤聚焦、狀態和操作標籤、響應式換行以及減少動畫處理。
- 渲染複用: 展開時複用原始原生節點渲染器，確保工具詳情、複製功能和文件鏈接正常工作。
- 智能展開: 當 DSH 標記關閉分支不可用、後續節點位於關閉答案之後、或用戶在活動區域內有鍵盤焦點或文本選中時，turn 保持展開，以防止錯誤或未完成工作被隱藏。
安裝與啓用¶
通過 CLI 安裝插件到 Web profile：
dsh plugin --profile web add github:memorax-ai/dsh-turn-fold
安裝完成後，可通過以下命令驗證狀態（確保三個補丁均爲 bound）：
dsh harmony status --profile web
兼容性與實現¶
該插件基於 dsh-harmony 運行，通過內存中的三個 Source Patches 對編譯後的瀏覽器包進行修改：
- inject-turn-fold-runtime: 向 ChatView 注入摺疊渲染器和 disclosure UI。
- rewrite-node-render-loop: 替換特定版本的原生節點列表 seam 爲每 turn 渲染器。
- install-turn-fold-services: 註冊本地化字典並綁定原生設置作用域。
支持的 DSH 版本範圍：
* DSH 0.1.0-rc.8 至 0.1.7
* DSH 0.2.0-rc.2
注意事項¶
- 渲染行爲: 無論摺疊與否，DSH 始終渲染推理過程、工具調用和上下文信息。
- 文件修改: 插件安裝的 DSH 文件不會被修改，卸載或禁用後可恢復原生摺疊。
- 選擇器匹配: 每個選擇器必須精確匹配一次；不兼容的編譯形狀會導致插件失敗（fail closed）。
- 測試覆蓋: 兼容性測試主要覆蓋 Windows 瀏覽器環境，包括啓動、持久化和回放。不覆蓋 macOS/Linux 上的真實模型調用或瀏覽器交互。
總結¶
dsh-turn-fold 通過摺疊機制優化 DSH WebUI 的長對話閱讀體驗，提供 Codex 風格的摘要視圖。更多細節可查閱 GitHub 倉庫 或 技能庫目錄。
