Pose & Costume Image Generation
从姿势服饰参考库选取模板，结合提示词生成人物图。
数据源
姿势/服饰/人物数据来自 https://hongye007.github.io/open-pose-costume/data/catalog.json（3194条）
- pose: 姿势模板（如 P001、P047）
- costume: 服饰模板（如 SPR-0050）
- character: 人物参考（可选，编号如
f71f980dde3）
生图服务配置
通过技能目录的 .env 文件配置（OpenAI 兼容接口）：
cp .env.example .env
# 编辑 .env
# IMAGE_API_BASE=https://your-image-service.example.com/v1
# IMAGE_API_KEY=sk-your-key
# IMAGE_MODEL=gpt-image-2
| 变量 | 说明 | 默认值 |
|---|---|---|
| IMAGE_API_BASE | 生图服务地址（含 /v1） | 必填 |
| IMAGE_API_KEY | 服务密钥 | 必填 |
| IMAGE_MODEL | 模型名 | gpt-image-2 |
也可用命令行参数临时覆盖：--api-base / --api-key / --model
使用流程
1. 搜索姿势/服饰 → 选取参考
2. 配置 .env 文件
3. 调用 generate.py 生成
命令行工具
搜索姿势/服饰
python3 scripts/fetch_poses.py --search "站姿" --kind pose --limit 10
python3 scripts/fetch_poses.py --search "裙" --kind costume
生成图片（支持 1/2/3 张参考图）
1 张参考图（仅姿势）：
python3 scripts/generate.py --pose P047 --prompt "beautiful woman, white dress, realistic photo"
2 张参考图（姿势 + 服饰）：
python3 scripts/generate.py --pose P047 --costume SPR-0001 --prompt "young woman, spring outfit, portrait"
3 张参考图（姿势 + 服饰 + 人物）：
python3 scripts/generate.py --pose P047 --costume SPR-0001 --character f71f980dde3 --prompt "portrait"
本地人物照片（第三张参考图，优先于 --character）：
python3 scripts/generate.py --pose P047 --person-image ~/photos/me.jpg --prompt "realistic photo"
调试模式
# 只打印参考图和提示词，不生成图片
python3 scripts/generate.py --pose P047 --prompt "test" --dry-run
注意事项
- 参考图顺序固定：姿势 → 服饰 → 人物（1/2/3 张自动适配）
- 人物参考可从库选（--character 编号）或本地照片（--person-image 路径）
- Catalog 数据缓存在技能目录
.cache/catalog.json，首次运行自动下载（约3MB） - 添加
--refresh强制刷新数据 - 姿势库约288个，服饰库约1407套，人物库约1499个
参考
- 姿势服饰库：https://hongye007.github.io/open-pose-costume/
- 官方 Skill：https://github.com/hongye007/open-pose-costume-skill
作者
- 作者：sxkiss
- 主页：https://github.com/sxkiss
- 许可：MIT
