weather-query

核心用法

和风天气查询技能是一款基于和风天气企业级API的专业气象数据获取工具，通过标准化的API接口提供精准天气服务。用户可通过城市名称、经纬度坐标或LocationID三种方式进行地点定位，系统支持智能解析自然语言时间表达（如"今天"、"明天"、"未来3天"），自动映射为对应的查询参数（1-15天范围）。当用户未指定地点时，系统会检查QWEATHER_DEFAULT_LOCATION环境变量获取默认位置，确保查询连续性。

显著优点

该技能的核心优势在于数据源的专业性与安全架构的规范性。依托和风天气权威气象服务体系，提供实时天气、未来15天预报、生活指数等多维度数据。安全层面采用JWT Ed25519签名算法进行身份认证，所有敏感配置（API密钥、私钥路径）均通过环境变量外部化读取，避免硬编码风险。代码层面具备完善的输入验证机制，对经纬度格式（正则匹配^-?\d+(\.\d+)?\s*,\s*-?\d+(\.\d+)?$）、LocationID（数字校验）、查询天数（1-15范围限制）进行严格校验，并配备结构化错误处理体系，API失败时明确提示检查环境变量配置。

潜在局限性

作为T3来源的社区项目（开发者murphys7017），其长期维护稳定性与官方或企业级项目存在差距。功能重度依赖外部网络环境与和风天气API可用性，无网络连接时完全无法工作。初始配置门槛较高，用户需自行申请和风天气企业版API权限，手动配置JWT私钥文件（ed25519-private.txt）及多项环境变量（QWEATHER_API_HOST、QWEATHER_PROJECT_ID等），对非技术用户不够友好。此外，技能未提供本地缓存机制，重复查询相同地点会产生冗余API调用。

适合人群

该技能适合需要高精度气象数据的专业场景：智能助手开发者集成天气查询模块、自动化工作流构建者设置天气触发条件、对预报准确性有较高要求的个人用户。对于仅需基础天气查询且追求开箱即用的普通用户，建议优先使用系统内置工具或T1来源的官方应用。

使用风险

主要风险包括网络依赖风险（需确保能访问和风天气企业API域名xxx.re.qweatherapi.com）、配置安全风险（私钥文件权限管理不当可能导致密钥泄露）、以及服务可用性风险（受限于和风天气API配额与稳定性）。建议生产环境使用前进行异常网络测试，并妥善保管私钥文件避免未授权访问。