在模型推理场景中，开发者常需要调用视觉识别能力来处理图像。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 插件生态提供了基础且丰富的视觉识别能力。安装并配置后，开发者即可在对话或脚本中调用各类检测接口。
