Self-drive Travel Roadbook

生活服务

自驾路书全功能工具箱：创建/更新路书、照片归档、路线图生成（Leaflet+OSRM）、PDF导出

旅行规划

492

下载量

安装量

收藏量

★ 5.0

综合评分ⓘ

概述

更多信息

🚗 自驾路书完整工具箱#

集路书模板、照片管理、地图生成、PDF输出于一体的自驾游记录系统。

1. 文件路径规范#

text

路书文件:    /mnt/c/Users/zhou/Desktop/目的地自驾路书.md
路书HTML:    /mnt/c/Users/zhou/Desktop/目的地路书_打印版.html
路书PDF:     /mnt/c/Users/zhou/Desktop/目的地路书.pdf
照片目录:    /mnt/c/Users/zhou/Desktop/目的地自驾_全部照片/
封面地图:    /mnt/c/Users/zhou/Desktop/目的地自驾_全部照片/map_cover.jpg
地图HTML:    /mnt/c/Users/zhou/Desktop/目的地自驾_OSRM路线图.html
路线缓存:    /tmp/目的地_routes.json

⚠️ 命名规则：

路书HTML/PDF：不带"自驾"二字（如 成都至西昌路书_打印版.html）

照片目录：带"自驾"和"全部照片"（如 成都至西昌自驾_全部照片/）

路书文件可放在 Desktop 或其子文件夹中（如 云贵旅行/成都至西昌自驾路书.md）

数据唯一性：路书 MD 文件是唯一真相，所有生成操作（地图、统计）前必须先读取该文件获取最新数据。

2. 📝 路书录入流程#

2.1 新建路书模板#

markdown

# 🚗 目的地自驾路书

> ✅ 行程状态：进行中/已结束
> 开启时间：YYYY年MM月DD日 HH:MM
> 结束时间：YYYY年MM月DD日
> 路线总览：出发地 → 途经地1 → 途经地2 → 目的地

---

## 📅 行程统计
| 天数 | 路线 | 里程 | 消费 |
|------|------|------|------|
| Day 1 (MM/DD) | 起点→终点 | XXXkm | ¥XXX |
| **累计** | — | **X,XXXkm** | **¥XX,XXX** |

---

## 📅 Day 1 — YYYY年MM月DD日 | 起点 → 终点
## 📅 Day 9 — YYYY年MM月DD日 | 拉萨休整

2.2 录入原则：每录入一个地点，立即查询海拔#

⚠️ 重要：每录入一个城市/景点/途经点， 立即调用海拔查询，将结果填入表格。不要等到最后统一录入，否则容易遗漏。

需要查询海拔的地点：

起点海拔：查询出发地的海拔
终点海拔：查询目的地的海拔
途经点/景点海拔：查询每个途经景点的海拔

2.3 海拔查询方式#

方式一：批量自动查询（推荐）

运行脚本，自动读取路书中所有地点并填充海拔：

bash

python ~/.hermes/skills/travel/roadbook/scripts/lookup_elevation.py <路书MD路径>

方式二：单独查询

python

from scripts.lookup_elevation import lookup_elevation
elevation = lookup_elevation("拉萨")  # 返回: 3650（米）

2.4 每日录入模板#

markdown

## 📅 Day 1 — YYYY年MM月DD日 | 起点 → 终点

### 🛣️ 行程信息
| 项目 | 内容 |
|------|------|
| 起点 | 起点名称（海拔：XXX m） |
| 终点 | 终点名称（海拔：XXX m） |
| 出发时间 | HH:MM |
| 到达时间 | HH:MM |
| 行程耗时 | 约X小时XX分 |
| 行驶里程 | XXXXX km → XXXXX km |
| 当日总里程 | **XXX km** |
| 入住宾馆 | **宾馆名称**（地点） |

### 💰 今日消费
| 类别 | 金额 |
|------|------|
| 住宿费 | ¥XXX |
| 用餐费 | ¥XX |
| 加油费 | ¥XXX |
| 高速过路费 | ¥XXX |
| 门票/观光费 | ¥XXX |
| 其他杂费 | ¥XX |
| **合计** | **¥XXX** |

### 🏔️ 景点驻留
| 景点 | 海拔 | 停留时间 | 主要风光 |
|------|------|----------|----------|
| 景点名称 | XXXX m | XX分钟 | 风光描述 |

### 😊 有趣的人与事
1. 描述1
2. 描述2

### 📷 精彩瞬间
- Day1_景点名_01~03.jpg（共3张）

📌 景点海拔来源：

使用 lookup_elevation.py 脚本自动查询

或通过网络搜索确认（部分著名景点如珠峰大本营有精确海拔）

所有景点都必须有海拔数据，格式： XXXX m（纯数字+空格+m）

2.5 标题格式规则#

📌 格式规则：

有 →（如 成都 → 雅江）：跨城行程，解析为起点 → 终点

无 →（如 拉萨休整）：同城/休整，起点终点自动相同（自动去除"休整/休息/玩"等后缀）

⚠️ 两种格式不可混用，同一路书保持统一格式。

3. 📷 照片处理流程#

照片自动存入 ~/.hermes/image_cache/，文件名 img_xxxxxxxxxx.jpg
立即复制 到统一照片目录： /mnt/c/Users/zhou/Desktop/目的地+自驾_全部照片/
不要猜测 照片内容，等用户确认是第几天+景点后再重命名
重命名格式： DayX_景点_序号.jpg（如 Day6_珠峰_01.jpg）
统一文件夹是唯一真相来源，image_cache 仅作临时缓存

4. 🗺️ 地图生成#

使用 Leaflet + OSRM 生成交互式 HTML 地图。 生成时自动调用 OSRM API 获取真实道路路线，无需用户触发。城市标签、地名、图例等 默认全部使用中文。

