前言¶

在 DeepSeek Harness（DSH）插件體系裏，dsh-travel-plan 是一個面向旅行規劃的插件。它把旅行攻略從“泛泛介紹”收斂成一套可執行的流程：輸入目的地後，先從地圖、OTA、票務等來源掃出候選，再從公開社交平臺觀察當地主題玩法，接着覈驗營業時間、場次和活動日期，最後按天排出路線。

這個插件由 cosmic-snail 維護，採用 MIT 許可證。它適合需要把目的地、日期、人數、預算、主題和交通方式落到具體 POI 與按天行程的場景。

這是什麼¶

dsh-travel-plan 給 DeepSeek Harness 增加一套旅行攻略工作流：

• 提供 plan-travel-guide skill，輸出完整 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