[新增] 更新文档

docs/guide/upgrade.md

@@ -1,11 +1,24 @@
 # 升级与维护
 
+你会学到：如何升级 Server 与 Agent、如何清理观测数据，以及维护前后应该执行哪些验证命令。
+
+升级前建议先确认当前激活版本、最近一次 Agent 应用结果和数据库备份策略。生产环境不要在发布配置、Agent 大规模重连或数据库迁移进行中同时升级。
+
 ## Server 升级
 
 Root 用户可以在管理端顶栏检查并升级 Server 正式版。也可以通过上传 Server 二进制的方式执行确认升级。
 
 如需尝试 preview 版本，可手动检查对应发布。生产环境建议优先使用正式版。
 
+升级后确认：
+
+```bash
+docker compose ps
+docker compose logs -n 100 openflare
+```
+
+如果是源码部署，重新启动 Server 后确认日志中没有数据库迁移或启动错误。
+
 ## Agent 升级
 
 节点 Agent 默认只跟随正式版自动更新。preview 升级需要手动触发。
@@ -18,6 +31,15 @@ curl -fsSL https://raw.githubusercontent.com/Rain-kl/OpenFlare/main/scripts/inst
   --agent-token YOUR_AGENT_TOKEN
 ```
 
+注意：当前安装脚本重装时会删除整个安装目录，包括旧 `agent.json`、本地状态、缓存数据和下载的二进制。执行前请确认手头仍有可用 Token。
+
+升级后确认：
+
+```bash
+systemctl status openflare-agent
+journalctl -u openflare-agent -n 100 --no-pager
+```
+
 ## 数据维护
 
 管理端设置页可以维护观测数据自动清理策略：
@@ -49,5 +71,15 @@ Frontend：
 
 ```bash
 cd openflare_server/web
+pnpm lint
+pnpm typecheck
+pnpm test
+pnpm build
+```
+
+Docs：
+
+```bash
+cd docs
 pnpm build
 ```