前言¶
在对话式开发环境里，用户常会直接说「帮我生成一张封面」「做张 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
