AI Logo Creator
基于 Together AI（FLUX.2-pro / flash-image-3.1）的品牌 Logo 生成与品牌套件导出工作流。
核心 prompt 工程移植自开源项目 Nutlope/logocreator。
功能说明
- Logo 生成：结构化参数（公司名 / 风格 / 类型 / 品牌色 / 细节级别 / 单色模式）→ 分层 prompt → 1024px PNG。
- Logo 迭代编辑：以图生图，支持换色、改排版（横向 lockup）、提取纯图标版等指令式修改。
- 品牌套件导出：四角泛洪填充抠除背景 → 提取 5 色配色方案 → 导出 favicon 全尺寸（16/32/48/180/192/512）→ 1024 社交头像 → ZIP 一键打包。
前置要求
- Together AI API Key：环境变量
TOGETHER_API_KEY，或执行时由用户粘贴。引导用户到 https://api.together.ai/ 注册获取（有免费额度）。缺少 key 时先向用户索取，不要尝试其他模型。 - Python 3.9+；仅品牌套件脚本需要 Pillow（
pip install Pillow，生成/编辑脚本只依赖标准库）。
工作流程
第 1 步：收集需求（缺什么问什么，一次问完）
| 参数 | 选项 | 默认 |
|---|---|---|
| 公司/品牌名（必填） | — | — |
| 风格 style | Minimal / Geometric / Gradient / Mascot / Hand-drawn / Luxury / Retro / 3D | Minimal |
| 类型 logo-type | icon-name 图文组合 / icon 纯图形 / wordmark 纯文字 / monogram 首字母 / emblem 徽章 / abstract 抽象 | icon-name |
| 主色 primary-color | hex（如 #2F6FF5）或 auto | auto |
| 背景色 background-color | hex 或 auto | auto |
| 细节 detail-level | Minimal / Balanced / Detailed | Balanced |
| 单色 monochrome | 开/关 | 关 |
| 补充说明 additional-info | 自由文本（行业、寓意、禁忌元素等） | 无 |
用户只给公司名时，直接用默认值生成，不要追问——先出图再迭代。
第 2 步：生成
python scripts/generate_logo.py --name "Acme" --style Minimal --logo-type icon-name \
--primary-color "#2F6FF5" --output acme-logo.png
- 模型自动路由：含文字类型走
google/flash-image-3.1，纯图形走FLUX.2-pro（guidance=7），文字类失败自动回退 FLUX。 - 加
--print-prompt可向用户展示组装好的 prompt。 - 一次生成 1 张；用户想对比时，换风格/类型批量生成多张（3–4 张为宜，提醒按张计费）。
第 3 步：迭代编辑（可选）
python scripts/edit_logo.py --image acme-logo.png \
--prompt "Recolor the icon to emerald green (#059669), keep everything else identical." \
--output acme-logo-v2.png
编辑指令用祈使句、限定修改范围（详见 references/prompt-engineering.md 末尾）。
第 4 步：导出品牌套件
python scripts/brand_kit.py --image acme-logo.png --name acme --out-dir acme-brand-kit
产出：透明底主图、favicon 六尺寸、1024 社交头像、palette.json、*-brand-kit.zip。
抠图不干净时调 --tolerance（默认 24，背景残留就加大到 32–48）。
第 5 步：交付
向用户展示生成图与套件 zip，并附 palette.json 中的配色方案。
示例
示例一：用户说"帮我给'山丘咖啡'设计个 Logo"
→ 直接执行：generate_logo.py --name "山丘咖啡" --style Minimal（全默认），出图后问是否调整并导出套件。
示例二：用户说"要一个蓝白科技感纯图标，不要文字"
→ --logo-type icon --style Geometric --primary-color "#2563EB" --background-color "#FFFFFF"。
示例三：用户说"把刚才的 Logo 改成横向排版，图标在左"
→ edit_logo.py --prompt "Rearrange into a horizontal lockup: icon on the left, company name on the right." --width 1536 --height 768。
限制说明
- 生成质量取决于模型；含文字的 logo 可能出现拼写错误，须逐字母核对，错了就用编辑接口修正或重新生成。
- 不支持直接导出 SVG（上游项目亦在路线图阶段）；需要矢量图时建议用户对透明底 PNG 做位图追踪。
- 品牌套件抠图依赖"平坦纯色背景"这一 prompt 约束；Gradient/3D 风格或模型未遵守时抠图可能残留，需调 tolerance 或手动处理。
- 编辑接口对输入图大小有限制（约 5 MB），且为图生图，无法保证像素级一致。
注意事项
- 生成/编辑均按张计费（参考约 $0.03/张），批量出图前告知用户。
- API Key 只从环境变量或用户当次输入获取，不写入任何文件。
- 中文品牌名建议同时在 additional-info 里给出英文拼写，提升文字渲染正确率。
- 详细 prompt 规则见 references/prompt-engineering.md；API 参数与错误处理见 references/together-api.md。
