前言¶
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 文件中，不寫入代碼邏輯。
