动作治理¶
Status: Current
Last verified: 2026-06-30
动作治理的核心不变量是:决策后端只能提出 SuggestedAction,真正可执行的 AuthorizedAction 只能由 ActionLifecycle 在策略通过后构造。
类型边界¶
IntentBatch
-> Intent
-> SuggestedAction # 不可信建议
-> ActionProposal # core 生成坐标和 effect
-> PolicyActionDecision # PolicyEngine 逐 action 裁决
-> AuthorizedAction # ActionLifecycle 唯一 seal 点
-> ActionAdapter
-> AuditRecord
AuthorizedAction 定义在 aios-core::governance,字段私有。aios-action 只能接收引用并读取 getter,不能自行构造授权动作。
PolicyEngine 检查¶
当前策略检查覆盖:
- 后端能力等级:
CapabilityLevel::for_route(route) - 全局自动执行风险上限:默认只允许
Low - 置信度下限:默认
0.3 - blocked action 子串
Deferredurgency 拒绝- 单 intent action 数量上限
- action 是否在后端能力白名单内
- target 是否出现在当前
StructuredContext中
常见拒绝原因由 DenialReason 表示,例如 RiskExceedsCapability、ActionCapabilityDenied、TargetNotInContext。
ActionLifecycle 状态机¶
每个 (window_ordinal, intent_ordinal, action_ordinal) 形成一个确定性 ActionCoord。每个 coord 恰好产出一条终态 AuditRecord。
当前可达状态:
Proposed
-> SchemaValidated
-> PolicyChecked
-> Dispatched
-> Succeeded
Proposed
-> RejectedInvalidSchema
Proposed
-> SchemaValidated
-> PolicyChecked
-> DeniedByCapability | DeniedByPolicy
Proposed
-> SchemaValidated
-> PolicyChecked
-> Dispatched
-> Failed
当前没有 retry、rollback、budget reservation、scheduler state 或 cancel/expire 状态;这些机制不存在,因此文档和代码都不应声明对应终态。
AuditRecord¶
AuditRecord 是动作治理的审计输出,包含:
coordaction_typetargeteffectroutesource_tiertransitionsterminaloutcomedenial_reasonbackend_errorerror
Replay 的 canonical projection 会剥离 UUID、latency 等 volatile 字段,把确定性审计流折叠进 audit_hash。
执行适配器¶
| Adapter | 使用场景 | 行为 |
|---|---|---|
DefaultActionExecutor | daemon 在线路径 | 纯确定性本地 stub,不访问网络或环境变量。daemon 启动期若 Android bridge 已配置则选用 AndroidAdapter 代替。 |
AndroidAdapter | daemon + Android bridge | 经 localhost socket 转发 Android-safe action(HMAC、TCP 请求/响应协议);仅在 daemon 启动期选择。 |
OfflineAdapter | replay / golden tests | 不访问系统、网络或 Android,只返回确定性 ActionOutcome。 |
daemon 启动时根据 DIPECS_ANDROID_ACTION_BRIDGE_ENABLED 等环境变量在 AndroidAdapter 和 DefaultActionExecutor 之间二选一注入 ActionLifecycle。