Weather Open‑Meteo 技能

该技能通过调用 open-meteo.com 公共 API 获取当前天气及简要预报。若地理编码查询或天气请求失败，技能可自动回退至轻量级替代服务 wttr.in。

📌 适用范围与注意事项

• 该技能 依赖 curl 和 jq。
• 位置参数在发送至 API 前会进行 URL 编码。
• 下方示例使用 jq 的 @uri 过滤器演示了安全构造查询字符串的方法。

✅ 适用场景

✔ 用户询问 某一地点的天气、预报、气温或降雨概率。 ✖ 不适用于历史气象数据、极端天气预警或详细气候学分析。

📋 命令格式

该技能接受一个参数：位置名称（城市名、地区名，或以 lat,lon 格式表示的经纬度坐标）。

Open‑Meteo（主用，返回 JSON）

地理编码（获取地点对应的经纬度）：

curl -s "https://geocoding-api.open-meteo.com/v1/search?name=São+Paulo&count=1" | jq '.results[0] | {name, latitude, longitude}'

当前天气（按经纬度查询）：

curl -s "https://api.open-meteo.com/v1/forecast?latitude=-23.55&longitude=-46.63¤t_weather=true" | jq '.current_weather'

7 日预报（按经纬度查询）：

curl -s "https://api.open-meteo.com/v1/forecast?latitude=-23.55&longitude=-46.63&daily=temperature_2m_max,temperature_2m_min,precipitation_sum&forecast_days=7" | jq '.daily'

JSON 示例片段

{
  "latitude": -23.55,
  "longitude": -46.63,
  "current_weather": {
    "temperature": -5.3,
    "windspeed": 3.9,
    "winddirection": 200,
    "weathercode": 80,
    "time": "2024-02-18T14:00"
  }
}

📖 Open‑Meteo API 文档

wttr.in（备用方案）

单行文本（HTML 格式）：

curl -s "wttr.in/São+Paulo?format=3"

紧凑纯文本格式：

curl -s "wttr.in/São+Paulo?format=1"

PNG 图像（适用于终端显示或嵌入）：

curl -s -o sp.png "http://wttr.in/São+Paulo?format=1"

📚 示例（用户查询）

用户： 圣保罗现在的天气如何？ Agent： 圣保罗当前天气：🌤️ +10 °C，降雨概率 20%

提示

• 对城市名进行 URL 编码：

  curl -s "https://geocoding-api.open-meteo.com/v1/search?name=$(echo São Paulo | jq -sRr @uri)"
  

• 使用 jq 动态构建查询：

  city="São Paulo"
  lat=$(curl -s "https://geocoding-api.open-meteo.com/v1/search?name=$(echo $city | jq -sRr @uri)" | jq -r '.results[0].latitude')
  lon=$(curl -s "https://geocoding-api.open-meteo.com/v1/search?name=$(echo $city | jq -sRr @uri)" | jq -r '.results[0].longitude')
  

• 若已知经纬度，可直接传入 latitude 和 longitude 参数。
• 该 API 存在调用频率限制（约 100 次/分钟）。建议对脚本结果进行缓存，或控制请求间隔。