DreamCycle
检测、分析和自动修复 AI 代理会话日志中的故障模式。
何时使用
在以下情况下使用 DreamCycle：
- 代理已经运行了一段时间，您想检查是否有重复的故障
- 会话日志正在积累，您想进行趋势分析
- 您怀疑相同的错误不断发生，但没有人跟踪它
- 您想要已知故障模式的自动修复建议
- 在更改代理配置后，验证没有回归
工作原理
DreamCycle 是 AI 代理的回顾性调试器。它以三个阶段扫描代理的会话日志文件：
会话日志 → 扫描 → 分析 → 修复
扫描 —— 从 JSON 会话文件中提取故障、模式和课程信号
分析 —— 检测重复模式（出现 2+ 次）和趋势（与前一次扫描相比上升/下降/稳定）
修复 —— 将已知故障模式映射到带有置信度评分的自动修复建议
安装
pip install dreamcycle
用法
# 基本诊断：扫描过去 2 天的会话
dreamcycle diagnose ~/.openclaw/sessions/
# 扫描过去 7 天
dreamcycle diagnose ~/my-agent/logs/ --days 7
# 以 JSON 输出用于程序化使用
dreamcycle diagnose ./sessions/ --output json
# 版本信息
dreamcycle version
示例输出
━━━ DreamCycle 诊断 ━━━
扫描：42 个会话（过去 2 天）
信号：156 个总计（故障：78，模式：52，课程：26）
━━━━━━━━━━━━━━━━━━━━━━━━━
🔄 顶级重复模式
[12x] "timeout" → ⚡ 高
修复：添加 retry_with_backoff（置信度：85%）
[8x] "ModuleNotFoundError" → ⚡ 高
修复：pip install （置信度：95%）
📈 趋势
↑ 超时：12x（从上一次扫描的 5x 上升）
↓ ModuleNotFoundError：8x（从 15x 下降）
🔧 自动修复摘要
✅ 2/4 个模式有自动修复
❌ 2 个模式需要手动审查
要求
仅 python3 和 pip。零外部依赖 —— DreamCycle 仅使用 Python 标准库。
注意
- 会话文件必须是 JSON 格式，包含 messages 数组和 role/content 字段
- 第一次运行建立基线；趋势数据从第二次运行开始显示
- 趋势数据存储在 ~/.dreamcycle/scan_history.json 中
by