@playcraft/cli 0.0.1

package/dist/commands/status.js

@@ -0,0 +1,106 @@
+import { ProcessManager } from '../process-manager.js';
+import { loadConfig } from '../config.js';
+import pc from 'picocolors';
+import ora from 'ora';
+export async function statusCommand(options) {
+    if (options.all) {
+        // 显示所有运行中的服务
+        await showAllStatus();
+    }
+    else {
+        // 显示指定项目的状态
+        await showProjectStatus(options.project);
+    }
+}
+async function showProjectStatus(projectId) {
+    const spinner = ora('检查服务状态...').start();
+    try {
+        // 如果没有指定项目，尝试从配置文件读取
+        if (!projectId) {
+            try {
+                const config = await loadConfig({});
+                projectId = config.projectId;
+            }
+            catch (error) {
+                spinner.fail('未指定项目 ID');
+                console.error(pc.red('请使用 --project 参数指定项目 ID，或使用 --all 查看所有服务'));
+                process.exit(1);
+            }
+        }
+        if (!projectId) {
+            spinner.fail('未指定项目 ID');
+            console.error(pc.red('请使用 --project 参数指定项目 ID'));
+            process.exit(1);
+        }
+        const pid = await ProcessManager.loadPid(projectId);
+        if (!pid) {
+            spinner.fail('服务未运行');
+            console.log(pc.yellow(`项目 ${projectId} 的 agent 未在运行\n`));
+            process.exit(0);
+        }
+        const isRunning = ProcessManager.isRunning(pid);
+        if (!isRunning) {
+            spinner.warn('发现无效的 PID 文件');
+            await ProcessManager.removePid(projectId);
+            console.log(pc.yellow(`项目 ${projectId} 的 agent 未在运行（已清理 PID 文件）\n`));
+            process.exit(0);
+        }
+        spinner.succeed('服务运行中');
+        // 尝试读取配置获取更多信息
+        let config;
+        try {
+            config = await loadConfig({ projectId });
+        }
+        catch (error) {
+            // 忽略配置加载错误
+        }
+        console.log(pc.cyan('\n📊 服务状态\n'));
+        console.log(`${pc.bold('项目 ID:')} ${projectId}`);
+        console.log(`${pc.bold('进程 ID:')} ${pid}`);
+        if (config) {
+            console.log(`${pc.bold('端口:')} ${config.port}`);
+            console.log(`${pc.bold('目录:')} ${config.dir}`);
+        }
+        console.log();
+    }
+    catch (error) {
+        spinner.fail('检查失败');
+        console.error(pc.red(`错误: ${error.message}`));
+        process.exit(1);
+    }
+}
+async function showAllStatus() {
+    const spinner = ora('检查所有服务状态...').start();
+    try {
+        const pids = await ProcessManager.getAllPids();
+        if (pids.length === 0) {
+            spinner.succeed('没有运行中的服务');
+            console.log(pc.yellow('没有找到运行中的 agent 服务\n'));
+            process.exit(0);
+        }
+        spinner.succeed(`找到 ${pids.length} 个运行中的服务`);
+        console.log(pc.cyan('\n📊 运行中的服务\n'));
+        for (const { projectId, pid } of pids) {
+            const isRunning = ProcessManager.isRunning(pid);
+            const status = isRunning ? pc.green('运行中') : pc.red('已停止');
+            console.log(`${pc.bold('项目:')} ${projectId}`);
+            console.log(`${pc.bold('PID:')} ${pid}`);
+            console.log(`${pc.bold('状态:')} ${status}`);
+            // 尝试读取配置
+            try {
+                const config = await loadConfig({ projectId });
+                console.log(`${pc.bold('端口:')} ${config.port}`);
+                console.log(`${pc.bold('目录:')} ${config.dir}`);
+            }
+            catch (error) {
+                // 忽略配置加载错误
+            }
+            console.log();
+        }
+    }
+    catch (error) {
+        spinner.fail('检查失败');
+        console.error(pc.red(`错误: ${error.message}`));
+        process.exit(1);
+    }
+}

