港澳台通行证识别

要解决什么问题

跨境业务、出入境辅助填表或档案数字化时，经常需要从港澳通行证、台湾通行证照片里抽出结构化字段：通行证号码、姓名、性别、出生日期、有效期、签发地点，以及证件背面的 MRZ 机读码。人工录入慢且易错，通用 OCR 又往往对证件版式和 MRZ 规则不熟。

本技能把「理解用户意图 → 选接口 → 传参 → 展示 API 结果」拆清楚：大模型只做路由，实际识别由小笨羊云端 API 完成。

技能如何工作

1. API 密钥：首次使用若未配置 XBY_APIKEY，须通过 AskUserQuestion 向用户索取密钥，再调用 scripts.config.set_api_key 写入；密钥可在 xiaobenyang.com 获取。
2. 选工具：

- 用户提供图片 URL → scripts.tools.ocr_pass(dataUrl=...)
- 用户提供 Base64 图片 → scripts.tools.ocr_pass_for_data_base64(dataBase64=...)

1. 返回：工具返回 result["raw"]（JSON 原始数据）、success、message；应将 raw 整理后直接展示，禁止在无密钥时自行搜索或编造识别结果。

参数不全时用 AskUserQuestion 补问；调用工具一律使用关键字参数。

适用边界与注意点

• 强依赖 API：没有有效密钥时技能不可用，不能假装已识别。
• 输入形态二选一：要么可访问的图片链接，要么完整 Base64，缺一则需向用户确认。
• 清单若与其它名称（如「香烟检测」）不一致，以 SKILL 文档与上述 OCR 能力为准。