审批策略

审批策略决定智能体遇到权限请求时继续、拒绝还是等待用户。策略由目标 CLI 强制执行；App 用于创建、同步、选择和检查模板。

选择审批模式

新设备或不确定项目风险时使用“每次询问”；希望减少中断时使用“安全模式”。“自动审批”“允许全部”和自定义规则属于明确评估过风险后的策略，不应作为首次配置的默认选项。

模式	行为
每次询问	每个权限请求都等待确认
安全模式	自动允许常规工作区操作，高风险操作仍需确认
自动审批	独立 AI Reviewer 处理常规请求，高风险、不完整或不确定请求仍询问用户
允许全部	自动允许所有请求，包括高风险操作
自定义规则	使用选中的规则模板；未匹配或无法解析的操作默认询问

“允许全部”可能允许破坏性、提权、网络变更和工作区外操作，只应在已隔离且可信的环境使用。

自定义规则模板

模板包含名称、说明和决策规则。每条规则选择 allow、ask 或 deny，并通过原子动作、工具模式或 Condition JSON 匹配操作。

决策规则中 deny 优先于 allow。没有匹配、条件无法解析或工具未知时，默认询问用户。没有任何规则的模板等同于所有操作询问。

高风险范围

重点检查破坏性命令、提权和系统命令、网络写操作、工作区外访问以及未知工具。常规读取、搜索和工作区内编辑也应根据项目敏感度决定是否自动允许。

JSON、校验与观察模式

高级 JSON 支持 Approval Policy v1 文档，以及 Python、JavaScript、SQL 和不透明 Shell 行为声明。保存前处理所有校验错误与警告。

观察模式只评估和记录策略，不会自动批准或拒绝操作，适合在正式启用前验证匹配结果。

如果 App 与目标 CLI 的策略 Registry 版本不同，先更新两端。目标 CLI 不支持策略协议版本时，不能应用该模板。

同步与冲突

模板可保存在当前 App，并在登录后同步到账户。离线时，已安装到设备的模板仍可工作。

如果本地和账户版本都发生修改，选择“使用账户版本”会覆盖未同步的本地编辑；选择“保留 App 版本”会创建新的账户修订。删除模板会同步到其他账户设备。