技能介绍

海事数据查询的工程化封装

在船舶追踪、港口 ETA、航线参考和海洋环境研判中，常见难点不是拿到单点 API，而是如何把 MMSI、IMO 消歧、港口五位码、潮汐站 ID、时间窗口、区域多边形和权限边界统一处理。该技能将 ShipXY 的 33 项海事服务封装成受控 CLI 流程：先读取服务语义契约，再校验参数，执行调用，并按返回解释规则分析结果，避免手工拼接请求导致口径不一致。

从查询到研判的工作方式

核心能力包括：按 MMSI、IMO、船名或呼号搜索船舶并区分同名船；查询单船或多船最新 AIS 位置、航速、航向及周边约 10 海里船舶；读取多边形区域当前快照或固定船队；查询船籍、船旗和 Lloyd's 档案；分析历史轨迹、接近事件和靠港记录；搜索港口五位码并查询靠泊、锚泊、预计到港及历史活动；获取单船 ETA 和港到港参考航线；查询气象、台风、潮汐及航行警告。

关键步骤强调：已有可信 MMSI 时跳过搜索；港名必须先经港口搜索获取五位码；潮汐站 ID 与港口码分离；区域快照不能替代历史发现；大范围或历史查询先做 dry-run 校验；大响应写入文件并读取 result_path，不把完整数据倒进对话。

适用边界与使用注意

该技能适合需要可解释、可复核的海事数据工作流，例如船舶监控、港口运营分析、航线前期参考和海洋环境检查。但它不等同于导航系统：航线结果只用于规划参考，不能作为导航指令、安全许可或避碰建议。不同接口有明确限制，如接近事件单次不超过 31 天，靠港清单单次不超过 7 天，区域多边形建议使用有序 lng,lat 点并处理分页。权限、历史深度、额度和数据新鲜度都会影响结果，汇报时应保留时间、时区、单位、哨兵值和分页状态。