xby-ocr-pass：DeepSeek Harness 港澳臺通行證識別插件

前言¶

DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。當需要在智能體流程中處理實體證件並提取結構化信息時，通常涉及繁瑣的圖像處理和解析邏輯。xby-ocr-pass 插件旨在將這一過程封裝爲標準接口，使開發者能夠直接調用識別能力。

插件介紹¶

這是一個由 xby-skill 維護的模型推理類插件，開源協議爲 MIT。它專注於處理港澳通行證和臺灣通行證，能夠識別證件號碼、姓名、性別、出生日期、有效期、簽發地點等信息，並支持 MRZ（機讀碼）解析。

安裝¶

在終端中執行以下命令進行安裝：

dsh plugin --profile web add github:xby_skill/xby-ocr-pass

安裝完成後，插件將隨 DSH 進程啓動並生效。

核心功能¶

插件提供以下四個主要功能接口：

1. set_xby_apikey
   在聊天或交互環境中設置 API 密鑰。該設置會自動持久化，重啓 DSH 後依然有效。

2. ocr_pass
   執行通行證識別。需要輸入圖片文件鏈接。識別結果包含通行證號碼、姓名、性別、出生日期、有效期、簽發地點等字段，支持 MRZ 機讀碼解析。

3. ocr_pass_for_data_base64
   執行通行證識別。需要輸入圖片文件的 BASE64 編碼。識別邏輯同上，但數據輸入方式爲編碼字符串。

4. ocr_pass_for_data_file
   執行通行證識別。需要輸入圖片文件的文件路徑。識別邏輯同上，但數據輸入方式爲本地文件路徑。

配置與使用¶

獲取密鑰¶

插件依賴外部 OCR 服務，需要配置 API 密鑰。請前往 小笨羊官網 註冊並獲取密鑰。

使用步驟¶

1. 在 DSH 環境中調用 set_xby_apikey 接口，傳入從官網獲取的密鑰。
2. 根據輸入數據的來源，選擇 ocr_pass、ocr_pass_for_data_base64 或 ocr_pass_for_data_file。
3. 確保輸入的圖片鏈接、BASE64 編碼或文件路徑有效且符合證件格式。

注意事項¶

• 插件運行需要有效的 API 密鑰，否則無法完成識別。
• 不同的識別命令對輸入數據的要求不同：ocr_pass 依賴鏈接，後兩者依賴 Base64 或文件路徑。
• 使用前建議檢查源碼與許可證（MIT），確保符合項目合規要求。

參考資源¶

• 插件目錄
• GitHub 倉庫