FarmOS 天气

源自农艺模块（Agronomy module）的农场田块当前天气状况与天气预报。

适用场景

本技能支持的功能： 田块当前天气状况、天气预报、积温（GDD）、喷药适宜性评估，以及田块历史天气数据。

触发语句示例： “天气怎么样”、“今天能喷药吗”、“田块 X 的 GDD 是多少”、“预报如何”、“这周会下雨吗”、“现在温度和风速是多少”、“田块状况如何？”

本技能 不支持 的功能： 关于冰雹、洪涝或霜冻等天气致害的田块观测（请使用 farmos-observations 模块并指定 weather_damage 类型 —— 该操作将记录实际损害以便追踪）。本技能回答“天气 是什么”，而观测模块记录“天气 造成了什么”。

最低可用输入： “天气” 或任意田块引用。若未明确指定田块，则任一邻近田块 ID 均可使用，因全部 69 个田块均位于印第安纳州中部。

API 基础地址

http://100.102.77.110:8012

端点列表

健康检查

GET /api/weather/health

返回：天气服务健康状态。

当前天气

GET /api/weather/field/{field_id}/current

返回：指定田块的当前天气状况（温度、降水、风速等）。

天气预报

GET /api/weather/field/{field_id}/forecast?days=7

返回：每日及每小时预报数据（最长支持 14 天）。

历史天气

GET /api/weather/field/{field_id}/historical?days=30

返回：指定田块的历史天气记录。

积温（GDD）

GET /api/weather/field/{field_id}/gdd?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD&baseTemp=10

返回：指定日期范围内田块的积温累积值。

喷药适宜性

GET /api/weather/field/{field_id}/spray-conditions

返回：喷药适宜性评估结果（含风速、降雨概率、温度等校验）。

按坐标查询天气

GET /api/weather/coordinates?latitude={lat}&longitude={lon}&type=current

返回：基于经纬度的天气信息（无需田块 ID）。如需预报数据，请将 type 设为 forecast。

集成仪表盘

GET /api/integration/dashboard

返回：农艺汇总信息（若可用，包含天气数据）。

数据完整性要求

1. /api/integration/dashboard 返回农艺汇总数据 —— 仅可用于快速概览，不可作为主要天气数据源。
2. 若任一天气端点调用失败或返回空响应，应如实告知：“天气服务当前无响应。” 禁止推测或编造天气信息。
3. 针对 GDD 查询，响应中必须明确标注时间范围，使用户清晰了解统计区间。例如：“4 月 1 日至今日的 GDD：1,142。”

跨模块上下文关联

回答天气相关问题时，需同步思考天气对农场其他环节的影响：

天气 → 任务（Tasks）：

• 在回答“今天能喷药吗？”或“是否适合下田作业？”前，应先查询 farmos-tasks 中已排定的任务。将预报与具体工作计划关联，例如：“周四至周六有雨——若您计划对田块 14 进行喷药，今天是最佳窗口期。”
• 报告预报时，主动提示与天气敏感型任务存在冲突的情况，例如：“本周您共安排了 3 项喷药任务，但大风将于周三起增强，今日与明日是最佳执行时机。”
• GDD 达到关键阈值时将触发农艺操作。当玉米 GDD 达到 V6 阶段（约 450 GDD）、VT 阶段（约 1,100 GDD）、R1 阶段（约 1,400 GDD）等里程碑时，应联动任务建议，例如：“田块 12 刚达到 1,100 GDD，即 V6 标志点，现已进入追肥窗口期。需要我为您创建一项任务吗？”

天气 → 观测（Observations）：

• 持续降雨叠加高温后，提示病害风险升高，例如：“已连续 3 天降雨且日最高温达 80°F 以上，灰斑病与褐斑病发生条件成熟，建议本周对玉米田开展巡查。”
• 出现霜冻或极端天气后，建议开展损伤核查，例如：“昨夜出现初霜，建议重点检查晚播田块是否存在冻害。”
• 将近期天气与已有观测模式关联：若近期已记录病害观测，应在响应中指出其与天气的潜在关联。

天气 → 设备（Equipment）：

• 若预报即将降雨且田间作业已排期，需提示设备调度影响，例如：“降雨将于周四开始，所有需下田作业的设备务必在此之前就位。”

对于任何涉及田间作业的问题，应同步查询 farmos-tasks 和 farmos-observations 数据，并与天气信息综合判断。并非所有简单问题（如“当前温度多少？”）都需要交叉验证——请依实际情况判断。仅当天气变化会对既定计划产生实质性影响时，才需进行跨模块关联分析。

单位制 —— 已采用美制单位，直接展示即可

天气 API 所有数值均以美国惯用单位（US imperial units）返回。请原样展示，无需转换。

禁止转换单位，禁止重新标注单位。 0.25 即表示 0.25 英寸；55 即表示 55°F；16 即表示 16 mph。

日期处理 —— 以今日为锚点

API 返回的日期格式为 YYYY-MM-DD 字符串，且首条数据始终为今日，而非明日。

• 请使用系统当前日期准确标注每一天：“今日（2 月 28 日）”、“明日（3 月 1 日）”、“周三（3 月 2 日）”；
• 切勿假设预报首条数据为“明日”——它就是“今日”；
• 若无法确认今日确切日期，请如实说明，切勿猜测。

使用注意事项

• 农场位于印第安纳州中部。若某特定田块的天气数据不可用，使用当地通用天气数据亦可接受。
• 喷药适宜性至关重要：风速须低于 10 mph，未来 24 小时内无降雨，且温度处于适宜区间。
• “今天能喷药吗？”是高频问题——请通过 spray-conditions 端点核查风速、降雨概率及温度。
• 田块 ID 均为整数，全农场共 69 个田块。因所有田块地理位置相近，绝大多数天气查询均可使用任一邻近田块 ID。
• 若需基于坐标查询天气（无田块 ID），请使用 /coordinates 端点，并传入农场大致坐标（纬度 ~40.25，经度 ~-85.67）。