xby-pet-detect：宠物情绪识别插件

前言¶

DeepSeek Harness (DSH) 采用“一切皆插件”的架构，允许开发者通过插件扩展模型推理能力。xby-pet-detect 是一个专注于模型推理的插件，由 xby-skill 维护。它主要用于解决宠物面部表情识别的需求，将图片输入转换为结构化的情绪分类数据。

安装¶

通过 DSH 的插件管理工具安装，支持从 GitHub 仓库安装或本地调试。

从 GitHub 安装¶

使用官方安装命令添加插件：

dsh plugin --profile web add github:xby_skill/xby-pet-detect

本地开发调试¶

若需进行本地开发，可使用绝对路径安装或通过 patch 文件调试：

dsh plugin --profile web add /absolute/path/to/xby-pet-detect

dsh web --profile web --patch /absolute/path/to/dsh-ocr-plugin/cordis.patch.yml

核心功能¶

该插件提供三个主要的推理接口，支持不同的图片输入格式。

1. set_xby_apikey
   在聊天中设置 API 密钥。该操作会自动持久化，重启 DSH 进程后依然有效。

2. pet_emotion_recognition
   识别宠物面部表情，输出 4 类情绪：Angry / Happy / Relaxed / Sad。
   - 输入要求：需要输入图片文件链接。

3. pet_emotion_recognition_for_data_base64
   识别宠物面部表情，输出 4 类情绪：Angry / Happy / Relaxed / Sad。
   - 输入要求：需要输入图片文件的 BASE64 编码。

4. pet_emotion_recognition_for_data_file
   识别宠物面部表情，输出 4 类情绪：Angry / Happy / Relaxed / Sad。
   - 输入要求：需要输入图片文件的文件路径。

前置条件与配置¶

插件依赖外部 API 服务，使用前需完成以下配置。

获取 API 密钥¶

插件需要前往小笨羊官网注册并获取 API 密钥。
- 官网地址：https://xiaobenyang.com

使用步骤¶

1. 在 DSH 聊天环境中调用 set_xby_apikey 命令设置密钥。
2. 根据图片来源，选择对应的识别接口：
   - 若图片为链接，使用 pet_emotion_recognition。
   - 若图片为 Base64 字符串，使用 pet_emotion_recognition_for_data_base64。
   - 若图片为本地文件，使用 pet_emotion_recognition_for_data_file。

生态背景¶

DSH 插件目录（https://www.skillhub.cn/plugins/xby-skill/xby-pet-detect）与 DeepSeek 或幻方研究院无官方从属关系。该插件遵循 MIT 许可证，开发者可自由使用与修改。