Files
zclaw_openfang/docs/features/02-intelligence-layer/03-reflection-engine.md
iven aa6a9cbd84
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
feat: 新增技能编排引擎和工作流构建器组件
refactor: 统一Hands系统常量到单个源文件
refactor: 更新Hands中文名称和描述

fix: 修复技能市场在连接状态变化时重新加载
fix: 修复身份变更提案的错误处理逻辑

docs: 更新多个功能文档的验证状态和实现位置
docs: 更新Hands系统文档

test: 添加测试文件验证工作区路径
2026-03-25 08:27:25 +08:00

2.8 KiB
Raw Blame History

自我反思引擎 (Reflection Engine)

分类: 智能层 优先级: P1 - 重要 成熟度: L4 - 生产 最后更新: 2026-03-24 验证状态: 代码已验证 后端实现: Rust (reflection.rs)


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 已实现功能

  • 规则模式检测 (lib)
  • LLM 深度分析 (lib)
  • 改进建议生成 (lib)
  • 身份变更提案 (lib)
  • 定时触发机制 (lib)
  • 对话计数触发 (lib)
  • 结果存储 (lib)
  • UI 反思日志 - 已集成到 RightPanel 'reflection' tab

3.2 已知问题

问题 严重程度 状态
LLM 分析成本高 可选
建议有时不够具体 待改进

四、演化路线

4.1 短期计划1-2 周)

  • 优化建议的具体性
  • 添加建议执行追踪

4.3 中期计划1-2 月)

  • 可视化反思报告
  • 用户反馈循环