openclaw-sync-assistant 0.0.7 → 0.0.9

package/index.js

@@ -18,144 +18,145 @@ module.exports = {
       console.log("✅ openclaw-sync-assistant 插件已激活！");
     }
 
-    // 对于一些旧版本的 OpenClaw 或不同规范，可能需要挂载在 extensions 对象上
-    if (
-      context.api &&
-      context.api.commands &&
-      typeof context.api.commands.registerCommand === "function"
-    ) {
-      try {
-        context.api.commands.registerCommand("sync.setup", () =>
-          this.executeCommand("sync.setup", {}, context),
-        );
-      } catch (e) {
-        if (process.env.DEBUG === "openclaw:sync") {
-          console.error(e);
-        }
+    // 检查是否已经配置过
+    let hasConfigured = false;
+    if (context.api && context.api.config && context.api.config.get) {
+      const currentMethod = await context.api.config.get(
+        "openclaw-sync-assistant.syncMethod",
+      );
+      if (currentMethod) {
+        hasConfigured = true;
       }
     }
+
+    // 如果未配置，则在安装/首次加载时触发引导向导
+    if (!hasConfigured) {
+      await this.runSetupWizard(context);
+    }
+
+    // 根据模式启动后台服务的逻辑占位
+    // if (config.syncMethod === 'p2p') startP2PService(context);
+    // else if (config.syncMethod === 'github') startGitSyncService(context);
   },
 
   /**
-   * 插件命令执行函数 (通过 openclaw.plugin.json 中的 commands 声明触发)
-   * @param {string} commandId - 触发的命令 ID
-   * @param {object} args - 命令参数
-   * @param {object} context - OpenClaw 插件上下文
+   * 运行配置引导向导
    */
-  async executeCommand(commandId, args, context) {
-    if (commandId === "sync.setup") {
-      console.log("\n");
-      intro(pc.bgCyan(pc.black(" OpenClaw Sync Assistant Setup ")));
-
-      const syncMethod = await select({
-        message: "请选择同步方式 (Sync Method):",
-        options: [
-          { value: "p2p", label: "点对点直连 (P2P - 基于 Hyperswarm)" },
-          { value: "github", label: "GitHub 托管 (基于 Git 仓库)" },
-        ],
-      });
+  async runSetupWizard(context) {
+    console.log("\n");
+    intro(pc.bgCyan(pc.black(" OpenClaw Sync Assistant 初始配置引导 ")));
+    console.log(
+      pc.gray(
+        "提示: 你可以随时按 Ctrl+C 跳过此向导，稍后在配置文件中手动设置。\n",
+      ),
+    );
 
-      const syncMode = await select({
-        message: "请选择同步模式 (Sync Mode):",
-        options: [
-          {
-            value: "decentralized",
-            label:
-              "去中心模式 (Decentralized - 适合多设备对等同步，随时随地拉取)",
-          },
-          {
-            value: "centralized",
-            label:
-              "中心模式 (Centralized - 适合以某台设备或仓库为主的主从同步)",
-          },
-        ],
-      });
+    const syncMethod = await select({
+      message: "请选择同步方式 (Sync Method):",
+      options: [
+        { value: "skip", label: "跳过配置 (稍后设置)" },
+        { value: "p2p", label: "点对点直连 (P2P - 基于 Hyperswarm)" },
+        { value: "github", label: "GitHub 托管 (基于 Git 仓库)" },
+      ],
+    });
 
-      let syncSecret = "";
-      let githubRepo = "";
-
-      if (syncMethod === "p2p") {
-        syncSecret = await text({
-          message:
-            "请输入您的同步密钥 (Sync Secret, 用于生成 P2P 发现的 Topic 和加密数据):",
-          placeholder: "例如: my-super-secret-key",
-          validate(value) {
-            if (value.length === 0) return "同步密钥不能为空！";
-          },
-        });
-      } else if (syncMethod === "github") {
-        githubRepo = await text({
-          message: "请输入用于同步的 GitHub 仓库地址:",
-          placeholder: "例如: https://github.com/your-name/sync-repo.git",
-          validate(value) {
-            if (value.length === 0) return "GitHub 仓库地址不能为空！";
-          },
-        });
-      }
+    if (syncMethod === "skip" || typeof syncMethod === "symbol") {
+      outro(pc.yellow("已跳过同步配置。你可以稍后修改 openclaw.json 来启用。"));
+      return;
+    }
+
+    const syncMode = await select({
+      message: "请选择同步模式 (Sync Mode):",
+      options: [
+        {
+          value: "decentralized",
+          label: "去中心模式 (Decentralized - 适合多设备对等同步)",
+        },
+        {
+          value: "centralized",
+          label: "中心模式 (Centralized - 适合以某台设备为主的主从同步)",
+        },
+        { value: "skip", label: "跳过" },
+      ],
+    });
 
-      const syncItems = await multiselect({
-        message: "请选择要同步的内容:",
-        options: [
-          { value: "Config", label: "Config", hint: "OpenClaw 核心配置" },
-          { value: "Auth", label: "Auth", hint: "认证信息" },
-          { value: "Sessions", label: "Sessions", hint: "会话记录" },
-          { value: "Workspace", label: "Workspace", hint: "工作区状态" },
-        ],
-        required: true,
+    if (syncMode === "skip" || typeof syncMode === "symbol") {
+      outro(pc.yellow("已跳过同步配置。"));
+      return;
+    }
+
+    let syncSecret = "";
+    let githubRepo = "";
+
+    if (syncMethod === "p2p") {
+      syncSecret = await text({
+        message: "请输入您的同步密钥 (Sync Secret, 用于生成 P2P 发现和加密):",
+        placeholder: "例如: my-super-secret-key (直接回车可跳过)",
+      });
+      if (typeof syncSecret === "symbol") return;
+    } else if (syncMethod === "github") {
+      githubRepo = await text({
+        message: "请输入用于同步的 GitHub 仓库地址:",
+        placeholder: "例如: https://github.com/... (直接回车可跳过)",
       });
+      if (typeof githubRepo === "symbol") return;
+    }
 
-      const s = spinner();
-      s.start(
-        `正在初始化 [${syncMethod.toUpperCase()} - ${syncMode}] 同步服务...`,
-      );
+    const syncItems = await multiselect({
+      message: "请选择要同步的内容 (按空格勾选，回车确认):",
+      options: [
+        { value: "Config", label: "Config", hint: "OpenClaw 核心配置" },
+        { value: "Auth", label: "Auth", hint: "认证信息" },
+        { value: "Workspace", label: "Workspace", hint: "工作区状态" },
+      ],
+      required: false,
+    });
+
+    if (typeof syncItems === "symbol") return;
+
+    const s = spinner();
+    s.start(`正在保存初始配置...`);
 
-      // 如果通过 executeCommand 传入的 context 带有 api，则更新配置
-      if (
-        context &&
-        context.api &&
-        context.api.config &&
-        context.api.config.update
-      ) {
+    if (
+      context &&
+      context.api &&
+      context.api.config &&
+      context.api.config.update
+    ) {
+      await context.api.config.update(
+        "openclaw-sync-assistant.syncMethod",
+        syncMethod,
+      );
+      await context.api.config.update(
+        "openclaw-sync-assistant.syncMode",
+        syncMode,
+      );
+      if (syncSecret) {
         await context.api.config.update(
-          "openclaw-sync-assistant.syncMethod",
-          syncMethod,
+          "openclaw-sync-assistant.syncSecret",
+          syncSecret,
         );
+      }
+      if (githubRepo) {
         await context.api.config.update(
-          "openclaw-sync-assistant.syncMode",
-          syncMode,
+          "openclaw-sync-assistant.githubRepo",
+          githubRepo,
         );
-        if (syncSecret)
-          await context.api.config.update(
-            "openclaw-sync-assistant.syncSecret",
-            syncSecret,
-          );
-        if (githubRepo)
-          await context.api.config.update(
-            "openclaw-sync-assistant.githubRepo",
-            githubRepo,
-          );
+      }
+      if (syncItems && syncItems.length > 0) {
         await context.api.config.update(
           "openclaw-sync-assistant.syncItems",
           syncItems,
         );
-      } else {
-        if (process.env.DEBUG === "openclaw:sync") {
-          console.log(
-            "提示: 未找到 context.api.config.update，配置未持久化保存。",
-          );
-        }
       }
-
-      await new Promise((resolve) => setTimeout(resolve, 1500));
-
-      s.stop("配置已保存！");
-
-      outro(
-        pc.green(
-          `✔ 配置完成！同步助手后台服务已按 [${syncMethod.toUpperCase()} - ${syncMode}] 接管状态同步。`,
-        ),
-      );
     }
+
+    s.stop("配置已保存！");
+    outro(
+      pc.green(
+        `✔ 配置向导完成！后台服务将按 [${syncMethod.toUpperCase()}] 模式运行。`,
+      ),
+    );
   },
 
   /**

package/openclaw.plugin.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-sync-assistant",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "description": "An OpenClaw plugin for P2P file and data synchronization using Hyperswarm and Hyperdrive ecosystem.",
   "main": "index.js",
   "type": "commonjs",