by 详细分析 ▾
运行时依赖
版本
首次从 pluiez-agent-skills 的提交 b64745e 发布到 ClawHub。
安装命令
点击复制本土化适配说明
Gemini 安装说明： 安装命令：npx clawhub@latest install gemini-image-cli
技能文档
使用 ./scripts/gemini-image.sh 进行 Gemini 原生图像生成。优先使用此内置脚本，而非手写一次性 curl 命令。
工作流
- 运行
./scripts/gemini-image.sh，带上用户提示及所需选项。 - 普通请求无需询问使用哪个端点；脚本自动选择：优先本地 Gemini 兼容代理，其次 Google 回退。
- 普通单图生成保持默认：
gemini-3.1-flash-image-preview，尺寸512，宽高比16:9。 - 延迟优先于最新画质时，使用
gemini-2.5-flash-image。 - 用户需要更强指令遵循、文本渲染或专业级输出时，使用
gemini-3-pro-image-preview。 - 多模型批量、多次重试或其他可能消耗额外配额的重复调用前，先确认。
- 仅在解释提供商/安全权衡、选择非默认模型、配置本地 Gemini 兼容代理、排查缓慢或失败请求、或修改 CLI 时，才阅读
references/behavior.md。
常用命令
生成单图： ``bash
./scripts/gemini-image.sh "A cute orange kitten sitting on a soft blanket"
` 指定输出路径或前缀；脚本按返回的图像 MIME 类型自动选扩展名：
`bash
./scripts/gemini-image.sh "画两只小猫在打闹" --output ./out/kittens.png
`
使用更快模型：
`bash
./scripts/gemini-image.sh "画两只小猫在打闹" --model gemini-2.5-flash-image
`
强制使用 Google 官方端点：
`bash
./scripts/gemini-image.sh "画两只小猫在打闹" --provider google
`
强制使用本地代理端点：
`bash
./scripts/gemini-image.sh "画两只小猫在打闹" --provider local
`
使用更大输出尺寸：
`bash
./scripts/gemini-image.sh "A cinematic poster of two kittens" --size 1K --aspect 16:9
`
使用输入图像进行引导生成或编辑：
`bash
./scripts/gemini-image.sh "Turn this cat photo into a watercolor illustration" --image cat.jpg
`
输出约定
脚本将人类可读日志打印到 stderr，机器可读结果打印到 stdout。成功时 stdout 行：
`text
image= raw_json= text= duration_seconds=
`
仅启用 --with-text 时才会出现 text=`。