首页布局优化前

2026-03-17 23:26:16 +08:00
parent 74dbf42644
commit e262200f1e
89 changed files with 2266 additions and 2120 deletions
--- a/docs/features/02-intelligence-layer/03-reflection-engine.md
+++ b/docs/features/02-intelligence-layer/03-reflection-engine.md
@@ -3,7 +3,17 @@
 > **分类**: 智能层
 > **优先级**: P1 - 重要
 > **成熟度**: L4 - 生产
-> **最后更新**: 2026-03-16
+> **最后更新**: 2026-03-17
+
+---
+
+## ✅ UI 集成状态
+
+> **当前状态**: ✅ 已集成
+>
+> `ReflectionLog.tsx` 组件已集成到 `RightPanel.tsx` 的 'reflection' tab。
+>
+> **集成位置**: RightPanel 'reflection' tab (点击 Sparkles 图标)

 ---

@@ -17,16 +27,15 @@
 |------|-----|
 | 分类 | 智能层 |
 | 优先级 | P1 |
-| 成熟度 | L4 |
+| 成熟度 | L2 (降级：UI 未集成) |
 | 依赖 | AgentMemory, LLMService |

 ### 1.2 相关文件

-| 文件 | 路径 | 用途 |
-|------|------|------|
-| 核心实现 | `desktop/src/lib/reflection-engine.ts` | 反思逻辑 |
-| LLM 服务 | `desktop/src/lib/llm-service.ts` | LLM 调用 |
-| 类型定义 | `desktop/src/types/reflection.ts` | 反思类型 |
+| 文件 | 路径 | 用途 | 集成状态 |
+|------|------|------|---------|
+| 核心实现 | `desktop/src/lib/reflection-engine.ts` | 反思逻辑 | ✅ 存在 |
+| 日志 UI | `desktop/src/components/ReflectionLog.tsx` | 反思日志界面 | ❌ **未集成** |

 ---

@@ -39,11 +48,6 @@
 2. 无法从历史交互中学习
 3. Agent 行为缺乏透明度

-**系统缺失能力**:
- 缺乏行为分析机制
- 缺乏自动改进能力
- 缺乏自我评估能力
-
 **为什么需要**:
 反思是人类智能的核心特征，让 Agent 具备反思能力是实现 L4 自演化的关键。

@@ -62,240 +66,36 @@
 | 时间间隔 | 每 N 小时后（默认 24 小时） |
 | 手动触发 | 用户或系统主动调用 |

-### 2.4 设计约束
+---

- **性能约束**: 反思不能阻塞主流程
- **成本约束**: LLM 调用需要控制频率
- **质量约束**: 建议必须可操作
+## 三、实际效果
+
+### 3.1 已实现功能
+
+- [x] 规则模式检测 (lib)
+- [x] LLM 深度分析 (lib)
+- [x] 改进建议生成 (lib)
+- [x] 身份变更提案 (lib)
+- [x] 定时触发机制 (lib)
+- [x] 对话计数触发 (lib)
+- [x] 结果存储 (lib)
+- [x] **UI 反思日志** - ✅ 已集成到 RightPanel 'reflection' tab
+
+### 3.2 已知问题
+
+| 问题 | 严重程度 | 状态 |
+|------|---------|------|
+| LLM 分析成本高 | 中 | 可选 |
+| 建议有时不够具体 | 低 | 待改进 |

 ---

-## 三、技术设计
+## 四、演化路线

