前言¶
在 Agent 里做配图，常见做法是接一家固定云厂商的官方 SDK，或自己维护多套 HTTP 调用脚本。模型一换，Base URL、鉴权方式和请求体往往都要改一遍。若你已经在用第三方「中转 API」（同一套 Key 和网关地址背后聚合多种图像模型），更需要的是：让 Agent 按统一流程走文生图、图生图和多图任务，而不是每次在对话里重复贴 endpoint 和参数说明。
下面介绍 SkillHub 上的 生图外挂.Skill（坐标 @user_2c58fc0f/ch12893719743826428329324），它通过用户自备的中转接口接入 GPT Image 2.5、Nano Banana 2.1 等模型，把图像能力挂到任意支持 Skills 的 Agent 上。
这是什么¶
生图外挂.Skill 是 SkillHub design-media 分类下的社区 Skill（来源：community），当前页面版本为 v5.2.1，发布者为 user_2c58fc0f（SkillHub 页面作者显示为 HenryChen）。
一句话定位：让 Agent 经中转 API 调用图像模型，完成 文生图、图生图、多图创作；Skill 标签标明 requires_api_key=true，需要你自己提供可用的 API Key（及对应中转服务）。
官方页面：https://www.skillhub.cn/skills/user_2c58fc0f/ch12893719743826428329324
核心功能¶
以下能力均来自 SkillHub 官方简介，未在页面单独展开的实现细节不作延伸描述。
- 中转接入多类图像模型：通过中转网关使用 GPT Image 2.5、Nano Banana 2.1 等（页面表述为「等」，未逐一列出完整模型表）。
- 文生图：根据自然语言描述生成图像。
- 图生图：在已有图像基础上按提示修改或重绘（页面与同类 Skill 的常见能力对齐，具体参数以 Skill 内说明为准）。
- 多图创作：支持多图相关创作场景（官方简介中的「多图创作能力」，未在公开页给出逐步示例）。
安装与启用¶
SkillHub 推荐先安装 skillhub CLI，再把 Skill 安装到当前 Agent 实际读取的 skills 目录；装错目录会导致 Agent 识别不到，需重启或重新加载后生效。安装流程以 https://skillhub.cn/install/skillhub.md 为准。
1、检查或安装 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
2、安装本 Skill¶
将 @user_2c58fc0f/ch12893719743826428329324 安装到你当前环境的 skills 目录。--dir 必须指向 Agent 配置的目录，例如 Cursor 常用路径为 ~/.cursor/skills/：
skillhub install @user_2c58fc0f/ch12893719743826428329324 --dir ~/.cursor/skills/
其他客户端的常见目录（同样来自 SkillHub 安装文档，按你实际使用的工具替换 --dir）：
- Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/ - Windsurf：
~/.codeium/windsurf/skills/或项目.windsurf/skills/
安装完成后，按所用 Agent 的要求重启或刷新 Skills 列表。
3、API Key 与中转服务¶
Skill 标记 requires_api_key=true：你需要自行准备中转服务商提供的 API Key，以及该服务要求的 Base URL / 模型 ID 等信息。公开 SkillHub 页面未列出固定配置文件名或字段 schema；首次在对话里启用生图时，应把中转商文档中的 endpoint、模型名和 Key 交给 Agent，并确认 Skill 内是否会把配置写入本地（以安装包内 SKILL.md 为准）。
典型用法¶
公开页未附带可复制的一键 curl 示例，可复现的流程如下。
- 完成上一节的 CLI 安装与
skillhub install。 - 在 Agent 对话中说明要使用 生图外挂.Skill，并给出任务类型，例如：「文生图，竖版海报，标题某某」或「参考这张图做图生图，保持构图、换背景」。
- 按 Agent 提示补全 中转 API 的 Key 与模型标识（仅在你信任的环境提供 Key；勿提交到公开仓库）。
- 生成结果一般为图片文件或 Agent 可访问的 URL，保存路径取决于 Skill 脚本与 Agent 工作区策略。
若你使用 Cursor，安装目录为 ~/.cursor/skills/ 后，在同一项目里直接描述图像需求即可，由 Agent 加载 Skill 后调用中转接口。
适用场景与注意¶
适合谁
- 已在用或计划用第三方图像中转 API，希望 Agent 统一走 Skill 流程，而不是手写多份调用代码。
- 需要在对话里快速切换 GPT Image 2.5、Nano Banana 2.1 等页面提到的模型能力，做配图、改版、多图类任务。
限制与注意
- 依赖外部中转：画质、限速、计费与合规由你选择的网关决定，Skill 本身不替代服务商 SLA。
- Key 安全：
requires_api_key=true意味着 Key 会进入 Agent 运行上下文；仅在可信环境使用，并遵循中转商密钥轮换建议。 - 版本与统计：SkillHub 页面当前为 v5.2.1；社区 Skill 的下载量、评分会随时间变化，以安装前页面显示为准。
- 未公开细节勿臆测：例如具体 OpenAI 兼容路径、Gemini 原生协议字段、NewAPI / One API 适配方式等，在未安装 Skill 并阅读其
SKILL.md前，本文不写入未核实配置项。
结尾¶
生图外挂.Skill 把「中转 API + 多模型图像能力」封装成 Agent 可加载的 Skill，面向文生图、图生图与多图创作；安装坐标为 @user_2c58fc0f/ch12893719743826428329324，需自备 API Key。详情与安装入口：https://www.skillhub.cn/skills/user_2c58fc0f/ch12893719743826428329324
