62 lines
1.9 KiB
Markdown
62 lines
1.9 KiB
Markdown
# Travel Planner
|
|
|
|
一个面向个人、团队或家庭的智能旅游规划工具。
|
|
|
|
## 功能特性
|
|
|
|
- 🗺️ **地图可视化**：使用 Leaflet + OpenStreetMap，无需 API Key
|
|
- 🤖 **AI 智能规划**：根据目的地、天数、偏好自动生成行程建议
|
|
- 📍 **景点标注**：登录后可将景点标记为「去过」或「想去」
|
|
- 👨👩👧 **多用户支持**：每个账号独立保存自己的旅行记录
|
|
- 💾 **本地存储**：数据保存在浏览器 localStorage，无需后端
|
|
|
|
## 快速开始
|
|
|
|
### 方式一：直接用浏览器打开
|
|
|
|
直接用现代浏览器打开 `index.html` 即可。
|
|
|
|
### 方式二：使用 Python Flask 启动（推荐）
|
|
|
|
```bash
|
|
pip install flask
|
|
python app.py
|
|
```
|
|
|
|
然后访问 http://127.0.0.1:5000
|
|
|
|
## 使用说明
|
|
|
|
1. 注册一个账号（本地模拟，数据存在浏览器中）
|
|
2. 在左侧面板输入目的地、天数、偏好，点击「AI 生成行程」
|
|
3. 在地图上点击任意位置，可以添加自定义景点标注
|
|
4. 点击景点标记，可切换「想去 / 去过」状态
|
|
5. 切换「显示模式」可以只看去过的或想去的景点
|
|
|
|
## 目录结构
|
|
|
|
```
|
|
travel-planner/
|
|
├── app.py # Flask 启动入口（可选）
|
|
├── index.html # 主页面
|
|
├── css/
|
|
│ └── style.css # 样式
|
|
├── js/
|
|
│ ├── auth.js # 登录/注册逻辑
|
|
│ ├── map.js # 地图与标注
|
|
│ ├── ai.js # AI 行程生成
|
|
│ └── main.js # 主入口
|
|
└── README.md
|
|
```
|
|
|
|
## 技术栈
|
|
|
|
- 原生 HTML / CSS / JavaScript
|
|
- [Leaflet](https://leafletjs.com/) 地图库
|
|
- OpenStreetMap 瓦片
|
|
- Flask（可选静态服务）
|
|
|
|
## 说明
|
|
|
|
AI 规划为本地规则引擎模拟（无需联网调用大模型）。如需接入真实大模型 API，可在 `js/ai.js` 的 `generatePlan` 中替换为 fetch 调用。
|