在 DSH 插件生態中，處理駕駛證這類結構化證件信息通常需要編寫額外的解析邏輯。xby-ocr-driver-license 是一個專注於駕駛證識別的插件，由 xby-skill 維護，歸類於模型推理。它能夠直接從駕駛證的主頁和副頁中提取關鍵信息。
功能說明¶
該插件提供以下核心能力：
- set_xby_apikey：在聊天中設置 API 密鑰。該操作會自動持久化密鑰，重啓進程後依然有效。
- ocr_driver_license：識別駕駛證主頁和副頁。需要輸入圖片文件鏈接。
- ocr_driver_license_for_data_base64：識別駕駛證主頁和副頁。需要輸入圖片文件的 BASE64 編碼。
- ocr_driver_license_for_data_file：識別駕駛證主頁和副頁。需要輸入圖片文件的文件路徑。
識別字段包括駕駛證主頁的證號、姓名、性別、國籍、住址、出生日期、準駕車型、初次領證日期、有效期限，以及副頁的檔案編號。
安裝與配置¶
使用該插件前，需先獲取 API 密鑰。
- 獲取密鑰：前往小笨羊官網註冊並獲取 API 密鑰。
- 安裝插件：執行以下命令進行安裝。
dsh plugin --profile web add github:xby_skill/xby-ocr-driver-license
安裝完成後，插件即可在當前 DSH 進程中使用。
使用示例¶
安裝成功後，可通過以下指令調用功能。
- 設置 API 密鑰（首次使用必須執行）。
set_xby_apikey <your_api_key>
- 識別圖片文件鏈接。
ocr_driver_license https://example.com/driver_license.jpg
- 識別圖片文件的 BASE64 編碼。
ocr_driver_license_for_data_base64 <base64_string>
- 識別圖片文件的文件路徑。
ocr_driver_license_for_data_file /absolute/path/to/image.jpg
注意事項¶
- 許可證：本插件採用 MIT 許可證開源。
- 運行權限：插件以當前 dsh 進程的權限運行，安裝前請檢查源碼與許可證是否符合需求。
- 數據來源：識別服務依賴於小笨羊的 API 接口，請確保已按官網指引獲取有效密鑰。
