天气预报技能

该技能通过调用 Open-Meteo API 查询全球任意地点的天气预报，提供按小时划分的气温数据。

适用场景

当出现以下情况时，启用此技能：

• 用户询问天气信息或天气预报
• 用户查询特定地点的气温
• 用户提出与天气相关的请求，且需获取当前或未来时段的数据
• 用户提供地名，并期望获得对应的天气详情

技能组成

脚本

scripts/get_weather.py 脚本提供了一种可靠、可复用的方式，用于从 Open-Meteo API 获取天气数据。相比每次手动编写 API 请求，使用该脚本具有以下优势：

• 确保 API 端点和参数的一致性
• 统一处理网络请求中的各类错误
• 自动完成 JSON 解析与关键数据提取
• 支持在不加载上下文的情况下直接执行

参考文档

references/api_response_format.md 文件记录了 Open-Meteo API 的响应结构，包括：

• 请求参数（纬度、经度、按小时返回的数据类型）
• 响应格式及各字段含义
• 时区处理方式
• 可能的错误条件

工作流程

当该技能被激活后，系统将执行以下步骤：

1. 从用户查询中提取位置信息，可能包括：

   • 城市名称（例如：“北京”、“上海”、“New York”）
   • 具体地理坐标（纬度、经度）
   • 描述性位置（例如：“我当前的位置”）

2. 将位置转换为地理坐标：

   • 若提供的是城市名称，则通过地理编码服务获取其对应的纬度与经度
   • 若已直接提供坐标，则直接使用
   • 常用城市坐标（已保存在内存中）：北京（39.9042, 116.4074）、上海（31.2304, 121.4737）、New York（40.7128, -74.0060）、London（51.5074, -0.1278）、Tokyo（35.6762, 139.6503）

3. 使用坐标执行天气查询脚本：

   • 以纬度和经度为参数运行 scripts/get_weather.py
   • 脚本返回结构化的天气数据，包含逐小时气温信息

4. 以自然、易读的方式向用户呈现结果：

   • 汇总关键信息（当前气温、当日最高/最低温、整体预报趋势）
   • 包含相关时间信息（如未来 24 小时，或用户明确提及的具体时段）
   • 根据上下文使用合适的温度单位（默认为摄氏度；若用户明确要求，则使用华氏度）

重要说明

• Open-Meteo API 提供的是逐小时天气预报，而不仅限于当前天气
• 气温数值默认单位为摄氏度
• 该 API 免费开放，无需身份认证
• 坐标精度建议保留至小数点后四位，以提升定位准确性
• 若无法获取某地点对应的坐标，应提示用户并请求提供坐标或更换其他地点

交互示例

用户：“北京现在的天气怎么样？”
操作：提取“北京”，使用坐标（39.9042, 116.4074），运行脚本，返回预报结果

用户：“明天东京会冷吗？”
操作：提取“Tokyo”和“tomorrow”，使用坐标（35.6762, 139.6503），运行脚本，返回明日气温信息

用户：“获取纬度 52.52、经度 13.41 处的气温”
操作：直接使用所提供坐标，运行脚本，返回逐小时气温数据

用户：“今天上海会有多热？”
操作：提取“Shanghai”，使用坐标（31.2304, 121.4737），运行脚本，识别并返回今日最高气温