核心功能
Stormglass Surf Skill 是一款面向冲浪爱好者与海洋活动规划者的专业数据获取工具，通过整合 Stormglass API 与 Google Geocoding 服务，实现全球冲浪点的精准定位与海洋条件查询。核心能力覆盖：
- 多模定位：支持地名模糊搜索（自动地理编码）或直接经纬度输入
- 全维度数据：浪高、涌高、涌周期、涌向、风速、风向、阵风、水温、潮汐信息
- 灵活时窗：即时快照至72小时预报可选，满足从当下决策到行程规划的不同场景
- 机器优先输出：结构化 JSON 格式专为自动化管道设计，同时保留可读模式便于调试
显著优点
1. 数据权威性：Stormglass 聚合 NOAA、DWD、MetOffice 等多源气象海洋数据，预报精度经冲浪社区广泛验证
2. 工程友好：标准退出码（0/2/3/4/5）、稳定 Schema、mock 模式支持 CI/CD 集成
3. 容错设计：Google Geocoding 失效时自动回退 OpenStreetMap，关键字段缺失时返回 null 而非异常
4. 场景覆盖：从个人晨浪决策到商业冲浪旅行平台的批量数据供给均可支撑
潜在局限
- API 依赖：Stormglass 免费额度有限（每日50次），高频场景需订阅商业计划
- 地理盲区：极偏远海域或小众浪点可能存在预报精度下降
- 数据延迟：潮汐预报为模型推算，与实时验潮站数据可能存在偏差
- 专业门槛：涌向、周期等参数需一定海洋知识基础才能有效解读
适合人群
| 用户类型 | 典型场景 |
|---------|---------|
| 冲浪爱好者 | 周末浪况预判、异地 surf trip 规划 |
| 冲浪教练/学校 | 课程安排、安全评估 |
| 冲浪媒体/平台 | 自动化浪报内容生成 |
| 智能设备开发者 | 冲浪手表、穿戴设备的 API 数据层 |
常规风险
- API 密钥泄露：
STORMGLASS_API_KEY需严格环境变量管理，避免硬编码 - 地理位置误解析：地名重复时（如「Lighthouse Beach」）可能返回错误坐标，建议关键场景用经纬度直输
- 海洋安全边界：预报数据不能替代现场观察与专业救生判断，极端海况下决策责任自负
- 服务连续性：第三方 API 变更可能导致功能中断，生产环境需监控
exit code 4