鸟类识别

这个技能解决什么问题

拿到一张野外照片，想快速知道画面里是什么鸟，但你不想手动翻图鉴，也不想把图片上传到一个界面里来回点。这个技能把「图片 → 鸟种」这件事变成一个可直接调用的工具函数：给它一张图片链接或 Base64 编码，它返回 API 的原始识别结果。

典型的触发场景包括：

• 摄影师整理素材时，批量确认拍摄到的鸟种
• 在现有的 AI 应用里嵌入一个鸟类识别模块，由模型自行判断并调用
• 需要对返回的结构化数据做二次处理（例如按置信度过滤、写入数据库）

核心能力

技能内部提供两个工具函数，按输入形式区分：

• scripts.tools.bird_detection：输入图片文件链接地址 dataUrl
• scripts.tools.bird_detection_for_data_base64：输入图片的 Base64 编码 dataBase64

两个函数都执行同一件事：检测并识别图片中的鸟类。模型在这一层只负责路由——理解用户意图、从工具列表中选出正确的函数、提取对应参数，然后以关键字参数的方式调用。真正的识别逻辑在代码侧完成，模型不接触也不生成识别数据。

调用流程按以下步骤执行：

1. 检查 API 密钥是否已配置
2. 根据用户意图选择工具函数
3. 提取该工具所需的参数
4. 使用关键字参数调用工具，例如 scripts.tools.bird_detection(dataUrl='...')
5. 将返回的原始数据整理后展示给用户

函数返回一个 dict 对象，包含 raw（API 原始 JSON）、success（是否成功）和 message（状态消息）三个字段。通常只需把 raw 解析后呈现，或根据 success 判断是否需要重试。

注意点

API 密钥是硬性前置条件。 首次使用时如果未配置 XBY_APIKEY，必须通过交互式问答向用户索取，拿到后调用 scripts.config.set_api_key(api_key) 保存。在没有密钥的情况下，禁止自行搜索或编造识别结果——没有降级路径，缺密钥就是不可用。

参数缺失时同样需要主动询问。如果用户只给了图片但没说明形式，或链接无效、Base64 不完整，应先补齐参数再发起调用，而不是用空值硬调。

适用边界：这个技能只做「检测 + 识别」，返回的是 API 的原始输出。如果你需要后处理逻辑（比如分类汇总、存库、出报告），要在自己的代码里实现；如果图片里没有鸟，是否报错以 API 返回的 raw 与 message 为准。