@playcraft/cli 0.0.40 → 0.0.42

package/dist/commands/tools.js

@@ -1,620 +1,11 @@
-import { writeFileSync, mkdirSync, readFileSync } from 'fs';
-import { dirname, join, parse } from 'path';
-import { tmpdir } from 'os';
-import { AgentApiClient } from '../utils/agent-api-client.js';
-const TMP_DIR = join(tmpdir(), 'playcraft');
-const MAX_REFERENCE_IMAGES = 8;
-function ensureTmpDir() {
-    mkdirSync(TMP_DIR, { recursive: true });
-}
-function tmpPath(prefix) {
-    return join(TMP_DIR, `${prefix}-${Date.now()}.json`);
-}
-function writeResult(prefix, data) {
-    ensureTmpDir();
-    const path = tmpPath(prefix);
-    writeFileSync(path, JSON.stringify(data, null, 2));
-    return path;
-}
-function handleError(err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    console.error(`Error: ${msg}`);
-    process.exit(1);
-}
-/** Fallback extension from API mime when magic-byte sniff fails. */
-function extensionForImageMime(mimeType) {
-    const base = mimeType.toLowerCase().split(';')[0]?.trim() ?? '';
-    switch (base) {
-        case 'image/png':
-            return '.png';
-        case 'image/jpeg':
-        case 'image/jpg':
-            return '.jpg';
-        case 'image/webp':
-            return '.webp';
-        case 'image/gif':
-            return '.gif';
-        case 'image/bmp':
-            return '.bmp';
-        default:
-            return '.png';
-    }
-}
-/**
- * Detect container from decoded bytes (magic). Prefer this over MIME alone.
- */
-function sniffImageExtension(buf) {
-    // PNG (8-byte signature)
-    if (buf.length >= 8 &&
-        buf[0] === 0x89 &&
-        buf[1] === 0x50 &&
-        buf[2] === 0x4e &&
-        buf[3] === 0x47) {
-        return '.png';
-    }
-    // JPEG (SOI marker)
-    if (buf.length >= 3 && buf[0] === 0xff && buf[1] === 0xd8 && buf[2] === 0xff) {
-        return '.jpg';
-    }
-    // GIF87a / GIF89a
-    if (buf.length >= 6 &&
-        buf[0] === 0x47 &&
-        buf[1] === 0x49 &&
-        buf[2] === 0x46 &&
-        buf[3] === 0x38 &&
-        (buf[4] === 0x37 || buf[4] === 0x39) &&
-        buf[5] === 0x61) {
-        return '.gif';
-    }
-    // WebP: RIFF .... WEBP
-    if (buf.length >= 12 &&
-        buf[0] === 0x52 &&
-        buf[1] === 0x49 &&
-        buf[2] === 0x46 &&
-        buf[3] === 0x46 &&
-        buf[8] === 0x57 &&
-        buf[9] === 0x45 &&
-        buf[10] === 0x42 &&
-        buf[11] === 0x50) {
-        return '.webp';
-    }
-    // BMP
-    if (buf.length >= 2 && buf[0] === 0x42 && buf[1] === 0x4d) {
-        return '.bmp';
-    }
-    return null;
-}
-/** Replace output extension when it does not match the chosen format extension. */
-function resolveImageOutputPath(outputPath, wantExt) {
-    try {
-        const { dir, name, ext } = parse(outputPath);
-        if (ext.toLowerCase() === wantExt) {
-            return outputPath;
-        }
-        return join(dir, `${name}${wantExt}`);
-    }
-    catch (e) {
-        const detail = e instanceof Error ? e.message : String(e);
-        console.warn(`Could not adjust output path for extension ${wantExt} (${detail}); using path as given: ${outputPath}`);
-        return outputPath;
-    }
-}
-function collectReferenceImagePaths(value, previous) {
-    return previous.concat([value]);
-}
-function mimeTypeForImagePath(filePath) {
-    const ext = filePath.split('.').pop()?.toLowerCase();
-    if (ext === 'png')
-        return 'image/png';
-    if (ext === 'webp')
-        return 'image/webp';
-    if (ext === 'jpg' || ext === 'jpeg')
-        return 'image/jpeg';
-    if (ext === undefined || ext === '') {
-        throw new Error(`Reference image path has no file extension: ${filePath}. Use .png, .webp, .jpg, or .jpeg.`);
-    }
-    throw new Error(`Unsupported reference image extension ".${ext}" in ${filePath}. Only png, webp, jpg, and jpeg are allowed.`);
-}
-/** Load reference images for generate-image; skip unreadable paths after console.warn (same tolerance as output path resolve). */
-function collectReferenceImagePayloads(paths) {
-    if (paths.length === 0)
-        return undefined;
-    const out = [];
-    for (const p of paths) {
-        try {
-            const mimeType = mimeTypeForImagePath(p);
-            out.push({
-                base64: readFileSync(p).toString('base64'),
-                mimeType,
-            });
-        }
-        catch (e) {
-            const detail = e instanceof Error ? e.message : String(e);
-            const code = e && typeof e === 'object' && 'code' in e ? String(e.code) : '';
-            const hint = code ? ` (${code})` : '';
-            console.warn(`Skipping reference image (read failed): ${p}${hint}\n  ${detail}`);
-        }
-    }
-    if (paths.length > 0 && out.length === 0) {
-        console.warn('All reference images failed to load; continuing with text-only generation.');
-    }
-    return out.length > 0 ? out : undefined;
-}
+import { registerGenerationCommands } from './tools-generation.js';
+import { registerProjectCommands } from './tools-project.js';
+import { register3DCommands } from './tools-3d.js';
 export function registerToolsCommands(program) {
     const tools = program
         .command('tools')
-        .description('后端 /api/agent/tools；需 PLAYCRAFT_API_URL + PLAYCRAFT_SANDBOX_TOKEN 或 .playcraft.json');
-    // ─── Image Models ────────────────────────────────────────────
-    tools.command('list-image-models')
-        .description('列出后端已配置的可用生图模型（modelKind=image），输出可直接作为 --image-model 的值')
-        .option('--json', '以 JSON 格式输出（默认为人类可读表格）')
-        .action(async (opts) => {
-        try {
-            const client = new AgentApiClient();
-            const models = await client.get('/image-models');
-            if (!models.length) {
-                console.log('暂无已配置的生图模型。请前往 Admin > AI Settings 添加 modelKind=image 的配置。');
-                return;
-            }
-            if (opts.json) {
-                console.log(JSON.stringify(models, null, 2));
-                return;
-            }
-            // 人类可读表格
-            const defaultMark = (m) => (m.isDefault ? ' (default)' : '');
-            const maxRefLen = Math.max(...models.map((m) => m.ref.length), 'MODEL REF'.length);
-            console.log('');
-            console.log(`${'MODEL REF'.padEnd(maxRefLen)}  PROVIDER          MODEL`);
-            console.log(`${'-'.repeat(maxRefLen)}  ----------------  --------------------------------`);
-            for (const m of models) {
-                console.log(`${m.ref.padEnd(maxRefLen)}  ${m.provider.padEnd(16)}  ${m.model}${defaultMark(m)}`);
-            }
-            console.log('');
-            console.log(`使用方式：playcraft tools generate-image --prompt "..." --output out.png --image-model <MODEL REF>`);
-            console.log('');
-        }
-        catch (err) {
-            console.error('获取生图模型列表失败：', err instanceof Error ? err.message : String(err));
-            process.exit(1);
-        }
-    });
-    // ─── Generation ─────────────────────────────────────────────
-    tools.command('generate-image')
-        .description('AI 生成图片（支持多张参考图图生图）')
-        .requiredOption('--prompt <text>', '图片描述')
-        .option('--aspect-ratio <ratio>', '宽高比 (1:1|16:9|9:16|3:4|4:3)', '1:1')
-        .requiredOption('--output <path>', '保存路径')
-        .option('--image-size <size>', '图片尺寸 (1K|2K|4K)')
-        .option('--reference-image <path>', '参考图路径（可重复多次，最多 8 张），支持 PNG/JPG/WEBP', collectReferenceImagePaths, [])
-        .option('--image-model <ref>', '生图模型，格式 provider/model-id（如 iegg-litellm/gpt-image-1 或 google/gemini-2.0-flash-preview-image-generation）')
-        .action(async (opts) => {
-        try {
-            const paths = opts.referenceImage ?? [];
-            if (paths.length > MAX_REFERENCE_IMAGES) {
-                throw new Error(`Too many reference images: ${paths.length} paths given; maximum is ${MAX_REFERENCE_IMAGES}.`);
-            }
-            const referenceImages = collectReferenceImagePayloads(paths);
-            const client = new AgentApiClient();
-            const result = await client.post('/generate-image', {
-                prompt: opts.prompt,
-                aspectRatio: opts.aspectRatio,
-                imageSize: opts.imageSize,
-                referenceImages,
-                ...(opts.imageModel ? { imageModelRef: opts.imageModel } : {}),
-            });
-            const buf = Buffer.from(result.imageBase64, 'base64');
-            const sniffed = sniffImageExtension(buf);
-            const fromMime = extensionForImageMime(result.mimeType);
-            const wantExt = sniffed ?? fromMime;
-            if (!sniffed) {
-                console.warn('Could not detect image format from file signature; using Content-Type from API for extension.');
-            }
-            else if (sniffed !== fromMime) {
-                console.warn(`Image bytes look like ${sniffed.slice(1).toUpperCase()} but API reported ${result.mimeType}; ` +
-                    'extension follows file signature.');
-            }
-            const outputPath = resolveImageOutputPath(opts.output, wantExt);
-            if (outputPath !== opts.output) {
-                console.log(`Output path adjusted to ${wantExt} payload: ${outputPath}`);
-            }
-            mkdirSync(dirname(outputPath), { recursive: true });
-            writeFileSync(outputPath, buf);
-            const sizeKB = Math.round(buf.length / 1024);
-            console.log(`Image saved to ${outputPath} (${sizeKB}KB, ${wantExt.slice(1)})`);
-        }
-        catch (e) {
-            handleError(e);
-        }
-    });
-    tools.command('generate-sfx')
-        .description('AI 生成音效（SFX），使用 ElevenLabs Sound Effects')
-        .requiredOption('--prompt <text>', '音效描述，仅英文，如 "crisp UI click, short tail, no voice"')
-        .option('--duration <seconds>', '时长（秒，0.5-30）', parseFloat)
-        .option('--loop', '生成可循环的音效', false)
-        .requiredOption('--output <path>', '保存路径，如 ./assets/audio/click.mp3')
-        .action(async (opts) => {
-        try {
-            const client = new AgentApiClient();
-            const result = await client.post('/generate-sfx', {
-                prompt: opts.prompt,
-                duration: opts.duration,
-                loop: opts.loop,
-            });
-            mkdirSync(dirname(opts.output), { recursive: true });
-            const buf = Buffer.from(result.audioBase64, 'base64');
-            writeFileSync(opts.output, buf);
-            const sizeKB = Math.round(buf.length / 1024);
-            console.log(`SFX saved to ${opts.output} (${sizeKB}KB, ${result.duration.toFixed(2)}s, provider=${result.provider})`);
-        }
-        catch (e) {
-            handleError(e);
-        }
-    });
-    tools.command('generate-bgm')
-        .description('AI 生成 BGM（30s 循环），使用 Google Lyria 3')
-        .requiredOption('--prompt <text>', 'BGM 描述，如 "轻快休闲游戏配乐"')
-        .option('--style <style>', '音乐风格，如 casual / epic / sci-fi / retro')
-        .option('--bpm <bpm>', '目标 BPM', parseInt)
-        .requiredOption('--output <path>', '保存路径，如 ./assets/audio/bgm.mp3')
-        .action(async (opts) => {
-        try {
-            const client = new AgentApiClient();
-            const result = await client.post('/generate-bgm', {
-                prompt: opts.prompt,
-                style: opts.style,
-                bpm: opts.bpm,
-            });
-            mkdirSync(dirname(opts.output), { recursive: true });
-            const buf = Buffer.from(result.audioBase64, 'base64');
-            writeFileSync(opts.output, buf);
-            const sizeKB = Math.round(buf.length / 1024);
-            console.log(`BGM saved to ${opts.output} (${sizeKB}KB, ${result.duration.toFixed(2)}s, provider=${result.provider})`);
-        }
-        catch (e) {
-            handleError(e);
-        }
-    });
-    // ─── Project Pipeline ───────────────────────────────────────
-    tools.command('save-to-git')
-        .description('同步沙箱内容到 Git 仓库')
-        .requiredOption('--project-id <id>', '项目数字 ID', parseInt)
-        .requiredOption('--message <text>', '提交信息')
-        .option('--branch <name>', '分支名', 'main')
-        .action(async (opts) => {
-        try {
-            const client = new AgentApiClient();
-            const result = await client.post('/save-to-git', {
-                projectId: opts.projectId,
-                branch: opts.branch,
-                commitMessage: opts.message,
-            });
-            if (result.success) {
-                console.log(`Saved to git: commit ${result.commitHash ?? 'unknown'}`);
-            }
-            else if (result.conflict) {
-                console.log(`Conflict detected in ${result.conflictFiles?.length ?? 0} file(s)`);
-                if (result.conflictFiles?.length) {
-                    for (const f of result.conflictFiles)
-                        console.log(`  - ${f}`);
-                }
-                process.exit(1);
-            }
-            else {
-                console.error(`Error: ${result.error ?? 'Save failed'}`);
-                process.exit(1);
-            }
-        }
-        catch (e) {
-            handleError(e);
-        }
-    });
-    tools.command('build-project')
-        .description('在沙箱中执行项目构建')
-        .requiredOption('--project-id <id>', '项目数字 ID', parseInt)
-        .option('--branch <name>', '分支名', 'main')
-        .action(async (opts) => {
-        try {
-            const client = new AgentApiClient();
-            const result = await client.post('/build-project', {
-                projectId: opts.projectId,
-                branch: opts.branch,
-            });
-            if (result.success === false) {
-                if (result.output) {
-                    const logPath = writeResult('build', { output: result.output, error: result.error });
-                    console.error(`Build failed. Log: ${logPath}`);
-                }
-                else {
-                    console.error(`Error: ${result.error ?? 'Build failed'}`);
-                }
-                process.exit(1);
-            }
-            if (result.output) {
-                const logPath = writeResult('build', result);
-                console.log(`Build succeeded`);
-                console.log(`Log: ${logPath}`);
-            }
-            else {
-                console.log('Build succeeded');
-            }
-        }
-        catch (e) {
-            handleError(e);
-        }
-    });
-    tools.command('publish')
-        .description('将构建产物上传到 COS，获取预览 URL')
-        .requiredOption('--project-id <id>', '项目数字 ID', parseInt)
-        .option('--branch <name>', '分支名', 'main')
-        .action(async (opts) => {
-        try {
-            const client = new AgentApiClient();
-            const result = await client.post('/publish-to-cos', {
-                projectId: opts.projectId,
-                branch: opts.branch,
-            });
-            if (result.success === false) {
-                console.error(`Error: ${result.error ?? 'Publish failed'}`);
-                process.exit(1);
-            }
-            if (result.previewUrl) {
-                console.log(`Published: ${result.previewUrl}`);
-            }
-            else {
-                console.log('Published successfully');
-            }
-        }
-        catch (e) {
-            handleError(e);
-        }
-    });
-    tools.command('create-remix')
-        .description('基于项目创建 Remix 分支')
-        .requiredOption('--project-id <id>', '项目数字 ID')
-        .requiredOption('--name <name>', 'Remix 显示名称')
-        .option('--source-branch <name>', '源分支', 'main')
-        .option('--description <text>', '描述')
-        .action(async (opts) => {
-        try {
-            const client = new AgentApiClient();
-            const projectId = Number(opts.projectId);
-            if (!Number.isInteger(projectId) || projectId <= 0) {
-                console.error(`Error: --project-id must be a positive integer, got: ${opts.projectId}`);
-                process.exit(1);
-            }
-            const result = await client.post('/create-remix', {
-                projectId,
-                sourceBranch: opts.sourceBranch,
-                name: opts.name,
-                description: opts.description,
-            });
-            if (result.success === false) {
-                console.error(`Error: ${result.error ?? 'Create remix failed'}`);
-                process.exit(1);
-            }
-            console.log(`Remix created: ${opts.name} (project ${result.projectId}, branch ${result.branchName})`);
-            if (result.editorUrl)
-                console.log(`Editor: ${result.editorUrl}`);
-        }
-        catch (e) {
-            handleError(e);
-        }
-    });
-    // ─── Queries ────────────────────────────────────────────────
-    tools.command('list-templates')
-        .description('列出可用项目模板')
-        .option('--tag <filter>', '按标签过滤')
-        .action(async (opts) => {
-        try {
-            const client = new AgentApiClient();
-            const params = {};
-            if (opts.tag)
-                params.tagFilter = opts.tag;
-            const result = await client.get('/list-templates', params);
-            const detailsPath = writeResult('list-templates', result);
-            if (opts.tag) {
-                console.log(`Found ${result.templateCount} templates matching "${opts.tag}" (${result.totalCount} total)`);
-            }
-            else {
-                console.log(`Found ${result.templateCount} templates`);
-            }
-            console.log(`Details: ${detailsPath}`);
-        }
-        catch (e) {
-            handleError(e);
-        }
-    });
-    tools.command('list-assets')
-        .description('列出项目资产')
-        .requiredOption('--project-id <id>', '项目数字 ID')
-        .option('--branch <name>', '分支名')
-        .option('--types <list>', '资产类型，逗号分隔（texture,script,audio,model...）')
-        .option('--search <keyword>', '名称搜索')
-        .option('--limit <n>', '最大数量', '30')
-        .option('--skip <n>', '偏移', '0')
-        .action(async (opts) => {
-        try {
-            const client = new AgentApiClient();
-            const params = { projectId: opts.projectId };
-            if (opts.branch)
-                params.branch = opts.branch;
-            if (opts.types)
-                params.types = opts.types;
-            if (opts.search)
-                params.search = opts.search;
-            if (opts.limit)
-                params.limit = opts.limit;
-            if (opts.skip)
-                params.skip = opts.skip;
-            const result = await client.get('/list-project-assets', params);
-            const detailsPath = writeResult('list-assets', result);
-            const typeSummary = Object.entries(result.byTypeCount)
-                .map(([k, v]) => `${k}: ${v}`)
-                .join(', ');
-            console.log(`Found ${result.total} assets (${typeSummary})`);
-            console.log(`Details: ${detailsPath}`);
-        }
-        catch (e) {
-            handleError(e);
-        }
-    });
-    tools.command('list-remixes')
-        .description('列出可访问的 Remix 项目')
-        .option('--scope <scope>', 'my 或 gallery', 'my')
-        .option('--search <keyword>', '搜索')
-        .option('--limit <n>', '最大数量', '20')
-        .option('--page <n>', '页码', '1')
-        .action(async (opts) => {
-        try {
-            const client = new AgentApiClient();
-            const params = {};
-            if (opts.scope)
-                params.scope = opts.scope;
-            if (opts.search)
-                params.search = opts.search;
-            if (opts.limit)
-                params.limit = opts.limit;
-            if (opts.page)
-                params.page = opts.page;
-            const result = await client.get('/list-remixes', params);
-            const detailsPath = writeResult('list-remixes', result);
-            console.log(`Found ${result.total} remixes (page ${result.page}/${result.totalPages})`);
-            console.log(`Details: ${detailsPath}`);
-        }
-        catch (e) {
-            handleError(e);
-        }
-    });
-    // ─── Publish ────────────────────────────────────────────────
-    tools.command('publish-prefab')
-        .description('发布 Remixable Prefab 到资产库')
-        .requiredOption('--remix-project-id <id>', 'Remix 项目 ID', parseInt)
-        .requiredOption('--template <name>', '模板名')
-        .requiredOption('--variant <name>', '变体名')
-        .requiredOption('--prefab <name>', '预制件名')
-        .requiredOption('--staging-root <path>', 'Staging 目录路径')
-        .option('--visibility <v>', 'public 或 team', 'team')
-        .option('--team-id <id>', '团队 ID')
-        .action(async (opts) => {
-        try {
-            const client = new AgentApiClient();
-            const result = await client.post('/publish-prefab', {
-                remixProjectId: opts.remixProjectId,
-                templateName: opts.template,
-                variantName: opts.variant,
-                prefabName: opts.prefab,
-                stagingRoot: opts.stagingRoot,
-                visibility: opts.visibility,
-                teamId: opts.teamId,
-            });
-            if (result.success === false) {
-                console.error(`Error: ${result.error ?? 'Publish prefab failed'}`);
-                process.exit(1);
-            }
-            console.log(`Prefab published: ${result.bundlePath} (${result.uploaded} files)`);
-        }
-        catch (e) {
-            handleError(e);
-        }
-    });
-    // ─── Builds ─────────────────────────────────────────────────
-    tools.command('list-builds')
-        .description('查看云端构建列表')
-        .option('--project-id <id>', '项目数字 ID（不填则查看当前用户所有项目）')
-        .option('--branch <name>', '按分支过滤')
-        .option('--status <status>', '按状态过滤 (queued|running|success|failed)')
-        .option('--platform <platform>', '按平台过滤 (facebook|snapchat|playcraft...)')
-        .option('--search <keyword>', '按名称/提交信息搜索')
-        .option('--limit <n>', '最大数量', '20')
-        .option('--skip <n>', '偏移', '0')
-        .action(async (opts) => {
-        try {
-            const client = new AgentApiClient();
-            const params = {};
-            if (opts.projectId)
-                params.projectId = opts.projectId;
-            if (opts.branch)
-                params.branchName = opts.branch;
-            if (opts.status)
-                params.status = opts.status;
-            if (opts.platform)
-                params.platform = opts.platform;
-            if (opts.search)
-                params.search = opts.search;
-            if (opts.limit)
-                params.limit = opts.limit;
-            if (opts.skip)
-                params.skip = opts.skip;
-            const result = await client.get('/list-builds', params);
-            const detailsPath = writeResult('list-builds', result);
-            const statusCounts = {};
-            for (const item of result.items) {
-                statusCounts[item.status] = (statusCounts[item.status] ?? 0) + 1;
-            }
-            const statusSummary = Object.entries(statusCounts).map(([s, n]) => `${s}: ${n}`).join(', ');
-            console.log(`Found ${result.total} builds (${statusSummary || 'none'})`);
-            console.log(`Details: ${detailsPath}`);
-        }
-        catch (e) {
-            handleError(e);
-        }
-    });
-    tools.command('get-build')
-        .description('查看单次构建详情（状态、产物、校验结果等）')
-        .requiredOption('--id <buildId>', '构建 ID')
-        .action(async (opts) => {
-        try {
-            const client = new AgentApiClient();
-            const result = await client.get('/get-build', { id: opts.id });
-            if ('error' in result && result.error) {
-                console.error(`Error: ${result.error}`);
-                process.exit(1);
-            }
-            const detailsPath = writeResult('get-build', result);
-            const statusLine = result.status === 'running' && result.progress != null
-                ? `${result.status} (${result.progress}%)`
-                : result.status;
-            const sizeMB = result.outputSize ? `${(result.outputSize / 1024 / 1024).toFixed(2)}MB` : 'unknown size';
-            const nameLabel = result.name ? ` "${result.name}"` : '';
-            console.log(`Build ${result.id}${nameLabel}: ${statusLine} [${result.platform}/${result.format}] ${sizeMB}`);
-            if (result.error)
-                console.log(`Error: ${result.error}`);
-            if (result.downloadUrl)
-                console.log(`Download: ${result.downloadUrl}`);
-            if (result.previewUrl)
-                console.log(`Preview: ${result.previewUrl}`);
-            if (result.validationPassed === false) {
-                const errors = (result.validationWarnings ?? []).filter((w) => w.severity === 'error');
-                console.log(`Validation: FAILED (${errors.length} error(s))`);
-            }
-            else if (result.validationPassed === true) {
-                console.log(`Validation: PASSED`);
-            }
-            console.log(`Details: ${detailsPath}`);
-        }
-        catch (e) {
-            handleError(e);
-        }
-    });
-    tools.command('get-build-download')
-        .description('获取构建产物下载地址')
-        .requiredOption('--id <buildId>', '构建 ID')
-        .action(async (opts) => {
-        try {
-            const client = new AgentApiClient();
-            const result = await client.get('/get-build-download', { id: opts.id });
-            if (result.error) {
-                console.error(`Error: ${result.error}`);
-                process.exit(1);
-            }
-            console.log(`Download URL: ${result.downloadUrl}`);
-            if (result.previewUrl)
-                console.log(`Preview URL: ${result.previewUrl}`);
-            const sizeMB = result.size ? ` (${(result.size / 1024 / 1024).toFixed(2)}MB)` : '';
-            console.log(`Platform: ${result.platform}/${result.format}${sizeMB}`);
-        }
-        catch (e) {
-            handleError(e);
-        }
-    });
+        .description('后端 /api/agent/tools；运行 playcraft login 后即可直接使用，也支持 .playcraft.json 或 PLAYCRAFT_SANDBOX_TOKEN 环境变量');
+    registerGenerationCommands(tools);
+    registerProjectCommands(tools);
+    register3DCommands(tools);
 }

