核心用法
weather-pulse 是一款轻量级天气与空气质量查询工具，通过命令行快速获取全球实时气象数据。它整合 QWeather（气象数据）与 WAQI（空气质量）两大免费 API，支持城市名称、坐标、CityId 三种输入格式，覆盖当前天气、3-30 天预报、24-168 小时逐小时预报、生活指数及 AQI/PM2.5 等多维数据。
显著优点
- 免费额度 generous：QWeather 每月 5 万次调用，WAQI 每小时 1 千次，个人及小团队使用几乎无压力
- 输入灵活：自动解析中英文城市名、坐标（支持经纬度顺序容错）、标准 CityId
- 输出可控：默认简洁文本，
-j参数可输出原始 JSON 便于二次开发 - 稳定性保障：内置 3 次自动重试机制应对网络波动
潜在局限
- 配置门槛：需分别注册 QWeather 和 WAQI 获取 API 密钥，环境变量配置对非技术用户不够友好
- 功能边界：无雷达图、卫星云图等可视化能力；生活指数依赖 QWeather 特定接口，覆盖城市可能不全
- 速率限制：WAQI 每小时 1k 请求在高频场景（如自动化监控）下可能吃紧
适合人群
- 开发者构建 CLI 工作流或自动化脚本
- 需要快速获取结构化气象数据的分析师
- 对天气数据有基础需求、偏好轻量工具的个人用户
常规风险
- API 稳定性：第三方免费服务存在变更接口或降额风险，建议监控用量并保留降级方案
- 数据精度：空气质量数据受监测站点分布影响，偏远地区可能存在偏差
- 密钥管理：API Key 以环境变量传递，需避免硬编码提交至代码仓库