Featured image of post Grok Build 权限模式详解:ask、auto 与 Always-approve 如何执行规则

Grok Build 权限模式详解:ask、auto 与 Always-approve 如何执行规则

结合 Grok Build 1.0.77 与 1.0.88 终端实测,梳理六种权限模式对 deny、ask、allow 的处理,解释为何 Always-approve 会自动批准 ask,并记录配置加载、历史授权和排查方法。

-- 次浏览
-- 条评论

在配置里给 git push 加了 ask,Grok 仍然直接执行,看起来像权限规则没有生效。但“命中规则”“发起审批”和“停下来等人确认”并不是同一个结果。

理解 Grok Build 的权限行为,需要同时看规则、模式和客户端。本文结合本机终端实测,把这三个部分分开说明,方便以后调整配置时查阅。

先分清规则、模式和客户端

Grok 的权限行为可以从三个层面理解:

  • 权限规则:把具体操作规定为 deny、ask 或 allow。
  • 权限模式:决定没有明确授权的操作,是询问、自动审查、自动拒绝,还是自动批准。
  • 客户端行为:收到审批请求以后,是展示确认界面,还是直接替用户回答。

因此,ask 更准确的含义是“进入审批流程”,不能脱离模式和客户端,把它理解成“必定等人点击一次”。

如果需要对照其他工具的权限模型,可以结合 AI 编程 CLI 的权限怎么配 阅读。本文只讨论 Grok Build,不把其他工具的同名模式直接套过来。

规则优先级与配置来源

原生规则通常写在 ~/.grok/config.toml 的 [permission] 中,也可以由项目的 .grok/config.toml、兼容的 .claude/settings.json 或 .claude/settings.local.json 提供。

规则的基本含义如下:

规则含义
deny拒绝匹配的操作
ask将匹配的操作送入审批流程
allow通过这层权限检查;Plan、Hook 或系统权限仍可能限制执行

匹配多条配置规则时,优先级是:

1
deny > ask > allow

这个优先级也适用于不同配置来源之间的规则。例如,宽泛的 Bash(git *) 的 allow,不能覆盖另一份配置里的 Bash(git cherry-pick *) 的 deny。

配置中有 allow,不代表其他操作全部禁止。 没有匹配规则的操作会进入内置判断和模式处理:default 可能询问,auto 可能自动批准,Always-approve 通常直接执行。

六种模式的整体对照

下面讨论规则已经加载、没有保存过历史的 Always allow 授权,也没有额外 Hook 或沙箱配置的基本情况。Plan 的文件限制以本次验证的原生工具链为准。

模式命中 deny命中 ask命中 allow没有匹配规则时
default,界面也叫 Ask拒绝等待人工确认允许内置允许的操作直接执行,其余询问
acceptEdits拒绝等待人工确认允许文件编辑自动允许,其他操作通常询问
auto,界面叫 Auto-review拒绝等待人工确认允许内置判断或自动审查决定,必要时询问或阻止
dontAsk拒绝直接拒绝,不等待回答允许已经允许的操作可执行,其余拒绝
bypassPermissions,界面叫 Always-approve仍拒绝终端客户端自动批准允许通常直接执行
plan拒绝在计划阶段允许的范围内询问仍受计划阶段限制读取通常允许;普通文件编辑受限;Shell 仍走审批

default:需要审批的事情交给用户决定

default 不会对每个工具调用都弹窗。读取文件、git status、git diff 等内置认可的操作,通常可以直接执行。

没有规则放行、也不属于内置允许范围的操作,就询问用户。例如,没有其他授权时,执行构建命令可能需要确认;如果配置明确允许该命令,就可以免去这次确认。

acceptEdits:自动批准文件编辑,保留其他审批

acceptEdits 主要放开通过文件编辑工具进行的修改,例如创建文件、替换文件内容。它不代表所有 Shell 命令都自动允许,也不能仅凭“这个脚本最终只是改文件”就推断脚本免审批。

显式规则仍可以收紧它。本次实测中,普通文件写入自动完成;给目标文件增加 Edit(...) 的 ask 后,写入停下来等待确认。

auto:让自动判断承担一部分审批

auto 会遵守已经加载、匹配到的配置规则。没有匹配规则时,一些常规操作可以直接放行,其他操作可能进入自动审查。

不是每个操作都会调用模型审查。本次普通文件写入直接获准;没有匹配规则的推送命令进入了分类器。

交互终端中,不能自动放行的操作可以转给用户确认;无交互运行中,同类情况可能直接失败。具体是否放行,仍取决于真实的自动判断结果。

auto 与 default 的主要差别,发生在没有明确授权、原本需要审批的操作上。二者对已经加载的 ask 和 deny 可以表现一致,但默认处理方式并不相同。

dontAsk:需要询问才能执行的操作,直接拒绝

