Poster Forge

通用海报/图片生成器，支持 3 种渲染引擎，并具备自动降级能力。

引擎

默认模式为 auto：按顺序尝试 AI → HTML → text 降级方案。

快速开始

# 使用 AI 生成带背景的简易海报
python3 scripts/generate.py --title "你的标题" --prompt "watercolor sunset" --output poster.jpg

# 分屏对比图（使用 HTML 引擎，无需联网）
python3 scripts/generate.py --title "A vs B" --mode html --template split 
  --left-label "方案A" --right-label "方案B" 
  --left-items "优点1|优点2" --right-items "优点1|优点2" --output compare.jpg

# 教程卡片
python3 scripts/generate.py --title "教程标题" --mode html --template tutorial 
  --code-content "print('hello')" --tagline "底部提示语" --output tutorial.jpg

参数说明

核心参数

• --title（必需）：主标题
• --subtitle：副标题
• --tagline：底部标语
• --mode：ai | html | text | auto（默认值：auto）
• --output：输出文件路径

模板参数（仅 HTML 引擎生效）

• --template：split | gradient | card | tutorial

尺寸预设

• --preset：xiaohongshu（1080×1440）| wechat（900×500）| instagram（1080×1080）| twitter（1200×675）| a4（2480×3508）
• --width / --height：自定义宽高

分屏模板（split template）专用参数

• --left-label / --right-label：左右两侧标签
• --left-items / --right-items：以竖线（|）分隔的内容项
• --left-color / --right-color：RGB 颜色值，格式为 R,G,B

文字叠加参数

• --text-position：bottom | center | top | none
• --font-title-size / --font-sub-size：标题与副标题字体大小
• --no-overlay：跳过 PIL 文字叠加（适用于 HTML 模板已内置文字的情况）

AI 引擎参数

• --prompt：向 Pollinations.ai 提交的英文描述（用于生成图像）

面向 Agent 的工作流

1. 确定内容与视觉风格
2. 选择渲染模式：追求灵活性用 auto，强调稳定性用 html，侧重美学效果用 ai
3. 调用 scripts/generate.py 并传入对应参数
4. 若使用 html 模式并指定 --template，建议添加 --no-overlay（HTML 模板中已包含文字）
5. 将生成的图片发送给用户

依赖要求

• Python 3 + Pillow（即 PIL）
• curl（用于 AI 引擎下载字体）
• Chromium/Chrome（HTML 引擎所需，可选）