package/dist/commands/stop.js

@@ -0,0 +1,58 @@
+import { ProcessManager } from '../process-manager.js';
+import { loadConfig } from '../config.js';
+import pc from 'picocolors';
+import ora from 'ora';
+export async function stopCommand(options) {
+    const spinner = ora('查找运行中的服务...').start();
+    try {
+        let projectId = options.project;
+        // 如果没有指定项目，尝试从配置文件读取
+        if (!projectId) {
+            try {
+                const config = await loadConfig({});
+                projectId = config.projectId;
+            }
+            catch (error) {
+                // 忽略配置加载错误
+            }
+        }
+        if (!projectId) {
+            spinner.fail('未指定项目 ID');
+            console.error(pc.red('请使用 --project 参数指定要停止的项目 ID'));
+            process.exit(1);
+        }
+        const pid = await ProcessManager.loadPid(projectId);
+        if (!pid) {
+            spinner.fail('未找到运行中的服务');
+            console.log(pc.yellow(`项目 ${projectId} 的 agent 未在运行`));
+            process.exit(0);
+        }
+        if (!ProcessManager.isRunning(pid)) {
+            spinner.warn('发现僵尸 PID 文件');
+            await ProcessManager.removePid(projectId);
+            console.log(pc.yellow('已清理无效的 PID 文件'));
+            process.exit(0);
+        }
+        spinner.text = `正在停止进程 ${pid}...`;
+        await ProcessManager.killProcess(pid, 'SIGTERM');
+        // 等待进程退出
+        let attempts = 0;
+        while (ProcessManager.isRunning(pid) && attempts < 10) {
+            await new Promise(resolve => setTimeout(resolve, 500));
+            attempts++;
+        }
+        if (ProcessManager.isRunning(pid)) {
+            // 强制杀死
+            spinner.warn('进程未响应，强制终止...');
+            await ProcessManager.killProcess(pid, 'SIGKILL');
+        }
+        await ProcessManager.removePid(projectId);
+        spinner.succeed('服务已停止');
+        console.log(pc.green(`✅ 项目 ${projectId} 的 agent 已停止\n`));
+    }
+    catch (error) {
+        spinner.fail('停止失败');
+        console.error(pc.red(`错误: ${error.message}`));
+        process.exit(1);
+    }
+}

package/dist/config.js

@@ -0,0 +1,31 @@
+import { cosmiconfig } from 'cosmiconfig';
+import { z } from 'zod';
+import path from 'path';
+import 'dotenv/config';
+export const ConfigSchema = z.object({
+    projectId: z.string().optional(),
+    token: z.string().optional(),
+    dir: z.string().default(process.cwd()),
+    port: z.number().default(2468),
+    url: z.string().optional(), // Cloud API URL
+});
+const explorer = cosmiconfig('playcraft', {
+    searchPlaces: ['playcraft.config.json', 'playcraft.agent.config.json'],
+});
+export async function loadConfig(cliOptions) {
+    const result = await explorer.search(cliOptions.dir || process.cwd());
+    const fileConfig = result?.config || {};
+    const agentConfig = (fileConfig && typeof fileConfig === 'object' && 'agent' in fileConfig)
+        ? (fileConfig.agent || {})
+        : fileConfig;
+    const config = ConfigSchema.parse({
+        ...agentConfig,
+        ...cliOptions,
+        projectId: cliOptions.projectId || process.env.PLAYCRAFT_PROJECT_ID || agentConfig.projectId,
+        token: cliOptions.token || process.env.PLAYCRAFT_TOKEN || agentConfig.token,
+        port: cliOptions.port || (process.env.PLAYCRAFT_PORT ? parseInt(process.env.PLAYCRAFT_PORT) : undefined) || agentConfig.port,
+    });
+    // Resolve absolute path for dir
+    config.dir = path.resolve(process.cwd(), config.dir);
+    return config;
+}

package/dist/fs-handler.js

