zexuanw958-svg/travel-plan-viz

解決的問題

travel-plan-viz 將旅行行程轉換為精緻、以行動裝置為優先的單一檔案 HTML 頁面。它解決了資訊碎片化問題，將研究、排程與導航整合為一個可離線閱讀的文件，同時自動化預訂提醒與地圖座標修正等繁瑣的規劃工作。

如何運作

本專案採用混合架構，結合 AI 代理指令與硬編碼的 JavaScript 引擎，以確保可靠性：

• 代理工作流程：AI（例如 Claude Code 或 Codex）研究目的地，建立行程，並根據內容合約生成 HTML 頁面。
• 核心引擎：三個原生 JS 引擎負責技術性重載：map.js 負責互動式 Leaflet 地圖與座標轉換（GCJ-02 到 WGS-84），reminders.js 負責計算預訂截止日期，validate.js 負責生成後的機械性檢查，確保無欄位或座標遺漏。
• 資料持久化：完整行程以 JSON 格式嵌入 HTML 檔案中，允許 AI 在不遺失現有資料的情況下更新計畫（例如將某站點從第 3 天移至第 4 天）。
• 可擴展性：可選擇與官方旅行技能（如 Fliggy 或 Amap）整合以取得即時資料，但僅透過網路研究即可完全運作。

適用對象

希望獲得結構化、視覺美觀且可在行動裝置上離線存取的便攜式旅行指南的旅行者，以及希望擴展 Claude Code 或 Codex 等 AI 代理能力的使用者，透過可重複使用的技能來增強功能。

主要亮點

• 互動式地圖：無需 API 金鑰的地圖，支援編號站點、虛線路線，以及 iOS 與 Android 的一鍵導航連結。
• 預訂提醒：根據出發日期自動倒推計算票務與飯店的預訂截止時間。
• 離線優先：生成單一響應式 HTML 檔案，即使無網路連接，文字內容仍可閱讀。
• 機械驗證：使用專用腳本檢測常見 AI 錯誤，如緯度/經度顛倒或缺失必填區塊。
• 迭代編輯：支援將 HTML 重新輸入 AI，AI 修改內嵌的 JSON 資料以更新行程。