Introduction

In the DeepSeek Harness (DSH) plugin ecosystem, dsh-travel-plan is a plugin oriented towards travel planning. It consolidates travel guides from “general introductions” into an executable process: after inputting a destination, it first scans candidate points from maps, OTAs, ticketing, and other sources, then observes local thematic activities from public social platforms, verifies business hours, sessions, and event dates, and finally arranges a route day by day.

This plugin is maintained by cosmic-snail and is licensed under the MIT license. It is suitable for scenarios that require mapping destination, date, number of people, budget, theme, and transportation mode to specific POIs and daily itineraries.

What is this

dsh-travel-plan adds a travel guide workflow to DeepSeek Harness:

  • Provides the plan-travel-guide skill, outputting a complete POI summary and daily itinerary.
  • Scans maps, OTAs, reviews, ticketing, and official guides to mine local keywords and experience candidates.
  • Searches Xiaohongshu, Douyin, Weibo, Bilibili, and public web by platform; Instagram, YouTube, and Reddit can also be specified if required.
  • Verifies address, business hours, opening/closing, booking, tickets, event dates, sessions, and restrictions.
  • Clusters by region and fills time slots such as morning, noon, afternoon, dinner, and evening.
  • Provides four tools: travel_search_catalog, travel_search_social, travel_verify_poi, and travel_plan_route.

Core Features

The capabilities it provides are introduced below according to the usage flow.

Candidate Source Scanning

The plugin scans maps, OTAs, reviews, ticketing, and official guides to discover local candidate points. This step is used to supplement locations that are bookable, visitable, and experiential, avoiding reliance solely on social platform popularity.

Social Platform Theme Discovery

The plugin searches Xiaohongshu, Douyin, Weibo, Bilibili, and public web by platform. If other platforms are specified, Instagram, YouTube, and Reddit can also be searched.

Social platform results are used to observe “how this theme is usually played locally”. This information is used only as a discovery signal and is not directly treated as a final fact.

POI Verification

The plugin verifies the following information:

  • Address
  • Business Hours
  • Opening/Closing
  • Booking
  • Tickets
  • Event Dates
  • Sessions
  • Restrictions

This step is used to avoid writing outdated information, event details, or experience descriptions directly from social posts into the final itinerary.

Daily Scheduling

The plugin clusters candidates by region and fills them into time slots such as morning, noon, afternoon, dinner, and evening. The generated itinerary prioritizes connecting points within the same region rather than splitting a day across multiple regions.

Output Format

The output of the plan-travel-guide skill contains two parts:

  1. Complete POI summary table.
  2. Daily itinerary.

Installation and Usage

The plugin requires Node.js version ^22.19.0 || >=24.0.0 and requires the dsh CLI to be installed.

Git installation comes with pre-built lib/, so allowBuilds is not required.

The installation command is as follows:

dsh plugin --profile web add github:cosmic-snail/dsh-travel-plan

The Web UI / headless environment comes with web search by default. If no web search provider is available, the plan-travel-guide skill and travel_plan_route tool will still load, but the three search-related tools travel_search_catalog, travel_search_social, and travel_verify_poi will not appear.

@deepseek-ai/dsh-web is an optional peer dependency.

Typical Usage

When using plan-travel-guide, the destination is a required field. Providing dates is strongly recommended, especially for multi-day trips, tickets, shows, exhibitions, etc.

When details such as number of people, budget, theme, or self-driving are missing, reasonable defaults will be used, and the process will not stop to ask for them.

Example 1:

Use /plan-travel-guide to help me plan a travel guide from 2026-10-03 to 2026-10-05.
Destination: Mong Kok, Hong Kong
Accommodation: Hong Kong Fortune Metropole Mong Kok Hotel
Number of People: 5
Transportation: No self-driving
Budget: Medium
Pace: Moderate
Theme: Anime, Retro, and Literary Exploration

Example 2:

Use /plan-travel-guide to help me plan a one-day trip on 2026-10-03, with the location centered around Nanjing Road, Shanghai.
Five people, no self-driving, medium budget, moderate pace, theme: Anime.

Configuration

You can override related configurations in the profile’s cordis.patch.yml. Note that the patch replaces the entire config block; if you modify the configuration, you need to write out all the keys used.

Example:

- id: travel-planner
  config:
    searchMaxResults: 8
    searchTimeoutMs: 30000
    verifyTimeoutMs: 45000
    fetchMaxChars: 8000

Configuration items are as follows:

  1. searchMaxResults, default 8.
  2. searchTimeoutMs, default 30000.
  3. verifyTimeoutMs, default 45000.
  4. fetchMaxChars, default 8000.

Scenarios and Notes

Suitable for the following scenarios:

  • Given a destination and date, generate a travel guide that can be followed.
  • Need to map thematic activities to specific POIs, restaurants, shows, exhibitions, or experience points.
  • Need to verify business hours, bookings, tickets, event dates, and sessions.
  • Need to connect a daily route by region, reducing cross-region back-and-forth.

Notes:

  • The plugin runs with the permissions of the current dsh process. Source code and license should be checked before installing.
  • Social posts are used only as discovery signals. It will not pretend to have read unopenable posts, nor will it fabricate links.
  • When no web search provider is available, search-related tools will not appear, but the skill and travel_plan_route will still load.
  • When overriding configuration in cordis.patch.yml, the patch replaces the entire config block; after modification, all used keys must be written out.

Conclusion

The value of dsh-travel-plan is breaking down travel planning into four executable steps: candidate scanning, theme discovery, POI verification, and daily scheduling. It is suitable for scenarios where users want to map destination guides to specific locations, specific time slots, and verifiable information.

GitHub Repository: https://github.com/cosmic-snail/dsh-travel-plan