@@ -0,0 +1,83 @@
+import fs from 'fs/promises';
+import path from 'path';
+export class FSHandler {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    isSafePath(targetPath) {
+        const resolvedPath = path.resolve(this.config.dir, targetPath);
+        return resolvedPath.startsWith(this.config.dir);
+    }
+    async readFile(relativePath) {
+        if (!this.isSafePath(relativePath)) {
+            throw new Error('Access denied: path is outside of the project directory');
+        }
+        const fullPath = path.join(this.config.dir, relativePath);
+        try {
+            const stats = await fs.stat(fullPath);
+            if (!stats.isFile()) {
+                throw new Error('Path is not a file');
+            }
+            const content = await fs.readFile(fullPath, 'utf-8');
+            return {
+                exists: true,
+                content,
+                mtime: stats.mtime,
+                size: stats.size,
+            };
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return { exists: false };
+            }
+            throw error;
+        }
+    }
+    async listDirectory(relativePath = '.') {
+        if (!this.isSafePath(relativePath)) {
+            throw new Error('Access denied: path is outside of the project directory');
+        }
+        const fullPath = path.join(this.config.dir, relativePath);
+        try {
+            const entries = await fs.readdir(fullPath, { withFileTypes: true });
+            return entries
+                .filter(entry => !entry.name.startsWith('.')) // Filter hidden files
+                .map(entry => ({
+                name: entry.name,
+                type: entry.isDirectory() ? 'directory' : 'file',
+            }));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new Error('Directory not found');
+            }
+            throw error;
+        }
+    }
+    async readBinaryFile(relativePath) {
+        if (!this.isSafePath(relativePath)) {
+            throw new Error('Access denied: path is outside of the project directory');
+        }
+        const fullPath = path.join(this.config.dir, relativePath);
+        try {
+            const stats = await fs.stat(fullPath);
+            if (!stats.isFile()) {
+                throw new Error('Path is not a file');
+            }
+            const buffer = await fs.readFile(fullPath);
+            return {
+                exists: true,
+                buffer,
+                mtime: stats.mtime,
+                size: stats.size,
+            };
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return { exists: false };
+            }
+            throw error;
+        }
+    }
+}

package/dist/index.js

