用途：把一张源图批量导出为 Android 与 iOS 应用图标资源，适用于确定性的图标导出任务，而不是手工图像编辑。
主要能力：生成 android/ 下的 mipmap-* 启动图标 PNG 和 play-store/play_store_icon.png（512px 商店资源），以及 ios/AppIcon.appiconset/ 下的 Contents.json 与对应 PNG。支持 contain 模式（默认，保留完整 logo 并留白）与 cover 模式（填满方形，允许居中裁剪）；可用 --background 设置非方形源图的留白颜色，用 --corner-radius 让导出图标自带圆角，用 --extra-sizes 追加额外的方形 PNG 尺寸，用 --android-adaptive 生成 Android 自适应图标资源。
使用方式：先确认输入图片路径，再运行 python3 scripts/icon_generator.py <input-image> -o <output-dir>。基础示例：python3 scripts/icon_generator.py input.png -o output_icons。带裁剪、白色留白、额外尺寸与圆角的示例：
python3 scripts/icon_generator.py input.png
-o output_icons
--mode cover
--background '#FFFFFFFF'
--extra-sizes 256 384
--corner-radius 18
导出 Android 自适应图标：python3 scripts/icon_generator.py input.png -o output_icons --android-adaptive --adaptive-background '#FFFFFF'。依赖 Pillow，如未安装：python3 -m pip install 'Pillow>=10.0.0'。
结果核查：检查 android/mipmap-* 的启动图标 PNG；检查 android/play-store/play_store_icon.png；检查 ios/AppIcon.appiconset/Contents.json 与生成的 PNG；若启用了自适应图标，检查 android/mipmap-anydpi-v26/ 下的 XML 与 ic_launcher_foreground.png、ic_launcher_background.png。
限制：Pillow 导入报错需先安装依赖并重跑；颜色需用 #RRGGBB 或 #RRGGBBAA 格式；源图缺失时应停止并先确认路径。若需要非方形输出或手工精修，应改用图像编辑流程。参数细节、尺寸清单与输出结构可参考 references/usage.md。