在 DSH(DeepSeek Harness)的插件化架构下,为智能体添加图像识别能力通常需要对接外部服务。xby-classify 插件封装了 YOLOv26 模型,提供了在 DSH 环境内直接对图片进行 ImageNet 1000 类分类的接口。
插件简介¶
xby-classify 是由 xby-skill 维护的模型推理类插件。它本身不包含模型权重,而是通过调用外部 API(小笨羊官网)来执行分类任务,返回 Top-5 的预测类别和置信度。
核心功能¶
该插件提供以下主要能力:
- set_xby_apikey:在聊天上下文中设置 API 密钥。设置后,密钥会自动持久化,重启 DSH 后依然有效。
- yolo26_classify:接收图片文件链接,返回 ImageNet 1000 类的 Top-5 类别和置信度。
- yolo26_classify_for_data_base64:接收图片文件的 BASE64 编码,执行分类。
- yolo26_classify_for_data_file:接收图片文件的本地文件路径,执行分类。
安装¶
在 DSH 命令行中执行以下命令即可安装:
dsh plugin --profile web add github:xby_skill/xby-classify
配置与使用¶
获取密钥¶
使用前需要前往 小笨羊官网 注册并获取 API 密钥。
典型用法¶
根据图片来源的不同,使用对应的命令:
- 处理网络图片链接:使用
yolo26_classify,传入图片 URL。 - 处理 Base64 编码图片:使用
yolo26_classify_for_data_base64,传入 Base64 字符串。 - 处理本地文件:使用
yolo26_classify_for_data_file,传入本地文件路径。
注意事项¶
- 分类基于 ImageNet 1000 类标准。
- 返回结果包含 Top-5 类别及对应的置信度。
- License: MIT。
- 插件以当前 DSH 进程的权限运行,处理本地文件路径时需确保路径可访问。
总结¶
该插件为 DSH 开发者提供了一个接入图像分类服务的标准入口。源码与更新可查看 GitHub 仓库。