// 步骤 1: 分析影响（我们的技能）
const analysis = await openclaw.updateChecker.analyze();
if (analysis.compatibilityCheck.high === 0) {
  console.log('✅ 可以安全升级');
  
  // 步骤 2: 执行更新（使用 Openclaw Update 等工具）
  // openclaw update
}

// 检查官方更新影响
const result = await openclaw.updateChecker.analyze();
console.log(result.report);

// 分析更新影响并生成报告
const analysis = await openclaw.updateChecker.analyze({
  currentVersion: '2026.3.13',  // 当前版本（可选，自动检测）
  targetVersion: 'latest',       // 目标版本（可选，默认 latest）
  backupAffected: true,          // 是否备份受影响的文件（可选，默认 true）
  generateReport: true,          // 是否生成报告（可选，默认 true）
  outputPath: './update-impact-report.md'  // 报告输出路径（可选）
});

// 输出分析结果
console.log('影响评估:', analysis.impactSummary);
console.log('需要关注的文件:', analysis.affectedFiles);
console.log('升级建议:', analysis.recommendations);

// 检查特定配置文件的兼容性
const configCheck = await openclaw.updateChecker.checkConfig({
  files: ['AGENTS.md', 'HEARTBEAT.md', 'scripts/*.js'],
  version: '2026.3.23'
});

// 备份当前配置
const backup = await openclaw.updateChecker.backup({
  destination: './backup/update-20260324',
  includeAffectedOnly: true  // 只备份受影响的文件
});

# OpenClaw 更新影响分析报告

**分析时间**: 2026-03-24 11:09
**当前版本**: v2026.3.13
**目标版本**: v2026.3.23

## 影响评估

### 🔴 高优先级（必须处理）
- 无

### 🟡 中优先级（建议处理）
- 飞书媒体附件配置 - 官方已修复发送失败问题
- Exec 安全审批规则变更 - 可能需要重新审批命令

### 🟢 低优先级（需要注意）
- 浏览器 CDP 配置 - 官方优化复用逻辑
- 插件 SDK 路径变更 - 不影响最终用户

## 兼容性统计

| 类别 | 文件数 | 兼容性 |
|------|--------|--------|
| 核心配置 | 7 | ✅ 100% |
| 技能包 | 100+ | ✅ 100% |
| 自动化脚本 | 15+ | ✅ 100% |
| 文档 | 10 | ✅ 100% |

## 升级建议

1. 可以安全升级到 v2026.3.23
2. 升级后测试飞书图片发送
3. 检查浏览器连接是否正常
4. 关注 Exec 审批日志

## 备份清单

✅ 已备份 13 个文件到 ./backup/update-20260324

{
  "skills": {
    "entries": {
      "openclaw-update-checker": {
        "config": {
          "autoBackup": true,
          "backupDestination": "./backup",
          "reportFormat": "markdown",
          "includeVersionHistory": true,
          "githubRepo": "openclaw/openclaw"
        }
      }
    }
  }
}

{
  impactSummary: {
    high: 0,
    medium: 2,
    low: 3,
    none: 120
  },
  affectedFiles: [...],
  recommendations: [...],
  report: "完整报告内容"
}

{
  compatible: [...],
  incompatible: [...],
  warnings: [...]
}

{
  backupPath: "./backup/update-20260324",
  files: [...],
  timestamp: "2026-03-24T11:09:00+08:00"
}

{
  version: "2026.3.23",
  releaseDate: "2026-03-24",
  changes: [...],
  breakingChanges: [...],
  fixes: [...],
  features: [...]
}

# 从 ClawHub 安装（推荐）
openclaw skills install openclaw-update-checker

# 或从 GitHub 安装
openclaw skills install github:Adgai115/openclaw-260324/skills/openclaw-update-checker

// 定时任务：每周日 9:00
const result = await openclaw.updateChecker.analyze();
if (result.impactSummary.high > 0) {
  await openclaw.message.send({
    to: 'user',
    message: `⚠️ 发现 ${result.impactSummary.high} 个高优先级更新，请查看报告`
  });
}

// 升级前
const analysis = await openclaw.updateChecker.analyze();
if (analysis.impactSummary.high === 0) {
  console.log('✅ 可以安全升级');
  await openclaw.exec({ command: 'pnpm add -g openclaw@latest' });
} else {
  console.log('⚠️ 存在兼容性问题，请先处理');
}

// 每天 2:00
await openclaw.updateChecker.backup({
  destination: `./backup/daily-${new Date().toISOString().split('T')[0]}`,
  includeAffectedOnly: false
});

// 手动指定版本
await openclaw.updateChecker.analyze({
  targetVersion: '2026.3.23'
});

// 检查磁盘空间
// 确保备份目录存在
await openclaw.exec({ command: 'mkdir -p ./backup' });

// 检查输出路径权限
// 尝试使用绝对路径
await openclaw.updateChecker.analyze({
  outputPath: 'E:/Dev/.openclaw/workspace/update-report.md'
});