前言¶
做界面稿、营销图或风格探索时，常见做法是单独打开某个绘图站点，把提示词复制过去，再把结果下载回项目。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 即可。
核心功能¶
根据技能说明，已核实的能力包括：
- 文生图：通过
--prompt描述画面，可选画幅与风格。 - 图生图：在提示词基础上传入
--image，支持本地路径或https://files.dlazy.com/...等 URL；本地文件会由 CLI 上传到 dLazy 媒体存储供模型读取。 - 画幅：
--aspect_ratio，默认auto，可选1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9。 - 风格：
--style，默认Recraft V3 Raw，可选Photorealism、Illustration。 - 调试与异步：
--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 的场景。
限制与注意
- 依赖网络与付费：推理在 dLazy 云端完成；余额不足会返回
insufficient_balance，需在 Credits 设置 充值。 - 密钥与隐私：本地参考图会上传到
files.dlazy.com；敏感素材勿随意传入。 - 错误码：未配置或无效 Key 为
unauthorized；缺--prompt等会报参数错误；生成失败可能含安全策略等原因，需根据 CLI 返回信息处理。 - 与 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
