前言¶
在 DeepSeek Harness(DSH)插件体系里,dsh-travel-plan 是一个面向旅行规划的插件。它把旅行攻略从“泛泛介绍”收敛成一套可执行的流程:输入目的地后,先从地图、OTA、票务等来源扫出候选,再从公开社交平台观察当地主题玩法,接着核验营业时间、场次和活动日期,最后按天排出路线。
这个插件由 cosmic-snail 维护,采用 MIT 许可证。它适合需要把目的地、日期、人数、预算、主题和交通方式落到具体 POI 与按天行程的场景。
这是什么¶
dsh-travel-plan 给 DeepSeek Harness 增加一套旅行攻略工作流:
- 提供
plan-travel-guideskill,输出完整 POI 总表和按天行程。 - 扫描地图、OTA、点评、票务和官网导览,挖掘当地词汇和体验类候选。
- 按平台搜索小红书、抖音、微博、B站和公开网页,也可以指定 Instagram、YouTube、Reddit。
- 核验地址、营业时间、开闭店、预约、票务、活动日期、场次和限制。
- 按区域聚类,填写上午到晚上的时段。
- 提供
travel_search_catalog、travel_search_social、travel_verify_poi、travel_plan_route四个工具。
核心功能¶
下面按使用流程介绍它提供的能力。
候选来源扫描¶
插件会扫地图、OTA、点评、票务和官网导览,用来发现当地候选点。这个步骤用于补出可订、可到店、可体验的地点,避免只依赖社交平台热度。
社交平台主题发现¶
插件会按平台搜索小红书、抖音、微博、B站和公开网页。如果指定了其他平台,也可以搜索 Instagram、YouTube、Reddit。
社交平台结果用于观察“这个主题在当地通常怎么玩”。这类信息只作为发现信号,不直接当作最终事实。
POI 核验¶
插件会核验以下信息:
- 地址
- 营业时间
- 开闭店
- 预约
- 票务
- 活动日期
- 场次
- 限制
这个步骤用于避免把社交帖里的过时信息、活动信息或体验描述直接写进最终行程。
按天排程¶
插件会按区域聚类,把候选点填进上午、中午、下午、晚餐、晚上等时段。这样生成的行程会优先在同一区域串联,而不是把一天拆成跨区折返。
输出形态¶
plan-travel-guide skill 的输出包含两部分:
1、完整 POI 总表。
2、按天行程。
安装与启用¶
插件要求 Node.js 版本为 ^22.19.0 || >=24.0.0,并要求安装 dsh CLI。
Git 安装已带预构建 lib/,不需要 allowBuilds。
安装命令如下:
dsh plugin --profile web add github:cosmic-snail/dsh-travel-plan
Web UI / headless 环境默认带网页搜索。如果没有可用的网页搜索提供方,plan-travel-guide skill 和 travel_plan_route 工具仍会加载,但 travel_search_catalog、travel_search_social、travel_verify_poi 这三个搜索类工具不会出现。
@deepseek-ai/dsh-web 是 optional peer dependency。
典型用法¶
使用 plan-travel-guide 时,必填项是目的地。日期强烈建议提供,尤其是多日行程、门票、演出、展期等场景。
人数、预算、主题、是否自驾等信息缺失时,会使用合理默认值,不会因此停下来追问。
示例一:
使用 /plan-travel-guide,帮我规划 2026-10-03 到 2026-10-05 的旅行攻略。
目的地:香港旺角
住宿:香港富荟旺角酒店
人数:5人
交通:不自驾
预算:中等
节奏:适中
主题:二次元、复古文艺探店
示例二:
使用 /plan-travel-guide,帮我规划 2026-10-03 一天,地点围绕上海南京路。
五个人,不自驾,中等预算,节奏适中,主题二次元。
配置¶
可以在 profile 的 cordis.patch.yml 中覆盖相关配置。注意 patch 会替换整段 config,如果修改配置,需要把用到的键写全。
示例如下:
- id: travel-planner
config:
searchMaxResults: 8
searchTimeoutMs: 30000
verifyTimeoutMs: 45000
fetchMaxChars: 8000
配置项如下:
1、searchMaxResults,默认 8。
2、searchTimeoutMs,默认 30000。
3、verifyTimeoutMs,默认 45000。
4、fetchMaxChars,默认 8000。
适用场景与注意¶
适合以下场景:
- 给定目的地和日期,生成可照着走的旅行攻略。
- 需要把主题玩法落到具体 POI、餐厅、演出、展览或体验点。
- 需要核验营业时间、预约、票务、活动日期和场次。
- 需要按区域串联一天路线,减少跨区折返。
注意事项:
- 插件以当前 dsh 进程权限运行。安装前应检查源码和许可证。
- 社交帖只作为发现信号。打不开的帖子不会假装读过,也不会编造链接。
- 没有可用网页搜索提供方时,搜索类工具不会出现,但 skill 和
travel_plan_route仍会加载。 - 在
cordis.patch.yml中覆盖配置时,patch 会替换整段config,改后需写全用到的键。
结尾¶
dsh-travel-plan 的价值,是把旅行规划拆成候选扫描、主题发现、POI 核验和按天排程四个可执行步骤。它适合希望把目的地攻略落到具体地点、具体时段和可核验信息的场景。
GitHub 仓库:https://github.com/cosmic-snail/dsh-travel-plan