@workclaw/cli 1.0.19 → 1.0.22

package/README.md

@@ -1,161 +1,161 @@
-# WorkClaw CLI
-
-WorkClaw CLI 是一个用于初始化和配置 WorkClaw 插件的命令行工具。
-
-## 安装
-
-```bash
-# 使用 npm 安装
-npm install -g @workclaw/cli
-
-# 使用 npx 直接运行（无需安装）
-npx @workclaw/cli local
-```
-
-## 使用
-
-### 命令
-
-本 CLI 提供两个命令：
-
-| 命令 | 说明 |
-|------|------|
-| `workclaw local` | 本地账户安装（需要登录） |
-| `workclaw box` | 盒子设备安装（无需登录，仅支持 Linux） |
-
-### 交互式初始化
-
-```bash
-# 本地安装（需要手机号密码）
-workclaw local
-# 或使用 npx
-npx @workclaw/cli local
-
-# 盒子安装（需要 AppKey 和 AppSecret）
-workclaw box
-# 或使用 npx
-npx @workclaw/cli box
-```
-
-### 命令行参数
-
-#### local 命令参数
-
-| 参数               | 缩写 | 说明             |
-| ---------------- | -- | -------------- |
-| --scenario       | -s | 安装场景           |
-| --env            | -e | 环境 (test/prod) |
-| --phone          | 无  | 手机号码           |
-| --user-pass      | 无  | 用户密码           |
-| --plugin-version | 无  | 插件版本号         |
-| --debug          | 无  | 调试模式           |
-
-#### box 命令参数
-
-| 参数               | 缩写 | 说明 |
-| ---------------- | -- | ---- |
-| --env            | -e | 环境 (test/prod) |
-| --app-key        | 无  | App Key |
-| --app-secret     | 无  | App Secret |
-| --plugin-version | 无  | 插件版本号 |
-| --debug          | 无  | 调试模式 |
-
-### 安装场景
-
-| 场景            | 说明           |
-| ------------- | ------------ |
-| windows-local | Windows 本地安装 |
-| mac-local     | macOS 本地安装   |
-| linux-local   | Linux 本地安装   |
-
-### 环境
-
-| 环境   | 说明   |
-| ---- | ---- |
-| test | 测试环境 |
-| prod | 正式环境 |
-
-## 示例
-
-### 本地安装
-
-#### 交互式安装（推荐新手使用）
-
-```bash
-# 全局安装后运行
-workclaw local
-
-# 或使用 npx 直接运行
-npx @workclaw/cli local
-```
-
-#### 仅指定手机号和密码
-
-```bash
-workclaw local --phone 13800138000 --user-pass your_password
-```
-
-#### 完整参数指定
-
-```bash
-workclaw local --scenario windows-local --env test --phone 13800138000 --user-pass your_password
-```
-
-#### 使用正式环境
-
-```bash
-workclaw local --env prod --phone 13800138000 --user-pass your_password
-```
-
-#### macOS 安装
-
-```bash
-workclaw local --scenario mac-local --phone 13800138000 --user-pass your_password
-```
-
-#### Linux 安装
-
-```bash
-workclaw local --scenario linux-local --phone 13800138000 --user-pass your_password
-```
-
-### 盒子安装
-
-盒子安装适用于不需要用户登录的场景，直接使用 AppKey 和 AppSecret 进行安装。**仅支持 Linux 环境**。
-
-```bash
-# 基本用法
-workclaw box --app-key your_app_key --app-secret your_app_secret
-
-# 指定环境
-workclaw box --app-key your_app_key --app-secret your_app_secret --env prod
-```
-
-### 指定插件版本
-
-可以使用 `--plugin-version` 参数安装指定版本的插件（默认安装最新版）：
-
-```bash
-# 安装指定版本
-workclaw local --phone 13800138000 --user-pass your_password --plugin-version 1.0.0
-workclaw box --app-key your_app_key --app-secret your_app_secret --plugin-version 1.0.0
-```
-
-### 调试模式
-
-当安装失败时，可以使用 `--debug` 参数查看详细日志：
-
-```bash
-# 本地安装 + 调试模式
-workclaw local --phone 13800138000 --user-pass your_password --debug
-
-# 盒子安装 + 调试模式
-workclaw box --app-key your_app_key --app-secret your_app_secret --debug
-
-# 完整参数 + 调试模式
-workclaw local --scenario windows-local --env test --phone 13800138000 --user-pass your_password --debug
-```
-
-## 许可证
-
-MIT License
+# WorkClaw CLI
+
+WorkClaw CLI 是一个用于初始化和配置 WorkClaw 插件的命令行工具。
+
+## 安装
+
+```bash
+# 使用 npm 安装
+npm install -g @workclaw/cli
+
+# 使用 npx 直接运行（无需安装）
+npx @workclaw/cli local
+```
+
+## 使用
+
+### 命令
+
+本 CLI 提供两个命令：
+
+| 命令 | 说明 |
+|------|------|
+| `workclaw local` | 本地账户安装（需要登录） |
+| `workclaw box` | 盒子设备安装（无需登录，仅支持 Linux） |
+
+### 交互式初始化
+
+```bash
+# 本地安装（需要手机号密码）
+workclaw local
+# 或使用 npx
+npx @workclaw/cli local
+
+# 盒子安装（需要 AppKey 和 AppSecret）
+workclaw box
+# 或使用 npx
+npx @workclaw/cli box
+```
+
+### 命令行参数
+
+#### local 命令参数
+
+| 参数               | 缩写 | 说明             |
+| ---------------- | -- | -------------- |
+| --scenario       | -s | 安装场景           |
+| --env            | -e | 环境 (test/prod) |
+| --phone          | 无  | 手机号码           |
+| --user-pass      | 无  | 用户密码           |
+| --plugin-version | 无  | 插件版本号         |
+| --debug          | 无  | 调试模式           |
+
+#### box 命令参数
+
+| 参数               | 缩写 | 说明 |
+| ---------------- | -- | ---- |
+| --env            | -e | 环境 (test/prod) |
+| --app-key        | 无  | App Key |
+| --app-secret     | 无  | App Secret |
+| --plugin-version | 无  | 插件版本号 |
+| --debug          | 无  | 调试模式 |
+
+### 安装场景
+
+| 场景            | 说明           |
+| ------------- | ------------ |
+| windows-local | Windows 本地安装 |
+| mac-local     | macOS 本地安装   |
+| linux-local   | Linux 本地安装   |
+
+### 环境
+
+| 环境   | 说明   |
+| ---- | ---- |
+| test | 测试环境 |
+| prod | 正式环境 |
+
+## 示例
+
+### 本地安装
+
+#### 交互式安装（推荐新手使用）
+
+```bash
+# 全局安装后运行
+workclaw local
+
+# 或使用 npx 直接运行
+npx @workclaw/cli local
+```
+
+#### 仅指定手机号和密码
+
+```bash
+workclaw local --phone 13800138000 --user-pass your_password
+```
+
+#### 完整参数指定
+
+```bash
+workclaw local --scenario windows-local --env test --phone 13800138000 --user-pass your_password
+```
+
+#### 使用正式环境
+
+```bash
+workclaw local --env prod --phone 13800138000 --user-pass your_password
+```
+
+#### macOS 安装
+
+```bash
+workclaw local --scenario mac-local --phone 13800138000 --user-pass your_password
+```
+
+#### Linux 安装
+
+```bash
+workclaw local --scenario linux-local --phone 13800138000 --user-pass your_password
+```
+
+### 盒子安装
+
+盒子安装适用于不需要用户登录的场景，直接使用 AppKey 和 AppSecret 进行安装。**仅支持 Linux 环境**。
+
+```bash
+# 基本用法
+workclaw box --app-key your_app_key --app-secret your_app_secret
+
+# 指定环境
+workclaw box --app-key your_app_key --app-secret your_app_secret --env prod
+```
+
+### 指定插件版本
+
+可以使用 `--plugin-version` 参数安装指定版本的插件（默认安装最新版）：
+
+```bash
+# 安装指定版本
+workclaw local --phone 13800138000 --user-pass your_password --plugin-version 1.0.0
+workclaw box --app-key your_app_key --app-secret your_app_secret --plugin-version 1.0.0
+```
+
+### 调试模式
+
+当安装失败时，可以使用 `--debug` 参数查看详细日志：
+
+```bash
+# 本地安装 + 调试模式
+workclaw local --phone 13800138000 --user-pass your_password --debug
+
+# 盒子安装 + 调试模式
+workclaw box --app-key your_app_key --app-secret your_app_secret --debug
+
+# 完整参数 + 调试模式
+workclaw local --scenario windows-local --env test --phone 13800138000 --user-pass your_password --debug
+```
+
+## 许可证
+
+MIT License

