技能说明

不配置鉴权也可使用本技能中不需 token 的部分；船位、档案等已实现功能需配置 token 后可用。技能列表与触发词见 references/skills_index.md。

Token 配置（可选，部分接口必填）

船位、档案等已实现功能依赖 HiFleet API 鉴权；不配置 token 时这些接口不可用，但技能中其他不需鉴权的部分仍可使用。需要用到船位/档案时，请配置：

1. 环境变量（二选一）：HIFLEET_USER_TOKEN 或 HIFLEET_USERTOKEN
2. 项目/ClawHub 配置：usertoken / userToken
3. 请求参数：接口支持时传入 usertoken

建议使用仅限本技能使用的专用 token，停用后及时轮换。

已实现功能

船位 / Ship Position

获取（岸基+卫星+移动）船舶最新位置信息。支持**关键字（船名或 MMSI）**查询，自动走“先搜船、再查位”的两步流程。

• 触发：船位、位置、报位、在哪、MMSI、ship position、vessel position
• 输入：关键字（船名或 MMSI）或直接 9 位 MMSI；usertoken 从配置读取
• API 详情：references/position_api.md（含 shipSearch 与 position/get/token）
• 脚本：scripts/get_position.py（支持关键字或 MMSI，可选用于命令行/集成）

两步流程：

1. 第一步 - 搜船：用用户关键字调用 position/shipSearch（shipname、usertoken、i18n=zh、count）。
2. 第二步 - 查位：根据结果数量处理：
   • 0 条：提示未找到，请检查关键字。
   • 1 条：直接取该条 mmsi，调用 position/position/get/token 查位置并展示。
   • 多条：若可推断用户目标船（如关键字为完整 MMSI 或唯一匹配船名），则用对应 MMSI 查位；否则列出船名/MMSI/船型/船籍等，请用户选择具体 MMSI，再按所选 MMSI 调用 position/position/get/token 查位置。

若用户已提供 9 位数字 MMSI，可省略第一步，直接调用 position/position/get/token。展示时经纬度需将接口返回的 la/lo 除以 60 转为度。

档案 / Archive

根据 IMO 或 MMSI 获取船舶档案（基本信息、尺度、舱容、建造、入级、动力、公司信息、互保协会等）。接口支持 imo 与 mmsi 二选一，内贸船无 IMO 时仅传 mmsi 即可。船名不支持，需先通过 shipSearch 得到 MMSI/IMO。

• 触发：档案、船舶信息、船籍、船型、船东、管理公司、archive、vessel profile、ship info
• 输入：IMO（7 位）或 MMSI（9 位）；usertoken 从配置读取
• API 详情：references/archive_api.md
• 脚本：scripts/get_archive.py（支持 IMO 或 MMSI，MMSI 直接传 mmsi 参数，需 token）

调用流程：检查 token → 若为 IMO：GET ...?imo={imo}&usertoken=...；若为 MMSI：GET ...?mmsi={mmsi}&usertoken=...（支持内贸船无 IMO）→ 解析 data，按 labelZh 分块展示。船名需先 shipSearch 得到 MMSI/IMO 再查档案。

安全与合规

本技能仅向 https://api.hifleet.com 的船位/档案接口发起只读 GET 请求，token 仅用于 API 鉴权。详见 SECURITY.md。

参考资料与脚本