AI 编程 agent 权限:模式与 allow、deny 规则

OHarness 会先把每一次工具调用与 allow、ask、deny 规则比对,再看权限模式。deny 优先于一切——包括 bypass 模式——所以明确的拒绝是你唯一可以完全依赖的边界。

更新于

5 种模式

模式行为
default(手动)任何会改变状态的操作都先询问
acceptEdits文件编辑直接通过,其他操作都询问
plan只读;拒绝所有改动
auto编辑和常规命令直接通过,有风险的操作询问
bypassPermissions全部批准——deny 规则禁止的除外

在会话里用 /mode 选择,或在命令行用 --permission-mode 指定。auto 是对代价的判断,不是安全检查:它衡量的是波及范围(rm、sudo、git push、kubectl、npm publish、写入项目以外的位置),凡是它认不出是常规操作的都会询问。

规则

规则匹配工具名,或者带通配符的 Tool(argument) 形式:

{
  "allow": ["Bash(npm run test:*)", "mcp__github__get_*"],
  "ask":   ["Bash(git push*)"],
  "deny":  ["Bash(rm -rf *)", "write(.env*)"]
}

规则存放在哪里

作用域文件用途
user~/.oharness/settings.json个人习惯
project.oharness/settings.json属于仓库,可以代码审查
local.oharness/settings.local.json只对当前检出生效,已加入 gitignore

拒绝规则会在各个作用域之间累加,而且永远不会被覆盖,所以项目可以禁止用户在全局允许过的操作。在确认请求里选「始终允许」时,写入的是最具体的模式——批准 Bash(npm test) 并不会放行所有 Bash(...)。用 /permissions 查看当前生效的规则。

权限系统不是什么

可写目录检查(workspaceMode)会在询问之前就拒绝项目以外的路径,但它检查的是参数,并不限制进程本身。一条 shell 命令能访问你能访问的一切。要真正隔离,请在容器或虚拟机里运行 agent,把规则当作防止失误的护栏。

常见问题

怎样阻止编程 agent 执行危险命令?

加 deny 规则。在 OHarness 里,像 "deny": ["Bash(rm -rf *)", "Bash(git push*)"] 这样的规则会在所有模式下拒绝这些命令,包括 bypassPermissions。deny 规则才是边界;模式只是图方便。

bypass 模式会忽略 deny 规则吗?

不会。在 OHarness 里,deny 优先于一切,包括 bypassPermissions。明确的拒绝是用户唯一可以绝对依赖的规则。

仓库能为所有使用者统一设置权限吗?

能。.oharness/settings.json 里的规则会随项目一起提交。任何作用域的拒绝规则都会累加,所以即使用户在全局允许了某个操作,项目也可以禁止它。

相关内容