weather-query

🌤️ 精准实时的智能天气管家

基于和风天气专业API,支持城市名/经纬度/ID多维度定位,提供实时天气与15天预报的企业级数据服务。

收藏
4.5k
安装
1.2k
版本
v0.1.0
CLS 安全性认证2026-05-02
点击查看完整报告 >

使用说明

核心用法

和风天气查询技能是一款基于和风天气企业级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_HOSTQWEATHER_PROJECT_ID等),对非技术用户不够友好。此外,技能未提供本地缓存机制,重复查询相同地点会产生冗余API调用。

适合人群

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

使用风险

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

安全解读

核心用法

该 skill 专注于天气信息查询,通过和风天气(QWeather)及 Open-Meteo 两大权威气象数据源,为用户提供实时天气、未来多日报表及生活指数等信息。

触发方式:用户提及"天气"、"气温"、"下雨"、"降温"、"预报"等关键词时自动激活。支持自然语言表达,如"今天"、"明天"、"未来3天"等。

定位能力:灵活支持三种定位方式——

  • 城市名称(如"北京")
  • LocationID(和风天气内部编码)
  • 经纬度坐标

若用户未指定地点,系统优先读取环境变量 QWEATHER_DEFAULT_LOCATION;若未配置则主动追问,避免猜测。

查询类型

  • 实时天气:当前气温、体感温度、湿度、风向风力、观测时间
  • 未来预报:每日最高/最低气温、白天/夜间天气现象、降水概率、风力等级

日期映射逻辑清晰:"今天"=1天、"明天"=2天(重点输出第2天)、"后天"=3天,支持最长15天预报。

显著优点

1. 数据源权威:和风天气是国内主流商业气象服务商,Open-Meteo 为欧洲开源气象项目,双重保障数据可靠性
2. 安全传输:所有 API 调用均采用 TLS 1.2+ 加密,JWT 认证机制确保请求合法性

3. 配置规范:敏感信息(API密钥、私钥路径)通过环境变量注入,无硬编码风险

4. 隐私友好:仅传输必要的地理位置信息,不收集用户个人身份数据

5. 代码透明:580行代码、13个文件,结构清晰,无混淆或打包风险

潜在缺点与局限

1. 网络依赖:必须连接外部 API,离线环境无法使用;API 故障时直接报错而非降级
2. 配额限制:和风天气免费版有调用次数限制,高频使用可能触发限速

3. 地域覆盖:部分偏远地区或海外城市的预报精度可能不如主流城市

4. 无历史数据:仅支持实时与未来预报,无法查询过往天气记录

5. T3来源:个人开发者作品,缺乏企业级维护承诺与 SLA 保障

适合人群

  • 日常出行、差旅规划需快速获取天气信息的普通用户
  • 开发者构建天气相关应用的原型验证
  • 对数据安全有基本认知,能接受第三方 API 调用的场景

常规风险

| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 第三方 API 依赖 | 中 | 和风天气服务可用性直接影响功能 |
| 环境变量泄露 | 低 | 需确保 `QWEATHER_*` 变量不被日志记录 |
| 私钥文件权限 | 低 | JWT 私钥需设置 600 权限 |
| 依赖更新 | 低 | axios 需定期更新以修复潜在漏洞 |

部署建议:生产环境使用前建议 fork 代码自行审查,监控 API 配额,并配置备用数据源。

weather-query 内容

lib文件夹
手动下载zip · 14.5 kB
ed25519-private.txttext/plain
请选择文件