方式 A：Docker 一键
cp .env.example .env
docker compose up -d --build
| 服务 | 目录 / 镜像 | 默认端口 |
|---|---|---|
| Postgres | db | 5432 |
| API | api/ | 8000 |
| MCP | mcp/ | 8080 |
| Web | web/（docker/Dockerfile.web） | 3000 |
- Web：http://localhost:3000
- MCP：
http://localhost:8080/mcp，锁定空间：http://localhost:8080/{slug}/mcp - 首次建卷会执行
tests/helpers/schema.sql+ 论文相关 migration（Postgres 库名supavault，产品名「文稿智库」）。 - 重建空库：
docker compose down -v && docker compose up -d --build - 侧栏「千问问答」：在
.env设DASHSCOPE_API_KEY后docker compose up -d --build web
方式 B：只起数据库 + 本机进程
docker compose up -d db
连接串：postgresql://postgres:postgres@localhost:5432/supavault
API
cd api
# 根目录 .env：DATABASE_URL、JWT_SECRET 等
uvicorn main:app --reload --port 8000
Web
cd web
# NEXT_PUBLIC_API_URL=http://localhost:8000
# NEXT_PUBLIC_MCP_URL=http://localhost:8080/mcp
npm run dev
MCP
cd mcp
# MCP_URL / API_URL / JWT 与根目录 .env 一致
uvicorn server:app --reload --port 8080
设置页可复制「通义千问 MCP」配置（推荐当前空间的 /{slug}/mcp）；正式挂百炼时 MCP 须公网可达。