核心功能
WindSensei 是一款面向风运动爱好者的专业天气技能,支持风筝冲浪(Kitesurfing)、翼板(Wingfoiling)、帆板(Windsurfing)及冲浪(Surfing)等运动的风况查询与预报。
主要用法
基础查询:用户可直接询问"Cherry Beach 风怎么样"或"周末能去风筝冲浪吗",技能自动调用 https://windsensei.com/api/v1/wind-report API 获取实时风况。支持模糊匹配地点名称,一次返回最多 3 个匹配结果。
时间窗口:支持 today/tomorrow/weekend/week 四种预报周期,默认返回当日数据。
双模式运行:
- 公共模式(无 API Key):查询任意公开地点,使用默认偏好设置(12-40kt,8am-8pm)
- 认证模式(有 API Key):自动读取用户收藏地点与个性化活动偏好,返回定制化预报
日历联动:检测到优质风况窗口时,可自动调用宿主代理的日历工具创建活动,标题格式为"Kite @ {地点}",包含风速、风向、温度等详细描述。
新地点申请:当查询地点无数据时,支持通过 POST /api/v1/spot-request 提交新增申请,重复申请自动去重。
显著优点
1. 领域专业性:专为风运动设计,非通用天气 API,数据包含浪向质量、适宜装备等垂直领域指标
2. 智能时间块分析:将连续适宜时段聚合成"blocks",避免用户手动筛选小时级数据
3. 零门槛使用:无 API Key 时功能完整,降低首次使用阻力
4. 开放生态:API Key 免费生成,地点数据众包扩展
局限性与风险
数据覆盖:依赖 WindSensei 自建数据库,小众地点可能缺失(需主动申请添加)
区域局限:从示例地点(Cherry Beach、Hanlan's)推测主要覆盖北美地区,其他地区支持程度不明
预报精度:未明确说明数据源(气象模型/实测站),长周期预报(week)可靠性存疑
安全依赖:仅只读 HTTPS 请求,不直接处理敏感凭证,但 API Key(ss_ 前缀)如泄露可能导致个人偏好数据暴露
适合人群
- 风筝冲浪、翼板、帆板爱好者
- 需要基于风况规划行程的户外运动员
- 希望自动化日历管理的效率型用户
常规风险提示
- 海上运动存在固有风险,风况预报仅供参考,实际出海前需结合现场判断
- API Key 建议妥善保管,避免在公共环境硬编码