前言¶
在對話式開發環境裏，用戶常會直接說「幫我生成一張封面」「做張 16:9 海報」「圖裏要有中文標題」。若 Agent 沒有對接好的文生圖能力，要麼拒絕任務，要麼自行拼湊未文檔化的 HTTP 調用，比例、張數也容易和預期不一致。zimage 是 SkillHub 上的一條 community Skill，把 Z-Image 輕量級文生圖接口封裝成 Agent 可遵循的 SKILL.md 約定，並寫明何時調用、參數如何映射、哪些場景不要用。
這是什麼¶
zimage（座標 @user_4bd21536/zimage，版本 1.0.0）由社區用戶 user_4bd21536 發佈，分類爲 design-media，來源爲 community。它解決的是：在用戶提出生成圖片類需求時，由 Agent 調用 zImage 接口，用 prompt（必填）與 size（可選）生成圖片；比例表述（如 1:1、16:9、9:16）需轉換爲 size 參數。接口鑑權使用請求頭 x-api-key，密鑰來自 kexiangai.com。Skill 頁標註 requires_api_key=true。
官方入口：
- API 資料頁：https://api.skillhub.cn/user_4bd21536/zimage
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_4bd21536/zimage
核心功能¶
以下能力均來自 Skill 官方簡介，未額外擴展：
- 文生圖：通過 Z-Image 輕量級文生圖接口生成圖片，底層調用名爲 zImage。
- 意圖識別：適用於用戶要求「生成圖片」「海報圖」「封面圖」「帶中文文字的圖片」，或直接給出比例（1:1、16:9、9:16 等）。
- 比例映射：將用戶的比例要求轉換爲接口的
size參數。 - 按量執行：按用戶要求的數量精確生成，且不得重複執行（同一任務不應多調一次）。
- 明確邊界：不用於圖片編輯、OCR 或視頻生成。
安裝與啓用¶
SkillHub 頁面給出的安裝指引是：依據 SkillHub 安裝與優先源配置，安裝 @user_4bd21536/zimage。下面是與該文檔一致的通用流程；各 Agent 的 skills 目錄不同，需按當前環境替換 --dir 路徑。
先確認是否已安裝 SkillHub CLI：
command -v skillhub && skillhub --version
若未安裝，可使用官方安裝腳本（完整安裝含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
將 Skill 安裝到當前 Agent 的 skills 目錄（必須使用 --dir，否則默認落在 ./skills/ 且可能不被識別）：
skillhub install user_4bd21536/zimage --dir <你的 skills 目錄>
常用客戶端 skills 路徑示例（摘自官方安裝文檔）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝完成後，按你所用 Agent 的說明重啓或刷新技能列表，使 SKILL.md 被加載。
API 密鑰：在 kexiangai.com 獲取可用於 Z-Image 的 key，並在 Agent 或運行環境中配置爲 x-api-key（具體配置方式取決於 Agent 如何讀取 requires_api_key 類 Skill；以各客戶端文檔爲準）。
典型用法¶
zimage 面向自然語言任務，而非手寫腳本。用戶側可這樣描述需求（示例僅說明觸發方式，不代表固定文案）：
- 「生成一張 1:1 的產品概念圖，prompt 寫清楚主體和風格。」
- 「做一張 16:9 的博客封面，標題用中文：某某技術週刊。」
- 「按 9:16 豎版生成一張活動海報，只要一張。」
經過上面的步驟安裝並配置 x-api-key 後，Agent 應在匹配到生成類意圖時調用 zImage，並遵守：
- 傳入 prompt（必填）；
- 若用戶指定比例，將 1:1、16:9、9:16 等映射爲 size；
- 用戶說「要 N 張」時，精確執行 N 次，不重複、不超額。
接口參數名以 Skill 簡介爲準：prompt、size；鑑權頭爲 x-api-key。
適用場景與注意¶
適合誰
- 需要在 Cursor、Claude Code、Codex 等支持 SkillHub 技能的 Agent 裏，穩定承接「生成圖 / 海報 / 封面 / 帶中文文字圖」類對話的開發者或團隊。
- 已能在 kexiangai.com 開通 Z-Image 接口密鑰的使用者。
限制與注意
- 僅文生圖：編輯現有圖、文字識別、視頻生成均不在 Skill 聲明範圍內，應換用其他工具或 Skill。
- 依賴外網 API 與有效 x-api-key；未配置密鑰時無法完成調用。
- SkillHub 頁顯示版本 1.0.0；社區來源（community），行爲以 SKILL.md 與接口方文檔爲準，升級前建議在測試環境驗證。
- 公開頁統計（以抓取資料爲準）：評分 100000，下載 844，安裝 8；與第三方轉載數據可能不一致，以 SkillHub 頁面爲準。
結尾¶
zimage 把 Z-Image 文生圖收斂成一條可安裝的 Agent Skill：明確觸發語、比例到 size 的映射、張數紀律，以及不適用場景。若你的對話裏經常出現封面和海報類需求，可按官方指引安裝 @user_4bd21536/zimage 並配置 kexiangai.com 的 x-api-key。詳情見：https://www.skillhub.cn/skills/user_4bd21536/zimage
