证照照片检测与优化 v0.05

对证件照进行质量检测与自动优化。支持多种规格（身份证、寸照），调用证照家API，自动图像优化，并将结果按合格/不合格分类存放。

支持的规格

| ID | 规格名称 | 像素尺寸 | 打印尺寸 | 常用场景 |

|----|----------|----------|----------|---------|

| 740 | 二代身份证 | 358×441 | 26×32mm | 身份证、社保卡、居住证 |

| 623 | 一寸 | 295×413 | 25×35mm | 简历、入职、报名表、学生档案 |

| 626 | 二寸 | 413×626 | 35×53mm | 职称申报、教师资格证、证书 |

| 621 | 小一寸 | 260×378 | 22×32mm | 港澳台通行证 |

| 622 | 大一寸 | 390×567 | 33×48mm | 护照、签证、公务员考试 |

| 624 | 小二寸 | 413×531 | 35×45mm | 日本/韩国签证 |

| 625 | 大二寸 | 425×650 | 36×55mm | 司法考试、注会、建造师 |

首次使用：配置凭证

将 assets/config.json 中的占位符替换为真实凭证：

{
  "app_key": "从证照家平台获取的AppKey",
  "app_secret": "从证照家平台获取的AppSecret"
}

> 凭证获取：登录 证照家平台 → 管理中心 → API密钥

使用方式

安装依赖

pip install requests

单张检测

python scripts\idphoto.py "D:\photo.jpg" "身份证"
python scripts\idphoto.py "D:\photo.jpg" "一寸"
python scripts\idphoto.py "D:\photo.jpg" 740

批量检测

python scripts\idphoto-batch.py "D:\photos文件夹" "身份证"
python scripts\idphoto-batch.py "D:\photos文件夹" 740
python scripts\idphoto-batch.py "D:\photos文件夹" "护照"

支持的输入格式

| 输入方式 | 示例 | 说明 |

|----------|------|------|

| 规格名称 | 身份证 一寸 二寸 | 自然语言匹配 |

| 规格ID | 740 623 626 622 | 直接指定数字ID |

| 交互选择 | （不填参数） | 显示菜单选择 |

> 匹配到规格后会显示确认信息（名称、尺寸、用途），确认后才执行检测。

输出结构

证照检测结果_日期/
├── 合格/              ← API处理后的照片
└── 不合格/            ← 原图（方便复查重拍）

检测状态说明

| flag | 含义 | 处理方式 |

|------|------|---------|

| 1 | ✅ 合格 | 保存处理后照片到 合格/ |

| 0 | ❌ 不合格 | 复制原图到 不合格/，并显示原因 |

| -1 | 检测中 | 自动轮询等待 |

依赖

• Python 3 + requests
• 有效的证照家 AppKey + AppSecret

版本历史

| 版本 | 说明 |

|------|------|

| v0.05 | 新增规格确认环节；同步7种规格（含ID/尺寸/用途/关键词）；清理文档残留内容 |

| v0.04 | 支持多规格 + 自然语言匹配 + 交互式菜单 |

| v0.03 | 清理版：移除Node.js相关文件，仅保留Python版本 |

| v0.02 | 新增 Python 版本 |

| v0.01 | 初始版本 |