ClawHub 智能更新技能 🔄

说明

具备智能合并能力的 ClawHub 技能更新器。保留本地修改、自动检测冲突，并提供详尽的合并建议，而非盲目覆盖文件。

适用场景

当出现以下情况时，请使用该技能：

• 您已对 ClawHub 下载的技能进行了本地修改
• 您希望在更新技能时不丢失自己的更改
• 您需要冲突检测与合并建议
• 您希望在更新前自动生成备份
• 您倾向采用安全、保守的更新方式，而非高风险的自动更新

与 auto-updater 的核心差异

安装

# 通过 ClawHub 安装
clawhub install clawhub-smart-updater

# 该技能将安装以下内容：
# - smart-update.py（主更新脚本）
# - restore-backup.py（回滚工具）
# - config.json（配置文件）

使用方法

快速入门

# 运行智能更新检查
python skills/clawhub-smart-updater/smart-update.py

# 此操作将：
# 1. 检查所有已安装技能是否存在更新
# 2. 备份当前版本
# 3. 将新版本下载至临时目录
# 4. 对比并分类变更类型
# 5. 生成含详细建议的报告

命令行选项

# 试运行（不执行任何实际变更）
python smart-update.py --dry-run

# 更新指定技能
python smart-update.py --slug image-with-comfyui

# 强制更新（跳过冲突检测）
python smart-update.py --force

# 显示详细输出
python smart-update.py --verbose

# 清理旧备份（保留最近 7 天内的备份）
python smart-update.py --cleanup-backups --older-than 7

OpenClaw Cron 集成

该技能专为 OpenClaw 的 cron 任务设计：

{
  "cron": {
    "jobs": [
      {
        "name": "Weekly Smart Update",
        "schedule": {
          "kind": "cron",
          "expr": "0 10 * * 1",
          "tz": "Europe/Prague"
        },
        "payload": {
          "kind": "agentTurn",
          "message": "Run smart-update.py --report and send summary to user"
        },
        "delivery": {
          "channel": "whatsapp",
          "to": ""
        }
      }
    ]
  }
}

工作原理

1. 发现阶段

clawhub list → 获取已安装技能列表
clawhub inspect  → 获取最新版本信息
对比：local_version 与 latest_version

2. 备份阶段

Copy-Item skills/ skills/.backup-YYYY-MM-DD -Recurse

3. 下载阶段

clawhub inspect  --files --output temp/-new

4. 分析阶段

• 对所有文件计算 SHA-256 哈希值
• 与原始 ClawHub 提供的哈希值进行比对
• 识别被本地修改过的文件
• 按类型归类变更：
  • 安全变更：文档、配置文件、未改动的文件
  • 冲突变更：上游与本地均修改过的代码文件

5. 合并阶段

• 自动应用安全变更
• 标记需人工审查的冲突项
• 生成 diff 文件
• 创建合并报告

6. 报告阶段

生成详细报告，包含：

• 已更新的内容
• 需人工审查的内容
• 安全警告
• 统计信息

配置

config.json

{
  "backup": {
    "enabled": true,
    "retention_days": 7,
    "directory": "skills/.backups"
  },
  "conflict": {
    "auto_backup": true,
    "generate_diff": true,
    "require_manual_review": true
  },
  "notification": {
    "enabled": true,
    "channel": "whatsapp",
    "target": "",
    "on_conflict_only": false
  },
  "update": {
    "auto_apply_safe": true,
    "auto_apply_conflicts": false,
    "ignore_whitespace": true
  }
}

输出示例

成功报告

## Smart Update Report - 2026-05-07

### ✅ 自动更新（2 个技能）：
- image-with-comfyui: 1.4.8 → 1.4.9（仅文档更新）
- moltbook-interact: 1.0.0 → 1.0.1（修复 bug）

### ⚠️ 需人工审查（1 个技能）：
- fusion-bridge: 1.0.2 → 1.0.3
  - main.py 第 45–67 行存在冲突
  - 查看：temp/fusion-bridge/diff.txt

### 统计信息：
- 已检查技能数：23
- 已更新技能数：2
- 冲突技能数：1
- 已清理备份数：3

冲突报告

### ⚠️ fusion-bridge：检测到冲突

**本地修改：**
- 修改了：main.py（自定义错误处理逻辑）
- 修改了：SKILL.md（捷克语翻译）

**上游变更：**
- 修复了：main.py（connect() 函数中的 bug）
- 更新了：README.md（新增示例）

**冲突点：**
main.py 第 45–67 行同时被本地和上游修改

**建议：**
需人工合并。上游修复至关重要，但须保留自定义错误处理逻辑。

**操作步骤：**
1. 查看：temp/fusion-bridge/diff.txt
2. 手动合并
3. 运行：python smart-update.py --accept fusion-bridge

安全特性

备份系统

• 更新前自动创建备份
• 备份目录带日期标识
• 支持可配置的保留周期（默认：7 天）
• 可通过 restore-backup.py 快速回滚

冲突检测

• 基于 SHA-256 的文件内容哈希校验
• 追踪用户修改过的具体文件
• 智能变更分类机制
• 为冲突文件自动生成 diff

安全性

• 集成 VirusTotal（对标记为 SUSPICIOUS 的文件发出警告）
• 依赖项变更检测
• 权限审计
• 绝不盲目覆盖文件

故障排查

“Permission denied” 错误

原因： 技能文件正被编辑器或其他进程占用锁定

解决方案：

# 关闭正在使用技能文件的编辑器
# 或强制解锁
python smart-update.py --force-unlock

备份目录过大

原因： 历史备份持续累积

解决方案：

python smart-update.py --cleanup-backups --older-than 7

误报冲突

原因： 检测到空白字符（空格、换行等）变更

解决方案：

python smart-update.py --ignore-whitespace

包含的文件

• smart-update.py — 主更新脚本
• restore-backup.py — 回滚工具
• config.json — 配置文件
• SKILL.md — 本文档
• README.md — 扩展文档

依赖要求

• Python 3.10+
• 已安装 ClawHub CLI
• Git（可选，用于高级 diff 功能）
• Windows PowerShell（用于备份脚本）

许可证

MIT-0 — 可免费使用、修改及再分发，无需署名。

作者

Klepeto 🦞（vilda）
创建时间：2026-05-07
测试环境：Windows 11，Python 3.12

更新日志

1.0.0（2026-05-07）

• 初始发布
• 支持智能合并与冲突检测
• 内置自动备份系统
• 支持生成 diff 文件
• 支持 OpenClaw cron 集成
• 支持 WhatsApp 推送报告