dsh-travel-planner

dsh plugin --profile web add dsh-travel-planner

<p align="right">

<strong>简体中文</strong> · <a href="./README.en.md">English</a>

</p>

<p align="center">

<img src="docs/images/banner.svg" width="100%" alt="TravelPlanner 旅行规划师：一句话需求，交付一份能离线打开的旅行路书">

</p>

<p align="center">

<a href="https://github.com/deepseek-ai/deepseek-harness"><img src="https://img.shields.io/badge/DeepSeek%20Harness-Agent%20Preset-a33a2c?style=flat-square" alt="DeepSeek Harness Agent Preset"></a>

<a href="./package.json"><img src="https://img.shields.io/badge/DSH-%E2%89%A5%200.2.0--rc.2-5B4CF0?style=flat-square" alt="DSH ≥ 0.2.0-rc.2"></a>

<img src="https://img.shields.io/badge/Node.js-%E2%89%A5%2022-339933?style=flat-square&logo=nodedotjs&logoColor=white" alt="Node.js ≥ 22">

<a href="https://github.com/AusertDream/TravelPlanner/actions/workflows/check.yml"><img src="https://github.com/AusertDream/TravelPlanner/actions/workflows/check.yml/badge.svg" alt="check"></a>

<a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-0B7285?style=flat-square" alt="MIT"></a>

<a href="https://github.com/AusertDream/TravelPlanner/stargazers"><img src="https://img.shields.io/github/stars/AusertDream/TravelPlanner?style=flat-square&color=f39c12" alt="GitHub stars"></a>

</p>

<p align="center">

<a href="#-快速开始">快速开始</a> ·

<a href="#️-效果预览">效果预览</a> ·

<a href="#-需要哪些-key">需要哪些 Key</a> ·

<a href="#-技能也能单独用">技能单独用</a> ·

<a href="docs/INSTALL.md">安装指南</a> ·

<a href="#-常见问题">常见问题</a>

</p>

一句话需求，交付一份能用的路书

旅行规划师是 DeepSeek Harness（DSH） 里的一个中文旅行规划 agent。

你说「国庆从上海去成都玩 3 天，2 个人，预算 6000」。它会当场查 12306 余票、飞猪 / 途牛的机票和酒店价、高德的真实路线，核实闭馆日、预约放票和天气，最后交给你一个能离线打开的 HTML 文件：逐日时间轴、可拖动地图、三档酒店、分项预算、每一站的导航链接都在里面，转发给同行的人直接就能看。

[!IMPORTANT]

它只做规划和查询，绝不代订、代付。所有价格都是查询时的参考价，预订由你自己在官方渠道完成。

<p align="center">

<img src="docs/images/map.jpg" width="88%" alt="路书里的地图：高德底图、真实地铁路线、编号站点与每站导航链接">

</p>

🆚 和「问一句 AI 给个攻略」有什么不同

· 普通对话 · 旅行规划师

车次、票价、房价 · 凭记忆，常常过时或编造 · 当场查 12306 / 飞猪 / 途牛，标注来源和查询日期

市内怎么走 · 「坐地铁大概 30 分钟」 · 高德真实路线：几号线换几号线、几分钟、票价几块

闭馆、预约、末班车 · 经常漏 · 先盘硬约束（闭馆日、放票时间、实名限量、末班缆车），再排行程

住哪 · 一个笼统的区域 · 按动线重心选址，三档价格（必有 < ¥200 和 < ¥400 的整间房），附房型实拍

交付 · 一大段聊天文字 · 一个 HTML 文件：图片内联、手机也能看、离线可用

出错了怎么办 · 你自己发现 · 交付前自动跑门禁：静态检查、桌面 + 手机两种宽度的布局检查、首屏截图自检

🖼️ 效果预览

<table>

<tr>

<td width="50%" align="center"><img src="docs/images/hero.png" alt="路书首屏"><br>_{<b>首屏</b>：这趟为什么这么排，一段话讲清取舍}</td>

<td width="50%" align="center"><img src="docs/images/day.jpg" alt="逐日时间轴"><br>_{<b>逐日时间轴</b>：几点到哪、怎么去、花多少，附 Plan B}</td>

</tr>

<tr>

<td width="50%" align="center"><img src="docs/images/budget.jpg" alt="分项预算"><br>_{<b>花多少钱</b>：分项预算 + 环形图，每一项可追溯}</td>

<td width="50%" align="center"><img src="docs/images/weather.jpg" alt="天气"><br>_{<b>天气</b>：出行那几天的预报与穿衣、改期建议}</td>

</tr>

</table>

完整示例：[examples/成都3天2晚路书.html](examples/成都3天2晚路书.html)（下载后用浏览器打开）。

🧭 它是怎么规划的

flowchart LR
  A["一句话需求"] --> B["需求访谈<br/>只问必要的 5 件事"]
  B --> C["硬约束盘点<br/>闭馆 · 放票 · 末班车 · 天气"]
  C --> D["大交通<br/>12306 · 飞猪 · 途牛"]
  D --> E["住宿<br/>选址 + 三档价格"]
  E --> F["逐日编排<br/>高德真实路线"]
  F --> G["写路书网页<br/>地图 · 预算 · 天气"]
  G --> H{"交付门禁"}
  H -- 通过 --> I["单文件 HTML"]
  H -- 不通过 --> G

