用途：通过 Azure AI 图像 API 使用 MAI-Image-2.5，从文本生成图像，或对提供的 JPEG/PNG 进行编辑，并保存、校验输出结果。
主要能力：文生图与图生图。生成默认 1024x1024，宽高各至少 768 像素且总像素不超过 1,048,576；编辑仅接受 JPEG/PNG 输入，输出固定为 PNG，尺寸由服务决定。MAI-Image-2.5 的图像编辑目前为公共预览功能，不建议在未考虑预览限制的情况下用于生产。
使用方式：需 Python 3.10+，并在当前目录或其父目录的 .env 中提供 AZURE_API_KEY 与 AZURE_IMAGE_ENDPOINT。端点可为资源根、/mai/v1/images、/generations 或 /edits，脚本会自动选择对应路径。文生图示例：python3 .agents/skills/generate-images-mai/scripts/generate_image.py --prompt "A photograph of a red fox in an autumn forest" --width 1024 --height 1024 --output generated_image.png；图生图需加 --input-image garden.png。常用选项包括 --prompt（必填）、--input-image、--output（默认 generated_image.png）、--width、--height、--model（默认 MAI-Image-2.5）、--endpoint、--env-file、--force。进程内已有环境变量优先于 .env。
适用场景：需要快速生成配图或基于现有图像做定向编辑，并校验输出可用性。
限制与安全：切勿读取、打印、返回、提交或在生成文件、命令、日志、聊天中嵌入 API 密钥；不要创建含真实密钥的 .env。若目标文件已存在，除用户明确要求替换外不得覆盖。输出须校验非空且可解码为图像，必要时用看图工具检查并在图像空白、异常或明显跑题时重新生成。失败时按缺少配置、无效输入图、认证失败、端点或部署失败、b64_json 缺失、内容策略拒绝、图像损坏等情况分别处理，密钥验证应在本地进行。