用途：baoyu-imagine 用于调用多家官方 API 生成 AI 图像，主脚本为 {baseDir}/scripts/main.ts，运行前需解析 ${BUN_X}：优先 bun，其次 npx -y bun，否则建议 brew install oven-sh/bun/bun。
主要能力：支持 OpenAI GPT Image 2、Azure OpenAI、Google、OpenRouter、DashScope（阿里通义万象）、Z.AI GLM-Image、MiniMax、即梦、Seedream（豆包）和 Replicate。可设置提供方、模型、宽高比、显式尺寸、质量预设（normal/2k）、Google/OpenRouter 的 1K/2K/4K，以及参考图和小批量生成。
使用方式：首次使用为阻塞步骤，需先完成配置并生成 EXTEND.md，否则不会生成图像。基本命令如 ${BUN_X} {baseDir}/scripts/main.ts --prompt "A cat" --image cat.png；可加 --ar 16:9 --quality 2k，或 --provider dashscope --model qwen-image-2.0-pro。提示词可来自文件（--promptfiles），参考图用 --ref，批量用 --batchfile batch.json --jobs 4，JSON 输出用 --json。
配置与优先级：配置路径依次为项目 .baoyu-skills/baoyu-imagine/EXTEND.md、XDG 目录、用户主目录。加载优先级为 CLI 参数 > EXTEND.md > 环境变量 > 当前目录 .env > 主目录 .env。模型解析优先级为 --model、EXTEND.md、对应环境变量、内置默认。
限制：Jimeng、Seedream 3.0、SeedEdit 3.0 及 wan2.7-image* 之外的 DashScope 模型不支持参考图；Replicate 仅支持 --n 1；ratio-metadata 仅适用于文生图，参考图编辑仍需 openai-native 或原生编辑提供方。生成失败最多重试 3 次；缺少 API key 会报错并给出设置说明；无效宽高比会发出警告并使用默认值。具体提供方模型家族、尺寸规则和限制需查阅对应参考文档。