paw-cra-design-batch

批量设计制作

概述

用于营销活动的批量视觉制作——将内容日历或营销活动简报转换为一套完整、可直接用于各平台的视觉素材。此工作流负责多素材制作：解析简报、建立制作队列、生成每项素材并验证品牌规范，最后交付整理好的素材包及机器可读的清单。

**参数：**接受 --headless / -H，用于无需交互的全自动批量制作。

**输出：**整理好的营销活动素材包文件夹 + batch-manifest.json，列出制作的每项素材及其规格。

激活时

从 {project-root}/.pawbytes/config/config.yaml 和 {project-root}/.pawbytes/config/config.user.yaml（根级配置和 cra 区段）加载可用配置。解析并在整个会话中应用（括号内为默认值）：

• {user_name}（null）——以用户姓名称呼用户
• {communication_language}（English）——用于所有交流
• {document_output_language}（English）——用于生成的文档内容
• {fal_key}（null）——用于图像生成的 fal.ai API 密钥
• {output_directory}（.pawbytes/creative-suites）——基础输出路径

从 {project-root}/.pawbytes/creative-suites/index.md 加载共享的代理机构记忆。从 .pawbytes/creative-suites/brands/{active-brand}/guidelines.md 加载当前品牌指南。

**知识库：**检查 {project-root}/.pawbytes/creative-suites/knowledge/index.md，查看此前调研的平台规格和设计指南。

工具验证：

• 检查 fal_key 是否可用（必需——没有它就无法进行批量制作）
• 检查 ffmpeg 是否可用（可选——仅制作动态轮播图时需要）
• 检查 Puppeteer/Playwright 是否可用（可选——用于模板渲染）

如果传入 --headless 或 -H，则无需交互即可执行完整流程。加载 ./references/autonomous-batch.md，了解无头执行协议。

否则，在开始制作前，先与用户确认简报/日历。

---

流程

批量制作流程按顺序分阶段运行。每个阶段完成后才会开始下一阶段。无头模式下，所有阶段均无需暂停即可执行。交互模式下，生成完成后会设置审核关卡，供用户批准、修改或拒绝，然后再进行最终打包。

步骤 1 — 简报接收

加载 ./references/brief-intake.md

解析收到的内容日历或营销活动简报。提取：

• 所需素材总数
• 每项素材的规格：平台、格式、尺寸、内容/文案、视觉方向
• 品牌参考（需要加载哪些品牌指南）
• 营销活动名称及任何命名规范
• 优先级或排序偏好

如果输入是内容日历，则每一行都将成为制作队列中的一项素材。如果输入是包含交付物描述的营销活动简报，则将其拆分为各项素材规格。

**输出：**可用于建立队列的结构化素材列表。

步骤 2 — 加载品牌与营销活动背景

加载指定品牌的品牌指南。加载 .pawbytes/creative-suites/brands/{brand}/campaigns/{campaign}/assets/ 中现有的营销活动素材，以了解已有内容并保持视觉一致性。

如果营销活动在 .pawbytes/creative-suites/brands/{brand}/campaigns/{campaign}/scripts/ 中有已批准的文案/脚本，则加载这些内容，用于生成素材。

**输出：**品牌背景及现有营销活动背景已加载到工作记忆中。

步骤 3 — 生产队列构建

加载 ./references/queue-builder.md

根据解析后的素材列表构建有序的生产队列。按平台和格式对素材分组，以便高效批量生成（同一平台的素材可以共享样式种子和模板）。

为每个队列项确定：

• 平台规格（尺寸、安全区域、格式）
• 模板选择（若使用基于代码的模板）
• AI 生成参数（模型、样式、种子策略）
• 文字叠加要求
• 导出格式和命名约定

采用顺序命名：{campaign}_{platform}_{type}_{NNN}.{ext}（例如：summer-sale_instagram_post_001.png）。

**输出：**包含每项素材完整规格的有序生产队列。

步骤 4 — 批量生成循环

加载 ./references/batch-generation.md

对生产队列中的每项素材：