dontAsk 的意思是没有现成授权就不执行。它仍允许内置认可的读取,以及明确配置了 allow 的操作。

正确加载该策略后,本次未获授权的文件写入被拒绝;命中 Shell 或 Edit 的 ask 时,也立即返回拒绝,没有等待人工回答。

它和 Always-approve 都可能不弹窗,但结果相反:dontAsk 自动拒绝需要审批的操作,Always-approve 自动同意审批请求。

Always-approve:自动回答同意,配置中的 deny 仍能拦截

bypassPermissions 是命令行和兼容配置中的名称,Always-approve 是常见界面名称,也可以通过 --always-approve 启用。

在本次终端实测中,匹配 ask 的 Shell 命令确实进入了审批流程,但客户端自动返回 allow,命令随后执行。匹配配置中 deny 的命令,则在执行前被拒绝。

所以,这个模式下不能依靠 ask 保证人工确认。需要禁止的操作,应使用匹配到实际调用的 deny。

这里的 deny 指声明式配置规则,不应与弹窗里保存的历史“永不允许”记录混为一谈。随 CLI 附带的文档说明,Always-approve 的普通直通路径不会查询所有历史授权记录。

1.0.88 附带的权限文档改写为:Always-approve 下,匹配 Shell 命令片段的 ask 规则“仍然适用”。按 1.0.88 复测,交互终端和 grok -p 中匹配 ask 的 git push,依旧是进入审批流程后被自动批准并执行,审批事件同样是 decision: allow。这句文档只能理解为规则仍会触发审批,不能理解为会停下来等人确认。

plan:增加计划阶段的编辑限制

Plan 除了影响审批,还限制当前阶段可以直接修改什么。

在本次原生工具链实测中,Plan 阶段允许写计划文件,普通业务文件编辑会被拒绝。给业务文件增加 allow,也不能越过这个限制。

但是,Shell 命令仍然可以经过权限检查和审批后执行。因此,Plan 不能替代严格的只读系统沙箱,也不能据此断言所有有副作用的操作都会被阻止。

为什么命中 ask 以后还是执行了

Always-approve 的一组实测记录能直接解释这个现象。

配置中已经存在匹配的 ask。后台先记录:

1
permission policy: ask rule matched, prompting user

随后,审批事件记录:

1
2
3
4
5
{
  "type": "permission_resolved",
  "decision": "allow",
  "wait_ms": 0
}

测试没有向终端输入批准按键,Git 命令仍然开始执行。它最终因为临时仓库没有 HEAD 而失败:

1
error: src refspec HEAD does not match any

这个错误只用于证明命令已经运行,不代表发生了成功的远程推送。

将匹配规则改为 deny 后,日志变为:

1
permission policy: deny rule matched (enforced before YOLO)

工具返回未执行:

1
Denied by permission policy: deny rule on bash matching "git push"

这说明权限管理器与终端客户端的行为需要一起看。只看到后台“发起确认”,不能证明界面真的停下来等人。

日常自动处理,推送保留人工确认

如果目标是日常操作尽量自动、git push 人工确认、git cherry-pick 禁止执行,可以采用下面的原生配置:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
# ~/.grok/config.toml
[ui]
yolo = false
permission_mode = "auto"

[permission]
ask = [
    "Bash(git push)",
    "Bash(git push *)",
]
deny = [
    "Bash(git cherry-pick)",
    "Bash(git cherry-pick *)",
]

这份配置表达的是指定操作的审批要求。没有写进规则的操作,继续交给 auto 判断。

规则匹配的是实际工具调用和参数,不是 Git 的语义权限。例如,不能只因为配置覆盖了 git push ...,就推断它一定覆盖所有包装脚本或不同的 Git 参数排列。本次也验证了简单的 cd ... && git push ... 链式形式,但没有穷举所有 Shell 写法。

配置入口与实际生效状态

命令行的 --permission-mode 列出六个值:

1
default, acceptEdits, auto, dontAsk, bypassPermissions, plan

但 ui.permission_mode 的配置参考列出的是:

1
default / ask / auto / always-approve

这两组取值不能直接互换。尤其不要把六个名字都照搬到 ui.permission_mode。

本次 acceptEdits、dontAsk 的策略效果,通过兼容配置 permissions.defaultMode 加载后验证。例如:

1
2
3
4
5
{
  "permissions": {
    "defaultMode": "dontAsk"
  }
}

验证时,其他 Auto-review 和 Always-approve 开关保持关闭。仅传入 --permission-mode dontAsk 的终端用例,没有表现出预期的默认拒绝策略;通过兼容配置加载后,才观察到上述拒绝行为。因此,参数被接受和策略实际生效之间,还需要运行时证据。