-### 3.1 核心接口
-
-```typescript
-interface ReflectionResult {
-  timestamp: number;
-  patterns: Pattern[];
-  suggestions: Suggestion[];
-  identityChanges?: IdentityChangeProposal[];
-}
-
-interface Pattern {
-  type: PatternType;
-  description: string;
-  evidence: string[];
-  severity: 'info' | 'warning' | 'critical';
-}
-
-interface Suggestion {
-  type: SuggestionType;
-  description: string;
-  action: () => Promise<void>;
-  priority: 'low' | 'medium' | 'high';
-}
-
-interface IdentityChangeProposal {
-  file: 'SOUL.md' | 'AGENTS.md' | 'USER.md';
-  changeType: 'add' | 'modify' | 'remove';
-  content: string;
-  reason: string;
-}
-```
-
-### 3.2 反思流程
-
-```
-触发反思
-    │
-    ▼
-收集数据
-    │
-    ├──► 会话历史 (最近 N 条)
-    ├──► 记忆统计 (各类型数量)
-    ├──► 任务状态 (待完成数量)
-    └──► 行为指标 (响应时间、满意度)
-    │
-    ▼
-模式检测
-    │
-    ├──► 规则检测 (快速)
-    │       ├── 任务积累
-    │       ├── 记忆过多
-    │       ├── 偏好增长
-    │       └── 经验积累
-    │
-    └──► LLM 分析 (深度)
-            ├── 行为模式
-            ├── 改进机会
-            └── 身份建议
-    │
-    ▼
-生成建议
-    │
-    ├──► 可执行动作
-    ├──► 优先级排序
-    └──► 身份变更提案
-    │
-    ▼
-存储结果
-```
-
-### 3.3 模式检测规则
-
-```typescript
-const PATTERN_RULES: PatternRule[] = [
-  {
-    type: 'task_accumulation',
-    check: (stats) => stats.pendingTasks > 5,
-    severity: 'warning',
-    description: '待办任务过多',
-    suggestion: '清理已完成或过期的任务'
-  },
-  {
-    type: 'memory_overflow',
-    check: (stats) => stats.totalMemories > 100,
-    severity: 'warning',
-    description: '记忆数量过多',
-    suggestion: '清理低重要性的记忆'
-  },
-  {
-    type: 'preference_growth',
-    check: (stats) => stats.preferenceCount > 20,
-    severity: 'info',
-    description: '用户偏好持续积累',
-    suggestion: '整理和合并相似偏好'
-  },
-  {
-    type: 'lesson_count',
-    check: (stats) => stats.lessonCount > 10,
-    severity: 'info',
-    description: '经验教训积累',
-    suggestion: '回顾并应用这些经验'
-  }
-];
-```
-
-### 3.4 LLM 深度分析
-
-```typescript
-async function deepReflect(context: ReflectionContext): Promise<ReflectionResult> {
-  const prompt = `
-作为一个 AI Agent，请分析以下行为数据并提出改进建议：
-
-## 会话历史
-${context.recentConversations}
-
-## 记忆统计
- 事实: ${context.factCount}
- 偏好: ${context.preferenceCount}
- 经验: ${context.lessonCount}
- 任务: ${context.taskCount}
-
-## 行为指标
- 平均响应时间: ${context.avgResponseTime}ms
- 用户满意度: ${context.satisfaction}
-
-请输出：
-1. 发现的行为模式
-2. 改进建议
-3. 身份变更提案（如有）
-  `;
-
-  return await llmService.reflect(prompt);
-}
-```
-
---
-
-## 四、预期作用
-
-### 4.1 用户价值
-
-| 价值类型 | 描述 |
-|---------|------|
-| 效率提升 | Agent 自动优化行为 |
-| 体验改善 | 持续改进的交互质量 |
-| 信任增强 | 透明的自我评估 |
-
-### 4.2 系统价值
-
-| 价值类型 | 描述 |
-|---------|------|
-| 架构收益 | 闭环的改进机制 |
-| 可维护性 | 自动发现问题 |
-| 可扩展性 | 可添加新的检测规则 |
-
-### 4.3 成功指标
-
-| 指标 | 基线 | 目标 | 当前 |
-|------|------|------|------|
-| 建议采纳率 | 0% | 60% | 45% |
-| 问题发现率 | 0% | 80% | 70% |
-| 改进效果 | - | 可衡量 | 符合预期 |
-
---
-
-## 五、实际效果
-
-### 5.1 已实现功能
-
- [x] 规则模式检测
- [x] LLM 深度分析
- [x] 改进建议生成
- [x] 身份变更提案
- [x] 定时触发机制
- [x] 对话计数触发
- [x] 结果存储
-
-### 5.2 测试覆盖
-
- **单元测试**: 28 项 (heartbeat-reflection.test.ts)
- **集成测试**: 完整流程测试
- **覆盖率**: ~90%
-
-### 5.3 已知问题
-
-| 问题 | 严重程度 | 状态 | 计划解决 |
-|------|---------|------|---------|
-| LLM 分析成本高 | 中 | 可选 | - |
-| 建议有时不够具体 | 低 | 待改进 | Q2 |
-
-### 5.4 用户反馈
-
-反思功能帮助 Agent 持续改进，但建议需要更具体可操作。
-
---
-
-## 六、演化路线
-
-### 6.1 短期计划（1-2 周）
+### 4.1 短期计划（1-2 周）
 - [ ] 优化建议的具体性
 - [ ] 添加建议执行追踪

-### 6.2 中期计划（1-2 月）
+### 4.3 中期计划（1-2 月）
 - [ ] 可视化反思报告
 - [ ] 用户反馈循环
