前言¶
DeepSeek Harness (DSH) 采用“一切皆插件”的架构。在构建智能体应用时，若需要处理视觉数据并识别其中的野生动物，手动集成模型成本较高。xby-wild-animal-detection 插件封装了这一能力，使开发者可以直接通过命令调用检测服务。
核心功能¶
该插件提供以下核心能力：
- set_xby_apikey：在聊天中设置 API 密钥。该密钥会自动持久化，重启进程后依然有效。
- wild_animals_detection：输入一张图像，输出图像中所有识别到的野生动物的检测框、置信度及标签。需提供图片文件的链接。
- wild_animals_detection_for_data_base64：输入一张图像，输出图像中所有识别到的野生动物的检测框、置信度及标签。需提供图片文件的 BASE64 编码。
- wild_animals_detection_for_data_file：输入一张图像，输出图像中所有识别到的野生动物的检测框、置信度及标签。需提供图片文件的文件路径。
安装与启用¶
使用 DSH 的 CLI 工具进行安装。
# 格式：dsh plugin --profile <profile> add github:<owner>/<repo>
dsh plugin --profile web add github:xby_skill/xby-wild-animal-detection
安装完成后，插件会自动加载，即可在聊天或脚本中使用上述功能。
典型用法¶
使用前，需要先设置 API 密钥，然后根据图片数据的形式选择对应的检测命令。
- 设置 API 密钥：
在聊天中输入命令设置密钥：
set_xby_apikey <你的API密钥>
- 识别图片：
根据图片存储方式选择命令：
* 图片文件链接：
wild_animals_detection <图片链接>
- 图片文件的 BASE64 编码：
wild_animals_detection_for_data_base64 <BASE64字符串>
- 图片文件的文件路径：
wild_animals_detection_for_data_file /path/to/image.jpg
注意事项¶
- API 密钥依赖：插件依赖小笨羊官网的服务。使用前必须前往该官网注册并获取有效的 API 密钥。
- 运行权限：该插件以当前 DSH 进程的权限运行。安装前请检查源码，确保符合安全要求。
- 许可证：本插件遵循 MIT 许可证开源。
总结¶
该插件为 DSH 智能体提供了基础的野生动物视觉识别能力。通过简单的命令调用，即可在对话流中实现图片分析。插件目录与源码仓库如下：
* 插件目录：https://www.skillhub.cn/plugins/xby-skill/xby-wild-animal-detection
* GitHub：https://github.com/xby-skill/xby-wild-animal-detection
