generate-youtube-thumbnail

用途：这是一个可复用的工作流，通过 Arcads 的 Nano Banana 2 图像端点生成 YouTube 缩略图，并支持人物相似度对齐和经过验证的点击率（CTR）公式。适用于“帮我做一个 YouTube 缩略图”“为这个视频创建缩略图”“需要缩略图变体 / A/B 测试”“用我的脸重做这个缩略图”“生成 10 个缩略图概念”等请求。\n\n主要能力：按需求收集概念、人物、品牌素材、文字和对比素材；校验本地参考图片是否存在；按 5 种缩略图公式选择方向（品牌和平手势、真实对比 AI、终端流程、惊讶反应、前后分割）；按模板组合提示词；使用批量脚本完成图片放大、预签名上传、S3 PUT、并行生成、失败重试和资产轮询下载；生成后逐张评估相似度、可读性和情绪冲击力，并给出前 3 推荐及后续优化建议。\n\n使用方式：需要 .env 中配置 ARCADS_BASIC_AUTH 和 ARCADS_API_KEY，并提供 productId（默认取 MASTER_CONTEXT.md 中的“My workspace”产品）。参考图片必须保存在磁盘目录中，包括 face/（5 张以上人物照片）、logos/、products/、examples/、style/ 等；聊天中粘贴的图片无法被 API 使用，需用户保存为实际文件。生成前需估算成本并确认，例如“N 个变体 × 24 credits = X credits”，并提示用户在 Arcads 平台确认准确价格。随后复制 scripts/generate-batch.sh 为带版本号的脚本，更新参考路径和提示词数组，后台运行并监控日志。\n\n适用场景：单张缩略图制作、A/B 变体、面部替换、批量概念探索、品牌缩略图、真实对比 AI、前后对比等。\n\n限制与注意事项：参考图每次生成都需重新上传，复用同一 filePath 会导致 HTTP 500；图片最长边小于 1080px 会返回 422，脚本会转为 RGB、用 Lanczos 放大到 1080px 并保存为 JPEG；referenceImages 必须是字符串数组而非对象；人物相似度需要 5 张以上不同角度面部参考，否则会泛化成通用形象；品牌特定元素需提供实际文件，纯文字描述只能得到近似结果；macOS 默认 bash 3.2 不支持关联数组，脚本使用索引数组和临时文件；预签名 URL 约 10 分钟过期，长任务需重新上传。成本参考：单次生成 24 credits，6 变体 144、10 变体 240、20 变体 480，均为估算，需在 Arcads 平台确认；典型生成时间约 30–60 秒，10 个并行约 1.5–2 分钟。