在 DeepSeek Harness (DSH) 的生態中,模型推理能力通常需要通過插件集成。xby-detect-vehicle 是一個用於圖像中車輛識別的推理插件,它通過調用外部 API 來完成檢測任務,避免在本地部署重型模型。
插件定位¶
該插件由 xby-skill 維護,屬於模型推理類插件。它的核心作用是接收圖像數據,識別其中的車輛類型(car, truck, bus, motorbike, tricycle, carplate),並返回對應的檢測框、置信度和標籤。
核心功能¶
插件提供了以下能力:
set_xby_apikey:在聊天中設置 API 密鑰,該操作會自動持久化,重啓 DSH 進程後依然有效。detect_vehicle:輸入圖片文件鏈接,輸出車輛檢測結果。detect_vehicle_for_data_base64:輸入圖片文件的 BASE64 編碼,輸出車輛檢測結果。detect_vehicle_for_data_file:輸入圖片文件的文件路徑,輸出車輛檢測結果。
安裝與啓用¶
使用官方提供的命令直接安裝:
dsh plugin --profile web add github:xby_skill/xby-detect-vehicle
使用前置條件¶
該插件依賴外部服務,使用前需完成以下步驟:
- 前往小笨羊官網註冊賬號。
- 獲取對應的 API 密鑰。
- 在 DSH 中調用
set_xby_apikey設置該密鑰。
典型用法¶
根據圖片來源的不同,選擇對應的檢測函數:
- 圖片鏈接:使用
detect_vehicle,輸入圖片的 HTTP/HTTPS 鏈接。 - Base64 編碼:使用
detect_vehicle_for_data_base64,輸入經過 Base64 編碼的字符串。 - 本地文件:使用
detect_vehicle_for_data_file,輸入圖片在系統中的絕對路徑。
注意事項¶
- 檢測功能依賴小笨羊 API,請確保網絡連通及密鑰有效。
set_xby_apikey設置的密鑰僅對當前 DSH 進程有效,但會自動持久化保存,重啓依然生效。
參考資料¶
- 插件目錄:https://www.skillhub.cn/plugins/xby-skill/xby-detect-vehicle
- 源碼倉庫:https://github.com/xby-skill/xby-detect-vehicle