@playcraft/cli 0.1.36-beta1 → 0.1.37-beta

package/dist/commands/build.js

@@ -4,6 +4,7 @@ import pc from 'picocolors';
 import ora from 'ora';
 import { BaseBuilder, ViteBuilder, PlayableBuilder, PlayableAnalyzer, EngineDetector, detectAmmoUsage } from '@playcraft/build';
 import { loadBuildConfig } from '../build-config.js';
+import { cleanupBuildTempDirectory, createBuildTempDirectory } from './build-temp.js';
 import inquirer from 'inquirer';
 /**
  * 类型守卫：检查对象是否符合 PlayableScriptsConfig 类型
@@ -250,6 +251,7 @@ export async function buildCommand(projectPath, options) {
     const spinner = ora(pc.cyan('🔨 开始打包 Playable Ad...')).start();
     // 清理选项（默认为 false，使用覆盖模式）
     const shouldClean = options.clean === true;
+    let tempBuildDir;
     try {
         // ====== 引擎 + 构建工具检测 ======
         spinner.text = pc.cyan('检测项目引擎类型...');
@@ -450,6 +452,7 @@ export async function buildCommand(projectPath, options) {
         const shouldRunPlayableOnly = options.mode === 'playable';
         // 验证平台
         const validPlatforms = [
+            'playcraft',
             'facebook',
             'snapchat',
             'ironsource',
@@ -473,6 +476,7 @@ export async function buildCommand(projectPath, options) {
         // 注：Facebook 在 Phaser（playable-scripts devkit）下的产物格式由其 devkit 输入配置决定（恒为 ZIP），
         //     平台侧不在此处做引擎判断。
         const platformFormatConfig = {
+            playcraft: { formats: ['html'], default: 'html' },
             facebook: { formats: ['html', 'zip'], default: 'html' },
             applovin: { formats: ['html'], default: 'html' },
             ironsource: { formats: ['html'], default: 'html' },
@@ -584,8 +588,11 @@ export async function buildCommand(projectPath, options) {
                     console.log(pc.dim('   无主题目录，跳过主题选择'));
                 }
             }
-            // 输入商店跳转地址（CTA）- 如果配置文件中没有则必填
-            if (!options.storeUrls) {
+            // 输入商店跳转地址（CTA）- 如果配置文件中没有则必填；通用预览（playcraft）不面向渠道，可不填
+            if (selectedPlatform === 'playcraft' && !options.storeUrls) {
+                console.log(pc.dim('\nℹ️  通用预览不需要商店地址'));
+            }
+            else if (!options.storeUrls) {
                 console.log(pc.cyan('\n🔗 商店跳转地址（CTA 按钮目标）'));
                 console.log(pc.dim('   iOS 和 Android 地址均为必填'));
                 const storeUrlAnswer = await inquirer.prompt([
@@ -636,8 +643,8 @@ export async function buildCommand(projectPath, options) {
                 // 未指定格式，使用默认值
                 options.format = formatConfig.default;
             }
-            // 如果命令行未传入 storeUrls，交互式输入（必填）
-            if (!options.storeUrls) {
+            // 如果命令行未传入 storeUrls，交互式输入（必填）；通用预览（playcraft）不面向渠道，可不填
+            if (!options.storeUrls && options.platform !== 'playcraft') {
                 spinner.stop();
                 console.log(pc.cyan('\n🔗 商店跳转地址（CTA 按钮目标）'));
                 console.log(pc.dim('   iOS 和 Android 地址均为必填'));
@@ -742,7 +749,7 @@ export async function buildCommand(projectPath, options) {
             // 输入是源代码或官方构建，先执行阶段1
             spinner.text = pc.cyan('执行阶段1: 基础构建...');
             // 将临时目录放在项目所在目录下，避免跨盘符路径问题（Windows 上 C:\Temp 和 D:\project 会导致 Vite 路径计算错误）
-            const tempDir = path.join(resolvedProjectPath, '.playcraft-temp', `base-build-${Date.now()}`);
+            tempBuildDir = await createBuildTempDirectory(resolvedProjectPath);
             // 构建 playableScriptsConfig，合并 CLI 选择的参数
             const playableScriptsConfig = buildPlayableScriptsConfig(fileConfig?.playableScripts, {
                 platform: options.platform,
@@ -750,7 +757,7 @@ export async function buildCommand(projectPath, options) {
                 selectedThemes,
             });
             const baseBuilder = new BaseBuilder(resolvedProjectPath, {
-                outputDir: tempDir,
+                outputDir: tempBuildDir,
                 selectedScenes,
                 analyze: buildOptions.analyze,
                 analyzeReportPath: buildOptions.analyze ? 'base-bundle-report.html' : undefined,
@@ -795,16 +802,7 @@ export async function buildCommand(projectPath, options) {
                 }
                 console.log('\n' + pc.green(`输出目录: ${finalOutputDir}`));
                 console.log(pc.dim('💡 产物已包含渠道适配、MRAID 注入、代码混淆和 fflate 压缩'));
-                // 清理临时目录
-                try {
-                    const tempBaseDir = path.join(resolvedProjectPath, '.playcraft-temp');
-                    await fs.rm(tempBaseDir, { recursive: true, force: true });
-                    console.log(pc.dim(`\n🗑️  已清理临时目录`));
-                }
-                catch (error) {
-                    // 记录清理错误信息
-                    console.log(pc.dim(`\n⚠️  清理临时目录失败: ${error instanceof Error ? error.message : String(error)}`));
-                }
+                await cleanupBuildTempDirectory(tempBuildDir);
                 return;
             }
             spinner.text = pc.cyan('✅ 阶段1完成，开始阶段2...');
@@ -976,18 +974,7 @@ export async function buildCommand(projectPath, options) {
                 console.log(pc.yellow(`\n⚠️  检测到 Ammo.js，建议替换为 ${analysis.suggestedEngine}`));
             }
         }
-        // 清理临时目录（调试时注释掉）
-        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) {
-            //   // 忽略清理错误
-            // }
-        }
+        await cleanupBuildTempDirectory(tempBuildDir);
     }
     catch (error) {
         spinner.fail(pc.red('打包失败'));

package/dist/commands/create.js

@@ -1,3 +1,4 @@
+import { prepareLocalSkillLifecycle } from '../project-skills/lifecycle.js';
 import { execFileSync, execSync } from 'child_process';
 import inquirer from 'inquirer';
 import fs from 'fs/promises';
@@ -6,8 +7,11 @@ import { fileURLToPath } from 'url';
 import pc from 'picocolors';
 import ora from 'ora';
 import { resolveCreateTemplate, resolveCreateTemplateDir, } from '../scaffold/templates.js';
+import { PLATFORM_SKILL_DIRS } from './platform-skills.generated.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+/** `@playcraft/skills` 包内 Platform Skill 的目录名（与 Atom Skill 的 `skills/` 区分）。 */
+const PLATFORM_SKILLS_DIRNAME = 'playcraft-skills';
 /** 生成一个本地占位 Project ID（99xxxxxx），后续可通过 playcraft config set 更新为真实 ID */
 function generateMockProjectId() {
     const suffix = Math.floor(Math.random() * 90_000_000) + 10_000_000;
@@ -849,7 +853,7 @@ function extractSkillBodyForCursor(content) {
  * @param cliCommandsDir CLI 命令所在目录（用于解析 skills 包位置）
  * @param configDir 配置目录名（如 '.claude' 或 '.codebuddy'）
  */
-async function setupPlatformSkillLinksInner(targetDir, cliCommandsDir, configDir) {
+export async function setupPlatformSkillLinksInner(targetDir, cliCommandsDir, configDir) {
     const skillsLinkDir = path.join(targetDir, configDir, 'skills');
     await fs.mkdir(skillsLinkDir, { recursive: true });
     // 以下 Skill 在项目模板中以静态目录形式存在，不创建软连接覆盖它们。
@@ -868,11 +872,12 @@ async function setupPlatformSkillLinksInner(targetDir, cliCommandsDir, configDir
         'playcraft-image-generation',
         'playcraft-audio-generation',
     ]);
-    // 尝试从 CLI 安装包的位置定位 @playcraft/skills/skills 目录
+    // Platform Skill 住在 playcraft-skills/，与 Atom Skill 的 skills/ 是两个目录。
+    // 尝试从 CLI 安装包的位置定位它（monorepo 内或与 CLI 平级安装时可解析）。
     const candidateDirs = [
-        path.resolve(cliCommandsDir, '..', '..', '..', '..', 'skills', 'skills'),
-        path.resolve(cliCommandsDir, '..', '..', '..', 'skills', 'skills'),
-        path.resolve(cliCommandsDir, '..', '..', 'skills', 'skills'),
+        path.resolve(cliCommandsDir, '..', '..', '..', '..', 'skills', PLATFORM_SKILLS_DIRNAME),
+        path.resolve(cliCommandsDir, '..', '..', '..', 'skills', PLATFORM_SKILLS_DIRNAME),
+        path.resolve(cliCommandsDir, '..', '..', 'skills', PLATFORM_SKILLS_DIRNAME),
     ];
     let resolvedSkillsDir = null;
     for (const dir of candidateDirs) {
@@ -885,18 +890,24 @@ async function setupPlatformSkillLinksInner(targetDir, cliCommandsDir, configDir
             // 继续下一个候选
         }
     }
-    // 相对路径（指向 npm install 后的 node_modules）始终创建，作为安装后激活的备用
-    const relativeSkillsBase = path.join('..', '..', 'node_modules', '@playcraft', 'skills', 'skills');
+    // 相对路径（指向 npm install 后的 node_modules）作为安装后激活的备用
+    const relativeSkillsBase = path.join('..', '..', 'node_modules', '@playcraft', 'skills', PLATFORM_SKILLS_DIRNAME);
     if (resolvedSkillsDir) {
-        // 能立即解析 → 创建指向绝对路径的软连接，当下即可使用
+        // 能立即解析 → 以真实目录为准创建绝对路径软连接，当下即可使用。
+        // 按「是否含 SKILL.md」判定而非 playcraft- 前缀：sound-effects 无前缀但同样是平台技能。
         const entries = await fs.readdir(resolvedSkillsDir, { withFileTypes: true });
         for (const entry of entries) {
-            if (!entry.name.startsWith('playcraft-') || staticSkills.has(entry.name))
+            if (!entry.isDirectory() || staticSkills.has(entry.name))
                 continue;
-            const linkPath = path.join(skillsLinkDir, entry.name);
             const targetPath = path.join(resolvedSkillsDir, entry.name);
             try {
-                await fs.symlink(targetPath, linkPath, 'dir');
+                await fs.access(path.join(targetPath, 'SKILL.md'));
+            }
+            catch {
+                continue;
+            }
+            try {
+                await fs.symlink(targetPath, path.join(skillsLinkDir, entry.name), 'dir');
             }
             catch {
                 // 已存在则跳过
@@ -904,28 +915,9 @@ async function setupPlatformSkillLinksInner(targetDir, cliCommandsDir, configDir
         }
     }
     else {
-        // 无法立即解析 → 创建指向 node_modules 的相对路径软连接，npm install 后自动激活
-        const knownPlatformTools = [
-            'playcraft-asset-management',
-            'playcraft-audio-generation',
-            'playcraft-build',
-            'playcraft-code-editor',
-            'playcraft-create-remix',
-            'playcraft-deploy',
-            'playcraft-image-generation',
-            'playcraft-image-processing',
-            'playcraft-platform-intro',
-            'playcraft-prefab',
-            'playcraft-project-management',
-            'playcraft-remix-workflow',
-            'playcraft-save',
-            'playcraft-skill-recommender',
-            'playcraft-sprite-generation',
-            'playcraft-sprite-remix',
-            'playcraft-sprite-sheet',
-            'playcraft-3d-flip-sprite',
-        ];
-        for (const name of knownPlatformTools) {
+        // 无法立即解析 → 指向 node_modules 的相对路径软连接，npm install 后自动激活。
+        // 清单由 scripts/generate-platform-skills.mjs 从真实目录生成并由 CI 校验，不要手写。
+        for (const name of PLATFORM_SKILL_DIRS) {
             if (staticSkills.has(name))
                 continue;
             const linkPath = path.join(skillsLinkDir, name);
@@ -1289,6 +1281,7 @@ export async function createCommand(projectName, options) {
                 smokeSpinner.warn(`Harness 自检跳过: ${message}`);
             }
         }
+        await prepareLocalSkillLifecycle(targetDir, 'create');
         const gitSpinner = ora(isWorktreeMode ? '提交项目分支...' : '初始化 Git 仓库...').start();
         try {
             if (isWorktreeMode) {

package/dist/commands/image.js

@@ -677,9 +677,7 @@ async function runBatchStep(cmd, args, inputPath, outputPath) {
             const meta = await sharp(inputPath).metadata();
             const targetW = scale ? Math.round((meta.width ?? 64) * scale) : w;
             const targetH = scale ? Math.round((meta.height ?? 64) * scale) : h;
-            await safeToFile(sharp(inputPath).resize(targetW, targetH, {
-                fit, background: { r: 0, g: 0, b: 0, alpha: 0 },
-            }), outputPath, inputPath);
+            await safeToFile(sharp(inputPath).resize(targetW, targetH, { fit }), outputPath, inputPath);
             break;
         }
         case 'crop': {
@@ -838,9 +836,7 @@ export function registerImageCommands(program) {
                 process.exit(1);
             }
             const fit = parseResizeFitOption(opts.fit);
-            await safeToFile(sharp(opts.input).resize(targetW, targetH, {
-                fit, background: { r: 0, g: 0, b: 0, alpha: 0 },
-            }), opts.output, opts.input);
+            await safeToFile(sharp(opts.input).resize(targetW, targetH, { fit }), opts.output, opts.input);
             const outSz = statSync(resolveSandboxPath(opts.output)).size;
             console.log(`Resized ${w}x${h} → ${targetW ?? '?'}x${targetH ?? '?'} — ${opts.output} (${sizeLabelBytes(outSz)})`);
         }

package/dist/commands/login.js

@@ -1,7 +1,8 @@
 import http from 'http';
-import { exec } from 'child_process';
+import { execFile } from 'child_process';
 import crypto from 'crypto';
-import { saveGlobalConfig, loadGlobalConfig } from '../config.js';
+import { loadGlobalConfig, normalizeEnvironmentBaseUrl, readEnvironmentProfile, saveEnvironmentProfile } from '../config.js';
+import { activateAccount } from '../auth/account-activation.js';
 /** 默认云端 Portal（Next.js `/cli-auth` 与 API 同源时的基址；可通过 --url 或 PLAYCRAFT_URL 覆盖） */
 export const DEFAULT_PLAYCRAFT_CLOUD_BASE = 'https://playcraft.aix.intlgame.com';
 const CALLBACK_PORT = 3456;
@@ -18,10 +19,11 @@ function openBrowser(url) {
     const cmd = process.platform === 'darwin'
         ? 'open'
         : process.platform === 'win32'
-            ? 'start'
+            ? 'rundll32'
             : 'xdg-open';
     try {
-        exec(`${cmd} "${url}"`, (err, _stdout, stderr) => {
+        const arguments_ = process.platform === 'win32' ? ['url.dll,FileProtocolHandler', url] : [url];
+        execFile(cmd, arguments_, (err, _stdout, stderr) => {
             if (err) {
                 console.error('Failed to open browser automatically:', err.message);
                 if (stderr?.trim()) {
@@ -44,21 +46,18 @@ function resolveLoginBaseUrl(options) {
         globalConfig.url ||
         globalConfig.backendUrl ||
         DEFAULT_PLAYCRAFT_CLOUD_BASE;
-    return raw.replace(/\/+$/, '');
+    const base = normalizeEnvironmentBaseUrl(raw);
+    if (!base)
+        throw new Error('Invalid environment address');
+    return base;
 }
 function normalizeLoginEnvironmentUrl(raw) {
-    try {
-        const url = new URL(raw);
-        url.hash = '';
-        url.search = '';
-        url.pathname = url.pathname.replace(/\/+$/, '');
-        return url.toString().replace(/\/+$/, '');
-    }
-    catch {
-        return undefined;
-    }
+    return normalizeEnvironmentBaseUrl(raw);
 }
 export function resolveExistingTokenForLoginTarget(globalConfig, backendUrl) {
+    const profile = readEnvironmentProfile(globalConfig, backendUrl);
+    if (profile)
+        return profile.token;
     const token = typeof globalConfig.token === 'string' ? globalConfig.token : undefined;
     const storedBackendUrl = typeof globalConfig.backendUrl === 'string'
         ? globalConfig.backendUrl
@@ -74,9 +73,17 @@ export function resolveExistingTokenForLoginTarget(globalConfig, backendUrl) {
         : undefined;
 }
 export function buildCliAuthUrl(options) {
-    const url = new URL('/cli-auth', options.backendUrl);
+    const base = normalizeEnvironmentBaseUrl(options.backendUrl);
+    if (!base)
+        throw new Error('Invalid environment address');
+    const url = new URL(`${base}/cli-auth`);
+    url.searchParams.set('callbackUrl', options.callbackUrl);
     url.searchParams.set('callback', options.callbackUrl);
     url.searchParams.set('state', options.state);
+    if (options.codeChallenge) {
+        url.searchParams.set('codeChallenge', options.codeChallenge);
+        url.searchParams.set('codeChallengeMethod', 'S256');
+    }
     return url.toString();
 }
 export async function renewExistingToken(options) {
@@ -87,12 +94,20 @@ export async function renewExistingToken(options) {
     try {
         const res = await fetchFn(`${options.backendUrl}/api/settings/personal-access-tokens/current/renew`, {
             method: 'PATCH',
+            redirect: 'error',
+            signal: AbortSignal.timeout(10_000),
             headers: {
                 Authorization: `Bearer ${options.token}`,
                 'Content-Type': 'application/json',
             },
             body: JSON.stringify({ expiresIn: '365d' }),
         });
+        if (res.ok && res.json && options.onRenewed) {
+            const result = await res.json();
+            if (typeof result.expiresAt === 'string' && Date.parse(result.expiresAt) > Date.now()) {
+                options.onRenewed(result.expiresAt);
+            }
+        }
         return res.ok;
     }
     catch {
@@ -100,29 +115,43 @@ export async function renewExistingToken(options) {
     }
 }
 export async function loginCommand(options) {
+    if (options.activate) {
+        await activateAccount(options, DEFAULT_PLAYCRAFT_CLOUD_BASE);
+        return;
+    }
     const backendUrl = resolveLoginBaseUrl(options);
     const callbackPort = options.callbackPort ?? CALLBACK_PORT;
     const globalConfig = loadGlobalConfig();
     const existingToken = resolveExistingTokenForLoginTarget(globalConfig, backendUrl);
     if (existingToken) {
-        const renewed = await renewExistingToken({ backendUrl, token: existingToken });
+        let expiresAt;
+        const renewed = await renewExistingToken({ backendUrl, token: existingToken,
+            onRenewed: (value) => { expiresAt = value; } });
         if (renewed) {
-            saveGlobalConfig({
-                token: existingToken,
-                url: backendUrl,
-                backendUrl,
-            });
+            const previous = readEnvironmentProfile(globalConfig, backendUrl);
+            saveEnvironmentProfile(backendUrl, { token: existingToken,
+                ...(previous?.identity ? { identity: previous.identity } : {}),
+                ...(expiresAt ? { expiresAt } : {}) });
             console.log('Existing CLI token renewed. Token saved to ~/.playcraft/config.json');
             return;
         }
     }
     const state = crypto.randomBytes(16).toString('hex');
+    const codeVerifier = crypto.randomBytes(32).toString('base64url');
+    const codeChallenge = crypto.createHash('sha256').update(codeVerifier).digest('base64url');
+    let callbackUrl = '';
+    let exchanging = false;
     return new Promise((resolve, reject) => {
         let timeout;
         const server = http.createServer((req, res) => {
-            res.setHeader('Access-Control-Allow-Origin', '*');
+            res.setHeader('Access-Control-Allow-Origin', new URL(backendUrl).origin);
             res.setHeader('Access-Control-Allow-Methods', 'POST, OPTIONS');
             res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+            if (req.headers.origin && req.headers.origin !== new URL(backendUrl).origin) {
+                res.writeHead(403);
+                res.end();
+                return;
+            }
             if (req.method === 'OPTIONS') {
                 res.writeHead(204);
                 res.end();
@@ -130,8 +159,9 @@ export async function loginCommand(options) {
             }
             if (req.url === '/callback' && req.method === 'POST') {
                 let body = '';
-                req.on('data', (chunk) => (body += chunk));
-                req.on('end', () => {
+                req.on('data', (chunk) => { body += chunk; if (body.length > 16_384)
+                    req.destroy(); });
+                req.on('end', async () => {
                     try {
                         const data = JSON.parse(body);
                         if (data.state !== state) {
@@ -139,22 +169,36 @@ export async function loginCommand(options) {
                                 'Content-Type': 'text/html',
                                 Connection: 'close',
                             });
-                            res.end('<html><body><h1>Invalid state</h1></body></html>', () => {
-                                closeServer(() => {
-                                    reject(new Error('State mismatch - possible CSRF attack'));
-                                });
-                            });
+                            res.end('<html><body><h1>Invalid state</h1></body></html>');
                             return;
                         }
-                        const callbackToken = typeof data.token === 'string' ? data.token : undefined;
-                        if (!callbackToken) {
-                            throw new Error('Login callback did not include a token');
+                        if (exchanging) {
+                            res.writeHead(409);
+                            res.end();
+                            return;
+                        }
+                        if (typeof data.code !== 'string' || !/^[A-Za-z0-9_-]{43}$/.test(data.code)) {
+                            throw new Error('Login callback did not include an authorization code');
                         }
-                        saveGlobalConfig({
-                            token: callbackToken,
-                            url: backendUrl,
-                            backendUrl,
+                        exchanging = true;
+                        const base = normalizeEnvironmentBaseUrl(backendUrl);
+                        if (!base)
+                            throw new Error('Invalid environment address');
+                        const exchange = await fetch(`${base}/api/cloud-environments/exchange`, {
+                            method: 'POST', redirect: 'error', signal: AbortSignal.timeout(10_000),
+                            headers: { 'Content-Type': 'application/json' },
+                            body: JSON.stringify({ code: data.code, state, callbackUrl, codeVerifier }),
                         });
+                        if (!exchange.ok)
+                            throw new Error('Authorization code exchange failed');
+                        const credential = await exchange.json();
+                        if (!credential.token || !/^playcraft_pat_[A-Za-z0-9_-]{32}$/.test(credential.token)
+                            || !credential.identity?.userId || !Array.isArray(credential.identity.identities)
+                            || !credential.expiresAt || Date.parse(credential.expiresAt) <= Date.now()) {
+                            throw new Error('Invalid environment credential response');
+                        }
+                        saveEnvironmentProfile(base, { token: credential.token,
+                            identity: credential.identity, expiresAt: credential.expiresAt });
                         res.writeHead(200, {
                             'Content-Type': 'text/html',
                             Connection: 'close',
@@ -174,9 +218,6 @@ export async function loginCommand(options) {
                     catch (err) {
                         const cause = err instanceof Error ? err : new Error(String(err));
                         console.error('[playcraft login] Callback handling failed:', cause.message);
-                        if (cause.stack) {
-                            console.error(cause.stack);
-                        }
                         const userFacing = cause instanceof SyntaxError
                             ? 'Invalid JSON in login callback.'
                             : `Login callback failed: ${cause.message}`;
@@ -221,14 +262,15 @@ export async function loginCommand(options) {
             });
         });
         try {
-            server.listen(callbackPort, () => {
+            server.listen(callbackPort, '127.0.0.1', () => {
                 const address = server.address();
                 const listeningPort = typeof address === 'object' && address ? address.port : callbackPort;
-                const callbackUrl = `http://localhost:${listeningPort}/callback`;
+                callbackUrl = `http://127.0.0.1:${listeningPort}/callback`;
                 const authUrl = buildCliAuthUrl({
                     backendUrl,
                     callbackUrl,
                     state,
+                    codeChallenge,
                 });
                 console.log('Opening browser for login...');
                 console.log(`If the browser does not open, visit this URL manually:\n  ${authUrl}\n`);

package/dist/commands/platform-skills.generated.js

@@ -0,0 +1,19 @@
+// 此文件由 scripts/generate-platform-skills.mjs 生成，请勿手改。
+// 重新生成：pnpm --filter @playcraft/cli generate:platform-skills
+/** `@playcraft/skills/playcraft-skills/` 下的 Platform Skill 目录名。 */
+export const PLATFORM_SKILL_DIRS = [
+    'playcraft-3d-flip-sprite',
+    'playcraft-asset-management',
+    'playcraft-build',
+    'playcraft-code-editor',
+    'playcraft-create-remix',
+    'playcraft-deploy',
+    'playcraft-iteration-methodology',
+    'playcraft-platform-intro',
+    'playcraft-prefab',
+    'playcraft-project-management',
+    'playcraft-remix-workflow',
+    'playcraft-save',
+    'playcraft-template-upgrade-merge',
+    'sound-effects',
+];

package/dist/commands/playable.js

@@ -0,0 +1,53 @@
+import { recordPlayable } from '../recording/recorder.js';
+import { RecordingError, recordingMessage as t } from '../recording/messages.js';
+import { dirname, join } from 'node:path';
+import { captureGeneratedArtifact } from '../workspace-runtime/workspaces/artifact-receipts.js';
+export async function runPlayableRecord(options) {
+    const interrupted = new AbortController();
+    const deadline = new AbortController();
+    const onInterrupt = () => interrupted.abort(new DOMException('Interrupted', 'AbortError'));
+    process.once('SIGINT', onInterrupt);
+    let timer;
+    try {
+        const seconds = options.timeout === undefined ? 1200 : Number(options.timeout);
+        if (!Number.isFinite(seconds) || seconds <= 0 || seconds > 1800)
+            throw new RecordingError('invalidArguments', 64);
+        timer = setTimeout(() => deadline.abort(new DOMException('Timed out', 'TimeoutError')), seconds * 1000);
+        const result = await recordPlayable(options, AbortSignal.any([interrupted.signal, deadline.signal]));
+        const metadata = result.envelope.result;
+        const output = result.envelope.artifacts;
+        if (result.envelope.ok && metadata && output?.candidate) {
+            const artifacts = [metadata.candidate, ...metadata.controls];
+            const paths = [output.candidate, ...(output.controls ?? [])];
+            for (let index = 0; index < artifacts.length; index++) {
+                const artifact = artifacts[index], path = paths[index];
+                if (!path)
+                    continue;
+                const thumbnail = artifact.screenshots?.[0]?.path;
+                await captureGeneratedArtifact(path, 'playable record', {
+                    width: artifact.video.source.width, height: artifact.video.source.height,
+                    duration: artifact.video.source.durationMs / 1000,
+                    ...(thumbnail ? { thumbnailPath: join(dirname(output.metadata), thumbnail) } : {}),
+                });
+            }
+        }
+        process.stdout.write(`${JSON.stringify(result.envelope)}\n`);
+        process.exitCode = result.exitCode;
+    }
+    catch (error) {
+        const code = error instanceof RecordingError ? error.code : 'recordingFailed';
+        process.stdout.write(`${JSON.stringify({ schemaVersion: 'playcraft.video-cli.v1', command: 'playable record', state: 'failed', ok: false, error: { code, message: t(code) } })}\n`);
+        process.exitCode = error instanceof RecordingError ? error.exitCode : 4;
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+        process.removeListener('SIGINT', onInterrupt);
+    }
+}
+export function registerPlayableCommands(program) {
+    program.command('playable').description(t('topic')).command('record').description(t('record'))
+        .option('--url <url>', t('url')).option('--scenario <file>', t('scenario')).option('--out <directory>', t('out'))
+        .option('--browser-path <path>', t('browser')).option('--timeout <seconds>', t('timeout'))
+        .action(runPlayableRecord);
+}

package/dist/commands/skills.js

@@ -18,6 +18,8 @@
  *   3. <cwd>/node_modules/@playcraft/skills/playcraft-skills（兼容旧路径 skills）
  *   4. <CLI 自身>/../../skills/playcraft-skills（monorepo 开发时，兼容旧路径 skills）
  */
+import { registerProjectSkillsCommands } from '../project-skills/commands.js';
+import { registerRegistryCommands } from '../skill-registry/commands.js';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { getFusionHintsForGameplayAtoms, } from '../atom-tree/fusion-hints.js';
@@ -1430,6 +1432,8 @@ export function registerSkillsCommands(program) {
     const skills = program
         .command('skills')
         .description('开发时 Skill 发现与脚手架工具（按 engine/intent 推荐 skill 集合，或将 ref 文件复制到项目）');
+    registerProjectSkillsCommands(skills);
+    registerRegistryCommands(skills);
     // 公共选项：skills 目录
     const addSkillsDirOption = (cmd) => cmd.option('--skills-dir <path>', '指定 skills 目录路径（默认自动发现）');
     // ── list ──────────────────────────────────────────────────────────────────

package/dist/commands/tools-3d.js

@@ -2,6 +2,7 @@ import { writeFileSync, mkdirSync, readFileSync } from 'fs';
 import { dirname } from 'path';
 import { AgentApiClient } from '../utils/agent-api-client.js';
 import { mimeTypeForImagePath, handleError } from './tools-utils.js';
+import { captureGeneratedArtifact } from '../workspace-runtime/workspaces/artifact-receipts.js';
 const AVATAR_TEMPLATES = [
     'basketball', 'badminton', 'pingpong', 'gymnastics', 'pilidance',
     'tennis', 'athletics', 'footballboykicking1', 'footballboykicking2',
@@ -148,6 +149,9 @@ export function register3DCommands(tools) {
                 writeFileSync(opts.savePreview, previewBuf);
                 console.log(`  Preview saved: ${opts.savePreview}`);
             }
+            await captureGeneratedArtifact(opts.output, 'generate-3d', {
+                ...(opts.savePreview && result.previewImageBase64 ? { thumbnailPath: opts.savePreview } : {}),
+            });
             console.log(`\nNext steps:`);
             console.log(`  Inspect:        playcraft 3d info ${opts.output}`);
             console.log(`  Apply texture:  playcraft tools generate-texture --model-url <url> --reference-image <img> --output out.glb`);
@@ -209,6 +213,7 @@ export function register3DCommands(tools) {
             const outDir = dirname(opts.output);
             mkdirSync(outDir, { recursive: true });
             writeFileSync(opts.output, buf);
+            await captureGeneratedArtifact(opts.output, 'generate-texture');
             const sizeMB = (buf.length / 1024 / 1024).toFixed(2);
             console.log(`\nTextured model saved: ${opts.output} (${sizeMB}MB, ${elapsed}s)`);
             if (result.resultUrl)
@@ -253,6 +258,7 @@ export function register3DCommands(tools) {
             const outDir = dirname(opts.output);
             mkdirSync(outDir, { recursive: true });
             writeFileSync(opts.output, buf);
+            await captureGeneratedArtifact(opts.output, 'retopology');
             const sizeMB = (buf.length / 1024 / 1024).toFixed(2);
             console.log(`\nRetopologized model saved: ${opts.output} (${sizeMB}MB, ${elapsed}s)`);
         }
@@ -289,6 +295,7 @@ export function register3DCommands(tools) {
             const outDir = dirname(opts.output);
             mkdirSync(outDir, { recursive: true });
             writeFileSync(opts.output, buf);
+            await captureGeneratedArtifact(opts.output, 'uv-unwrap');
             const sizeMB = (buf.length / 1024 / 1024).toFixed(2);
             console.log(`\nUV-unwrapped model saved: ${opts.output} (${sizeMB}MB, ${elapsed}s)`);
         }
@@ -324,6 +331,7 @@ export function register3DCommands(tools) {
             const outDir = dirname(opts.output);
             mkdirSync(outDir, { recursive: true });
             writeFileSync(opts.output, buf);
+            await captureGeneratedArtifact(opts.output, 'convert-3d');
             const sizeMB = (buf.length / 1024 / 1024).toFixed(2);
             console.log(`\nConverted model saved: ${opts.output} (${sizeMB}MB, ${elapsed}s)`);
             console.log(`  Format: ${result.format.toUpperCase()}`);
@@ -359,6 +367,7 @@ export function register3DCommands(tools) {
             const outDir = dirname(opts.output);
             mkdirSync(outDir, { recursive: true });
             writeFileSync(opts.output, buf);
+            await captureGeneratedArtifact(opts.output, 'generate-3d-parts');
             const sizeMB = (buf.length / 1024 / 1024).toFixed(2);
             console.log(`\n3D parts model saved: ${opts.output} (${sizeMB}MB, ${elapsed}s)`);
         }
@@ -402,6 +411,7 @@ export function register3DCommands(tools) {
             const outDir = dirname(opts.output);
             mkdirSync(outDir, { recursive: true });
             writeFileSync(opts.output, buf);
+            await captureGeneratedArtifact(opts.output, 'generate-motion');
             const sizeMB = (buf.length / 1024 / 1024).toFixed(2);
             console.log(`\nMotion FBX saved: ${opts.output} (${sizeMB}MB, ${elapsed}s)`);
         }
@@ -463,6 +473,7 @@ export function register3DCommands(tools) {
             const outDir = dirname(opts.output);
             mkdirSync(outDir, { recursive: true });
             writeFileSync(opts.output, buf);
+            await captureGeneratedArtifact(opts.output, 'generate-avatar');
             const sizeMB = (buf.length / 1024 / 1024).toFixed(2);
             console.log(`\n3D avatar saved: ${opts.output} (${sizeMB}MB, ${elapsed}s)`);
         }