@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { initCommand } from './commands/init.js';
+import { startCommand, startInternal } from './commands/start.js';
+import { stopCommand } from './commands/stop.js';
+import { statusCommand } from './commands/status.js';
+import { logsCommand } from './commands/logs.js';
+import { configCommand } from './commands/config.js';
+import { buildCommand } from './commands/build.js';
+const program = new Command();
+program
+    .name('playcraft')
+    .description('PlayCraft Local Dev Agent - 本地开发助手')
+    .version('0.0.1');
+// init 命令
+program
+    .command('init')
+    .description('交互式初始化配置文件')
+    .option('-d, --dir <path>', '配置文件目录', process.cwd())
+    .action(async (options) => {
+    await initCommand(options.dir);
+});
+// start 命令
+program
+    .command('start')
+    .description('启动本地开发 agent')
+    .option('-p, --project <id>', '项目 ID')
+    .option('-t, --token <token>', '认证令牌')
+    .option('-d, --dir <path>', '监听目录', process.cwd())
+    .option('--port <port>', '服务端口', '2468')
+    .option('--daemon', '守护进程模式（后台运行）')
+    .action(async (options) => {
+    // 检查是否是内部调用（守护进程）
+    if (process.env.PLAYCRAFT_INTERNAL === 'true') {
+        await startInternal();
+    }
+    else {
+        await startCommand(options);
+    }
+});
+// stop 命令
+program
+    .command('stop')
+    .description('停止运行中的 agent 服务')
+    .option('-p, --project <id>', '项目 ID')
+    .action(async (options) => {
+    await stopCommand(options);
+});
+// status 命令
+program
+    .command('status')
+    .description('查看服务运行状态')
+    .option('-p, --project <id>', '项目 ID')
+    .option('-a, --all', '显示所有运行中的服务')
+    .action(async (options) => {
+    await statusCommand(options);
+});
+// logs 命令
+program
+    .command('logs')
+    .description('查看服务日志')
+    .option('-p, --project <id>', '项目 ID')
+    .option('-f, --follow', '实时跟踪日志')
+    .option('-n, --lines <number>', '显示最后 N 行', '50')
+    .action(async (options) => {
+    await logsCommand(options);
+});
+// config 命令
+program
+    .command('config')
+    .description('配置管理')
+    .argument('<action>', '操作: get, set, list')
+    .option('-p, --project <id>', '项目 ID')
+    .option('-k, --key <key>', '配置键（用于 get/set）')
+    .option('-v, --value <value>', '配置值（用于 set）')
+    .action(async (action, options) => {
+    await configCommand(action, options);
+});
+// build 命令 - 完整流程（阶段1 + 阶段2）
+program
+    .command('build')
+    .description('打包项目为 Playable Ad（自动执行基础构建和渠道打包）')
+    .argument('[project-path]', '项目路径', process.cwd())
+    .option('-p, --platform <platform>', '目标平台 (facebook|snapchat|ironsource|applovin|google|tiktok|unity|liftoff|moloco|bigo)')
+    .option('-f, --format <format>', '输出格式 (html|zip)', 'html')
+    .option('-o, --output <path>', '输出目录', './dist')
+    .option('-c, --config <file>', '配置文件路径')
+    .option('--compress', '压缩引擎代码')
+    .option('--analyze', '生成打包分析报告')
+    .option('--replace-ammo', '检测到 Ammo 时自动替换为 p2 或 cannon')
+    .option('--ammo-engine <engine>', '指定替换物理引擎 (p2|cannon)')
+    .option('--auto-build', '如果是源代码项目，自动执行本地构建')
+    .option('--skip-build', '跳过本地构建，直接从源代码打包（可能不完整）')
+    .option('--mode <mode>', '构建模式 (full|base|playable)')
+    .option('--use-vite', '使用 Vite 构建（默认启用）', true)
+    .option('--no-use-vite', '禁用 Vite，使用旧构建器')
+    .option('--css-minify', '压缩 CSS（默认根据平台配置）')
+    .option('--no-css-minify', '禁用 CSS 压缩')
+    .option('--js-minify', '压缩 JS（默认根据平台配置）')
+    .option('--no-js-minify', '禁用 JS 压缩')
+    .option('--compress-images', '压缩图片（默认根据平台配置）')
+    .option('--no-compress-images', '禁用图片压缩')
+    .option('--image-quality <quality>', '图片质量 0-100（默认根据平台配置）', parseInt)
+    .option('--convert-webp', '转换为 WebP 格式（默认启用）', true)
+    .option('--no-convert-webp', '禁用 WebP 转换')
+    .option('--compress-models', '压缩 3D 模型（默认根据平台配置）')
+    .option('--no-compress-models', '禁用模型压缩')
+    .option('--model-compression <method>', '模型压缩方法 (draco|meshopt)', 'draco')
+    .action(async (projectPath, options) => {
+    await buildCommand(projectPath, options);
+});
+// build-base 命令 - 只执行阶段1：基础构建
+program
+    .command('build-base')
+    .description('生成可运行的多文件构建产物（阶段1）')
+    .argument('<project-path>', '项目路径')
+    .option('-o, --output <path>', '输出目录', './build')
+    .action(async (projectPath, options) => {
+    await buildCommand(projectPath, {
+        ...options,
+        baseOnly: true,
+        platform: 'facebook', // 占位符，不会被使用
+    });
+});
+// analyze 命令 - 生成打包分析报告
+program
+    .command('analyze')
+    .description('生成打包分析报告（可视化 + 体积建议）')
+    .argument('[project-path]', '项目路径', process.cwd())
+    .option('-p, --platform <platform>', '目标平台 (facebook|snapchat|ironsource|applovin|google|tiktok|unity|liftoff|moloco|bigo)')
+    .option('-f, --format <format>', '输出格式 (html|zip)', 'html')
+    .option('-o, --output <path>', '输出目录', './dist')
+    .option('-c, --config <file>', '配置文件路径')
+    .option('--compress', '压缩引擎代码')
+    .option('--replace-ammo', '检测到 Ammo 时自动替换为 p2 或 cannon')
+    .option('--ammo-engine <engine>', '指定替换物理引擎 (p2|cannon)')
+    .option('--mode <mode>', '构建模式 (full|base|playable)')
+    .option('--use-vite', '使用 Vite 构建（默认启用）', true)
+    .option('--no-use-vite', '禁用 Vite，使用旧构建器')
+    .option('--css-minify', '压缩 CSS（默认根据平台配置）')
+    .option('--no-css-minify', '禁用 CSS 压缩')
+    .option('--js-minify', '压缩 JS（默认根据平台配置）')
+    .option('--no-js-minify', '禁用 JS 压缩')
+    .option('--compress-images', '压缩图片（默认根据平台配置）')
+    .option('--no-compress-images', '禁用图片压缩')
+    .option('--image-quality <quality>', '图片质量 0-100（默认根据平台配置）', parseInt)
+    .option('--convert-webp', '转换为 WebP 格式（默认启用）', true)
+    .option('--no-convert-webp', '禁用 WebP 转换')
+    .option('--compress-models', '压缩 3D 模型（默认根据平台配置）')
+    .option('--no-compress-models', '禁用模型压缩')
+    .option('--model-compression <method>', '模型压缩方法 (draco|meshopt)', 'draco')
+    .action(async (projectPath, options) => {
+    await buildCommand(projectPath, {
+        ...options,
+        analyze: true,
+    });
+});
+// build-playable 命令 - 只执行阶段2：渠道打包
+program
+    .command('build-playable')
+    .description('将多文件构建产物转换为单HTML Playable Ads（阶段2）')
+    .argument('<base-build-dir>', '多文件构建产物目录')
+    .requiredOption('-p, --platform <platform>', '目标平台 (facebook|snapchat|ironsource|applovin|google|tiktok|unity|liftoff|moloco|bigo)')
+    .option('-f, --format <format>', '输出格式 (html|zip)', 'html')
+    .option('-o, --output <path>', '输出目录', './dist')
+    .option('-c, --config <file>', '配置文件路径')
+    .option('--compress', '压缩引擎代码')
+    .option('--analyze', '生成打包分析报告')
+    .option('--replace-ammo', '检测到 Ammo 时自动替换为 p2 或 cannon')
+    .option('--ammo-engine <engine>', '指定替换物理引擎 (p2|cannon)')
+    .option('--use-vite', '使用 Vite 构建（默认启用）', true)
+    .option('--no-use-vite', '禁用 Vite，使用旧构建器')
+    .option('--css-minify', '压缩 CSS（默认根据平台配置）')
+    .option('--no-css-minify', '禁用 CSS 压缩')
+    .option('--js-minify', '压缩 JS（默认根据平台配置）')
+    .option('--no-js-minify', '禁用 JS 压缩')
+    .option('--compress-images', '压缩图片（默认根据平台配置）')
+    .option('--no-compress-images', '禁用图片压缩')
+    .option('--image-quality <quality>', '图片质量 0-100（默认根据平台配置）', parseInt)
+    .option('--convert-webp', '转换为 WebP 格式（默认启用）', true)
+    .option('--no-convert-webp', '禁用 WebP 转换')
+    .option('--compress-models', '压缩 3D 模型（默认根据平台配置）')
+    .option('--no-compress-models', '禁用模型压缩')
+    .option('--model-compression <method>', '模型压缩方法 (draco|meshopt)', 'draco')
+    .action(async (baseBuildDir, options) => {
+    await buildCommand(baseBuildDir, {
+        ...options,
+        mode: 'playable',
+    });
+});
+// 新增：inspect 命令 - 检查项目类型
+program
+    .command('inspect')
+    .description('检查项目类型和结构')
+    .argument('[path]', '项目路径', process.cwd())
+    .action(async (projectPath) => {
+    const { inspectCommand } = await import('./commands/inspect.js');
+    await inspectCommand(projectPath);
+});
+program.parse(process.argv);

