前言¶
DeepSeek Harness (DSH) 生態強調通過插件擴展智能體的能力。在處理身份驗證、旅行助手等自動化任務時，從護照圖像中提取結構化數據是常見需求。xby-ocr-passport 插件爲 DSH 提供了護照信息識別與 MRZ 機讀碼解析能力。
插件定位¶
名稱：xby-ocr-passport
核心價值：護照識別 OCR
分類：模型推理
維護者：xby-skill
許可證：MIT
功能：識別護照號碼、中文姓名、英文姓名、性別、國籍、出生日期、簽發日期、有效期至、簽發地點等信息，支持 MRZ 機讀碼解析。
核心功能¶
插件提供以下能力：
1. set_xby_apikey：在聊天中設置 API 密鑰，該操作會自動持久化，重啓後依然有效。
2. ocr_passport：識別護照信息。需要輸入圖片文件鏈接。
3. ocr_passport_for_data_base64：識別護照信息。需要輸入圖片文件的 BASE64 編碼。
4. ocr_passport_for_data_file：識別護照信息。需要輸入圖片文件的文件路徑。
安裝與啓用¶
使用官方命令安裝插件：
dsh plugin --profile web add github:xby_skill/xby-ocr-passport
典型用法¶
- 使用前需前往 小笨羊官網 註冊並獲取 API 密鑰。
- 在聊天界面調用
set_xby_apikey命令配置密鑰。 - 調用識別命令時，根據實際環境選擇輸入方式：
- 使用ocr_passport時提供圖片文件鏈接。
- 使用ocr_passport_for_data_base64時提供圖片文件的 BASE64 編碼。
- 使用ocr_passport_for_data_file時提供圖片文件的文件路徑。
注意事項¶
- 使用前必須獲取並配置 API 密鑰。
- 調用識別功能時，必須提供有效的圖片文件鏈接、BASE64 編碼或文件路徑。
- 該插件使用 MIT 許可證，建議在安裝前檢查源碼與許可證條款。