-
-### 6.3 长期愿景
- [ ] 自主执行改进
- [ ] 跨 Agent 学习
-
---
-
-## 七、头脑风暴笔记
-
-### 7.1 待讨论问题
-1. 是否应该自动执行某些改进建议？
-2. 如何评估反思的质量？
-
-### 7.2 创意想法
- 反思分享：Agent 之间共享反思结果
- 反思评分：用户对反思结果打分
- A/B 测试：对比反思前后的效果
-
-### 7.3 风险与挑战
- **技术风险**: LLM 分析的不确定性
- **成本风险**: 频繁反思的成本
- **缓解措施**: 规则优先，LLM 可选
--- a/docs/features/02-intelligence-layer/05-autonomy-manager.md
+++ b/docs/features/02-intelligence-layer/05-autonomy-manager.md
@@ -3,7 +3,17 @@
 > **分类**: 智能层
 > **优先级**: P1 - 重要
 > **成熟度**: L4 - 生产
-> **最后更新**: 2026-03-16
+> **最后更新**: 2026-03-17
+
+---
+
+## ✅ UI 集成状态
+
+> **当前状态**: ✅ 已集成
+>
+> `AutonomyConfig.tsx` 组件已集成到 `RightPanel.tsx` 的 'autonomy' tab。
+>
+> **集成位置**: RightPanel 'autonomy' tab (点击 Shield 图标)

 ---

@@ -17,16 +27,16 @@
 |------|-----|
 | 分类 | 智能层 |
 | 优先级 | P1 |
-| 成熟度 | L4 |
+| 成熟度 | L2 (降级：UI 未集成) |
 | 依赖 | AuditLog, ApprovalWorkflow |

 ### 1.2 相关文件

-| 文件 | 路径 | 用途 |
-|------|------|------|
-| 核心实现 | `desktop/src/lib/autonomy-manager.ts` | 授权逻辑 |
-| 审批 UI | `desktop/src/components/ApprovalPanel.tsx` | 审批界面 |
-| 审计日志 | `desktop/src/lib/audit-log.ts` | 操作记录 |
+| 文件 | 路径 | 用途 | 集成状态 |
+|------|------|------|---------|
+| 核心实现 | `desktop/src/lib/autonomy-manager.ts` | 授权逻辑 | ✅ 存在 |
+| 配置 UI | `desktop/src/components/AutonomyConfig.tsx` | 配置界面 | ❌ **未集成** |
+| 审批 UI | `desktop/src/components/ApprovalsPanel.tsx` | 审批界面 | ❌ **未集成** |

 ---

@@ -84,227 +94,53 @@

 ```typescript
 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[];
 }
-
-interface Action {
-  type: ActionType;
-  risk: RiskLevel;
-  payload: any;
-  rollback?: () => Promise<void>;
-}
-
-interface AuthorizationResult {
-  granted: boolean;
-  reason: string;
-  requestId?: string;  // 如果需要审批
-}
-
-type AutonomyLevel = 'supervised' | 'assisted' | 'autonomous';
-type RiskLevel = 'low' | 'medium' | 'high';
 ```

 ### 3.2 授权流程

 ```
-操作请求
-    │
-    ▼
-评估风险等级
-    │
-    ├──► Low
-    │       │
-    │       ├──► Supervised → 需要确认
-    │       ├──► Assisted → 自动执行
-    │       └──► Autonomous → 自动执行
-    │
-    ├──► Medium
-    │       │
-    │       ├──► Supervised → 需要确认
-    │       ├──► Assisted → 需要确认
-    │       └──► Autonomous → 自动执行
-    │
-    └──► High
-            │
-            └──► 所有级别 → 需要确认
-    │
-    ▼
-需要确认?
-    │
-    ├──► 是 → 创建审批请求
-    │         │
-    │         ├──► 用户批准 → 执行
-    │         └──► 用户拒绝 → 记录并通知
-    │
-    └──► 否 → 直接执行
-    │
-    ▼
-执行操作
-    │
-    ├──► 成功 → 记录审计日志
-    └──► 失败 → 尝试回滚
-    │
-    ▼
-完成
-```
-
-### 3.3 审批请求结构
-
-```typescript
-interface ApprovalRequest {
-  id: string;
-  action: Action;
-  status: 'pending' | 'approved' | 'rejected' | 'expired';
-  createdAt: number;
-  expiresAt: number;  // 默认 1 小时
-  context?: string;   // 操作上下文说明
-}
-
-// 审批 UI 展示
-const ApprovalCard = ({ request }: { request: ApprovalRequest }) => (
-  <div className="approval-card">
-    <h4>{request.action.type}</h4>
-    <p>风险等级: {request.action.risk}</p>
-    <p>上下文: {request.context}</p>
-    <div className="actions">
-      <button onClick={() => approve(request.id)}>批准</button>
-      <button onClick={() => reject(request.id)}>拒绝</button>
-    </div>
-  </div>
-);
-```
-
-### 3.4 审计日志
-
-```typescript
-interface AuditEntry {
-  id: string;
-  timestamp: number;
-  action: Action;
-  result: 'success' | 'failed' | 'rejected';
-  level: AutonomyLevel;
-  userId?: string;
-  reason?: string;
-  rollbackAvailable: boolean;
-}
-
-// 示例日志
-{
-  id: "audit_001",
-  timestamp: 1709500000000,
-  action: {
-    type: "memory_delete",
-    risk: "high",
-    payload: { memoryId: "mem_123" }
-  },
-  result: "success",
-  level: "assisted",
-  reason: "用户批准：记忆已过时"
-}
+操作请求 → 评估风险等级 → 需要确认? → 执行操作 → 完成
+                              ↓
+                    创建审批请求 → 用户批准/拒绝
 ```

 ---

