技能介绍

要解决的问题

海运货物追踪经常在工程层面失败：箱号、提单号和订舱号格式不同，路由规则复杂；船司站点和聚合平台可能返回脏数据、验证码或登录墙；查询失败时，也很容易把“没拿到数据”误当成“货物没有进展”。

这个技能如何工作

cargo-tracking 负责输入识别，包括 ISO 6346 集装箱校验位和提单前缀路由，并做有边界的多来源编排。默认 scope 只对无需凭证的公共来源发起真实查询，例如 SITC、COSCO、Sinotrans 和 Evergreen；需要凭证的来源会被跳过并给出指引。

结果模型严格分成两层：

result_status：表示查询本身是否成功，例如 success、partialsuccess、noresult、source_failed 等。
tracking_status：只有在查询成功或部分成功时才存在，表示货物在运输流程中的可见状态。

标准流程是提取用户提供的编号，通过 scripts/track.py 执行单次或批量查询，先解释 result_status，再读取结构化轨迹。诊断命令可以展示应路由到哪个船司、是否缺少凭证、官方查询入口在哪，以及是否建议人工复核。

适用边界

不要从失败查询推断 delivered、cleared 或 not found。失败只说明数据没拿到，不是业务事实。tracking_status 是可见性数据，不构成放货、责任判定或清关证明。默认 scope 不会自动查询 Maersk、MSC、Hapag-Lloyd、CMA CGM 等需要凭证的来源；订舱号通常也没有稳定公共来源。