前言¶
DeepSeek Harness (DSH) 採用插件化架構，旨在降低智能體開發的門檻。在構建涉及文檔處理的智能體時，開發者往往需要集成特定的識別能力。xby-ocr-vehicle-license 是一個現成的模型推理插件，封裝了行駛證識別邏輯，解決了在 DSH 環境中直接調用 OCR 服務的接口問題。
插件介紹¶
該插件由 xby-skill 維護，屬於模型推理類別。它主要用於識別機動車行駛證的關鍵信息，包括號牌號碼、車輛類型、所有人、住址、品牌型號、發動機號碼、車輛識別代號等。插件內置了自動方向檢測和主副頁過濾功能，能夠適應不同擺放角度的圖片，並處理行駛證的主頁或副頁。
核心功能¶
插件提供了以下標準化接口：
set_xby_apikey: 在對話中設置 API 密鑰，配置後自動持久化，重啓 DSH 後依然有效。ocr_vehicle_license: 識別行駛證信息，輸入參數爲圖片文件鏈接。ocr_vehicle_license_for_data_base64: 識別行駛證信息，輸入參數爲圖片文件的 BASE64 編碼。ocr_vehicle_license_for_data_file: 識別行駛證信息，輸入參數爲圖片文件的文件路徑。
安裝與啓用¶
通過命令行安裝該插件，執行以下指令：
dsh plugin --profile web add github:xby_skill/xby-ocr-vehicle-license
安裝完成後，插件將隨 DSH 進程啓動，可通過上述接口在對話或代碼中調用。
使用配置¶
使用前必須獲取 API 密鑰。請前往 小笨羊官網 註冊並獲取密鑰，然後通過 set_xby_apikey 接口將其注入當前會話。
插件會以當前 DSH 進程的權限運行。如果使用 ocr_vehicle_license_for_data_file 接口，請確保當前環境具備讀取對應文件路徑的權限。
注意事項¶
該插件遵循 MIT 許可證。在安裝和使用前，建議開發者檢查源碼與許可證條款。插件依賴外部 API 服務，請確保網絡環境能夠正常訪問。
