核心用法
ship-position 是一款面向海事、物流及航运管理场景的船舶位置查询技能。用户只需提供船舶的 MMSI（水上移动业务标识码，9位数字），即可调用 HiFleet 专业海事 API 获取该船的最新位置信息。技能支持岸基 AIS、卫星 AIS 与移动基站三重数据源融合，覆盖全球航行船舶。
使用前必须在环境变量或项目配置中设置 HIFLEET_USER_TOKEN 授权令牌。技能采用纯 Markdown 文档形式实现，无本地可执行代码，通过 HTTPS GET 请求与 HiFleet 服务端交互，返回数据包含船名、经纬度、航速航向、吃水深度、目的港、预计抵港时间等 20 余项字段。
显著优点
1. 数据源专业可靠：HiFleet 是国内领先的船舶动态数据服务商，数据覆盖全球 30 万+ 船舶，更新频率高，定位精度优于公开 AIS 平台。
2. 零代码部署：纯文档型技能，无需安装依赖，配置 Token 即可直接使用，集成成本极低。
3. 信息维度丰富：除基础位置外，还提供船舶尺度、载重吨、船籍国、建造年份等静态资料，满足深度分析需求。
4. 安全合规：Token 通过环境变量管理，无硬编码风险；HTTPS 加密传输符合 GDPR、CCPA 等隐私法规要求。
潜在缺点与局限性
1. 强依赖外部服务：功能完全依赖 HiFleet API，若服务故障或网络异常，技能将无法使用；无本地缓存机制，无法离线查询历史位置。
2. Token 获取门槛：需用户自行向 HiFleet 申请授权 Token，对非专业用户存在一定使用门槛。
3. 坐标单位需换算：API 返回经纬度为「分」单位（需除以 60 转换为度），若未做转换易导致定位偏差。
4. 无批量查询能力：单次仅支持单船查询，不适合大规模船队监控场景。
适合的目标群体
- 航运与物流企业：实时追踪自有或合作船舶位置，优化航线调度与 ETA 预测。
- 港口与海事管理机构：监控进出港船舶动态，辅助引航调度与安全监管。
- 大宗商品贸易商：跟踪散货船、油轮位置，掌握货物在途状态。
- 船舶经纪人与研究分析师：获取船舶静态资料与航行历史，支撑市场研究。
使用风险说明
- 服务可用性风险：HiFleet API 为商业服务，可能存在限流、停机或接口变更，建议用户阅读服务条款并建立备用数据源。
- Token 安全管理：Token 泄露可能导致授权额度被耗尽，建议定期轮换并监控使用量。
- 数据精度限制：AIS 数据依赖船舶设备开机与信号覆盖，近海及偏远海域可能存在延迟或盲区。
- MMSI 输入风险：MMSI 输入错误将返回空结果或错误码，建议在前端增加格式校验（9位数字正则）。