openclaw-sync-assistant 0.0.11 → 0.1.0

package/index.js

@@ -7,6 +7,12 @@ const {
   spinner,
 } = require("@clack/prompts");
 const pc = require("picocolors");
+const path = require("path");
+const os = require("os");
+const GitSyncService = require("./src/github-sync");
+
+let isWizardRunning = false;
+let gitSyncInstance = null;
 
 module.exports = {
   /**
@@ -18,20 +24,69 @@ module.exports = {
       console.log("✅ openclaw-sync-assistant 插件已激活！");
     }
 
+    // 防止在 OpenClaw 的某些生命周期中 activate 被并发/多次调用导致向导重复弹出
+    if (isWizardRunning) return;
+
     // 检查是否已经配置过
     let hasConfigured = false;
+    let syncMethod = null;
+    let githubRepo = null;
+    let syncMode = null;
+
     if (context.api && context.api.config && context.api.config.get) {
-      const currentMethod = await context.api.config.get(
+      syncMethod = await context.api.config.get(
         "openclaw-sync-assistant.syncMethod",
       );
-      if (currentMethod) {
+      githubRepo = await context.api.config.get(
+        "openclaw-sync-assistant.githubRepo",
+      );
+      syncMode = await context.api.config.get(
+        "openclaw-sync-assistant.syncMode",
+      );
+      if (syncMethod) {
         hasConfigured = true;
       }
     }
 
     // 如果未配置，则在安装/首次加载时触发引导向导
     if (!hasConfigured) {
-      await module.exports.runSetupWizard(context);
+      isWizardRunning = true;
+      try {
+        await module.exports.runSetupWizard(context);
+        // 向导结束后重新获取最新配置
+        if (context.api && context.api.config && context.api.config.get) {
+          syncMethod = await context.api.config.get(
+            "openclaw-sync-assistant.syncMethod",
+          );
+          githubRepo = await context.api.config.get(
+            "openclaw-sync-assistant.githubRepo",
+          );
+          syncMode = await context.api.config.get(
+            "openclaw-sync-assistant.syncMode",
+          );
+        }
+      } finally {
+        isWizardRunning = false;
+      }
+    }
+
+    // 启动实际的同步服务
+    if (syncMethod === "github" && githubRepo) {
+      const openclawDir = path.join(os.homedir(), ".openclaw");
+      // 这里我们为了安全，默认只同步 config 和 workspace 等子目录，但为了简单起见，我们在 openclawDir 下创建一个 sync 专用文件夹
+      // 或者直接同步整个 .openclaw 目录（需要在 github-sync.js 中排除一些不必要的缓存）
+      // 推荐做法：在 .openclaw/sync-data 目录做软链接或者单独管理
+      const syncDir = path.join(openclawDir, "sync-data");
+
+      gitSyncInstance = new GitSyncService(
+        syncDir,
+        githubRepo,
+        syncMode,
+        process.env.DEBUG === "openclaw:sync",
+      );
+      await gitSyncInstance.init();
+    } else if (syncMethod === "p2p") {
+      console.log("[OpenClaw Sync] P2P 模式尚未在此版本中完全实现核心逻辑。");
     }
   },
 
@@ -156,9 +211,13 @@ module.exports = {
   },
 
   /**
-   * 插件卸载时的清理函数
+   * 插件卸载或停用时的清理函数
    */
   deactivate() {
-    console.log("❌ openclaw-sync-assistant 插件已卸载。");
+    console.log("❌ openclaw-sync-assistant 插件已卸载/停用。");
+    if (gitSyncInstance) {
+      gitSyncInstance.stop();
+      gitSyncInstance = null;
+    }
   },
 };

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openclaw-sync-assistant",
   "name": "openclaw-sync-assistant",
