weather

核心用法

Weather Skill 提供两种免 API Key 的天气查询方案：

wttr.in（主推）：通过 curl 命令获取格式化的天气信息，支持多种输出格式。快速单行模式可获取「城市: 天气图标+温度」的简洁结果；紧凑格式支持自定义变量组合（温度、湿度、风速、月相等）；完整预报模式以 ASCII 图表展示多日天气。支持城市名、机场代码、坐标等多种定位方式，可切换公制/英制单位，还能直接输出 PNG 图片。

Open-Meteo（备选）：面向程序化场景，返回标准 JSON 格式数据，包含温度、风速、天气代码等字段，便于二次开发集成。

显著优点

1. 零门槛使用：无需注册账号、申请 API Key，开箱即用
2. 终端友好：纯文本/ASCII 输出，适合命令行环境和脚本集成
3. 格式灵活：从极简单行到完整图表，满足不同场景需求
4. 全球覆盖：支持任意城市、机场代码、地理坐标查询
5. 双源备份：主备两个服务，提升可用性

潜在缺点与局限性

• 网络依赖：必须联网，离线无法使用
• 服务稳定性：依赖第三方免费服务，存在服务中断或限流风险
• 精度限制：免费服务的数据精度和更新频率不及商业气象 API
• 无历史数据：仅支持当前和预报，无法查询过去天气
• 中文支持：城市名需 URL 编码，部分终端对天气图标显示不完整

适合的目标群体

• 开发者：需要快速集成天气功能的脚本和自动化工具
• 运维工程师：服务器监控、日志记录中的天气标注
• 终端用户：偏好命令行的高效用户
• 教育场景：学习 API 调用和数据解析的教学示例

使用风险

• 隐私暴露：查询请求会暴露 IP 地址和大致地理位置给第三方服务
• 外部依赖：wttr.in 或 Open-Meteo 服务变更可能导致功能失效
• 证书验证：curl 示例未强制校验 HTTPS 证书，存在中间人攻击理论风险（建议生产环境添加 --cacert 或移除 -k 参数）

核心用法

weather Skill 提供两套免 API Key 的终端天气查询方案，适合开发者、运维人员及命令行用户快速获取气象信息。

wttr.in（主推）

极简语法，curl 直接访问：

• 单行速查：curl -s "wttr.in/London?format=3" → London: ⛅️ +8°C
• 自定义字段：?format=%l:+%c+%t+%h+%w 输出位置、天气图标、温度、湿度、风向
• 完整预报：wttr.in/London?T 终端可视化图表
• 进阶技巧：支持机场代码（JFK）、URL 编码城市名（New+York）、公制/英制切换（?m/?u）、PNG 图片导出

Open-Meteo（备用）

JSON 结构化数据，适合脚本集成：curl -s "api.open-meteo.com/v1/forecast?latitude=51.5&longitude=-0.12&current_weather=true"

显著优点

• 零门槛：无需注册、无 API Key、无调用限制
• 跨平台：纯 curl 命令，兼容 Linux/macOS/WSL/Termux
• 输出灵活：从单行字符串到可视化图表，覆盖脚本自动化到人工阅读全场景
• 全球覆盖：城市名、机场代码、经纬度均可定位

潜在局限

• 依赖网络：离线环境不可用，无本地缓存机制
• 精度受限：免费服务更新频率约 1-2 小时，不满足航空级或农业级精度需求
• 无历史数据：仅支持当前及未来预报，无法查询过去天气
• 中文支持：城市名建议用拼音或英文，部分中文地名可能解析失败

适合人群

• 服务器运维（快速检查机房所在地天气）
• 开发者（CI/CD 脚本集成天气通知）
• 终端爱好者（打造个性化状态栏如 tmux/waybar）
• 差旅人士（机场代码速查无需打开 App）

常规风险

• 隐私：curl 请求暴露 IP 及查询城市，敏感场景建议配合代理
• 服务可用性：wttr.in 偶有 503 故障，生产环境建议实现 Open-Meteo 自动降级
• 单位混淆：默认可变，脚本中务必显式指定 ?m 或 ?u