前言¶
在 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
