fix: 固定开发环境后端数据目录,避免 cwd 不同导致头像 404

从 cwd 向上解析 backend 根,并写入本地开发启动约定。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-09-16 05:13:58 +08:00
parent 833bcd33a1
commit b0170a99fd
10 changed files with 208 additions and 9 deletions

View File

@@ -0,0 +1,35 @@
---
description: 本地开发启动约定:后端工作目录、唯一数据目录、单实例,避免头像/上传 404
alwaysApply: true
---
# 本地开发环境
## 后端启动(必须遵守)
规范命令与 `start.bat` / `start.sh` 一致:
```
cd backend
go run ./cmd/jiang13
```
- 数据目录**只有** `backend/data/`(头像在 `backend/data/uploads/avatars/`)
- 配置文件是 `backend/app.ini`,不是仓库根、也不是 `cmd/jiang13/`
- **禁止**在仓库根、`backend/cmd/jiang13/` 或其他目录执行 `go run`(会另建一套 data,DB 里头像 URL 对不上文件)
- **禁止**同时跑两个后端。启动前若 `:3001` 已在听,沿用现有进程,或先停再启;不要再开一个
- 启动日志必须含 `workPath=.../backend` 且 `dataDir=.../backend/data`。若不是,立刻停掉重来
- 覆盖工作目录只用环境变量 `JIANG13_WORK_PATH`(指向 `backend/`)
## 前端
```
cd frontend
npm.cmd run dev
```
`:3000` 把 `/uploads` rewrite 到 `:3001`。头像 404 先查后端 `dataDir`,不要改前端。
## 遗留目录
`backend/cmd/jiang13/data/` 是错误 cwd 的产物,禁止当数据源。发现后把 `uploads/` 合并进 `backend/data/uploads/`,再删遗留目录。