环境配置指南

本指南用于帮助新成员配置 ai-learning-assistant 项目的开发环境。

1. 软件安装

请根据需求自行判断下载或安装以下软件。

1.1 基础开发环境 必备！！！！

• Git (版本控制)
  • 文件：Git-2.52.0-64-bit.exe
  • 下载链接：点击下载Git
  • 注意事项：这一步要选择使用vscode作为编译器，剩下安装全部默认即可

• Node.js (前端环境)
  • 文件：node-v25.2.1-x64.msi
  • 下载链接：点击下载Node.js
• Python (后端环境)
  • 说明：请安装 Python 3.10 或更高版本。
  • 下载连接：点击下载python-3.14.2-amd64.exe

1.2 开发工具

• Antigravity (代码编辑器)

  • 文件：Antigravity.exe
  • 下载链接：点击下载Antigravity.exe

• Cursor (代码编辑器)

  • 文件：CursorSetup-x64-2.2.44.exe
  • 下载链接：点击下载Cursor

1.3 网络工具

• FlClash (代理工具)
  • 文件：FlClash--windows-amd64-setup.exe
  • 下载链接：点击下载FlClash

2. 网络配置 (FlClash)

为了确保开发过程中能正常下载依赖，请按以下步骤配置 FlClash或者配置清华源，详见常见问题栏：

1. 安装并运行 FlClash。
2. 添加订阅：
   • 订阅链接：

     请从群公告获取
     

3. 更新订阅并选择节点。
4. 开启 系统代理 (System Proxy)。

3. 🚀 快速开始

1. 环境准备

• Python 3.10+
• Node.js 16+ (仅开发需要，运行无需)
• DeepSeek API Key

2. 安装依赖

后端依赖:

pip install fastapi uvicorn sqlmodel pymupdf requests python-multipart

前端依赖 (仅需修改前端代码时):

cd frontend
npm install

3. 配置 API Key

在项目根目录创建 .env 文件：

DEEPSEEK_API_KEY=your_api_key_here

可以从群公告获取

4. 启动应用

方式一：直接运行 (推荐)

python run_app.py

此命令会：

• 启动 FastAPI 后端 (http://127.0.0.1:8000)
• 自动打开默认浏览器

方式二：开发模式

• 后端: uvicorn backend.app:app --reload
• 前端: cd frontend && npm run dev

4. 常见问题

Pip 镜像源配置 (加速下载)

设为默认

升级 pip 到最新的版本后进行配置：

python -m pip install --upgrade pip
pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple

如果您到 pip 默认源的网络连接较差，临时使用本镜像站来升级 pip：

python -m pip install -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple --upgrade pip

• 如果 npm install 失败，请检查 FlClash 是否开启了系统代理。

Antigravity登录问题

需要自备非国区的google账号，并且在FlClash内开启虚拟网卡模式才能登录

ai使用推荐

https://aistudio.google.com/免费且不限量使用高级功能
https://gemini.google.com/