前言¶
在对话式开发环境里，「根据一段描述出一张图」往往还要切到网页控制台或自己接 HTTP。提示词、尺寸、参考图和结果 URL 分散在多步操作里，Agent 也很难按统一约定执行。若你已经在用 dLazy 托管的生成 API，更希望 Skill 只负责把「即梦文生图」封装成可复现的 CLI 调用，jimeng t2i 就是面向这一需求的社区 Skill。
这是什么¶
jimeng t2i（坐标 @user_f95f21b8/dlazy-jimeng-t2i）是 SkillHub 上分类为 design-media 的社区 Skill，当前版本 1.0.9。官方简介为：Text-to-image generation with Jimeng, quickly converting text to high-quality images.
Skill 本体遵循通用 SKILL.md 格式，由发布者 user_f95f21b8 上架；底层通过 dlazyai 维护的 @dlazy/cli 调用 dLazy 托管 API，对接即梦（Jimeng）文生图能力。SkillHub 页面标注 requires_api_key=true，使用前需配置 dLazy API Key。
核心功能¶
以下能力均来自 Skill 包内 SKILL.md / SKILL-cn.md（v1.0.9）：
- 文生图：以
--prompt提交提示词，经dlazy jimeng-t2i调用后端，默认模型标识为jimeng-t2i-v40。 - 可选参考图：支持
--images，最多 10 张，可为 URL 或本地路径（本地文件会经 CLI 上传到files.dlazy.com）。 - 多种输出尺寸：
--size提供多组分辨率（默认1440*2560），完整可选列表见下方用法中的-h输出。 - 调试与异步：
--dry-run可打印 payload 与费用估算而不真正请求；--no-wait返回generateId，可用dlazy status <generateId> --wait轮询。 - Agent 触发词：文档列出如 jimeng、即梦、文生图、generate image 等关键词，便于在对话中唤起该 Skill。
成功时 CLI 返回 JSON，其中 result.outputs 含图片 URL（托管于 files.dlazy.com）。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
按 SkillHub 安装文档 检查或安装：
command -v skillhub && skillhub --version
未安装时可执行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 将 Skill 装到当前 Agent 的 skills 目录¶
安装时必须使用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能无法被加载。SkillHub 文档给出的常见路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令：
skillhub install @user_f95f21b8/dlazy-jimeng-t2i --dir ~/.cursor/skills/
也可让 AI 按官方页面提示，参照 https://skillhub.cn/install/skillhub.md 完成同一坐标的安装。
3. 安装并配置 dLazy CLI¶
Skill 元数据要求本机具备 npm / npx，并固定 CLI 版本 1.0.9：
npm install -g @dlazy/cli@1.0.9
或不全局安装、按需调用：
npx @dlazy/cli@1.0.9 <command>
配置 API Key（写入 ~/.dlazy/config.json，亦可用环境变量 DLAZY_API_KEY）：
dlazy auth set YOUR_API_KEY
Key 需在 dlazy.com 控制台 API Key 页 创建或复制。
典型用法¶
Agent 侧的核心指令是执行 dlazy jimeng-t2i 获取结果。先查看帮助：
dlazy jimeng-t2i -h
常用参数摘要（与官方文档一致）：
--prompt [prompt] 提示词
--images [images...] 参考图 [image: url or local path] (max 10)
--size [size] 尺寸 [default: 1440*2560]
--dry-run 打印 payload 与费用估算，不调用 API
--no-wait 异步任务立即返回 generateId
--timeout <seconds> 等待异步完成的最长时间（默认 1800）
基础文生图示例：
dlazy jimeng-t2i --prompt '夕阳下的城市天际线，赛博朋克风格'
带参考图时，官方示例为（注意示例中使用 --image 单数形式，与 -h 中的 --images 并存，以你本地 dlazy jimeng-t2i -h 为准）：
dlazy jimeng-t2i --prompt '提示词内容' --image '/path/to/image.png'
调用前可用 --dry-run 核对参数与预估消耗。
适用场景与注意¶
适合谁
- 已在 dLazy 开通 API、希望在 Cursor / Claude Code / 其他支持 Skill 的客户端里用自然语言驱动即梦文生图的团队或个人。
- 需要 Agent 统一走
dlazy命令、输出结构化 JSON（含图片 URL）的自动化流程。
限制与注意
- 依赖与网络：需 Node 生态（npm/npx）、可访问
api.dlazy.com与files.dlazy.com；提示词与上传的媒体会发往 dLazy 服务端，使用前请阅读 dlazy.com 服务条款。 - 计费与余额：API 按 dLazy 账户计费；返回
insufficient_balance时需到控制台充值（文档链接：https://dlazy.com/dashboard/organization/settings?tab=credits）。 - 鉴权失败：
unauthorized表示 Key 缺失或无效，需重新dlazy auth set或设置DLAZY_API_KEY。 - 社区来源：SkillHub 标记来源为 community，上架者为 user_f95f21b8；CLI 源码在 github.com/dlazyai/cli，安装前可自行审阅。
- SkillHub 数据（抓取时）：评分 100000，下载约 1110 次，安装记录 2；页面数据会变动，以 SkillHub 实时展示为准。
结尾¶
jimeng t2i 把即梦文生图收敛为 Skill + dlazy jimeng-t2i 一条链路：在 Agent 里写清提示词与尺寸，由 CLI 对接 dLazy API 并返回可下载的图片 URL。若你要从商店安装或核对版本，可参考：
- API 入口：https://api.skillhub.cn/user_f95f21b8/dlazy-jimeng-t2i
- SkillHub 页面：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-jimeng-t2i
