在模型推理場景中,開發者常需要調用視覺識別能力來處理圖像。xby-detect 是一個由 xby-skill 維護的 DSH 插件,提供了一套完整的視覺檢測與識別能力。
簡介¶
xby-detect 屬於模型推理類別,採用 MIT 許可證。它集成了多種視覺任務,支持從日常物體檢測到特定場景(如火焰、反光衣)識別,覆蓋昆蟲、植物、動物、車輛等多個領域。
安裝與啓用¶
在 DSH 環境中安裝該插件,執行以下命令:
dsh plugin --profile web add github:xby_skill/xby-detect
安裝完成後,需在對話中設置 API 密鑰以啓用檢測功能:
set_xby_apikey
核心功能¶
插件提供了豐富的檢測與識別命令,主要分爲以下幾類:
-
通用與專項檢測
包括日常物體檢測 (daily_object_detection)、通用識別 (general_recognition)、車輛檢測 (detect_vehicle)、行人檢測 (detect_pedestrian)、反光衣檢測 (detect_reflective_vest)、安全帽與人體檢測 (helmet_head_person_detection) 等。 -
垂直領域識別
涵蓋昆蟲識別 (insect_recognition)、植物識別 (plant_recognition)、動物識別 (animal_recognition)、鳥類識別 (bird_detection)、野生動物檢測 (wild_animals_detection)、寵物情緒識別 (pet_emotion_recognition)、菜品識別 (dish_recognition) 等。 -
場景與行爲檢測
包括手機檢測 (cellphone_detection)、電動自行車檢測 (ebike_detection)、手勢檢測 (gesture_detection)、吸菸檢測 (smoking_detection) 以及火焰檢測 (fire_detection)。 -
YOLO26 模型系列
提供基於 YOLO26 系列的多種視覺任務:- 目標檢測:
yolo26_detect(80類COCO目標) - 旋轉目標檢測:
yolo26_obb_detect(15類特定目標) - 實例分割:
yolo26_segment(80類COCO目標) - 人體姿態估計:
yolo26_pose_estimate(17個關鍵點) - 圖像分類:
yolo26_classify(ImageNet 1000類)
- 目標檢測:
典型用法¶
以 BASE64 編碼輸入圖片爲例,調用日常物體檢測功能:
daily_object_detection_for_data_base64
系統將輸出圖片中所有人/寵物/車/火焰/紙箱目標的檢測框、置信度和標籤。
調用寵物情緒識別功能:
pet_emotion_recognition
系統將識別寵物面部表情,輸出 Angry / Happy / Relaxed / Sad 四類情緒。
注意事項¶
- 輸入格式:多數檢測類功能支持圖片文件鏈接、BASE64 編碼或文件路徑三種格式。
- API 密鑰:使用前必須通過
set_xby_apikey命令設置 API 密鑰。 - 場景適配:火焰檢測等功能在安防攝像頭、交通攝像頭視角下表現最佳。
結語¶
xby-detect 爲 DSH 插件生態提供了基礎且豐富的視覺識別能力。安裝並配置後,開發者即可在對話或腳本中調用各類檢測接口。