Evolution Watcher

自动监控并对比已安装插件版本，生成升级报告，支持星型记忆架构的智能进化决策。

evolution-watcher - 星型架构智能进化监控器

⚠️ 重要警告

此插件为开发测试版本，尚未准备好用于生产环境。

请勿在生产环境安装此插件，因为它仍在积极开发中，API 和功能可能发生重大变化。此版本发布主要用于内部测试和架构审查。

如需使用稳定的监控功能，请等待正式版发布。

概述

evolution-watcher 是星型记忆架构的智能监控插件，负责自动发现、分析插件更新，为系统自我进化提供决策支持。它是实现"辅助自我进化系统"的第一阶段核心组件。

功能特性

MVP 阶段 (v0.6.0)

• ✅ 自动监控：定期检查 ClawHub 上已安装插件的新版本
• ✅ 版本对比：识别当前版本与最新版本的差异
• ✅ 报告生成：生成可读性强的升级报告（控制台 + Markdown）
• ✅ 安全设计：仅读取信息，不执行任何自动升级操作

第二阶段增强 (v0.6.2)

• ✅ 沙盒验证 - 在临时目录中应用适配器修复并运行健康检查，确保修复安全
• ✅ 适配器自动调整建议 - 支持 9 种变更模式：函数重命名、导入路径变更、配置键变更、类重命名、参数添加/移除、方法签名变更、返回值类型变更、装饰器变更
• ✅ 用户授权流程优化 - 展示 diff、沙盒验证报告、修复方案，等待用户确认后应用（authorized=True）
• ✅ 代码变更集（Diff）解析 - 从 GitHub 仓库获取版本差异，分析变更文件、行数、破坏性变更
• ✅ 批量冲突检测 - 分析多插件升级时的依赖冲突，提供警告与解决建议
• ✅ 变更日志解析与关键变化提取（v0.6.0 已实现）
• ✅ 影响评估（兼容性、收益、风险，v0.6.0 已实现）

未来计划

• 🔄 复杂变更支持 - 参数默认值变更、函数签名重排序、多文件联动修复
• 🔄 集成测试沙盒 - 在独立 Python 进程中运行完整集成测试套件
• 🔄 适配器模板库扩展 - 更多变更模式（异常变更、依赖版本变更等）

安装与配置

安装方法

bash

# 从 ClawHub 安装（未来）
clawhub install evolution-watcher

# 或本地开发模式
cp -r evolution-watcher /root/.openclaw/workspace/skills/

配置文件

config/monitor_sources.json：

json

{
  "clawhub": {
    "enabled": true,
    "check_frequency_hours": 24
  },
  "github": {
    "enabled": false,
    "repositories": [],
    "check_frequency_hours": 24
  }
}

使用方法

手动运行监控

bash

cd /root/.openclaw/workspace/skills/evolution-watcher
python3 scripts/monitor.py --report

输出示例

text

🔄 evolution-watcher v0.6.0
📅 检查时间: 2026-03-17 22:00:00
📊 监控源: ClawHub (已安装 5 个插件)

📈 更新检测结果:
┌──────────────────────┬────────────┬────────────┬──────────┐
│ 插件                 │ 当前版本   │ 最新版本   │ 状态     │
├──────────────────────┼────────────┼────────────┼──────────┤
│ memory-sync-enhanced │ 2.0.0      │ 2.0.0      │ ✅ 最新   │
│ ontology            │ 1.0.4       │ 1.0.5       │ ⚠️ 可升级 │
│ self-improving      │ 1.2.16      │ 1.2.16      │ ✅ 最新   │
└──────────────────────┴────────────┴────────────┴──────────┘

📋 详细报告已保存: reports/updates_20260317_220000.md

报告文件结构

text

reports/
├── updates_20260317_220000.md     # 详细升级报告
├── updates_log.json               # 结构化监控日志
└── summary.json                   # 摘要统计

集成架构

在星型架构中的位置

text

⭐ 星型记忆架构
├── 核心: memory-sync-enhanced (MSE)
├── 插件: self-improving (SIPA)
├── 插件: ontology
├── 插件: memory-sync-protocol (MSP)
└── 新增: evolution-watcher (本插件)

数据流

1. 监控模块 → 调用 ClawHub CLI (list, inspect)
2. 分析模块 → 对比版本，生成差异分析
3. 报告模块 → 输出人类可读报告
4. 日志模块 → 记录监控历史（JSON 格式）

技术细节

监控逻辑

1. 读取 clawhub list 获取已安装插件列表
2. 对每个插件执行 clawhub inspect <slug> 获取最新版本
3. 对比 current_version (来自 list) 与 latest_version (来自 inspect)
4. 记录差异到结构化日志

安全机制

• 🔐 零自动升级：所有升级操作需手动执行
• 🔐 只读操作：仅调用信息查询命令，不修改系统
• 🔐 完整日志：所有监控操作都有审计日志
• 🔐 配置可控：监控频率、范围可配置

开发计划

v0.1.0 (MVP)

• 基础监控框架
• ClawHub 版本检测
• 报告生成

v0.2.0

• 变更日志解析
• 初步影响评估
• GitHub 监控支持

v0.3.0

• 适配器变更检测
• 升级建议排序
• 集成测试支持

注意事项

1. 网络依赖：需要互联网连接访问 ClawHub API
2. API 限制：ClawHub API 可能有速率限制，请合理配置检查频率
3. 版本准确性：依赖 ClawHub 的版本信息准确性
4. 向后兼容：未来版本将保持配置文件兼容性

贡献与反馈

• 问题报告：通过 GitHub Issues 或 ClawHub 评论
• 功能建议：欢迎提出进化监控的新需求
• 开发贡献：遵循标准插件开发流程

---

进化是一个渐进的过程，而非一次革命。

错误码

错误码	描述	解决方案
E001	未知错误	检查日志，联系开发者
E002	配置错误	验证配置文件格式
E003	依赖缺失	安装所需依赖包