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 进程中运行完整集成测试套件
• 🔄 适配器模板库扩展 - 更多变更模式（异常变更、依赖版本变更等）

安装与配置

安装方法

从 ClawHub 安装（未来）

或本地开发模式

配置文件

使用方法

手动运行监控

输出示例

🔄 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/updates20260317220000.md

报告文件结构

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

集成架构

在星型架构中的位置

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

数据流

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

技术细节

监控逻辑

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

安全机制

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

开发计划

v0.1.0 (MVP)

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

v0.2.0

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

v0.3.0

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

注意事项

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

贡献与反馈

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

错误码