技能介绍

要解决什么问题

野外红外相机每晚产生上千张图像，人工翻看筛出动物、记录种类极其耗时；而通用目标检测模型对野生动物的长尾类别（比如豹猫与猞猁、不同鹿种）识别能力弱，小目标、遮挡、夜间图像误检和漏检都很常见。开发者真正需要的是：给一张图，直接拿到该图中所有野生动物的检测框、置信度和标签，用于后续统计、归档或告警，而不是自己标注数据、训练模型或去调一个对动物类别不敏感的通用检测 API。

技能如何工作

这个技能采用「大模型做路由、代码做调用」的分工：

大模型负责理解用户意图、选择工具函数、从对话中提取参数；scripts.tools 中的代码只负责把请求发给 API 并拿回原始数据。
按输入形式提供三个工具函数：图片链接走 scripts.tools.wild_animals_detection；Base64 编码走 scripts.tools.wild_animals_detection_for_data_base64；本地文件路径走 scripts.tools.wild_animals_detection_for_data_file。三者输出一致：所有识别到的野生动物的检测框、置信度及标签。
标准流程：检查密钥 → 按用户意图选择工具 → 提取必填参数 → 以关键字参数调用，例如 scripts.tools.wild_animals_detection(dataUrl=...) → 将 result["raw"] 中的 JSON 整理后展示给用户，同时利用 result["success"] 和 result["message"] 判断调用状态。

适用边界与注意点

API 密钥是硬性前提：运行时需要配置 XBY_APIKEY。若当前环境中没有，必须通过 AskUserQuestion 向用户询问，拿到后调用 scripts.config.set_api_key() 保存；禁止在缺少密钥时自行搜索或编造检测结果。
参数不完整时（例如用户没给出图片地址），应先用 AskUserQuestion 追问缺失参数，而不是带着空值调用。
该技能只做「图 → 检测框/置信度/标签」这一件事，不做视频流、不做跟踪、不做物种细粒度分类后处理，超出这个范围的需求需要自行在原始返回数据上扩展。