@playcraft/cli 0.1.40-beta → 0.1.41-prod

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

@@ -1,324 +0,0 @@
-// ============================================================
-// 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 { 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 = {
-  /**
-   * 精灵图直出模型：永远用 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,
-
-  /**
-   * 切分单元尺寸（像素）。留空（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
- * 关键词组合让 gpt-image-2 理解"网格布局"意图
- */
-/**
- * 读取精灵图实际像素尺寸（用于自动推导切分单元尺寸）。
- * 失败返回 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, 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);
-
-    try {
-      playcraft(
-        [
-          'tools', 'generate-image',
-          '--prompt', prompt,
-          '--output', sheetPath,
-          '--aspect-ratio', CONFIG.aspectRatio,
-          '--image-model', CONFIG.model,
-          '--timeout', '240',
-        ],
-        { 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;
-  }
-
-  // 切分单元尺寸：优先用 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，否则下游会拿到缺图的资产集。
-  log(`[RENAME    ] Renaming ${batch.items.length} cells${CONFIG.removeBg ? ' + 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 (CONFIG.removeBg) {
-        // 绿幕去背景（tolerance 25 适合纯绿色 #00FF00 背景）
-        playcraft([
-          'image', 'remove-background',
-          '--input', srcPath,
-          '--output', dstPath,
-          '--tolerance', '25',
-        ]);
-      } 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,97 +0,0 @@
-// ============================================================
-// 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);

package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs

@@ -1,118 +0,0 @@
-// ============================================================
-// gen-edit-variants.template.mjs — 基图 + Edit 模型生成变体脚本模板
-// 用途：先用高质量模型生成 1 张完美基图，再用 edit 模型批量修改出一组变体
-//
-// 适用场景：结构相同、只改局部的变体集合
-//   - 扑克牌（换花色/换数字）
-//   - 棋子系列（换颜色/换图案）
-//   - 图标集（换内容符号）
-//
-// 使用方式：
-//   1. cp .claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs ta-workspace/scripts/gen-<name>-variants.mjs
-//   2. Phase 1：先手动生成基图（见下方说明），存为 CONFIG.baseImage 路径
-//   3. 填写 CONFIG 和 VARIANTS，然后 node ta-workspace/scripts/gen-<name>-variants.mjs
-//
-// Edit 模型决策（按优先级）：
-//   1. mulerouter/qwen-image-edit-max — 纯 edit，局部修改能力最强
-//   2. mulerouter/gpt-image-2         — 有图走 /edit 端点，质量高
-//   3. mulerouter/wan2.6-image        — 图生图，回退选项
-// ============================================================
-
-import { execSync } from 'child_process';
-import { existsSync, mkdirSync, appendFileSync } from 'fs';
-
-// ============ CONFIG — 修改这里 ============
-const CONFIG = {
-  /**
-   * Phase 1 基图路径（必须已存在）
-   * 生成基图的命令示例（gpt-image-2 质量最高，双 provider 回退）：
-   *   playcraft tools generate-image \
-   *     --prompt "A playing card: Ace of Spades. [完整风格描述]" \
-   *     --output assets/images/cards/base_ace_spades.png \
-   *     --aspect-ratio 3:4 \
-   *     --image-model iegg-litellm/gpt-image-2
-   */
-  baseImage: 'assets/images/cards/base_ace_spades.png',
-  /** Edit 模型（qwen-image-edit-max 局部修改能力最强） */
-  editModel: 'mulerouter/qwen-image-edit-max',
-  /** 输出目录 */
-  outputDir: 'assets/images/cards',
-  /** 图片比例（建议与基图相同） */
-  aspectRatio: '3:4',
-};
-// ============ DATA — 定义要生成的变体列表 ============
-// editPrompt 应该描述"修改指令"而不是"完整重新描述"
-// 好的写法：'Change the rank symbol from A to 2, show two spade symbols in center'
-// 差的写法：'A playing card with two spade symbols...'（这是重新生成，不是编辑）
-const VARIANTS = [
-  {
-    name: 'spades_2',
-    editPrompt: 'Change the rank symbol from A to 2. Show two spade suit symbols in center.',
-  },
-  {
-    name: 'spades_3',
-    editPrompt: 'Change the rank symbol from A to 3. Show three spade suit symbols in center.',
-  },
-  // 继续添加变体...
-];
-// ============ LOGIC — 通常不需要修改 ============
-
-const LOG_FILE = 'ta-workspace/logs/gen-edit-variants.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');
-}
-
-// 检查基图
-if (!existsSync(CONFIG.baseImage)) {
-  log(`ERROR: Base image not found: ${CONFIG.baseImage}`);
-  log(`Please generate the base image first (Phase 1), then run this script.`);
-  process.exit(1);
-}
-
-log(`=== Edit Variants Start ===`);
-log(`Base: ${CONFIG.baseImage} | Model: ${CONFIG.editModel}`);
-log(`Total variants: ${VARIANTS.length}`);
-
-let done = 0, skipped = 0, failed = 0;
-const failures = [];
-
-for (let i = 0; i < VARIANTS.length; i++) {
-  const variant = VARIANTS[i];
-  const outPath = `${CONFIG.outputDir}/${variant.name}.png`;
-
-  if (existsSync(outPath)) {
-    log(`[SKIP] (${i + 1}/${VARIANTS.length}) ${variant.name}`);
-    skipped++;
-    continue;
-  }
-
-  log(`[EDIT] (${i + 1}/${VARIANTS.length}) ${variant.name}: ${variant.editPrompt.slice(0, 60)}...`);
-
-  const promptEscaped = variant.editPrompt.replace(/"/g, '\\"');
-  const cmd =
-    `playcraft tools generate-image` +
-    ` --prompt "${promptEscaped}"` +
-    ` --output "${outPath}"` +
-    ` --aspect-ratio ${CONFIG.aspectRatio}` +
-    ` --reference-image "${CONFIG.baseImage}"` +
-    ` --image-model "${CONFIG.editModel}"`;
-
-  try {
-    execSync(cmd, { stdio: 'inherit', timeout: 120_000 });
-    done++;
-    log(`[OK  ] ${variant.name}`);
-  } catch (e) {
-    log(`[FAIL] ${variant.name}: ${e.message?.slice(0, 100)}`);
-    failures.push(variant.name);
-    failed++;
-  }
-}
-
-log(`\n=== Complete: Done=${done} Skipped=${skipped} Failed=${failed}/${VARIANTS.length} ===`);
-if (failures.length > 0) log(`Failed: ${failures.join(', ')}`);
-if (failed > 0) process.exit(1);

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

@@ -1,137 +0,0 @@
-// ============================================================
-// process-batch.template.mjs — 批量图片处理脚本模板
-// 用途：对一批图片执行去背景 / trim + resize + 验证
-//
-// 使用方式：
-//   1. cp .claude/skills/playcraft-image-generation/reference/process-batch.template.mjs ta-workspace/scripts/process-<name>.mjs
-//   2. 修改下方 CONFIG 区域（特别是 SKIP_REMOVE_BG 选项）
-//   3. node ta-workspace/scripts/process-<name>.mjs
-//
-// 背景处理决策（修改 CONFIG.skipRemoveBg 前请阅读）：
-//   - 独立元素（角色/道具/图标）需透明背景 → skipRemoveBg = false（默认）
-//     建议生图时 prompt 加 "on solid bright green #00FF00 background, isolated"
-//   - 卡牌/棋子/UI面板（矩形本体不需透明）→ skipRemoveBg = true
-//     生图时 prompt 加 "flat 2D, no shadow, no 3D effect, clean edges"
-// ============================================================
-
-import { execSync } from 'child_process';
-import { readdirSync, existsSync, mkdirSync, appendFileSync, unlinkSync } from 'fs';
-import { join, basename, extname } from 'path';
-
-// ============ CONFIG — 修改这里 ============
-const CONFIG = {
-  /** 输入目录（gen-batch 的输出目录） */
-  inputDir: 'assets/images/batch',
-  /** 输出目录 */
-  outputDir: 'assets/images/processed',
-  /** 临时文件目录（去背景中间结果） */
-  tmpDir: 'ta-workspace/tmp',
-  /** 目标宽度（像素） */
-  targetW: 128,
-  /** 目标高度（像素） */
-  targetH: 128,
-  /**
-   * 跳过去背景步骤
-   * - false（默认）：执行 remove-background（绿幕素材/独立元素）
-   * - true：跳过，只做 trim + resize（卡牌/棋子等矩形本体素材）
-   */
-  skipRemoveBg: false,
-  /**
-   * floodfill 容差（0–255）
-   * 绿幕背景建议 25；默认白背景可用 15
-   * 仅在 skipRemoveBg = false 时生效
-   */
-  removeBgTolerance: 25,
-  /** resize 时的 fit 模式：contain / cover / fill / inside / outside */
-  resizeFit: 'contain',
-};
-// ============ LOGIC — 通常不需要修改 ============
-
-const LOG_FILE = 'ta-workspace/logs/process-batch.log';
-mkdirSync(CONFIG.outputDir, { recursive: true });
-mkdirSync(CONFIG.tmpDir, { 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 SUPPORTED_EXTS = new Set(['.png', '.jpg', '.jpeg', '.webp']);
-const files = readdirSync(CONFIG.inputDir)
-  .filter(f => SUPPORTED_EXTS.has(extname(f).toLowerCase()))
-  .sort()
-  .map(f => join(CONFIG.inputDir, f));
-
-log(`=== Batch Processing Start ===`);
-log(`Files: ${files.length} | skipRemoveBg: ${CONFIG.skipRemoveBg} | Target: ${CONFIG.targetW}x${CONFIG.targetH}`);
-
-let done = 0, skipped = 0, failed = 0;
-const failures = [];
-
-for (let i = 0; i < files.length; i++) {
-  const inputPath = files[i];
-  const name = basename(inputPath, extname(inputPath));
-  const outPath = join(CONFIG.outputDir, `${name}.png`);
-
-  if (existsSync(outPath)) {
-    log(`[SKIP] (${i + 1}/${files.length}) ${name}`);
-    skipped++;
-    continue;
-  }
-
-  log(`[PROC] (${i + 1}/${files.length}) ${name}`);
-
-  try {
-    if (CONFIG.skipRemoveBg) {
-      // 卡牌/棋子等矩形本体：直接 resize（不需要去背景）
-      execSync(
-        `playcraft image resize` +
-        ` --input "${inputPath}"` +
-        ` --output "${outPath}"` +
-        ` --width ${CONFIG.targetW}` +
-        ` --height ${CONFIG.targetH}` +
-        ` --fit ${CONFIG.resizeFit}`,
-        { stdio: 'inherit' },
-      );
-    } else {
-      // 独立元素：先去背景，再 resize
-      const tmpNobg = join(CONFIG.tmpDir, `${name}_nobg.png`);
-
-      // 步骤 1：去背景（绿幕 tolerance=25 效果最好）
-      execSync(
-        `playcraft image remove-background` +
-        ` --input "${inputPath}"` +
-        ` --output "${tmpNobg}"` +
-        ` --tolerance ${CONFIG.removeBgTolerance}`,
-        { stdio: 'inherit' },
-      );
-
-      // 步骤 2：resize 到目标尺寸
-      execSync(
-        `playcraft image resize` +
-        ` --input "${tmpNobg}"` +
-        ` --output "${outPath}"` +
-        ` --width ${CONFIG.targetW}` +
-        ` --height ${CONFIG.targetH}` +
-        ` --fit ${CONFIG.resizeFit}`,
-        { stdio: 'inherit' },
-      );
-
-      // 清理临时文件
-      if (existsSync(tmpNobg)) unlinkSync(tmpNobg);
-    }
-
-    log(`[OK  ] ${name}`);
-    done++;
-  } catch (e) {
-    log(`[FAIL] ${name}: ${e.message?.slice(0, 100)}`);
-    failures.push(name);
-    failed++;
-  }
-}
-
-log(`\n=== Complete: Done=${done} Skipped=${skipped} Failed=${failed}/${files.length} ===`);
-if (failures.length > 0) log(`Failed: ${failures.join(', ')}`);
-if (failed > 0) process.exit(1);