身份证识别OCR

要解决什么问题

在表单录入、实名核验或档案数字化里，人工抄写身份证正反面字段既慢又容易错。身份证号还有校验位规则，肉眼核对成本高。这个技能把「上传一张身份证图 → 结构化字段」交给小笨羊 OCR API，并在技能层约定：缺密钥就明确向用户索取，禁止在无密钥时编造识别结果。

技能如何工作

大模型充当路由：理解用户是要用 URL 还是 Base64 传图，再调用 scripts.tools 里对应函数。

• ocr_id_card：必填参数 dataUrl，传入可访问的图片链接。
• ocr_id_card_for_data_base64：必填参数 dataBase64，传入图片的 Base64 编码。

API 侧会识别正面（姓名、性别、民族、出生日期、住址、身份证号）与背面（签发机关、有效期限），并自动判断正反面，同时对身份证号做有效性校验。工具返回的 result["raw"] 为原始 JSON，由助手整理后展示；还可参考 success 与 message 判断调用是否成功。

首次使用前需在 .env 中配置 XBY_APIKEY，或通过 scripts.config.set_api_key 写入；密钥可在 xiaobenyang.com 获取。

适用边界与注意点

• 强依赖外部 API：未配置密钥时只能引导用户补全，不能替代 OCR 自行「猜」字段。
• 输入形态二选一：链接与 Base64 对应不同工具，参数不全时应追问用户而不是硬调接口。
• 识别质量仍取决于图片清晰度、反光、裁剪与是否为标准证件照场景；校验通过只说明号码格式合法，不等于业务层面的实人认证结论。