每一步对应一个技能模块，按需加载，不会一次把所有规则塞进上下文。开工前它还会先跑一遍环境自检：缺了必需的 Key 会停下来告诉你去哪申请、填到哪；只是没配可选的 Google Maps Key，就不打断你。

🚀 快速开始

前提：Node.js ≥ 22、Python 3、Git、Chrome 或 Edge。数据源 CLI（飞猪 / 高德 / 途牛）可以先不装，agent 第一次开工时会告诉你缺什么，你同意的话它能帮你装。

方式一：DSH 桌面版「添加插件」（推荐）

1. 侧栏 插件 → 添加插件，粘贴仓库地址，点「安装」：

   https://github.com/AusertDream/TravelPlanner

2. 完全退出 DSH 再打开（托盘图标右键退出；只关窗口不算）。第一次启动时，插件会自动把工具脚本和技能装到 ~/.dsh 下。

3. 新建会话，模式选「旅行规划师」，说一句需求。

桌面版的插件目前不能自动更新：升级时先在插件管理里卸载，再按上面的步骤装新版。

方式二：插件市场

收录进 awesome-dsh-plugin 精选列表后，就能在 dsh-market 插件市场（设置 → 插件市场）里搜「TravelPlanner」一键安装，装完同样要完全退出并重开 DSH。

方式三：克隆仓库 + 安装脚本（一次装齐）

npm install -g @fly-ai/flyai-cli @amap-lbs/amap-gui tuniu-cli   # 飞猪 / 高德 / 途牛 CLI
python -m pip install pillow

git clone https://github.com/AusertDream/TravelPlanner.git
cd TravelPlanner
node scripts/install.mjs

脚本会装好工具脚本、技能和 12306 MCP，把仓库注册成 DSH 的 bundle，最后跑一遍环境自检。选项、升级、卸载、排障见 [docs/INSTALL.md](docs/INSTALL.md)。

🔑 需要哪些 Key

都在一个文件里：~/.dsh/preset-assets/travel-planner/.env（首次安装时自动生成）。申请都免费，图文步骤见 [docs/KEYS.md](docs/KEYS.md)。

Key · · 管什么 · 没有会怎样

AMAP_KEY + AMAP_SECURITY_KEY · 必需 · 高德 POI、市内路线、地图上的真实路线 · 查不了景点坐标和市内交通

FLYAI_API_KEY · 必需 · 飞猪机票、酒店、门票实时价 · 进「体验模式」，酒店价格被遮蔽

GOOGLE_MAPS_API_KEY · 可选增强 · 路书里直接加载可拖动的 Google 地图 · 自动降级到无 Key 嵌入 / 高德瓦片地图 / 静态图

UNSPLASH_ACCESS_KEY · 可选 · 路书配图 · 改用 Wikimedia（免 Key）

TUNIU_API_KEY · 可选 · 途牛（第二数据源） · 一般走 tuniu auth login 网页授权，不用填

填完保存即生效，不用重启 DSH。随时可以手动自检：

node ~/.dsh/preset-assets/travel-planner/doctor.mjs

🧩 技能也能单独用

规划方法论、交通、住宿、地图、路书都写成了独立的技能（标准 SKILL.md 格式），可以单独装给 DSH 里的其他 agent，或 Claude Code 等支持技能的 agent：

node scripts/install.mjs --skills-only                                # DSH 所有 agent（~/.dsh/skills）
node scripts/install.mjs --skills-only --skills-dir ~/.agents/skills  # 多种 agent 共用的目录
node scripts/install.mjs --skills-only --skills-dir ~/.claude/skills  # Claude Code

技能 · 内容

travel-planning · 总控：规划信条、需求访谈、行程骨架、逐日编排、自检；告诉 agent 每一步加载哪个模块

travel-constraints · 硬约束：闭馆日、预约放票、实名限量、时段票、末班车、天气窗口、高原

travel-transport · 大交通取舍（按门到门时间比较飞机和高铁）、市内每段怎么走

travel-hotels · 选址、三档价格梯度、途牛低配额下怎么挑、房型实拍图

travel-maps · 地图组件 map-widget.py、高德真实路线、出图尺寸

travel-roadbook · 路书网页骨架、来源标注、天气与预算图表、交付门禁

train-booking · flyai-cli · amap-cli-skill · 12306 / 飞猪 / 高德 的用法与实测踩过的坑

💬 怎么用

在「旅行规划师」模式里正常说话就行：

• 「十一从杭州去西安 4 天，两个大人一个 6 岁小孩，预算一万，想看兵马俑」
• 「帮我看看这份行程有没有问题」+ 贴上行程文字或截图
• 「第二天太赶了，换个轻松点的」——它会改网页，并告诉你改了哪里

它只问必要的几件事：从哪出发（绝不默认

…(truncated)