项目脚手架下载

两套脚手架都已经配置前后端目录、Nginx 反向代理、Docker Compose、健康检查和 Mac/Windows 启动脚本。学生选择其中一套即可，不建议毕设中途更换。

Flask + Vue 脚手架

v1.0.0可下载

Flask 3 后端、Vue 3 前端、Nginx 反向代理、Docker Compose 健康检查与构建脚本。

下载 ZIP

Express + Vue 脚手架

v1.0.0可下载

Express 后端、Vue 3 前端、Nginx 反向代理、Docker Compose 健康检查与构建脚本。

下载 ZIP

使用前准备

1. 安装并启动 Docker Desktop。
2. 确认 Docker 正在运行：docker --version 和 docker compose version 都能执行。
3. 把压缩包解压到英文路径，避免 Windows 下中文路径造成构建异常。
4. 首次构建需要拉取基础镜像并安装依赖，通常需要 3–8 分钟。

Flask + Vue 启动步骤

cd graduation-flask-vue-scaffold
chmod +x build/build.sh docker/up.sh docker/down.sh
./build/build.sh
./docker/up.sh

浏览器打开 http://localhost:8080，后端健康检查是 http://localhost:5050/api/health。

Express + Vue 启动步骤

cd graduation-express-vue-scaffold
chmod +x build/build.sh docker/up.sh docker/down.sh
./build/build.sh
./docker/up.sh

浏览器打开 http://localhost:8081，后端健康检查是 http://localhost:5051/api/health。

配置 Agnes API Key

1. 编辑 docker/.env。
2. 增加 AGNES_API_KEY=你的密钥。
3. 按需增加 AGNES_API_BASE=https://apihub.agnes-ai.com/v1。
4. 重启容器：./docker/down.sh && ./docker/up.sh。

docker/.env 不提交 Git，也不复制到前端。所有 Agnes 请求必须由 server/ 下的后端代理。生图接口示例见压缩包内的 server/docs/AGNES_IMAGE_API.md。