wttr-weather（天气）

wttr.in 天气查询服务

💡 快捷工具：本 skill 包含辅助脚本和参考文档 - Python 脚本: scripts/weather.py - 多功能天气查询工具（统一使用） - 参考指南: references/quick-reference.md - 速查手册

核心功能

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

主要能力

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

基本用法

标准查询（使用 Python 脚本）

# 当前位置（基于 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    # 洛杉矶机场

单位设置

# 公制单位（摄氏度，默认除美国外）
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/纯文本

# 标准输出（自动检测）
python scripts/weather.py Beijing

# 强制纯文本（无颜色）
python scripts/weather.py Beijing -f plain

# 限制为标准控制台字符
python scripts/weather.py Beijing -f compact

2. PNG 图片格式

# 下载 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 使用）

# 完整 JSON 数据
python scripts/weather.py Beijing -f json

# 精简 JSON（不含小时数据）
python scripts/weather.py Beijing -f json-lite

JSON 输出包含：

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

4. Prometheus 监控指标

# Prometheus 格式
python scripts/weather.py Beijing -f prometheus

一行输出格式（format 参数）

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

预设格式

# 格式 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）

*时间以本地时区显示

# 自定义输出示例
python scripts/weather.py Beijing --custom-format "%l:+%c+%t+%h+%w\
"
# Beijing: ⛅️ +7°C 45% ↓12km/h

# 多地点查询
python scripts/weather.py "Beijing:Shanghai:Guangzhou" -f oneline --custom-format "3"

数据丰富格式 (v2)

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

# 使用 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)

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

# PNG 格式（浏览器）
python scripts/weather.py California -f v3

# Sixel 格式（支持内联图像的终端）
python scripts/weather.py Bayern -f v3

月相查询

# 当前位置月相
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"
# 🌖

多语言支持

# 通过语言参数设置
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.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 别名

# ~/.bashrc 或 ~/.zshrc
alias weather='python /path/to/weather.py'
alias weather-json='python /path/to/weather.py -f json'

Python 程序集成

from weather import WeatherQuery

weather = WeatherQuery("Beijing")

# 获取 JSON 数据
data = weather.json_full()
print(f"当前温度：{data['current_condition'][0]['temp_C']}°C")

# 获取一行输出
print(weather.oneline("3"))

使用建议

最佳实践

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

常见问题

Emoji 显示问题：

• 安装 Noto Color Emoji 字体
• 配置 fontconfig 优先使用 emoji 字体
• 运行 fc-cache -f -v 刷新字体缓存

终端不支持：

• 使用 ?T 参数强制纯文本
• 使用 ?d 限制为标准字符

API 参考

端点

查询参数

天气代码

相关资源

• 官方文档：https://wttr.in/:help
• 源码仓库：https://github.com/chubin/wttr.in
• 翻译贡献：/translation

使用流程总结

当用户需要查询天气时：

1. 确定位置 - 城市名、机场代码、特殊地点（加~）
2. 选择格式 - 终端显示、JSON API、PNG 图片
3. 设置参数 - 单位、语言、自定义输出
4. 执行查询 - 使用 curl/wget/httpie 或辅助脚本
5. 解析结果 - 直接显示或程序处理

辅助脚本使用

Python 脚本 (scripts/weather.py)

功能丰富的查询工具，支持多种输出格式：

# 标准天气查询
python scripts/weather.py Beijing

# JSON 格式（适合程序处理）
python scripts/weather.py Beijing -f json

# 精简 JSON（不含小时数据）
python scripts/weather.py Beijing -f json-lite

# 一行输出（适合状态栏）
python scripts/weather.py Beijing -f oneline

# 自定义格式
python scripts/weather.py Tokyo --custom-format "%l: %c %t"

# 下载 PNG 图片
python scripts/weather.py Paris -f png -o weather.png

# 详细预报 (v2)
python scripts/weather.py Beijing -f v2

# 地图视图 (v3)
python scripts/weather.py California -f v3

# 月相查询
python scripts/weather.py -f moon

# 指定日期月相
python scripts/weather.py -f moon --moon-date 2025-12-25

参数说明

参考指南 (references/quick-reference.md)

速查手册，包含：

• 常用命令速查表
• 自定义格式代码对照
• 预设格式示例
• 支持的语言代码
• 天气代码对照表
• tmux 配置示例
• 故障排除指南

建议：查询具体参数或忘记语法时，参考 references/quick-reference.md