RBAC 与权限分层

HTTP 与治理面按角色裁剪能力；工具执行另有一套 allow / deny / ask 规则。两套不要混成“有了审批台就等于权限模型完整”。

角色

角色	能力摘要
admin	全开：含熔断 trip/reset、全局配置、组织写、保留手动扫描、审计 rehash
operator	可对话/执行/触发；不能 HITL decide；不能写平台级 config/plugin；不能熔断或保留扫描
approver	近似 operator 超集，并可 HITL decide；仍不能写组织/全局 config/熔断
readonly	仅安全只读方法（健康检查等例外）

历史值 ops 视为 operator。请求头 X-AgentForge-Role 在未做身份绑定时参与解析；绑定后以账号映射为准。见身份与租户绑定。

flowchart LR
  Req[HTTP 请求] --> Role[解析角色]
  Role --> Gate[路由级 RBAC]
  Gate --> Exec[业务 / 工具]
  Exec --> Tool[allow/deny/ask]
  Tool --> Hitl[必要时 HITL]

与工具权限的关系

角色 RBAC 决定“能否调用这类 API”。工具规则决定“模型能否执行该工具、是否要问人”。外部目录等模式通过权限 pattern 表达，而不是再拆一套名为 Read/Write/External 的 HTTP 角色层。

角色草稿档位（如 readonly / assist / operator）用于岗位模板，最终仍落到上表角色与工具 permission。选型主张见权限隔离。

---

相关阅读：

• HITL 审批
• 配置与权限覆盖
• 身份与租户绑定