Baoyu Image Gen

核心功能

baoyu-image-gen 是一款面向开发者和专业用户的 AI 图像生成技能，通过统一的 CLI 接口整合四大主流图像生成 API：

• OpenAI：GPT Image 系列模型，支持原生图像编辑
• Google：Gemini 多模态模型（Pro/Flash），支持参考图生成
• DashScope：阿里云通义万象，中文场景优化
• Replicate：开源模型托管平台，支持社区模型如 SDXL

显著优点

1. 多模态能力：原生支持参考图像输入（reference images），可将现有图片作为风格或内容基准进行再创作
2. 企业级配置：通过 EXTEND.md 实现项目级和用户级偏好持久化，支持默认提供商、质量预设、输出路径等
3. 灵活的参数控制： aspect ratio（1:1 到 2.35:1）、quality 预设（normal/2k/4K）、明确模型指定
4. 智能降级：自动检测可用 API key，多 key 场景默认优先 Google
5. 并行生成支持：大批量场景可启用多 subagent 并发（默认串行保稳定）

潜在局限

• 依赖外部 API：需自行配置各平台 API key，国内用户访问 OpenAI/Google 需网络环境支持
• 成本不透明：不同提供商定价差异大（Replicate 按秒计费，OpenAI 按张计费），无内置成本估算
• Replicate 冷启动：社区模型可能存在启动延迟
• 模型能力参差：各提供商图像质量、中文理解、复杂构图能力差异显著，需实验选型

适合人群

• 需要批量生成封面、插图的内容创作者
• 构建 AI 工作流的开发者（支持 JSON 输出、环境变量注入）
• 需要图生图、风格迁移的设计师
• 国内企业用户（DashScope 提供合规中文支持）

常规风险

• API key 泄露：通过环境变量或 .env 文件管理，需确保 .gitignore 配置
• 内容安全：各平台有独立的内容审核策略，可能触发拒绝生成
• 成本失控：并行生成 4-8 并发时需注意配额和预算
• EXTEND.md 阻塞：首次使用强制配置流程，未经验证的配置可能导致生成失败

核心用法

baoyu-image-gen 是一款基于官方 API 的多服务商 AI 图像生成工具，采用 TypeScript + Bun 运行时构建。核心功能包括：

• 多Provider支持：OpenAI (GPT Image)、Google (Gemini multimodal/Imagen)、DashScope (阿里通义万象)、Replicate
• 生成模式：纯文本生成、参考图编辑（Google multimodal/OpenAI edits）
• 参数控制：宽高比 (1:1/16:9/9:16/4:3/3:4/2.35:1)、画质预设 (normal/2k/4K)、批量生成
• 配置管理：通过 EXTEND.md 持久化默认参数，支持项目级和用户级配置

执行入口为 scripts/main.ts，通过 CLI 参数驱动。首次使用需完成配置初始化（⛔ 阻塞式），后续按优先级加载：CLI参数 > EXTEND.md > 环境变量 > .env 文件。

显著优点

1. 架构设计合理：各服务商独立封装于 providers/ 目录，便于审计和维护；无第三方依赖，仅使用 Node.js 内置模块和 Bun API
2. 安全合规：静态评分75分，无危险函数调用；execSync 仅用于代理环境下 curl 回退（已充分注释）
3. 灵活配置：支持自定义 API 端点（企业代理场景）、多层级配置覆盖、环境变量热加载
4. 生成策略保守：默认串行生成确保稳定性，仅用户显式请求时才启用并行（建议并发4，最大8）
5. 隐私合规：GDPR 五项检测全通过，无敏感数据外泄，API 密钥访问符合最小化原则

潜在缺点与局限性

1. 运行时依赖：强制要求 Bun 运行时，Node.js 用户需额外安装
2. 首次配置门槛：EXTEND.md 初始化流程为阻塞式设计，需人工介入选择 provider/model/quality
3. 外部 API 依赖：4 家服务商 API 可用性直接影响功能，无本地回退方案
4. 代理环境 hack：Bun fetch 代理问题通过 curl 子进程绕过，长期维护成本存在
5. 自定义端点风险：*_BASE_URL 环境变量虽便利企业部署，但引入潜在重定向攻击面

适合人群

• 专业内容创作者、设计师、开发者 needing 程序化图像生成
• 多平台 API 密钥持有者，需要统一 CLI 接口管理
• 注重代码可审计性的企业/团队（全开源、无黑盒依赖）
• 需要项目级配置隔离的协作场景

常规风险

| 风险项 | 等级 | 说明 |

|--------|------|------|

| API 密钥泄露 | 中 | 需定期轮换，建议使用最小权限密钥 |

| 意外费用 | 中 | 多 provider 需分别监控用量，建议设置预算警报 |

| 自定义端点重定向 | 低 | 设置 *_BASE_URL 时需验证 SSL 证书 |

| 配置文件写入 | 低 | 定期检查 ~/.baoyu-skills/ 目录内容 |

| 外部图片下载 | 低 | 部分 API 返回 URL 需二次下载，建议增加域名校验 |

总体评估：功能完整、代码规范、安全基线良好，适合生产环境谨慎使用。