🚗 自驾路书完整工具箱

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

1. 文件路径规范

路书文件:    /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 新建路书模板

# 🚗 目的地自驾路书

> ✅ 行程状态：进行中/已结束
> 开启时间：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 海拔查询方式

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

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

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

方式二：单独查询

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

2.4 每日录入模板

## 📅 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张）

📌 景点海拔来源：

1. 使用 lookup_elevation.py 脚本自动查询
2. 或通过网络搜索确认（部分著名景点如珠峰大本营有精确海拔）
3. 所有景点都必须有海拔数据，格式：XXXX m（纯数字+空格+m）

2.5 标题格式规则

📌 格式规则：

• 有 →（如 成都 → 雅江）：跨城行程，解析为起点 → 终点
• 无 →（如 拉萨休整）：同城/休整，起点终点自动相同（自动去除"休整/休息/玩"等后缀）

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

3. 📷 照片处理流程

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

4. 🗺️ 地图生成

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

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

4.1 生成脚本

# 修改脚本中的路径配置后运行
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 坐标参考表

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 |）：

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 |）：

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标题，取其中的数字：

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脚本）

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

Step 2: 导出PDF

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

Scripts