Skip to content
lau0708Public

About

TripMind 是一个基于大模型(LLM)协同地图 POI 的智能旅行路书生成平台。通过“AI 逻辑规划 + 地图数据校验 + 移动端落地”的模式,帮用户生成一条真正可用、地名准确、路线顺畅的自由行行程。

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

TripMind AI 智能行程规划

大模型协同高德 POI,一键生成精准旅行路书

TripMind 是一个 AI 驱动的旅游行程规划应用。用户输入目的地和天数,系统通过大语言模型生成结构化行程,再调用高德地图 API 校验每个景点的真实坐标,最终在地图上可视化展示完整路线。

架构设计

用户输入(目的地 + 天数)
        │
        ▼
┌──────────────────────────┐
│  Node.js BFF (Express)   │
│                          │
│  ① 通义千问 → JSON 行程   │
│  ② 高德 REST → POI 坐标  │
│  ③ SSE 流式返回进度       │
└──────────┬───────────────┘
           │
     ┌─────┴─────┐
     ▼           ▼
 Web (Vue3)   小程序 (uni-app)
 SSE 进度流    JSON 请求
 高德 JS API   原生 map 组件

技术栈

层级 技术
BFF 后端 Node.js + Express + dotenv
大模型 阿里云通义千问 qwen-plus(JSON Mode 结构化输出)
地图服务 高德地图 JS API 2.0 + REST API
Web 前端 Vue 3 + Vite + SSE 流式解析
小程序端 uni-app + Vue 3(支持微信/支付宝/百度等)

项目结构

tripmind-demo/
├── server.js                # BFF 后端(SSE 流式 + JSON 双模式)
├── .env                     # 环境变量(不提交 Git)
├── .env.example             # 环境变量模板
├── package.json
│
├── tripmind-web/            # Web 前端
│   ├── src/
│   │   ├── App.vue          # 主页面(SSE 进度 + 地图联动)
│   │   ├── main.js          # 入口(环境变量配置安全密钥)
│   │   └── style.css
│   ├── .env                 # 前端环境变量
│   ├── .env.example
│   └── package.json
│
├── tripmind-miniapp/        # 小程序端
│   ├── pages/index/index.vue # 首页(Timeline + 地图双向联动)
│   ├── manifest.json
│   └── pages.json
│
└── scripts/
    └── test-itinerary.js    # 命令行测试脚本

快速启动

1. 配置环境变量

# 复制模板并填入你的 Key
cp .env.example .env
# 编辑 .env,填入 GAODE_REST_KEY 和 ALIYUN_KEY

cd tripmind-web
cp .env.example .env
# 编辑 .env,填入 VITE_AMAP_JS_KEY 和 VITE_AMAP_SECURITY_CODE

2. 启动 BFF 后端

# 安装依赖
npm install

# 启动服务(默认端口 3000)
node server.js

3. 启动 Web 前端

cd tripmind-web
npm install
npm run dev

4. 小程序端

使用 HBuilderX 打开 tripmind-miniapp 目录,运行到微信开发者工具。

核心特性

  • AI 行程生成 — 通义千问 JSON Mode 强制结构化输出,包含每日主题、时段、景点和推荐理由
  • POI 坐标校验 — 逐个调用高德 REST API 碰撞真实经纬度,未匹配的景点明确标记提示
  • SSE 流式进度 — Web 端实时展示生成进度(AI 规划 → 坐标校验 → 完成),告别漫长等待
  • 地图可视化 — Marker 标记 + Polyline 路线折线 + 卡片悬浮联动高亮
  • 小程序适配 — Timeline 时间线设计,地图与行程卡片双向联动
  • 工程规范 — 密钥全部外置到 .env,带超时控制、错误兜底、JSON 修复逻辑

API 接口

POST /api/generate-itinerary

请求体:

{
  "destination": "杭州",
  "days": 2
}

响应模式:

  • 请求头包含 Accept: text/event-stream → SSE 流式响应(Web 端)
  • 普通请求 → JSON 响应(小程序端)

SSE 事件格式:

data: {"step":"llm","message":"🤖 AI 正在规划行程..."}
data: {"step":"poi","message":"🗺️ 正在校验景点坐标 (3/8)..."}
data: {"step":"done","message":"✅ 路线生成完毕!"}
data: {"success":true,"data":{...}}

环境变量说明

变量名 用途 配置位置
GAODE_REST_KEY 高德 REST API(POI 搜索) 根目录 .env
ALIYUN_KEY 阿里云通义千问 根目录 .env
SILICONFLOW_KEY SiliconFlow(可选,测试脚本用) 根目录 .env
VITE_AMAP_JS_KEY 高德 JS API(前端地图) tripmind-web/.env
VITE_AMAP_SECURITY_CODE 高德安全密钥 tripmind-web/.env

About

TripMind 是一个基于大模型(LLM)协同地图 POI 的智能旅行路书生成平台。通过“AI 逻辑规划 + 地图数据校验 + 移动端落地”的模式,帮用户生成一条真正可用、地名准确、路线顺畅的自由行行程。

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages