在 DeepSeek Harness (DSH) 开发中，处理用户上传的银行卡图片并提取关键信息（如卡号、发卡行、卡种）是一项常见需求。手动解析不仅耗时，而且容易出错。xby-ocr-bank-card 插件通过对接 OCR 服务，可以自动识别并利用 Luhn 算法校验卡号有效性，直接集成到 DSH 工作流中。
插件定位¶
该插件由 xby-skill 维护，属于联网工具类别。它是一个银行卡识别工具，能够从图片中提取银行卡号、发卡银行和卡类型，并提供卡号合法性校验。
核心功能¶
插件提供了三个主要工具函数，支持不同的输入方式：
- set_xby_apikey：在聊天中设置 API 密钥。设置后密钥会自动持久化，重启 DSH 进程后依然有效。
- ocr_bank_card：识别银行卡信息。输入参数为图片文件链接。
- ocr_bank_card_for_data_base64：识别银行卡信息。输入参数为图片文件的 BASE64 编码。
- ocr_bank_card_for_data_file：识别银行卡信息。输入参数为图片文件的文件路径。
所有识别功能均包含使用 Luhn 算法校验卡号有效性的逻辑。
安装与启用¶
使用 DSH CLI 进行安装：
dsh plugin --profile web add github:xby_skill/xby-ocr-bank-card
使用前置条件¶
使用前需要前往小笨羊官网注册并获取 API 密钥。
典型用法¶
- 设置密钥：
在聊天中输入以下命令设置 API 密钥：
set_xby_apikey <你的API密钥>
- 识别银行卡：
根据输入数据类型的不同，选择对应的函数调用：- 使用图片链接：
ocr_bank_card https://example.com/bank-card.jpg
* 使用 Base64 编码：
ocr_bank_card_for_data_base64 iVBORw0KGgoAAAANS...
* 使用本地文件路径：
ocr_bank_card_for_data_file /path/to/bank_card.png
注意事项¶
- 插件需要输入有效的图片文件链接、Base64 字符串或文件路径才能完成识别。
- 由于插件以当前 DSH 进程权限运行，建议在安装前检查源码逻辑与许可证（MIT）。
总结¶
该插件为 DSH 开发者提供了一个标准化的银行卡信息提取方案。更多技术细节与源码，请访问 GitHub 仓库。
