road-kid/dsh-terminal-shell ↗★ 0
dsh-terminal-shell
在Windows上切换终端工具所使用的Shell 适合需要在Windows系统上将默认终端切换为Git Bash或CMD的用户。
安裝
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:road-kid/dsh-terminal-shell說明文件
閱讀完整 README ↗dsh-terminal-shell
在 Windows 上选择模型的终端工具背后用哪个 shell:PowerShell、本机 Git Bash,或 cmd.exe。
设计取向:一个开关、所有 preset 跟随、不动 preset 文件、不接管全局 ctx.shell。默认 dialect: pwsh,装上去什么都不变;改成 bash 或 cmd 后,新会话拿到对应的工具、其它 shell 工具从该会话的工具目录里消失,已开的会话保持原状。
临时替代方案:DSH 目前没有内置的「终端 / shell 选择」能力。在官方能力落地前,本插件是它的临时替代方案——用官方已发布的执行器与工具,把 Windows 上新会话的终端换掉;Windows 受限沙箱档位下的
confinedPolicy同属这段临时接线。官方提供等价设置后即可停用本插件:从 profile 依赖里移除本行并重启,新会话即回到官方终端工具。插件不改 DSH 安装目录、不改任何 preset、不接管全局ctx.shell,配置只写进当前 profile 的 patch 层;卸载不需要清理任何全局状态。minimalMode: variant是这条界线上的例外,但不是对它的破坏:持久终端版本以新增预设minimal-gitbash的形式注册,官方minimal预设原样保留;没有会话再引用它时,这个预设会自行消失。详见极简模式。
为什么要这个插件
DSH 0.2.1-rc.2 的平台组合在 Windows 上是互斥的:
- id: bash-sandbox
name: '@deepseek-ai/dsh-bash-sandbox'
disabled: !!js process.platform === 'win32'
- id: pwsh-sandbox
name: '@deepseek-ai/dsh-pwsh-sandbox'
disabled: !!js process.platform !== 'win32'
- id: tool-bash # 同样的平台断言
- id: tool-pwsh
ctx.shell 是单实例服务(同一 context 内加载第二个会抛错),所以 Windows 上根本没有 bash 执行器,bash 工具也不存在。想用 Git Bash 只有三条路:
| 路线 | 代价 |
|---|---|
改 dsh-base / profile patch 的平台断言 | 要动第一方组合,重启,且只影响那一个平面 |
| 自研 PTY / 自研工具 | 重写 60KB+ 的工具契约,容易与官方行为漂移 |
| 本插件:会话级隔离替换 | 只在新会话的 isolate('shell') 子树里注入执行器,宿主平面不动 |
本插件选第三条。
工作原理
插件本身不实现终端。它做四件事,全部复用第一方组件(官方 minimal 预设另有一个变体入口,见极简模式;cmd 方言是唯一的例外,见CMD 方言):
-
执行器:
GitBashExecutor extends LocalBashExecutor,只改三处——execute()用配置的bash.exe绝对路径组[bash, -c, command](基类硬编码"bash",在 Windows 上会命中System32\bash.exe,那是 WSL 启动器);resolve()注入PATH(spawnSpec里spec.env是唯一能塞 PATH 的位置);- 受限档位下按
confinedPolicy选择直接启动、走官方ctx.sandbox.confine(),还是明确报错(见「受限沙箱策略」)。
超时、输出收集与溢出、abort 分类、
dshEnv合并、结果整形全部继承,行为与官方 bash 执行器一致。 -
工具本体:直接挂官方
@deepseek-ai/dsh-tool-bash。前台/后台、超时转后台、sandbox_permissions升级、会话 cwd、工具卡片、退出码标记,官方自带。(cmd方言不能这样——官方工具名与执行器都绑死了bash/pwsh,所以cmd用的是逐字移植的src/cmd/tool.ts。) -
会话级替换(
src/replace.ts,在agent/created里执行):shellCtx = agentCtx.isolate('shell') // 该 agent 私有的 shell realm shellCtx.plugin(GitBashExecutor, {...}) // 只在这个子树里可见 shellCtx.plugin(ToolBash, {...}) // 注册出的 bash 落在 agent 自己的工具层 agentCtx.tools.restrict({ deny: ['pwsh'] }) // 只过滤「继承来的」工具 agentCtx.systemPrompt.section({ name: 'tool:pwsh', text: '' }) // 空文本=渲染时丢弃四步都登记在
agentCtx上,会话结束由 cordis 逆序释放;中途失败则逆序回滚,会话退化为原样。 -
配置与设置行:所有字段
.volatile(),同一份 entry Config 由 Host 交给官方configForms服务;客户端半区(lib/client.js)把它渲染成 设置 → 通用 → 终端工具 的一行,写回仍落在 profile 的 patch 层。行内控件全部复用官方@deepseek-ai/dsh-client-ui-primitives的Button/Input/Menu/IconChevronDownOutlineRegular,外观与相邻的官方设置项同源;该包只作为 devDependency 提供类型,运行时由 Web shell 的冻结模块表(PLATFORM_MODULES)播种,bundle 像require('react')一样require()它,插件不在运行时安装任何依赖。
关键设计约束(为什么不那么做)
- 不接管全局
ctx.shell:那会让所有会话(包括没选 bash / cmd 的)跟着变,并且与宿主平台的执行器冲突。 - 不编辑 preset:
preset-standard在 profile 里是完整快照,改它等于接管用户的组合文件,且升级会被覆盖。极简模式的变体同理——它是新增一个注册项(minimal-gitbash),不是改官方minimal的定义。 - 只对新会话生效:工具与 prompt 是会话创建时装配的,运行中换不掉——这是 DSH 的语义,不是插件的取舍。
restrict只过滤继承层:官方文档明确 "never what its OWN layer registers",所以从 agent scope 调restrict({deny:['pwsh']})恰好只隐藏 preset 带进来的pwsh,不影响本层注册的bash;cmd方言用restrict({deny:['pwsh','bash']})隐藏两个继承工具(先tools.get确认可见,隐藏不存在的名字会抛错),本层注册的cmd不受影响。- 沙箱策略是显式配置,不由插件悄悄绕过:默认
confinedPolicy: unconfined在 Windows 受限档位下直接启动 Git Bash,命令因此不受文件沙箱约束——这是用户在设置里看得到、可改回的选择;escalate仍走官方ctx.sandbox.confine()与官方审批,fail明确报错。插件只把 MSYS 启动失败分类成denied,不自己实现审批。
安装
前置条件
- Windows + DSH Desktop `>=0.2.1-rc.2 .dsh\profiles\desktop\package.json
插件包自带 `dsh.bundle.patch`,profile 的组合层会读取它并插入:
```yaml
- insert:
- id: terminal-shell
name: dsh-terminal-shell
disabled: !!js process.platform !== 'win32'
安装或升级后必须重启 DSH:运行中插入的 row 只进组合树,插件的 apply 不会被调用。
启用
重启后打开 设置 → 通用,底部会多出一行 终端工具(客户端半区注册的 settings.general.item 行,id terminal-shell,order 60):
终端工具 [命令提示符(cmd) ▾]
模型执行命令时使用的终端;改动只影响新会话。
cmd.exe 路径 [C:/WINDOWS/system32/cmd.exe] [自动发现]
控制台代码页 [65001]
受限沙箱时 [先走官方沙箱(escalate) ▾]
(上面是选中 cmd 后的样子;默认 pwsh 时没有后续行。)
- 版式与官方 General 段设置行一致:两列,左侧标题(14px/20px)+ 一句说明(12px/18px),右侧控件;24px 列间距、16px 纵向内边距、
.5px底部分隔线(--dsw-alias-border-l2)。颜色全部取--dsw-alias-*设计变量,跟随主题。 - 终端类型是一枚官方下拉触发器(36px、
--dsw-radius-md、--dsw-alias-bg-module-platform、chevron),点开是官方Menu——与官方段里所有枚举型偏好的渲染方式相同。三项顺序为PowerShell(pwsh)/Git Bash(bash)/命令提示符(cmd)。默认pwsh:装插件本身不改变任何行为。 - 选
bash后才出现路径行。路径默认是官方Input,直接填bash.exe的完整路径;「自动发现」命中多于一条时,输入框换成同一套下拉,列出全部可用路径。路径为空时有提示;扫描中按钮文案变为「正在扫描…」,扫不到会明确提示,而不是清空输入。 - 选
cmd后出现的是cmd.exe路径、控制台代码页、受限沙箱时 三行;bash专属字段(loginShell/extraPath/pythonUtf8/minimalMode/ bash 的confinedPolicy)在该方言下隐藏。cmd行始终带一条限制说明(一次性批处理、%VAR%展开、%~dp0指向内部脚本、回显不可恢复、非 ASCII 依赖代码页)。 - 已经选好的路径不会被后续扫描改写(除非它已失效)。
bash时路径行之后还有 受限沙箱时 下拉(unconfined/escalate/fail,默认unconfined);选中unconfined会显示提示:模型执行的命令不受文件沙箱限制。三种取值的后果见「受限沙箱策略」。- 再下一行是 极简模式 下拉(
leave/oneshot/variant,默认oneshot),只在方言为bash且平台受支持时出现,用于处理官方minimal预设的持久终端。选variant后行内会显示变体状态:已注册 / 注册失败(带原因);关掉选项但仍有会话引用时,提示里会给出引用数。见极简模式。 - 挂载时不扫描、不写配置:扫描只在点「自动发现」时发生,并把选中的
bashPath与可用列表bashCandidates原子写回;/state只读配置,所以打开设置是瞬时的。运行中的会话保持启动时的终端类型——这是 DSH 的装配语义。 - 能力或设置服务不可用时行内会说明原因(例如「当前 DSH 版本不支持自动切换:{reason}」);配置只读时所有控件禁用。非 Windows 上整行不渲染。
设置行通过两条 /api 路由(都不写配置;写入仍走 configForms,落 profile patch 层):
| 路由 | 作用 |
|---|---|
POST /api/dsh-terminal-shell/state | 平台、设置可用性、当前值、能力探测。不扫描,所以打开设置是瞬时的 |
POST /api/dsh-terminal-shell/discover | 用户点「自动发现」时才调用,返回全部可用候选 |
Config 字段(设置行直接编辑 dialect、confinedPolicy 与 bashPath;点「自动发现」会原子写回 bashPath + bashCandidates;其余字段仍可直接写 profile patch):
| 字段 | 说明 |
|---|---|
dialect | pwsh(默认,行为不变)/ bash / cmd |
bashPath | 显式 bash.exe 绝对路径;留空 = 自动发现 |
bashCandidates | 上一次「自动发现」的可用路径(也接受手填的安装根目录) |
autoDiscover | 会话装配时 bashPath 为空是否自动发现 |
discoverTimeoutMs | 一次发现的上限(只 stat 文件,不 spawn) |
loginShell | 传 -l,读取登录 profile |
extraPath | 追加到子进程 PATH 的目录 |
pythonUtf8 | 导出 PYTHONIOENCODING=utf-8 |
confinedPolicy | Windows 受限档位下的处理方式:unconfined(默认,直接启动,不经文件沙箱)/ escalate(先走官方沙箱;首次失败返回官方 denial 提示,模型带 sandbox_permissions 重试并审批)/ fail(抛 SandboxUnavailableError,提示改配置) |
minimalMode | 官方 minimal 预设的处理方式:leave(保留官方持久终端)/ oneshot(默认,旧行为,换成一次性 bash)/ variant(另注册持久 Git Bash 预设 minimal-gitbash)。只影响 minimal 会话 |
cmdPath | 显式 cmd.exe 绝对路径;留空 = %ComSpec% → %SystemRoot%\System32\cmd.exe |
cmdCodePage | 脚本里 chcp 的代码页,默认 65001(UTF-8)。改成别的值只影响 cmd 会话内的控制台代码页 |
cmdConfinedPolicy | cmd 方言在受限档位下的处理方式:escalate(默认,走官方沙箱)/ unconfined(直接启动)。没有 fail |
timeoutMs / maxTimeoutMs / maxOutputBytes / maxSpillBytes / graceMs | 继承自官方 bash 执行器的同名字段 |
把 dialect 改成 bash,新建会话即可看到工具目录里是 bash 而不再是 pwsh。已开的会话不受影响。
自动发现顺序
Git Bash(bash 方言)
bashPath 为空且 autoDiscover 为真时,按下列顺序找,命中即止:
bashCandidates里的每一项(展开为bin\bash.exe/usr\bin\bash.exe)- 注册表
HKLM\SOFTWARE\GitForWindows的InstallPath %ProgramFiles%\Git、%ProgramFiles(x86)%\Git、%LocalAppData%\Programs\Git%ProgramFiles%\MSYS2、C:\msys64、%LocalAppData%\MSYS2%SystemDrive%\cygwin64、%SystemDrive%\cygwin- PATH 上
git.exe反推(\bin\bash.exe)
WSL 被硬排除:C:\Windows\System32\bash.exe 和 WindowsApps\bash.exe 都不是 Git Bash,交给执行器会得到另一个操作系统和另一套文件系统。
发现只做文件系统探测(statSync)+ 一次异步 reg.exe query,不会 spawn bash --version——宿主在 agent/created 里串行派发事件,同步 spawn 会卡住整个进程。
cmd.exe(cmd 方言)
cmdPath 为空时:cmdPath → %ComSpec%(也认 COMSPEC)→ %SystemRoot%\System32\cmd.exe(也认 SYSTEMROOT / windir)。不扫描磁盘——cmd.exe 没有第二个合理位置。三步全部落空时该会话跳过替换(reason=cmd-not-found),保留官方 pwsh 工具。
PATH 组装
执行时子进程 PATH = 工具链 bin → usr\bin → bin → usr\local\bin → extraPath → 宿主 PATH。
顺序是有意的:MSYS2 的 git/ls/grep 必须赢过 Windows 上的同名同源工具,而宿主 PATH 必须保留,否则 node/python 等原生命令会消失。去重按「小写 + 去尾分隔符 + /→\」归一化。
受限沙箱策略(confinedPolicy)
Windows 的受限档位(read-only / workspace-write)把子进程降到 Low 完整性,MSYS2 运行时初始化命名共享内存时被拒,Git Bash 在命令执行前就退出:
bash.exe: *** fatal error - NtCreateDirectoryObject(\BaseNamedObjects\msys-2.0S5-…): 0xC0000022
exit -1073741502
confinedPolicy 决定插件此时怎么走:
| 值 | 行为 | 代价 |
|---|---|---|
unconfined(默认) | 直接以普通权限启动 Git Bash,不调用 ctx.sandbox.confine() | 一次调用即成功;模型执行的命令不受文件沙箱限制 |
escalate | 先按官方方式进入沙箱;MSYS 启动失败被标为 denied,模型收到官方升级提示后带 sandbox_permissions: danger-full-access 重试,由宿主审批 | 首次失败 + 一次审批往返 |
fail | 抛 SandboxUnavailableError,错误信息提示把 confinedPolicy 改成 unconfined,或带 sandbox_permissions: danger-full-access 重试 | 明确报错,不自动重试 |
结果事实:unconfined 直启时结果把 sandbox.mode 报成 danger-full-access——这是这次调用实际的边界,因为没有任何后端包住子进程;sandbox.enforcement 不填(官方枚举描述的是"有活动后端时能保证多少",此时没有后端可描述)。escalate 走 confine(),mode / enforcement 保持官方原值。
工具声明:unconfined 下执行器不再向 tool-bash 声明受限档位(sandboxMode 返回 undefined),所以模型不会被告知"命令在沙箱内运行",也不会看到用不上的 sandbox_permissions。escalate / fail 与其它平台仍按官方方式声明。
安全含义:unconfined 是默认值是显式的产品选择——Windows 受限档位下不这样就没有可用的 Git Bash;它意味着模型通过 bash 执行的命令不受文件沙箱约束。需要沙箱约束时选 escalate(官方审批)或 fail(拒绝执行)。设置行在选中 unconfined 时会显示同样的提示。
escalate 的审批完全由第一方 dsh-tool-bash 负责:approveEscalation 在 execute 之前调用,批准后以 danger-full-access 的 sandboxPolicy 进入执行器。插件只把 MSYS 启动失败分类成 denied,不自己实现审批,也不修改宿主的沙箱实现。判定同时看退出码(3221225794 / 3221225506)与 stderr 签名(ntcreatedirectoryobject(\basenamedobjects\msys- / couldn't create signal pipe),前台与后台一致。
CMD 方言(cmd.exe)
dialect: cmd 是第三个方言,也是唯一不建立在官方 dsh-tool-bash 之上的一个。官方工具的名字、执行器、沙箱叙述都绑死在 bash/pwsh 上,cmd.exe 需要另一套传输、另一套启动判定、另一段提示词,所以 cmd 工具(src/cmd/tool.ts)是官方工具的逐字移植,只把 bash 相关标识换成 cmd。
选中 cmd 后:会话拿到 cmd 工具,pwsh 与 bash 被 restrict 隐藏,官方 tool:pwsh 提示词段被压空,换成 tool:cmd 段。后台作业、超时转后台、sandbox_permissions 升级、会话 cwd、工具卡片、退出码标记与官方 bash 工具同构。
传输:为什么每次调用都落一个临时 .cmd 脚本
cmd.exe 不能像 bash -c 那样把命令当参数传:
| 传法 | 结果 |
|---|---|
cmd /c 单元素 | Node 会把引号转义成 \",cmd 不认 |
cmd /c … 多元素 | 同样被改写 |
| 环境变量一次性传入 | 简单命令可用,但命令首字符是引号即失败(文件名、目录名或卷标语法不正确)、%PATH% 不展开、多行只取第一行 |
走 stdin(cmd /d /q) | 出 banner + 提示符 + More?,不可用 |
临时 .cmd 脚本 | 引号原样、%VAR% 正常展开、多行正常、exit /b N 退出码正确 |
所以每次执行都会在每个执行器自己的 scratch 目录(os.tmpdir() 下 dsh-cmd-)写一个 cmd-.cmd,内容为:
@echo off
chcp 65001>nul
cd /d "" 2>nul || (echo cmd: cannot enter the working directory 1>&2 & exit /b 1)
cd守卫不是装饰:脚本从 scratch 目录启动,工作目录若已不存在,没有守卫时命令会在 scratch 目录里静默执行并 exit 0——模型会以为命令跑在它的会话目录里。UNC 路径改用pushd。- 没有尾部
exit /b %errorlevel%:cmd脚本的退出码本来就是最后一条命令的退出码,显式写反而会把dir /nonexistent & echo recovered这类命令的0改掉。这条由测试T-EXIT守住。 /q关掉回显且不恢复:命令原文不会出现在输出里,只有命令自己打印的东西会被返回;脚本里写@echo on也压不过/q。- 文件名以裸名传给
cmd.exe,cwd设为脚本目录:这是唯一能扛住 scratch 路径里出现&()^,;%的形态(绝对路径形态在这些字符下全部失败,docs/probes/cmd-transport.mjs有复现)。 - 脚本用 UTF-8 无 BOM、CRLF 写入(CRLF 不是功能必需,只是为了兼容旧式批处理工具链)。
- 每个执行器在
ctx.effect里回收自己的 scratch 目录;插件启动时sweepStaleScripts()清掉 24 小时前的残留。
发现顺序
cmdPath 为空时依次尝试:cmdPath → %ComSpec% → %SystemRoot%\System32\cmd.exe(也认 SYSTEMROOT / windir)。不做磁盘扫描——cmd.exe 在 Windows 上没有第二个合理位置。
沙箱(cmdConfinedPolicy)
与 Git Bash 相反:cmd.exe 能在 Windows 受限令牌下正常启动(官方 dsh-sandbox-local 的功能探针本身就是 cmd /c exit 0)。所以 cmd 的启动判定不复用 planLaunch(),而是自己的 planCmdLaunch():
| 值 | 行为 |
|---|---|
escalate(默认) | 受限档位下走官方 ctx.sandbox.confine(),命令真的被文件沙箱约束;danger-full-access 或没有沙箱时直接启动 |
unconfined | 一律直接启动,命令不受文件沙箱约束 |
没有 fail 档:cmd 不存在「受限下起不来」这种情况,fail 只会变成一个没有意义的拒绝。
安装时探针(cmd-sandbox-unavailable):escalate 档位下,插件在把 cmd 工具交给会话之前,会先用同一条执行链跑一次 echo dsh-cmd-probe-ok 并把结果读回来。原因是受限启动的前缀由宿主的沙箱运行器拼装,而桌面版 Electron 宿主把它拼成 [process.execPath, runner.js]——Electron 只有带 ELECTRON_RUN_AS_NODE=1 才当 Node 用,否则会去启动桌面应用本身、随即退出。于是子进程「退出码 0、无输出」,模型看到的每条命令都是「成功但什么都没做」,这是终端工具能碰到的最坏的失败形态(与命令没输出无法区分)。探针失败时插件直接让开(reason=cmd-sandbox-unavailable),把会话留给官方工具,并在日志里提示改 unconfined。
已知判定缺口:sandbox.denied 依赖 provider 的 stderr 签名。中文 Windows 上 cmd 的拒绝信息是 GBK 中文,英文签名 is not recognized as an internal or external command 永不命中——此时沙箱仍然生效(命令确实被拦了),只是结果里的 denied 标记可能为 false。插件不伪造这个判定。
与 bash / pwsh 方言的差别
minimalMode只对bash有意义。cmd会话里minimal预设的持久终端不会被替换——持久终端是 PTY 语义,cmd方言不提供(见已知限制)。confinedPolicy(bash 的)与cmdConfinedPolicy(cmd 的)是两个独立字段,设置行按当前方言只显示对应的那个。
极简模式(minimal preset)
官方 minimal 预设是唯一自带持久 shell 的出厂预设:它的 persistent-shell 组挂的是一行持久 PTY(Windows 上是持久 pwsh,POSIX 上是持久 bash),bash / pwsh 工具由这一组提供。因此它和其它预设不同——插件不能只替换一个执行器,那组持久终端会继续把 pwsh 送到模型面前;而默认行为(oneshot)是用一次性 Git Bash 工具盖掉它,持久性随之丢失。
minimalMode 只对 agent preset 是 minimal(或变体 minimal-gitbash)的会话生效,对其它预设没有影响。默认 oneshot,即升级到 0.5.0 不改变任何现有行为。
| 值 | minimal 会话里发生什么 | 预设选择器里出现什么 |
|---|---|---|
leave | 插件不介入,保留官方持久终端(Windows 上仍是持久 pwsh) | 不变 |
oneshot(默认) | 旧行为:bash 换成插件的一次性 Git Bash 工具,pwsh 隐藏 | 不变 |
variant | 同样不介入官方 minimal;另外注册 minimal-gitbash(order 3.1),它是 minimal 的克隆,persistent-shell 组改接插件的持久 Git Bash 后端 | 多一项「极简模式 · Git Bash」 |
variant 的实质是新增预设,不是改写官方 minimal:官方定义一个字节都不动,克隆出来的定义 id 为 minimal-gitbash,只在该选项为 variant 时注册。变体行里嵌入的是注册那一刻解析出的 Git Bash 绝对路径;之后改 bashPath(或 confinedPolicy / loginShell / pythonUtf8)会让定义按新输入重建,已在运行的变体会话仍跑旧的那一版,不受影响。
变体的生命周期
variant只负责把变体放进预设名册,不改默认预设、也不替用户选会话。- 选项为
variant且能解析到 Git Bash 时注册,状态registered;注册成功后校验一次预设名册,缺失或损坏则报failed并给出原因(校验放在注册之后、且必须等插件激活返回再执行——激活期间调agentPresets.list()会与 Host Loader 互等死锁)。 - 选项关掉后不一定立刻注销。若还有会话引用
minimal-gitbash(活跃会话的 preset,或已持久化的会话头),定义保留,状态变为retained并显示引用数。原因是官方恢复路径按 id 解析预设且没有回退:删掉定义,这些会话会永远打不开,用户只会看到一个笼统的gateway/internal。 - 只有当没有任何会话引用时,定义才真正注销,状态回到
absent。 - 变体不可用(找不到 Git Bash、构造失败)时不会静默回落到
oneshot:minimal会话按leave处理,设置行显示failed与原因。静默回落等于「设了却没生效」,这里宁可明说。
怎么用
新建会话时打开预设选择器,选「极简模式 · Git Bash」(minimal-gitbash)。名册是界面挂载时拉的,如果选择器是注册前就打开的,重开一次即可看到。已开的会话不会被重新组装:替换发生在会话创建时,改选项或改预设都只影响之后新建的会话。
持久后端没有 sandbox_permissions 升级通道,所以 escalate 在这条路上无法完成升级:unconfined(默认)直接启动 Git Bash;escalate 仍会走官方受限路径并撞上 MSYS 启动失败,但没有可用的重试入口;fail 直接抛 SandboxUnavailableError。另外,官方 ensureSandboxModeFence 禁止在持久终端打开期间切换沙箱档位,这算一条限制,见「已知限制」。
设计依据、三个选项的取舍与风险分析见 [docs/PLAN-minimal-mode.md](do