前言¶

做圖標、插畫或 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