前言¶
在 DeepSeek Harness（DSH）Web 客戶端裏跑智能體，一個回合往往包含上下文注入、思考塊、工具調用和過程正文。這些內容默認全部展開，長會話裏界面很快被工作流佔滿，模型最終回覆反而要往下翻才能看到。
官方界面會顯示 Deep diving... 等狀態提示，但並不會把整段工作過程收成摘要行。dsh-auto-collapse 是一個純前端 DOM 插件，掛在 DSH Web 聊天界面上，把工具卡片與 Think 推理塊自動摺疊，呈現接近 VSCode Codex 桌面端的摺疊體驗，同時支持把狀態提示詞改爲可配置的 Deep sleeping...。下面介紹它的定位、能力與安裝方式。
這是什麼¶
dsh-auto-collapse 由 a179-sanae 維護，在 GitHub 上開源（MIT 許可，當前版本 0.1.4）。它不改動消息內容，只控制工作流程的顯示狀態；卸載（HMR stop）時可完整還原所有摺疊、隱藏與改寫。
插件掛在 DSH Web 聊天界面上，通過 DOM 操作把每個回合的工作過程收成一行摘要，點擊後再展開完整流程。目標是讓界面主要保留模型說的話。
核心功能¶
三級摺疊結構¶
- 一級：回合完成自動收起。每個回合完成後，工作過程收成一行
已處理 X秒，只留模型最終正文。點擊可展開完整工作流程（上下文注入 → 思考 → 工具調用 → 過程正文 → 最終正文）。 - 二級：工具與思考各自摺疊。展開一級後，工具調用組與思考塊各自摺疊成一行 chip（
正在運行 {命令}/運行了命令/已思考），點擊展開或收起。相鄰工具組合並，正文輸出是硬邊界，不會跨正文合併。 - 三級：思考合併。展開
已思考後，連續思考合併爲一個三級思考行（標題Think · 第一句），點擊展開合併內容塊；原始四級行不出現。
視覺與交互¶
- 圖標盒 16px、glyph 14px、行高 24px、行距 16px，顏色使用 DSH 原生 token（
--dsw-alias-label-*），思考與命令圖標取自 DSH 原生圖標（IconThinkOutline14/IconApiOutline14）。 - 點擊驅動的展開（淡入 + 4px 上移，合併思考正文帶高度展開）與收起（鏡像淡出）均爲 180ms；僅用戶點擊觸發動畫，流式協調器決策保持瞬時。
- running 狀態帶文字平滑呼吸動畫；
prefers-reduced-motion下停止動畫，過渡動畫同樣禁用。
流式與兼容性¶
同一個 assistant-step 原地補正文、React 換節點和歷史亂序掛載都會重新協調。除 tool-call 外，頂層 command / manual-compaction、context 和純圖片 final 都按同一回合語義處理。
可配置狀態提示詞¶
在 設置 → 插件 → 插件配置 中可以編輯「狀態提示詞」，默認 Deep sleeping...。留空保存後恢復官方 Deep diving...。
安裝與啓用¶
已發佈 npm 包，推薦用構建好的版本：
dsh plugin --profile web add "dsh-auto-collapse"
從 GitHub 安裝（開發版或需要跟隨 main 分支時）：
dsh plugin --profile web add "github:a179-sanae/dsh-auto-collapse#main"
安裝後重啓 DSH web 服務（或觸發插件 HMR），頁面 Ctrl+Shift+R 硬刷新即可生效。無需任何配置。
典型用法¶
安裝並刷新後，插件自動生效，無需額外命令。
查看摺疊效果：等一個回合完成後，工作過程會收成一行 已處理 X秒，模型最終正文留在界面上。點擊該行可展開完整工作流程。
調整狀態提示詞：打開 DSH Web 客戶端的 設置 → 插件 → 插件配置，編輯「狀態提示詞」。默認值爲 Deep sleeping...；若希望恢復官方文案，留空保存即可回到 Deep diving...。
卸載還原：通過 dsh plugin 移除插件並觸發 HMR stop，所有摺疊、隱藏與文案改寫會完整還原。
適用場景與注意¶
適合誰
- 經常在 DSH Web 上跑多步智能體任務，希望界面聚焦模型最終輸出。
- 習慣 VSCode Codex 桌面端摺疊體驗，想在 Web 端獲得類似交互。
- 需要可逆的 UI 增強，不希望改動底層消息數據。
使用前注意
- 插件以當前
dsh進程權限運行，安裝前應檢查 源碼 與 MIT 許可證。 - 純前端 DOM 插件，依賴 DSH Web 客戶端的 DOM 結構與 React 渲染行爲；DSH 大版本升級後若界面結構變化，可能需要等待插件適配。
- 社區目錄 SkillHub 是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
小結¶
dsh-auto-collapse 把 DSH Web 會話裏的工具調用與思考塊收成可展開的一行摘要，讓長對話界面更乾淨，同時保留完整工作流的可查看性。安裝一條命令即可啓用，狀態提示詞可按需配置。
