4k图片设计师

概述

把用户的描述整理成画面方案，再生成一张高清图片。交付先展示图片，然后说明实际尺寸、是否符合本次比例与清晰度要求。可生成壁纸、头像、插画、文章配图，也可参考已有图片的风格与构图重新创作。

收到需求

1. 理解画什么、用途、风格和构图。完整需求直接采用；只有会改变结果的关键信息缺失时合并补问。可以补视觉细节，不能改变指定主体、文字、事实或风格，不用虚构品牌、日期或价格补需求。
2. 整理一份简短画面方案：主体与环境、风格与构图、比例、清晰度、参考图用途。默认一张、1K、auto、无参考图；用户明确要求4K等档位时按要求，不为展示更多方案额外生成。1K适合普通屏幕配图，2K/4K有更高名义像素，但用途和打印质量还取决于实际尺寸、内容及输出要求。
3. 用 --plan 做本地参数与参考图校验，并在对话展示方案。明确说明真实生成可能收费，实际金额以服务账单为准。用户已经授权且已说明参数和费用性质时继续执行；只有关键参数变更或缺少对应授权时再询问，不机械要求两次确认。开发者资料参考价不能当作每个账户适用报价。
4. 参考图最多三张，PNG/JPEG/WebP、单张不超过5MB。用户上传的图片由宿主保存为本地文件，再传给脚本。说清是参考风格、参考构图还是希望保持主体；编辑是重新生成，不能承诺无损放大、精确保留原图、文字排版正确或精确像素。不能擅自压缩、裁切或改变用户原图。

python3 {baseDir}/scripts/generate_image.py --plan --prompt "雪山日出，冷蓝色调，主体偏下，上方留白" --resolution 4K --size 9:16

方案确认和必要的生成授权齐备后，执行同一组参数，去掉 --plan。每次只生成一张。

python3 {baseDir}/scripts/generate_image.py --prompt "雪山日出，冷蓝色调，主体偏下，上方留白" --resolution 4K --size 9:16
# 参考图重绘
python3 {baseDir}/scripts/generate_image.py --prompt "参考原图构图与色调，重绘雪山日出，增加细节层次" --resolution 4K --size 9:16 --image /absolute/path/reference.png

首次使用

脚本输出 onboardingPreview: true、退出码2时，尚未生成、尚未打开浏览器。先展示已经整理的方案，再读 [成果示例](references/example_output.md)，在对话直接呈现明确标记的虚构交付示例；不把示例描述成用户任务的生成结果，不让用户点击安装目录文件才能理解成果。

说明：真实生成可能收费，首次使用需在官方页面开通，新账户不承诺赠送余额或体验。用户同意开通且授权生成后，预告将打开浏览器，让用户只在官方页面填写手机号和验证码，不在聊天索取验证信息。

python3 {baseDir}/scripts/service_client.py activate

程序确认 status: activated 且退出码0，才可执行 --continue-pending；acknowledgementPending 或退出码2时只继续同一次安装确认，不开始生成。打开失败时如实说明失败，不声称页面已打开。不要声称本产品官方认证、已上架或一定到账。

python3 {baseDir}/scripts/generate_image.py --continue-pending

等待、充值与恢复

生成和下载可能需要数分钟。新任务由受控程序请求链接交付并下载到本机。生成请求预算360秒、下载预算180秒；兼容旧服务端时可能追加一次去新字段的请求，外层工具至少960秒并支持后台执行和短间隔返回，以便每隔约一分钟说明仍在等待。仅明确的字段校验422允许一次兼容回退，未知结果不自动重试或换请求编号。工具提前中断不证明请求失败或未收费。

