Skip to content

协作治理框架

Phase 64 | v3.0.0 | 5 IPC 处理器 | 2 张新数据库表

核心特性

  • 🤝 渐进式自主权: AI 根据审批通过率自动提升自主等级(0→10),逐步获得更大决策权
  • 🚦 决策网关: 架构、迁移、安全等关键决策强制人工审批,风险可控
  • 🎯 置信度门控: 高置信度(≥0.95)+ 非关键类型可自动审批,减少人工负担
  • 📋 完整审计追踪: 所有 AI 决策记录审批人、时间、意见,支持事后审计
  • ⚖️ 分域管理: 不同作用域(部署/架构/数据)独立维护自主等级和历史记录

系统架构

┌─────────────────────────────────────────────────┐
│              协作治理框架                         │
├─────────────────────────────────────────────────┤
│  AI Agent  →  决策提交  →  ┌──────────────┐     │
│                            │  决策网关     │     │
│                            │  ┌──────────┐│     │
│                            │  │置信度检查││     │
│                            │  │类型检查  ││     │
│                            │  │等级检查  ││     │
│                            │  └──────────┘│     │
│                            └──────┬───────┘     │
│                         ┌────────┼────────┐     │
│                         ↓        ↓        ↓     │
│                    自动审批   待人工审批  拒绝    │
│                         ↓        ↓              │
│                    ┌──────────────────┐          │
│                    │  Track Record    │          │
│                    │  自主等级自动提升 │          │
│                    └──────────────────┘          │
├─────────────────────────────────────────────────┤
│  DB: governance_decisions | autonomy_levels     │
└─────────────────────────────────────────────────┘

自主等级体系

NONE(0) → MINIMAL(2) → LOW(4) → MEDIUM(6) → HIGH(8) → FULL(10)
等级数值说明
NONE0所有操作需人工审批
MINIMAL2仅信息查询类操作自主
LOW4非关键配置变更可自主
MEDIUM6常规开发任务可自主
HIGH8除安全策略外均可自主
FULL10完全自主(仍保留人工否决权)

自动提升条件: 在某作用域内,当 track_record > 0.9 且总决策数 ≥ 10 时,自主等级自动 +1。


决策类型

类型说明默认需审批
ARCHITECTURE架构决策
MIGRATION数据迁移
SECURITY安全策略
DEPLOYMENT部署操作
DATA数据操作
GENERAL通用决策

核心功能

1. 提交决策

javascript
// AI 提交一个架构决策
const decision = await submitDecision({
  decisionType: 'ARCHITECTURE',
  title: '采用事件驱动架构重构消息模块',
  description: '当前消息模块采用同步调用,建议迁移到事件驱动以提升可扩展性',
  confidence: 0.88,
  context: { currentArch: 'sync-rpc', proposedArch: 'event-driven' },
  proposedAction: 'refactor-messaging-to-events'
});

// 置信度 0.88 < 0.95 且类型为 ARCHITECTURE(需审批)→ status: 'PENDING'

2. 审批/拒绝

javascript
// 人工审批
await window.electronAPI.invoke('collab-governance:approve-decision', {
  decisionId: 'gd-001',
  reviewer: 'admin',
  comment: '同意,但需要在 staging 环境先验证'
});

// 拒绝
await window.electronAPI.invoke('collab-governance:reject-decision', {
  decisionId: 'gd-002',
  reviewer: 'admin',
  comment: '风险太高,建议分阶段实施'
});

3. 查看待审决策

javascript
const pending = await window.electronAPI.invoke('collab-governance:get-pending', {
  filter: { decisionType: 'ARCHITECTURE' }
});

4. 自主等级管理

javascript
// 查看某作用域的自主等级
const level = await window.electronAPI.invoke('collab-governance:get-autonomy-level', {
  scope: 'deployment'
});
// { scope: 'deployment', level: 6, trackRecord: 0.95, totalDecisions: 23, ... }

// 设置自主策略
await window.electronAPI.invoke('collab-governance:set-autonomy-policy', {
  scope: 'deployment',
  level: 8,
  requireApprovalFor: ['ARCHITECTURE', 'MIGRATION', 'SECURITY']
});

自动审批规则

决策在满足以下条件时自动审批(AUTO_APPROVED):

  1. 置信度 ≥ 0.95
  2. 决策类型不在 requireApprovalFor 列表中
  3. 当前作用域自主等级 ≥ 该操作所需最低等级

否则进入 PENDING 状态等待人工审批。


IPC 通道

通道参数返回值
collab-governance:get-pending{ filter? }待审决策列表
collab-governance:approve-decision{ decisionId, reviewer, comment? }操作结果
collab-governance:reject-decision{ decisionId, reviewer, comment? }操作结果
collab-governance:get-autonomy-level{ scope }自主等级
collab-governance:set-autonomy-policy{ scope, level?, requireApprovalFor? }操作结果

数据库表

governance_decisions

字段类型说明
idTEXT PK决策 ID
decision_typeTEXTARCHITECTURE/MIGRATION/SECURITY/...
titleTEXT决策标题
descriptionTEXT详细描述
confidenceREALAI 置信度(0-1)
statusTEXTPENDING/APPROVED/REJECTED/AUTO_APPROVED
contextJSON决策上下文
proposed_actionTEXT建议操作
reviewerTEXT审批人
review_commentTEXT审批意见
created_atINTEGER创建时间
reviewed_atINTEGER审批时间

autonomy_levels

字段类型说明
idTEXT PK记录 ID
scopeTEXT作用域(唯一)
levelINTEGER自主等级(0-10)
total_decisionsINTEGER总决策数
approved_decisionsINTEGER通过数
rejected_decisionsINTEGER拒绝数
track_recordREAL通过率
updated_atINTEGER更新时间

相关链接

关键文件

文件说明
desktop-app-vue/src/main/ai-engine/autonomous/collaboration-governance.js协作治理框架核心实现
desktop-app-vue/src/main/ai-engine/autonomous/decision-gateway.js决策网关与自动审批逻辑
desktop-app-vue/src/main/ai-engine/autonomous/autonomy-manager.js自主等级管理与自动提升
desktop-app-vue/src/renderer/stores/collaborationGovernance.ts协作治理 Pinia Store

相关文档

基于 MIT 许可发布