前言¶
在 IDE 或对话式 Agent 里做配图、改图，常见做法是单独打开网页控制台或自己写脚本调 HTTP API。提示词、参考图路径和画幅参数往往要在工具链里来回粘贴，也不利于让 Agent 按步骤执行。
下面介绍 SkillHub 上的 banana pro（坐标 @user_f95f21b8/dlazy-banana-pro，当前版本 1.0.9）。它把 dLazy 的 Nano Banana Pro 能力封装成标准 SKILL.md，Agent 通过 dLazy CLI 的 dlazy banana-pro 子命令完成文生图与图生图。Skill 页面标注 requires_api_key=true，使用前需配置 dLazy API Key。
这是什么¶
banana pro 是一类 design-media 向的社区 Skill（来源 community，发布者 user_f95f21b8）。官方简介为：使用 Nano Banana Pro 生成/编辑图片，支持 text-to-image 与 image-to-image。
实现上，Skill 是 dLazy 托管 API 的薄封装：提示词与参数发往 api.dlazy.com，本地参考图由 CLI 上传到 files.dlazy.com，生成结果 URL 同样由 dLazy 媒体域返回。CLI 由 dlazyai 维护，npm 包为 @dlazy/cli（Skill 元数据固定版本 1.0.9）。
- SkillHub 页面：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-banana-pro
- API 资源地址：https://api.skillhub.cn/user_f95f21b8/dlazy-banana-pro
截至资料抓取时，SkillHub 显示评分 100000，下载 1517 次，安装 5 次（以页面实时数据为准）。
核心功能¶
已核实能力如下：
- 文生图 / 图生图：通过
--prompt与--image（或--images，最多 14 张，支持 URL 或本地路径）组合调用 Nano Banana Pro。 - 画幅与分辨率：
--aspectRatio支持auto、1:1、4:3、3:4、16:9、9:16、21:9；--imageSize支持1K、2K、4K（默认1K）。 - 预检与异步：
--dry-run可打印请求体与费用估算而不真正调用 API；--no-wait返回generateId，可用dlazy status <generateId> --wait轮询。 - 触发词：Skill 文档列出如
nano banana pro、generate image、text to image等，便于 Agent 识别何时启用本 Skill。
依赖环境：Skill 元数据要求本机具备 npm 与 npx。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 官方说明执行（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 将 Skill 装到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。SkillHub 文档给出的常见路径包括：
- Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/ - Claude Code：
~/.claude/skills/
以 Cursor 为例：
skillhub install dlazy-banana-pro --dir ~/.cursor/skills/
也可让 Agent 按 SkillHub 安装说明处理，提示词示例为：请根据 https://skillhub.cn/install/skillhub.md，安装 @user_f95f21b8/dlazy-banana-pro。
3. 安装 dLazy CLI¶
Skill 声明的全局安装命令（版本与 Skill 一致）：
npm install -g @dlazy/cli@1.0.9
不想全局安装时，可按次使用：
npx @dlazy/cli@1.0.9 <command>
源码与包信息：https://github.com/dlazyai/cli、https://www.npmjs.com/package/@dlazy/cli。
4. 配置 API Key¶
所有请求需要 dLazy API Key：
dlazy auth set YOUR_API_KEY
密钥写入用户配置目录（Linux/macOS 为 ~/.dlazy/config.json）。也可单次通过环境变量 DLAZY_API_KEY 传入。Key 在 dlazy.com/dashboard/organization/api-key 获取。
安装或更新 Skill 后，按你所用 Agent 的惯例重启或刷新 skills 加载，再在自然语言中提及生成/编辑图片或 Nano Banana 相关需求即可触发。
典型用法¶
Agent 侧的核心动作是执行 dlazy banana-pro。先查看帮助：
dlazy banana-pro -h
官方 SKILL 中的命令示例（参数名以英文 CLI 为准）：
# 带本地参考图的生成/编辑：
dlazy banana-pro --prompt 'prompt text' --image '/path/to/image.png'
# 使用远程图片 URL 的图生图：
dlazy banana-pro --prompt 'prompt text' --image 'https://files.dlazy.com/image.png'
成功时 CLI 返回 JSON，outputs 中含图片 url（托管在 files.dlazy.com）。若使用 --no-wait，需再用 dlazy status 查询任务状态。
调用前可用 --dry-run 核对参数与预估费用；长任务可配合 --timeout（默认等待上限 1800 秒）。
适用场景与注意¶
适合谁
- 已在使用 Cursor、Codex、Claude Code 等支持 SKILL.md 的 Agent，希望在对话里直接出图或改图。
- 愿意使用 dLazy 账号与 API 额度，并接受云端推理与文件上传链路。
限制与注意
- 付费与额度：API 调用消耗 dLazy 组织积分；返回
insufficient_balance时需到控制台充值（Skill 文档指向 credits 设置页）。 - 密钥安全：不要把 API Key 写进仓库；优先
dlazy auth set或环境变量。 - 数据出境：提示词与上传的本地文件会进入 dLazy 服务，需符合你所在团队的数据合规要求。
- 错误码：401 多为 Key 缺失或无效；501 多为缺少
--prompt；502 多为本地路径不存在。Agent 文档要求对 unauthorized、余额不足给出明确引导。
结尾¶
banana pro 把 Nano Banana Pro 的文生图、图生图能力接到 Agent 工作流里：SkillHub 负责分发与版本（1.0.9），dLazy CLI 负责鉴权与 API 调用。若你正在 SkillHub 的 design-media 分类里找可落地的出图 Skill，可从官方页安装并配置 Key 后，用 dlazy banana-pro 做最小闭环验证。
- SkillHub：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-banana-pro
- API：https://api.skillhub.cn/user_f95f21b8/dlazy-banana-pro
