@playcraft/cli 0.0.11 → 0.0.13

package/dist/commands/build.js

@@ -1,6 +1,5 @@
 import path from 'path';
 import fs from 'fs/promises';
-import os from 'os';
 import pc from 'picocolors';
 import ora from 'ora';
 import { BaseBuilder, ViteBuilder, PlayableBuilder } from '@playcraft/build';
@@ -10,16 +9,24 @@ import inquirer from 'inquirer';
  * 检测是否是基础构建产物（多文件版本）
  */
 async function detectBaseBuild(dir) {
-    const indicators = [
+    // 基础文件：所有格式都需要
+    const baseIndicators = [
         path.join(dir, 'index.html'),
         path.join(dir, 'config.json'),
-        path.join(dir, '__start__.js'),
     ];
+    // Classic 格式特有
+    const classicIndicator = path.join(dir, '__start__.js');
+    // ESM 格式特有
+    const esmIndicator = path.join(dir, 'js/index.mjs');
     try {
-        await fs.access(indicators[0]);
-        await fs.access(indicators[1]);
-        await fs.access(indicators[2]);
-        return true;
+        // 检查基础文件
+        for (const indicator of baseIndicators) {
+            await fs.access(indicator);
+        }
+        // 检查格式特有文件（满足其一即可）
+        const isClassic = await fs.access(classicIndicator).then(() => true).catch(() => false);
+        const isESM = await fs.access(esmIndicator).then(() => true).catch(() => false);
+        return isClassic || isESM;
     }
     catch (error) {
         return false;
@@ -209,10 +216,15 @@ async function analyzeBaseBuild(baseBuildDir, ammoReplacement) {
     };
 }
 export async function buildCommand(projectPath, options) {
+    // 解析项目路径 - 在 spinner 之前执行以便调试
+    const resolvedProjectPath = path.resolve(projectPath);
+    console.log(`[DEBUG] projectPath: ${projectPath}`);
+    console.log(`[DEBUG] resolvedProjectPath: ${resolvedProjectPath}`);
+    console.log(`[DEBUG] cwd: ${process.cwd()}`);
     const spinner = ora(pc.cyan('🔨 开始打包 Playable Ad...')).start();
+    // 清理选项（默认为 false，使用覆盖模式）
+    const shouldClean = options.clean === true;
     try {
-        // 解析项目路径
-        const resolvedProjectPath = path.resolve(projectPath);
         if (!options.baseOnly && !options.mode) {
             spinner.stop();
             const modeAnswer = await inquirer.prompt([
@@ -300,10 +312,22 @@ export async function buildCommand(projectPath, options) {
         }
         // 如果只执行基础构建
         if (options.baseOnly || options.mode === 'base') {
+            // 确定输出目录（Base Build 默认 ./build）
+            const baseBuildOutputDir = path.resolve(options.output || './build');
+            // 安全检查：防止输出目录与输入目录相同时被清理
+            const isSameAsInput = path.resolve(baseBuildOutputDir) === path.resolve(resolvedProjectPath);
+            // 如果输出目录与输入目录相同，警告用户并禁用清理
+            if (shouldClean && isSameAsInput) {
+                console.log(pc.yellow(`\n⚠️  输出目录与输入目录相同，跳过清理以保护源文件`));
+            }
+            else if (!shouldClean) {
+                console.log(pc.dim(`\nℹ️  使用覆盖模式，新文件将覆盖旧文件（使用 --clean 可清理旧目录）`));
+            }
             spinner.text = pc.cyan('执行阶段1: 基础构建...');
             const baseBuilder = new BaseBuilder(resolvedProjectPath, {
-                outputDir: path.resolve(options.output || './build'),
+                outputDir: baseBuildOutputDir,
                 selectedScenes,
+                clean: shouldClean && !isSameAsInput, // 清理逻辑由 BaseBuilder 内部处理
             });
             const baseBuild = await baseBuilder.build();
             spinner.succeed(pc.green('✅ 基础构建完成！'));
@@ -311,7 +335,7 @@ export async function buildCommand(projectPath, options) {
             console.log(pc.dim('💡 提示: 可以在浏览器中打开 index.html 测试游戏'));
             return;
         }
-        // 完整流程：阶段1 + 阶段2
+        // 完整流程：阶段1 + 阶段2（Playable Ads）
         const shouldRunPlayableOnly = options.mode === 'playable';
         // 验证平台
         const validPlatforms = [
@@ -329,30 +353,80 @@ export async function buildCommand(projectPath, options) {
             'adikteev',
             'remerge',
         ];
+        // 渠道输出格式配置（根据各渠道Playable规格对照表）
+        // 只支持 HTML: applovin, ironsource, unity, moloco, adikteev, remerge
+        // 只支持 ZIP: google, tiktok, liftoff, bigo, snapchat, inmobi
+        // 支持两种: facebook
+        const platformFormatConfig = {
+            facebook: {
+                formats: ['html', 'zip'],
+                default: 'html',
+                description: 'Facebook 支持两种格式'
+            },
+            applovin: { formats: ['html'], default: 'html' },
+            ironsource: { formats: ['html'], default: 'html' },
+            unity: { formats: ['html'], default: 'html' },
+            moloco: { formats: ['html'], default: 'html' },
+            adikteev: { formats: ['html'], default: 'html' },
+            remerge: { formats: ['html'], default: 'html' },
+            google: { formats: ['zip'], default: 'zip' },
+            tiktok: { formats: ['zip'], default: 'zip' },
+            liftoff: { formats: ['zip'], default: 'zip' },
+            bigo: { formats: ['zip'], default: 'zip' },
+            snapchat: { formats: ['zip'], default: 'zip' },
+            inmobi: { formats: ['zip'], default: 'zip' },
+        };
+        // 获取渠道支持的格式
+        const getPlatformFormats = (platform) => {
+            return platformFormatConfig[platform] || { formats: ['html', 'zip'], default: 'html' };
+        };
         if (!options.platform || !validPlatforms.includes(options.platform)) {
             spinner.stop();
-            const answers = await inquirer.prompt([
+            // 先选择平台
+            const platformAnswer = await inquirer.prompt([
                 {
                     type: 'list',
                     name: 'platform',
                     message: '选择目标平台:',
                     choices: validPlatforms,
                 },
-                {
-                    type: 'list',
-                    name: 'format',
-                    message: (answers) => answers.platform === 'facebook' ? '选择输出格式（Facebook 支持两种格式）:' : '选择输出格式:',
-                    choices: (answers) => answers.platform === 'facebook'
-                        ? [
-                            { name: 'HTML（单文件，最大 5MB，所有资源内联）', value: 'html' },
-                            { name: 'ZIP（多文件，最大 5MB，HTML 文件需 < 2MB）', value: 'zip' },
-                        ]
-                        : [
-                            { name: 'HTML（单文件）', value: 'html' },
-                            { name: 'ZIP（多文件）', value: 'zip' },
-                        ],
-                    default: 'html',
-                },
+            ]);
+            const selectedPlatform = platformAnswer.platform;
+            const formatConfig = getPlatformFormats(selectedPlatform);
+            // 根据平台支持的格式决定是否需要选择
+            let selectedFormat;
+            if (formatConfig.formats.length === 1) {
+                // 只支持一种格式，直接使用
+                selectedFormat = formatConfig.formats[0];
+                const formatName = selectedFormat === 'html' ? 'HTML（单文件）' : 'ZIP（多文件）';
+                console.log(pc.dim(`ℹ️  ${selectedPlatform} 渠道仅支持 ${formatName} 格式`));
+            }
+            else {
+                // 支持多种格式，让用户选择
+                const formatAnswer = await inquirer.prompt([
+                    {
+                        type: 'list',
+                        name: 'format',
+                        message: formatConfig.description
+                            ? `选择输出格式（${formatConfig.description}）:`
+                            : '选择输出格式:',
+                        choices: formatConfig.formats.map(f => ({
+                            name: f === 'html'
+                                ? (selectedPlatform === 'facebook'
+                                    ? 'HTML（单文件，最大 5MB，所有资源内联）'
+                                    : 'HTML（单文件）')
+                                : (selectedPlatform === 'facebook'
+                                    ? 'ZIP（多文件，最大 5MB，HTML 文件需 < 2MB）'
+                                    : 'ZIP（多文件）'),
+                            value: f,
+                        })),
+                        default: formatConfig.default,
+                    },
+                ]);
+                selectedFormat = formatAnswer.format;
+            }
+            // 选择输出目录
+            const outputAnswer = await inquirer.prompt([
                 {
                     type: 'input',
                     name: 'output',
@@ -360,11 +434,24 @@ export async function buildCommand(projectPath, options) {
                     default: options.output || './dist',
                 },
             ]);
-            options.platform = answers.platform;
-            options.format = answers.format;
-            options.output = answers.output;
+            options.platform = selectedPlatform;
+            options.format = selectedFormat;
+            options.output = outputAnswer.output;
             spinner.start(pc.cyan('🔨 开始打包 Playable Ad...'));
         }
+        else {
+            // 命令行已指定平台，检查格式是否符合要求
+            const formatConfig = getPlatformFormats(options.platform);
+            if (options.format && !formatConfig.formats.includes(options.format)) {
+                const supportedFormats = formatConfig.formats.join(' 或 ');
+                console.log(pc.yellow(`\n⚠️  ${options.platform} 渠道仅支持 ${supportedFormats} 格式，已自动切换为 ${formatConfig.default}`));
+                options.format = formatConfig.default;
+            }
+            else if (!options.format) {
+                // 未指定格式，使用默认值
+                options.format = formatConfig.default;
+            }
+        }
         // 解析配置
         const buildOptions = {
             platform: options.platform,
@@ -385,18 +472,44 @@ export async function buildCommand(projectPath, options) {
             modelCompression: options.modelCompression,
             // 场景选择
             selectedScenes,
+            // ESM 选项
+            ...(options.esmMode ? { esmMode: options.esmMode } : {}),
         };
         if (fileConfig) {
             Object.assign(buildOptions, fileConfig);
         }
-        // 1. 检测输入类型
+        // 1. 先检测输入类型（在清理目录之前！）
         spinner.text = pc.cyan('检测项目类型...');
         const isBaseBuild = await detectBaseBuild(resolvedProjectPath);
+        // 2. 验证 playable-only 模式的前置条件
+        if (shouldRunPlayableOnly && !isBaseBuild) {
+            // 检查是否是原始 PlayCanvas 编辑器项目
+            const isEditorProject = await fs.access(path.join(resolvedProjectPath, 'scenes.json')).then(() => true).catch(() => false);
+            if (isEditorProject) {
+                throw new Error('检测到这是 PlayCanvas 编辑器项目，不是多文件构建产物。\n\n' +
+                    '请使用以下命令之一：\n' +
+                    '  1. playcraft build <项目路径>          # 完整构建（推荐）\n' +
+                    '  2. playcraft build-base <项目路径>     # 先生成多文件产物\n' +
+                    '     playcraft build-playable <产物路径> # 再转换为 Playable\n\n' +
+                    '💡 提示: build-playable 命令仅用于已有的多文件构建产物');
+            }
+            throw new Error('当前目录不是多文件构建产物，请先运行完整构建或使用 build-base 生成。');
+        }
+        // 3. 验证通过后，显示清理/覆盖模式提示（实际清理由 ViteBuilder 内部处理）
+        const playableOutputDir = buildOptions.outputDir || path.resolve(options.output || './dist');
+        // 安全检查：防止输出目录与输入目录相同时被清理
+        const isSameAsInput = path.resolve(playableOutputDir) === path.resolve(resolvedProjectPath);
+        if (shouldClean && isSameAsInput) {
+            console.log(pc.yellow(`\n⚠️  输出目录与输入目录相同，跳过清理以保护源文件`));
+        }
+        else if (!shouldClean) {
+            console.log(pc.dim(`\nℹ️  使用覆盖模式，新文件将覆盖旧文件（使用 --clean 可清理旧目录）`));
+        }
+        // 注意：ViteBuilder 内部会通过 emptyOutDir: true 自动清空输出目录
+        // 4. 确定 baseBuildDir
         let baseBuildDir;
         if (shouldRunPlayableOnly) {
-            if (!isBaseBuild) {
-                throw new Error('当前目录不是多文件构建产物，请先运行完整构建或使用 build-base 生成。');
-            }
+            // 已经在上面验证过 isBaseBuild === true
             spinner.text = pc.cyan('✅ 使用多文件构建产物，直接执行阶段2');
             baseBuildDir = resolvedProjectPath;
         }
@@ -408,7 +521,8 @@ export async function buildCommand(projectPath, options) {
         else {
             // 输入是源代码或官方构建，先执行阶段1
             spinner.text = pc.cyan('执行阶段1: 基础构建...');
-            const tempDir = path.join(os.tmpdir(), `playcraft-base-build-${Date.now()}`);
+            // 将临时目录放在项目所在目录下，避免跨盘符路径问题（Windows 上 C:\Temp 和 D:\project 会导致 Vite 路径计算错误）
+            const tempDir = path.join(resolvedProjectPath, '.playcraft-temp', `base-build-${Date.now()}`);
             const baseBuilder = new BaseBuilder(resolvedProjectPath, {
                 outputDir: tempDir,
                 selectedScenes,
@@ -506,16 +620,20 @@ export async function buildCommand(projectPath, options) {
             const finalReportPath = buildOptions.analyzeReportPath
                 ? buildOptions.analyzeReportPath
                 : path.join(buildOptions.outputDir || './dist', 'bundle-report.html');
+            let reportExists = false;
             try {
                 await fs.access(baseReportPath);
                 await fs.copyFile(baseReportPath, finalReportPath);
+                reportExists = true;
             }
-            catch (error) {
-                console.warn(pc.yellow('  ⚠️ 无法找到或复制分析报告'));
+            catch {
+                // 报告文件不存在（例如从官方构建产物直接复制时），这是正常的
             }
             const analysis = await analyzeBaseBuild(baseBuildDir, buildOptions.ammoReplacement);
             console.log('\n' + pc.bold('分析报告:'));
-            console.log(`  - 可视化报告: ${finalReportPath}`);
+            if (reportExists) {
+                console.log(`  - 可视化报告: ${finalReportPath}`);
+            }
             if (analysis.engineSize > 0) {
                 const engineMB = (analysis.engineSize / 1024 / 1024).toFixed(2);
                 console.log(`  - 引擎大小: ${engineMB} MB`);
@@ -536,14 +654,17 @@ export async function buildCommand(projectPath, options) {
                 console.log(pc.yellow(`  - 检测到 Ammo.js，建议替换为 ${analysis.suggestedEngine}`));
             }
         }
-        // 清理临时目录
-        if (!isBaseBuild && baseBuildDir.startsWith(os.tmpdir())) {
-            try {
-                await fs.rm(baseBuildDir, { recursive: true, force: true });
-            }
-            catch (error) {
-                // 忽略清理错误
-            }
+        // 清理临时目录（调试时注释掉）
+        if (!isBaseBuild && baseBuildDir.includes('.playcraft-temp')) {
+            // 调试：暂时保留临时目录
+            console.log(pc.yellow(`[DEBUG] 临时目录保留在: ${baseBuildDir}`));
+            // try {
+            //   // 清理整个 .playcraft-temp 目录
+            //   const tempBaseDir = path.join(resolvedProjectPath, '.playcraft-temp');
+            //   await fs.rm(tempBaseDir, { recursive: true, force: true });
+            // } catch (error) {
+            //   // 忽略清理错误
+            // }
         }
     }
     catch (error) {

package/dist/commands/fix-ids.js

@@ -0,0 +1,43 @@
+/**
+ * fix-ids 命令：修复已导入项目的 ID 映射（将 Sandbox 中的 PlayCanvas ID 转换为 PlayCraft numericId）
+ */
+import pc from 'picocolors';
+export async function fixIdsCommand(options) {
+    const { projectId, apiUrl, token } = options;
+    const baseUrl = (apiUrl || process.env.BACKEND_API_URL || process.env.PLAYCRAFT_URL || 'http://localhost:3001').replace(/\/+$/, '');
+    const url = `${baseUrl}/api/projects/${encodeURIComponent(projectId)}/fix-ids`;
+    const headers = {
+        'Content-Type': 'application/json',
+    };
+    if (token || process.env.PLAYCRAFT_TOKEN) {
+        headers['Authorization'] = `Bearer ${token || process.env.PLAYCRAFT_TOKEN}`;
+    }
+    if (process.env.NEXT_PUBLIC_LOCAL_AUTH_BYPASS === 'true' && process.env.NEXT_PUBLIC_LOCAL_USER) {
+        headers['X-Local-User'] = process.env.NEXT_PUBLIC_LOCAL_USER;
+    }
+    console.log(pc.dim(`Fixing ID mapping for project ${projectId}...`));
+    console.log(pc.dim(`POST ${url}`));
+    try {
+        const res = await fetch(url, {
+            method: 'POST',
+            headers,
+        });
+        const body = await res.json().catch(() => ({}));
+        if (!res.ok) {
+            const msg = body.message || res.statusText || String(res.status);
+            console.error(pc.red(`Failed to fix ID mapping: ${msg}`));
+            process.exit(1);
+        }
+        if (body.success !== true) {
+            console.error(pc.red('Unexpected response from server'));
+            process.exit(1);
+        }
+        console.log(pc.green('ID mapping fixed successfully'));
+        console.log(pc.dim('Please reload the editor to see changes.'));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(pc.red(`Request failed: ${message}`));
+        process.exit(1);
+    }
+}

package/dist/commands/start.js

@@ -4,15 +4,10 @@ import { fileURLToPath } from 'url';
 import { loadConfig } from '../config.js';
 import { ProcessManager } from '../process-manager.js';
 import { isPortAvailable, findAvailablePort } from '../port-utils.js';
-import { Logger } from '../logger.js';
-import { createServer } from '../server.js';
-import { SocketServer } from '../socket.js';
-import { Watcher } from '../watcher.js';
-import { FSHandler } from '../fs-handler.js';
-import http from 'http';
 import pc from 'picocolors';
 import ora from 'ora';
 import inquirer from 'inquirer';
+import { PlayCraftAgent } from '../agent/agent.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 export async function startCommand(options) {
@@ -23,6 +18,7 @@ export async function startCommand(options) {
             token: options.token,
             dir: options.dir,
             port: options.port ? parseInt(options.port) : undefined,
+            mode: options.mode || undefined,
         });
         if (!config.projectId) {
             spinner.fail('项目 ID 未设置');
@@ -101,6 +97,7 @@ async function startDaemon(config) {
             PLAYCRAFT_PORT: config.port.toString(),
             PLAYCRAFT_DIR: config.dir,
             PLAYCRAFT_DAEMON: 'true',
+            PLAYCRAFT_MODE: config.mode || 'full-local',
         },
     });
     child.unref();
@@ -126,76 +123,11 @@ async function startDaemon(config) {
     }
 }
 async function startForeground(config) {
-    const logger = new Logger(config.projectId || 'default', false);
-    await logger.initialize();
-    console.log(pc.cyan(`\n🚀 PlayCraft Agent 启动中...\n`));
-    console.log(`${pc.bold('项目 ID:')} ${config.projectId || pc.yellow('未设置')}`);
-    console.log(`${pc.bold('目录:')}  ${config.dir}`);
-    console.log(`${pc.bold('端口:')}  ${config.port}\n`);
-    const fsHandler = new FSHandler(config);
-    const app = createServer(config, fsHandler);
-    const server = http.createServer(app);
-    // Connection status indicator
-    let lastConnectionCount = 0;
-    const socketServer = new SocketServer(server, config, async (count) => {
-        if (count > lastConnectionCount) {
-            const message = `✅ 编辑器已连接 (共 ${count} 个连接)`;
-            await logger.info(message);
-            console.log(pc.green(message));
-        }
-        else if (count < lastConnectionCount) {
-            const message = count === 0
-                ? '⚠️  编辑器已断开连接，等待重新连接...'
-                : `⚠️  连接数减少 (剩余 ${count} 个连接)`;
-            await logger.info(message);
-            console.log(pc.yellow(message));
-        }
-        lastConnectionCount = count;
-    });
-    const watcher = new Watcher(config, async (filePath, type) => {
-        const message = `[${type.toUpperCase()}] ${filePath}`;
-        await logger.info(message);
-        socketServer.notifyFileChange(filePath, type);
-    });
-    server.listen(config.port, async () => {
-        await logger.info(`Local server running at http://localhost:${config.port}`);
-        console.log(pc.green(`✅ 本地服务运行在 http://localhost:${config.port}`));
-        console.log(pc.dim('等待编辑器连接...\n'));
-    });
-    // 优雅关闭
+    const agent = new PlayCraftAgent(config, false);
+    await agent.start();
     const shutdown = async () => {
-        console.log(pc.yellow('\n正在关闭 agent...'));
-        // Set a timeout to force exit if graceful shutdown fails
-        const forceExitTimeout = setTimeout(() => {
-            console.log(pc.red('强制退出...'));
-            process.exit(1);
-        }, 3000); // 3 seconds timeout
-        try {
-            // Close watcher
-            await watcher.close();
-            // Close WebSocket connections
-            socketServer.destroy();
-            // Close HTTP server
-            await new Promise((resolve) => {
-                server.close(() => {
-                    resolve();
-                });
-                // Force close if it takes too long
-                setTimeout(() => {
-                    resolve();
-                }, 1000);
-            });
-            // Close logger
-            await logger.close();
-            clearTimeout(forceExitTimeout);
-            console.log(pc.green('✅ Agent 已关闭'));
-            process.exit(0);
-        }
-        catch (error) {
-            clearTimeout(forceExitTimeout);
-            console.error(pc.red('关闭时出错:'), error);
-            process.exit(1);
-        }
+        await agent.stop();
+        process.exit(0);
     };
     process.on('SIGINT', shutdown);
     process.on('SIGTERM', shutdown);
@@ -207,6 +139,7 @@ export async function startInternal() {
     const port = parseInt(process.env.PLAYCRAFT_PORT || '2468');
     const dir = process.env.PLAYCRAFT_DIR || process.cwd();
     const isDaemon = process.env.PLAYCRAFT_DAEMON === 'true';
+    const mode = process.env.PLAYCRAFT_MODE || 'full-local';
     if (!projectId) {
         console.error('PLAYCRAFT_PROJECT_ID 环境变量未设置');
         process.exit(1);
@@ -216,68 +149,20 @@ export async function startInternal() {
         token,
         dir,
         port,
+        mode,
     };
-    const logger = new Logger(config.projectId || 'default', isDaemon);
-    await logger.initialize();
-    await logger.info(`Starting PlayCraft Agent for project: ${config.projectId || 'default'}`);
-    await logger.info(`Directory: ${config.dir}`);
-    await logger.info(`Port: ${config.port}`);
-    const fsHandler = new FSHandler(config);
-    const app = createServer(config, fsHandler);
-    const server = http.createServer(app);
-    // Connection status tracking for daemon mode
-    let lastConnectionCount = 0;
-    const socketServer = new SocketServer(server, config, async (count) => {
-        if (count > lastConnectionCount) {
-            await logger.info(`Editor connected (${count} connection(s))`);
-        }
-        else if (count < lastConnectionCount) {
-            await logger.info(count === 0 ? 'Editor disconnected' : `Connection decreased (${count} remaining)`);
-        }
-        lastConnectionCount = count;
-    });
-    const watcher = new Watcher(config, async (filePath, type) => {
-        await logger.info(`[${type.toUpperCase()}] ${filePath}`);
-        socketServer.notifyFileChange(filePath, type);
-    });
-    server.listen(config.port, async () => {
-        await logger.info(`Local server running at http://localhost:${config.port}`);
-    });
+    const agent = new PlayCraftAgent(config, isDaemon);
+    await agent.start();
     // 保存 PID
     await ProcessManager.savePid(config.projectId || 'default', process.pid);
-    // 优雅关闭
     const shutdown = async () => {
-        await logger.info('Shutting down agent...');
-        // Set a timeout to force exit
-        const forceExitTimeout = setTimeout(() => {
-            process.exit(1);
-        }, 3000);
         try {
-            // Close watcher
-            await watcher.close();
-            // Close WebSocket connections
-            socketServer.destroy();
-            // Close HTTP server
-            await new Promise((resolve) => {
-                server.close(() => {
-                    resolve();
-                });
-                setTimeout(() => {
-                    resolve();
-                }, 1000);
-            });
-            // Remove PID file
+            await agent.stop();
+        }
+        finally {
             await ProcessManager.removePid(config.projectId || 'default');
-            // Close logger
-            await logger.close();
-            clearTimeout(forceExitTimeout);
             process.exit(0);
         }
-        catch (error) {
-            clearTimeout(forceExitTimeout);
-            await logger.error(`Error during shutdown: ${error}`);
-            process.exit(1);
-        }
     };
     process.on('SIGINT', shutdown);
     process.on('SIGTERM', shutdown);

package/dist/commands/sync.js

@@ -0,0 +1,40 @@
+import { loadConfig } from '../config.js';
+import { createSyncEngineFromConfig } from '../sync/sync-engine.js';
+import pc from 'picocolors';
+export async function syncCommand(action, options) {
+    const config = await loadConfig({});
+    if (config.mode !== 'hybrid') {
+        console.log(pc.yellow('Sync 命令仅在 hybrid 模式下可用'));
+        console.log(pc.dim('当前模式: ' + (config.mode || 'full-local')));
+        console.log(pc.dim('请设置 mode: "hybrid" 并配置 url 和 token'));
+        process.exit(1);
+    }
+    if (!config.url || !config.token || !config.projectId) {
+        console.error(pc.red('hybrid 模式需要配置 url、token 和 projectId'));
+        console.log(pc.dim('请在 playcraft.agent.config.json 或环境变量中设置'));
+        process.exit(1);
+    }
+    try {
+        const syncEngine = await createSyncEngineFromConfig();
+        switch (action) {
+            case 'push':
+                await syncEngine.push(options);
+                break;
+            case 'pull':
+                await syncEngine.pull(options);
+                break;
+            case 'status':
+                await syncEngine.status();
+                break;
+            default:
+                console.error(pc.red(`未知操作: ${action}`));
+                console.log(pc.yellow('可用: push, pull, status'));
+                process.exit(1);
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(pc.red(message));
+        process.exit(1);
+    }
+}

package/dist/commands/upgrade.js

@@ -0,0 +1,71 @@
+/**
+ * upgrade 命令
+ * 检查并更新 CLI 到最新版本
+ */
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import pc from 'picocolors';
+import ora from 'ora';
+import { getLatestVersion } from '../utils/version-checker.js';
+import { promptForUpdate } from '../utils/updater.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * 获取 package.json
+ */
+function getPackageJson() {
+    return JSON.parse(readFileSync(join(__dirname, '..', '..', 'package.json'), 'utf-8'));
+}
+/**
+ * upgrade 命令处理函数
+ * @param options 命令选项
+ */
+export async function upgradeCommand(options) {
+    const packageJson = getPackageJson();
+    const currentVersion = packageJson.version;
+    console.log(pc.bold('\n📦 PlayCraft CLI 版本检查\n'));
+    console.log(`当前版本: ${pc.cyan(currentVersion)}`);
+    try {
+        const spinner = ora('正在检查最新版本...').start();
+        const latestVersion = await getLatestVersion(packageJson);
+        spinner.stop();
+        console.log(`最新版本: ${pc.green(latestVersion)}`);
+        if (currentVersion === latestVersion) {
+            console.log(pc.green('\n✓ 已是最新版本！\n'));
+            return;
+        }
+        // 比较版本号
+        const [currentMajor, currentMinor, currentPatch] = currentVersion.split('.').map(Number);
+        const [latestMajor, latestMinor, latestPatch] = latestVersion.split('.').map(Number);
+        let updateType = 'patch';
+        if (latestMajor > currentMajor) {
+            updateType = 'major';
+        }
+        else if (latestMinor > currentMinor) {
+            updateType = 'minor';
+        }
+        const typeLabels = {
+            major: '主版本',
+            minor: '次版本',
+            patch: '补丁版本',
+        };
+        console.log(pc.yellow(`\n⚠ 有新版本可用 (${typeLabels[updateType]}更新)\n`));
+        if (options.checkOnly) {
+            console.log(pc.yellow(`运行 ${pc.bold('playcraft upgrade')} 来更新到最新版本\n`));
+            return;
+        }
+        // 触发交互式更新
+        await promptForUpdate({
+            latest: latestVersion,
+            current: currentVersion,
+            type: updateType,
+            name: packageJson.name,
+        }, currentVersion);
+    }
+    catch (error) {
+        console.error(pc.red(`\n✗ 检查版本失败: ${error instanceof Error ? error.message : String(error)}\n`));
+        console.error(pc.gray('提示: 请检查网络连接或稍后重试\n'));
+        process.exit(1);
+    }
+}