人工智能技术应用课程讲义

项目脚手架下载 ​

两套脚手架是推荐的统一技术底座：Flask 或 Express 后端 + Vue 3 前端 + SQLite 持久化。本机装好 Python 和 Node.js 后，按下面步骤在本地直接运行，不要求安装 Docker；容器化打包只作为学有余力时的可选交付方式。

技术路线只是推荐而非限制：已有基础的同学可以选用其他后端语言或框架（如 PHP、Java 等），但需满足选题的功能、数据库持久化与本地可运行要求，环境与部署问题需自行解决，建议换技术栈前先与指导老师沟通。

两套脚手架任选其一即可，不建议毕设中途更换。解压后先读压缩包里的 README.md，那是完整的图文教程（环境准备、目录结构、加功能示例、常见问题、推进清单）。

Flask + Vue 脚手架

v1.1.0可下载

Flask 3 后端、Vue 3 前端，本地三步跑通；附 Docker 可选打包脚本与完整使用教程 README。

下载 ZIP

Express + Vue 脚手架

v1.1.0可下载

Express 后端、Vue 3 前端，本地三步跑通；附 Docker 可选打包脚本与完整使用教程 README。

下载 ZIP

使用前准备 ​

  1. 安装 Python 3.9+（Flask 版需要；Windows 安装时勾选 Add python.exe to PATH）。

  2. 安装 Node.js 18+ LTS（两套都需要，自带 npm）。

  3. 校园网下载慢可先配国内镜像（各执行一次）：

    bash
    pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
npm config set registry https://registry.npmmirror.com

  4. 把压缩包解压到英文路径，避免 Windows 下中文路径造成异常。

Flask + Vue：本地三步跑起来 ​

开两个终端窗口。终端 1 启动后端（监听 5050）：

bash
cd graduation-flask-vue-scaffold/server
python3 -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate
pip install -r requirements.txt
python app.py

终端 2 启动前端（监听 5173）：

bash
cd graduation-flask-vue-scaffold/web
npm install
npm run dev

浏览器打开 http://localhost:5173，页面顶部「后端连通性」显示绿点即成功；后端健康检查是 http://localhost:5050/api/health。

Express + Vue：本地三步跑起来 ​

开两个终端窗口。终端 1 启动后端（监听 3000）：

bash
cd graduation-express-vue-scaffold/server
npm install
npm run dev

终端 2 启动前端（监听 5173）：

bash
cd graduation-express-vue-scaffold/web
npm install
npm run dev

浏览器打开 http://localhost:5173，「后端连通性」显示绿点即成功；后端健康检查是 http://localhost:3000/api/health。

配置 Agnes API Key（AI 类选题需要） ​

本地模式下，在启动后端的那个终端里先设置环境变量再启动：

bash
# macOS / Linux
export AGNES_API_KEY=你的密钥
export AGNES_API_BASE=https://apihub.agnes-ai.com/v1

# Windows PowerShell
$env:AGNES_API_KEY = "你的密钥"

Docker 模式则写在 docker/.env 中。无论哪种方式：Key 不进 Git、不进前端代码、不进说明书截图，所有 Agnes 请求必须由 server/ 后端代理。申请步骤见 Agnes API 使用教程。

下一步 ​

  1. 把 web/src/App.vue 里的演示卡片改成你选题的第一个页面。
  2. 按 选题页 的功能模块清单拆分接口和数据表。
  3. 遇到端口占用、依赖安装失败等问题，先查压缩包内 README 的「常见问题排查」一节。