PROJECT.md 3.4 KB
Trip Planner Pro — HelloAgents智能旅行助手
项目信息
- 项目名称: Trip Planner Pro — HelloAgents智能旅行助手
- 作者: @shengyuantong
- 项目类型: 生活服务
项目简介
AI 驱动的智能旅行规划助手，后端 FastAPI + 前端 Vue 3，通过多智能体 LLM 编排和高德地图 MCP 协议集成，实现个性化的旅行计划生成。系统支持多智能体协作自动搜索景点、查询天气、推荐酒店并生成完整行程，同时提供 AI 旅游对话和行程管理功能。
核心功能
- AI 智能生成旅行计划 — 用户输入城市、日期、偏好等基本信息，系统自动调用多智能体流水线（景点搜索 → 天气查询 → 酒店推荐 → 行程规划 Agent）生成详尽的 PDF/图片可导出行程
- 流式 AI 旅游对话 — 基于 SSE 的流式聊天，具备用户画像自动提取、跨会话上下文记忆，提供智能旅行问答
- 用户认证系统 — 双 JWT（HttpOnly Cookie）+ Redis Refresh Token 持久化 + RSA 加密密码传输，支持无 Cookie 设备兼容
- 高德地图深度集成 — 通过 MCP 协议接入高德地图服务，支持 POI 搜索、天气查询、多种交通方式路线规划（公共交通 / 自驾 / 步行 / 混合）
- 出行人群定制 — 支持 7 种出行人群（独自旅行、情侣夫妻、朋友结伴、家庭亲子、公司团建、老年旅行、研学旅行）个性化行程定制
- 历史行程管理 — 历史行程 CRUD、PDF / 图片导出
技术亮点
- 多智能体流水线架构 — 4 个顺序/并行步骤（景点搜索 → 天气 → 酒店 → 规划），采用
ThreadPoolExecutor并行执行无依赖任务，显著提升生成效率 - MCP 协议集成 — 通过 JSON-RPC 子进程方式接入高德地图 MCP 服务，每次批量调用独立启动子进程，实现 Agent 自动工具调用
- 用户画像系统 — 异步提取用户意图和偏好，跨会话持久化缓存，首次对话时按需加载，作为上下文注入提示词
- 双 JWT 认证 — Access Token（30 分钟）+ Refresh Token（7 天），均通过 HttpOnly Cookie 传递，Refresh Token 存储在 Redis 中支持轮换和撤销
- RSA 加密密码传输 — 前端使用 Web Crypto API 进行 RSA-OAEP 加密，后端使用
cryptography库解密，保障密码安全 - SSE 流式输出 — AI 对话采用 Server-Sent Events 实时推送 Token，前端使用
ReadableStream.getReader()解析流数据 - HTTPS 支持 — 内建自签名证书生成脚本，支持全站 HTTPS 访问
- 无 ORM 数据库 — 使用原生 SQLite + WAL 模式，无 ORM 依赖，轻量高效
演示效果
（待补充截图或 GIF）
自检清单
- 代码能够正常运行
- README 文档完整
- requirements.txt 完整
- 有清晰的使用示例
- 代码有适当的注释
其他说明
- 项目结构：前后端分离，
backend/为 FastAPI 后端，frontend/为 Vue 3 + Vite 前端 - 框架依赖：基于自定义
hello-agents==1.0.2框架（提供SimpleAgent、HelloAgentsLLM和Tool基类） - 6 组 API 路由：
auth（认证）、trip（旅行规划）、chat（AI 对话）、history（历史行程）、map（地图服务）、poi（POI 详情） - 模块级单例模式：每个服务暴露
get_*()函数惰性初始化并缓存全局实例，无依赖注入框架