interactive-travel-planner – Vue3+AI智能旅行路线规划器

项目简介

interactive-travel-planner 是一款基于 Vue 3 + TypeScript + Vite 构建的本地优先互动式旅行路线规划工具，深度集成 AI 能力，支持从文字攻略或截图智能识别生成行程。用户可手动规划或由 AI 辅助优化路线，支持高德地图路线规划、预算管理、天气查询和风险提醒。

核心功能

1. AI 智能导入行程：支持粘贴小红书、公众号或聊天攻略文字，也可以上传截图，AI 自动识别生成结构化行程草稿。
2. 多 AI 接入协议：支持 OpenAI Responses、OpenAI Chat Completions、Anthropic Messages 三大协议，灵活配置多个 AI 接入实例。
3. 高德地图深度集成：路线规划支持驾车、步行、骑行、公交等多种交通方式，实时获取距离、耗时、高速费。
4. AI 路线优化：智能分析并优化地点顺序，验证路线可行性，用户确认后一键应用。
5. 预算管理系统：全程费用台账，支持燃油车/新能源车自动计算油耗费用、高德高速费估算、人工费用记录与核价状态跟踪。
6. 天气与风险提醒：集成高德天气、Azure Maps Weather、和风天气、彩云天气，自动识别降雨、降雪、雷暴、高原风险并给出建议。
7. 计划完整性检查：出发前自动检查每日时间可行性、住宿覆盖、票务状态、必去地点预约情况。
8. 数据备份与恢复：完整计划导出/导入为 JSON（不含 API Key），自动保存最多10个历史版本。

技术实现

技术栈

项目采用现代前端技术栈：Vue 3 + TypeScript + Vite + Pinia 状态管理，UI 层基于 Element Plus 2.14.5 并通过 CSS Variables 自定义旅行主题，地图层使用高德地图 JavaScript API 2.0。AI 能力通过官方 openai-js-sdk 和 @anthropic-ai/sdk 实现，动态导入避免首屏同时加载两套 SDK。

AI 接入设计

项目设计了灵活的 AI Provider 适配层，预置 OpenAI、Anthropic、DeepSeek、阿里云百炼、OpenRouter 等模板，用户填入具体 API Key 后形成可用的 AI 接入实例。每个实例支持多模型配置、上下文窗口管理和请求超时控制。行程解析和路线优化使用独立的可编辑提示词，互不干扰。

地图与路线

高德地图适配器实现了 PlanMapProvider 接口，提供 estimateRoute()（供 AI 路线分析使用）和 searchRouteOptions()（面向用户路线选择）。交通路线支持全部候选方案展示（综合推荐、用时优先、距离优先等），用户确认后快照保存在每个 Stop 上，包括起终点、方式、距离、用时和压缩 Polyline。

预算引擎

预算不是单一金额，而是附着在全程、日期、地点和交通段上的费用台账。燃油车/新能源车按路线里程、百公里能耗和能源单价自动计算；高德驾车路线高速费可自动估算，也可手动覆盖避免重复计算。

天气与风险

天气 Provider 通过注册表模式管理，支持高德、Azure Maps Weather、和风天气、彩云天气四家。风险引擎在天气数据之上独立聚合，自动识别降雨、降雪、雷暴、大风、高温和高原风险，不依赖地图 POI 或 AI 猜测。

快速上手

1. 克隆仓库：git clone https://github.com/pedoc/interactive-travel-planner
2. 安装依赖：pnpm install --frozen-lockfile
3. 启动开发服务：pnpm dev，访问 http://127.0.0.1:8765/
4. 配置地图Key：首次打开后按提示填写高德地图 JS API Key 和 securityJsCode
5. 开始规划：新建计划，手动添加地点或使用「AI 导入」从文字/图片生成行程

桌面版（Windows/macOS/Linux）可通过 GitHub Actions 自动构建的安装包使用：发布新版本时推送形如 v0.1.0 的 Git 标签即可触发构建。

适用人群

• 喜欢深度规划自由行、自驾游的旅行爱好者
• 需要管理多人、多天复杂行程的用户
• 希望用 AI 辅助从攻略中提取行程的旅行者
• 对路线优化、预算控制有精细化需求的独立规划者