Nexus/.cursorrules

# Nexus 6.0 — Cursor 速查

> SSOT: [docs/project/nexus-functional-development-guide.md](docs/project/nexus-functional-development-guide.md)  
> Handoff: [docs/project/AI-HANDOFF-2026-06-03.md](docs/project/AI-HANDOFF-2026-06-03.md)

## 栈

FastAPI + Async SQLAlchemy + Redis · Vue 3 + Vuetify 4 SPA（15 页）· Vite → `web/app/`

## 环境（勿在仓库写密码）

- 生产: `https://api.synaglobal.vip` · 端口 8600 · `ssh nexus`
- 本地: `~/Nexus` 或 `$NEXUS_ROOT` · 见 [linux-dev-paths.md](docs/project/linux-dev-paths.md)
- 凭据: 仅 `.env`（不入 git）
- **Gitea**：clone/pull 可匿名；**push** 用 `bash scripts/git-push.sh`（凭据在 `deploy/nexus-1panel.secrets.sh`，已 gitignore，勿提交）

## 关键路径

| 用途 | 路径 |
|------|------|
| 后端入口 | `server/main.py` |
| 前端路由 | `frontend/src/router/index.ts` |
| API 客户端 | `frontend/src/api/index.ts` |
| Sync | `server/api/sync_v2.py` |
| 门控 | `deploy/pre_deploy_check.sh` |
| 本地验证 | `bash scripts/local_verify.sh` |

## 铁律

见 `.cursor/rules/perfect-implementation.mdc` · `nexus-security.mdc` — 完美实现、无静默吞错、无明文密钥、CUD 审计。

## Agent Git / diff（省 token、防卡顿）

- **禁止**无路径过滤的全仓 `git diff` / `git diff HEAD`（`web/app/assets` 构建产物可导致数十万行输出）。
- **优先**：`git diff --stat` 或 `git diff -- frontend/src server/api tests docs`。
- **提交**：只 `git add` 源码与文档；`web/app/assets/*` 由 Docker 内 `vite build` 生成，勿为 diff 把海量 hash 文件纳入上下文。
- **部署/门控**：定向 pytest（如 `tests/integration/test_*.py`），避免并行全仓 diff + 本地 build + 远程镜像重建。

## 部署

```bash
bash deploy/pre_deploy_check.sh && bash deploy/deploy-production.sh
```

前端: `cd frontend && npx vite build` → tar/scp（见 `deploy/deploy-frontend.sh`）

## 进度条（改代码时输出）

```
□实现 □本地验证 □审计8步 □部署 □健康检查 □浏览器验证 □changelog
```