动物识别

要解决什么问题

你在做相册整理、科普内容标注或 UGC 审核时，往往需要知道「图里是什么动物」，而不是让模型凭印象猜种类。本技能把这类需求收敛成一次 API 调用：输入一张含动物的图片，返回类别标签，由后端视觉模型完成识别，而不是在对话里编造物种名。

技能如何工作

大模型侧只做路由：理解用户是要用链接还是 Base64，补齐缺失参数，再调用 scripts.tools 里对应函数。

• animal_recognition：必填 dataUrl，传入可访问的图片文件链接。
• animal_recognition_for_data_base64：必填 dataBase64，传入图片的 Base64 编码。

调用前会检查 scripts.config.settings.api_key；若 .env 里没有 XBY_APIKEY，须通过 AskUserQuestion 向用户索取密钥，并用 scripts.config.set_api_key 持久化。工具返回 dict：成功时把 result["raw"] 里的 JSON 整理展示；同时可参考 success 与 message。

适用边界与注意点

• 必须配置 API 密钥（小本洋）；无密钥时禁止自行搜索或编造识别结果。
• 技能面向「含动物的图像」；若用户未提供 URL 或 Base64，应主动追问，而不是假设本地已有文件。
• 识别粒度与标签体系以 API 原始返回为准，前端展示时不要擅自改写成未在 raw 中出现的类别。