-  "version": "0.0.11",
+  "version": "0.1.0",
   "description": "OpenClaw Sync Assistant Plugin",
   "commands": [
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-sync-assistant",
-  "version": "0.0.11",
+  "version": "0.1.0",
   "description": "An OpenClaw plugin for P2P file and data synchronization using Hyperswarm and Hyperdrive ecosystem.",
   "main": "index.js",
   "type": "commonjs",
@@ -44,11 +44,13 @@
   "dependencies": {
     "@clack/prompts": "^0.9.0",
     "b4a": "^1.6.6",
+    "chokidar": "^5.0.0",
     "corestore": "^7.9.2",
     "hyperdrive": "^13.3.1",
     "hyperswarm": "^4.17.0",
     "localdrive": "^2.2.1",
-    "picocolors": "^1.1.1"
+    "picocolors": "^1.1.1",
+    "simple-git": "^3.33.0"
   },
   "devDependencies": {
     "eslint": "^8.57.0",

package/src/github-sync.js

@@ -0,0 +1,158 @@
+const simpleGit = require("simple-git");
+const chokidar = require("chokidar");
+const fs = require("fs");
+
+class GitSyncService {
+  constructor(syncDir, githubRepo, syncMode, debug = false) {
+    this.syncDir = syncDir;
+    this.githubRepo = githubRepo;
+    this.syncMode = syncMode; // 'centralized' or 'decentralized'
+    this.debug = debug;
+
+    // 确保同步目录存在，否则 simple-git 初始化会报错
+    if (!fs.existsSync(this.syncDir)) {
+      fs.mkdirSync(this.syncDir, { recursive: true });
+    }
+
+    this.git = simpleGit(this.syncDir);
+    this.watcher = null;
+    this.syncTimeout = null;
+    this.isSyncing = false;
+  }
+
+  log(...args) {
+    if (this.debug) {
+      console.log("[OpenClaw Sync (GitHub)]", ...args);
+    }
+  }
+
+  error(...args) {
+    console.error("[OpenClaw Sync (GitHub)] ❌", ...args);
+  }
+
+  async init() {
+    try {
+      const isRepo = await this.git.checkIsRepo();
+      if (!isRepo) {
+        this.log("初始化本地 Git 仓库...");
+        await this.git.init();
+        await this.git.addRemote("origin", this.githubRepo);
+
+        // 尝试拉取远程仓库以防它是非空的
+        try {
+          await this.git.pull("origin", "main", {
+            "--allow-unrelated-histories": null,
+          });
+        } catch (e) {
+          this.log("远程仓库可能为空，或者拉取失败 (可忽略):", e.message);
+        }
+      } else {
+        // 检查并更新 remote
+        const remotes = await this.git.getRemotes(true);
+        const origin = remotes.find((r) => r.name === "origin");
+        if (!origin) {
+          await this.git.addRemote("origin", this.githubRepo);
+        } else if (origin.refs.fetch !== this.githubRepo) {
+          await this.git.removeRemote("origin");
+          await this.git.addRemote("origin", this.githubRepo);
+        }
+
+        // 获取当前分支，如果为空则尝试设置为 main
+        let currentBranch = "";
+        try {
+          const branches = await this.git.branch();
+          currentBranch = branches.current;
+        } catch (e) {
+          // ignore
+        }
+
+        if (!currentBranch) {
+          try {
+            await this.git.checkoutLocalBranch("main");
+          } catch (e) {
+            // ignore
+          }
+        }
+
+        // 启动时自动拉取最新更改
+        this.log("拉取远程最新状态...");
+        try {
+          await this.git.pull("origin", "main");
+          this.log("✅ 拉取成功");
+        } catch (e) {
+          this.error("拉取失败 (可能仓库为空或无 main 分支):", e.message);
+        }
+      }
+
+      this.startWatching();
+    } catch (err) {
+      this.error("初始化失败:", err);
+    }
+  }
+
+  startWatching() {
+    this.log(`开始监听目录变化: ${this.syncDir}`);
+
+    // 监听目录变化，忽略 .git 目录
+    this.watcher = chokidar.watch(this.syncDir, {
+      ignored: /(^|[/\\])\../, // ignore dotfiles
+      persistent: true,
+      ignoreInitial: true,
+      awaitWriteFinish: {
+        stabilityThreshold: 2000,
+        pollInterval: 100,
+      },
+    });
+
+    const triggerSync = (event, filepath) => {
+      this.log(`检测到文件变化 [${event}]: ${filepath}`);
+
+      // 防抖：2秒内没有新变化则触发同步
+      if (this.syncTimeout) clearTimeout(this.syncTimeout);
+      this.syncTimeout = setTimeout(() => this.performSync(), 2000);
+    };
+
+    this.watcher
+      .on("add", (path) => triggerSync("add", path))
+      .on("change", (path) => triggerSync("change", path))
+      .on("unlink", (path) => triggerSync("unlink", path));
+  }
+
+  async performSync() {
+    if (this.isSyncing) return;
+    this.isSyncing = true;
+
+    try {
+      const status = await this.git.status();
+      if (status.isClean()) {
+        this.log("没有需要提交的更改");
+        this.isSyncing = false;
+        return;
+      }
+
+      this.log("正在提交并推送到 GitHub...");
+      await this.git.add("./*");
+
+      const timestamp = new Date().toISOString();
+      await this.git.commit(`Auto-sync: ${timestamp} via OpenClaw`);
+
+      // 推送
+      await this.git.push("origin", "main");
+      this.log("✅ 同步推送成功！");
+    } catch (err) {
+      this.error("同步推送失败:", err);
+    } finally {
+      this.isSyncing = false;
+    }
+  }
+
+  stop() {
+    if (this.watcher) {
+      this.watcher.close();
+      this.log("停止监听文件变化");
+    }
+    if (this.syncTimeout) clearTimeout(this.syncTimeout);
+  }
+}
+
+module.exports = GitSyncService;