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 数据以更新行程。