植物识别

要解决什么问题

野外或相册里拍到一株不认识的植物，你往往只有一张照片：没有标本号、也没有本地图鉴对照。若希望模型给出科、属、种乃至亚种层面的名称，而不是凭视觉「猜一个像的」，就需要走专门的识别 API，并把图片以链接或 Base64 等形式传给后端。

技能如何工作

本技能把大模型当作路由层：理解用户是要「认这株植物」，再按输入形式选用工具并补齐参数。

• scripts.tools.plant_recognition：必填 dataUrl，传入可访问的图片文件链接。
• scripts.tools.plant_recognition_for_data_base64：必填 dataBase64，传入图片的 Base64 编码。

调用前会检查 scripts.config.settings.api_key；若 .env 中缺少 XBY_APIKEY，须通过 AskUserQuestion 向用户索取密钥，并用 scripts.config.set_api_key 持久化。工具返回的 dict 中，result["raw"] 为 API 原始 JSON，应整理后直接展示；success 与 message 用于判断成败与说明。

适用边界与注意点

• 必须配置 API 密钥（获取地址：https://xiaobenyang.com）；缺少密钥时禁止自行搜索或编造识别结果。
• 参数不完整（例如只有描述、没有图片链接或 Base64）时，应询问用户补全后再调用。
• 识别质量取决于图片清晰度、角度与 API 能力；技能本身不负责图像预处理或本地图库维护。