1. 加载平台规格 — 确认尺寸、安全区域和格式要求
2. 生成 AI 图像 — 使用 fal.ai，搭配已确定的提示词和参数。根据 Designer 的 AI 模型选择指南选择模型。将所有生成的图像下载到本地路径。
3. 应用模板／文字叠加 — 如果素材使用基于代码的模板，则使用生成的背景渲染 HTML/CSS 叠加层。如果完全由 AI 生成，则通过图像编辑添加任何文字叠加。
4. 品牌验证 — 根据品牌指南检查输出：颜色、字体、Logo 位置和视觉风格是否一致。标记任何偏差。
5. 按顺序命名导出 — 使用步骤 3 中的命名约定，保存到营销活动素材文件夹。

跟踪进度：将每项已完成的素材记录到持续更新的清单中。如果某项素材生成失败，记录失败原因并继续处理下一项，不要中止整个批次。

**输出：**营销活动文件夹中的已生成素材，以及每项素材的生成日志。

步骤 5 — 整理素材包

将所有已生成的素材整理到清晰的营销活动文件夹结构中：

{output_directory}/brands/{brand}/campaigns/{campaign}/assets/batch-{date}/
  instagram/
    posts/
    carousels/
    stories/
  linkedin/
    posts/
    carousels/
  tiktok/
  x-twitter/
  facebook/
  youtube/
  print/
  batch-manifest.json

将素材从生成位置移动或复制到此整理后的结构中。确保每项素材在其平台文件夹中都有唯一的顺序文件名。

步骤 6 — 批次清单

在素材包根目录生成 batch-manifest.json。此清单是所有已生成内容的机器可读记录。

加载 ./references/manifest-schema.md 以查看完整架构。

清单包括：

• 营销活动元数据（名称、品牌、日期、素材总数）
• 每项素材的条目：文件名、平台、尺寸、格式、文件大小、生成模型、生成状态（成功／失败／跳过）、品牌验证状态
• 汇总统计：生成总数、失败总数、跳过总数、涵盖的平台

步骤 7 — 审核关卡

**交互模式：**按平台展示所有已生成素材的摘要。显示缩略图或文件路径。包含成功、失败数量以及任何品牌验证警告。请用户批准此批次、要求修改特定素材，或拒绝。

**无头模式：**完全跳过此关卡。将摘要记录到每日活动文件，然后继续更新状态。

步骤 8 — 状态更新

将完成状态写入营销活动记忆和每日日志。

**营销活动状态：**使用批量生产结果更新 .pawbytes/creative-suites/brands/{brand}/campaigns/{campaign}/status.md — 记录已生成的内容、保存位置以及任何失败。

**每日日志：**追加到 .pawbytes/creative-suites/daily/{YYYY-MM-DD}.md：

## {HH:MM} [Designer/Batch]
**Task:** Batch production — {campaign}
**Brand:** {brand}
**Produced:** {N} assets across {M} platforms
**Failed:** {F} assets
**Location:** {bundle path}
**Manifest:** {manifest path}

---

错误处理

• 缺少 fal_key： 中止批处理并给出明确提示 — 没有生成能力，无法制作素材
• 单个素材生成失败： 记录失败原因。对于暂时性错误（HTTP 429、500、502、503、504、超时），等待 5 秒后重试一次。如果重试仍然失败，则跳过该素材并继续处理下一个，在清单中将其标记为 status: "failed"，并包含错误原因和 retried: true。
• 缺少品牌指南： 发出警告并尽力生成；在清单中将所有素材标记为 brand_validated: false
• 模板渲染失败： 对该素材改用纯 AI 生成，并在清单中注明回退情况

平台规格速查

队列构建时，请参考 ./references/platform-specs-quick.md 中的精简尺寸查询表。完整规格请参考 Designer 的 platform-specifications.md。

AI 模型选择

请使用 Designer Agent 的模型选择指南。批量制作时，优先选择：

• Nano Banana Pro — 最适合带有排版文字的营销帖子
• FLUX.2 [flex] — 兼顾质量与速度，适合批量生成
• FLUX.1 [schnell] — 用于快速原型设计，或在速度比高级质量更重要的超大批次中