使用

用户在 Web UI 设置默认终端：打开设置（齿轮）→ 通用 →「默认终端」下拉，选择 PowerShell / Git Bash / WSL 之一。改动即时生效并持久化。

模型看到 shell 工具后，执行命令时自动使用你选择的终端（工具不暴露终端参数，模型无法更改你的选择）：

默认终端 = Git Bash 时：shell(command: "git status") 走 Git Bash
默认终端 = WSL 时：shell(command: "ls -la /mnt/d/WorkSpace") 走 WSL；传 distro: "Ubuntu" 可指定发行版
默认终端 = PowerShell 时：shell(command: "Get-Process node") 走 PowerShell

模型使用示例

一次性命令（默认终端）：shell(command: "git status", description: "查看 git 状态")
跨轮保持状态（交互式）：terminal(action: "open") → 记下 sessionId → terminal(action: "send", sessionId, input: "cd /d/project\n") → terminal(action: "send", sessionId, input: "npm run dev\n") → terminal(action: "close", sessionId)
中断正在运行的程序：terminal(action: "signal", sessionId, signal: "SIGINT")
查看活动会话：terminal(action: "list")
沙箱拒绝后升级：shell(command: ..., sandbox_permissions: "workspace-write", justification: "...")

Web UI 设置（推荐）：设置 → 通用 →「默认终端」。

插件 row 的 config（覆盖默认，作为设置的 composition 基准）：