这是一个基于 Python 和 FFmpeg 开发的桌面客户端工具,专门用于优化身份证明照片,解决上传审核平台时常见的格式、元数据、色彩空间及分辨率问题。
由于部分代码或模型文件体积较大,无法直接上传至 GitHub 仓库。请通过以下网盘链接下载相关资源:
在提交身份验证(KYC)照片时,许多平台对上传的文件有严格限制。常见的报错原因包括:
- 使用了带有透明通道的 PNG 格式。
- 照片包含 Exif/GPS 等敏感元数据或修图痕迹。
- 照片分辨率过低(不清晰)。
- 色彩空间不符合标准(如非 YUV420P)。
本项目通过一个简洁的 GUI 界面,一键自动化处理上述所有技术问题。
- 环境集成:利用 Python 的 Tkinter 构建跨平台图形界面,并集成 FFmpeg 核心处理引擎。
- 多选加载:支持用户通过文件浏览器批量选择多张不同格式的照片。
- 参数配置:
- 格式强制转换:所有输入文件统一输出为
.jpg。 - 元数据剥离:通过
-map_metadata -1指令彻底清除所有 Exif 信息。 - 智能缩放:检测图片宽度,若低于 1200px 则等比放大,确保清晰度。
- 色彩规范:统一使用
yuvj420p色彩空间。
- 格式强制转换:所有输入文件统一输出为
- 多线程处理:使用 Python 线程池异步执行 FFmpeg 命令,确保界面在处理大文件时不卡顿。
- 打包分发:使用 PyInstaller 将所有依赖(包括 FFmpeg 核心)打包成单个独立的
.exe文件。
- FFmpeg 引擎:利用 FFmpeg 强大的多媒体处理能力,进行高质量的图像重采样和属性重写。
- Tkinter GUI:使用 Python 标准库实现轻量级的用户交互界面。
- 单文件封装:通过
sys._MEIPASS动态定位打包后的内部资源,实现无环境依赖运行。
- 启动工具:
- 开发者模式:运行
python optimizer.py或双击run.bat。 - 绿色版:直接双击运行
PhotoOptimizer.exe。
- 开发者模式:运行
- 操作流程:
- 点击 “选择照片”,从本地选取需要优化的证件照。
- 点击 “立即开始优化”。
- 获取结果:
- 处理完成后,工具会自动打开
optimized_output文件夹。 - 使用该文件夹中带
_optimized后缀的文件重新提交即可。
- 处理完成后,工具会自动打开
- 本工具处理过程完全在本地完成,不会上传任何隐私数据到云端。
- 请确保提交的是证件的原件照片,本工具仅进行技术参数优化,不会对证件内容进行任何伪造。
开发者:ongwu
电子邮箱:ongwu007@gmail.com