配置

补丁层默认配置（cordis.patch.yml）：

- id: niubash-executor
  name: dsh-niubash-only/executor
  config:
    timeoutMs: 120000
    maxTimeoutMs: 600000
    maxOutputBytes: 64000
    graceMs: 3000
    enforceNiubashOnly: true   # 拒绝把命令交给别的 shell
    dialectLint: true          # spawn 前拒绝 PowerShell/CMD 习惯，并给出 Bash 写法
    dialectHints: true         # 失败时按真实错误文本追加一行 Niubash hint
    requireNiubash: true       # 找不到 niu 就启动失败（而不是每次调用都失败）
    verifyNiubash: true        # 启动时跑一次 `niu --version`
    probeNativeShells: true    # 探测本机 bash/sh 是否解析到 Niubash，决定是否放行
    smokeTest: true            # 启动时跑一条真实命令，起不来就当场把原因报出来
    sandbox: false             # 直接在本机运行：ctx.sandbox 不包裹、不拦截 niu

- id: niubash-teaching
  name: dsh-niubash-only/teaching
  config:
    guide: full                # full | compact | off
    rules: true
    rewriteToolDescriptions: true

执行器可选项：

字段	默认	含义
`niuPath`	`$DSH_NIU_PATH` → `PATH` → 安装目录 → `niu.exe`	Niubash 可执行文件
`niuArgs`	`['-c']`	argv 前缀，命令追加在最后
`enforceNiubashOnly`	`true`	守卫开关
`foreignShellAllowlist`	`[]`	整条命令匹配的正则（字符串），命中则放行（守卫与方言预检共用）
`dialectLint`	`true`	spawn 前拒掉 PowerShell/CMD 习惯
`dialectHints`	`true`	失败时在 stderr 末尾追加一行 `Niubash hint (…)`
`requireNiubash`	`true`	无法解析 `niu` 时启动即失败
`verifyNiubash` / `verifyTimeoutMs`	`true` / `10000`	启动探测 `niu --version` 及其超时
`smokeTest`	`true`	启动时走一次真实调用路径（`echo niubash-smoke-ok`），把"命令根本起不来"这类启动期故障写在启动日志里
`probeNativeShells`	`true`	启动探测 `command -v bash; command -v sh`，据此决定 `bash`/`sh` 放行与否
`sandbox`	`false`	是否让 `ctx.sandbox` 包裹 shell 命令。默认关：`niu` 直接在本机以 harness 进程的身份运行，结果的 `sandbox` 事实报 `mode: danger-full-access`，会话要了受限模式时额外报 `bypassed:` 。设为 `true` 则走第一方原来的包裹与拒绝判定（此时 Niubash 1.1.4 在受限模式下起不来，见下节）

可执行文件解析顺序：niuPath → DSH_NIU_PATH → PATH 里第一个含 niu.exe 的目录 → 已知安装目录（%LOCALAPPDATA%\Programs\Niubash、%ProgramFiles%\Niubash、%ProgramFiles(x86)%\Niubash）→ 裸 niu.exe。安装目录这一档是刻意的：Niubash 安装程序把目录加进用户 PATH 后广播环境变更，但已经在运行的 harness 进程仍持有启动时的环境——回退到文档化的安装目录，可以让部署不必重启宿主。

cwd、timeoutMs、maxTimeoutMs、maxOutputBytes、maxSpillBytes、graceMs 沿用 dsh 自己的 shell 设置命名空间，settings.yaml 的 shell: 段仍然可以热改预算。

在本 profile 的 cordis.patch.yml 里按 id 覆盖即可，例如：

- id: niubash-executor
  config:
    niuPath: 'C:\Users\me\AppData\Local\Programs\Niubash\niu.exe'
    enforceNiubashOnly: false

dsh-niubash-only

安裝

說明文件

配置