核心功能
weather-query 是专为天气信息查询设计的专业 Skill,通过和风天气(QWeather)商业级 API 提供精准气象服务。支持城市名称、LocationID、经纬度坐标三种定位方式,并可通过环境变量设置默认查询地点。
显著优点
1. 数据源专业可靠:直接对接和风天气 API,非通用搜索抓取,数据实时性、准确性有保障
2. 多维度定位智能:自动解析用户输入的地点形式,无需用户刻意区分城市名或坐标
3. 自然语言理解强:支持"今天/明天/后天/未来N天"等口语化时间表达,自动映射为 API 参数
4. 信息维度丰富:除基础气温外,涵盖体感温度、湿度、风向风力、降水概率、昼夜天气对比
5. 企业级安全认证:采用 JWT + Host 双因子认证机制,私钥本地存储,符合 API 安全最佳实践
潜在局限
- 依赖环境配置:需提前配置
QWEATHER_API_HOST、QWEATHER_PROJECT_ID、QWEATHER_CREDENTIALS_ID、QWEATHER_PRIVATE_KEY_PATH四项密钥,上手门槛较高 - 服务可用性受限:若和风天气 API 服务异常或额度耗尽,功能完全不可用(禁止回退到 web_search)
- 地理覆盖限制:和风天气对海外部分地区支持可能不及全球服务商
- 无历史数据:仅支持实时与未来预报,无法查询过往天气记录
适合人群
- 对天气数据准确性要求高的出行规划用户
- 需要集成专业气象服务的开发者/企业场景
- 已具备和风天气商业 API 资质的组织用户
常规风险提示
- 密钥泄露风险:私钥文件路径需严格权限控制,避免代码仓库泄露
- 默认地点误用:若配置
QWEATHER_DEFAULT_LOCATION,需确保用户知晓当前查询非其所在地 - 预报精度衰减:超过7天的长期预报准确性显著下降,建议仅作趋势参考