Files
zclaw_openfang/docs/features/02-intelligence-layer/03-reflection-engine.md
iven b7ec317d2c
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Rust Check (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled
docs: 更新功能文档 — 反映架构重构成果
- docs/features/README.md — 技能数 69→70, Hands 11个, 成熟度更新
- 智能层文档成熟度上调 (身份演化 L3, 反思引擎 L3)
- 后端集成文档更新 SaaS 迁移系统说明
- 知识库添加架构重构记录
2026-03-29 19:42:37 +08:00

113 lines
2.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 自我反思引擎 (Reflection Engine)
> **分类**: 智能层
> **优先级**: P1 - 重要
> **成熟度**: L4 - 生产
> **最后更新**: 2026-03-29
> **验证状态**: ✅ 代码已验证
> **后端实现**: Rust (reflection.rs) - **85% 完整度**
---
## ✅ UI 集成状态
> **当前状态**: ✅ 已集成
>
> `ReflectionLog.tsx` 组件已集成到 `RightPanel.tsx` 的 'reflection' tab。
>
> **集成位置**: RightPanel 'reflection' tab (点击 Sparkles 图标)
> **后端位置**: `desktop/src-tauri/src/intelligence/reflection.rs`
---
## 一、功能概述
### 1.1 基本信息
自我反思引擎让 Agent 能够分析自己的行为模式,发现问题并提出改进建议,是实现 Agent 自我进化的关键组件。
| 属性 | 值 |
|------|-----|
| 分类 | 智能层 |
| 优先级 | P1 |
| 成熟度 | L4 |
| 依赖 | AgentMemory, LLMService |
| 触发条件 | 对话次数 / 时间间隔 / 手动 |
| 属性 | 值 |
|------|-----|
| 分类 | 智能层 |
| 优先级 | 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 月)
- [ ] 可视化反思报告
- [ ] 用户反馈循环