openclaw-rollback 1.0.0

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "openclaw-rollback",
+  "version": "1.0.0",
+  "description": "OpenClaw 智能配置回滚系统 - 基于配置影响图谱与故障根因定位",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "ocr": "bin/cli.js",
+    "openclaw-rollback": "bin/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/webui.js",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "openclaw",
+    "rollback",
+    "config",
+    "backup",
+    "root-cause",
+    "impact-graph",
+    "knowledge-graph",
+    "aiops"
+  ],
+  "author": "zhanxy2",
+  "license": "MIT",
+  "dependencies": {
+    "express": "^4.18.2",
+    "node-cron": "^3.0.3"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.10.0",
+    "@types/node-cron": "^3.0.11",
+    "typescript": "^5.3.0"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "webui",
+    "skills",
+    "scripts",
+    "README.md",
+    "LICENSE",
+    "openclaw.plugin.json"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openclaw/rollback.git"
+  }
+}

package/scripts/install.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+set -e
+
+echo "🚀 安装 OpenClaw Rollback..."
+
+# 检查 Node.js
+if ! command -v node &> /dev/null; then
+    echo "❌ 错误: 未安装 Node.js"
+    exit 1
+fi
+
+NODE_VERSION=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)
+if [ "$NODE_VERSION" -lt 18 ]; then
+    echo "❌ 错误: 需要 Node.js 18+，当前版本: $(node -v)"
+    exit 1
+fi
+
+# 安装
+echo "📦 正在安装 openclaw-rollback..."
+npm install -g openclaw-rollback
+
+# 验证
+echo "✅ 安装完成!"
+echo ""
+echo "可用命令:"
+echo "  ocr backup           立即备份"
+echo "  ocr graph            查看配置影响图谱"
+echo "  ocr impact <node>    分析配置变更影响"
+echo "  ocr root-cause ...   故障根因定位"
+echo "  ocr changes          查看变更历史"
+echo "  ocr webui            启动 Web UI"
+echo ""
+echo "首次使用建议:"
+echo "  ocr backup           # 创建第一个备份"
+echo "  ocr graph            # 查看配置影响图谱"

package/skills/rollback/SKILL.md

@@ -0,0 +1,65 @@
+# OpenClaw Rollback
+
+智能配置回滚系统 —— 基于配置影响图谱与故障根因定位。
+
+## 安装
+
+```bash
+npm install -g openclaw-rollback
+```
+
+## CLI 命令
+
+| 命令 | 说明 |
+|------|------|
+| `ocr backup` | 立即创建备份 |
+| `ocr restore <id>` | 回滚到指定备份 |
+| `ocr list` | 列出所有备份 |
+| `ocr delete <id>` | 删除指定备份 |
+| `ocr graph` | 生成配置影响图谱 |
+| `ocr impact <node>` | 分析配置变更影响 |
+| `ocr root-cause <type> <detail>` | 故障根因定位 |
+| `ocr changes` | 查看配置变更历史 |
+| `ocr status` | 查看 Gateway 健康状态 |
+| `ocr travel-mode [on\|off]` | 开启/关闭出行模式 |
+| `ocr webui` | 启动 Web UI |
+| `ocr config` | 显示当前配置 |
+| `ocr daemon` | 启动守护进程 |
+
+## Web UI
+
+```bash
+ocr webui
+# 访问 http://localhost:3739
+```
+
+## 核心能力
+
+### 1. 配置影响图谱
+
+自动构建配置项之间的依赖/影响关系图，可视化展示。
+
+### 2. 故障根因定位
+
+Gateway 挂了，精准定位是哪个配置项导致的，输出置信度和修复建议。
+
+### 3. 配置变更追踪
+
+自动记录每次配置变更的 diff，用于故障追溯。
+
+### 4. 智能自动回滚
+
+- 健康时自动创建 "known-good" 备份
+- 异常时自动回滚到最后 "known-good"
+- 双重确认机制避免误判
+
+## 故障模式
+
+支持 8 种故障模式的根因定位：
+- 端口不可达
+- 认证失败 (401/403)
+- 进程崩溃
+- 配置解析错误
+- 插件加载失败
+- Agent 连接失败
+- Skill 执行错误