102 lines
2.5 KiB
Markdown
102 lines
2.5 KiB
Markdown
# 自我反思引擎 (Reflection Engine)
|
||
|
||
> **分类**: 智能层
|
||
> **优先级**: P1 - 重要
|
||
> **成熟度**: L4 - 生产
|
||
> **最后更新**: 2026-03-17
|
||
|
||
---
|
||
|
||
## ✅ UI 集成状态
|
||
|
||
> **当前状态**: ✅ 已集成
|
||
>
|
||
> `ReflectionLog.tsx` 组件已集成到 `RightPanel.tsx` 的 'reflection' tab。
|
||
>
|
||
> **集成位置**: RightPanel 'reflection' tab (点击 Sparkles 图标)
|
||
|
||
---
|
||
|
||
## 一、功能概述
|
||
|
||
### 1.1 基本信息
|
||
|
||
自我反思引擎让 Agent 能够分析自己的行为模式，发现问题并提出改进建议，是实现 Agent 自我进化的关键组件。
|
||
|
||
| 属性 | 值 |
|
||
|------|-----|
|
||
| 分类 | 智能层 |
|
||
| 优先级 | P1 |
|
||
| 成熟度 | L2 (降级：UI 未集成) |
|
||
| 依赖 | AgentMemory, LLMService |
|
||
|
||
### 1.2 相关文件
|
||
|
||
| 文件 | 路径 | 用途 | 集成状态 |
|
||
|------|------|------|---------|
|
||
| 核心实现 | `desktop/src/lib/reflection-engine.ts` | 反思逻辑 | ✅ 存在 |
|
||
| 日志 UI | `desktop/src/components/ReflectionLog.tsx` | 反思日志界面 | ❌ **未集成** |
|
||
|
||
---
|
||
|
||
## 二、设计初衷
|
||
|
||
### 2.1 问题背景
|
||
|
||
**用户痛点**:
|
||
1. Agent 重复犯同样的错误
|
||
2. 无法从历史交互中学习
|
||
3. Agent 行为缺乏透明度
|
||
|
||
**为什么需要**:
|
||
反思是人类智能的核心特征，让 Agent 具备反思能力是实现 L4 自演化的关键。
|
||
|
||
### 2.2 设计目标
|
||
|
||
1. **模式检测**: 识别行为模式（任务积累、偏好增长等）
|
||
2. **问题发现**: 自动发现问题（记忆过多、任务未清理等）
|
||
3. **建议生成**: 提出可操作的改进建议
|
||
4. **身份变更**: 提议修改 Agent 身份文件
|
||
|
||
### 2.3 触发机制
|
||
|
||
| 触发条件 | 描述 |
|
||
|---------|------|
|
||
| 对话次数 | 每 N 次对话后（默认 5 次） |
|
||
| 时间间隔 | 每 N 小时后（默认 24 小时） |
|
||
| 手动触发 | 用户或系统主动调用 |
|
||
|
||
---
|
||
|
||
## 三、实际效果
|
||
|
||
### 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 分析成本高 | 中 | 可选 |
|
||
| 建议有时不够具体 | 低 | 待改进 |
|
||
|
||
---
|
||
|
||
## 四、演化路线
|
||
|
||
### 4.1 短期计划（1-2 周）
|
||
- [ ] 优化建议的具体性
|
||
- [ ] 添加建议执行追踪
|
||
|
||
### 4.3 中期计划（1-2 月）
|
||
- [ ] 可视化反思报告
|
||
- [ ] 用户反馈循环
|