翔云银行卡 OCR 识别

要解决什么问题

在 KYC、支付绑卡或财务录入里，人工抄写银行卡号很容易出错，而且卡面信息分散在卡号、发卡行、卡类型等多个字段。本技能把翔云开放平台银行卡识别 API（typeId=17）接到对话流程里：你给一张卡面图，它返回结构化 JSON，便于后续校验、入库或导出。

技能如何工作

1. 配置凭证：优先读取技能目录下的 config.json（key / secret）。缺失时会引导你去 netocr.com 个人中心领取 ocrKey 与 ocrSecret 并写入配置，避免每次重复询问。
2. 接收图片：支持本地路径、Base64 字符串；URL 会先下载再转 Base64。识别走 Base64 接口 POST https://netocr.com/api/recogliu.do，也支持文件上传 POST https://netocr.com/api/recog.do。
3. 调用与缓存：通过 scripts/recognize.py 发起识别；成功后会将结果保存为与图片同名的 {图片名}.json，同级目录落盘，减少重复计费调用。
4. 结果展示与导出：默认可表格展示卡号、卡类型、卡名称、银行名称、银行编号等字段。仅当你明确要求「导出 / 保存 / CSV / Excel」时，才用 export.py 生成文件；导出时优先 --from-dir 读取已缓存 JSON。

适用边界与注意点

• typeId 固定为 17，不可改成其它证件类型。
• 图片建议 JPG/PNG/BMP；普通场景约 200KB、24 位色深；扫描件建议 300 DPI 且小于 3MB。格式或体积不合会触发 10003/10004 等错误码。
• config.json 含敏感信息，勿提交到 Git；认证失败（10001）或余额不足（10002）需重新配置或充值。
• 技能为通用 Python 3.x 脚本封装，不绑定特定 IDE；更完整的请求/响应说明见技能内 references/api_docs.md 与官方文档 bankCard.html。