r
6859846b7c
- bootstrap 失败恢复 SSH 临时登录回退 - ssh_bootstrap 真安装检测与 config 目录自愈 - axs Gitea 发布源切换为 https://axs.kuma1xn.vip
57 lines
2.3 KiB
Plaintext
57 lines
2.3 KiB
Plaintext
# 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 + 远程镜像重建。
|
||
|
||
## 部署
|
||
|
||
默认 **本机 rsync 直传**（不 push Gitea）：
|
||
|
||
```bash
|
||
bash deploy/pre_deploy_check.sh && bash deploy/deploy-production.sh
|
||
```
|
||
|
||
仅同步源码（不重建镜像）：`bash deploy/rsync-local-to-server.sh`
|
||
仍走 Gitea 拉取：`NEXUS_DEPLOY_VIA_GIT=1 bash deploy/deploy-production.sh`
|
||
|
||
前端: `cd frontend && npx vite build` → 部署脚本内 tar/scp 到 `web/app/`
|
||
|
||
## 进度条（改代码时输出）
|
||
|
||
```
|
||
□实现 □本地验证 □审计8步 □部署 □健康检查 □浏览器验证 □changelog
|
||
```
|