项目图片生成
这是 Axhub Make client 对系统 imagegen 能力的项目入口。当前项目需要新生成、编辑或派生位图图片/视觉素材时,先使用本技能;系统 imagegen 规则作为下游通用规范,不绕过本技能的工具与配置选择。
工作流
- 如果当前环境提供内部图片生成 MCP 或图片生成工具,优先使用。
- 内部图片生成工具不可用时,读取 Axhub Make 服务端图片配置:
- 只读取
<AXHUB_MAKE_HOME_DIR or user home>/.axhub/make/server.config.json。 - 使用
ai.imageGeneration.baseUrl、ai.imageGeneration.apiKey和ai.imageGeneration.model。
- 只读取
- 如果服务端配置缺失或不完整,再读取本地 Codex 配置/认证路径:
- 始终检查
CODEX_HOME,然后检查用户 home 下的.codex。 - Windows 还要检查 AppData/ProgramData 下的 Codex 配置目录。
- macOS/Linux 还要检查 XDG Codex 配置目录。
- 从
config.toml读取 providerbase_url;从auth.json读取 API key。
- 始终检查
- 配置完整时,直接以
baseUrl、apiKey、model作为 Image Gen provider settings 执行;现有配置即授权使用该 provider/model,不再追加 CLI/API 确认,其他生成规则继续遵循系统imagegen技能。 - 如果当前 MCP、工具或 API 不支持单次生成多张图片,而用户需要多张图片,应发起多次生成请求,不要把需求降级成只生成一张。
- 生成派生产物时(例如基于现有图片/原型做变体、扩图、局部重绘、风格迁移、素材补图或素材拆分),必须把原图或相关原型截图作为参考图传给图片生成工具;传参使用本地文件路径,不要只在提示词里文字描述,也不要传远程 URL。如果当前只有页面或预览链接,先导出真实运行截图到本地,再把该本地路径传入。
如果没有项目服务端配置或本地配置,则回退到系统 imagegen 的默认行为。
提示词应聚焦实际图片用途:目标画面、输出角色、尺寸/比例、视觉风格、精确文案、透明背景需求,以及输出保存位置。UI、网站、插画和普通视觉素材都按正式生产资产描述,不默认使用低保真表达。
写给第三方图片生成工具的提示词,应按真实产品或正式界面来描述,不要传递内部 prototype 概念。只有用户明确要求低保真、线框图、占位图或草稿时,才使用 wireframe、placeholder、draft 等词。
设备与画布比例
在调用图片生成工具前,必须先判断目标载体,并把画布比例写进提示词或工具参数。gpt-image-2 的 API 参数 size 可以使用符合约束的自定义尺寸:宽高都必须是 16 的倍数,最长边必须小于 3840px,长短边比例不超过 3:1,总像素在 655360 到 8294400 之间。设备真实比例写进提示词;不要把不符合约束的设备物理尺寸直接传给 size。
用户没有明确指定尺寸时,按以下默认值处理:
| 场景 | 默认画布 | 工具尺寸建议 |
|---|---|---|
| 手机 App、小程序、移动端 H5 整屏 | 竖向手机屏,约 9:19.5,接近 390x844 |
768x1664;需要更高清时用 1168x2528,并在提示词中强调手机整屏比例 |
| PC Web、后台、SaaS、桌面端产品页 | 横向桌面屏,16:10 或接近 1440x900 |
1440x896;需要更高清时用 1920x1200 |
| 平板界面 | 4:3 或 3:4,按横竖屏需求选择 |
使用最接近的合规 size,例如 1536x2048 或 2048x1536,并在提示词中说明平板横/竖屏 |
| 图标、头像、独立素材矩阵 | 1:1 |
1024x1024 |
| 插画、头像、装饰图等独立素材 | 1:1;按素材形态调整 |
1024x1024,并在提示词中说明透明背景或素材边界 |
| Banner、封面、Hero 背景 | 16:9、21:9 或用户指定平台比例 |
使用满足 Image 2 约束的横向尺寸,例如 1920x1088 |
如果用户说“移动端、手机、App、小程序、H5”,默认使用竖向手机整屏;不要生成方图、横图、平板比例或宽得像桌面端的手机 UI。如果用户说“PC、Web、后台、SaaS、Dashboard、管理端、桌面端”,默认使用横向桌面画布;不要生成手机竖屏。只有用户明确说“自适应/多端”时,才分别生成移动端和 PC 端多张图。
写最终提示词时加入类似字段:
Canvas/aspect ratio: mobile portrait phone screen, about 9:19.5, 390x844 logical pixels.
Device target: modern smartphone app full screen.
Frame treatment: show one complete phone screen UI, no browser chrome unless requested, no tablet or desktop layout.
Avoid: square canvas, landscape canvas, tablet-like proportions, cropped UI, extra outer mockup scene.