name: roadbook
description: 自驾旅游路书完整工具箱 — 路书创建/更新、照片归档、路线图生成（Leaflet+OSRM）、路书PDF生成
category: travel
集路书模板、照片管理、地图生成、PDF输出于一体的自驾游记录系统。
路书文件: /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 文件是唯一真相，所有生成操作（地图、统计）前必须先读取该文件获取最新数据。
# 🚗 目的地自驾路书
> ✅ 行程状态：进行中/已结束
> 开启时间：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日 | 拉萨休整⚠️ 重要：每录入一个城市/景点/途经点，立即调用海拔查询，将结果填入表格。不要等到最后统一录入，否则容易遗漏。
需要查询海拔的地点：
运行脚本，自动读取路书中所有地点并填充海拔：
python ~/.hermes/skills/travel/roadbook/scripts/lookup_elevation.py <路书MD路径>from scripts.lookup_elevation import lookup_elevation
elevation = lookup_elevation("拉萨") # 返回: 3650（米）## 📅 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）
📌 格式规则：
- 有
→（如成都 → 雅江）：跨城行程，解析为起点 → 终点
- 无
→（如拉萨休整）：同城/休整，起点终点自动相同（自动去除"休整/休息/玩"等后缀）
⚠️ 两种格式不可混用，同一路书保持统一格式。
~/.hermes/image_cache/，文件名 img_xxxxxxxxxx.jpg/mnt/c/Users/zhou/Desktop/目的地+自驾_全部照片/DayX_景点_序号.jpg（如 Day6_珠峰_01.jpg）使用 Leaflet + OSRM 生成交互式 HTML 地图。生成时自动调用 OSRM API 获取真实道路路线，无需用户触发。城市标签、地名、图例等默认全部使用中文。
⚠️ 重要：地图默认就是 OSRM 真实道路轨迹图，不是简单示意图；如果生成了无轨迹的示意图，说明没有正确执行代码中的 OSRM 调用。
# 修改脚本中的路径配置后运行
python ~/.hermes/skills/travel/roadbook/scripts/generate_map.pyvisitedOrder 数组）label === '返程' 或判定为回头路的路线均以虚线（dashArray: '8, 8'）显示第X天 起点→途经点1→途经点2→终点 XXkm拉萨→羊卓雍错→日喀则 356km）虚线为回头路/返程| 主要城市 | 经度 | 纬度 | | 川藏线景点 | 经度 | 纬度 | | 青藏线/西藏景点 | 经度 | 纬度 |
|----------|------|------|--|------------|------|------|--|----------------|------|------|
| 成都 | 104.07 | 30.57 | | 折多山 | 101.56 | 30.29 | | 羊卓雍错 | 90.35 | 29.13 |
| 雅江 | 101.02 | 30.03 | | 高尔寺山 | 101.12 | 30.04 | | 卡若拉山 | 90.22 | 29.05 |
| 如美镇 | 98.42 | 30.08 | | 卡子拉山 | 100.77 | 30.08 | | 纳木措 | 90.53 | 30.73 |
| 波密 | 95.77 | 30.87 | | 理塘 | 100.27 | 30.00 | | 念青唐古拉山 | 90.55 | 30.46 |
| 拉萨 | 91.10 | 29.65 | | 姊妹湖 | 99.92 | 30.12 | | 羊八井 | 90.08 | 30.05 |
| 日喀则 | 89.58 | 29.28 | | 巴塘 | 99.52 | 30.02 | | 嘉措拉山 | 88.08 | 28.88 |
| 珠峰 | 86.93 | 28.53 | | 芒康 | 98.78 | 30.03 | | 加乌拉山 | 87.08 | 28.63 |
| 那曲 | 91.00 | 31.47 | | 东达山 | 97.77 | 30.33 | | 珠峰大本营 | 86.93 | 28.53 |
| 攀枝花 | 101.72 | 26.58 | | 怒江72拐 | 97.42 | 30.20 | | | | |
| 西昌 | 102.27 | 27.89 | | 然乌湖 | 96.68 | 30.13 | | | | |
| 昆明 | 102.71 | 25.04 | | 色季拉山 | 95.62 | 30.72 | | | | |
| 抚仙湖 | 102.85 | 24.45 | | 鲁朗 | 95.33 | 30.47 | | | | |
| 万峰林 | 104.90 | 25.10 | | 林芝 | 94.37 | 30.02 | | | | |
| 石棉 | 102.36 | 29.23 | | 米拉山 | 93.48 | 30.37 | | | | |
从路书MD文件生成美观的HTML路书，使用与现有正常工作路书完全相同的CSS和布局。可导出PDF或生成长图格式。
不同路书的 --- 分隔符格式可能不同：
--- 后跟单换行 \n--- 后跟双换行 \n\n调试方法：如果 re.split() 只返回1个块，先打印 --- 的位置确认格式，再调整正则。正确模式应为 \n---\n\n(?=## 📅 Day)（双换行）。
⚠️ 不同路书的汇总表格式不同，必须分别用不同正则匹配：
格式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。
⚠️ 里程数据必须从路书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*\|），因为列索引因路书不同而变化，会漏掉部分天数。
# 修改脚本中的路径配置后运行
python ~/.hermes/skills/travel/roadbook/scripts/generate_roadbook_html.pycd /mnt/c/Users/zhou/Desktop
google-chrome --headless --disable-gpu --no-sandbox \
--print-to-pdf="成都自驾西藏路书.pdf" --print-to-pdf-no-header "成都自驾西藏路书_打印版.html"| 脚本 | 功能 |
|------|------|
| scripts/generate_map.py | 生成OSRM路线图（Leaflet交互式HTML） |
| scripts/generate_roadbook_html.py | 生成路书HTML打印版（含封面、统计、每日行程） |
| scripts/lookup_elevation.py | 查询并填充路书中各地点的海拔 |