前言¶
在對話裏直接出圖，常見做法是切到 Midjourney 網頁或 Discord，把提示詞複製過去再等結果。若你希望 Cursor、Claude Code 等帶 Skills 的 Agent 在任務流裏完成「寫提示詞 → 調模型 → 拿回圖片 URL」，需要一條可複用的技能封裝，而不是每次手寫 HTTP 請求。
下面介紹 SkillHub 上的 mj-imagine（座標 @user_f95f21b8/dlazy-mj-imagine，當前版本 1.0.9）。它把 dLazy 託管的 Midjourney 推理能力接到 Agent 側，通過 @dlazy/cli 執行 dlazy mj.imagine，支持純文本生圖。
這是什麼¶
mj-imagine 是社區來源（community）的 Skill，分類爲 design-media，由發佈者 user_f95f21b8 上架。官方簡介爲：
Generate artistic images using Midjourney (MJ) model. Supports text-to-image.
技能包內標識爲 dlazy-mj.imagine，實質是 dLazy API 的薄封裝：提示詞與參數發往 api.dlazy.com，生成結果 URL 由 files.dlazy.com 返回。CLI 由 dlazyai 維護，源碼見 github.com/dlazyai/cli。
SkillHub 頁面統計（以商店展示爲準）：評分 100000，下載約 1200 次；標籤含 requires_api_key=true，使用前需配置 dLazy API Key。
核心功能¶
根據技能包 SKILL.md 與 SkillHub 簡介，已覈實能力如下：
- 文生圖：通過 Midjourney 模型生成藝術向圖像（
modelId:mj_imagine）。 - 畫幅與機型：
--aspect_ratio支持auto、1:1、4:3、16:9等；--botType可選MID_JOURNEY或NIJI_JOURNEY。 - 輸出形式：
--output默認爲四宮格grid，也可指定U1–U4單張放大結果。 - 調試與異步：
--dry-run可查看請求載荷與費用估算；--no-wait返回generateId，可用dlazy status <generateId> --wait輪詢。 - 觸發詞：技能說明中列出
midjourney、mj、文生圖相關表述，便於 Agent 路由到本 Skill。
依賴環境需具備 npm / npx；CLI 固定版本爲 @dlazy/cli@1.0.9。
安裝與啓用¶
1. 安裝 SkillHub CLI（若尚未安裝）¶
command -v skillhub && skillhub --version
未安裝時可按 SkillHub 文檔執行完整安裝：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
說明見 skillhub.cn/install/skillhub.md。
2. 將 mj-imagine 裝進當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向 Agent 實際識別的 skills 路徑，否則默認落在 ./skills/ 可能無法加載。常用路徑示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下.agents/skills/
搜索與安裝命令（與 skillhub search 輸出一致）：
skillhub search mj-imagine
skillhub install dlazy-mj-imagine --namespace user_f95f21b8 --dir ~/.cursor/skills/
也可讓 Agent 按官方提示安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_f95f21b8/dlazy-mj-imagine`。
安裝後重啓或刷新 Agent，使 Skills 生效。
3. 安裝並配置 dLazy CLI¶
全局安裝（與技能 metadata 中聲明一致）：
npm install -g @dlazy/cli@1.0.9
或不落盤全局包、按需調用：
npx @dlazy/cli@1.0.9 <command>
配置 API Key（寫入 ~/.dlazy/config.json，Windows 爲 %USERPROFILE%\.dlazy\config.json）：
dlazy auth set YOUR_API_KEY
也可單次通過環境變量傳入：
export DLAZY_API_KEY=YOUR_API_KEY
Key 在 dlazy.com/dashboard/organization/api-key 獲取，需先在 dlazy.com 註冊或登錄。
典型用法¶
Agent 側應按技能說明執行 dlazy mj.imagine。先查看幫助：
dlazy mj.imagine -h
基礎文生圖（--prompt 爲必填）：
dlazy mj.imagine --prompt 'a watercolor cityscape at dusk, soft lighting'
指定畫幅與 Niji 風格：
dlazy mj.imagine \
--prompt 'anime character portrait, detailed eyes' \
--aspect_ratio 9:16 \
--botType NIJI_JOURNEY \
--output grid
技能文檔中的帶圖示例（本地或遠程參考圖）：
dlazy mj.imagine --prompt '提示詞內容' --image '/path/to/image.png'
dlazy mj.imagine --prompt '提示詞內容' --image 'https://files.dlazy.com/image.png'
成功時 CLI 返回 JSON，outputs 中含 url 指向 files.dlazy.com 上的 PNG。若使用 --no-wait，需再執行 dlazy status <generateId> --wait 等待完成。
在對話裏，你可以用自然語言描述畫面，並說明畫幅或 MID_JOURNEY / NIJI_JOURNEY，由 Agent 拼裝上述參數後執行命令。
適用場景與注意¶
適合誰
- 已在用 Cursor、Claude Code 等 Skills 能力，希望在同一上下文裏生成 Midjourney 風格配圖的設計、運營或前端同學。
- 願意使用 dLazy 託管 API（按量計費、需自備 Key）而不是自建 MJ 代理的團隊。
限制與注意
- 必須聯網且需 API Key：未配置或 Key 無效會返回
unauthorized；餘額不足時code爲insufficient_balance，需在 dlazy.com 積分設置 充值。 - 數據出境路徑：提示詞與上傳的本地文件會經 dLazy 上傳到其 API 與媒體存儲，使用前請對照組織合規要求。
- CLI 版本鎖定：技能固定
@dlazy/cli@1.0.9，升級 CLI 前建議對照 SkillHub 上技能版本是否同步更新。 - 安全與內容策略：後端可能拒絕違規提示詞（例如返回 safety policy 相關錯誤），需在提示詞側自行把控。
結尾¶
mj-imagine 把 Midjourney 文生圖收斂成 Agent 可調用的 dlazy mj.imagine 命令：SkillHub 負責分發技能包，dLazy CLI 負責鑑權與 API 調用。若你的痛點是「在編碼或寫稿對話裏順手出圖」，可按上文完成 Skill 與 CLI 安裝，再配置 API Key 即可試用。
