面向 Z 世代的周末同城轻出行 AI 智能管家
CI Tests Python FastAPI License 美团 AI 大赛
一站式解决信息碎片化、预算失控、行程变动与出行陪伴难题
快速开始 · 产品亮点 · 项目结构 · 文档 · 常见问题
产品概念预览
Go Now(走你)面向 18–30 岁 Z 世代大学生与年轻上班族,聚焦 周末同城多人轻出行 场景。产品覆盖 种草 → 决策 → 规划 → 协同 → 导航 → 体验 → 售后 服务闭环,从工具型产品升级为主动式、场景化智能出行管家。
| 用户痛点 | Go Now 解法 |
|---|---|
| 多平台信息碎片化 | 自然语言输入 + AI 骨架 + 高德真实 POI |
| 预算容易失控 | 四档预算画像 + 步骤级人均约束 |
| 突发行程变动 | 天气改写、单步重匹配、路线动态重算 |
| 等待焦虑 / 疑问多 | 桌宠「走你」陪聊、新手教程、方言辅助 |
API Key(大模型 + 高德)由每位用户自行配置,服务端无需预置密钥,适合大赛演示与开源分享。
| 能力 | 通用聊天 AI | 地图 App | Go Now |
|---|---|---|---|
| 自然语言规划 | ✓ | △しろさんかく | ✓ |
| 真实 POI / 路线 | ✗ | ✓ | ✓ |
| 预算与偏好约束 | ✗ | △しろさんかく | ✓ |
| 天气 / 餐厅 / 交通分支 | ✗ | △しろさんかく | ✓ |
| 生成过程情感陪伴 | ✗ | ✗ | ✓ |
生成等待期本地题库陪聊,缓解焦虑。
- AI Key:通义、DeepSeek、OpenAI 等 13+ 提供商
- 高德 Key:Web 服务 + JS API + 安全密钥
- 每位提供商独立教程 →
docs/llm_guides/
- Python 3.11+
- Windows / macOS / Linux
| 端 | 启动命令 | 说明 |
|---|---|---|
| Windows 本地 | start_server_local.bat |
本机开发,热重载 |
| Windows Server | start_server.bat |
宝塔 / 腾讯云公网部署 |
| macOS 本地 | start_server_mac.command 或 ./start_server_local.sh |
本机开发,热重载 |
| Linux 服务器 | ./start_server.sh |
公网部署(0.0.0.0:8000) |
完整说明见 一键启动.md 。浏览器访问:http://127.0.0.1:8000/
- 注册 / 登录账号
- 设置 → 配置 AI Key(
docs/LLM_TOKEN_GUIDE.md) - 设置 → 配置高德 Key(
docs/AMAP_KEY_GUIDE.md) - 进入 AI 规划,输入需求或点「标准演示用例」
手动安装与开发模式
py -m pip install -r requirements.txt
copy .env.example .env # 仅占位,无需填写真实密钥
py -m uvicorn app.main:app --host 127.0.0.1 --port 8000 --reloadAPI 文档:http://127.0.0.1:8000/docs
运行测试
py -m pytest tests/ -q
GO-NOW-travelagent/
├── app/ # FastAPI 后端与静态前端
│ ├── routes/ # API 路由
│ ├── services/ # 规划编排、POI、LLM、高德
│ └── static/ # 规划页 JS / 欢迎页桥接
├── Best Destinations/ # 高德 POI 搜索与匹配引擎
├── docs/ # 演示脚本、Key 教程、安全说明
├── tests/ # 314 项单元测试
├── .github/ # CI、Issue 模板、社交分享图
├── 一键启动.md # 四端启动说明
├── start_server_local.bat # Windows 本地
├── start_server.bat # Windows Server
├── start_server_mac.command
├── start_server_local.sh # macOS / Linux 本地
├── start_server.sh # Linux 服务器
└── requirements.txt
flowchart LR
subgraph Client["前端"]
W["欢迎页 / 规划页"]
Pet["走你桌宠"]
end
subgraph API["FastAPI"]
Auth["用户 / 档案"]
Plan["行程编排"]
LLM["用户 LLM 配置"]
Amap["用户高德配置"]
end
subgraph Engine["智能引擎"]
Qwen["大模型骨架"]
Rules["规则 + RAG"]
POI["高德 POI / 路线"]
end
W --> Auth --> Plan
Plan --> Qwen & Rules & POI
LLM --> Qwen
Amap --> POI
Pet --> API
| 层级 | 技术 |
|---|---|
| 后端 | FastAPI · SQLite · SQLAlchemy |
| 大模型 | 用户自配 OpenAI 兼容 API |
| 地图 | 高德 Web 服务 + JS API |
| 前端 | 原生 HTML / JS · Live2D 桌宠 |
| 质量 | 314 项 pytest · GitHub Actions CI |
| 文档 | 说明 |
|---|---|
| docs/DEMO_SCRIPT.md | 3 分钟评委演示脚本 |
| docs/SECURITY.md | 安全与密钥说明 |
| docs/LLM_TOKEN_GUIDE.md | AI Key 配置总览 |
| docs/AMAP_KEY_GUIDE.md | 高德双 Key 教程 |
| docs/标准测试用例.md | 标准演示用例 |
| CONTRIBUTING.md | 贡献指南 |
| CHANGELOG.md | 版本变更记录 |
| 方法 | 路径 | 说明 |
|---|---|---|
POST |
/api/travel/register |
注册 |
POST |
/api/travel/login |
登录 |
GET |
/api/travel/profile |
用户档案与预算档位 |
POST |
/api/travel/plan/stream |
流式生成出游计划 |
GET |
/api/travel/llm/config |
读取 AI Key 配置 |
GET |
/api/travel/amap/config |
读取高德 Key 配置 |
完整接口见 app/routes/travel.py 与 Swagger /docs。
配置了 AI Key 仍提示未配置?
请重新登录一次,确保欢迎页与规划页使用同一用户 ID。本地可清除 localStorage.travel_user_id 后重新登录并保存 Key。
高德搜索一直报错或服务器空转?
检查 Web 服务 Key 是否有效、每日配额是否用尽(错误码 10044)。无效 Key 会触发熔断并快速失败,请更换有效 Key 后重试。
私密仓库社交预览图不显示?
GitHub 对私密仓库的 Social Preview 支持有限。公开后可到 Settings → General → Social preview 上传 .github/social-preview.png,或运行 py scripts/generate_github_social_preview.py 重新生成。
欢迎提交 Issue 与 Pull Request,详见 CONTRIBUTING.md。