翔云护照识别 OCR

要解决什么问题

跨境业务、KYC 或档案数字化里，护照信息往往仍靠人工对照图片录入：号码、姓名拼音、签发与有效期等字段多、格式不统一，批量处理还容易出错。本技能把结构化解析交给翔云开放平台证件识别 API（typeId=13），在 Agent 对话里完成「收图 → 调 API → 展示字段 → 按需导出」。

技能如何工作

1. 配置凭证：通过 scripts/config_manager.py 读取 skill 根目录的 config.json；缺失时引导用户到 netocr.com 获取 ocrKey / ocrSecret 并写入本地。
2. 接收图片：支持本地路径、Base64 字符串；URL 需先下载再转 Base64。
3. 调用识别：recognize.py 请求 Base64 接口 POST https://netocr.com/api/recogliu.do 或文件上传接口 recog.do；成功后在图片同级目录缓存 {图片名}.json，避免重复扣费。
4. 展示与导出：结果以表格展示；仅当用户明确要求导出时，用 export.py 生成 CSV / Excel / JSON，并优先 --from-dir 读取已缓存 JSON。

可提取字段包括护照号码、姓名、姓名拼音、性别、出生日期与地点、签发日期、有效期限、签发机关、国籍等，覆盖中国及多国护照场景。

适用边界与注意点

• typeId 固定为 13，不可改；config.json 含密钥，勿提交仓库。
• 图片建议 JPG/PNG/BMP，普通图约 200KB、扫描件 300DPI 且小于 3MB；反光、遮挡会导致 -1 识别失败。
• 错误码 -3/-5 为次数或余额不足，-4 为认证失败，需重新配置 key/secret。
• 导出不会自动触发；本技能为通用 Python 3.x 脚本，不绑定特定 IDE。