Evolution Watcher

SKILL.md

---
name: evolution-watcher
version: 0.6.2
layer: tooling
function_type: upgrade_monitoring
health: healthy
adapter: evolution_watcher_adapter (planned)
dependencies: []
issue: 用户授权流程已实现，适配器自动修复支持9种变更模式
---
# 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 | 依赖缺失 | 安装所需依赖包 |