前言¶

DSH 瀏覽器界面裏，工具調用結果默認收在摺疊中。如果你希望新到達的工具調用卡片自動打開，同時不想把內部塊裏的行數摺疊全部展開，可以使用 dsh-tool-autoexpand。它是一個 DSH client 插件，用來減少手工展開卡片的操作。

這是什麼¶

better-er/dsh-tool-autoexpand 是純瀏覽器端 client 插件，許可證爲 MIT。它不替換任何原生工具卡片渲染器，也不引入 host 行爲。插件會在 DSH web 界面中自動掛載，並在側欄底部提供一個默認開啓的開關。

核心功能¶

• 自動展開新渲染的工具調用卡片。
• 只展開卡片頂層摺疊行，不會誤開內部 ReadBlock、TerminalBlock、DiffBlock、SearchBlock 的行數摺疊。
• 側欄底部開關卡包含圖標、標題、ON/OFF 狀態膠囊和一句效果說明，並隨 DSH 明/暗主題自適應。
• 整卡可點擊，aria-pressed 同步狀態；切換即啓用或停用，無需重啓。

安裝與啓用¶

從 GitHub 安裝：

dsh plugin --profile web add github:better-er/dsh-tool-autoexpand

或安裝 npm 發佈的版本：

dsh plugin --profile web add dsh-tool-autoexpand

安裝命令執行後自動掛載，重啓 DSH web 後啓用，無需手工編輯任何組合文件。

典型用法¶

1、執行上面的安裝命令。

2、重啓 DSH web。

3、新到達的工具調用卡片自動展開頂層摺疊行。

4、需要關閉時，點擊側欄底部開關卡，ON/OFF 狀態即時切換，無需重啓。

適用場景與注意¶

適合在 DSH web 中查看工具調用結果、並希望新卡片默認展開的場景。注意它是當前 dsh profile 下的 client 插件，通過當前 dsh 命令安裝後隨 DSH web 加載；安裝前應檢查源碼和 MIT 許可證。

如果自行排查插件加載問題，lib/client.js 的 factory 必須以 return module.exports 結尾；否則模塊導出爲 undefined，DSH 啓動會 fail-loud。

如果不再需要，執行：

dsh plugin --profile web remove dsh-tool-autoexpand

徹底移除後，重啓 DSH web 後不再加載。

結尾¶

dsh-tool-autoexpand 的核心價值是：新工具調用卡片自動頂層展開，同時不打開內部塊的行數摺疊。GitHub 倉庫：https://github.com/better-er/dsh-tool-autoexpand