chore(dev): 按端口杀进程树，避免 Windows 孤儿监听

新增 stop.bat/ps1/sh，并写入本地开发规则：停服务用脚本、停后复核端口。

Co-authored-by: Cursor <cursoragent@cursor.com>

.cursor/project_memory.md

@@ -284,6 +284,7 @@
 - **全站图片策略：用户上传的图片统一 WebP**。头像裁剪/转码在浏览器端完成（Canvas → toBlob('image/webp')），后端只收 WebP
 - 存储：`backend/data/uploads/avatars/{随机hex32}.webp`（已在 backend/data/ gitignore 内），Gin `r.Static("/uploads", ...)` 提供静态服务；Next rewrite 新增 `/uploads/:path*` 同源代理到后端（与 /api 一样走 BACKEND_URL 兜底 localhost:3001）
 - **本地开发数据目录铁律（2026-09-16）**：`config.Parse` 从 cwd 向上解析 backend 根，不跟 `os.Getwd()` 走。规范启动 `cd backend && go run ./cmd/jiang13`；数据只有 `backend/data/`。在 `cmd/jiang13/` 启动会写出另一套 `cmd/jiang13/data`，DB 里头像 404。规则见 `.cursor/rules/jiang13-bbs-local-dev.mdc`；可用 `JIANG13_WORK_PATH` 覆盖。启动日志打印 `workPath`/`dataDir`。`:3001` 已占用则不要再开第二个后端
+- **本地进程停干净（2026-09-16）**：Windows 上停 Cursor 终端常留下 `go`/`node` 孤儿听端口。用户用仓库根 `stop.bat`（Unix：`./stop.sh`）按 `:3000`/`:3001` + `taskkill /T` 杀进程树；agent 禁止只杀 shell、停后须复核端口空闲。详见 `jiang13-bbs-local-dev.mdc`
 - DB：`attachments` 表（user_id+kind 联合索引，kind 取值 `avatar`/`image`，记录 url/mime/size/width/height）；`service/upload.go` 校验 RIFF/WEBP 魔数 + `golang.org/x/image/webp` 解码尺寸（正方形 64~512px）+ **大小限制以裁剪后文件为准（≤2MiB，MaxBytesReader 限请求体）**，落盘与 user.avatar 更新在同一事务
 - 路由（需登录 + CSRF）：`POST /api/upload/avatar`（multipart 字段 file）、`PUT /api/avatar/use`（只能选用本人 attachments 中的 url）、`GET /api/my/media`（本人全部附件，id DESC 限 60 条）、`DELETE /api/my/attachments/:id`（被帖子 content 引用返回 409；是当前头像则事务内置空 user.avatar；成功后物理删除文件）
 - **头像只能走上传/媒体库选用通道**：`UpdateProfile` 已移除 avatar 字段，禁止通过资料接口写任意外链 URL

.cursor/rules/jiang13-bbs-local-dev.mdc

@@ -1,5 +1,5 @@
 ---
-description: 本地开发启动约定：后端工作目录、唯一数据目录、单实例，避免头像/上传 404
+description: 本地开发启动/停止约定：工作目录、单实例、按端口杀进程树，避免孤儿进程与头像 404
 alwaysApply: true
 ---
 
@@ -30,6 +30,33 @@ npm.cmd run dev
 
 `:3000` 把 `/uploads` rewrite 到 `:3001`。头像 404 先查后端 `dataDir`，不要改前端。
 
+## 进程生命周期（Windows 孤儿进程）
+
+根因：Cursor/agent 停掉的往往是 **shell 父进程**；`go run` / `npm` 拉起的 `go.exe`/`node.exe`/编译产物仍在听端口，任务管理器里才看得见。
+
+### Agent 必须遵守
+
+1. **先查再启**：启动前用端口探测；`:3000`/`:3001` 已在听 → **复用**，禁止再开一份
+2. **停服务优先跑脚本**（仓库根）：
+   - Windows：`stop.bat`（内部调用 `stop.ps1`）
+   - Unix：`./stop.sh`
+3. **禁止**只依赖「结束终端 / Ctrl+C / 杀 shell PID」当作已停干净
+4. 无脚本时，Windows 用 **按端口 + 进程树** 清理（PowerShell）：
+   ```powershell
+   foreach ($port in 3000,3001) {
+     Get-NetTCPConnection -LocalPort $port -State Listen -EA SilentlyContinue |
+       Select-Object -ExpandProperty OwningProcess -Unique |
+       ForEach-Object { if ($_ -gt 0) { taskkill /T /F /PID $_ } }
+   }
+   ```
+5. 声称已停止后，**再查一次**端口是否空闲；仍占用则继续 `/T` 杀树，勿让用户去任务管理器
+6. 默认**不动** Docker Postgres；用户要停库再 `docker compose down`
+7. 会话结束前若本会话启动过前后端：主动清理或明确告知用户执行 `stop.bat`
+
+### 用户侧
+
+双击 / 运行仓库根 `stop.bat`（或 `./stop.sh`）即可，无需开任务管理器。
+
 ## 遗留目录
 
 `backend/cmd/jiang13/data/` 是错误 cwd 的产物，禁止当数据源。发现后把 `uploads/` 合并进 `backend/data/uploads/`，再删遗留目录。