VirtualTour-Back

这是2025年第十八届中国大学生计算机设计大赛虚拟文旅项目的后端代码库，代码的使用方法请参考本文档。

🛠️环境安装

Python Version: 3.10

🔧使用Python虚拟环境

---

Linux

pip -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

---

Windows

pip -m venv .venv
venv\Scripts\activate
pip install -r requirements.txt

---

🔧使用Anaconda

conda create -n vitour python=3.10
conda activate vitour
pip install -r requirements.txt

📌API_KEY配置

.env 文件包含了所有的API_KEY，请自行在 /src 目录创建并按照以下格式填写：

DEEPSEEK_API_KEY=sk-xxxxxx
XUNFEI_APP_ID=xxxxxx
XUNFEI_API_KEY=xxxxxxx
XUNFEI_API_SECRET=MDJiOWQzxxxxxxxxxx
QWEN_API_KEY=sk-xxxxx
OPENAI_API_KEY=sk-xxxxxxx

证书配置

因为硬件加速强制要求在安全的网络上下文环境中，故必须采用https进行部署。 将privkey.pem和cert.pem放进src目录中即可。

## 🗂项目结构

```TEXT
.
├── src/
│   ├── mcp_server/
│   │   ├── mcp.py
│   │   └── tools.json
│   ├── rag/
│   │   ├── base.txt
│   │   └── rag.py
│   ├── tts/
│   │   └── text_speech.py
│   ├── .env
│   ├── index.html
│   └── main.py
├── .venv/
├── LICENSE
├── README.md
├── cert.pem
├── privkey.pem
├── README.md
└── requirements.txt

✅ 待办

• 编写 Dockerfile 🐳