package/dist/logger.js

@@ -0,0 +1,122 @@
+import fs from 'fs/promises';
+import path from 'path';
+import os from 'os';
+import { createWriteStream } from 'fs';
+import pc from 'picocolors';
+const PLAYCRAFT_DIR = path.join(os.homedir(), '.playcraft');
+const LOGS_DIR = path.join(PLAYCRAFT_DIR, 'logs');
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "DEBUG";
+    LogLevel["INFO"] = "INFO";
+    LogLevel["WARN"] = "WARN";
+    LogLevel["ERROR"] = "ERROR";
+})(LogLevel || (LogLevel = {}));
+export class Logger {
+    logFile;
+    stream = null;
+    projectId;
+    isDaemon;
+    constructor(projectId, isDaemon = false) {
+        this.projectId = projectId;
+        this.isDaemon = isDaemon;
+        this.logFile = path.join(LOGS_DIR, `${projectId}.log`);
+    }
+    async ensureLogDirectory() {
+        try {
+            await fs.mkdir(LOGS_DIR, { recursive: true });
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST') {
+                throw new Error(`Failed to create log directory: ${error.message}`);
+            }
+        }
+    }
+    formatMessage(level, message) {
+        const timestamp = new Date().toISOString();
+        return `[${timestamp}] [${level}] ${message}\n`;
+    }
+    getColorFunction(level) {
+        switch (level) {
+            case LogLevel.DEBUG:
+                return pc.gray;
+            case LogLevel.INFO:
+                return pc.cyan;
+            case LogLevel.WARN:
+                return pc.yellow;
+            case LogLevel.ERROR:
+                return pc.red;
+            default:
+                return (text) => text;
+        }
+    }
+    async initialize() {
+        await this.ensureLogDirectory();
+        if (this.isDaemon) {
+            this.stream = createWriteStream(this.logFile, { flags: 'a' });
+        }
+    }
+    async write(level, message) {
+        const formatted = this.formatMessage(level, message);
+        // 写入文件（如果是守护进程模式）
+        if (this.stream) {
+            this.stream.write(formatted);
+        }
+        else {
+            // 前台模式：同时写入文件和终端
+            await fs.appendFile(this.logFile, formatted, 'utf-8');
+        }
+        // 输出到终端（如果不是守护进程模式）
+        if (!this.isDaemon) {
+            const colorFn = this.getColorFunction(level);
+            const prefix = colorFn(`[${level}]`);
+            console.log(`${prefix} ${message}`);
+        }
+    }
+    async debug(message) {
+        await this.write(LogLevel.DEBUG, message);
+    }
+    async info(message) {
+        await this.write(LogLevel.INFO, message);
+    }
+    async warn(message) {
+        await this.write(LogLevel.WARN, message);
+    }
+    async error(message) {
+        await this.write(LogLevel.ERROR, message);
+    }
+    async close() {
+        if (this.stream) {
+            return new Promise((resolve, reject) => {
+                this.stream.end(() => {
+                    this.stream = null;
+                    resolve();
+                });
+                this.stream.on('error', reject);
+            });
+        }
+    }
+    getLogFilePath() {
+        return this.logFile;
+    }
+    static async readLogFile(projectId, lines) {
+        const logFile = path.join(LOGS_DIR, `${projectId}.log`);
+        try {
+            const content = await fs.readFile(logFile, 'utf-8');
+            const allLines = content.split('\n').filter(line => line.trim());
+            if (lines && lines > 0) {
+                return allLines.slice(-lines);
+            }
+            return allLines;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
+        }
+    }
+    static getLogFilePath(projectId) {
+        return path.join(LOGS_DIR, `${projectId}.log`);
+    }
+}