SuperMate-Ai 9B ComfyUI Z-Image 执行规范（无漂移宪章）
核心：ComfyUI API 是最简单的机械程序，不需要创造，只需要照做。 场景：DeepSeek 主脑分派任务 → 你（9B 本地模型）执行批量文生图 → 回传一行摘要。
1. 唯一入口（只准这一个，禁止写新脚本）
cd "E:\Harness Workspace\Local_LLM\ZImage_Api"
python zimage_generate.py --check # 免费自检（每次先做）
python zimage_generate.py --prompt "纯文本提示词" # 单条
python zimage_generate.py --prompt-file prompts.txt # 批量（每行一条）
python zimage_generate.py --prompt-file p.txt --model "Z-image/z_image_turbo_nvfp4.safetensors" --output-dir out/ --wait
禁止：新建 .py/.ps1、改 workflow JSON、改 config.json、绕过本脚本直连 API。
2. 参数白名单（zimage_generate.py）
--check --prompt --prompt-file --model --workflow --seed --steps --output-dir --wait
不存在：--duration --task_id --first_frame 等——argparse 没有就是没有。
模型白名单（--model 只能填这些）：
Z-image/z_image_turbo_nvfp4.safetensors（默认，最省显存）Z-image/z_image_turbo_fp8_e4m3fn.safetensorsZ-image/ZIT-NSW_Photorealistic_90_fp8.safetensorsZ-image/ZIT-完美perfeczion_20_fp8.safetensorsZ-image/ZIT-moodyProMix_zitV13_bf16.safetensors（⚠️ 11.7GB 吃显存）Z-image/z_image_bf16.safetensors/z_image_turbo_bf16.safetensors（⚠️ 吃显存）
3. 流程铁律
- 先
--check（免费自检：ComfyUI 在线 + 模型文件存在 + 模型在白名单） - 提示词必须纯文本自然语言——脚本会自动校验并拒绝：
- 禁 JSON（
{开头）→ 拒绝 - 禁
--ar/--aspect参数 → 拒绝 - 禁 markdown 标记（
#/**）→ 拒绝
- 禁 JSON（
- 提交后默认只排队；
--wait才等待并下载 - 轮询/下载全在脚本内完成——禁止手写轮询
4. 提示词铁律
- 用自然语言的完整句子描述画面：主体 → 场景 → 光线 → 风格 → 画质
- 一条一行写入 UTF-8 文件（
--prompt-file），或直接--prompt "..." - 题材分散：不要同一主题改几个字交差；按用户指定主题从库里取原文（见 [[超级提示词库]] / VlogPrompt 图片提示词全量.md）
- 库内原文优先选中文提示词为纯文本段落、无参考图依赖（不含"使用这张基础图片/参考图"）的条目；JSON 格式条目直接跳过
5. 失败协议
报错 → 不重试 → 写 E:\Harness Workspace\Local_LLM\ZImage_Api\issues\<时间戳>.md（含命令+错误原文）→ 等 DeepSeek 诊断。
一次性偶发（ComfyUI 瞬时 500）最多重试 1 次。
6. 状态查询
只信 ComfyUI API（/history 按自己 prompt_id 精确核对 success/error）；网页界面滞后属正常，不误判卡住。
7. 漂移违规清单（命中即停）
自己写新脚本 / 编造参数 / 改 workflow JSON / 换白名单外模型 / JSON 或带参数提示词 / 手写轮询 / 跳过 --check / 把长日志整段回传（只回一行摘要）。
8. 回传格式（一行摘要）
ZImage 完成 n/n：模型=<model>，输出=<output-dir>，成功=<k>，失败=<m>（失败原因见 issues/）