在 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
