前言¶

做图标、插画或 UI 装饰时，位图放大容易糊，手工描 SVG 又费时。把需求写成提示词，让模型直接出可缩放的矢量结果，是更省事的路径。下面介绍 SkillHub 上的 recraft v3 svg：它把 dLazy 托管的 Recraft v3 SVG 能力封装成标准 Skill，Agent 按 SKILL.md 调用 @dlazy/cli 即可，不必自己拼 HTTP 请求。

这是什么¶

recraft v3 svg（坐标 @user_f95f21b8/dlazy-recraft-v3-svg，当前版本 1.0.9）是一条社区来源（community）、分类为 design-media 的 Skill。SkillHub 简介为：Generate high-quality SVG vector graphics from text using Recraft v3.

维护与实现侧：Skill 由发布者 user_f95f21b8 上架；底层 CLI 与 API 由 dlazyai 提供（@dlazy/cli，本 Skill 固定 1.0.9）。Skill 本质是 dLazy API 的薄封装：提示词与参数发往 api.dlazy.com，生成物 URL 由 files.dlazy.com 返回。

SkillHub 页面标注 requires_api_key=true，使用前需配置 dLazy API Key。

核心功能¶

依据 Skill 包内 SKILL.md，已核实能力包括：

1. 文生矢量：通过子命令 dlazy recraft-v3-svg，以 --prompt 描述画面；模型标识为 recraft-v3-svg。
2. 画幅与风格：--aspect_ratio 支持 auto、1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9；--style 可选 Vector Art（默认）、Line Art、Engraving。
3. 参考图：示例中支持 --image 传入本地路径或 https://files.dlazy.com/... 的 URL（由 CLI 上传或引用）。
4. 调试与异步：--dry-run 可打印请求体与费用估算而不真正调用 API；--no-wait 返回 generateId，可用 dlazy status <generateId> --wait 轮询；--timeout 默认最长等待 1800 秒。
5. Agent 触发词：如 recraft svg、generate svg、text to image 等（见 Skill 文档「Trigger Keywords」）。

成功时 CLI 返回 JSON 信封，result.outputs 中含图片类资源的 url、mimeType 等字段（文档示例为 image/png 形态的托管链接，以实际返回为准）。

安装与启用¶

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

按 SkillHub 安装说明 检查或安装：

command -v skillhub && skillhub --version

未安装时可执行完整安装（文档推荐）：

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

2. 将 Skill 装到当前 Agent 的 skills 目录¶

SkillHub 要求 --dir 指向 Agent 实际识别的目录，否则默认 ./skills/ 可能不会被加载。常见路径（同官方安装文档）：

安装本 Skill：

skillhub install @user_f95f21b8/dlazy-recraft-v3-svg --dir ~/.cursor/skills/

将 ~/.cursor/skills/ 换成你当前客户端对应路径。安装后按各客户端要求重启或刷新 Skill 列表。

也可让 Agent 按 SkillHub 页面提示，参照 https://skillhub.cn/install/skillhub.md 完成安装。

3. 安装并配置 dLazy CLI¶

Skill 元数据要求本机具备 npm / npx。全局安装（与 Skill 声明一致）：

npm install -g @dlazy/cli@1.0.9

或按需单次调用：

npx @dlazy/cli@1.0.9 <command>

配置 API Key（写入 ~/.dlazy/config.json，Linux/macOS；Windows 为 %USERPROFILE%\.dlazy\config.json）：

dlazy auth set YOUR_API_KEY

Key 在 dlazy.com/dashboard/organization/api-key 获取；也可通过环境变量 DLAZY_API_KEY 按次传入。

典型用法¶

先查看子命令帮助（Skill 要求 Agent 以此为准）：

dlazy recraft-v3-svg -h

基础调用（文档示例，含可选参考图）：

dlazy recraft-v3-svg --prompt 'prompt text' --image '/path/to/image.png'

使用远程参考图：

dlazy recraft-v3-svg --prompt 'prompt text' --image 'https://files.dlazy.com/image.png'

仅生成、不调 API 时可用：

dlazy recraft-v3-svg --prompt 'your description' --dry-run

在 Cursor 等环境中，用户用自然语言描述画面即可；Agent 读取 Skill 后应执行上述 CLI，而不是臆造图片地址。

适用场景与注意¶

适合：需要由 Agent 编排的矢量插画、图标草图、线稿风格素材；团队已使用 dLazy 账户、愿意把提示词与可选参考图发到云端推理的场景。

限制与注意：

1. 付费与配额：调用消耗 dLazy 组织积分；返回 insufficient_balance 时需到控制台充值（Skill 文档给出 credits 设置页链接）。
2. 密钥：未配置或无效 Key 会 unauthorized；SkillHub 标签已标明需要 API Key。
3. 依赖与环境：需 Node 生态下的 npm/npx；网络需能访问 api.dlazy.com 与 files.dlazy.com。
4. 数据路径：本地 --image 等路径会被 CLI 上传至 dLazy 存储，敏感素材需自行评估合规性。
5. 版本：Skill 与 CLI 均锁定 1.0.9；升级前建议在 github.com/dlazyai/cli 审阅变更。

SkillHub 统计（以抓取资料为准）：评分 100000，下载 1043，安装 1。

结尾¶

recraft v3 svg 把 Recraft v3 的 SVG 生成能力接到通用 Skill 流程里：SkillHub 负责分发与坐标，dLazy CLI 负责鉴权与调用。若你已在用 Cursor / Claude Code 等支持 Skill 的客户端，按本文装好 Skill 与 @dlazy/cli@1.0.9、配置 Key 后，即可用自然语言驱动矢量图生成。

官方入口：

• SkillHub 页面：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-recraft-v3-svg
• API 坐标页：https://api.skillhub.cn/user_f95f21b8/dlazy-recraft-v3-svg