Ship Position

核心用法

HiFleet Skills 是一套面向航运业的综合数据查询工具集，通过标准化API接口提供船舶位置、档案、港口国监督(PSC)检查、海峡通航统计、区域船舶监控及港口信息等多维度数据服务。

主要功能模块：

• 船位追踪：支持船名/MMSI关键字搜索，自动完成"搜船→查位"两步流程，返回岸基+卫星+移动多源融合的实时船位
• 船舶档案：按IMO或MMSI查询船舶全量档案，涵盖基本信息、尺度、舱容、建造、入级、动力、公司信息、互保协会等
• PSC检查：单船历史检查记录查询，支持IMO/船名/MMSI多种输入方式
• PSC OpenClaw分析：基于日批统计的异常事件检测（滞留率飙升、缺陷异常等）及宏观统计对比（当局/船旗/港口维度）
• 海峡通航：曼德海峡、苏伊士运河、好望角、霍尔木兹海峡的通航统计与船舶明细
• 区域船舶：支持bbox矩形、areaId区域ID、WKT多边形三种方式查询指定区域内当前船舶
• 港口指南：港口列表检索与单港详细信息查询

技术特性：

• 采用环境变量HIFLEET_API_KEY统一鉴权
• 部分功能（如海峡通航）在无私钥时限7天数据，有私钥时时间区间不限
• 严格区分authority（检查国）、flag（船旗国）、ship_type（检查类型）等字段语义

显著优点

1. 数据维度丰富：覆盖船位、档案、PSC、通航统计、区域监控等航运核心业务场景，单技能满足多类查询需求
2. PSC深度分析能力强：除单船记录外，提供基于统计模型的异常检测（OpenClaw）和宏观对比分析，可回答"某检查国是否变严""哪船旗风险高"等复杂问题
3. 区域查询灵活：支持坐标矩形、预定义区域、自定义WKT多边形三种空间查询方式
4. 触发词设计完善：中英文双语触发词覆盖专业术语（如"曼德海峡""Port State Control"）
5. 数据合规性设计：OpenClaw模块内置数据稀疏保护规则，明确区分"异常表无命中"与"无PSC活动"，避免误导性结论

潜在缺点与局限性

1. API密钥依赖重：核心功能均需HIFLEET_API_KEY，无私钥时功能大幅受限（如海峡通航限7天）
2. 部分功能待实现：性能（油耗能效）、航程航次、航线推荐、气象海况、船队监控、AIS报文等功能标记为"待实现"
3. 内贸船限制：无IMO船舶无法调用PSC接口；部分国际航行数据对内贸船覆盖有限
4. OpenClow数据稀疏风险：统计异常表可能因阈值严格、样本不足等原因返回极少数据，需人工解读
5. 字段语义易混淆：ship_type实际表示检查类型而非船型，authority表示检查国而非船籍国，用户易产生误解

适合人群

• 航运公司运营人员：船位监控、船队管理、航线规划
• 船舶管理公司（SMC）：船舶档案维护、PSC迎检准备
• 租船经纪与租家：open vessel查询、船期匹配、港口距离排序
• 海事咨询与研究机构：PSC监管趋势分析、船旗/港口风险评估
• 保险与金融机构：船舶风险评估、合规性尽调

常规风险

1. API密钥泄露风险：HIFLEET_API_KEY为访问凭证，需在环境变量中安全配置，避免硬编码提交
2. 数据时效性风险：船位、区域船舶等实时数据存在正常延迟；统计类数据（PSC异常）为日批更新，非实时
3. 统计推断风险：OpenClaw基于历史基线检测异常，但"显著升高"不等于"必然问题"，需结合单船记录综合判断
4. 覆盖范围风险：AIS融合数据存在卫星盲区、岸基站覆盖差异；部分敏感区域数据可能受限
5. 误用风险：禁止用异常表替代单船PSC查询；禁止将TYPE_INS检查类型误作船型进行商业决策

核心用法

本技能是HiFleet官方出品的综合性航运数据查询工具，面向航运业从业者提供一站式船舶与海事信息检索服务。核心功能模块包括：

船舶追踪与档案：通过船名、MMSI或IMO号码查询船舶实时位置（融合岸基+卫星+移动AIS数据），获取船舶完整档案信息（基本参数、尺度、舱容、建造信息、入级状态、动力配置、公司隶属、互保协会等）。支持"先搜船、再查位"的智能两步流程，自动处理模糊匹配与多结果选择。

