@playcraft/cli 0.1.34 → 0.1.36-beta1

package/dist/commands/tools-generation.js

@@ -1,7 +1,8 @@
 import { writeFileSync, mkdirSync } from 'fs';
 import { dirname, parse, join } from 'path';
 import sharp from 'sharp';
-import { captureGeneratedArtifact } from '../workspace-runtime/workspaces/artifact-receipts.js';
+import { resolveImageBackgroundRequirement, validateImageDeliveryOptions } from '@playcraft/common/prefab';
+import { readImageAssetContext } from '../utils/image-asset-context.js';
 import { AgentApiClient } from '../utils/agent-api-client.js';
 import { MAX_REFERENCE_IMAGES, collectReferenceImagePaths, collectReferenceImagePayloads, sniffImageExtension, extensionForImageMime, resolveImageOutputPath, handleError, raceWithTimeout, } from './tools-utils.js';
 function isMasterCompositeStripRequest(opts) {
@@ -151,86 +152,120 @@ export function registerGenerationCommands(tools) {
         .requiredOption('--prompt <text>', '图片描述')
         .option('--aspect-ratio <ratio>', '宽高比 (1:1|45:16|16:9|9:16|3:4|4:3|2:3|3:2|21:9)', '1:1')
         .requiredOption('--output <path>', '保存路径（--count>1 时自动追加 _1/_2 等后缀）')
+        .option('--target-asset <path>', 'Existing asset to replace; read its schema references and delivery constraints')
+        .option('--no-target-reference', 'Generate without the existing asset reference only when explicitly requested')
+        .option('--output-format <format>', 'Final format: png, webp or jpeg')
+        .option('--fit-mode <mode>', 'Canvas fitting: contain, cover or fill')
+        .option('--padding-color <color>', 'Canvas padding color (transparent by default)')
+        .option('--remove-background', 'Require a verified transparent image')
+        .option('--no-remove-background', 'Keep the generated background')
         .option('--image-size <size>', '图片尺寸 (1K|2K|4K)')
         .option('--width <n>', '精确宽度（像素；MC 横排 5×9:16 推荐 3600 或 4096）', (v) => parseInt(v, 10))
         .option('--height <n>', '精确高度（像素；MC 推荐 1280 或 1455）', (v) => parseInt(v, 10))
         .option('--reference-image <path>', '参考图路径（可重复多次，最多 8 张），支持 PNG/JPG/WEBP', collectReferenceImagePaths, [])
         .option('--image-model <model>', '模型名（如 gpt-image-2）或 provider/model（如 mulerouter/gpt-image-2）。传模型名时后端按优先级自动 fallback；传 provider/model 则直连指定 provider')
-        .option('--retry <n>', '全部 provider 都失败时的重试轮数（默认 1；超时不计为可重试错误）', (v) => parseInt(v, 10), 1)
+        .option('--retry <n>', '额外重试轮数（默认 0；后端统一限制尝试，透明验证失败和超时不重试）', (v) => parseInt(v, 10), 0)
         .option('--timeout <seconds>', '请求超时秒数（默认 1800，即 30 分钟；异步生图模型耗时较长，仅在后端明确报错时提前终止）', (v) => parseInt(v, 10), 1800)
         .option('--count <n>', '一次 API 调用生成多少张图片（默认 1，最多 10；仅 gpt-image-2 实际支持批量）', (v) => parseInt(v, 10), 1)
         .action(async (opts) => {
-        const paths = opts.referenceImage ?? [];
-        if (paths.length > MAX_REFERENCE_IMAGES) {
-            console.error(`Error: Too many reference images: ${paths.length} paths given; maximum is ${MAX_REFERENCE_IMAGES}.`);
-            process.exit(1);
-            return;
-        }
-        const hasReferenceImages = paths.length > 0;
-        const attemptGenerate = async (modelRef, attempt) => {
-            const label = modelRef ? `[${modelRef}]` : '[default model]';
-            if (attempt > 0) {
-                console.log(`Retry ${attempt}/${opts.retry} ${label}...`);
-            }
-            else {
-                console.log(`Generating image ${label}...`);
+        try {
+            const assetContext = opts.targetAsset ? await readImageAssetContext(opts.targetAsset, process.cwd(), {
+                referenceImagePaths: opts.referenceImage, useTargetReference: opts.targetReference,
+                prompt: opts.prompt, removeBackground: opts.removeBackground,
+            }) : undefined;
+            opts = { ...opts,
+                aspectRatio: assetContext?.aspectRatio ?? opts.aspectRatio,
+                width: assetContext?.width ?? opts.width, height: assetContext?.height ?? opts.height,
+                outputFormat: assetContext?.outputFormat ?? opts.outputFormat,
+                fitMode: assetContext?.fitMode ?? opts.fitMode,
+                removeBackground: resolveImageBackgroundRequirement({ prompt: opts.prompt,
+                    schemaRemoveBackground: assetContext?.removeBackgroundFromSchema ? assetContext.removeBackground : undefined,
+                    removeBackground: opts.removeBackground, fallbackRemoveBackground: assetContext?.removeBackground }),
+                paddingColor: assetContext?.paddingColor ?? opts.paddingColor,
+                imageModel: opts.imageModel || assetContext?.imageModelRef,
+            };
+            const invalidDelivery = validateImageDeliveryOptions(opts);
+            if (invalidDelivery)
+                throw new Error(invalidDelivery);
+            const paths = opts.referenceImage?.length ? opts.referenceImage : assetContext?.referenceImagePaths ?? [];
+            if (paths.length > MAX_REFERENCE_IMAGES) {
+                console.error(`Error: Too many reference images: ${paths.length} paths given; maximum is ${MAX_REFERENCE_IMAGES}.`);
+                process.exit(1);
+                return;
             }
-            const referenceImages = await collectReferenceImagePayloads(paths);
-            const client = new AgentApiClient();
-            const imageCount = Math.min(Math.max(1, opts.count ?? 1), 10);
-            const requestPromise = client.post('/generate-image', {
-                prompt: opts.prompt,
-                aspectRatio: opts.aspectRatio,
-                imageSize: opts.imageSize,
-                ...(opts.width && opts.height ? { width: opts.width, height: opts.height } : {}),
-                referenceImages,
-                ...(modelRef ? { imageModelRef: modelRef } : {}),
-                ...(imageCount > 1 ? { imageCount } : {}),
-            });
-            return raceWithTimeout(requestPromise, opts.timeout * 1000, `Request timed out after ${opts.timeout}s. The backend task may still be running — check admin panel before re-running.`);
-        };
-        const enrichError = (err, modelRef) => {
-            const msg = err instanceof Error ? err.message : String(err);
-            const lines = [`Error: ${msg}`];
-            if (msg.includes('500') || msg.includes('Internal server error')) {
-                lines.push('');
-                lines.push('Hint: API 500 error — the model may be temporarily unavailable.');
-                lines.push('  → If using a bare model name (e.g. gpt-image-2), all providers failed — try a different model');
-                if (modelRef?.includes('/')) {
-                    lines.push('  → Or try without provider prefix to auto-fallback providers: --image-model gpt-image-2');
+            const hasReferenceImages = paths.length > 0;
+            const attemptGenerate = async (modelRef, attempt) => {
+                const label = modelRef ? `[${modelRef}]` : '[default model]';
+                if (attempt > 0) {
+                    console.log(`Retry ${attempt}/${opts.retry} ${label}...`);
                 }
-            }
-            else if (msg.includes('timed out')) {
-                lines.push('');
-                lines.push('Hint: Request timed out. The backend task may still be running — retries were skipped to avoid creating duplicate tasks.');
-                lines.push('  → Check the backend/admin panel for task status before re-running');
-                lines.push('  → Try --image-size 1K to reduce generation time');
-                lines.push('  → Or increase timeout with --timeout <seconds> (current default: 1800s)');
-            }
-            else if (hasReferenceImages && (msg.includes('reference') || msg.includes('image input'))) {
-                lines.push('');
-                lines.push('Hint: Reference image error — the selected model may not support --reference-image.');
-                lines.push('  → Run: playcraft tools list-image-models');
-                lines.push('  → Models with CAPABILITY=text+image support --reference-image');
-            }
-            return lines.join('\n');
-        };
-        try {
+                else {
+                    console.log(`Generating image ${label}...`);
+                }
+                const referenceImages = await collectReferenceImagePayloads(paths);
+                const client = new AgentApiClient();
+                const imageCount = Math.min(Math.max(1, opts.count ?? 1), 10);
+                const requestPromise = client.post('/generate-image', {
+                    prompt: opts.prompt,
+                    aspectRatio: assetContext?.aspectRatio ?? opts.aspectRatio,
+                    imageSize: opts.imageSize,
+                    width: assetContext?.width ?? opts.width,
+                    height: assetContext?.height ?? opts.height,
+                    outputFormat: assetContext?.outputFormat ?? opts.outputFormat,
+                    fitMode: assetContext?.fitMode ?? opts.fitMode,
+                    paddingColor: assetContext?.paddingColor ?? opts.paddingColor,
+                    removeBackground: opts.removeBackground,
+                    referenceImages,
+                    ...(modelRef ? { imageModelRef: modelRef } : {}),
+                    ...(imageCount > 1 ? { imageCount } : {}),
+                });
+                return raceWithTimeout(requestPromise, opts.timeout * 1000, `Request timed out after ${opts.timeout}s. The backend task may still be running — check admin panel before re-running.`);
+            };
+            const enrichError = (err, modelRef) => {
+                const msg = err instanceof Error ? err.message : String(err);
+                const lines = [`Error: ${msg}`];
+                if (/source_transparency_invalid|output_transparency_invalid|transparency_unsupported/.test(msg)) {
+                    lines.push('Hint: Transparent output was not delivered. Preserve the requested transparency, references and model; use the request id and stage to investigate.');
+                }
+                else if (/API 500\b|Internal server error/.test(msg)) {
+                    lines.push('');
+                    lines.push('Hint: API 500 error — the model may be temporarily unavailable.');
+                    lines.push('  → Inspect the request id and backend diagnostics before another generation attempt.');
+                    if (modelRef?.includes('/') && opts.removeBackground !== true) {
+                        lines.push('  → Or try without provider prefix to auto-fallback providers: --image-model gpt-image-2');
+                    }
+                }
+                else if (msg.includes('timed out')) {
+                    lines.push('');
+                    lines.push('Hint: Request timed out. The backend task may still be running — retries were skipped to avoid creating duplicate tasks.');
+                    lines.push('  → Check the backend/admin panel for task status before re-running');
+                    lines.push('  → Try --image-size 1K to reduce generation time');
+                    lines.push('  → Or increase timeout with --timeout <seconds> (current default: 1800s)');
+                }
+                else if (hasReferenceImages && (msg.includes('reference') || msg.includes('image input'))) {
+                    lines.push('');
+                    lines.push('Hint: Reference image error — the selected model may not support --reference-image.');
+                    lines.push('  → Run: playcraft tools list-image-models');
+                    lines.push('  → Models with CAPABILITY=text+image support --reference-image');
+                }
+                return lines.join('\n');
+            };
             let result = null;
             let lastError = null;
             // 重试逻辑：超时不重试（后端任务可能仍在运行，重试会导致重复提交）
-            const maxAttempts = 1 + (opts.retry ?? 1);
+            const maxAttempts = 1 + (opts.retry ?? 0);
             for (let attempt = 0; attempt < maxAttempts; attempt++) {
                 try {
-                    result = await attemptGenerate(opts.imageModel, attempt);
+                    result = await attemptGenerate(opts.imageModel || assetContext?.imageModelRef, attempt);
                     break;
                 }
                 catch (e) {
                     lastError = e;
                     const msg = e instanceof Error ? e.message : String(e);
                     const isTimeout = msg.includes('timed out');
-                    if (isTimeout) {
-                        console.error(`Attempt ${attempt + 1} timed out — not retrying (backend task may still be running).`);
+                    const cannotRetry = /source_transparency_invalid|output_transparency_invalid|transparency_unsupported|"retryable"\s*:\s*false/.test(msg);
+                    if (isTimeout || cannotRetry) {
+                        console.error(`Attempt ${attempt + 1} stopped: ${msg}`);
                         break;
                     }
                     if (attempt < maxAttempts - 1) {
@@ -259,12 +294,14 @@ export function registerGenerationCommands(tools) {
                 ...(result.additionalImages ?? []),
             ];
             const isBatch = allImages.length > 1;
-            const modelPart = opts.imageModel ? `model: ${opts.imageModel}` : '';
+            const modelPart = result.model ? `model: ${result.model}` : '';
             const providerPart = result.provider ? `provider: ${result.provider}` : '';
             const labelParts = [modelPart, providerPart].filter(Boolean);
             const modelLabel = labelParts.length > 0 ? ` (${labelParts.join(', ')})` : '';
             const savedPaths = [];
-            const stripTarget = resolveStripTargetDimensions({
+            if (result.transparencySource)
+                console.log(`Transparency source: ${result.transparencySource}`);
+            const stripTarget = opts.targetAsset || result.transparentBackground ? null : resolveStripTargetDimensions({
                 aspectRatio: opts.aspectRatio,
                 width: opts.width,
                 height: opts.height,
@@ -312,8 +349,17 @@ export function registerGenerationCommands(tools) {
                 savedPaths.push(resolvedPath);
                 const sidecar = {
                     prompt: opts.prompt,
-                    model: opts.imageModel ?? 'default',
+                    model: result.model ?? null,
+                    requestedModel: opts.imageModel ?? null,
                     provider: result.provider ?? null,
+                    transparentBackground: result.transparentBackground ?? null,
+                    transparencySource: result.transparencySource ?? null,
+                    requestId: result.requestId ?? null,
+                    attempts: result.attempts ?? null,
+                    targetAssetPath: assetContext?.targetAssetPath ?? null,
+                    outputFormat: opts.outputFormat ?? null,
+                    fitMode: opts.fitMode ?? null,
+                    paddingColor: opts.paddingColor ?? null,
                     aspectRatio: opts.aspectRatio,
                     imageSize: opts.imageSize ?? null,
                     requestedWidth: opts.width ?? stripTarget?.width ?? null,
@@ -331,9 +377,6 @@ export function registerGenerationCommands(tools) {
                 };
                 const sidecarPath = resolvedPath.replace(/\.[^.]+$/, '.json');
                 writeFileSync(sidecarPath, JSON.stringify(sidecar, null, 2));
-                await captureGeneratedArtifact(resolvedPath, 'generate-image', {
-                    ...(actualWidth ? { width: actualWidth } : {}), ...(actualHeight ? { height: actualHeight } : {}),
-                });
                 console.log(`  └─ Generation metadata: ${sidecarPath}`);
             }
             if (!isBatch && opts.output !== savedPaths[0] && savedPaths[0]) {
@@ -381,7 +424,6 @@ export function registerGenerationCommands(tools) {
                 output: opts.output, generatedAt: new Date().toISOString(),
             };
             writeFileSync(opts.output.replace(/\.[^.]+$/, '.json'), JSON.stringify(sfxSidecar, null, 2));
-            await captureGeneratedArtifact(opts.output, 'generate-sfx', { duration: result.duration });
             console.log(`  └─ Generation metadata: ${opts.output.replace(/\.[^.]+$/, '.json')}`);
         }
         catch (e) {
@@ -414,7 +456,6 @@ export function registerGenerationCommands(tools) {
                 output: opts.output, generatedAt: new Date().toISOString(),
             };
             writeFileSync(opts.output.replace(/\.[^.]+$/, '.json'), JSON.stringify(bgmSidecar, null, 2));
-            await captureGeneratedArtifact(opts.output, 'generate-bgm', { duration: result.duration });
             console.log(`  └─ Generation metadata: ${opts.output.replace(/\.[^.]+$/, '.json')}`);
         }
         catch (e) {

package/dist/commands/tools-image-context.js

@@ -0,0 +1,23 @@
+import { readImageAssetContext } from '../utils/image-asset-context.js';
+import { collectReferenceImagePaths, handleError } from './tools-utils.js';
+export function registerImageContextCommand(tools) {
+    tools.command('image-context')
+        .description('Read image asset reference and delivery constraints locally; does not generate an image')
+        .requiredOption('--asset-path <path>', 'Existing image asset path relative to the project')
+        .option('--reference-image <path>', 'Explicit local reference; may be repeated', collectReferenceImagePaths, [])
+        .option('--no-target-reference', 'Do not use the target schema or current asset as a reference')
+        .option('--prompt <text>', 'Generation request used to resolve background intent')
+        .option('--remove-background', 'Explicitly request verified transparency')
+        .option('--no-remove-background', 'Explicitly keep an opaque background')
+        .action(async (opts) => {
+        try {
+            console.log(JSON.stringify(await readImageAssetContext(opts.assetPath, process.cwd(), {
+                referenceImagePaths: opts.referenceImage, useTargetReference: opts.targetReference,
+                prompt: opts.prompt, removeBackground: opts.removeBackground,
+            })));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}

package/dist/commands/tools.js

@@ -1,16 +1,16 @@
 import { registerGenerationCommands } from './tools-generation.js';
-import { registerBatchCommands } from './tools-batch.js';
 import { registerProjectCommands } from './tools-project.js';
 import { register3DCommands } from './tools-3d.js';
 import { registerDetectCommand } from './tools-detect.js';
 import { registerVideoReviewCommand } from './tools-video-review.js';
+import { registerImageContextCommand } from './tools-image-context.js';
 export function registerToolsCommands(program) {
     const tools = program
         .command('tools')
         .description('后端 /api/agent/tools；运行 playcraft login 后即可直接使用，也支持 .playcraft.json 或 PLAYCRAFT_SANDBOX_TOKEN 环境变量');
     registerGenerationCommands(tools);
+    registerImageContextCommand(tools);
     registerProjectCommands(tools);
-    registerBatchCommands(tools);
     register3DCommands(tools);
     registerDetectCommand(tools);
     registerVideoReviewCommand(tools);

package/dist/config.js

@@ -2,8 +2,7 @@ import { cosmiconfig } from 'cosmiconfig';
 import { z } from 'zod';
 import path from 'path';
 import { homedir } from 'os';
-import { chmodSync, mkdirSync, renameSync, rmSync, writeFileSync, readFileSync } from 'fs';
-import { randomUUID } from 'node:crypto';
+import { mkdirSync, writeFileSync, readFileSync } from 'fs';
 import 'dotenv/config';
 export const ConfigSchema = z.object({
     projectId: z.string().optional(),
@@ -19,33 +18,6 @@ const explorer = cosmiconfig('playcraft', {
 });
 const GLOBAL_CONFIG_DIR = path.join(homedir(), '.playcraft');
 const GLOBAL_CONFIG_FILE = path.join(GLOBAL_CONFIG_DIR, 'config.json');
-export function normalizeEnvironmentBaseUrl(raw) {
-    try {
-        const url = new URL(raw);
-        if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password)
-            return undefined;
-        url.hash = '';
-        url.search = '';
-        url.pathname = url.pathname.replace(/\/+$/, '').replace(/\/api$/, '');
-        return url.toString().replace(/\/+$/, '');
-    }
-    catch {
-        return undefined;
-    }
-}
-export function readEnvironmentProfile(config, baseUrl) {
-    const key = normalizeEnvironmentBaseUrl(baseUrl);
-    const profiles = config.environmentProfiles;
-    if (!key || !profiles || typeof profiles !== 'object' || Array.isArray(profiles))
-        return undefined;
-    const profile = profiles[key];
-    if (!profile || typeof profile !== 'object' || Array.isArray(profile))
-        return undefined;
-    const value = profile;
-    if (typeof value.token !== 'string' || !value.token || normalizeEnvironmentBaseUrl(value.backendUrl) !== key)
-        return undefined;
-    return value;
-}
 export function loadGlobalConfig() {
     try {
         const content = readFileSync(GLOBAL_CONFIG_FILE, 'utf-8');
@@ -56,8 +28,7 @@ export function loadGlobalConfig() {
     }
 }
 export function saveGlobalConfig(partial) {
-    mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true, mode: 0o700 });
-    chmodSync(GLOBAL_CONFIG_DIR, 0o700);
+    mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true });
     let existing = {};
     try {
         existing = JSON.parse(readFileSync(GLOBAL_CONFIG_FILE, 'utf-8'));
@@ -66,25 +37,7 @@ export function saveGlobalConfig(partial) {
         // ignore
     }
     const merged = { ...existing, ...partial };
-    const temporary = path.join(GLOBAL_CONFIG_DIR, `.config-${randomUUID()}.tmp`);
-    try {
-        writeFileSync(temporary, JSON.stringify(merged, null, 2), { encoding: 'utf-8', flag: 'wx', mode: 0o600 });
-        renameSync(temporary, GLOBAL_CONFIG_FILE);
-    }
-    finally {
-        rmSync(temporary, { force: true });
-    }
-}
-export function saveEnvironmentProfile(baseUrl, profile) {
-    const key = normalizeEnvironmentBaseUrl(baseUrl);
-    if (!key)
-        throw new Error('Invalid environment address');
-    const current = loadGlobalConfig();
-    const profiles = current.environmentProfiles && typeof current.environmentProfiles === 'object'
-        && !Array.isArray(current.environmentProfiles) ? current.environmentProfiles : {};
-    saveGlobalConfig({ environmentProfiles: { ...profiles,
-            [key]: { ...profile, backendUrl: key, updatedAt: new Date().toISOString() } },
-        token: profile.token, url: key, backendUrl: key });
+    writeFileSync(GLOBAL_CONFIG_FILE, JSON.stringify(merged, null, 2), 'utf-8');
 }
 export async function loadConfig(cliOptions) {
     const result = await explorer.search(cliOptions.dir || process.cwd());
@@ -93,20 +46,12 @@ export async function loadConfig(cliOptions) {
         ? (fileConfig.agent || {})
         : fileConfig;
     const globalConfig = loadGlobalConfig();
-    const explicitTarget = cliOptions.url || process.env.PLAYCRAFT_URL || agentConfig.url;
-    const targetUrl = explicitTarget || globalConfig.url;
-    const profile = typeof targetUrl === 'string' ? readEnvironmentProfile(globalConfig, targetUrl) : undefined;
-    const legacyTarget = typeof globalConfig.backendUrl === 'string' ? globalConfig.backendUrl
-        : typeof globalConfig.url === 'string' ? globalConfig.url : undefined;
-    const legacyToken = !explicitTarget || (legacyTarget && normalizeEnvironmentBaseUrl(String(targetUrl)) === normalizeEnvironmentBaseUrl(legacyTarget))
-        ? globalConfig.token : undefined;
     const config = ConfigSchema.parse({
         ...globalConfig,
         ...agentConfig,
         ...cliOptions,
         projectId: cliOptions.projectId || process.env.PLAYCRAFT_PROJECT_ID || agentConfig.projectId || globalConfig.projectId,
-        url: targetUrl,
-        token: cliOptions.token || process.env.PLAYCRAFT_TOKEN || agentConfig.token || profile?.token || legacyToken,
+        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,

package/dist/index.js

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
-import { Command, CommanderError } from 'commander';
-import { accountActivationMessage } from './auth/messages.js';
+import { Command } from 'commander';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
@@ -28,24 +27,16 @@ import { registerLevelsCommands } from './commands/levels.js';
 import { registerPatternsCommands } from './commands/patterns.js';
 import { registerPradCommands } from './commands/prad.js';
 import { register3DCommands } from './commands/3d.js';
-import { registerWorkspaceRuntimeCommands } from './commands/workspace-runtime.js';
-import { registerWorkspaceCommands } from './commands/workspace.js';
-import { registerVideoCommands } from './commands/video.js';
-import { registerPlayableCommands } from './commands/playable.js';
-import { videoMessage } from './video-replication/messages.js';
 import { CLI_ROOT_DESCRIPTION, getCliTopicsHelpText, registerRootProgramHelp, } from './cli-root-help.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const packageJson = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
 const program = new Command();
-const structuredVideoTopic = ['video', 'playable'].includes(process.argv[2] ?? '');
-if (structuredVideoTopic)
-    program.exitOverride();
 program.name('playcraft').description(CLI_ROOT_DESCRIPTION).version(packageJson.version);
 registerRootProgramHelp(program);
 // 版本检查（非阻塞，后台执行）
 // 只在非 upgrade 命令时检查，避免重复提示
-if (!structuredVideoTopic && !process.argv.includes('upgrade') && !process.argv.includes('workspace-runtime')) {
+if (!process.argv.includes('upgrade')) {
     checkForUpdates(packageJson);
 }
 // create 命令
@@ -74,8 +65,6 @@ program
     .command('login')
     .description('登录 PlayCraft 账号并获取 CLI token')
     .option('--url <url>', 'Portal / API 基址（默认 https://playcraft.aix.intlgame.com，可用环境变量 PLAYCRAFT_URL 覆盖）')
-    .option('--activate', accountActivationMessage('activateOption'))
-    .option('--token <token>', accountActivationMessage('tokenOption'))
     .action(async (options) => {
     const { loginCommand } = await import('./commands/login.js');
     await loginCommand(options);
@@ -379,26 +368,4 @@ registerPatternsCommands(program);
 registerPradCommands(program);
 // 3D model utilities (playcraft 3d <command>)
 register3DCommands(program);
-registerWorkspaceRuntimeCommands(program);
-registerWorkspaceCommands(program);
-registerVideoCommands(program);
-registerPlayableCommands(program);
-if (structuredVideoTopic) {
-    try {
-        await program.parseAsync(process.argv);
-    }
-    catch (error) {
-        if (!(error instanceof CommanderError))
-            throw error;
-        if (error.exitCode === 0)
-            process.exitCode = 0;
-        else {
-            const command = [process.argv[2], process.argv[3]?.startsWith('-') ? undefined : process.argv[3]].filter(Boolean).join(' ');
-            process.stdout.write(`${JSON.stringify({ schemaVersion: 'playcraft.video-cli.v1', command, state: 'failed', ok: false,
-                error: { code: 'invalidArguments', message: videoMessage('invalidArguments') } })}\n`);
-            process.exitCode = 64;
-        }
-    }
-}
-else
-    program.parse(process.argv);
+program.parse(process.argv);

package/dist/remix/clone.js

@@ -1,4 +1,3 @@
-import { prepareLocalSkillLifecycle } from '../project-skills/lifecycle.js';
 import { spawnSync } from 'node:child_process';
 import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'node:fs';
 import path from 'node:path';
@@ -152,7 +151,6 @@ export async function remixClone(options) {
     };
     writePlaycraftMeta(targetDir, meta);
     configureRepoCredentialHelper(targetDir);
-    await prepareLocalSkillLifecycle(targetDir, 'checkout');
     let projectType;
     try {
         const project = await client.get(`/projects/${encodeURIComponent(projectId)}`);

package/dist/remix/init-template.js

@@ -1,4 +1,3 @@
-import { prepareLocalSkillLifecycle } from '../project-skills/lifecycle.js';
 import * as path from 'node:path';
 import { applyEnginePackToProject, bakeFullTemplate, KNOWN_ADAPTERS, readAdapterFromAtomTree, readEngineMarker, resolveCliPackageRoot, } from '../scaffold/compose.js';
 import { autoLinkSkillsFromAtomTree } from '../commands/skills.js';
@@ -69,7 +68,6 @@ export async function initTemplateCommand(opts) {
             console.log(`  ⚠ auto-link skipped: ${err.message}`);
         }
     }
-    await prepareLocalSkillLifecycle(projectDir, 'create');
     console.log('\n下一步：');
     console.log('  npm install');
     console.log('  阅读 .claude/skills/<atom>/SKILL.md（已自动 link）并填 logs/developer-log.md § Skill Preflight');

package/dist/remix/pull.js

@@ -1,4 +1,3 @@
-import { prepareLocalSkillLifecycle } from '../project-skills/lifecycle.js';
 import { spawnSync } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import path from 'node:path';
@@ -45,7 +44,6 @@ export async function remixPull(options = {}) {
         const detail = [result.stderr, result.stdout].filter(Boolean).join('\n').trim();
         throw new Error(detail || `git pull 失败（exit ${result.status}）`);
     }
-    await prepareLocalSkillLifecycle(repoDir, 'checkout');
     if (options.json) {
         console.log(JSON.stringify({
             schemaVersion: '1.0',

package/dist/remix/push.js

@@ -1,6 +1,3 @@
-import { prepareLocalSkillLifecycle } from '../project-skills/lifecycle.js';
-import { reconcileLocalProjectSkills } from '../project-skills/reconcile.js';
-import { projectSkillsMessage as skillMessage } from '../project-skills/messages.js';
 import { spawnSync } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import path from 'node:path';
@@ -44,7 +41,6 @@ export async function remixPush(options = {}) {
         process.stderr.write(`[push] ${meta.cloneUrl}\n`);
         process.stderr.write(`[push] branch=${meta.branch} dir=${repoDir}\n`);
     }
-    const skills = await prepareLocalSkillLifecycle(repoDir, 'push');
     const result = runAuthenticatedGit(['push', ...effectiveArgs], {
         cwd: repoDir,
         token: client.token,
@@ -54,24 +50,10 @@ export async function remixPush(options = {}) {
         const detail = [result.stderr, result.stdout].filter(Boolean).join('\n').trim();
         throw new Error(detail || `git push 失败（exit ${result.status}）`);
     }
-    let skillIndex;
-    let skillIndexFailed = false;
-    if (skills.managed) {
-        try {
-            skillIndex = await reconcileLocalProjectSkills(repoDir, { url: options.url, token: options.token });
-        }
-        catch (error) {
-            skillIndexFailed = true;
-            skillIndex = { indexed: false, message: skillMessage('pushIndexFailed'), detail: error instanceof Error ? error.message : String(error) };
-            process.exitCode = 1;
-        }
-        if (!options.json)
-            process.stderr.write(`${JSON.stringify(skillIndex)}\n`);
-    }
     if (options.json) {
         console.log(JSON.stringify({
             schemaVersion: '1.0',
-            ok: !skillIndexFailed,
+            ok: true,
             command: 'remix.push',
             requestId: client.requestId,
             data: {
@@ -80,8 +62,6 @@ export async function remixPush(options = {}) {
                 cloneUrl: meta.cloneUrl,
                 dir: repoDir,
                 gitArgs: effectiveArgs,
-                gitPushed: true,
-                skills: skillIndex,
             },
         }));
         return;