dsh-trip-planner-cn

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

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/](examples/README.md)。

核心特性

• 逐小时每日计划：营业时间、闭馆日、预约政策全部用工具核实后写入，每一跳都有高德/百度地图链接。
• 跨城交通深链：机票/火车票日期网格翻译成携程 / 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](.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](references/data-sources.md)。

数据源 · 用途

高德 / 百度开放平台 · 坐标解析、实时时距、周边 POI、静态路线图

12306 / 携程 / 去哪儿 / Trip.com · 机票与火车票深链

timor.tech + 国务院放假安排 · 法定节假日与调休

Open-Meteo / 中央气象台 · 天气预报与气象预警

本地 NOAA 天文模型 · 日出日落（零网络）

致谢

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

许可证

[MIT](LICENSE)