前言¶

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