Qwen-Image-3.0 图像生成

本文是入口文件。先读「铁律」，再按「任务路由」读取对应 reference，然后调用 scripts/qwen-image.ps1。

铁律（每次任务必记）

0. 模型固定 qwen-image-3.0-pro。 这是本 skill 的默认与主线。仅当用户明确要求更快或更省，才降到 qwen-image-3.0。不要因为「省事」或「不确定」而换模型。
1. 先读 reference，再写提示词。 提示词质量直接决定出图上限。禁止凭记忆套模板——每个题材的写法都在 references/prompt-guide.md 里，动手前必读。
2. -Size 必须用星号。 写 1024*1536，不是 1024x1536。服务端只认 DashScope 的星号格式，写成 x 直接 400。总像素须落在 512×512 至 2048×2048 之间，宽高比限 1:8 至 8:1。脚本已内置校验，但不要依赖它兜底。
3. 图生图禁止 -PromptExtendMode agent。 agent（智能体增强）仅 T2I 支持，I2I 场景传了必然 400。脚本会提前拦截并报错。
4. 默认开启 prompt_extend 与 enable_thinking，不要随手关。 这两个是模型能力的放大器：前者自动补全简短提示词，后者在出图前做推理规划，对复杂构图与文字排版提升显著。
5. 长提示词走 -PromptFile。 超过 2000 字符的提示词写进 UTF-8 文本文件，用 -PromptFile 读取，避免命令行转义损耗与 shell 长度限制。
6. 图片 URL 只有 24 小时有效期。 脚本会立即下载落盘；永远不要把服务端返回的 URL 当交付物。
7. 描述画面的物理构成，而不是情绪形容词。 写「午后三点右侧落地窗斜射光」而不是「唯美光影」；写「粗针织开衫的毛线纹理与褶皱阴影」而不是「质感的衣服」。模型能渲染前者，渲染不了后者。
8. 默认只出 1 张，不要擅自加 -N。 多图是成倍计费（1K 档约 $0.034/张）。用户没明确要候选或多版本时，先出 1 张定方向。确需批量，先告知张数与预估费用。
9. 失败不要盲目重试。 每次重发都是真实计费。先按 references/api-guide.md 的错误码表定位，确认修正点后再发。本 skill 不做自动降级或自动重试，避免无声烧钱。
10. 防同质化是硬要求。 不得复用 references/prompt-guide.md 里的例句措辞，不得固定结构顺序与起手维度，不得每张都走同类题材或同一尺寸。该文件第 7、8 节是强制约束，出图前逐条对照。

任务路由

执行

& "<skill目录>\scripts\qwen-image.ps1" -Prompt "..." [选项]

关于两个默认开启的开关。 提示词改写（prompt_extend）与思考模式（enable_thinking）默认都开着，它们是模型能力的放大器：前者补全你写得简短的提示，后者在出图前做推理规划。两者开启时你给的底稿越具体，服务端改写越不容易漂——不要因为「反正会被改写」就写得简略。只有排查问题才关掉它们。

输出与旁车记录

图片默认落在 skills/qwen-image/output/，每批同时写一个同名 .json 旁车记录，内含本次使用的模型、完整提示词、全部参数、输入图路径、request_id 与 usage。

微调重出时先读旁车记录，在原有参数基础上只改需要变的那一层，不要凭记忆重写提示词。这是让迭代可归因、可复现的前提。

交付前检查（强制执行）

1. 用 read_image 打开生成的图，确认画面与用户意图一致。
2. 放大看手。 逐只确认指头数量与分离度。手是最高频的崩坏点，与提示词质量无关，只能靠检查发现。
3. 涉及文字的需求，逐字核对有无错字、漏字、字形崩坏。
4. 反查用户原话。 逐个核对提示词里出现的可见物件，有没有用户没提过的——侧写最容易在无意间引入。
5. 发现偏差时，把偏差写成新的约束补进提示词重出，不要带着问题交付。手部崩坏优先降低动作复杂度，而不是加「五指分明」这类词。
6. 向用户报告图片路径与本次实际使用的模型。

环境

• 端点：POST https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
• Key：环境变量 QWEN_TOKEN_PLAN_CN_API_KEY，缺省从 $DSH_HOME/.credentials.yaml 或 ~/.dsh/.credentials.yaml 读取
• 输出目录：默认 skills/qwen-image/output/，可用 -OutDir 覆盖
• 该模型不是对话模型，不走 /chat/completions，不会也不应出现在 DSH 的模型选择器里