银行卡识别 OCR
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-rn88lg3j/xby-ocr-bank-card。
技能介绍
要解决什么问题
在表单录入、风控核对或支付对接里,经常需要从银行卡照片或截图里读出卡号,并确认号码是否合法、属于哪家银行、是借记还是贷记。纯靠人工抄写容易出错,本地 OCR 又往往不返回发卡行与卡种,也缺少标准的卡号校验。
本技能面向「给一张图,要结构化卡信息」的场景:识别卡号、发卡银行、卡类型,并对卡号做 Luhn 算法有效性校验。
技能如何工作
大模型作为路由层:理解意图、选工具、补全参数,再调用 scripts.tools 里的小笨羊 OCR API,而不是在对话里臆造卡号。
ocr_bank_card:入参为图片dataUrl(可访问的图片链接)。ocr_bank_card_for_data_base64:入参为dataBase64(图片的 Base64)。
典型流程:检查 scripts.config.settings.api_key 是否已配置;若 .env 中无 XBY_APIKEY,须通过 AskUserQuestion 向用户索取密钥并调用 scripts.config.set_api_key 保存;按用户提供的输入形式选 URL 或 Base64 工具;用关键字参数调用对应函数;将返回的 result["raw"] 整理展示,并参考 success / message 说明状态。
适用边界与注意点
- 必须配置 API 密钥(xiaobenyang.com 获取);无密钥时禁止自行搜索或编造识别结果。
- 识别质量依赖图片清晰度、反光、裁剪与遮挡;链接需可访问,Base64 需为完整有效编码。
- Luhn 仅校验号码格式是否符合常见卡号规则,不能替代发卡行侧的真实账户或余额验证。
使用场景
- 商户 KYC 审核收到银行卡正面照,需提取卡号、发卡银行与卡类型,并用 Luhn 校验后再写入审核系统。
- 支付或绑卡联调时,手头是卡面截图的 URL,需调用识别接口拿到结构化字段与校验结果做对照。
- 用户通过对话上传 Base64 编码的卡图,坐席侧 Agent 需输出卡号与发卡行供人工二次确认再绑卡。
- 对账或退款流程里只有卡面图片链接,需补全卡号及发卡银行信息并确认号码格式是否通过 Luhn。
适合人员
- 负责支付绑卡或 KYC 材料审核、要把卡面照片转成可入库字段的风控与合规人员
- 在 Agent 路由层对接小笨羊 OCR、需按 URL 或 Base64 选择 `ocr_bank_card` 工具的后端工程师
- 处理原路退款与用户绑卡申诉、需从卡截图核对卡号与发卡行的财务或客服主管
- 实施金融产品自动化录入、要求识别结果经 Luhn 通过后再提交核心系统的实施顾问