前言¶
做內容、做界面或做原型時，配圖往往卡在「找圖」和「改圖」上：關鍵詞搜到的素材不對題，自己畫又慢。把文生圖、圖生圖接到對話式 Agent 裏，可以用自然語言描述需求，由 Skill 走統一流程去調雲側能力，而不是每次手寫 SDK 或翻控制台文檔。
下面介紹 SkillHub 上的 HY Image Generation（@tencent-adm/hy-image-generation），它把騰訊雲混元生圖 3.0 封裝成 Agent Skill，面向「描述生成圖片」和「參考圖再生成」兩類任務。
這是什麼¶
HY Image Generation 是騰訊雲智能創作團隊在 SkillHub 發佈的企業來源 Skill（分類 design-media），當前版本 v1.0.2。一句話定位：基於騰訊雲混元生圖 3.0，支持文生圖與圖生圖，按文本描述（及圖生圖場景下的參考圖）生成更貼合意圖的圖片。
Skill 座標爲 @tencent-adm/hy-image-generation；SkillHub 頁面標註 requires_api_key=true，使用前需要準備騰訊雲側 API 憑證，具體變量名與配置步驟以安裝包內 SKILL.md 爲準。
核心功能¶
以下能力均來自官方簡介，未在資料中出現的參數或接口不寫：
- 文生圖：根據文字描述生成圖片。
- 圖生圖：在已有圖片基礎上，按描述進行再生成或風格/內容調整（具體交互以 Skill 文檔爲準）。
- 混元生圖 3.0：後端爲騰訊雲混元生圖 3.0 能力，由 Skill 在 Agent 側編排調用，減少自行對接 HTTP/SDK 的成本。
安裝與啓用¶
官方 SkillHub 頁面建議：讓 AI 按 SkillHub 安裝與優先源配置 安裝本 Skill。
1、安裝 SkillHub CLI（若尚未安裝）¶
先確認本機是否已有 skillhub：
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
2、安裝 HY Image Generation¶
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/，Agent 可能識別不到。常見路徑示例（以你實際環境爲準）：
| Agent / 客戶端 | Skills 目錄（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝命令：
skillhub install @tencent-adm/hy-image-generation --dir <你的 skills 目錄>
也可先搜索再安裝：
skillhub search hy-image-generation
skillhub install @tencent-adm/hy-image-generation --dir <你的 skills 目錄>
3、API Key 與啓用¶
Skill 標籤標明需要 API Key。安裝完成後，在對應 skills 目錄下打開該 Skill 的 SKILL.md，按文檔配置騰訊雲憑證並確認 Agent 已加載該目錄（部分客戶端需重啓或刷新技能列表）。不要在文章或倉庫裏硬編碼密鑰。
Cursor、Codex CLI、Claude Code 的差異主要體現在 skills 目錄路徑 與各自如何刷新技能；安裝命令本身均爲 skillhub install，資料中未單獨列出各客戶端不同的安裝包名。
典型用法¶
資料側可復現的步驟是「安裝 + 在對話中啓用 Skill」：
- 按上一節將
@tencent-adm/hy-image-generation裝到當前 Agent 的 skills 目錄，並完成 API Key 配置。 - 在對話中說明需求，例如：爲某段文案生成封面圖、按參考圖生成同風格變體、或根據分鏡描述批量出圖。Agent 在命中本 Skill 後，會按 SKILL.md 中的流程調用混元生圖 3.0。
官方頁面未公開獨立的 curl 示例或固定 prompt 模板；具體請求字段、輸出路徑、圖生圖如何傳參考圖，以安裝後的 SKILL.md 爲準，避免與版本 v1.0.2 不一致。
適用場景與注意¶
適合誰
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的客戶端，希望把「配圖」變成對話內一步完成的團隊或個人。
- 願意使用騰訊雲混元生圖、並能自行申請與保管 API Key 的開發者。
限制與注意
- 企業來源 Skill（
enterprise），使用與計費以騰訊雲混元生圖產品及你的賬號策略爲準。 - 必須配置 API Key；未配置時 Skill 無法完成雲端調用。
- 生成內容需遵守平臺與騰訊雲相關合規要求；商用前請覈對服務條款與版權約定。
- SkillHub 統計（截至資料抓取）：評分 100000，下載 6436，安裝 298；安裝量低於下載量時，常見原因是未裝到正確
--dir或未配置密鑰。
結尾¶
HY Image Generation 把混元生圖 3.0 的文生圖、圖生圖能力接到 Agent 工作流裏，適合用自然語言驅動配圖、又不想每次從零對接雲 API 的場景。安裝走 SkillHub 標準流程，憑證與調用細節以包內文檔爲準。
- SkillHub 頁面：https://www.skillhub.cn/skills/tencent-adm/hy-image-generation
- 官方地址：https://api.skillhub.cn/tencent-adm/hy-image-generation
- 安裝說明：https://skillhub.cn/install/skillhub.md
