护照识别 OCR

解决什么问题

护照复印件、扫描件或拍照件进入系统时，字段往往分散在人像页与 MRZ 机读码中。手工录入 护照号码、中文姓名、英文姓名、性别、国籍、出生日期、签发日期、有效期至、签发地点 容易错位，MRZ 的校验位和固定栏位也需要专门解析。

技能如何工作

该技能面向两类常见输入：可直接访问的图片链接，以及以 dataBase64 传入的图像 Base64 编码。核心能力是识别上述护照字段，并支持对 MRZ 机读码做结构化解析。

大模型在运行时承担路由层职责：

• 先判断是否已配置 API 密钥；若 scripts.config.settings.api_key 为空，则向用户询问，并通过 scripts.config.set_api_key(api_key) 保存
• 根据用户意图选择工具：图片链接走 scripts.tools.ocr_passport，参数为 dataUrl；Base64 输入走 scripts.tools.ocr_passport_for_data_base64，参数为 dataBase64
• 若缺少必要参数，先通过 AskUserQuestion 补齐，再以关键字参数调用工具
• 工具返回 result["raw"]、result["success"] 与 result["message"]，再将 raw 整理后展示

适用边界

• API 密钥是必需项；缺少密钥时必须向用户询问，禁止自行搜索或编造结果
• 输入只能是护照图片链接或 Base64 图像数据，不含本地文件路径直读能力
• 输出用于字段抽取，不构成证件真伪鉴伪或法律核验
• 处理护照信息时应遵循隐私与数据合规要求，最小化留存敏感数据