前言¶

做界面稿、營銷圖或風格探索時，常見做法是單獨打開某個繪圖站點，把提示詞複製過去，再把結果下載回項目。Agent 已經能寫代碼、改文檔，卻往往在「出一張符合設計風格的圖」這一步斷掉。下面介紹 SkillHub 上的 recraft v3（座標 @user_f95f21b8/dlazy-recraft-v3）：把 Recraft v3 的生成能力接到 Agent 工作流裏，通過 dLazy CLI 調用託管 API，支持文生圖與圖生圖。

這是什麼¶

recraft v3 是一條社區來源（community）的 Agent Skill，當前版本 1.0.9，分類爲 design-media。SkillHub 發佈者爲 user_f95f21b8；技能正文標明底層 CLI 由 dlazyai 維護，對應 npm 包 @dlazy/cli。

一句話定位：用 Recraft v3 生成多種設計風格的位圖，支持 text-to-image 與 image-to-image。技能本身是 dLazy API（api.dlazy.com / files.dlazy.com）的薄封裝，Agent 按 SKILL.md 指引執行 dlazy recraft-v3 即可。

核心功能¶

根據技能說明，已覈實的能力包括：

1. 文生圖：通過 --prompt 描述畫面，可選畫幅與風格。
2. 圖生圖：在提示詞基礎上傳入 --image，支持本地路徑或 https://files.dlazy.com/... 等 URL；本地文件會由 CLI 上傳到 dLazy 媒體存儲供模型讀取。
3. 畫幅：--aspect_ratio，默認 auto，可選 1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9。
4. 風格：--style，默認 Recraft V3 Raw，可選 Photorealism、Illustration。
5. 調試與異步：--dry-run 可查看請求載荷與費用估算；--no-wait 返回 generateId，可用 dlazy status <generateId> --wait 輪詢；--timeout 默認 1800 秒。

標籤 requires_api_key=true：使用前必須配置 dLazy API Key。

安裝與啓用¶

1. 安裝 SkillHub CLI（若尚未安裝）¶

command -v skillhub && skillhub --version

未安裝時可執行完整安裝腳本（見 SkillHub 安裝文檔）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2. 將 Skill 裝到當前 Agent 的 skills 目錄¶

安裝時必須用 --dir 指向 Agent 實際識別的 skills 路徑，否則默認落在 ./skills/ 可能不會被加載。常見路徑示例：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

skillhub install @user_f95f21b8/dlazy-recraft-v3 --dir <你的 skills 目錄>

也可讓 Agent 按官方提示安裝：參考 https://skillhub.cn/install/skillhub.md，安裝 @user_f95f21b8/dlazy-recraft-v3。

3. 安裝 dLazy CLI¶

技能元數據固定 CLI 版本爲 1.0.9，需要本機有 npm / npx：

npm install -g @dlazy/cli@1.0.9

或不全局安裝、按需調用：

npx @dlazy/cli@1.0.9 <command>

安裝前可到 github.com/dlazyai/cli 審閱源碼。

4. 配置 API Key¶

dlazy auth set YOUR_API_KEY

密鑰寫入 ~/.dlazy/config.json（Windows 爲 %USERPROFILE%\.dlazy\config.json）。也可單次使用環境變量 DLAZY_API_KEY。Key 在 dlazy.com/dashboard/organization/api-key 獲取。

典型用法¶

Agent 收到與圖像生成相關的任務時，應執行 dlazy recraft-v3（可用 -h 查看完整參數）。官方示例：

# 基礎：提示詞 + 本地參考圖（圖生圖）
dlazy recraft-v3 --prompt 'prompt text' --image '/path/to/image.png'

# 使用已託管在 dLazy 上的圖片 URL
dlazy recraft-v3 --prompt 'prompt text' --image 'https://files.dlazy.com/image.png'

成功時 CLI 返回 JSON，outputs 中含 url（例如 https://files.dlazy.com/result.png）。觸發關鍵詞包括：recraft v3、generate image / design image、text to image、image to image 等（見技能正文）。

可先 --dry-run 估算費用，再正式調用以控制消耗。

適用場景與注意¶

適合誰

• 需要在 Cursor、Claude Code、Codex 等環境裏，用自然語言讓 Agent 直接出設計向位圖的同學。
• 已有 dLazy 賬號與餘額，願意把提示詞與參考圖交給雲端 API 的場景。

限制與注意

1. 依賴網絡與付費：推理在 dLazy 雲端完成；餘額不足會返回 insufficient_balance，需在 Credits 設置 充值。
2. 密鑰與隱私：本地參考圖會上傳到 files.dlazy.com；敏感素材勿隨意傳入。
3. 錯誤碼：未配置或無效 Key 爲 unauthorized；缺 --prompt 等會報參數錯誤；生成失敗可能含安全策略等原因，需根據 CLI 返回信息處理。
4. 與 SVG 技能區分：同發佈者另有 dlazy-recraft-v3-svg 等變體；本文僅對應 recraft v3 位圖能力，命令爲 dlazy recraft-v3，模型標識爲 n1n-recraft-v3。

SkillHub 頁面當前顯示版本 v1.0.9；社區評分與下載量以商店頁爲準（抓取時評分爲 100000、下載約 992 次）。

結尾¶

recraft v3 把 Recraft v3 的文生圖、圖生圖接到 Agent Skill 標準流程裏：SkillHub 安裝技能、@dlazy/cli@1.0.9 執行命令、dLazy API Key 完成鑑權。若你希望在對話裏完成「描述 → 出圖 → 拿 URL」，可以從官方條目入手：

• SkillHub：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-recraft-v3
• API 入口：https://api.skillhub.cn/user_f95f21b8/dlazy-recraft-v3