| name | orm-weather-routing-nav-voyage-distance |
| description | ORM 气象导航航次距离计算工具 - 通过 NavOptima 查询港口间航行距离（海里） |
| homepage | https://ormwx.com |
| metadata | {"clawdbot":{"emoji":"⚓","requires":{"bins":"[Truncated]"},"install":[]}} |
⚓ ORM WEATHER ROUTING NAV VOYAGE DISTANCE SKILL
中文名： ORM 气象导航航次距离计算工具
英文名： ORM WEATHER ROUTING NAV VOYAGE DISTANCE SKILL
版本： 2.4.0（航次增强版）
创建时间： 2026-03-24
更新时间： 2026-03-24 13:14
维护人： ORM 正权海事 - AI 系统
📋 工具概述
用途： 通过 NavOptima 气象导航系统计算全球港口间的航行距离（海里）
适用场景： 航次估算、租船合同、气象导航服务、客户报价、多港口航线规划
数据源： NavOptima (https://nop.ormwx.com/voyage/distance) - 公司专业系统
🔐 登录配置（已更新）
NavOptima 账号：
✅ 登录测试： 2026-03-24 11:26 测试成功
安全提醒： 此账号为敏感配置，严禁外泄！
🗺️ 操作流程
Step 1: 登录 NavOptima
- 打开 https://nop.ormwx.com/voyage/distance
- 点击登录按钮
- 选择 "Account Password"
- 输入邮箱和密码
- 勾选协议并登录
Step 2: 输入港口
基础操作（2 个港口）
- 点击起点港口输入框
- 输入港口名称（如
SHANGHAI）
- 从下拉列表选择正确港口（如
SHANGHAI [CN]）
- 点击终点港口输入框
- 输入港口名称（如
BERONG）
- 从下拉列表选择正确港口（如
BERONG [PH]）
高级操作（多港口 - 途经点）
当港口数超过 2 个时：
- 点击 + 按钮（红色框）增加途经点
- 输入途经点港口名称
- 从下拉列表选择正确港口
- 可继续点击 + 添加更多途经点
- 点击 - 按钮可删除多余的港口
示例： 上海→新加坡→鹿特丹（3 个港口）
- 第 1 行：SHANGHAI [CN]
- 第 2 行：SINGAPORE [SG]（途经点）
- 第 3 行：ROTTERDAM [NL]
经纬度设置（精确位置）
当需要设置具体经纬度时：
- 点击港口输入框右侧的 📍 定位图标（红色框）
- 地图进入拖拽模式
- 用鼠标拖拽地图到目标位置
- 观察光标显示的经纬度（右下角显示）
- 根据光标经纬度确定精确位置
- 点击地图设置途经点
- 系统自动记录该点经纬度
适用场景：
- 非标准港口位置
- 特定锚地坐标
- 自定义航线点
- 精确的装/卸货位置
Step 3: 选择 AI Route 并查询
- 点击 AI Route 标签（蓝色按钮）
- 点击 Confirm 按钮
- 等待系统计算（约 3-5 秒）
Step 4: 获取结果
系统显示：
- 航行距离（海里，nm）
- 航程时间（天，days）
- 出发时间（ETD）
- 预计到达（ETA）
- 航线图（地图展示，含气象数据）
Step 5: 截图并发送（强制）
1. 调整地图视图（重要）
2. 截取完整结果图
browser.screenshot(full_page=True, output_path="/tmp/orm-route-result.jpg")
3. 立即发送到聊天窗口（强制）
message.send(
channel="feishu",
target=用户 ID,
media="/tmp/orm-route-result.jpg",
caption="📍 [起点] → [终点] 航线图 - ORM Weather Routing"
)
4. 附加签名信息（强制）
---
### 📞 联系方式
**ORM Weather Routing**
👤 **Andy**
📱 **+86 18669863008** (WeChat/WhatsApp)
📧 **Andy@ormwx.com**
📊 输出格式标准
完整输出模板
## 📍 [起点港口] → [终点港口]
### 航行距离（NavOptima AI Route）
| 项目 | 数值 |
|------|------|
| **航行距离** | **XXX 海里** |
| 航程时间 | X.X 天 |
| 出发时间 | YYYY-MM-DD HH:MM (UTC +8) |
| 预计到达 | YYYY-MM-DD HH:MM (UTC +8) |
| 航速设定 | XX.X kts |
| 天气系数 | X% |
### 航线截图
---
**数据来源：** NavOptima 气象导航系统
**计算时间：** YYYY-MM-DD HH:MM
**精度等级：** ⭐⭐⭐⭐⭐（<1% 误差）
---
### 📞 联系方式
**ORM Weather Routing**
👤 **Andy**
📱 **+86 18669863008** (WeChat/WhatsApp)
📧 **Andy@ormwx.com**
⚠️ 强制要求
1. 航线截图自动发送
- ✅ 无论用户在什么窗口对话
- ✅ 查询结束后立即发送 jpg 格式截图到聊天窗口
- ✅ 使用
message 工具或平台原生图片发送功能
- ✅ 截图必须包含完整航线图 + 距离数据
2. 签名信息（每次必选）
- ✅ 每次查询结束必须附加联系方式
- ✅ 格式固定如下：
---
### 📞 联系方式
**ORM Weather Routing**
👤 **Andy**
📱 **+86 18669863008** (WeChat/WhatsApp)
📧 **Andy@ormwx.com**
📍 常用港口代码
中国港口
| 港口 | 显示名称 | 代码 |
|---|
| 上海 | SHANGHAI [CN] | CNSHA |
| 青岛 | QINGDAO [CN] | CNTAO |
| 宁波 | NINGBO [CN] | CNNGB |
| 深圳 | SHENZHEN [CN] | CNSZX |
| 广州 | GUANGZHOU [CN] | CNGZH |
| 潮州 | CHAOZHOU [CN] | CNCZH |
| 厦门 | XIAMEN [CN] | CNXMN |
| 大连 | DALIAN [CN] | CNDLC |
| 天津 | TIANJIN [CN] | CNTXG |
东南亚港口
| 港口 | 显示名称 | 代码 |
|---|
| Berong | BERONG [PH] | PHBRG |
| 新加坡 | SINGAPORE [SG] | SGSIN |
| 雅加达 | JAKARTA [ID] | IDJKT |
| 马尼拉 | MANILA [PH] | PHMNL |
| 林查班 | LAEM CHABANG [TH] | THLCH |
非洲港口
| 港口 | 显示名称 | 代码 |
|---|
| 马普托 | MAPUTO [MZ] | MZMPM |
| 德班 | DURBAN [ZA] | ZADUR |
| 开普敦 | CAPE TOWN [ZA] | ZACPT |
| 蒙巴萨 | MOMBASA [KE] | KEMBA |
| 达累斯萨拉姆 | DAR ES SALAAM [TZ] | TZDAR |
欧洲港口
| 港口 | 显示名称 | 代码 |
|---|
| 鹿特丹 | ROTTERDAM [NL] | NLRTM |
| 汉堡 | HAMBURG [DE] | DEHAM |
| 安特卫普 | ANTWERP [BE] | BEANR |
| 比雷埃夫斯 | PIRAEUS [GR] | GRPIR |
⚠️ 注意事项
1. 精度说明
| 数据源 | 精度 | 误差范围 |
|---|
| NavOptima | ⭐⭐⭐⭐⭐ | <1% |
| Searoutes API | ⭐⭐⭐⭐ | 1-3% |
| 估算公式 | ⭐⭐⭐ | 5-10% |
2. 必须使用 NavOptima 的场景
- ✅ 租船合同航次估算
- ✅ 客户报价
- ✅ 气象导航服务
- ✅ 航次性能分析
- ✅ 正式报告输出
- ✅ 多港口航线规划
- ✅ 需要精确经纬度的场景
3. 截图要求
- ✅ 必须包含完整航线图
- ✅ 必须显示距离数值
- ✅ 必须显示 ETA 信息
- ✅ 使用 full_page=True
- ✅ 多港口航线需显示所有途经点
4. 安全规则
- ❌ 严禁外泄 NavOptima 账号密码
- ❌ 严禁将截图发送给未授权人员
- ❌ 严禁上传到公开平台
- ✅ 仅限内部使用和客户报价
🔧 错误处理
常见问题
| 问题 | 解决方案 |
|---|
| 登录失败 | 检查账号密码，确认账户有效 |
| 港口找不到 | 尝试使用港口代码或英文名 |
| 结果加载超时 | 增加 wait timeout 到 60 秒 |
| 截图失败 | 检查浏览器权限 |
| AI Route 无响应 | 刷新页面重试，或切换 Experience Route |
| 多港口计算失败 | 检查港口顺序，确保每个港口都有效 |
| 经纬度设置失败 | 确保已点击定位图标，地图已加载 |
降级方案
如果 NavOptima 不可用：
- 尝试刷新页面重新登录
- 使用 Experience Route 作为备选
- 降级到 Searoutes API
- 使用估算公式（需标注误差范围）
📝 使用示例
示例 1：基本查询（2 个港口）
用户：查询潮州到 Berong 的距离
→ 调用 orm-weather-routing-nav-distance "Chaozhou" "Berong"
→ 登录 NavOptima
→ 输入 CHAOZHOU [CN] 和 BERONG [PH]
→ 选择 AI Route → Confirm
→ 返回：837 海里 + 截图
输出：
## 📍 CHAOZHOU [CN] → BERONG [PH]
### 航行距离（NavOptima AI Route）
| 项目 | 数值 |
|------|------|
| **航行距离** | **837 海里** |
| 航程时间 | 3.1 天 |
| 出发时间 | 2026-03-24 11:00 (UTC +8) |
| 预计到达 | 2026-03-27 13:24 (UTC +8) |
| 航速设定 | 12.0 kts |
| 天气系数 | 5% |
---
**数据来源：** NavOptima 气象导航系统
**计算时间：** 2026-03-24 11:09
**精度等级：** ⭐⭐⭐⭐⭐（<1% 误差）
示例 2：多港口查询（3 个港口）
用户：查询上海→新加坡→鹿特丹的航线距离
→ 调用 orm-weather-routing-nav-distance "Shanghai" "Singapore" "Rotterdam"
→ 登录 NavOptima
→ 输入 SHANGHAI [CN]
→ 点击 + 按钮添加途经点
→ 输入 SINGAPORE [SG]
→ 点击 + 按钮添加终点
→ 输入 ROTTERDAM [NL]
→ 选择 AI Route → Confirm
→ 返回各段距离 + 总距离 + 截图
输出：
## 📍 SHANGHAI [CN] → SINGAPORE [SG] → ROTTERDAM [NL]
### 航行距离（NavOptima AI Route）
| 航段 | 距离 | 时间 |
|------|------|------|
| 上海→新加坡 | 2,450 海里 | 8.5 天 |
| 新加坡→鹿特丹 | 8,350 海里 | 29.0 天 |
| **总计** | **10,800 海里** | **37.5 天** |
---
**数据来源：** NavOptima 气象导航系统
**精度等级：** ⭐⭐⭐⭐⭐（<1% 误差）
示例 3：经纬度设置（精确位置）
用户：查询上海到某特定锚地（坐标：22.5°N, 114.0°E）的距离
→ 调用 orm-weather-routing-nav-distance "Shanghai" "22.5,114.0"
→ 登录 NavOptima
→ 输入 SHANGHAI [CN]
→ 点击终点右侧的 📍 定位图标
→ 拖拽地图到目标位置
→ 观察右下角经纬度显示（22.5°N, 114.0°E）
→ 点击地图设置该点为终点
→ 选择 AI Route → Confirm
→ 返回距离 + 截图
示例 4：航次计算
用户：潮州到 Berong，速度 12kt，油耗 20t/d
→ 调用 orm-weather-routing-nav-distance 获取距离 837 海里
→ 时间 = 837/12 = 69.75 小时 = 2.9 天
→ 油耗 = 2.9 × 20 = 58 吨
→ 输出完整航次估算
🎯 高级功能说明
多港口航线规划
适用场景：
操作要点：
- 按顺序输入所有港口
- 使用 + 按钮添加途经点
- 确保港口顺序正确
- 系统自动计算最优航线
经纬度精确设置
适用场景：
- 非标准港口位置
- 特定锚地/泊位
- 海上作业点
- 自定义航线点
操作要点：
- 点击 📍 定位图标
- 拖拽地图到目标区域
- 观察右下角经纬度显示
- 精确点击目标位置
- 系统自动记录坐标
📚 相关文件
| 文件 | 用途 |
|---|
/Users/andy/.openclaw/workspace/skills/orm-weather-routing-nav-distance/SKILL.md | Skill 定义文件 |
/Users/andy/.openclaw/workspace/工具使用规则.md | 工具使用规范 |
/Users/andy/.openclaw/workspace/TOOLS.md | 本地配置 |
🔄 版本历史
| 版本 | 日期 | 更新内容 |
|---|
| 1.0.0 | 2026-03-24 | 初始版本，支持基本距离查询 |
| 2.0.0 | 2026-03-24 | 集成 NavOptima，支持 AI Route + 截图 |
| 2.1.0 | 2026-03-24 11:26 | 更新账号为 distance@ormwx.com，测试登录成功 |
| 2.1.1 | 2026-03-24 11:27 | Skill 名称更新为 ORM WEATHER ROUTING NAV DISTANCE SKILL |
| 2.2.0 | 2026-03-24 11:32 | 新增多港口支持（+ 按钮）、经纬度设置（📍 图标）功能 |
| 2.3.0 | 2026-03-24 11:40 | 强制发送截图到聊天窗口、添加签名信息（Andy 联系方式） |
| 2.3.1 | 2026-03-24 11:55 | 地图自动缩放（始发港 + 目的港同框）、保持原始配色（不渲染） |
| 2.4.0 | 2026-03-24 13:14 | Skill 名称更新：NAV 后增加 VOYAGE（航次增强版） |
✅ 执行确认
维护人： ORM 正权海事 - AI 系统
审核人： 高总
生效时间： 2026-03-24
下次回顾： 2026-03-31
⚓ ORM WEATHER ROUTING NAV VOYAGE DISTANCE SKILL - 专业航海航次距离计算，NavOptima 精准数据！
