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 里的规则会随项目一起提交。任何作用域的拒绝规则都会累加,所以即使用户在全局允许了某个操作,项目也可以禁止它。