核心功能与用法
HiFleet Skills 是一套面向航运业的专业数据查询技能集，核心能力围绕船舶全生命周期追踪与海事合规监管展开。用户通过配置 HIFLEET_API_KEY 即可调用四大类服务：
1. 实时与历史船位服务
- 支持船名/MMSI/IMO多维度检索，自动执行"搜船→查位"两步流程
- 提供岸基+卫星AIS融合数据，含航速、航向、目的港、状态等字段
- 历史轨迹查询支持3个月压缩数据或1个月原始点序列，可限定地理边界
2. 船舶档案与航程分析
- 档案接口返回船舶尺度、舱容、建造信息、船级社、管理公司等结构化数据
- 航程模块涵盖历史挂靠港、完整航次记录、上一离港港口及当前停船时长分析
- 所有时间序列数据均采用北京时间，便于国内业务场景使用
3. 宏观航运监控
- 海峡通航统计：曼德海峡、苏伊士运河、霍尔木兹等咽喉航道按日/方向统计船型分布（无API Key限7天）
- 区域船舶监控：支持bbox矩形、区域ID或WKT多边形三种空间查询方式
- 集装箱红海绕航：专项追踪绕航曼德海峡的集装箱船舶动态
4. PSC合规与风险管理
- 单船PSC检查记录查询（需IMO号）
- 统计异常检测：基于日批模型识别滞留率/缺陷数的显著偏离（OpenClaw）
- 宏观统计对比：按检查当局、船旗、港口等多维度分析监管趋势
- 严格区分
authority（检查国）与flag（船籍国）字段语义
显著优点
- 数据权威性：源自主流AIS数据融合商HiFleet，覆盖国际航行船舶的IMO注册体系
- 计费透明：按实际数据量阶梯计费（轨迹每100点1积分、挂靠每20条1积分），余额与流水可实时查询
- 企业级安全：仅向固定域名
api.hifleet.com发起只读请求，无动态代码执行风险 - 中文原生：全字段中文标签、北京时间、国内港口优先匹配，降低航运从业者使用门槛
局限性与潜在风险
| 限制类型 | 具体说明 |
|---------|---------|
| 鉴权门槛 | 必须预配置`HIFLEET_API_KEY`，无免费匿名额度 |
| 内贸船盲区 | 无IMO号的内贸船舶无法查询PSC记录；部分功能依赖MMSI |
| 时间窗口限制 | 历史轨迹压缩版约3个月、未压缩版仅1个月 |
| 统计模型约束 | PSC异常检测存在`min-inspections`阈值，低流量港口可能无异常标记≠无风险 |
| 实时性边界 | AIS数据存在卫星覆盖间隙，近岸船位更新频率优于远洋 |
合规红线：严禁将PSC统计异常直接解读为"某国刻意针对"，禁止基于稀疏样本输出投资建议（如"必避开某港"）。对未来监管趋势须使用谨慎表述。
适用人群
- 航运运营方：调度、租船、商务部门需实时掌握船队位置与港口动态
- 海事合规岗：PSC检查记录追溯、船旗风险评估、缺陷码热点分析
- 大宗商品贸易商：海峡通航量监控、区域船舶密度研判供应链风险
- 保险与金融机构：船舶档案核验、航次历史审计、区域风险敞口评估
典型风险场景
1. API Key泄露：HIFLEET_API_KEY直连计费账户，需按机密凭证管理
2. MMSI误匹配：船名搜索返回多条结果时须用户确认，避免张冠李戴
3. 时区混淆：接口返回北京时间，但部分历史数据可能含UTC原始记录
4. 积分透支：高频轨迹查询（如全船队历史回放）可能快速消耗积分余额