核心用法
BirdNET-Go Skill 是专为本地化鸟类声音监测设计的查询工具，通过 HTTP 接口与自托管的 BirdNET-Go 服务通信，无需云端 API 密钥即可访问。
主要功能模块：
1. 实时检测记录：recent 命令获取最新鸟类识别结果，包含置信度评分（0.0-1.0）、时间戳及人工核验状态
2. 物种定向检索：search 支持通用名模糊匹配，species 提供学名精确查询，返回稀有度评分与分类学信息
3. 深度数据分析：detection 调取单个记录的完整元数据，包括关联天气条件；today 生成当日检测汇总报告
技术实现：纯 Bash 脚本封装，依赖 curl 进行 HTTP 请求、jq 处理 JSON 响应，通过本地配置文件 ~/.clawdbot/credentials/birdnet/config.json 管理服务地址。
显著优点
- 完全本地化：数据不出境，适合隐私敏感的自然保护区或科研机构部署
- 零认证门槛：内网访问免除 API 密钥管理，降低配置复杂度
- 科学级数据源：底层 BirdNET-Go 基于康奈尔大学 Lab of Ornithology 的 BirdNET 深度学习模型，识别 3000+ 鸟类物种
- 轻量无依赖：仅需标准 Unix 工具，适配 ARM/x86 边缘计算设备
潜在局限
- 网络拓扑限制：必须处于与 BirdNET-Go 服务同一局域网或配置端口转发
- 无历史聚合：接口仅提供原始记录查询，缺乏跨时段趋势分析功能
- 核验状态依赖人工：verification status 字段准确性取决于用户是否在 Web 界面手动标注
- 天气数据完整性：气象关联信息依赖 BirdNET-Go 服务端的外部 API 配置
适合人群
- 鸟类学研究者和观鸟爱好者自建监测站
- 智慧农业/生态监测项目的边缘节点管理员
- 需要本地化自然声景档案的保护区技术人员
常规风险
- SSRF 隐患：配置文件中 url 字段若被篡改指向外部地址，可能导致内网探测或 unintended 数据外泄
- 明文 HTTP：默认协议为 HTTP，局域网内存在流量嗅探风险
- 路径遍历：脚本对输入参数转义不足时，shell 注入可能影响目标服务器（尽管 BirdNET-Go 本身只暴露只读接口）