重启 dsh web，打开「设置 → 插件 → 插件配置」开始配置

**npm 安装（一条命令）**：

```sh
dsh plugin --profile web add dsh-windows-shell-policy

Release ZIP 安装：

1. 从 Releases 下载 dsh-windows-shell-policy-v*.zip 并解压
2. dsh plugin --profile web add link:
3. 重启 dsh web，打开「设置 → 插件 → 插件配置」开始配置

注入器安装（免重启，开发环境）：

DSH_CHECKOUT= bash scripts/build.sh   # 产出 lib/index.js + lib/client.js
dev_inject_plugin                       # host+UI 即时生效

配置指南

「设置 → 插件 → 插件配置」内展开「默认 Shell」卡片：

选项	行为
自动	探测到 git-bash 则用 bash，否则回落 pwsh（开箱即用）
bash	强制 git-bash（未探测到 bash 时回落 pwsh 并提示）
pwsh	强制 PowerShell（维持 DSH 默认行为）

切换保存后下一次请求生效；preferred 持久化于 settings 文档 shell-policy section，重启保留。显式 bash 路径可通过 settings.yaml 的 shell-policy.bashPath 配置（面板编辑在规划中）。

反馈

问题、需求、使用体验：提交到 issue #1（欢迎反馈）。

贡献者

贡献者	贡献
LAN-TINA-WS	项目作者与维护者

License

本项目采用 MIT License。

开发者文档

开发工艺（编写规范、DSH 能力清单、组合插件转正流程）见 docs/：

文档	内容
conventions.md	插件编写规范与常见失败速查
capabilities-host.md	DSH Host 服务/事件清单（本插件用到的）
capabilities-client.md	DSH Client 槽位/服务清单（本插件用到的）
roadmap-composition.md	组合插件转正施工记录

仓库结构：src/（host + client 源码）、scripts/（构建）、docs/（文档与截图）、cordis.patch.yml（bundle patch 装配）。

配置指南

「设置 → 插件 → 插件配置」内展开「默认 Shell」卡片：

选项	行为
自动	探测到 git-bash 则用 bash，否则回落 pwsh（开箱即用）
bash	强制 git-bash（未探测到 bash 时回落 pwsh 并提示）
pwsh	强制 PowerShell（维持 DSH 默认行为）

切换保存后下一次请求生效；preferred 持久化于 settings 文档 shell-policy section，重启保留。显式 bash 路径可通过 settings.yaml 的 shell-policy.bashPath 配置（面板编辑在规划中）。