境内旅行规划 ChenYiming-aaa/better-trip-planner

Trip Planner Skill（境内优化版）

一句旅行需求，变成逐小时、信息核实过、可以直接照着订的行程，交付为双击即开的精美 HTML 页面。

一个 Agent Skill，面向中国大陆境内旅行深度适配：装进 Claude Code、Codex、Gemini CLI、Cursor、WorkBuddy、CodeBuddy、DeepSeek Harness 等编码智能体后，直接用自然语言提需求即可。

它能帮你做的事：

- 🗺️ 长假多日游：得到一份逐小时、能直接照着订的完整行程
- 🌆 周末一日游：排出一套不赶路的玩法
- ⏱️ 2 小时空档：在陌生城市给出步行可达的去处
- 🌧️ 临场重排：赶不上车、下暴雨，几分钟重排当天

所有营业时间、价格、预约政策都用工具核实而不靠猜，每一项预订都递给你链接；不代订、不付款、不填个人信息。

成品页封面

安装

方式一：npm 安装（DeepSeek Harness）

先装好 DSH 与 pnpm，然后：

dsh plugin --profile web add dsh-trip-planner-cn

装完重启 DSH，技能目录里会出现 trip-planner-cn。卸载：

dsh plugin --profile web remove dsh-trip-planner-cn

不想走 npm 也可以直接从 GitHub 仓库装：

dsh plugin --profile web add github:ChenYiming-aaa/better-trip-planner

方式二：其他宿主（Claude Code / WorkBuddy / CodeBuddy 等）

下载本仓库，放到宿主的 skills 目录并命名为 trip-planner-cn：

| 宿主 | 位置 |
| Claude Code | ~/.claude/skills/trip-planner-cn |
| WorkBuddy | ~/.workbuddy/skills/trip-planner-cn |
| CodeBuddy | ~/.codebuddy/skills/trip-planner-cn |

运行环境只需 Python 3.9+ 标准库；可选安装 Pillow 用于素材流水线（pip install pillow）。

三十秒验证

不需要任何密钥，在 skill 目录执行：

python themes/render_clay2.py examples/china-2026/china.geo.json -o china-clay.html
python themes/qc.py china-clay.html # 退出码 0 即通过

未配置 AMAP_KEY 时渲染会提示静态地图隐藏的 WARN，属预期降级，退出码仍为 0。

使用

装好后，在智能体里用自然语言提需求即可，旅行类请求会自动触发本 skill：

云南 8 天，10 月出发，中等预算，自然风光和古城，日期前后可挪 2 天

使用提示：如果已经订好了机票、车票或酒店（航班号/车次、酒店名与入住日期），尽量一并提供——智能体会把这些预订直接编进行程、围绕它们反推每天的动线，得到的计划比"从零推荐"更贴合你的实际安排。

智能体会按问法自动选择四种工作模式：

| 模式 | 触发示例 | 执行内容 |
| 整趟旅行 | 帮我规划云南 8 天 | 意图收集 → 行前简报 → 路线骨架 → 城际交通 → 每日计划与酒店 → 自检交付 |
| 单日规划 | 我们在杭州有一天 | 节假日检查 + 单日计划 + 自检 |
| 空档填充 | 我在 X 附近有 2 小时空 | 15 分钟半径内 2–3 个选项 |
| 临场重排 | 高铁没赶上 / 下暴雨了 | 只重建受影响的那一天 |

渲染成品页

计划定稿后，渲染成设计版页面（默认插画版）：

python themes/render_theme2.py plan.geo.json --art plan.art.json -o trip-illustrated.html
python themes/qc.py trip-illustrated.html

七种主题任选，同一份行程可以每种都渲染一遍再挑：

| 主题 | 风格 |
| theme2 | 插画（水彩风，默认） |
| clay2 | 黏土 |
| noir2 | 夜航（黑白） |
| glass2 | 玻璃 |
| journal | 手账 |
| zine | 杂志 |
| splash | 闪屏 |

成品页完全自包含：双击即开、离线可看，每一天可展开高德路线地图，不泄漏任何密钥。

高德路线地图

更多主题与行程气质的搭配示例（重庆 · 山城霓虹、上海 · 梧桐区漫步、沪京西 8 天多城），见 examples/。

核心特性

- 逐小时每日计划：营业时间、闭馆日、预约政策全部用工具核实后写入，每一跳都有高德/百度地图链接。
- 跨城交通深链：机票/火车票日期网格翻译成携程 / Trip.com / 去哪儿 / 12306 的直达链接，价格点开链接核对，不编造。
- 住宿与预算：按片区给出酒店候选（带日期深链）、人民币预算汇总、按截止日排序的预订清单。
- 行前简报：应急号码、气象预警、假日调休、支付分层、离线地图准备，全部境内数据源。
- 图片三级策略：内置素材库优先 → 模型原生生图 → 境内生图 key（阿里云百炼 / 硅基流动），任何一档下页面都完整交付。

配置（可选）

所有密钥均为可选；不配置任何密钥也能完成规划与渲染，只是相应能力降级。
| 环境变量 | 作用 | 缺失时的行为 |
| AMAP_KEY | 高德 Web 服务 key | 静态地图隐藏，时距用估算值 |
| BAIDU_MAP_AK | 百度地理编码回退 | 跳过回退 |
| DASHSCOPE_API_KEY / SILICONFLOW_API_KEY | 境内生图 | 图片走素材库或原生能力 |
| TRIP_MAP_PROVIDER | 深链服务商，amap（默认）或 baidu | 用默认高德 |

申请高德 key：在高德开放平台（lbs.amap.com）注册并实名认证后创建应用，key 类型选「Web 服务」，个人开发者免费额度充足。拿到 key 后，在 skill 根目录建一个 .env 文件（参照 .env.example）写入 AMAP_KEY=你的key 即可，脚本会自动读取。

命令行工具

scripts/route_tools.py 统一处理计划文件（python scripts/route_tools.py <子命令> <plan.json> [参数]）：

| 子命令 | 功能 |
| geocode | 高德/百度解析 stop 坐标并写回 |
| check --live | 用高德实时时距替换估算值 |
| links --write | 为每一跳生成高德/百度导航深链 |
| kml | 导出 Organic Maps 可用的离线 KML |
| sun | 每日日出日落（本地天文模型，零网络） |
| ics | 从预订清单生成带提醒的日历文件 |
| poi | 高德周边 POI 搜索 |

python scripts/flight_scan.py --from 杭州 --to 青岛 --depart 2026-10-26 --nights 4 # 机票/火车票深链网格
python scripts/plan_lint.py plan.geo.json --strict # 渲染前内容门禁

数据来源

境内直连、免密钥优先；页面中的深链是价格与票务的真源。明细与回落链见 references/data-sources.md。

| 数据源 | 用途 |
| 高德 / 百度开放平台 | 坐标解析、实时时距、周边 POI、静态路线图 |
| 12306 / 携程 / 去哪儿 / Trip.com | 机票与火车票深链 |
| timor.tech + 国务院放假安排 | 法定节假日与调休 |
| Open-Meteo / 中央气象台 | 天气预报与气象预警 |
| 本地 NOAA 天文模型 | 日出日落（零网络） |

致谢

- Caveat（SIL OFL 1.1）与 Lucide（ISC），许可证全文见 THIRD-PARTY-NOTICES.md
- 高德开放平台、百度地图开放平台、Open-Meteo、timor.tech
- 图片生成：阿里云百炼通义万相、硅基流动 Kolors

许可证

MIT