旅行达人亲历省心攻略（Travel Planner）
> 一句话简介（人话版 / 市场橱窗文案）：你只管说"想去哪、玩几天、玩什么"，它就帮你把零散的景点排成一份能直接拿去走的行程表——每天去哪、怎么串、开多久车、住哪、花多少钱、带什么装备，连一张离线路线图都给你画好。尤其擅长古建、寺庙、石窟这类人文路线。
Overview
协助用户从"想去哪、玩几天、玩什么"出发，产出一份可执行、带预算的 Excel 旅行攻略。核心方法论来自用户沉淀的六步流程，尤其擅长古建/寺庙/石窟类人文路线；用"地图测距排动线"手法（两两测距 + 19:00 收车 + 顺路优先再调时 + 最佳时段贴合(含摄影/出片) + 换城市才换住(同城不挪窝、帕米尔类高原给2晚) + 返程留 2h）合理分配天数与动线，默认租车自驾、远距离用飞机+高铁组合。要求交通写真实班次/酒店写真实店名/美食写真实店名+评价，禁止只写"租车SUV""火车2h"之类糊话。
- 内置「亲历百宝书」 references/field-notes.md：收录本人实测过的古建/石窟/寺庙点位真实情报（亮点、最佳时段、坑、顺路组合）；做攻略时若候选点命中，直接采用并标注【亲历】，优先级高于通用搜索。
- 可附离线「路线示意图」：用 scripts/generate_route_map.py 把行程点位+路线渲染成自包含 SVG（相对位置示意，无联网、无地图 key），给看的人一个直观的「去了哪些地方、整条路线怎么走」概念。
When to use
- 用户提出"帮我做一份去[目的地]的攻略，大概[N]天，以玩[主题]为主"类请求。
- 用户需要把若干意向景点/城市排成每日动线，或判断"这些点需要几天能走完"。
- 用户做人文（古建/寺庙/石窟）路线，需要评估亮点、耗时、预约/光影等注意事项。
- 最终交付形态为单一「行程」sheet 的 Excel（11 列，费用内联带合计，详见 methodology ⑥）。
Workflow（六步）
严格按以下顺序执行，详细指令见 references/methodology.md：
1. 目的地扩展：列出核心目的地值得玩的点，并顺路覆盖周边可一并游玩的点。
2. 交通与天数判定：查机票/高铁班次 + 地图各地驾车车程，结合「飞机+高铁」组合与租车自驾，判定需要多少天。
3. 点位调研：先查 references/field-notes.md「亲历百宝书」（命中即采用并标注【亲历】，优先级最高）→ 再查 references/cultural-heritage.md 人文专项 → 最后用 web 补通用/最新信息（票价、临时闭馆）。逐点记录亮点/耗时/费用/开放午休/特殊事项。
4. 排每日动线与进出路线：用地图测距排动线（见 methodology ④），设计进出路线与住宿；遵循换城市才换住、同城不挪窝（以基地城市做周边 excursion，帕米尔类高原给 2 晚）、19:00 前收车、避免回头路、返程留 2h。每点填「图片/出片」（机位/光影/禁拍）与「带/装备·天气」（该日首行填装备+天气）。
5. 美食补充 & 具体化：有美食资讯则作为「安排」行（如「新蓝天鸽子汤(惊艳👍)」）或并入备注/tips 就近标注（不做独立列，住宿同理）。硬要求：交通写真实班次/航班时刻/包车价、住宿写真实酒店名、美食写真实店名+评价，禁止泛写。
6. 产出 Excel + 可选路线示意图：用 scripts/build_itinerary.py 把结构化数据渲染为 assets/itinerary-template.xlsx 同构的单一「行程」sheet（费用内联、脚本自动合计）xlsx；另可用 scripts/generate_route_map.py 生成一张离线「路线示意图」（相对位置 SVG，无联网、无地图 key），随攻略一并交付。
人文路线专项
当主题涉及古建/寺庙/石窟时，先查 references/field-notes.md「亲历百宝书」是否已有该点实测；有则直接采用并标注【亲历】。再看 references/cultural-heritage.md 获取这类点位的通用评估要点（最佳时段、预约、讲解、礼仪、耗时经验值、常见坑）。
知名人文目的地起点库见 references/destinations.md，可按需续补。
资源
references/methodology.md：六步流程详细指令与"地图测距排动线"手法（核心资产）。references/cultural-heritage.md：人文路线专项知识。references/destinations.md：人文目的地种子库。references/field-notes.md：亲历百宝书（本人实测古建/石窟/寺庙点位，做攻略时优先采用）。assets/itinerary-template.xlsx：Excel 交付模板（11 列表头 + 示例行）。scripts/build_itinerary.py：将 JSON 行程数据生成 xlsx（依赖 openpyxl）。scripts/ingest_historical.py：把历史攻略（腾讯文档在线表格，列布局可能不统一）自动识别列、归一化为 11 列 xlsx；多 sheet 逐一转换。scripts/generate_route_map.py：把行程 waypoints（经纬度+类型）+ route（顺序）渲染为离线 SVG 路线示意图（无联网、无地图 key，相对位置示意）。自动铺一层区域主要城市（如新疆主要城市）作相对位置参照锚点，路线用带箭头连线勾勒方向；--no-context可关掉参照层。
运行脚本
- 渲染行程：
python scripts/build_itinerary.py --input trip.json --output 行程.xlsx - 仅出空白模板：
python scripts/build_itinerary.py --template --output itinerary-template.xlsx - 导入历史攻略（腾讯文档→9列）：
python scripts/ingest_historical.py --file-id <file_id> --out-dir ./out --no-total - 离线路线示意图：
python scripts/generate_route_map.py --input map.json --output route.html（map.json含waypoints经纬度+类型 与route顺序；自动铺区域主要城市参照层并画带箭头路线；--no-context关掉参照层；--sample出示例；--svg出纯 svg；无第三方依赖） - 缺 openpyxl 时：
pip install openpyxl（建议在受管 Python venv 中安装）。
版本记录
- V1.0（首发）：六步流程 + 11 列 Excel 交付（时间/安排/车程距离/开放时间&时长/亮点推荐/备注/tips/图片出片/带装备天气/费用/待办，费用内联自动合计）+ 亲历百宝书（field-notes.md）+ 离线 SVG 路线示意图（generate_route_map.py）；含人文种子库与古建/寺庙/石窟专项知识。列结构采用 11 列（保持本版式，未改回手搓 9 列）。新疆喀什/塔县/莎车/红其拉甫实测点待 2026 年 9 月底出行后回填【亲历】。
