身份证OCR识别

要解决的问题

手动核验证件信息往往需要人工对照图片逐字段录入，不仅耗时，还容易因字段错位导致姓名、身份证号或住址被误填。这个技能将这个过程交给接口处理：上传一张证件图片，返回结构化的 JSON，你只需解析字段。

支持多种证件：身份证（含二代身份证正反面）、驾照、护照等。返回字段齐全：姓名、性别、民族、出生年月、家庭住址、身份证号码、签发机关、签发日期、有效期限。

如何工作

在根目录执行脚本 scripts/query_idcard_ocr.py，传入 --pic 指定图片路径，--api-key 可选（如果设置了环境变量 CHINAZ_IDCARD_OCR_API_KEY）。脚本将图片发送给接口，成功后解析返回的 JSON。图片需为 JPG/PNG，不超过 300K。

适用边界与注意点

• 一次只能查询一条记录，批量场景必须逐条执行或自行编写循环。
• 接口返回的 status: 0 表示成功，但数据来自第三方数据源，可能存在更新延迟，仅作参考。
• 不要将 API Key 写入日志或回复中，脚本设计上也不保存完整密钥。
• 遇到 missing_api_key 错误时，需要引导用户去购买页获取 Key。