前言¶
在 DeepSeek Harness (DSH) 的开发过程中，为智能体增加视觉理解能力是常见需求。插件 xby-general-recognition 提供了这一能力，它能够对包含主体物体的图像进行标签识别，并输出主体物体的类别标签，目前已覆盖 5 万多类的物体类别。
这是什么¶
这是一个模型推理类的插件，由 xby-skill 维护。它的核心作用是在对话中直接调用图像识别服务，无需手动借助外部工具，通过输入不同的图片数据形式来获取识别结果。
核心功能¶
插件提供了以下四个主要功能：
-
set_xby_apikey
在聊天中设置 API 密钥。该设置会自动持久化，重启 DSH 后依然有效。 -
general_recognition
对包含主体物体的图像进行标签识别。输入要求是图片文件的链接。 -
general_recognition_for_data_base64
对包含主体物体的图像进行标签识别。输入要求是图片文件的 BASE64 编码。 -
general_recognition_for_data_file
对包含主体物体的图像进行标签识别。输入要求是图片文件的文件路径。
安装与配置¶
在安装前，需要先前往 小笨羊官网 注册并获取 API 密钥。
使用以下命令安装插件：
dsh plugin --profile web add github:xby_skill/xby-general-recognition
安装完成后，在聊天中调用 set_xby_apikey 功能，填入获取到的密钥即可开始使用。
注意事项¶
该插件采用 MIT 许可证。
在安装前，建议检查源码与许可证，确保符合你的使用场景。插件以当前 dsh 进程的权限运行，请确保在安全的网络环境下调用。
