运行环境切换 yukitakasama/dsh-env-switch

env-switch（运行环境切换）插件

在 dsh WebUI 中切换 agent 的运行环境与命令方言（bash / pwsh / git-bash）。切换实时生效：下一次发送消息或开启新会话时，模型就会按新环境的命令约定工作。

用法

/env # 查看当前环境与可用环境 /env bash # 切换到 Linux / Bash 环境 /env pwsh # 切换到 Windows PowerShell 环境 /env git-bash # 切换到 Git Bash 环境（默认）

切换结果写入 settings（跨会话持久化），系统提示的「当前运行环境」段落每次请求动态渲染，因此：

- 当前会话的下一条消息：模型即按新方言编写命令；
- 新会话：继承最后一次切换的环境（或部署默认 defaultShell）。

它做什么（机制）

| 部分 | 机制 |
| /env 命令 | 查看/切换环境；非法值拒绝 |
| 状态持久化 | settings 命名空间 env（{ shell: 'bash'\|'pwsh'\|'git-bash' }），文件落在 ~/.dsh/settings.yaml |
| 模型感知（实时） | system-prompt section env-switch/current（order 150）：text 是函数，每次请求组装时读取当前环境并渲染方言与执行指导 |
| shell 内可查 | 注册 DSH_SHELL_DIALECT 到 shell-env：模型每次 shell 调用可用 $env:DSH_SHELL_DIALECT 查询当前方言 |

各环境的提示内容（注入系统提示）：

- bash：bash 方言（ls/grep/sed…）、POSIX 路径、$VAR 变量；
- pwsh：PowerShell 方言（Get-ChildItem/Select-String…）、原生 C:\... 路径、$env:NAME 变量，并指导通过 pwsh -NoProfile -NonInteractive -Command "..." 包装执行；
- git-bash：bash 方言，路径同时支持 C:\Users\... 与 /c/Users/...。

安装

临时挂载（仓库根）：
pnpm dsh web --patch ./env-switch/cordis.yml

长期启用：把 env-switch/cordis.yml 的 insert 段合并进 $DSH_HOME/profiles/web/cordis.patch.yml（本机已合并）

cordis.yml 里的 name 是绝对路径；仓库位置不同请修改。

配置

| 配置项 | 默认 | 说明 |
| defaultShell | git-bash | 新用户首次使用前的环境 |

文件结构

env-switch/
src/index.ts # 插件本体（/env 命令 + 动态提示 + DSH_SHELL_DIALECT） cordis.yml # Web overlay 挂载配置 package.json # type: module（Node 加载 .ts 需要） verify-env.mjs # 离线验证脚本（隔离 DSH_HOME） README.md # 本文档

验证

node env-switch/verify-env.mjs

覆盖：/env 查看与切换、非法环境拒绝、幂等、settings 持久化、system-prompt section 在 bash/pwsh/git-bash 间切换后的实时渲染。

说明与边界

- 切换的是模型感知的环境与命令约定（方言、路径、执行指导）；实际 shell 执行仍走当前组合挂载的 ctx.shell 执行器（Windows 上为 Git Bash）。pwsh 环境下模型通过 pwsh -NoProfile -NonInteractive -Command "..." 包装执行 PowerShell 命令。
- 若要切换 ctx.shell 的执行器实现本身（bash-local ↔ pwsh-local），属于组合/配置层变更（profile 的 shell backend 行），不属于本插件范围。
- 插件注册依赖 settings、systemPrompt、shellEnv、commands 服务（base bundle 均自带）。