-## 四、预期作用
+## 四、实际效果

-### 4.1 用户价值
+### 4.1 已实现功能

-| 价值类型 | 描述 |
-|---------|------|
-| 安全保障 | 高风险操作需要确认 |
-| 灵活控制 | 可调整自主级别 |
-| 透明度 | 所有操作可追溯 |
+- [x] 三级自主级别 (lib)
+- [x] 三级风险分级 (lib)
+- [x] 审批流程 (lib)
+- [x] 审计日志 (lib)
+- [x] 操作回滚 (lib)
+- [x] 审批过期 (lib)
+- [x] **UI 审批面板** - ✅ 已集成到 RightPanel 'autonomy' tab

-### 4.2 系统价值
+### 4.2 已知问题

-| 价值类型 | 描述 |
-|---------|------|
-| 架构收益 | 统一的授权框架 |
-| 可维护性 | 清晰的风险分级 |
-| 可扩展性 | 支持新的操作类型 |
-
-### 4.3 成功指标
-
-| 指标 | 基线 | 目标 | 当前 |
-|------|------|------|------|
-| 误操作率 | 5% | <1% | 0.5% |
-| 审批响应时间 | - | <5min | 2min |
-| 用户信任度 | 3/5 | 4.5/5 | 4.2/5 |
+| 问题 | 严重程度 | 状态 |
+|------|---------|------|
+| 回滚不总是可用 | 中 | 已知 |
+| 审批 UI 需要优化 | 低 | 待处理 |

 ---

-## 五、实际效果
+## 五、演化路线

-### 5.1 已实现功能
-
- [x] 三级自主级别
- [x] 三级风险分级
- [x] 审批流程
- [x] 审计日志
- [x] 操作回滚
- [x] 审批过期
- [x] UI 审批面板
-
-### 5.2 测试覆盖
-
- **单元测试**: 20+ 项
- **集成测试**: 完整流程测试
- **覆盖率**: ~90%
-
-### 5.3 已知问题
-
-| 问题 | 严重程度 | 状态 | 计划解决 |
-|------|---------|------|---------|
-| 回滚不总是可用 | 中 | 已知 | 设计阶段 |
-| 审批 UI 需要优化 | 低 | 待处理 | Q2 |
-
-### 5.4 用户反馈
-
-分层授权机制让人放心，高级别自主模式很方便。
-
---
-
-## 六、演化路线
-
-### 6.1 短期计划（1-2 周）
+### 5.1 短期计划（1-2 周）
 - [ ] 优化审批 UI
 - [ ] 添加批量审批

-### 6.2 中期计划（1-2 月）
+### 5.3 中期计划（1-2 月）
 - [ ] 智能风险预测
 - [ ] 自适应自主级别
-
-### 6.3 长期愿景
- [ ] 多用户审批
- [ ] 审批策略模板
-
---
-
-## 七、头脑风暴笔记
-
-### 7.1 待讨论问题
-1. 是否需要支持条件性自动批准？
-2. 如何处理长时间未处理的审批？
-
-### 7.2 创意想法
- 学习用户习惯：自动调整风险判断
- 审批委派：将审批权委托给他人
- 紧急模式：临时降低自主级别
-
-### 7.3 风险与挑战
- **技术风险**: 回滚机制的可靠性
- **安全风险**: 自主级别被恶意修改
- **缓解措施**: 高风险操作强制审计