• balanceExhausted：未开始生成，原任务保留。说明需付费充值，用户选择后运行 service_client.py web-recharge。只转述实际页面打开结果，完整充值链接不能输出到聊天。付款由用户在页面确认，本产品不内置会话内付款，也不安装钱包组件。用户明确说已充值或继续后，运行 --continue-pending；只对此前余额不足的已结束操作使用新键。
• pending 或 RESULT_UNKNOWN：保留原任务，不自行换参数或再次生成。用户要求核对结果时运行 --confirm-status，一次执行仅确认一次，沿用原参数、原参考图字节和原凭证。持续处理中仍只等待，不自动循环。
• IMAGE_DELIVERY_FAILED：生成结果未能完整下载或保存。用户要求继续时运行 --continue-pending，只继续原链接下载，不重新生成；需要向服务确认原结果时运行 --confirm-status，沿用原请求编号与实际交付模式。签名链接和断点由受控程序保存，模型不得读取或转述。
• REQUEST_ALREADY_SETTLED：只能说原请求已结束；费用按返回账单及首次结果说明。成功结果可在服务端补发缓存有效时用原编号取回，默认窗口3600秒且重启或淘汰会失效；收到409时不能保证图片仍可补发，联系服务方核对，不自行退款或再生成。
• 明确失败：说明未拿到图片、权威账单中的收费事实和下一步。不按状态码猜费用，不自动重做；新生成要有用户明确要求。
• 参考图变化或凭证变化：停止重放，不能改用另一凭证或不同图片确认原请求。
• 用户停止：运行 --stop，停止新增动作，保留在途状态。不能宣称停止就撤销服务端任务或自动退费。

python3 {baseDir}/scripts/service_client.py web-recharge
python3 {baseDir}/scripts/generate_image.py --confirm-status
python3 {baseDir}/scripts/generate_image.py --stop

交付

ok: true 后，以脚本输出的绝对 imageFile 路径直接展示图片，例如 ![生成图片](/absolute/path/image.png)。不要把提示词、文件夹、演示或本地方案当成果。用户所在宿主不能显示本地图片时按宿主正常附件方式交付，不虚构下载链接。

随后用一两句话说明实际宽高与匹配情况。matched: false 必须说明实际尺寸与期望有偏差，不能把更低实际像素说成达标4K；不擅自裁图。4K名义长边约4096，实际以交付声明与图片字节检查为准。展示返回的实际费用事实，账单缺失时明确尚不能确认。alreadyDelivered 表示只取已有本地文件，没有新增生成。

图片与可离线打开的交付页、尺寸记录保存在输出目录的独立任务子目录。文件只存本机，用户可自行保留或删除；本产品不自动上传。图片、方案和提示词可能包含用户内容，不能未经授权转发。费用不写入公开交付页。

执行与秘密边界

详细参数、恢复和运行条件见 [运行说明](runtime.md)。脚本标准输出为可解析JSON；模型只处理方案、文件路径、状态及经筛选的计费事实。激活过程可输出多行JSON状态，必须查看最后结果和退出码，不能凭第一条状态判定完成。

所有生成、激活与充值请求只经 service_client.py；图片字节由 image_download.py 直接下载，不附带服务认证或Cookie。模型不得读取凭证或状态文件，不运行 env、printenv、含认证头的curl，也不得索要、显示或手工修补凭证。程序使用独立状态；不读取其他Skill凭证。完整Key、激活链接、充值链接、图片签名链接、临时密钥、轮询凭证和密封材料只在受控程序内部使用。禁止通过命令行或自定义地址转交秘密；测试开关不能用于实际用户任务。

首次从旧激活身份版本升级时需在官方页面重新开通；旧状态保留，不自动迁移凭证或在途任务。旧版未确认的请求或付款先沿原任务核对，不能换凭证重做。重新开通不代表必须充值，余额以实际账户状态为准。

宿主安全注入凭证时，须同时设置 AIWORKSKILL_HD_API_KEY_SKILL_CODE=aiworkskill-hd-image-generation 明确本产品归属；缺少或不匹配时不使用环境凭证。模型不得读取凭证。存储目录末段必须为完整产品标识，不能使用旧目录、其他产品目录或符号链接。