Intel 图像生成器
请将 scripts/ 相对于此文件的路径解析。在用户工作区中使用绝对输出路径。
首先生成前检查
在每次生成之前，使用相同的模型/设备选项运行 --info：
SKILL_DIR="/absolute/path/to/intel-image-generator"
env -u VIRTUAL_ENV uv run --project "$SKILL_DIR/scripts" --locked intel-image-generator --info
该命令输出包含 device 和 model 的 JSON。它不会下载、验证、编译或运行模型。根据用户的请求和下面的兼容性表检查所选设备和模型。不要因为 --info 成功就声称未测试的模型可用。除非用户请求覆盖，否则使用报告的模型。不要静默地替换为其他模型。
然后使用相同的选项、提示词和输出路径生成。省略 --device 以保持自动选择，或在用户请求时使用显式设备：
env -u VIRTUAL_ENV uv run --project "$SKILL_DIR/scripts" --locked intel-image-generator \
--size 512x512 --seed 42 --steps 20 \
-p "一只友好的大象，扁平插画" \
-o /absolute/path/to/output.png
检查退出状态以及输出是否存在；然后返回其路径。如果更改模型/设备选项，请先重新运行 --info。
选项
--info（仅长选项）不需要提示词或输出。生成需要恰好一个 -p/--prompt 文本 或 -i/--input 路径（UTF-8 编码，每行一个提示词，忽略空白行），加上 -o/--output 路径。从文件读取的提示词会顺序生成，每个提示词生成一张图像，多个图像保存为 stem-1.ext、stem-2.ext 等。每个文件都是原子性的；所有目标路径都会预先验证，失败的运行可能会保留之前完成的图像。-m/--model 命名空间/仓库 选择兼容的模型；--model-dir 路径 选择本地导出目录（两者互斥）。其他选项：--size 宽x高、--seed 整数、--steps 整数、--device NPU|GPU|CPU。
对于参考图像调节，使用 -r/--reference 路径 和 --model stable-diffusion-v1-5/stable-diffusion-v1-5。这使用 IP-Adapter 进行文本到图像生成，而非图像到图像；它不保证角色一致性或精确的风格。不能与 --source、--strength 或 --model-dir 一起使用。即使该模型是默认模型，也必须明确指定，包括在 NPU 上默认模型不同的情况。首次使用会下载数个 GB 的数据并创建单独的导出。不要静默地更改模型。
对于图像到图像（img2img），使用 -s/--source 路径 作为起始图像，并可选择 --strength 浮点数（大于 0 且最多为 1，默认 0.75）。--strength 需要 --source。--style 已被移除；现在 -r 选择参考调节，-s 选择 img2img 源图像。
如果不指定 --device，集成 Intel GPU 的系统偏好顺序为 NPU → GPU → CPU；独立 Intel GPU 系统偏好 GPU → NPU → CPU。未知的 GPU 类型或无法检测 GPU 属性会回退到 CPU。显式指定的设备是严格的。编译/推理错误不会触发设备重试。
NPU 模型兼容性
这是此技能的单一模型兼容性列表。证据仅适用于确切的模型和软件配置，并非所有衍生版本。
| Hugging Face 模型 | 此 CLI 的 NPU 状态 |
|---|---|
stable-diffusion-v1-5/stable-diffusion-v1-5 | CPU/GPU 默认；NPU 已测试： 本地导出；在 Lunar Lake Intel AI Boost 上使用 OpenVINO 2026.4.1 / Optimum Intel 1.27.0 成功生成。 |
OpenVINO/stable-diffusion-v1-5-fp16-ov | 兼容的 SD 管道候选版本；此处未在 NPU 上测试。不要承诺成功编译。 |
OpenVINO/stable-diffusion-v1-5-int8-ov | NPU 默认；在 Lunar Lake 上使用 OpenVINO 2026.4.1 / Optimum Intel 1.27.0 成功生成了一张图像。 |
Intel/sd-1.5-square-quantized | Intel 在其卡片上标有 NPU，但其仓库缺少所需的 Diffusers model_index.json/组件布局。不能直接与此 CLI 的 --model 一起使用。 |
SDXL 和 FLUX 需要其他管道支持，并且在此 CLI 中不是可选择的 NPU 替代方案。不要仅仅为了测试兼容性而自动下载候选版本。
模型安全检查器已被禁用。有关设置、首次运行成本、模型/许可证详情以及故障排除，请参阅 README.md。不要静默地回退到 CPU 或进行未经批准的系统/驱动更改。