实时水质总览
4 项核心指标颜色分级展示。黄色代表预警，红色代表严重异常，便于值班人员快速判断。
24 小时趋势折线图
支持切换查看单个参数，也可以叠加查看全部趋势。
监测说明
建议结合趋势和预警等级综合判断，避免只看单点数据。
刷新状态
首页自动轮询，确保大屏和手机端都能看到最新状态。
自动刷新周期
首页每 30 秒自动获取一次最新数据与历史曲线。
最近更新时间
等待加载数据
未来趋势预测
结合 Prophet 趋势模型和短期 XGBoost 模型，提前预判未来几小时的变化方向。
未处理预警
展示当前尚未闭环的风险事件。点击“标记已处理”后，将从列表中移除。
投喂参数
输入存塘总重和平均体重，系统会结合当前水质给出今日建议投喂量与时间分配。
今日投喂结果
投喂建议会参考鱼体规格与最近一次水质状况，异常时自动保守调整。
增重预测参数
基于当前平均体重进行未来 14 天预测，并可视化 SHAP 特征贡献，便于理解增长驱动因素。
14 天增重预测
绿色代表正向促进，红色代表负向拖累。
数据录入与导入
养殖户可以直接在前端手工录入传感器数据和生长测量，也可以批量导入 CSV / JSON 文件，无需再改代码。
手工录入：水质数据
适合手机现场快速上报，提交后会直接写入后端 `sensor/data` 接口。
手工录入：生长测量
用于积累生长历史和后续真实数据版增重模型重训。
批量导入
支持 CSV 或 JSON。系统会逐行调用后端接口，并在下方显示成功/失败明细。
模板字段
导入结果
还没有导入记录。
最近导入历史
使用建议
先用手工录入完成日常报数，后续再用 CSV 批量补齐历史数据，能更快让模型进入真实重训阶段。
- 水质导入字段：`device_id,timestamp,temperature,do,ph,ammonia`
- 生长导入字段：`pond_id,measure_date,avg_weight_g,avg_length_cm,sample_count,total_fish,notes`
- 时间建议使用 ISO 8601，例如 `2026-03-29T08:00:00+08:00`
- 持续补录生长测量后，系统才能真正切换到数据库版增重重训
设备接入与 API 接入
在这里直接设置 API 基址和设备编号，并测试后端连通性。养殖户不需要再手工改 HTML 或代码。
设备上报入口
- 传感器上报：`POST /api/v1/sensor/data`
- 最新数据查询：`GET /api/v1/sensor/latest?device_id=...`
- 历史曲线查询：`GET /api/v1/sensor/history?device_id=...&hours=24`
接入状态
保存后可立即检查 `health / latest / history` 是否可用。
接入指南
给设备厂家或集成人员的最小接入信息，可以直接复制使用。
- 设备编号建议与系统中的鱼塘编号保持一致，例如 `pond_001`
- 上传时请求体使用字段 `do`，系统查询时会返回 `do_value`
- 推荐设备按 5 到 30 分钟固定周期上报一次数据
- 如果还没有真实设备，可以先切到 Mock 模式演示页面和流程
养殖信息设置
把塘口面积、养殖密度、品类和位置都放到前端里，方便养殖户直接使用。当前设置会优先同步到服务器，离线时自动回退到本机缓存。
天气查询使用 Open-Meteo 无密钥接口，位置可用地名搜索或浏览器定位快速获取。
养殖概况
根据你录入的基础信息，系统会给出更直观的生产摘要。
当地天气
用于辅助判断降雨、高温、大风等对水质和投喂的影响。