[codex] add K3s update center (#314)

* add k3s update center

* fix update center status timeouts

* Polish update center settings UI

* Document k3s update center

* Refocus update center docs for users

* Clarify k3s migration path in docs

docs/deployment.md

@@ -17,6 +17,34 @@
 > - 当前不再提供 `Release` 压缩包 + Node.js 运行时的独立部署路径。
 > - 生产/长期运行请用 Docker 系列方案；桌面版面向单机本地使用；源码运行请走本地开发流程。
 
+## K3s / Helm 更新中心
+
+如果你现在只是一个最普通的 Docker / Docker Compose 部署，请先跳过这节。
+
+这套能力只适用于：
+
+- 你已经在 K3s / Kubernetes 中部署了 Metapi
+- 而且当前 Metapi 是通过 Helm release 管理的
+
+它不适用于：
+
+- 只有一个裸 Docker Compose 容器
+- 想直接从管理后台更新外部 Docker 主机上的容器
+
+但如果你是老用户，**正在计划从 Docker Compose 迁到 K3s / Helm，以获得滚动更新能力**，那么这一节和对应专题页是值得提前看的。它写的不是“怎么原地升级 Compose”，而是“迁移完成后你会如何使用更新中心”。
+
+如果你已经通过 Helm 在 K3s / Kubernetes 中部署 Metapi，并希望在管理后台中：
+
+- 查看当前运行版本
+- 检查 GitHub Releases / Docker Hub 的稳定版
+- 通过集群内 helper 手动触发一次升级
+
+请直接阅读：
+
+- [K3s 更新中心](./k3s-update-center.md)
+
+这页会单独说明 helper 部署、主服务 token 对齐、设置页字段含义、实际升级顺序和已知限制。
+
 ## Zeabur 一键部署
 
 <a href="https://zeabur.com/templates/DOX5PR">