1.0.88 的文档写明命令行参数会覆盖配置,但复测结果与 1.0.77 相同:

  • 交互终端中,传入 --permission-mode dontAsk 或 acceptEdits 都只是让会话离开 Auto-review,写文件时弹出普通确认,既没有直接拒绝,也没有自动批准。
  • grok -p 中,调试日志显示参数已被接收,但 dontAsk 下文件照常写入;项目配置为 default 时,再传入 acceptEdits 也没有放行写入。
  • 改用 permissions.defaultMode 后,两种策略在交互终端和 grok -p 中都按预期生效:dontAsk 拒绝写入和命中 ask 的命令,acceptEdits 自动放行写入。

使用兼容配置时还要注意两点。交互终端默认以 Auto-review 启动,会盖过 defaultMode,需要同时设置 ui.permission_mode = "ask"。项目目录下的 .claude/settings.json 受文件夹信任控制,grok -p 在未信任的目录运行时要加 --trust,否则这份配置不会加载。

交互界面还可以在会话中切换模式。配置文件中的启动默认值,不一定等于窗口当前使用的模式。

历史授权与重新加载

即使模式和配置都正确,历史授权也可能改变是否再次询问。

随 CLI 附带的文档说明,已经保存的授权可以满足某些 ask。git push 等危险命令不会使用宽泛的历史前缀授权,但精确到整条命令的授权仍可能免去确认。

如果目标是每次都亲自批准,应避免保存对应操作的 Always allow,并检查项目作用域内已有的授权记录。本次新会话实验没有覆盖历史授权的全部组合。

权限规则在会话启动时加载。修改文件,不会自动刷新正在运行的会话。本次对照实验观察到:

  • 启动前已有匹配的 ask:Auto-review 停下来等待确认。
  • 启动后才写入匹配的 ask:原来的权限快照没有刷新,操作仍进入自动审批。

因此,修改规则后应启动一个重新加载配置的会话。使用 grok 创建新会话本身没有问题;恢复聊天历史,也不能直接等同于沿用旧的权限快照。

判断某次异常时,不要只看聊天的创建时间。应结合实际启动、当前模式、加载来源和当次审批日志。如果历史日志只有 allow 和等待时间,没有记录决策来源,就保留原因未确认的边界,不能直接认定是 Auto-review 绕过规则。

如何验证配置是否达到预期

先确认版本和配置来源:

1
2
grok version
grok inspect --json

inspect 可以帮助检查配置来源、规则是否被跳过,以及 Hook 等扩展。它不能单独证明某个已经运行的窗口持有什么权限快照。

需要复现时,可以带调试日志启动:

1
grok --debug --debug-file /tmp/grok-permission-debug.log

然后要求 Grok 只执行:

1
git push -h

它可以匹配推送的询问规则,批准以后也只显示帮助,不需要实际向远端推送。

排查时关注三个结果:

观察点能说明什么
规则加载来源与解析结果规则文件是否被识别、是否存在解析或跳过问题
ask rule matched 或 deny rule matched本次调用是否匹配了规则
permission_resolved 与工具执行结果审批最后如何结束,命令是否真的开始执行

如果是 ask,还要核对当前客户端是否开启 Always-approve。后台发起审批以后,客户端仍可能立即替用户回答。

实测范围与适用边界

本次先用 Grok Build 1.0.70 排查,再用 1.0.77(50ca579fa996)复核主要模式行为。上面的模式对照以 1.0.77 的本机交互终端结果为主。之后用 1.0.88(2fe3608f7398)在交互终端和 grok -p 中复测了 Always-approve 下的 ask 与 deny,以及 acceptEdits、dontAsk 的命令行与兼容配置入口,结果与 1.0.77 一致。

验证使用独立的临时 GROK_HOME、本机模拟模型接口、临时文件和空的本地 Git 仓库,没有使用共享远端。Auto-review 的分类结果由模拟接口控制,用来验证审批路径,不能据此判断真实分类模型会怎样评价任意一条命令。

等待确认的用例没有输入批准按键,观察到等待后结束测试。由测试中断产生的取消或拒绝事件,不等同于配置 deny 的主动拦截。

本文没有把结果扩大到所有命令写法、历史授权组合、远程客户端、工作区守护进程或操作系统沙箱。升级以后,建议重新检查版本、配置参考和最小复现。

本机可以按需查看随 CLI 附带的说明:

1
2
3
4
~/.grok/docs/user-guide/22-permissions-and-safety.md
~/.grok/docs/user-guide/26-config-reference.md
~/.grok/docs/user-guide/19-plan-mode.md
~/.grok/docs/user-guide/10-hooks.md

要保留人工推送确认,选择 Auto-review 或普通询问模式,并让推送调用匹配 ask;需要禁止的操作使用 deny。Always-approve 会改变审批请求的最终处理方式,不能把一条 ask 当作必定出现人工弹窗的保证。