---
name: poster-generate
description: 专业海报与设计生成器。当你需要“做一张海报”、“生成封面”、“设计书籍封面”或任何视觉设计请求时使用。
---

## 运行前环境检查（每次执行前必做）

在开始写作流程前，**直接询问用户**是否已配置好以下环境：
1. **已安装Python**
2. **已配置ARK_API_KEY环境变量**
如全部配置好，回复"已配置好"直接开始。
如有未配置的，告诉我哪一项，我会指导你如何获取。

**用户回复后的处理：**
- **"已配置好"或类似确认** → 直接进入完整工作流程
- **有缺失项** → 针对性指导配置：
  - Python 安装：引导至 Python 官方网站下载安装 Python
  - ARK_API_KEY：引导至火山方舟控制台获取, 询问用户电脑系统是windows还是mac, 并提示不同系统下的配置环境变量的方法。



## 完整工作流程

### 第一步：确认是否需要优化提示词
用户输入初始提示词后，先明确询问用户：**“是否需要我先优化提示词？”**

- **用户选择“需要优化”** → 根据 `references/prompt-guide.md` 优化提示词，展示优化结果并询问是否继续调整；确认后进入第二步
- **用户选择“不优化”** → 使用用户原始提示词，直接进入第二步调用脚本生成

### 第二步： 生成海报
1. 告诉用户生成海报的可选分辨率：2k, 4k
2. 告诉用户生成海报的可选比例：1:1, 3:4, 4:3, 9:16, 16:9, 21:9, 2:3, 3:2
3. 可选图生图，支持最多上传3张图片
- 脚本将本地文件编码后填入 API 的 `image` 数组。
- 如果用户需要对之前生成的图片进行调整，请把之前的图片填入API，并且不要对用户的修改需求（如"调整物体的颜色”、“调整物体的位置”）做任何改动。
4. 调用 `seedream.py` 脚本生成海报（在 `skills/poster-generate` 目录下执行时，路径见下方命令行说明）。

---

## 命令行使用

### 基本语法

```bash
python3 scripts/seedream.py --prompt "图片描述" --resolution 2k --ratio 3:4
```

图生图（1～3 张本地参考图，可重复 `--image`）：

```bash
python3 scripts/seedream.py --prompt "将图1的主色换为图2的配色" --resolution 2k --ratio 3:4 --image ./a.png --image ./b.png
```

文生图

```bash
python3 scripts/seedream.py --prompt "一个穿着华丽服装的女孩，撑着遮阳伞走在林荫道上" --resolution 2k --ratio 3:4
```

### 参数说明

| 参数 | 说明 | 默认值 | 可选值 |
|------|------|--------|--------|
| `--prompt` | 图片描述提示词（必需） | - | 任意文本 |
| `--resolution` | 分辨率 | 2k | 2k, 4k |
| `--ratio` | 宽高比 | 3:4 | 1:1, 3:4, 4:3, 9:16, 16:9, 21:9, 2:3, 3:2 |
| `--image` | 参考图，**仅本地文件路径**；`--image` 可写多次，**最多 3 次** | - | `.png` / `.jpg` / `.jpeg` / `.webp` / `.gif` |
| `--output` | 自定义输出路径 (必填) | - |任意路径|

---