升级与备份

升级

git pull                      # 或拉取新的镜像标签
docker compose build backend frontend
docker compose run --rm backend alembic upgrade head
docker compose up -d

Heads up

迁移是只进不退的——升级前请先给数据库做快照。生产环境没有 downgrade 路径。

版本在 GitHub 上打 tag 发布；升级前请阅读发布说明中标注"migration"或"breaking"的条目。

备份

全部状态只在两处：

Postgres — 定时 pg_dump（或云厂商快照）。
文件存储 — FILE_STORAGE_PATH 挂载卷，或你的 S3 桶。

其余（Redis、容器）皆可随时重建。

恢复 = 恢复这两者 → 启动服务，即完成。请在需要之前先演练一次恢复。

故障排查

现象	常见原因
前端能打开，其余请求 401/403	令牌错误或已轮换；`CORS_ORIGINS` 不匹配
消息只有刷新后才出现	代理缓冲了 SSE——见生产环境
智能体显示在线但从不回复	运行冒烟测试（话题横幅 → 重新检测）；到设备上检查智能体 CLI
启动报 `relation ... does not exist`	迁移未执行——`alembic upgrade head`
第二个副本收不到事件	未设置 `REDIS_URL`

仍未解决？Discord 或 GitHub issues——请附上后端日志。