@playcraft/cli 0.0.39 → 0.0.41

package/project-template/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs

@@ -0,0 +1,254 @@
+/**
+ * compare-style.template.mjs
+ *
+ * 色彩风格一致性定量检查脚本。
+ * 用途：TA Micro-Batch Validation 辅助工具，对 AI 补全素材与 Designer 样本做客观色彩比较。
+ *
+ * 使用方法：
+ *   cp .claude/skills/playcraft-image-generation/reference/compare-style.template.mjs \
+ *      ta-workspace/scripts/compare-style.mjs
+ *   # 修改下方 CONFIG 区域后运行：
+ *   node ta-workspace/scripts/compare-style.mjs
+ *
+ * 输出示例：
+ *   [COMPARE] tile_sample_1.png  vs  tile_comp_01.png
+ *     色相距离（加权）: 8.3°     → ✅ 优秀（< 15°）
+ *     明度差异:         0.06     → ✅ 优秀（< 0.10）
+ *     饱和度差异:       0.04     → ✅ 优秀（< 0.10）
+ *     综合一致性评分:   4.7 / 5  → ✅ 通过（≥ 3.0）
+ *
+ * 依赖：@gltf-transform/core（CLI 已内置）、sharp（CLI 已内置）
+ * 若 sharp 未全局可用，运行前：npm install sharp --no-save
+ */
+
+import { execSync } from 'child_process';
+import { existsSync, mkdirSync, appendFileSync } from 'fs';
+import path from 'path';
+
+// ─── CONFIG ───────────────────────────────────────────────────────────────────
+
+const CONFIG = {
+  /** Designer 样本图（风格基准） */
+  referenceImage: 'assets/images/tiles/tile_sample_1.png',
+
+  /** 要检查的 TA 补全素材目录或文件列表 */
+  targetDir: 'assets/images/tiles',
+
+  /** 只检查该目录下的哪些文件（glob 后缀匹配） */
+  targetGlob: '.png',
+
+  /** 排除文件名包含这些关键词的文件（Designer 样本自身） */
+  excludeKeywords: ['sample', 'concept', 'selected', 'storyboard'],
+
+  /** 日志输出路径 */
+  logFile: 'ta-workspace/logs/style-compare.log',
+
+  /** 评分阈值（低于此值输出警告） */
+  warnThreshold: 3.0,
+};
+
+// ─── HELPERS ──────────────────────────────────────────────────────────────────
+
+/**
+ * 用 playcraft image info 提取图片的 dominant colors（HSL 列表）
+ * 返回格式：[{ h, s, l, weight }]（weight 为面积占比估算）
+ */
+function extractDominantColors(imagePath) {
+  try {
+    const raw = execSync(
+      `playcraft image info --input "${imagePath}" --json`,
+      { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
+    );
+    const info = JSON.parse(raw);
+
+    // playcraft image info 返回 dominantColors 数组：[{ r, g, b, hex, percent }]
+    const colors = (info.dominantColors || []).slice(0, 5);
+    return colors.map(c => {
+      const hsl = rgbToHsl(c.r, c.g, c.b);
+      return { ...hsl, weight: (c.percent || 20) / 100 };
+    });
+  } catch {
+    return [];
+  }
+}
+
+function rgbToHsl(r, g, b) {
+  r /= 255; g /= 255; b /= 255;
+  const max = Math.max(r, g, b), min = Math.min(r, g, b);
+  const l = (max + min) / 2;
+  if (max === min) return { h: 0, s: 0, l };
+  const d = max - min;
+  const s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+  let h;
+  switch (max) {
+    case r: h = ((g - b) / d + (g < b ? 6 : 0)) / 6; break;
+    case g: h = ((b - r) / d + 2) / 6; break;
+    default: h = ((r - g) / d + 4) / 6;
+  }
+  return { h: h * 360, s, l };
+}
+
+/**
+ * 计算两组 dominant colors 之间的加权色相距离（°）
+ * 色相距离取最短弧（0–180°）
+ */
+function weightedHueDist(colorsA, colorsB) {
+  if (!colorsA.length || !colorsB.length) return 999;
+  let totalDist = 0, totalWeight = 0;
+  for (const a of colorsA) {
+    // 找 B 中色相最近的颜色
+    let minDist = Infinity;
+    for (const b of colorsB) {
+      const raw = Math.abs(a.h - b.h);
+      const dist = raw > 180 ? 360 - raw : raw;
+      if (dist < minDist) minDist = dist;
+    }
+    totalDist += minDist * a.weight;
+    totalWeight += a.weight;
+  }
+  return totalWeight > 0 ? totalDist / totalWeight : 999;
+}
+
+/**
+ * 计算明度 / 饱和度的加权平均差异（0–1）
+ */
+function weightedChannelDiff(colorsA, colorsB, channel) {
+  if (!colorsA.length || !colorsB.length) return 1;
+  const avgA = colorsA.reduce((s, c) => s + c[channel] * c.weight, 0) /
+               colorsA.reduce((s, c) => s + c.weight, 0);
+  const avgB = colorsB.reduce((s, c) => s + c[channel] * c.weight, 0) /
+               colorsB.reduce((s, c) => s + c.weight, 0);
+  return Math.abs(avgA - avgB);
+}
+
+/**
+ * 综合一致性评分 1–5
+ *
+ * 评分规则（与 playcraft-style-qa Micro-Batch 标准对齐）：
+ *   色相距离 < 15°  且 明度/饱和度差 < 0.10  → 5 分
+ *   色相距离 < 20°  且 明度/饱和度差 < 0.15  → 4 分
+ *   色相距离 < 30°  且 明度/饱和度差 < 0.20  → 3 分（勉强可接受）
+ *   色相距离 < 45°  且 明度/饱和度差 < 0.30  → 2 分（需调整）
+ *   其他                                       → 1 分（停止，提问 Designer）
+ */
+function calcScore(hueDist, lightDiff, satDiff) {
+  const channelOk = Math.max(lightDiff, satDiff);
+  if (hueDist < 15 && channelOk < 0.10) return 5;
+  if (hueDist < 20 && channelOk < 0.15) return 4;
+  if (hueDist < 30 && channelOk < 0.20) return 3;
+  if (hueDist < 45 && channelOk < 0.30) return 2;
+  return 1;
+}
+
+function scoreLabel(score) {
+  if (score >= 4) return '✅ 良好';
+  if (score >= 3) return '⚠️  可接受';
+  return '❌ 偏差过大，需停止';
+}
+
+function hueLabel(dist) {
+  if (dist < 15) return '✅ 优秀（< 15°）';
+  if (dist < 30) return '⚠️  偏差（< 30°）';
+  return '❌ 严重偏差（≥ 30°）';
+}
+
+function channelLabel(diff) {
+  if (diff < 0.10) return '✅ 优秀（< 0.10）';
+  if (diff < 0.20) return '⚠️  偏差（< 0.20）';
+  return '❌ 严重偏差（≥ 0.20）';
+}
+
+// ─── MAIN ─────────────────────────────────────────────────────────────────────
+
+async function main() {
+  const logDir = path.dirname(CONFIG.logFile);
+  if (!existsSync(logDir)) mkdirSync(logDir, { recursive: true });
+
+  const refPath = CONFIG.referenceImage;
+  if (!existsSync(refPath)) {
+    console.error(`[ERROR] 参考图不存在: ${refPath}`);
+    process.exit(1);
+  }
+
+  console.log(`\n📊 色彩风格一致性检查`);
+  console.log(`   参考图: ${refPath}\n`);
+
+  const refColors = extractDominantColors(refPath);
+  if (!refColors.length) {
+    console.error('[ERROR] 无法从参考图提取颜色，请确认 playcraft image info 可用');
+    process.exit(1);
+  }
+
+  // 收集目标文件
+  let targets = [];
+  try {
+    const { readdirSync } = await import('fs');
+    targets = readdirSync(CONFIG.targetDir)
+      .filter(f => f.endsWith(CONFIG.targetGlob))
+      .filter(f => !CONFIG.excludeKeywords.some(kw => f.includes(kw)))
+      .map(f => path.join(CONFIG.targetDir, f));
+  } catch {
+    console.error(`[ERROR] 无法读取目录: ${CONFIG.targetDir}`);
+    process.exit(1);
+  }
+
+  if (!targets.length) {
+    console.log('  未找到需要检查的目标文件');
+    return;
+  }
+
+  const results = [];
+  let failCount = 0;
+
+  for (const target of targets) {
+    const targetColors = extractDominantColors(target);
+    if (!targetColors.length) {
+      console.log(`  [SKIP] ${path.basename(target)} — 无法提取颜色`);
+      continue;
+    }
+
+    const hueDist  = weightedHueDist(refColors, targetColors);
+    const lightDiff = weightedChannelDiff(refColors, targetColors, 'l');
+    const satDiff   = weightedChannelDiff(refColors, targetColors, 's');
+    const score     = calcScore(hueDist, lightDiff, satDiff);
+
+    if (score < CONFIG.warnThreshold) failCount++;
+
+    const line = [
+      `[COMPARE] ${path.basename(refPath)}  vs  ${path.basename(target)}`,
+      `  色相距离（加权）: ${hueDist.toFixed(1)}°     → ${hueLabel(hueDist)}`,
+      `  明度差异:         ${lightDiff.toFixed(2)}     → ${channelLabel(lightDiff)}`,
+      `  饱和度差异:       ${satDiff.toFixed(2)}     → ${channelLabel(satDiff)}`,
+      `  综合一致性评分:   ${score} / 5  → ${scoreLabel(score)}`,
+      '',
+    ].join('\n');
+
+    console.log(line);
+    results.push({ file: path.basename(target), score, hueDist, lightDiff, satDiff });
+  }
+
+  // 汇总
+  const avgScore = results.reduce((s, r) => s + r.score, 0) / (results.length || 1);
+  const summary = [
+    `=== 汇总 ===`,
+    `  检查文件数: ${results.length}`,
+    `  平均评分:   ${avgScore.toFixed(1)} / 5`,
+    `  低于阈值数: ${failCount}（阈值 ${CONFIG.warnThreshold}）`,
+    failCount > 0
+      ? `  ⚠️  建议：停止低分文件类型的批量生产，调整生成参数或向 Designer 提问 ICP`
+      : `  ✅  全部通过，可继续批量生产`,
+    '',
+  ].join('\n');
+
+  console.log(summary);
+
+  // 写日志
+  const timestamp = new Date().toISOString();
+  appendFileSync(CONFIG.logFile, `\n[${timestamp}]\n${results.map(r =>
+    `${r.file}: score=${r.score} hue=${r.hueDist.toFixed(1)}° L=${r.lightDiff.toFixed(2)} S=${r.satDiff.toFixed(2)}`
+  ).join('\n')}\n${summary}`);
+
+  if (failCount > 0) process.exit(1);
+}
+
+main().catch(e => { console.error(e); process.exit(1); });

package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs

@@ -0,0 +1,235 @@
+// ============================================================
+// gen-batch-sprite.template.mjs — gpt-image-2 精灵图直出脚本模板
+//
+// 核心原则：让 gpt-image-2 一次 API 调用直接生成包含多个元素的
+// 网格精灵图，然后用 sprite-split 切分。比逐个生成效率高 N 倍。
+//
+// 适用场景：
+//   - 卡牌（扑克/麻将/游戏卡）：一批 13 张以内
+//   - 图标集：一批 9-16 张以内
+//   - 数字/字母贴图：一批 ≤16 个
+//
+// 使用方式：
+//   1. cp .claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs ta-workspace/scripts/gen-<name>-sprite.mjs
+//   2. 修改下方 CONFIG 和 BATCHES 区域
+//   3. node ta-workspace/scripts/gen-<name>-sprite.mjs
+// ============================================================
+
+import { execSync } from 'child_process';
+import { existsSync, mkdirSync, appendFileSync } from 'fs';
+
+// ============ CONFIG — 修改这里 ============
+const CONFIG = {
+  /**
+   * 精灵图直出模型：永远用 gpt-image-2（图像理解 + 布局能力最强）
+   * mulerouter 质量更高（建议作为主模型），iegg 更快（备用）
+   * 注意：精灵图生成比单图慢，通常需要 90-150s，timeout 设 240 以上
+   */
+  model: 'mulerouter/gpt-image-2',
+
+  /**
+   * 每批精灵图的列数
+   * 行数由 items.length / columns 自动计算。
+   * 推荐：每批 ≤16 个元素（如 columns=4 则每批最多 4 行），超过会出现混乱。
+   */
+  columns: 4,
+
+  /**
+   * 宽高比：根据 columns/rows 比例选择
+   * - 1:1 → 4×4 方形网格
+   * - 3:2 → 4×3 横向网格（4列3行）
+   * - 2:3 → 3×4 纵向网格（3列4行）
+   * - 16:9 → 适合宽横向布局
+   */
+  aspectRatio: '1:1',
+
+  /** 生成的精灵图输出目录 */
+  sheetDir: 'assets/gen/sheets',
+  /** sprite-split 切分后的单图输出目录 */
+  outputDir: 'assets/images/batch',
+
+  /**
+   * 通用风格描述（追加到每个批次 prompt 末尾）
+   *
+   * 元素需要透明背景（独立元素：角色/车/道具/图标）→ 绿幕策略：
+   *   style: 'flat 2D illustration, isolated on solid bright green #00FF00 background, centered, no shadow'
+   *   removeBg: true  （切分后逐帧去背景）
+   *
+   * 元素本身就是矩形（卡牌/棋子/UI 面板）→ 白底策略：
+   *   style: 'flat 2D, white background, no shadow, no drop shadow, clean edges'
+   *   removeBg: false
+   */
+  style: 'flat 2D illustration, isolated on solid bright green #00FF00 background, centered, no shadow',
+  /**
+   * 切分后是否对每帧执行 remove-background（绿幕去背景）
+   * true  → 独立元素（需透明通道）：remove-background --tolerance 25
+   * false → 卡牌/UI 面板等矩形元素：直接 resize，不去背景
+   */
+  removeBg: true,
+};
+
+// ============ DATA — 分批定义元素 ============
+// 规则：每批 ≤ CONFIG.columns × CONFIG.rows 个元素
+// 每个元素必须有 name（输出文件名）和 desc（精灵图中该格的内容描述）
+const BATCHES = [
+  {
+    sheetName: 'sheet_batch_1',
+    items: [
+      { name: 'item_01', desc: '<格 1 内容描述>' },
+      { name: 'item_02', desc: '<格 2 内容描述>' },
+      { name: 'item_03', desc: '<格 3 内容描述>' },
+      { name: 'item_04', desc: '<格 4 内容描述>' },
+      // 最多 CONFIG.columns × CONFIG.rows 个
+    ],
+  },
+  {
+    sheetName: 'sheet_batch_2',
+    items: [
+      { name: 'item_05', desc: '<格 5 内容描述>' },
+      { name: 'item_06', desc: '<格 6 内容描述>' },
+      // ...
+    ],
+  },
+  // 继续添加批次...
+];
+
+// ============ 精灵图 Prompt 构建器 ============
+/**
+ * 根据 items 列表构建精灵图网格 prompt
+ * 关键词组合让 gpt-image-2 理解"网格布局"意图
+ */
+function buildSpriteSheetPrompt(items, columns, style, removeBg) {
+  const actualRows = Math.ceil(items.length / columns);
+  const cellDescs = items.map((item, i) => {
+    const col = (i % columns) + 1;
+    const row = Math.floor(i / columns) + 1;
+    return `[Row${row},Col${col}]: ${item.desc}`;
+  }).join('; ');
+
+  // 绿幕模式强制在 prompt 里明确背景色，避免模型用白底
+  const bgInstruction = removeBg
+    ? 'Each element isolated on solid bright green #00FF00 background, no shadow, no gradient background.'
+    : 'Each element on clean white background.';
+
+  return [
+    `Sprite sheet grid layout, ${columns} columns × ${actualRows} rows.`,
+    `Each cell contains one element. Cell contents: ${cellDescs}.`,
+    bgInstruction,
+    `Grid layout, uniform cell size, equal spacing, elements perfectly centered in each cell.`,
+    `No borders between cells, no labels, no numbers on cells.`,
+    style,
+  ].join(' ');
+}
+
+// ============ LOGIC — 通常不需要修改 ============
+
+const LOG_FILE = 'ta-workspace/logs/gen-batch-sprite.log';
+mkdirSync(CONFIG.sheetDir, { recursive: true });
+mkdirSync(CONFIG.outputDir, { recursive: true });
+mkdirSync('ta-workspace/logs', { recursive: true });
+
+function log(msg) {
+  const line = `[${new Date().toISOString()}] ${msg}`;
+  console.log(line);
+  appendFileSync(LOG_FILE, line + '\n');
+}
+
+const totalElements = BATCHES.reduce((s, b) => s + b.items.length, 0);
+log(`=== Batch Sprite Generation Start ===`);
+log(`Total: ${BATCHES.length} batches, ${totalElements} elements`);
+log(`Model: ${CONFIG.model}`);
+
+let doneBatches = 0, failedBatches = 0;
+
+for (let bi = 0; bi < BATCHES.length; bi++) {
+  const batch = BATCHES[bi];
+  const sheetPath = `${CONFIG.sheetDir}/${batch.sheetName}.png`;
+
+  // ── Step 1: 生成精灵图（幂等跳过）────────────────────────────────
+  if (existsSync(sheetPath)) {
+    log(`[SKIP-SHEET] (${bi + 1}/${BATCHES.length}) ${batch.sheetName} already exists`);
+  } else {
+    log(`[GEN-SHEET ] (${bi + 1}/${BATCHES.length}) Generating ${batch.sheetName} (${batch.items.length} elements)`);
+    const prompt = buildSpriteSheetPrompt(batch.items, CONFIG.columns, CONFIG.style, CONFIG.removeBg);
+    const promptEscaped = prompt.replace(/"/g, '\\"');
+
+    const cmd =
+      `playcraft tools generate-image` +
+      ` --prompt "${promptEscaped}"` +
+      ` --output "${sheetPath}"` +
+      ` --aspect-ratio ${CONFIG.aspectRatio}` +
+      ` --image-model "${CONFIG.model}"` +
+      ` --timeout 240`;
+
+    try {
+      execSync(cmd, { stdio: 'inherit', timeout: 300_000 });
+      log(`[OK-SHEET  ] ${batch.sheetName}`);
+    } catch (e) {
+      log(`[FAIL-SHEET] ${batch.sheetName}: ${e.message?.slice(0, 200)}`);
+      failedBatches++;
+      continue;
+    }
+  }
+
+  // ── Step 2: sprite-split 切分精灵图 ──────────────────────────────
+  const actualRows = Math.ceil(batch.items.length / CONFIG.columns);
+  // 检查第一个切分结果是否已存在（幂等）
+  const firstItemPath = `${CONFIG.outputDir}/${batch.items[0]?.name}.png`;
+  if (batch.items[0] && existsSync(firstItemPath)) {
+    log(`[SKIP-SPLIT] ${batch.sheetName} already split`);
+    doneBatches++;
+    continue;
+  }
+
+  log(`[SPLIT     ] Splitting ${batch.sheetName} (${CONFIG.columns}×${actualRows})`);
+  const splitCmd =
+    `playcraft image sprite-split` +
+    ` --input "${sheetPath}"` +
+    ` --output-dir "ta-workspace/tmp/${batch.sheetName}"` +
+    ` --rows ${actualRows}` +
+    ` --columns ${CONFIG.columns}`;
+
+  try {
+    execSync(splitCmd, { stdio: 'inherit' });
+  } catch (e) {
+    log(`[FAIL-SPLIT] ${batch.sheetName}: ${e.message?.slice(0, 200)}`);
+    failedBatches++;
+    continue;
+  }
+
+  // ── Step 3: 重命名（+可选绿幕去背景）切分结果到最终位置 ─────────
+  log(`[RENAME    ] Renaming ${batch.items.length} cells${CONFIG.removeBg ? ' + remove-background' : ''}`);
+  for (let j = 0; j < batch.items.length; j++) {
+    const item = batch.items[j];
+    const row = Math.floor(j / CONFIG.columns);
+    const col = j % CONFIG.columns;
+    // sprite-split 默认命名：frame_r{row}_c{col}.png（0-indexed）
+    const srcPath = `ta-workspace/tmp/${batch.sheetName}/frame_r${row}_c${col}.png`;
+    const dstPath = `${CONFIG.outputDir}/${item.name}.png`;
+
+    if (!existsSync(srcPath)) {
+      log(`[WARN] Expected cell not found: ${srcPath} (index ${j} out of ${batch.items.length})`);
+      continue;
+    }
+    try {
+      if (CONFIG.removeBg) {
+        // 绿幕去背景（tolerance 25 适合纯绿色 #00FF00 背景）
+        execSync(`playcraft image remove-background --input "${srcPath}" --output "${dstPath}" --tolerance 25`);
+      } else {
+        execSync(`cp "${srcPath}" "${dstPath}"`);
+      }
+    } catch (e) {
+      log(`[WARN] Failed to process ${srcPath} → ${dstPath}: ${e.message?.slice(0, 80)}`);
+    }
+  }
+
+  log(`[OK-BATCH  ] (${bi + 1}/${BATCHES.length}) ${batch.sheetName} → ${batch.items.length} files`);
+  doneBatches++;
+}
+
+log(`\n=== Complete: Done=${doneBatches} Failed=${failedBatches}/${BATCHES.length} batches ===`);
+log(`Output: ${CONFIG.outputDir}`);
+if (failedBatches > 0) {
+  log('Re-run to retry failed batches (successful batches will be skipped)');
+  process.exit(1);
+}

package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs

@@ -0,0 +1,97 @@
+// ============================================================
+// gen-batch.template.mjs — 批量 AI 生图脚本模板
+// 用途：从零批量生成一组风格一致的素材（reference-image 模式）
+//
+// 使用方式：
+//   1. cp .claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs ta-workspace/scripts/gen-<name>.mjs
+//   2. 修改下方 CONFIG 和 ITEMS 区域
+//   3. node ta-workspace/scripts/gen-<name>.mjs
+// ============================================================
+
+import { execSync } from 'child_process';
+import { existsSync, mkdirSync, appendFileSync } from 'fs';
+
+// ============ CONFIG — 修改这里 ============
+const CONFIG = {
+  /**
+   * 生图模型。
+   * - Phase 1 概念图（追求质量）：用 gpt-image-2
+   *   model: 'iegg-litellm/gpt-image-2'
+   * - Phase 2 批量（reference-image 一致性）：用 google/，更稳定
+   *   model: 'google/gemini-3.1-flash-image-preview'
+   *
+   * 后端按优先级自动 fallback 多个 provider，无需手动指定 provider。
+   * text+image CAPABILITY 的模型才支持 --reference-image
+   */
+  model: 'google/gemini-3.1-flash-image-preview',
+  /** 概念图路径（确认过风格的样本，所有后续图的参考来源） */
+  referenceImage: 'assets/images/concept/approved_sample.png',
+  /** 输出目录 */
+  outputDir: 'assets/images/batch',
+  /** 图片比例 */
+  aspectRatio: '1:1',
+  /**
+   * 统一风格描述（从 design-brief.md 复制，粘贴到每个 prompt 末尾）
+   * 示例："flat 2D icon, vibrant colors, clean edges, white background, no shadow"
+   */
+  style: '<从 design-brief 复制的统一风格描述>',
+};
+// ============ DATA — 定义要生成的素材列表 ============
+const ITEMS = [
+  { name: 'item_01', desc: '<素材描述 1>' },
+  { name: 'item_02', desc: '<素材描述 2>' },
+  // 继续添加...
+];
+// ============ LOGIC — 通常不需要修改 ============
+
+const LOG_FILE = 'ta-workspace/logs/gen-batch.log';
+mkdirSync(CONFIG.outputDir, { recursive: true });
+mkdirSync('ta-workspace/logs', { recursive: true });
+
+function log(msg) {
+  const line = `[${new Date().toISOString()}] ${msg}`;
+  console.log(line);
+  appendFileSync(LOG_FILE, line + '\n');
+}
+
+log(`=== Batch Generation Start ===`);
+log(`Total: ${ITEMS.length} | Model: ${CONFIG.model}`);
+
+let done = 0, skipped = 0, failed = 0;
+const failures = [];
+
+for (let i = 0; i < ITEMS.length; i++) {
+  const item = ITEMS[i];
+  const outPath = `${CONFIG.outputDir}/${item.name}.png`;
+
+  if (existsSync(outPath)) {
+    log(`[SKIP] (${i + 1}/${ITEMS.length}) ${item.name}`);
+    skipped++;
+    continue;
+  }
+
+  log(`[GEN ] (${i + 1}/${ITEMS.length}) ${item.name}`);
+
+  const promptEscaped = `${item.desc}. ${CONFIG.style}`.replace(/"/g, '\\"');
+  const cmd =
+    `playcraft tools generate-image` +
+    ` --prompt "${promptEscaped}"` +
+    ` --output "${outPath}"` +
+    ` --aspect-ratio ${CONFIG.aspectRatio}` +
+    ` --reference-image "${CONFIG.referenceImage}"` +
+    ` --image-model "${CONFIG.model}"`;
+
+  try {
+    execSync(cmd, { stdio: 'inherit', timeout: 120_000 });
+    done++;
+    log(`[OK  ] ${item.name}`);
+  } catch (e) {
+    log(`[FAIL] ${item.name}: ${e.message?.slice(0, 100)}`);
+    failures.push(item.name);
+    failed++;
+  }
+}
+
+log(`\n=== Complete: Done=${done} Skipped=${skipped} Failed=${failed}/${ITEMS.length} ===`);
+if (failures.length > 0) log(`Failed: ${failures.join(', ')}`);
+if (failed > 0) process.exit(1);