昆虫识别

要解决什么问题

野外拍照、标本记录或科普场景里，你往往只有一张昆虫或节肢动物的照片，需要快速知道「这是什么」或至少落到目、科、属、种某一级的分类信息。人工查图鉴费时，且非专业人士很难稳定区分近缘种。本技能把识别请求交给小笨羊提供的图像识别 API，由 Agent 负责理解你的输入形式并选对调用方式。

技能如何工作

Agent 充当路由层：先检查是否已配置 XBY_APIKEY（未配置时通过 AskUserQuestion 向你要密钥，并用 scripts.config.set_api_key 写入 .env），再根据你提供的图片形式选择工具：

• insect_recognition：图片为可访问的 URL（dataUrl）
• insect_recognition_for_data_base64：图片为 Base64 字符串（dataBase64）
• insect_recognition_for_data_file：图片为本地文件路径

参数不齐时会追问缺失项；调用 scripts.tools 中对应函数后，应把返回的 result["raw"] 整理展示，并参考 success / message 判断状态。

适用边界与注意点

• 必须有有效 API 密钥；密钥在 xiaobenyang.com 获取。缺少密钥时禁止让模型自行搜索或编造识别结果。
• 识别准确度取决于图片清晰度、角度与 API 能力；文档未承诺离线或本地模型推理。
• 示例代码里的 search_schools 仅为 SKILL 模板残留，与本技能无关，实际只应使用上述三种昆虫识别工具。