PSC港口国监督检查：提供单船PSC历史记录查询（需IMO号码），以及宏观层面的PSC异常统计与对比分析，包括滞留率飙升检测、缺陷热点排行、当局/旗国/港口多维度的监管趋势分析，帮助识别船舶合规风险与港口检查强度变化。

区域与海峡通航：支持曼德海峡、苏伊士运河、好望角、霍尔木兹等咽喉航道的通航统计，可按日期区间与航行方向生成船型分布与船舶明细；区域船舶查询支持矩形框选（bbox）、区域名称（areaId）或WKT多边形三种方式，适用于贸易区监控、电子围栏等场景。

港口与租船服务：港口列表检索（支持港名或UN/LOCODE代码）与单港详细信息查询；租船模块整合船盘/货盘邮件解析、港口距离排序、班轮船期查询，辅助租船决策与航线规划。

显著优点

数据权威性与覆盖度：直接对接HiFleet官方API，数据来源涵盖全球AIS网络、港口国监督检查数据库、航运档案库，信息实时更新且具备行业公信力。PSC异常检测基于日批统计模型，能够识别相对历史基线的显著偏离，具备统计严谨性。

功能集成度高：单一技能覆盖船舶追踪、合规检查、航线分析、港口信息、租船支持五大航运核心场景，避免多工具切换的碎片化体验。中英双语触发词与输出支持，适应国际化航运环境。

查询智能化：内置模糊匹配与歧义消解机制（如多船名冲突时列出候选让用户选择），降低精确输入负担；支持自然语言区域描述（如"红海""马六甲海峡"）自动映射至标准区域ID。

安全设计规范：纯Python标准库实现，零第三方依赖，无动态代码加载风险；API密钥通过环境变量管理，不落地存储；租船模块内置邮件脱敏与本地SQLite缓存，数据不出境。

潜在缺点与局限性

功能实现不均衡：船位、档案、PSC、海峡通航、区域船舶、港口指南等模块已完全可用，但性能（油耗能效）、航程（航次挂港ETA/ETD）、航线（推荐航路点）、航运（运价市场）、气象海况、船队监控、AIS报文轨迹回放等模块标注为"待实现"，用户预期管理需依赖文档说明。

鉴权门槛与使用限制：核心功能强制依赖HIFLEET_API_KEY环境变量配置，无密钥用户仅可查询最近7天的海峡通航数据；内贸船舶若无IMO号码则无法使用PSC检查接口（尽管档案接口支持MMSI替代）。

网络协议混合：海峡通航统计接口（statisticzonetraffic）仍使用HTTP明文传输，虽经评估风险可控，但存在中间人攻击理论可能，需等待官方HTTPS升级。

数据稀疏性约束：PSC异常统计表（openclaw/anomalies）基于日批模型生成，数据量可能极少甚至为空，此时无法推断"无风险"或"监管宽松"，仅表示当前筛选条件下无异常事件命中，对用户的统计解读能力有一定要求。

适合的目标群体

航运公司运营与船队管理：需要实时监控船舶位置、追踪船队动态、评估船舶合规风险的管理人员。

租船经纪人与船舶经营人：依赖船盘货盘信息、港口距离计算、班轮船期查询进行租约谈判与航线优化的从业者。

港口与物流企业：关注咽喉航道通航状况、区域船舶流量、港口信息的调度与规划人员。

海事咨询与风控服务：利用PSC统计数据进行港口国监管趋势分析、船舶滞留风险预警、船旗/船级绩效评估的专业机构。

航运金融与保险：需要船舶档案信息、互保协会记录、历史合规数据进行尽职调查与风险评估的分析师。

使用风险

API可用性依赖：所有功能均依赖HiFleet官方API服务的在线状态，网络中断或服务维护时将无法使用；建议关键业务场景配置备用数据源。

数据时效性边界：船位数据融合多源AIS，存在分钟级延迟；PSC统计数据基于日批更新，非实时；海峡通航统计无密钥限制7天窗口，历史分析需提前规划密钥配置。

密钥安全管理：虽设计上API Key不写入文件，但环境变量配置仍需用户自行保障终端安全，避免在共享环境中明文暴露。

统计解读误用：PSC异常统计并非因果推断工具，不可用于"某港必然滞留""某旗必被针对"等绝对化断言；数据稀疏时更应避免过度推断，建议结合单船PSC记录交叉验证。

HTTP传输风险：海峡通航模块的明文传输在公共网络环境下存在被窃听或篡改可能，敏感航运信息查询建议在可信网络环境中使用。