前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许开发者将工具能力注入 Agent 上下文。旅行规划是高频需求，但普通对话模型容易编造车次票价、开闭馆时间等数据。TravelPlanner 是一个跑在 DSH 里的中文旅行规划 Agent，由 AusertDream 维护。它通过实时调用数据源和硬约束盘点，交付一份单文件 HTML 路书，解决“信息过时”与“方案不可落地”的问题。
核心能力¶
该插件主要提供以下功能：
- 实时数据查询：支持实时查询 12306、飞猪、途牛、高德的价格与路线，数据来源标注明确。
- 离线路书交付：最终输出一个单文件 HTML 路书，支持离线查看，包含图片内联、手机适配布局。
- 真实市内导航：基于高德真实路线，提供地铁换乘方案、票价与时长。
- 住宿筛选与房型：支持三档酒店价格筛选（必有低价档），并展示房型实拍图。
- 硬约束盘点：自动核对闭馆日、预约放票时间、末班车时间、天气等限制条件。
- 预算与图表：提供分项预算计算与环形图展示，每一项均可追溯来源。
- 环境自检：交付前检测必需的 API Key 是否配置，缺项会提示用户。
安装与配置¶
环境要求¶
运行前需准备 Node.js ≥ 22、Python 3、Git 及相关 CLI 工具。
安装步骤¶
在终端执行以下命令进行安装：
# 安装数据源 CLI 工具
npm install -g @fly-ai/flyai-cli @amap-lbs/amap-gui tuniu-cli
# 安装 Python 依赖
python -m pip install pillow
# 克隆仓库并运行安装脚本
git clone https://github.com/AusertDream/TravelPlanner.git
cd TravelPlanner
node scripts/install.mjs
安装脚本会自动处理工具脚本、技能文件及环境自检。
配置 Key¶
所有 Key 配置存储在 .env 文件中（路径通常为 ~/.dsh/preset-assets/travel-planner/.env）。
- 必需 Key：
AMAP_KEY/AMAP_SECURITY_KEY：高德 POI 与市内路线查询。FLYAI_API_KEY：飞猪机票、酒店、门票实时价。
- 可选 Key：
GOOGLE_MAPS_API_KEY：增强功能，用于路书内嵌 Google 地图（无 Key 时自动降级）。UNSPLASH_ACCESS_KEY：路书配图。TUNIU_API_KEY：途牛作为第二数据源。
配置完成后，可通过 node ~/.dsh/preset-assets/travel-planner/doctor.mjs 进行自检。
使用示例¶
在 DSH 中创建新会话，切换至“旅行规划助手”模式，按自然语言描述需求：
- “十一从杭州去西安 4 天，两个大人一个 6 岁小孩，预算一万，想看兵马俑。”
- “帮我看看这份行程有没有问题。”
- “第二天太赶了，换个轻松点的。”
Agent 会先确认必要信息（出发地、日期、人数、预算），再进行规划。它只做查询与规划，不进行代订、代付或提交证件信息。
适用场景与注意事项¶
该插件主要面向国内行程规划。其强项在于国内大交通（12306、飞猪、高德）与市内真实路线，境外市内路线能力较弱。Google Maps API Key 为可选，国内网络环境下高德瓦片通常更稳定。
注意：插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证（MIT）。Key 仅保存在本地 .env 文件中，不写入代码逻辑。
