本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-bash-terminal

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-bash-terminal

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 终端由用户决定，AI 无法更改：Web UI 设置页（设置 → 通用）出现"默认终端"下拉（PowerShell / Git Bash / WSL）；shell 工具永远只使用该设置，不暴露终端参数给模型。设置通过 DSH settings 系统持久化（settings.yaml）。
• 不占用 ctx.shell 能力接缝：DSH 自带的沙箱化 pwsh 工具保持原样可用；本插件的 shell 工具是额外的多终端入口。
• 通过共享的 ctx.subprocess seam 派生进程：进程树终止（Windows taskkill /T）、SIGTERM→grace→SIGKILL、输出 spill 文件，与官方 dsh-tool-bash / dsh-tool-pwsh 行为一致。
• 后台任务注册进通用 jobs registry，支持 run_in_background / job_output / job_kill。
• 前端设置页的「默认终端」是枚举（UI 自动渲染为下拉），模型每次调用都只按该设置执行，无法自行切换终端。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件是做什么的？

给 DSH 的 Windows 用户一个统一的 shell 工具，让你选的"默认终端"（PowerShell / Git Bash / WSL）跑命令，并提供一个交互式 terminal 工具。

只在 Windows 上能用吗？

是。插件在非 win32 平台会直接跳过注册工具，所以 macOS / Linux 安装后不会有可用的 shell 工具。

AI 模型能自己切换终端吗？

不能。终端选择由你在设置 → 通用 → 默认终端里改，模型只看到"shell"工具，不暴露终端参数给它。

和官方 pwsh 工具冲突吗？

不冲突。官方沙箱化的 pwsh 工具仍按原样可用，本插件是额外的多终端入口，不占用 ctx.shell 接缝。

怎么卸载？

运行 install.ps1 uninstall 即可，它会恢复 DSH 设置白名单、清理 patch、从 profile bundles 中移除插件。

— 源: plugin_wiki.faq_json

兼容性

• DSH: ^0.1.0-rc.6
• Node: >=20
• Platforms: Windows
• Native modules: node-pty

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则