package/dist/{index-K7R_QFg0.js → index-CznpA35l.js}

@@ -4099,6 +4099,19 @@ function getHomeDir$1() {
   return process$1.env.HOME || process$1.env.USERPROFILE || "";
 }
 const PLUGIN_PACKAGE_NAME$1 = "@workclaw/openclaw-workclaw";
+function deepMerge$1(target, source) {
+  const result = { ...target };
+  for (const key in source) {
+    const sourceValue = source[key];
+    const targetValue = target[key];
+    if (sourceValue !== void 0 && sourceValue !== null && typeof sourceValue === "object" && !Array.isArray(sourceValue) && typeof targetValue === "object" && targetValue !== null && !Array.isArray(targetValue)) {
+      result[key] = deepMerge$1(targetValue, sourceValue);
+    } else if (sourceValue !== void 0) {
+      result[key] = sourceValue;
+    }
+  }
+  return result;
+}
 class LocalInstaller {
   constructor(config) {
     this.config = config;
@@ -4292,104 +4305,176 @@ class LocalInstaller {
       debugLog("[更新配置] 无原有配置");
     }
     const config = getConfig(env);
-    const finalConfig = {
-      ...originalConfig,
+    const newConfig = {
+      // diagnostics: 诊断配置
       diagnostics: {
+        // 启用诊断功能
         enabled: true,
+        // 启用所有诊断标志 ['*'] 表示全部，[] 表示禁用所有
         flags: ["*"]
       },
+      // browser: 浏览器配置
       browser: {
+        // 禁用浏览器工具
         enabled: false
       },
+      // models: 模型配置
       models: {
+        // 配置合并模式：'merge' 合并 | 'replace' 替换
         mode: "merge",
         providers: {
           "siliconflow-minimax": {
+            // 模型 API 基础地址
             baseUrl: boundConfig.modelApiBaseUrl || config.MODEL_BASE_URL,
+            // API 密钥（从服务器获取）
             apiKey: boundConfig.modelApiKey,
+            // API 类型：'openai-completions' | 'openai-chat' 等
             api: "openai-completions",
+            // 是否使用 Authorization header 认证
             authHeader: true,
             models: [{
+              // 模型 ID（provider/model 格式）
               id: "Pro/MiniMaxAI/MiniMax-M2.5",
+              // 模型显示名称
               name: "MiniMax-M2.5",
+              // 是否启用推理能力
               reasoning: false,
+              // 支持的输入类型：['text'] | ['text', 'image']
               input: ["text"],
+              // 价格（0 表示免费或未设置）
               cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+              // 上下文窗口大小（token）
               contextWindow: 2e5,
+              // 最大输出 token 数
               maxTokens: 65536
             }]
           }
         }
       },
+      // agents: 代理配置
       agents: {
         defaults: {
+          // 默认使用的模型
           model: { primary: "siliconflow-minimax/Pro/MiniMaxAI/MiniMax-M2.5" },
           models: {
             "siliconflow-minimax/Pro/MiniMaxAI/MiniMax-M2.5": {
+              // 模型别名，用于显示
               alias: "Pro/MiniMaxAI/MiniMax-M2.5"
             }
           },
+          // 工作区目录路径
           workspace: paths.workspace,
+          // 会话压缩模式：'safeguard' 保守模式
           compaction: { mode: "safeguard" },
+          // 详细程度：'full' | 'short' | 'off'
           verboseDefault: "full",
+          // 最大并发任务数
           maxConcurrent: 4,
+          // 子代理最大并发数
           subagents: { maxConcurrent: 8 }
         },
+        // 代理列表
         list: [{ id: "main", workspace: paths.workspace }]
       },
+      // tools: 工具配置
       tools: {
+        // 禁用的工具列表（优先于 allow）
         deny: ["image", "web_search", "web_fetch"],
+        // 图像分析工具
         media: { image: { enabled: false } },
+        // 网络搜索和抓取工具
         web: { search: { enabled: false }, fetch: { enabled: false } },
+        // 提升权限工具（host=gateway）
         elevated: { enabled: true, allowFrom: { webchat: ["*"] } },
+        // exec 工具安全级别：'deny' | 'allowlist' | 'full'
         exec: { security: "full" }
       },
+      // bindings: 绑定配置
       bindings: [{
+        // 绑定的代理 ID
         agentId: "main",
+        // 匹配的通道和账户
         match: { channel: "openclaw-workclaw", accountId: "default" }
       }],
-      messages: { ackReactionScope: "group-mentions" },
+      // messages: 消息配置
+      messages: {
+        // 消息确认范围
+        ackReactionScope: "group-mentions"
+      },
+      // commands: 命令配置
       commands: {
+        // 本机命令：'auto' | 'on' | 'off'
         native: "auto",
+        // 本机技能：'auto' | 'on' | 'off'
         nativeSkills: "auto",
+        // 是否允许重启命令
         restart: true,
+        // 所有者显示格式：'raw' | 'name' | 'hidden'
         ownerDisplay: "raw"
       },
-      session: { dmScope: "per-account-channel-peer" },
+      // session: 会话配置
+      session: {
+        // DM 作用域
+        dmScope: "per-account-channel-peer"
+      },
+      // hooks: 钩子配置
       hooks: {
         internal: {
+          // 启用内部钩子
           enabled: true,
           entries: {
+            // 启动 Markdown 钩子
             "boot-md": { enabled: true },
+            // 引导额外文件钩子
             "bootstrap-extra-files": { enabled: true },
+            // 命令日志钩子
             "command-logger": { enabled: true },
+            // 会话记忆钩子
             "session-memory": { enabled: true }
           }
         }
       },
+      // channels: 通道配置
       channels: {
         "openclaw-workclaw": {
+          // 启用通道
           enabled: true,
+          // 连接模式：'websocket' | 'http'
           connectionMode: "websocket",
+          // WebSocket 连接策略
           wsConnectionStrategy: "per-appKey",
+          // 应用密钥（从服务器获取）
           appKey: boundConfig.appKey,
+          // 应用密钥（从服务器获取）
           appSecret: boundConfig.appSecret,
+          // API 基础 URL
           baseUrl: this.config.baseUrl || config.DEFAULT_BASE_URL,
+          // WebSocket URL
           websocketUrl: this.config.wsUrl || config.DEFAULT_WS_URL,
+          // 允许不安全的 TLS 连接
           allowInsecureTls: true,
+          // 允许原始 JSON 载荷
           allowRawJsonPayload: true,
           accounts: {
+            // 账户配置（agentId 从服务器获取）
             default: { enabled: true, agentId: boundConfig.agentId }
           }
         }
       },
+      // gateway: 网关配置
       gateway: {
+        // 网关模式：'local' | 'hosted'
         mode: "local",
+        // 网关端口
         port: 18789,
+        // 绑定地址：'loopback' | 'lan' | 'all'
         bind: "loopback",
+        // 认证模式
         auth: { mode: "token", token: "" },
+        // Tailscale 配置
         tailscale: { mode: "off", resetOnExit: false },
         nodes: {
+          // 节点上禁止的命令
           denyCommands: [
             "camera.snap",
             "camera.clip",
@@ -4402,45 +4487,56 @@ class LocalInstaller {
           ]
         },
         controlUi: {
+          // 允许不安全认证
           allowInsecureAuth: true,
+          // 禁用设备认证（仅用于开发）
           dangerouslyDisableDeviceAuth: true,
+          // 允许 Host 头源回退
           dangerouslyAllowHostHeaderOriginFallback: true,
+          // 允许的源
           allowedOrigins: ["http://localhost:18789", "http://127.0.0.1:18789"]
         }
       },
-      skills: { load: { watch: true } },
+      // skills: 技能配置
+      skills: {
+        // 技能加载监视模式
+        load: { watch: true }
+      },
+      // logging: 日志配置
       logging: {
+        // 日志级别：'debug' | 'info' | 'warn' | 'error'
         level: "info",
+        // 控制台日志级别
         consoleLevel: "info",
+        // 控制台样式：'pretty' | 'basic' | 'raw'
         consoleStyle: "pretty",
+        // 敏感信息脱敏：'off' | 'keys' | 'all'
         redactSensitive: "off",
+        // 日志文件路径（空表示不写入文件）
         file: "",
+        // 脱敏模式（正则表达式）
         redactPatterns: ["sk-.*"]
       },
+      // plugins: 插件配置
       plugins: {
+        // 允许的插件列表
         allow: [config.PLUGIN_NAME],
+        // 插件安装跟踪
         installs: {
           [config.PLUGIN_NAME]: {
-            source: "npm",
-            npm: PLUGIN_PACKAGE_NAME$1,
+            // npm 包名
+            installSource: PLUGIN_PACKAGE_NAME$1,
+            // 安装路径
             installPath: paths.target
           }
         },
+        // 插件条目启用状态
         entries: {
           [config.PLUGIN_NAME]: { enabled: true }
         }
-      },
-      wizard: {
-        lastRunAt: "",
-        lastRunVersion: "",
-        lastRunCommand: "",
-        lastRunMode: ""
-      },
-      meta: {
-        lastTouchedVersion: "",
-        lastTouchedAt: ""
       }
     };
+    const finalConfig = deepMerge$1(originalConfig, newConfig);
     debugLog("[更新配置] 写入配置文件...");
     await fs.writeFile(paths.config, JSON.stringify(finalConfig, null, 2), "utf-8");
     this.prefixText += chalk.green(`✓ 配置文件更新成功
@@ -4614,6 +4710,19 @@ function getHomeDir() {
   return process$1.env.HOME || process$1.env.USERPROFILE || "";
 }
 const PLUGIN_PACKAGE_NAME = "@workclaw/openclaw-workclaw";
+function deepMerge(target, source) {
+  const result = { ...target };
+  for (const key in source) {
+    const sourceValue = source[key];
+    const targetValue = target[key];
+    if (sourceValue !== void 0 && sourceValue !== null && typeof sourceValue === "object" && !Array.isArray(sourceValue) && typeof targetValue === "object" && targetValue !== null && !Array.isArray(targetValue)) {
+      result[key] = deepMerge(targetValue, sourceValue);
+    } else if (sourceValue !== void 0) {
+      result[key] = sourceValue;
+    }
+  }
+  return result;
+}
 class BoxInstaller {
   constructor(config) {
     this.config = config;
@@ -4635,76 +4744,80 @@ class BoxInstaller {
     if (!this.config.appSecret) {
       throw new AppError2(ERROR_CODES.APP_SECRET_REQUIRED, "AppSecret 不能为空，请使用 --app-secret 参数");
     }
-    debugLog("[验证配置] 配置验证通过");
+    debugLog("[验证配置] 配置检查通过");
+  }
+  getPaths() {
+    const home = getHomeDir();
+    const openclawDir = path.join(home, ".openclaw");
+    const extensionsDir = path.join(openclawDir, "extensions");
+    const targetDir = path.join(extensionsDir, "openclaw-workclaw");
+    const configFile = path.join(openclawDir, "openclaw.json");
+    const workspaceDir = path.join(openclawDir, "workspace");
+    const tempDir = path.join(openclawDir, ".temp");
+    return {
+      home,
+      extensions: extensionsDir,
+      target: targetDir,
+      config: configFile,
+      workspace: workspaceDir,
+      temp: tempDir
+    };
+  }
+  updateSpinner(text) {
+    this.spinner.prefixText = this.prefixText;
+    this.spinner.text = `${chalk.cyan("安装进度")} ${chalk.dim("→")} ${chalk.yellow(text)}`;
+    debugLog(`[Spinner] ${text}`);
+  }
+  getPrefixText() {
+    return this.prefixText;
   }
   async install() {
     try {
-      debugLog("[安装开始]");
+      debugLog("[盒子安装] 开始安装...");
       this.validateConfig();
-      const env = this.config.env || "test";
-      const config = getConfig(env);
-      const homeDir = getHomeDir();
-      const paths = {
-        home: path.join(homeDir, config.DIRS.OPENCLAW),
-        extensions: path.join(homeDir, config.DIRS.OPENCLAW, config.DIRS.EXTENSIONS),
-        target: path.join(homeDir, config.DIRS.OPENCLAW, config.DIRS.EXTENSIONS, config.PLUGIN_NAME),
-        config: path.join(homeDir, config.DIRS.OPENCLAW, config.DIRS.CONFIG_FILE),
-        workspace: path.join(homeDir, config.DIRS.OPENCLAW, config.DIRS.WORKSPACE),
-        temp: path.join(homeDir, config.DIRS.OPENCLAW, config.DIRS.TEMP)
-      };
-      debugLog(`[路径配置] home=${paths.home}`);
-      debugLog(`[路径配置] extensions=${paths.extensions}`);
-      debugLog(`[路径配置] target=${paths.target}`);
-      debugLog(`[路径配置] config=${paths.config}`);
-      debugLog(`[路径配置] workspace=${paths.workspace}`);
-      await this.doCleanOldFiles(paths.target);
+      this.updateSpinner("验证配置完成");
+      const paths = this.getPaths();
+      await this.doCleanOldFiles(paths);
+      this.updateSpinner("清理旧版本完成");
       await this.doDownloadFromNpm(paths);
-      await this.doUpdateConfig(paths, env);
+      this.updateSpinner("下载插件完成");
+      await this.doUpdateConfig(paths);
+      this.updateSpinner("更新配置完成");
       this.spinner.stop();
+      debugLog("[盒子安装] 安装完成");
     } catch (error) {
       this.spinner.stop();
+      debugLog(`[盒子安装] 安装失败: ${error.message}`);
       throw error;
     }
   }
-  getPrefixText() {
-    return this.prefixText;
-  }
-  async doCleanOldFiles(targetPath) {
-    this.spinner.prefixText = this.prefixText;
-    this.spinner.text = `${chalk.cyan("清理旧版本")} ${chalk.dim("→")} ${chalk.yellow("检查目录...")}`;
-    debugLog(`[清理旧版本] 检查目录: ${targetPath}`);
+  async doCleanOldFiles(paths) {
+    debugLog("[清理旧版本] 开始清理旧版本...");
+    this.prefixText += chalk.green(`✓ 开始清理旧版本
+`);
     try {
-      await fs.access(targetPath);
-      debugLog("[清理旧版本] 发现旧版本，开始清理...");
-      this.spinner.prefixText = this.prefixText;
-      this.spinner.text = `${chalk.cyan("清理旧版本")} ${chalk.dim("→")} ${chalk.yellow("正在清理...")}`;
-      await fs.rm(targetPath, { recursive: true, force: true });
-      this.prefixText += chalk.green(`✓ 旧版本清理完成
+      await fs.access(paths.target);
+      debugLog("[清理旧版本] 删除旧版本目录...");
+      await fs.rm(paths.target, { recursive: true, force: true });
+      this.prefixText += chalk.green(`✓ 旧版本清理成功
 `);
-      debugLog("[清理旧版本] 清理完成");
+      debugLog("[清理旧版本] 旧版本清理成功");
     } catch {
-      this.prefixText += chalk.green(`✓ 未发现旧版本
+      debugLog("[清理旧版本] 无旧版本需要清理");
+      this.prefixText += chalk.green(`✓ 无旧版本需要清理
 `);
-      debugLog("[清理旧版本] 未发现旧版本");
+    }
+    try {
+      await fs.access(paths.temp);
+      await fs.rm(paths.temp, { recursive: true, force: true });
+    } catch {
+      debugLog("[清理旧版本] 无临时目录需要清理");
     }
   }
   async doDownloadFromNpm(paths) {
-    this.spinner.prefixText = this.prefixText;
-    this.spinner.text = `${chalk.cyan("下载插件")} ${chalk.dim("→")} ${chalk.yellow("准备目录")}`;
-    debugLog("[下载插件] 创建扩展目录...");
-    await fs.mkdir(paths.extensions, { recursive: true });
-    debugLog(`[下载插件] 扩展目录: ${paths.extensions}`);
-    const tempDir = path.join(paths.temp, `install-${Date.now()}`);
-    debugLog(`[下载插件] 创建临时目录: ${tempDir}`);
-    await fs.mkdir(tempDir, { recursive: true });
-    this.spinner.prefixText = this.prefixText;
-    this.spinner.text = `${chalk.cyan("下载插件")} ${chalk.dim("→")} ${chalk.yellow("下载 tarball")}`;
-    debugLog("[下载插件] 执行 npm pack 下载源码包");
-    debugLog(`[下载插件] 工作目录: ${tempDir}`);
-    const tarballPath = await this.downloadTarball(tempDir);
-    await this.extractTarball(tarballPath, paths, tempDir);
-  }
-  async downloadTarball(tempDir) {
+    debugLog("[下载插件] 开始下载插件...");
+    this.prefixText += chalk.green(`✓ 开始下载插件
+`);
     const maxRetries = 3;
     let lastError = "";
     let tarballPath = "";
@@ -4716,10 +4829,10 @@ class BoxInstaller {
         const { execSync: execSync2 } = await import("node:child_process");
         const output = execSync2(
           `npm pack ${packageName} --registry=https://mirrors.tencent.com/npm/ --ignore-scripts`,
-          { cwd: tempDir, encoding: "utf-8", timeout: 6e4 }
+          { cwd: paths.temp, encoding: "utf-8", timeout: 6e4 }
         );
         const filename = output.trim().split("\n").pop() || "";
-        tarballPath = path.join(tempDir, filename);
+        tarballPath = path.join(paths.temp, filename);
         debugLog(`[下载插件] tarball 下载成功: ${tarballPath}`);
         break;
       } catch (error) {
@@ -4731,50 +4844,49 @@ class BoxInstaller {
         }
       }
     }
-    if (!tarballPath || !await fs.access(tarballPath).then(() => true).catch(() => false)) {
-      throw new AppError2(ERROR_CODES.NPM_INSTALL_FAILED, `tarball 下载失败: ${lastError}`);
+    if (!tarballPath) {
+      this.prefixText += chalk.red(`✗ 下载失败
+`);
+      throw new AppError2(ERROR_CODES.NPM_INSTALL_FAILED, `插件下载失败: ${lastError}`);
     }
-    return tarballPath;
+    this.prefixText += chalk.green(`✓ 插件下载成功
+`);
+    await this.extractTarball(tarballPath, paths);
   }
-  async extractTarball(tarballPath, paths, tempDir) {
-    this.spinner.prefixText = this.prefixText;
-    this.spinner.text = `${chalk.cyan("下载插件")} ${chalk.dim("→")} ${chalk.yellow("解压 tarball")}`;
-    debugLog(`[下载插件] 创建插件目录: ${paths.target}`);
-    await fs.mkdir(paths.target, { recursive: true });
-    debugLog(`[下载插件] 解压 tarball 到: ${paths.target}`);
+  async extractTarball(tarballPath, paths) {
+    debugLog("[解压插件] 开始解压 tarball...");
     try {
+      await fs.mkdir(paths.temp, { recursive: true });
       await tar.extract({
         file: tarballPath,
-        cwd: paths.target,
-        strip: 1
+        cwd: paths.temp
       });
-      debugLog("[下载插件] tarball 解压成功");
+      const packageDir = path.join(paths.temp, "package");
+      const stat = await fs.stat(packageDir);
+      if (stat.isDirectory()) {
+        await fs.mkdir(paths.extensions, { recursive: true });
+        await fs.cp(packageDir, paths.target, { recursive: true });
+        debugLog(`[解压插件] 插件解压成功: ${paths.target}`);
+        this.prefixText += chalk.green(`✓ 插件解压成功
+`);
+        await fs.rm(paths.temp, { recursive: true, force: true });
+        debugLog(`[解压插件] 清理临时文件成功`);
+        this.prefixText += chalk.green(`✓ 清理临时文件成功
+`);
+      } else {
+        throw new Error("解压失败：package 目录不存在");
+      }
     } catch (error) {
-      throw new AppError2(ERROR_CODES.NPM_INSTALL_FAILED, `tarball 解压失败: ${error.message}`);
-    }
-    const pluginPath = path.join(paths.target, "package.json");
-    const pluginExists = await fs.access(pluginPath).then(() => true).catch(() => false);
-    if (!pluginExists) {
-      throw new AppError2(ERROR_CODES.NPM_INSTALL_FAILED, "插件解压后未找到 package.json");
-    }
-    debugLog("[下载插件] 插件解压成功");
-    this.prefixText += chalk.green(`✓ 插件下载完成
+      debugLog(`[解压插件] 解压失败: ${error.message}`);
+      this.prefixText += chalk.red(`✗ 解压失败
 `);
-    try {
-      await fs.rm(tempDir, { recursive: true, force: true });
-      debugLog("[下载插件] 清理临时目录完成");
-    } catch {
-      debugLog("[下载插件] 清理临时目录失败（忽略）");
+      throw new AppError2(ERROR_CODES.NPM_INSTALL_FAILED, `插件解压失败: ${error.message}`);
     }
   }
-  async doUpdateConfig(paths, env) {
-    this.spinner.prefixText = this.prefixText;
-    this.spinner.text = `${chalk.cyan("更新配置")} ${chalk.dim("→")} ${chalk.yellow("写入配置文件")}`;
-    debugLog("[更新配置] 创建目录...");
-    await fs.mkdir(paths.home, { recursive: true });
-    await fs.mkdir(paths.workspace, { recursive: true });
-    debugLog("[更新配置] 目录创建完成");
-    debugLog("[更新配置] 读取原有配置...");
+  async doUpdateConfig(paths) {
+    debugLog("[更新配置] 开始更新配置...");
+    this.prefixText += chalk.green(`✓ 开始更新配置
+`);
     let originalConfig = {};
     try {
       const content = await fs.readFile(paths.config, "utf-8");
@@ -4783,105 +4895,179 @@ class BoxInstaller {
     } catch {
       debugLog("[更新配置] 无原有配置");
     }
-    const config = getConfig(env);
-    const finalConfig = {
-      ...originalConfig,
+    const config = getConfig(this.config.env);
+    const newConfig = {
+      // diagnostics: 诊断配置
       diagnostics: {
+        // 启用诊断功能
         enabled: true,
+        // 启用所有诊断标志 ['*'] 表示全部，[] 表示禁用所有
         flags: ["*"]
       },
+      // browser: 浏览器配置
       browser: {
+        // 禁用浏览器工具
         enabled: false
       },
+      // models: 模型配置
       models: {
+        // 配置合并模式：'merge' 合并 | 'replace' 替换
         mode: "merge",
         providers: {
           "siliconflow-minimax": {
+            // 模型 API 基础地址
             baseUrl: config.MODEL_BASE_URL,
+            // API 密钥（留空，由外部提供）
             apiKey: "",
+            // API 类型：'openai-completions' | 'openai-chat' 等
             api: "openai-completions",
+            // 是否使用 Authorization header 认证
             authHeader: true,
             models: [{
+              // 模型 ID（provider/model 格式）
               id: "Pro/MiniMaxAI/MiniMax-M2.5",
+              // 模型显示名称
               name: "MiniMax-M2.5",
+              // 是否启用推理能力
               reasoning: false,
+              // 支持的输入类型：['text'] | ['text', 'image']
               input: ["text"],
+              // 价格（0 表示免费或未设置）
               cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+              // 上下文窗口大小（token）
               contextWindow: 2e5,
+              // 最大输出 token 数
               maxTokens: 65536
             }]
           }
         }
       },
+      // agents: 代理配置
       agents: {
         defaults: {
+          // 默认使用的模型
           model: { primary: "siliconflow-minimax/Pro/MiniMaxAI/MiniMax-M2.5" },
           models: {
             "siliconflow-minimax/Pro/MiniMaxAI/MiniMax-M2.5": {
+              // 模型别名，用于显示
               alias: "Pro/MiniMaxAI/MiniMax-M2.5"
             }
           },
+          // 工作区目录路径
           workspace: paths.workspace,
+          // 会话压缩模式：'safeguard' 保守模式
           compaction: { mode: "safeguard" },
+          // 详细程度：'full' | 'short' | 'off'
           verboseDefault: "full",
+          // 最大并发任务数
           maxConcurrent: 4,
+          // 子代理最大并发数
           subagents: { maxConcurrent: 8 }
         },
+        // 代理列表
         list: [{ id: "main", workspace: paths.workspace }]
       },
+      // tools: 工具配置
       tools: {
+        // 禁用的工具列表（优先于 allow）
         deny: ["image", "web_search", "web_fetch"],
+        // 图像分析工具
         media: { image: { enabled: false } },
+        // 网络搜索和抓取工具
         web: { search: { enabled: false }, fetch: { enabled: false } },
+        // 提升权限工具（host=gateway）
         elevated: { enabled: true, allowFrom: { webchat: ["*"] } },
+        // exec 工具安全级别：'deny' | 'allowlist' | 'full'
         exec: { security: "full" }
       },
+      // bindings: 绑定配置
       bindings: [{
+        // 绑定的代理 ID
         agentId: "main",
+        // 匹配的通道和账户
         match: { channel: "openclaw-workclaw", accountId: "default" }
       }],
-      messages: { ackReactionScope: "group-mentions" },
+      // messages: 消息配置
+      messages: {
+        // 消息确认范围
+        ackReactionScope: "group-mentions"
+      },
+      // commands: 命令配置
       commands: {
+        // 本机命令：'auto' | 'on' | 'off'
         native: "auto",
+        // 本机技能：'auto' | 'on' | 'off'
         nativeSkills: "auto",
+        // 是否允许重启命令
         restart: true,
+        // 所有者显示格式：'raw' | 'name' | 'hidden'
         ownerDisplay: "raw"
       },
-      session: { dmScope: "per-account-channel-peer" },
+      // session: 会话配置
+      session: {
+        // DM 作用域
+        dmScope: "per-account-channel-peer"
+      },
+      // hooks: 钩子配置
       hooks: {
         internal: {
+          // 启用内部钩子
           enabled: true,
           entries: {
+            // 启动 Markdown 钩子
             "boot-md": { enabled: true },
+            // 引导额外文件钩子
             "bootstrap-extra-files": { enabled: true },
+            // 命令日志钩子
             "command-logger": { enabled: true },
+            // 会话记忆钩子
             "session-memory": { enabled: true }
           }
         }
       },
+      // channels: 通道配置
       channels: {
         "openclaw-workclaw": {
+          // 启用通道
           enabled: true,
+          // 连接模式：'websocket' | 'http'
           connectionMode: "websocket",
+          // WebSocket 连接策略
           wsConnectionStrategy: "per-appKey",
+          // 应用密钥
           appKey: this.config.appKey,
+          // 应用密钥
           appSecret: this.config.appSecret,
+          // API 基础 URL
           baseUrl: this.config.baseUrl || config.DEFAULT_BASE_URL,
+          // WebSocket URL
           websocketUrl: this.config.wsUrl || config.DEFAULT_WS_URL,
+          // 允许不安全的 TLS 连接
           allowInsecureTls: true,
+          // 允许原始 JSON 载荷
           allowRawJsonPayload: true,
           accounts: {
+            // 账户配置（agentId 为空表示待分配）
             default: { enabled: true, agentId: "" }
           }
         }
       },
+      // gateway: 网关配置
       gateway: {
+        // 网关模式：'local' | 'hosted'
         mode: "local",
+        // 网关端口
         port: 18789,
+        // 绑定地址：'loopback' | 'lan' | 'all'
         bind: "loopback",
-        auth: { mode: "token", token: "" },
+        // 认证模式（token字段未设置，是因为需要使用原始配置的token）
+        auth: {
+          mode: "token"
+        },
+        // Tailscale 配置
         tailscale: { mode: "off", resetOnExit: false },
         nodes: {
+          // 节点上禁止的命令
           denyCommands: [
             "camera.snap",
             "camera.clip",
@@ -4894,45 +5080,56 @@ class BoxInstaller {
           ]
         },
         controlUi: {
+          // 允许不安全认证
           allowInsecureAuth: true,
+          // 禁用设备认证（仅用于开发）
           dangerouslyDisableDeviceAuth: true,
+          // 允许 Host 头源回退
           dangerouslyAllowHostHeaderOriginFallback: true,
+          // 允许的源
           allowedOrigins: ["http://localhost:18789", "http://127.0.0.1:18789"]
         }
       },
-      skills: { load: { watch: true } },
+      // skills: 技能配置
+      skills: {
+        // 技能加载监视模式
+        load: { watch: true }
+      },
+      // logging: 日志配置
       logging: {
+        // 日志级别：'debug' | 'info' | 'warn' | 'error'
         level: "info",
+        // 控制台日志级别
         consoleLevel: "info",
+        // 控制台样式：'pretty' | 'basic' | 'raw'
         consoleStyle: "pretty",
+        // 敏感信息脱敏：'off' | 'keys' | 'all'
         redactSensitive: "off",
+        // 日志文件路径（空表示不写入文件）
         file: "",
+        // 脱敏模式（正则表达式）
         redactPatterns: ["sk-.*"]
       },
+      // plugins: 插件配置
       plugins: {
+        // 允许的插件列表
         allow: [config.PLUGIN_NAME],
+        // 插件安装跟踪
         installs: {
           [config.PLUGIN_NAME]: {
-            source: "npm",
-            npm: "@workclaw/openclaw-workclaw",
+            // npm 包名
+            installSource: PLUGIN_PACKAGE_NAME,
+            // 安装路径
             installPath: paths.target
           }
         },
+        // 插件条目启用状态
         entries: {
           [config.PLUGIN_NAME]: { enabled: true }
         }
-      },
-      wizard: {
-        lastRunAt: "",
-        lastRunVersion: "",
-        lastRunCommand: "",
-        lastRunMode: ""
-      },
-      meta: {
-        lastTouchedVersion: "",
-        lastTouchedAt: ""
       }
     };
+    const finalConfig = deepMerge(originalConfig, newConfig);
     debugLog("[更新配置] 写入配置文件...");
     await fs.writeFile(paths.config, JSON.stringify(finalConfig, null, 2), "utf-8");
     this.prefixText += chalk.green(`✓ 配置文件更新成功

package/dist/index.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import("./index-K7R_QFg0.js").then((cli) => {
+import("./index-CznpA35l.js").then((cli) => {
   cli.default();
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@workclaw/cli",
   "type": "module",
-  "version": "1.0.19",
+  "version": "1.0.22",
   "description": "WorkClaw CLI 工具 - 用于初始化和配置 WorkClaw 插件",
   "license": "MIT",
   "keywords": [