TravelPlanner

What it is

TravelPlanner (旅行规划助手, "trip-planning assistant") is a Chinese-language trip-planning agent preset for DeepSeek Harness (DSH), built for trips within mainland China.

Tell it "3 days in Chengdu from Shanghai over the National Day holiday, 2 people, ¥6,000". It queries live data — 12306 train availability, flight and hotel prices from Fliggy and Tuniu, real transit routes from Amap — checks closing days, ticket-release windows and the weather, then hands you a single HTML file that works offline: a day-by-day timeline, draggable maps with real routes, three hotel price tiers, an itemized budget and navigation links for every stop.

[!IMPORTANT] It plans and looks things up. It never books or pays for anything. Every price is a reference price at query time.

🎬 Video

Why not just ask a chatbot

Gallery

Full example: 👉 open the Chengdu 3-day itinerary online (works on phones; the online copy uses static maps). The source file is examples/成都3天2晚路书.html; download it to view offline.

Quick start

Prerequisites: Node.js ≥ 22, Python 3, Git, Chrome or Edge. The data-source CLIs (Fliggy, Amap, Tuniu) can wait: on its first run the agent tells you what is missing and can install it for you if you agree.

Option 1: DSH desktop "Add plugin" (recommended)

1. Sidebar Plugins → Add plugin, paste the repository URL and click Install:

   https://github.com/AusertDream/TravelPlanner
   

2. Quit DSH completely and reopen it (right-click the tray icon → Quit; closing the window is not enough). On first start the plugin copies its tool scripts and skills into ~/.dsh.

3. Start a new session, pick the 旅行规划助手 mode and describe your trip.

Option 2: the plugin market

It has been submitted to and is under review (). Once it is listed, you can search for "TravelPlanner" in the dsh-market plugin market (Settings → Plugin Market) and install it in one click. Restart DSH afterwards. Until then, Option 1 installs exactly the same thing.

Option 3: clone and run the installer

npm install -g @fly-ai/flyai-cli @amap-lbs/amap-gui tuniu-cli
python -m pip install pillow

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

The installer sets up the tool scripts, the skills and the 12306 MCP server, registers the repository as a DSH bundle, and finishes with an environment check. Options, upgrades, uninstalling and troubleshooting: docs/INSTALL.md (Chinese).

API keys

All keys live in one file, ~/.dsh/preset-assets/travel-planner/.env, created on first install. Every key is free to apply for; step-by-step guide in docs/KEYS.md (Chinese).

Changes take effect as soon as you save; no restart needed. Check anytime with:

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

The skills work on their own

The planning method, transport, hotels, maps and roadbook rules are standalone skills in the standard SKILL.md format. Install them for other DSH agents, or for Claude Code and other agents that read skills:

node scripts/install.mjs --skills-only                                # all DSH agents (~/.dsh/skills)
node scripts/install.mjs --skills-only --skills-dir ~/.agents/skills  # shared agents directory
node scripts/install.mjs --skills-only --skills-dir ~/.claude/skills  # Claude Code

Ground rules

• No booking or payment, no submitting ID details, no confirming prices on your behalf.
• No made-up data: times, prices and opening hours come from live queries and cite their source.
• No scraping Xiaohongshu: paste the note text or a screenshot instead.
• Keys live only in .env. The one exception is the Google Maps key, which is embedded in the roadbook HTML because the browser needs it; restrict it as described in docs/KEYS.md.

Compatibility

DeepSeek, dressed for the trip

The guide in the video is DeepSeek in travel gear: a straw hat, a camera, a little whale crossbody bag, and the tail comes along too. It is fan art of the whale that Chinese users affectionately call 「大肥鱼」 ("big fat fish"). The three-view lives in photos/ and the promo video's build scripts and art in video-src/.

License

MIT © Tianyi Jiang. Third-party components and services: NOTICE.md.