@playcraft/cli 0.1.53-beta → 0.1.54

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

@@ -1,254 +0,0 @@
-/**
- * compare-style.template.mjs
- *
- * 色彩风格一致性定量检查脚本。
- * 用途：TA Micro-Batch Validation 辅助工具，对 AI 补全素材与 Artist 样本做客观色彩比较。
- *
- * 使用方法：
- *   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 = {
-  /** Artist 样本图（风格基准） */
-  referenceImage: 'assets/images/tiles/tile_sample_1.png',
-
-  /** 要检查的 TA 补全素材目录或文件列表 */
-  targetDir: 'assets/images/tiles',
-
-  /** 只检查该目录下的哪些文件（glob 后缀匹配） */
-  targetGlob: '.png',
-
-  /** 排除文件名包含这些关键词的文件（Artist 样本自身） */
-  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 分（停止，提问 Artist）
- */
-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
-      ? `  ⚠️  建议：停止低分文件类型的批量生产，调整生成参数或向 Artist 提问 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-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs

@@ -1,333 +0,0 @@
-// ============================================================
-// gen-batch-sprite.template.mjs — 精灵图直出脚本模板
-//
-// 核心原则：一次 API (Application Programming Interface, 应用程序编程接口) 调用生成包含多个元素的
-// 网格精灵图，然后用 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 { execFileSync } from 'child_process';
-import { existsSync, mkdirSync, appendFileSync, copyFileSync } from 'fs';
-
-/**
- * Run the `playcraft` CLI with an argv ARRAY (never a shell string), so prompts
- * and paths containing $(), backticks, quotes, spaces, backslashes, etc. are
- * passed verbatim and cannot be reinterpreted by a shell.
- *   - capture:true → returns stdout (utf8); otherwise inherits stdio.
- */
-function playcraft(args, { capture = false, timeout } = {}) {
-  return execFileSync('playcraft', args, {
-    ...(capture ? { encoding: 'utf8' } : { stdio: 'inherit' }),
-    ...(timeout ? { timeout } : {}),
-  });
-}
-
-// ============ CONFIG — 修改这里 ============
-const CONFIG = {
-  /**
-   * 使用 list-image-models 核实本次模型；默认示例为 Image 2.5。
-   * 用户或制作流程锁定其他模型时填写实际 provider/model。
-   * 请求使用命令行默认等待时间，不在脚本中提前杀死仍在运行的请求。
-   */
-  model: 'iegg-litellm/gpt-image-2.5-sunburst',
-
-  /**
-   * 每批精灵图的列数
-   * 行数由 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 末尾）
-   *
-   * 只填写主体风格与构图，源图背景由下方流程选择。
-   * 卡牌白色牌面属于主体，应在 items.desc 中描述并设 removeBg=false。
-   */
-  style: 'flat 2D illustration, isolated subjects, centered, no shadow',
-  /**
-   * 最终是否需要透明：true 为独立元素，false 为不透明牌面/场景。
-   * automatic：整板由工具交付透明，切分后保留，不重复去背。
-   * chroma：保留色幕中间图，切分后逐格去背；仅限主文第 3 节明确选择的流程。
-   */
-  removeBg: true,
-  backgroundMode: 'automatic',
-  /** 独立色幕才使用；按主体颜色选择，金/黄/橙/绿用蓝幕，蓝/紫用绿幕。 */
-  chromaColor: '#00FF00',
-  chromaTolerance: 25,
-
-  /**
-   * 切分单元尺寸（像素）。留空（null）= 自动按精灵图实际像素尺寸 ÷ 网格推导（推荐）。
-   * 仅当模型输出的格子并非均匀均分、需要手动指定时才填写。
-   * ⚠️ 不要写死 256：4K 精灵图按 256 切分会严重错位。
-   */
-  cellWidth: null,
-  cellHeight: null,
-  /** 帧间距（像素），默认 0 */
-  padding: 0,
-};
-
-// ============ 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
- * 描述网格布局，避免重绘边框或格子标签。
- */
-/**
- * 读取精灵图实际像素尺寸（用于自动推导切分单元尺寸）。
- * 失败返回 null，由调用方决定是否中止该批次。
- */
-function readSheetDims(sheetPath) {
-  try {
-    const out = playcraft(['image', 'info', '--input', sheetPath, '--json'], { capture: true });
-    const meta = JSON.parse(out.slice(out.indexOf('{')));
-    if (typeof meta.width === 'number' && typeof meta.height === 'number') {
-      return { width: meta.width, height: meta.height };
-    }
-  } catch {
-    // fall through → null
-  }
-  return null;
-}
-
-function buildSpriteSheetPrompt(items, columns, config) {
-  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('; ');
-
-  // Image 2.5 由后端组装背景；其他模型首次请求需明确单一干净底色。
-  const modelId = config.model.trim().split('/').at(-1);
-  const nativeBackground = /^gpt-image-2\.5(?:$|-)/.test(modelId);
-  const bgInstruction = !config.removeBg ? '' : config.backgroundMode === 'chroma'
-    ? `Each element isolated on a uniform solid ${config.chromaColor} background, no shadow, no gradient background.`
-    : nativeBackground ? ''
-      : 'Render all foreground elements on a uniform solid pure white background for subsequent background removal. Preserve all elements, text, white details, colors and style.';
-
-  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.`,
-    config.style,
-  ].filter(Boolean).join(' ');
-}
-
-// ============ LOGIC — 通常不需要修改 ============
-
-const LOG_FILE = 'ta-workspace/logs/gen-batch-sprite.log';
-if (!['automatic', 'chroma'].includes(CONFIG.backgroundMode)) {
-  throw new Error('backgroundMode must be automatic or chroma.');
-}
-if (CONFIG.backgroundMode === 'chroma' && !/^#[\da-f]{6}$/i.test(CONFIG.chromaColor)) {
-  throw new Error('chromaColor must be one six-digit hex color.');
-}
-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);
-
-    try {
-      playcraft(
-        [
-          'tools', 'generate-image',
-          '--prompt', prompt,
-          '--output', sheetPath,
-          '--aspect-ratio', CONFIG.aspectRatio,
-          '--image-model', CONFIG.model,
-          CONFIG.removeBg && CONFIG.backgroundMode === 'automatic'
-            ? '--remove-background' : '--no-remove-background',
-        ],
-      );
-      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;
-  }
-
-  // 切分单元尺寸：优先用 CONFIG 显式值；否则按精灵图实际像素尺寸 ÷ 网格自动推导。
-  // ⚠️ 绝不写死 256——4K 精灵图按 256 切分会严重错位（test11 类事故）。
-  const padding = CONFIG.padding ?? 0;
-  let cellWidth = CONFIG.cellWidth;
-  let cellHeight = CONFIG.cellHeight;
-  if (cellWidth == null || cellHeight == null) {
-    const dims = readSheetDims(sheetPath);
-    if (!dims) {
-      log(
-        `[FAIL-SPLIT] ${batch.sheetName}: 无法读取精灵图尺寸，请在 CONFIG 显式设置 cellWidth/cellHeight`,
-      );
-      failedBatches++;
-      continue;
-    }
-    // 去掉帧间距后按网格均分
-    cellWidth ??= Math.floor((dims.width - padding * (CONFIG.columns - 1)) / CONFIG.columns);
-    cellHeight ??= Math.floor((dims.height - padding * (actualRows - 1)) / actualRows);
-    log(
-      `[CELL-SIZE ] ${batch.sheetName}: sheet ${dims.width}×${dims.height} → cell ${cellWidth}×${cellHeight} (grid ${CONFIG.columns}×${actualRows}, padding ${padding})`,
-    );
-  }
-  if (!(cellWidth > 0 && cellHeight > 0)) {
-    log(`[FAIL-SPLIT] ${batch.sheetName}: 推导出的 cell 尺寸非法 (${cellWidth}×${cellHeight})`);
-    failedBatches++;
-    continue;
-  }
-
-  log(`[SPLIT     ] Splitting ${batch.sheetName} (${CONFIG.columns}×${actualRows}, cell ${cellWidth}×${cellHeight})`);
-  const splitDir = `ta-workspace/tmp/${batch.sheetName}`;
-
-  try {
-    playcraft([
-      'image', 'sprite-split',
-      '--input', sheetPath,
-      '--output-dir', splitDir,
-      '--rows', String(actualRows),
-      '--columns', String(CONFIG.columns),
-      '--frame-width', String(cellWidth),
-      '--frame-height', String(cellHeight),
-      '--padding', String(padding),
-    ]);
-  } catch (e) {
-    log(`[FAIL-SPLIT] ${batch.sheetName}: ${e.message?.slice(0, 200)}`);
-    failedBatches++;
-    continue;
-  }
-
-  // ── Step 3: 保留自动透明结果；独立色幕才逐格去背 ────────────────
-  // 任何缺帧 / 处理失败都视为该批次失败（FAIL，不是 WARN）：一个不完整的
-  // 批次绝不能被报成 OK-BATCH，否则下游会拿到缺图的资产集。
-  const removeCellBackground = CONFIG.removeBg && CONFIG.backgroundMode === 'chroma';
-  log(`[RENAME    ] Renaming ${batch.items.length} cells${removeCellBackground ? ' + remove-background' : ''}`);
-  let processedOk = 0;
-  let batchFailed = false;
-  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 = `${splitDir}/frame_r${row}_c${col}.png`;
-    const dstPath = `${CONFIG.outputDir}/${item.name}.png`;
-
-    if (!existsSync(srcPath)) {
-      log(`[FAIL-CELL ] Expected cell not found: ${srcPath} (item ${item.name}, index ${j}/${batch.items.length})`);
-      batchFailed = true;
-      continue;
-    }
-    try {
-      if (removeCellBackground) {
-        // 只处理独立色幕，保留常规工具已经交付的透明边缘。
-        playcraft([
-          'image', 'remove-background',
-          '--input', srcPath,
-          '--output', dstPath,
-          '--tolerance', String(CONFIG.chromaTolerance),
-        ]);
-      } else {
-        copyFileSync(srcPath, dstPath);
-      }
-      processedOk++;
-    } catch (e) {
-      log(`[FAIL-CELL ] Failed to process ${srcPath} → ${dstPath}: ${e.message?.slice(0, 120)}`);
-      batchFailed = true;
-    }
-  }
-
-  if (batchFailed) {
-    log(`[FAIL-BATCH] (${bi + 1}/${BATCHES.length}) ${batch.sheetName} → only ${processedOk}/${batch.items.length} cells OK (see FAIL-CELL above)`);
-    failedBatches++;
-  } else {
-    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-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs

@@ -1,95 +0,0 @@
-// ============================================================
-// gen-batch.template.mjs — 批量 AI (Artificial Intelligence, 人工智能) 生图脚本模板
-// 用途：从零批量生成一组风格一致的素材（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 { execFileSync } from 'child_process';
-import { existsSync, mkdirSync, appendFileSync } from 'fs';
-
-// ============ CONFIG — 修改这里 ============
-const CONFIG = {
-  /**
-   * 生图模型。
-   * 先 list-image-models，再填写本次实际模型；普通素材优先 Image 2.5。
-   * 用户或制作流程锁定其他模型时保留其选择。
-   * 参考图要求模型支持 text+image 或 image→image。
-   */
-  model: 'iegg-litellm/gpt-image-2.5-sunburst',
-  /** 概念图路径（确认过风格的样本，所有后续图的参考来源） */
-  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, no shadow"
-   */
-  style: '<从 design-brief 复制的统一风格描述>',
-  /** 最终透明设 true；完整场景或不透明牌面设 false。独立色幕使用精灵图模板。 */
-  removeBackground: true,
-};
-// ============ 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 nativeBackground = /^gpt-image-2\.5(?:$|-)/.test(CONFIG.model.trim().split('/').at(-1));
-  const sourceBackground = CONFIG.removeBackground && !nativeBackground
-    ? 'on a uniform solid pure white background for subsequent background removal' : '';
-  const prompt = [item.desc, CONFIG.style, sourceBackground].filter(Boolean).join('. ');
-  const args = ['tools', 'generate-image', '--prompt', prompt, '--output', outPath,
-    '--aspect-ratio', CONFIG.aspectRatio, '--image-model', CONFIG.model,
-    CONFIG.removeBackground ? '--remove-background' : '--no-remove-background'];
-  if (CONFIG.referenceImage) args.push('--reference-image', CONFIG.referenceImage);
-
-  try {
-    execFileSync('playcraft', args, { stdio: 'inherit' });
-    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);