wttr.in 天气查询服务

💡 快捷工具：本 skill 包含辅助脚本和参考文档

• - Python 脚本: scripts/weather.py - 多功能天气查询工具（统一使用）
• 参考指南: references/quick-reference.md - 速查手册

核心功能

wttr.in 是一个功能强大的基于控制台天气预报服务，支持多种输出格式和全球位置查询。

主要能力

1. 1. 天气预报查询 - 支持全球任意地点的天气预报
2. 多格式输出 - ANSI 终端、HTML、PNG 图片、JSON、Prometheus 指标
3. 多语言支持 - 54+ 种语言，包括中文
4. 天文信息 - 月相、日出日落时间
5. 自定义格式 - 灵活配置输出内容
6. 一行输出 - 适合集成到 tmux、状态栏等

---

基本用法

标准查询（使用 Python 脚本）

bash

当前位置（基于 IP）

python scripts/weather.py

指定城市

python scripts/weather.py Beijing python scripts/weather.py Shanghai python scripts/weather.py New+York python scripts/weather.py London

使用 ~ 查询特殊地点（景点、山脉等）

python scripts/weather.py ~Eiffel+Tower python scripts/weather.py ~Mount+Everest

机场代码查询

python scripts/weather.py PEX # 北京首都机场 python scripts/weather.py PVG # 上海浦东机场 python scripts/weather.py LAX # 洛杉矶机场

单位设置

bash

公制单位（摄氏度，默认除美国外）

python scripts/weather.py Beijing -u m

英制单位（华氏度）

python scripts/weather.py Beijing -u u

公制 + m/s 风速

python scripts/weather.py Beijing -u M

---

输出格式

1. 终端 ANSI/纯文本

bash

标准输出（自动检测）

python scripts/weather.py Beijing

强制纯文本（无颜色）

python scripts/weather.py Beijing -f plain

限制为标准控制台字符

python scripts/weather.py Beijing -f compact

2. PNG 图片格式

bash

下载 PNG 天气图

python scripts/weather.py Beijing -f png -o weather.png

透明背景

python scripts/weather.py Beijing -f png --transparent -o weather.png

自定义透明度 (0-255)

python scripts/weather.py Beijing -f png --transparent --transparency 150

3. JSON 格式（API 使用）

bash

完整 JSON 数据

python scripts/weather.py Beijing -f json

精简 JSON（不含小时数据）

python scripts/weather.py Beijing -f json-lite

JSON 输出包含：

• - current_condition: 当前天气状况
• weather: 天气预报数据
• astronomy: 天文信息（日出、日落、月相）

4. Prometheus 监控指标

bash

Prometheus 格式

python scripts/weather.py Beijing -f prometheus

---

一行输出格式（format 参数）

适合集成到 tmux、weechat、状态栏等。

预设格式

bash

格式 1: 当前天气

python scripts/weather.py Beijing -f oneline --custom-format 1

🌦 +11⁰C

格式 2: 详细信息

python scripts/weather.py Beijing -f oneline --custom-format 2

🌦 🌡️+11°C 🌬️↓4km/h

格式 3: 位置 + 天气

python scripts/weather.py Beijing -f oneline --custom-format 3

Beijing: 🌦 +11⁰C

格式 4: 完整信息

python scripts/weather.py Beijing -f oneline --custom-format 4

Beijing: 🌦 🌡️+11°C 🌬️↓4km/h

自定义格式（%-notation）

代码	含义	代码	含义
%c	天气状况图标	%C	天气状况文本
%x

天气符号（纯文本） | %h | 湿度 | | %t | 实际温度 | %f | 体感温度 | | %w | 风速和方向 | %l | 位置名称 | | %m | 月相 🌑🌒🌓🌔🌕🌖🌗🌘 | %M | 月龄 | | %p | 降水量 (mm/3h) | %P | 气压 (hPa) | | %u | UV 指数 (1-12) | %D | 黎明时间* | | %S | 日出时间 | %z | 天顶时间 | | %s | 日落时间 | %d | 黄昏时间 | | %T | 当前时间* | %Z | 本地时区 |

*时间以本地时区显示

bash

自定义输出示例

python scripts/weather.py Beijing --custom-format %l:+%c+%t+%h+%w\n

Beijing: ⛅️ +7°C 45% ↓12km/h

多地点查询

python scripts/weather.py Beijing:Shanghai:Guangzhou -f oneline --custom-format 3

---

数据丰富格式 (v2)

实验性功能，提供详细天气和天文信息。

bash

使用 v2 格式

python scripts/weather.py Beijing -f v2

使用 Nerd Fonts（日间模式）

python scripts/weather.py Beijing -f v2-day

使用 Nerd Fonts（夜间模式）

python scripts/weather.py Beijing -f v2-night

包含信息：

• - 温度和降水变化预测
• 月相（今天及未来 3 天）
• 当前天气状况、温度、湿度、风速、气压
• 时区信息
• 黎明、日出、正午、日落、黄昏时间
• 精确地理坐标

---

地图视图 (v3)

显示地理区域的天气信息。

bash

PNG 格式（浏览器）

python scripts/weather.py California -f v3

Sixel 格式（支持内联图像的终端）

python scripts/weather.py Bayern -f v3

---

月相查询

bash

当前位置月相

python scripts/weather.py -f moon

指定日期

python scripts/weather.py -f moon --moon-date 2025-12-25

作为天气查询的一部分

python scripts/weather.py Beijing --custom-format %m

🌖

---

多语言支持

bash

通过语言参数设置

python scripts/weather.py Beijing -l zh
python scripts/weather.py Paris -l fr
python scripts/weather.py Berlin -l de
python scripts/weather.py Tokyo -l ja

查询非英文名称位置

python scripts/weather.py станция+Восток python scripts/weather.py ~长城

支持 54+ 种语言，包括：zh（中文）、en（英语）、fr（法语）、de（德语）、ru（俄语）、ja（日语）等。

---

集成示例

tmux 状态栏

tmux

~/.tmux.conf

set -g status-interval 60

使用 Python 脚本查询天气

WEATHER=#(python /path/to/weather.py Beijing -f oneline --custom-format %%l:+%%c+%%t&period=60)
set -g status-right $WEATHER | %Y-%m-%d %H:%M

Shell 别名

bash

~/.bashrc 或 ~/.zshrc

alias weather=python /path/to/weather.py
alias weather-json=python /path/to/weather.py -f json

Python 程序集成

python
from weather import WeatherQuery

weather = WeatherQuery(Beijing)

获取 JSON 数据

data = weather.json_full() print(f当前温度：{data[currentcondition][0][tempC]}°C)

获取一行输出

print(weather.oneline(3))

---

使用建议

最佳实践

1. 1. 自动查询场景（如 tmux）设置合理更新间隔（60-300 秒）
2. 多地点查询 使用 : 分隔，配合 period 参数
3. 脚本集成 使用 JSON 格式 (format=j1) 便于解析
4. 终端显示