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 ``` ### 输出示例 ``` 🔄 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 ``` ### 报告文件结构 ``` reports/ ├── updates_20260317_220000.md # 详细升级报告 ├── updates_log.json # 结构化监控日志 └── summary.json # 摘要统计 ``` ## 集成架构 ### 在星型架构中的位置 ``` ⭐ 星型记忆架构 ├── 核心: 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) - [x] 基础监控框架 - [x] ClawHub 版本检测 - [x] 报告生成 ### v0.2.0 - [ ] 变更日志解析 - [ ] 初步影响评估 - [ ] GitHub 监控支持 ### v0.3.0 - [ ] 适配器变更检测 - [ ] 升级建议排序 - [ ] 集成测试支持 ## 注意事项 1. **网络依赖**：需要互联网连接访问 ClawHub API 2. **API 限制**：ClawHub API 可能有速率限制，请合理配置检查频率 3. **版本准确性**：依赖 ClawHub 的版本信息准确性 4. **向后兼容**：未来版本将保持配置文件兼容性 ## 贡献与反馈 - **问题报告**：通过 GitHub Issues 或 ClawHub 评论 - **功能建议**：欢迎提出进化监控的新需求 - **开发贡献**：遵循标准插件开发流程 --- *进化是一个渐进的过程，而非一次革命。* ## 错误码 | 错误码 | 描述 | 解决方案 | |--------|------|----------| | E001 | 未知错误 | 检查日志，联系开发者 | | E002 | 配置错误 | 验证配置文件格式 | | E003 | 依赖缺失 | 安装所需依赖包 |