LiYing

LiYing是什么
LiYing是一款专为证件照处理设计的自动化照片处理程序，旨在简化证件照拍摄后的后期处理流程。它能够自动完成人体和人脸识别、角度纠正、背景替换（支持任意背景色）、尺寸裁切（适配各种常见证件照尺寸，如1寸、2寸等）以及照片排版等功能。该工具最大的特点是完全离线运行，所有图像处理操作均在本地完成，无需依赖云端服务器，从而保障用户隐私和数据安全。

LiYing的主要功能包括：自动识别人体和人脸，确保照片主体正确；智能纠正拍摄角度，保证照片符合证件照的规范要求；支持任意背景色替换，用户可根据需求更换为纯色或其他指定背景；提供多种尺寸的证件照自动裁切功能，并能按照标准格式自动排版，方便直接打印或进一步处理。此外，LiYing还支持多尺寸相片纸排版（如3×3、2×2、4×2等布局），满足不同打印需求。

该工具适用于需要快速处理证件照的个人用户、照相馆、企业HR等场景，能够大幅提升证件照处理效率，减少人工操作步骤。LiYing通过自动化流程解决了传统证件照处理中耗时、技术门槛高的问题，为用户创造了便捷、高效、隐私安全的价值。无论是普通用户自行处理证件照，还是专业机构批量处理，都能从中受益。

LiYing使用示例
使用LiYing处理证件照非常简单，以下为基本操作流程：

1. 下载与安装：如果是Windows用户且无需查看代码，可直接下载官方提供的整合包（已在Windows 7 SP1和Windows 10上测试）。整合包默认不包含模型文件，需根据指引下载对应模型并放置到正确目录（如LiYing/src/model）。

2. 运行方式：
– 运行整合包中的BAT脚本处理单张照片，例如：进入LiYing目录后运行 run.bat ./images/test1.jpg，程序会自动处理指定路径的照片。
– 如需使用WebUI界面操作，运行 run_webui.bat 脚本，然后通过浏览器访问 http://127.0.0.1:7860 即可使用图形化界面上传和处理照片。

3. 参数配置：LiYing支持通过命令行参数（CIL）自定义处理选项，例如指定照片类型（如1寸、2寸）、背景色、尺寸配置、是否压缩、是否排版、是否替换背景等。运行 python main.py –help 可查看所有参数说明，灵活适配不同证件照需求。

4. 模型下载：首次使用需下载项目所需的AI模型（如人脸识别模型Yunnet、背景替换模型RMBG-1.4/2.0、人体姿态识别模型yolov8n-pose等），并将模型文件放置到指定目录（如LiYing/src/model），或通过参数指定模型路径。部分模型需转换为ONNX格式，官方已提供转换好的模型供直接下载使用。

5. 自定义配置：程序内置了常见的证件照尺寸配置（如size_XX.csv）和颜色配置（如color_XX.csv），用户可根据需求修改CSV文件，自定义尺寸、背景色等参数，灵活适配各类证件照标准。