在 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 倉庫。