⚠️ 重要：地图默认就是 OSRM 真实道路轨迹图，不是简单示意图；如果生成了无轨迹的示意图，说明没有正确执行代码中的 OSRM 调用。

4.1 生成脚本#

bash

# 修改脚本中的路径配置后运行
python ~/.hermes/skills/travel/roadbook/scripts/generate_map.py

4.2 回头路/返程检测逻辑#

记录城市首次出现的顺序（ visitedOrder 数组）
如果某段路线的起点在城市访问顺序中位于终点之后，判定为回头路
label === '返程' 或判定为回头路的路线均以虚线（ dashArray: '8, 8'）显示

4.3 图例显示逻辑#

格式： 第X天起点→途经点1→途经点2→终点 XXkm
途经点直接嵌入路线字符串（如 Day5： 拉萨→羊卓雍错→日喀则 356km）
虚线图例说明： 虚线为回头路/返程

4.4 坐标参考表#

主要城市经度纬度川藏线景点经度纬度青藏线/西藏景点经度纬度成都104.0730.57折多山101.5630.29羊卓雍错90.3529.13雅江101.0230.03高尔寺山101.1230.04卡若拉山90.2229.05如美镇98.4230.08卡子拉山100.7730.08纳木措90.5330.73波密95.7730.87理塘100.2730.00念青唐古拉山90.5530.46拉萨91.1029.65姊妹湖99.9230.12羊八井90.0830.05日喀则89.5829.28巴塘99.5230.02嘉措拉山88.0828.88珠峰86.9328.53芒康98.7830.03加乌拉山87.0828.63那曲91.0031.47东达山97.7730.33珠峰大本营86.9328.53攀枝花101.7226.58怒江72拐97.4230.20西昌102.2727.89然乌湖96.6830.13昆明102.7125.04色季拉山95.6230.72抚仙湖102.8524.45鲁朗95.3330.47万峰林104.9025.10林芝94.3730.02石棉102.3629.23米拉山93.4830.37

5. 📄 路书HTML/PDF生成#

从路书MD文件生成美观的HTML路书， 使用与现有正常工作路书完全相同的CSS和布局。可导出PDF或生成长图格式。

5.0 已知格式差异#

不同路书的 --- 分隔符格式可能不同：

西藏路书： --- 后跟单换行 \n
云贵路书： --- 后跟双换行 \n\n

调试方法：如果 re.split() 只返回1个块，先打印 --- 的位置确认格式，再调整正则。正确模式应为 \n---\n\n(?=## 📅 Day)（双换行）。

5.1 汇总表格式（关键）#

⚠️ 不同路书的汇总表格式不同，必须分别用不同正则匹配：

格式A — 有里程行（如 | Day 1 (05/02) | 成都→西昌 | 356km | ¥718 |）：

python

for m in re.finditer(r'\|\s*Day\s*(\d+)\s*\(([^)]+)\)\s*\|\s*(.+?)\s*\|\s*([\d,]+)\s*km\s*\|\s*(¥[\d,.]+)\s*\|', content):
    summary.append({'day': int(m.group(1)), 'date': m.group(2), 'route': ..., 'km': m.group(4)+'km', 'cost': m.group(5)})

格式B — 休整日行（如 | Day 3 (05/04) | 昆明休整 | — | ¥530 |）：

python

for m in re.finditer(r'\|\s*Day\s*(\d+)\s*\(([^)]+)\)\s*\|\s*(.+?)\s*\|\s*—\s*\|\s*(¥[\d,.]+)\s*\|', content):
    summary.append({'day': int(m.group(1)), 'date': m.group(2), 'route': ..., 'km': '—', 'cost': m.group(4)})

⚠️ 注意：路书 MD 文件中的汇总表， km 数字前 没有空格（如 356km 而非 356 km），必须用 ([\d,]+)\s*km 匹配，不能用 \d+\s+km。

5.2 当日总里程解析#

⚠️ 里程数据必须从路书MD文件解析，不可硬编码。不同路书的表格列数可能不同，简单的列索引匹配会漏掉Day3/5/7等休整日。

正确方法：遍历MD文件的每一行，查找含"当日总里程"的行，然后向上回溯至多40行找到Day标题，取其中的数字：

python

lines = content.split('\n')
mileage = {}
for i, line in enumerate(lines):
    if '当日总里程' in line:
        for j in range(i-1, max(0, i-40), -1):
            dm = re.search(r'## 📅 Day (\d+)', lines[j])
            if dm:
                m = re.search(r'\*\*(\d+)\s*km\*\*', line)
                if m:
                    mileage[int(dm.group(1))] = int(m.group(1))
                break

⚠️ 注意： 当日总里程 表格行的格式为 | 当日总里程 | **356 km** |，其中 **356 km** 包含空格，应匹配 \*\*(\d+)\s*km\*\*。

错误方法：用正则匹配表格某列（如 \|\s*\d+\s*km\s*\|），因为列索引因路书不同而变化，会漏掉部分天数。

5.3 生成流程#

Step 1: 生成HTML（Python脚本）

bash

# 修改脚本中的路径配置后运行
python ~/.hermes/skills/travel/roadbook/scripts/generate_roadbook_html.py

Step 2: 导出PDF

bash

cd /mnt/c/Users/zhou/Desktop
google-chrome --headless --disable-gpu --no-sandbox \
    --print-to-pdf="成都自驾西藏路书.pdf" --print-to-pdf-no-header "成都自驾西藏路书_打印版.html"

Scripts#

脚本功能scripts/generate_map.py生成OSRM路线图（Leaflet交互式HTML）scripts/generate_roadbook_html.py生成路书HTML打印版（含封面、统计、每日行程）scripts/lookup_elevation.py查询并填充路书中各地点的海拔