Nexus/AGENTS.md

# Nexus 6.0 — Agent 入口（薄 stub）

> **长文 SSOT**: [docs/project/nexus-functional-development-guide.md](docs/project/nexus-functional-development-guide.md) + [附录](docs/project/nexus-functional-development-guide-appendix.md)  
> **会话接续**: [docs/project/AI-HANDOFF-2026-06-03.md](docs/project/AI-HANDOFF-2026-06-03.md)  
> **文档总索引**: [docs/README.md](docs/README.md)

## 项目概要

Nexus：2000+ 子机运维平台。后端 FastAPI + MySQL + Redis；前端 **Vue 3 + Vuetify 4 + TypeScript SPA**（14 页，`frontend/src/pages/`）；构建输出 `web/app/`；安装向导 `web/app/install.html`。

## 本地开发

```bash
docker compose up -d mysql redis
bash scripts/start-dev.sh          # API :8600
bash scripts/local_verify.sh     # L2b
cd frontend && npm run dev         # :3000/app/
```

路径见 [linux-dev-paths.md](docs/project/linux-dev-paths.md)。

## 强制约束

- 完美实现：`.cursor/rules/perfect-implementation.mdc`
- 安全 / 后端 / 前端：`.cursor/rules/nexus-*.mdc`
- 改代码必 `docs/changelog/YYYY-MM-DD-*.md`（≥10 行）
- 测试由 Agent 完成；用户只做终验

## 不可改

`API_KEY` · `SECRET_KEY` · `ENCRYPTION_KEY` · `DATABASE_URL`

## 部署

```bash
bash deploy/pre_deploy_check.sh
bash deploy/deploy-production.sh   # 需 SSH nexus + 用户批准
```

详情见功能指南 §17–18。

## 归档文档

历史审计合并卷：`docs/archive/README.md`