zclaw_openfang/docs/features/02-intelligence-layer/05-autonomy-manager.md

自主授权系统 (Autonomy Manager)

分类: 智能层 优先级: P1 - 重要 成熟度: L4 - 生产 最后更新: 2026-03-24 验证状态: ✅ 代码已验证 实现位置: desktop/src/lib/autonomy-manager.ts

---

✅ 集成状态

当前状态: ✅ 完全集成

AutonomyConfig.tsx 组件已集成到 RightPanel.tsx 的 'autonomy' tab。

集成位置: RightPanel 'autonomy' tab (点击 Shield 图标) 实现语言: TypeScript (前端) + 集成 Rust 后端检查

已集成的系统

系统	文件	集成状态	说明
反思引擎	reflection-engine.ts	✅ 已集成	反思运行前检查授权
上下文压缩	context-compactor.ts	✅ 已集成	压缩执行前检查授权
身份更新	agent-identity.ts	✅ 已集成	身份变更前检查授权
技能安装	skill-discovery.ts	✅ 已集成	技能安装/卸载前检查授权
记忆提取	session-persistence.ts	✅ 已集成	记忆保存前检查授权

---

一、功能概述

1.1 基本信息

自主授权系统实现了分层授权机制，根据操作的风险等级和当前的自主级别，决定是自动执行还是需要用户审批。

属性	值
分类	智能层
优先级	P1
成熟度	L4
依赖	AuditLog, ApprovalWorkflow

1.2 相关文件

文件	路径	用途	集成状态
核心实现	desktop/src/lib/autonomy-manager.ts	授权逻辑	✅ 存在
配置 UI	desktop/src/components/AutonomyConfig.tsx	配置界面	✅ 已集成
审批 UI	desktop/src/components/ApprovalsPanel.tsx	审批界面	✅ 已集成

---

二、设计初衷

2.1 问题背景

用户痛点:

1. Agent 自主操作可能带来风险
2. 不同操作的风险等级不同
3. 需要平衡效率和安全

系统缺失能力:

• 缺乏风险分级机制
• 缺乏审批流程
• 缺乏操作审计

为什么需要: 自主与安全的平衡是 AI Agent 可信的关键，需要分层授权机制来管理不同风险的操作。

2.2 设计目标

1. 分层授权: Supervised / Assisted / Autonomous
2. 风险分级: Low / Medium / High
3. 审批流程: 请求 → 等待 → 批准/拒绝
4. 审计追踪: 所有操作可追溯

2.3 自主级别

级别	描述	行为
Supervised	监督模式	所有操作需要确认
Assisted	辅助模式	低风险自动执行，中高风险需确认
Autonomous	自主模式	低中风险自动执行，高风险需确认

2.4 风险等级

等级	操作类型	Supervised	Assisted	Autonomous
Low	memory_save, reflection_run, compaction_run	需确认	自动	自动
Medium	hand_trigger, config_change, skill_install	需确认	需确认	自动
High	memory_delete, identity_update	需确认	需确认	需确认

2.5 设计约束

• 安全约束: 高风险操作始终需要确认
• 性能约束: 审批不能阻塞主流程
• 审计约束: 所有操作必须可追溯

---

三、技术设计

3.1 核心接口

interface AutonomyManager {
  getLevel(): AutonomyLevel;
  setLevel(level: AutonomyLevel): void;
  requestAuthorization(action: Action): Promise<AuthorizationResult>;
  getPendingApprovals(): ApprovalRequest[];
  approve(requestId: string): Promise<void>;
  reject(requestId: string, reason: string): Promise<void>;
  getAuditLog(filter?: AuditFilter): AuditEntry[];
}

3.2 授权流程

操作请求 → 评估风险等级 → 需要确认? → 执行操作 → 完成
                              ↓
                    创建审批请求 → 用户批准/拒绝

3.3 集成模式

各系统集成自主检查的统一模式：

import { canAutoExecute } from './autonomy-manager';

async function someOperation(options?: { skipAutonomyCheck?: boolean }) {
  // 自主检查
  if (!options?.skipAutonomyCheck) {
    const { canProceed, decision } = canAutoExecute('action_type', importance);
    if (!canProceed) {
      console.log(`[Module] Autonomy check failed: ${decision.reason}`);
      return; // 或返回默认结果
    }
    console.log(`[Module] Autonomy check passed: ${decision.reason}`);
  }

  // 执行实际操作
  // ...
}

---

四、实际效果

4.1 已实现功能

• 三级自主级别 (lib)
• 三级风险分级 (lib)
• 审批流程 (lib)
• 审计日志 (lib)
• 操作回滚 (lib)
• 审批过期 (lib)
• UI 审批面板 - ✅ 已集成到 RightPanel 'autonomy' tab
• 反思引擎集成 - ✅ 2026-03-18
• 上下文压缩集成 - ✅ 2026-03-18
• 身份更新集成 - ✅ 2026-03-18
• 技能安装集成 - ✅ 2026-03-18

4.2 已知问题

问题	严重程度	状态
回滚不总是可用	中	已知
审批 UI 需要优化	低	待处理

---

五、演化路线

5.1 短期计划（1-2 周）

• 集成反思引擎
• 集成上下文压缩
• 集成身份更新
• 集成技能安装
• 优化审批 UI
• 添加批量审批

5.3 中期计划（1-2 月）

• 智能风险预测
• 自适应自主级别