Weather Query
概述
查询全球城市天气信息的技能。支持三种查询模式：当前天气、未来3天预报、空气质量。默认使用 wttr.in（无需 API Key），也支持 Open-Meteo API 作为备选数据源。
前置条件
- Python 3.10+（系统自带）
requests库（pip install requests）- 网络可访问 wttr.in 或 api.open-meteo.com
核心命令
查询当前天气
python3 scripts/weather.py --city "Beijing" --mode current
查询未来预报
python3 scripts/weather.py --city "Shanghai" --mode forecast
查询空气质量
python3 scripts/weather.py --city "Guangzhou" --mode air
指定数据源
python3 scripts/weather.py --city "Tokyo" --source open-meteo
参数确认
| 参数 | 必需 | 默认值 | 说明 |
|---|---|---|---|
| --city | 是 | - | 城市名（支持中英文，如 "北京" / "Beijing"） |
| --mode | 否 | current | 查询模式: current / forecast / air |
| --source | 否 | wttr | 数据源: wttr / open-meteo |
| --lang | 否 | zh | 输出语言: zh / en |
| --format | 否 | text | 输出格式: text / json |
输出格式
current 模式
🏙️ 北京 (Beijing)
🌡️ 温度: 28°C (体感 30°C)
💧 湿度: 65%
🌬️ 风速: 12 km/h 东南风
☁️ 天气: 多云
👁️ 能见度: 10 km
forecast 模式
🏙️ 上海 未来3天预报:
📅 今天: 30°C / 22°C ☀️ 晴
📅 明天: 28°C / 21°C ⛅ 多云
📅 后天: 25°C / 19°C 🌧️ 小雨
air 模式
🏙️ 广州 空气质量:
🟢 AQI: 52 (良)
PM2.5: 35 μg/m³
PM10: 58 μg/m³
O₃: 42 μg/m³
验证方法
# 验证脚本可执行
python3 scripts/weather.py --city "Beijing" --mode current
# 验证 JSON 输出
python3 scripts/weather.py --city "Beijing" --format json
# 验证中文名查询
python3 scripts/weather.py --city "深圳" --mode forecast
最佳实践
- 城市名优先使用英文，中文城市名会自动转换
- wttr.in 对中国城市支持较好，Open-Meteo 对欧美城市更精确
- 批量查询时建议加
--format json方便程序解析 - wttr.in 有频率限制，批量查询建议间隔 1 秒
参考文档
- wttr.in — 基于终端的天气服务
- Open-Meteo API — 免费天气 API
- 城市名映射 — wttr.in 多语言支持
注意事项
- wttr.in 为公共服务，偶尔不稳定，可切换
--source open-meteo - 空气质量数据仅 Open-Meteo 支持，wttr.in 的 air 模式会自动切换数据源
- 中国部分小城市可能无法查询，建议使用地级市名称