用途：基于 HivisionIDPhotos API 生成合规证件照，适用于拍证件照、换底、修改证件照尺寸、查询证件照规格，或提到一寸、二寸照片等场景。
主要能力：支持一寸、二寸、小一寸、小二寸、大一寸、护照、港澳通行证等预设尺寸；支持白底、蓝底、红底及自定义 HEX 背景色；默认 300DPI 输出；可自定义宽高；可生成 6 寸相纸排版照；可选择不同抠图模型。
使用方式：需先部署 API 服务，例如 docker run -d -p 8080:8080 linzeyi/hivision_idphotos python3 deploy_api.py，并设置 export IDPHOTO_API_URL="http://127.0.0.1:8080"。快速使用命令为 bash {skillDir}/scripts/idphoto.sh --image photo.jpg --color blue --size 一寸。自定义尺寸示例：bash {skillDir}/scripts/idphoto.sh --image photo.jpg --color white --width 390 --height 567。参数包括 --image（必需）、--color（默认 white）、--size、--width、--height、--output（默认 .）、--dpi（默认 300）。处理流程为：先 POST /idphoto 完成人脸检测、抠图、人脸对齐与裁切，输出透明底 RGBA PNG；再 POST /add_background 叠加指定背景色，输出 JPG 成品。
高级用法：可编辑脚本中的 HEAD_HEIGHT_RATIO、HEAD_MEASURE_RATIO、TOP_DISTANCE_MIN、TOP_DISTANCE_MAX 调整人脸比例；可用 curl 调用 /generate_layout_photos 生成排版照；抠图模型可选 hivision_modnet（默认，纯色换底最佳）、modnet_photographic_portrait_matting（最快）、birefnet-v1-lite（精度最高，适合精细发丝与半透明衣物）。完整 API 文档见 references/openapi.yaml。
限制与排查：连接失败需检查 IDPHOTO_API_URL 与 Docker 是否运行；人脸未检测建议使用正面、光线均匀的照片；裁切偏上或偏下可调整 head_height_ratio 与 top_distance_*；文件过大可用 /set_kb 端点压缩。来源为 HivisionIDPhotos（MIT）。