hwj123hwj Image Provider
统一生图技能，基于策略模式，支持多个后端 Provider 自由切换。
脚本目录
| 脚本 | 用途 |
|---|---|
scripts/generate.py |
统一生图入口（配图 + 封面） |
基本用法
# 生成文章配图（16:9 横图）
python3 ${SKILL_DIR}/scripts/generate.py "your prompt" --size 1792x1024 -o output.jpg
# 生成封面图（从标题自动生成 prompt）
python3 ${SKILL_DIR}/scripts/generate.py --mode cover --title "文章标题" --size 1792x1024 -o cover.jpg
# 指定 provider
python3 ${SKILL_DIR}/scripts/generate.py "prompt" --provider dvcode
python3 ${SKILL_DIR}/scripts/generate.py "prompt" --provider vertex-imagen
参数
| 参数 | 说明 | 默认值 |
|---|---|---|
prompt |
图片描述（image 模式必填） | - |
--mode, -m |
image（配图）或 cover（封面） |
image |
--title, -t |
文章标题（cover 模式用） | - |
--size, -s |
尺寸: 0.5K / 1024x1024 / 1024x1792 / 1792x1024 / 2K / 4K |
1024x1024 |
--ratio, -r |
比例: 1:1 / 16:9 / 9:16 / 4:3 / 3:4（默认从 size 推断） |
auto |
--provider, -p |
vertex-imagen 或 dvcode |
从 .env 读取 |
--output, -o |
输出路径 | outputs/ 自动命名 |
Provider 切换
方式 1：修改 .env（永久切换默认）
编辑 ${SKILL_DIR}/.env：
DEFAULT_PROVIDER=vertex-imagen
# 或
DEFAULT_PROVIDER=dvcode
方式 2：命令行参数（单次覆盖）
python3 generate.py "prompt" --provider dvcode
方式 3：新增 Provider
- 在
scripts/providers/下新建xxx_provider.py - 继承
ImageProvider，实现generate()方法 - 在
registry.py的PROVIDERS字典中注册
API Key 配置
Vertex AI Imagen
读取优先级：
- 环境变量
VERTEX_API_KEY ${SKILL_DIR}/.env中的VERTEX_API_KEY=...~/.config/image-provider/config.json中的vertex_api_key
dvcode
无需 API Key，但需要：
- dvcode CLI 已安装
- 在有 Git remote 的目录下运行（推荐
dvcode_pictures/）
代理支持
Vertex AI Imagen 自动检测本地代理（Clash 等）：
- 优先读
HTTPS_PROXY环境变量 - 自动探测 7890/7897/1087 端口
- 无代理时直连