travel-roadbook-pipelinelisted
Install: claude install-skill Wexexortexort/travel-roadbook-pipeline
# 路书生成器
把用户的一句话目的地,做成**可核实、图文匹配、可打印**的本地单文件 HTML 路书。
> **总原则:可靠性 > 完整性 > 华丽度。**
> 一次信息编造、或图片与途经点对不上的交付,比朴素但可靠的交付差得多。
> 任何环节出问题都**降级交付,绝不停摆**。
> **实时取数 > 模型记忆。** 路线与里程走高德 REST 实时导航数据(国内路网最准的来源之一),
> 在地情报走小红书实时检索(只采信 2 年内 + 同季节的笔记)。
> **不要凭训练数据里的印象写里程、路况或景区规则** —— 那些信息通常已过时数年。
> **交付形态:本地单文件 HTML。** 不需要部署、不需要服务器、不需要任何账号。
> 双击即可打开、可直接打印/导出 PDF。**不做上线。**
## 四个必须避开的坑(实证)
| 坑 | 后果 | 做法 |
|---|---|---|
| 里程**只核总量**不核逐段 | 总量仅差 39 km,但单日虚高 198 km、另一日漏算 265 km | **逐段核验 + 单日时长排序**(Phase 1、2) |
| 出发地只问到市级 | "市"实为其下辖县,相距 100 km,单段误差 **198 km** | **强制问到县级**(Phase 0) |
| 手填景区坐标 | 某景区纬度错 0.28° ≈ 31 km,当天里程虚高 **76 km** | **POI 坐标必先校准**(Phase 2.2) |
| 图片**盲取第 N 张**即入页面 | 抓到头像 / 攻略信息图 / 与途经点不符的图 | **分级闸门校验**(Phase 5,默认轻量档) |
---
## Phase -1 · 环境预检(**每次必跑,不可跳过**)
开工前先体检,**不要跑到一半才发现缺 Key / 没装库**。
```bash
PY="<你的 python 绝对路径>"
"$PY" scripts/preflight.py --workdir "<路书工作目录>"
```
输出两类结论:
```
✅ 就绪 全部关键依赖在位
❌ 缺少关键依赖 缺高德 Key 或 bsk,必须先补齐
```
### 依赖清单与缺失时的指引
| 依赖 | 必需性 | 缺了怎么办 |
|---|---|---|
| **Python 3.10+** | 必需 | WorkBuddy 自带 3.12/3.13/3.14,用管理版绝对路径 |
| **Pillow** | 必需 | `"<python>" -m pip install pillow` |
| **bsk (browser-skill)** | 必需 | 见下方「bsk 安装」 |
| **高德 REST Key** | 必需 | 见下方「高德 Key 获取」 |
| **fontTools** | 可选 | 仅自托管字体子集化需要;用系统字体栈则免 |
**bsk 安装**(`preflight.py` 会给出同样指引):
1. 安装 browser-skill CLI
2. 在 Chrome 里安装 BrowserSkill 扩展并启用
3. **在该 Chrome 登录 xiaohongshu.com**(bsk 复用你的登录态,这是它比爬虫可靠的原因)
4. 验证:`bsk status --jso