package/dist/config.js

@@ -11,6 +11,7 @@ export const ConfigSchema = z.object({
     port: z.number().default(2468),
     url: z.string().optional(), // Cloud API URL
     mode: z.enum(['full-local', 'hybrid']).default('full-local'),
+    skillsDir: z.string().optional(), // 本地 skills 目录，供 playcraft skills 命令使用
 });
 const explorer = cosmiconfig('playcraft', {
     searchPlaces: ['playcraft.config.json', 'playcraft.agent.config.json'],
@@ -53,6 +54,7 @@ export async function loadConfig(cliOptions) {
         token: cliOptions.token || process.env.PLAYCRAFT_TOKEN || agentConfig.token || globalConfig.token,
         port: cliOptions.port || (process.env.PLAYCRAFT_PORT ? parseInt(process.env.PLAYCRAFT_PORT) : undefined) || agentConfig.port || globalConfig.port,
         mode: cliOptions.mode || process.env.PLAYCRAFT_MODE || agentConfig.mode || globalConfig.mode,
+        skillsDir: cliOptions.skillsDir || process.env.AGENT_SKILLS_DIR || agentConfig.skillsDir || globalConfig.skillsDir,
     });
     // Resolve absolute path for dir
     config.dir = path.resolve(process.cwd(), config.dir);