panda-imagine（熊猫想象）

图片生成引擎

多 Provider 图片生成引擎，通过统一的 CLI 接口调用 9 种图片生成服务。

脚本路径

1. {baseDir} = 本 SKILL.md 所在目录
2. 脚本路径 = {baseDir}/scripts/main.ts
3. 运行时: bun 可用 → bun; 否则 npx -y bun

步骤 0: 加载偏好 ⛔ 阻塞

检查 EXTEND.md：

test -f .panda-skills/panda-imagine/EXTEND.md && echo "project"
test -f "$HOME/.panda-skills/panda-imagine/EXTEND.md" && echo "user"

兼容读取: .baoyu-skills/baoyu-imagine/EXTEND.md（fallback）

使用方式

# 基本用法
${BUN_X} {baseDir}/scripts/main.ts --prompt "一只猫" --image cat.png

# 指定宽高比
${BUN_X} {baseDir}/scripts/main.ts --prompt "风景画" --image out.png --ar 16:9

# 高质量
${BUN_X} {baseDir}/scripts/main.ts --prompt "一只猫" --image out.png --quality 2k

# 从提示词文件生成
${BUN_X} {baseDir}/scripts/main.ts --promptfiles prompt.md --image out.png

# 参考图（Google, OpenAI, Azure, OpenRouter, Replicate, MiniMax, Seedream）
${BUN_X} {baseDir}/scripts/main.ts --prompt "改为蓝色" --image out.png --ref source.png

# 通义万相
${BUN_X} {baseDir}/scripts/main.ts --prompt "一只可爱的猫" --image out.png --provider dashscope

# MiniMax（角色参考图）
${BUN_X} {baseDir}/scripts/main.ts --prompt "站在窗前" --image out.jpg --provider minimax --ref portrait.png

# 即梦（自动检测 dreamina CLI 或 API 模式）
${BUN_X} {baseDir}/scripts/main.ts --prompt "科技海报" --image out.png --provider jimeng

# 即梦 + 参考图（需要 dreamina CLI）
${BUN_X} {baseDir}/scripts/main.ts --prompt "改为水彩风格" --image out.png --provider jimeng --ref source.png

# 豆包 Seedream
${BUN_X} {baseDir}/scripts/main.ts --prompt "一只猫" --image out.png --provider seedream

# 批量模式
${BUN_X} {baseDir}/scripts/main.ts --batchfile batch.json

批量文件格式

{
  "jobs": 4,
  "tasks": [
    {
      "id": "hero",
      "promptFiles": ["prompts/hero.md"],
      "image": "out/hero.png",
      "ar": "16:9"
    }
  ]
}

选项

环境变量

加载优先级: CLI 参数 > EXTEND.md > 环境变量 > .panda-skills/.env > ~/.panda-skills/.env

即梦 Provider 无需设置环境变量——安装 dreamina CLI 并登录后即可使用。

Provider 选择

即梦双模式:

• CLI 模式（优先）：安装了 dreamina CLI → 自动使用，支持 --ref 参考图
• API 模式（fallback）：设置了 JIMENG_ACCESS_KEY_ID → 使用火山引擎 HMAC 签名，不支持 --ref

安装 dreamina CLI:

curl -fsSL https://jimeng.jianying.com/cli | bash
dreamina login

自动选择逻辑:

1. 有 --ref 且无 --provider → 按 google > openai > azure > openrouter > replicate > seedream > minimax > jimeng 顺序
2. 指定 --provider → 使用该 Provider
3. 仅一个 API Key（或 dreamina CLI）→ 使用对应 Provider
4. 多个可用 → 使用第一个

质量预设

错误处理

• API Key 缺失 → 报错并提示设置
• 生成失败 → 自动重试最多 3 次
• 参考图 + 不支持的 Provider → 报错并提示替代方案

参考文档