From 04c1897a1f952f5e3250307f14d4c28fe8fee705 Mon Sep 17 00:00:00 2001 From: piexian <64474352+piexian@users.noreply.github.com> Date: Thu, 2 Apr 2026 20:49:05 +0800 Subject: [PATCH 1/7] =?UTF-8?q?docs:=20=E5=9C=A8=20uv=20=E9=83=A8=E7=BD=B2?= =?UTF-8?q?=E6=96=87=E6=A1=A3=E4=B8=AD=E6=B7=BB=E5=8A=A0=E4=B8=8D=E6=94=AF?= =?UTF-8?q?=E6=8C=81=20WebUI=20=E5=8D=87=E7=BA=A7=E7=9A=84=E8=AF=B4?= =?UTF-8?q?=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 通过 astrbot run（CLI 模式）启动时，会设置 ASTRBOT_CLI 环境变量， updator 会拒绝 WebUI 触发的升级操作以避免版本管理混乱。 用户需要通过命令行执行 uv tool upgrade astrbot 来更新。 Closes #7291 --- README.md | 3 +++ README_fr.md | 3 +++ README_ja.md | 3 +++ README_ru.md | 3 +++ README_zh-TW.md | 3 +++ README_zh.md | 3 +++ docs/en/deploy/astrbot/package.md | 5 +++++ docs/zh/deploy/astrbot/package.md | 5 +++++ 8 files changed, 28 insertions(+) diff --git a/README.md b/README.md index a901c5e137..58df635e5f 100644 --- a/README.md +++ b/README.md @@ -92,6 +92,9 @@ Update `astrbot`: uv tool upgrade astrbot ``` +> [!WARNING] +> AstrBot deployed via `uv` does not support upgrading through the WebUI. To update, please run the command above from the command line. + ### Docker Deployment For users familiar with containers and looking for a more stable, production-ready deployment method, we recommend deploying AstrBot with Docker / Docker Compose. diff --git a/README_fr.md b/README_fr.md index 979ba62f67..4ff078fd6d 100644 --- a/README_fr.md +++ b/README_fr.md @@ -92,6 +92,9 @@ Mettre à jour `astrbot` : uv tool upgrade astrbot ``` +> [!WARNING] +> AstrBot déployé via `uv` ne prend pas en charge la mise à jour via le WebUI. Pour mettre à jour, exécutez la commande ci-dessus depuis le terminal. + ### Déploiement Docker Pour les utilisateurs familiers avec les conteneurs et qui souhaitent une méthode plus stable et adaptée à la production, nous recommandons de déployer AstrBot avec Docker / Docker Compose. diff --git a/README_ja.md b/README_ja.md index 0e6d2dba49..edf5f9debd 100644 --- a/README_ja.md +++ b/README_ja.md @@ -92,6 +92,9 @@ astrbot run uv tool upgrade astrbot ``` +> [!WARNING] +> `uv` 経由でデプロイした AstrBot は、WebUI からのバージョンアップグレードに対応していません。更新するには、上記のコマンドをコマンドラインで実行してください。 + ### Docker デプロイ コンテナ運用に慣れており、より安定した本番向けのデプロイ方法を求めるユーザーには、Docker / Docker Compose での AstrBot デプロイをおすすめします。 diff --git a/README_ru.md b/README_ru.md index 64d742c5a3..8d01ef851f 100644 --- a/README_ru.md +++ b/README_ru.md @@ -92,6 +92,9 @@ astrbot run uv tool upgrade astrbot ``` +> [!WARNING] +> AstrBot, развёрнутый через `uv`, не поддерживает обновление через WebUI. Для обновления выполните указанную выше команду из командной строки. + ### Развёртывание Docker Для пользователей, знакомых с контейнерами и которым нужен более стабильный и подходящий для production способ, мы рекомендуем разворачивать AstrBot через Docker / Docker Compose. diff --git a/README_zh-TW.md b/README_zh-TW.md index 5bfea0d279..1fb893df0c 100644 --- a/README_zh-TW.md +++ b/README_zh-TW.md @@ -92,6 +92,9 @@ astrbot run uv tool upgrade astrbot ``` +> [!WARNING] +> 透過 `uv` 部署的 AstrBot 不支援在 WebUI 中進行版本升級。如需更新，請透過命令列執行上述命令。 + ### Docker 部署 對於熟悉容器、希望獲得更穩定且更適合正式環境部署方式的使用者，我們推薦使用 Docker / Docker Compose 部署 AstrBot。 diff --git a/README_zh.md b/README_zh.md index c852033524..00298a5a40 100644 --- a/README_zh.md +++ b/README_zh.md @@ -92,6 +92,9 @@ astrbot run uv tool upgrade astrbot ``` +> [!WARNING] +> 通过 `uv` 部署的 AstrBot 不支持在 WebUI 中进行版本升级。如需更新，请通过命令行执行上述命令。 + ### Docker 部署 对于熟悉容器、希望获得更稳定且更适合生产环境部署方式的用户，我们推荐使用 Docker / Docker Compose 部署 AstrBot。 diff --git a/docs/en/deploy/astrbot/package.md b/docs/en/deploy/astrbot/package.md index d72961b950..22207fdfdb 100644 --- a/docs/en/deploy/astrbot/package.md +++ b/docs/en/deploy/astrbot/package.md @@ -9,6 +9,11 @@ If `uv` is not installed, install it first by following the official guide: `uv` supports Linux, Windows, and macOS. +## Important Notes + +> [!WARNING] +> AstrBot deployed via `uv` **does not support upgrading through the WebUI**. To update, run `uv tool upgrade astrbot` from the command line. + ## Install and Start ```bash diff --git a/docs/zh/deploy/astrbot/package.md b/docs/zh/deploy/astrbot/package.md index 70969f3446..a8345e010d 100644 --- a/docs/zh/deploy/astrbot/package.md +++ b/docs/zh/deploy/astrbot/package.md @@ -8,6 +8,11 @@ `uv` 支持 Linux、Windows、macOS。 +## 注意事项 + +> [!WARNING] +> 通过 `uv` 部署的 AstrBot **不支持在 WebUI 中进行版本升级**。如需更新，请在命令行中执行 `uv tool upgrade astrbot`。 + ## 安装并启动 ```bash From 6c8e285e92072ab4820115f08a1a40a2742a4613 Mon Sep 17 00:00:00 2001 From: LIghtJUNction Date: Thu, 2 Apr 2026 22:21:43 +0800 Subject: [PATCH 2/7] Update README.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 58df635e5f..d3c30ccdaa 100644 --- a/README.md +++ b/README.md @@ -93,7 +93,7 @@ uv tool upgrade astrbot ``` > [!WARNING] -> AstrBot deployed via `uv` does not support upgrading through the WebUI. To update, please run the command above from the command line. +> AstrBot deployed via `uv` **does not support upgrading through the WebUI**. To update, please run the command above from the command line. ### Docker Deployment From f2a0e249f9a2acff787266c48a16104716b5845f Mon Sep 17 00:00:00 2001 From: LIghtJUNction Date: Thu, 2 Apr 2026 22:21:54 +0800 Subject: [PATCH 3/7] Update README_fr.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- README_fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README_fr.md b/README_fr.md index 4ff078fd6d..8324808e1e 100644 --- a/README_fr.md +++ b/README_fr.md @@ -93,7 +93,7 @@ uv tool upgrade astrbot ``` > [!WARNING] -> AstrBot déployé via `uv` ne prend pas en charge la mise à jour via le WebUI. Pour mettre à jour, exécutez la commande ci-dessus depuis le terminal. +> AstrBot déployé via `uv` **ne prend pas en charge la mise à jour via le WebUI**. Pour mettre à jour, exécutez la commande ci-dessus depuis le terminal. ### Déploiement Docker From f4a1a48595e8e17e2638fdda183ffc79e4104ca8 Mon Sep 17 00:00:00 2001 From: LIghtJUNction Date: Thu, 2 Apr 2026 22:22:10 +0800 Subject: [PATCH 4/7] Update README_ja.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- README_ja.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README_ja.md b/README_ja.md index edf5f9debd..621bbbf6e4 100644 --- a/README_ja.md +++ b/README_ja.md @@ -93,7 +93,7 @@ uv tool upgrade astrbot ``` > [!WARNING] -> `uv` 経由でデプロイした AstrBot は、WebUI からのバージョンアップグレードに対応していません。更新するには、上記のコマンドをコマンドラインで実行してください。 +> `uv` 経由でデプロイした AstrBot は、**WebUI からのバージョンアップグレードに対応していません**。更新するには、上記のコマンドをコマンドラインで実行してください。 ### Docker デプロイ From 49cdbf6ab9b2ff00a57793e8d748495cef42c515 Mon Sep 17 00:00:00 2001 From: LIghtJUNction Date: Thu, 2 Apr 2026 22:22:22 +0800 Subject: [PATCH 5/7] Update README_ru.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- README_ru.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README_ru.md b/README_ru.md index 8d01ef851f..742c207bdb 100644 --- a/README_ru.md +++ b/README_ru.md @@ -93,7 +93,7 @@ uv tool upgrade astrbot ``` > [!WARNING] -> AstrBot, развёрнутый через `uv`, не поддерживает обновление через WebUI. Для обновления выполните указанную выше команду из командной строки. +> AstrBot, развёрнутый через `uv`, **не поддерживает обновление через WebUI**. Для обновления выполните указанную выше команду из командной строки. ### Развёртывание Docker From 87926c0054c256664fbf72b8d65a9571174a5473 Mon Sep 17 00:00:00 2001 From: LIghtJUNction Date: Thu, 2 Apr 2026 22:22:42 +0800 Subject: [PATCH 6/7] Update README_zh-TW.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- README_zh-TW.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README_zh-TW.md b/README_zh-TW.md index 1fb893df0c..4788312235 100644 --- a/README_zh-TW.md +++ b/README_zh-TW.md @@ -93,7 +93,7 @@ uv tool upgrade astrbot ``` > [!WARNING] -> 透過 `uv` 部署的 AstrBot 不支援在 WebUI 中進行版本升級。如需更新，請透過命令列執行上述命令。 +> 透過 `uv` 部署的 AstrBot **不支援在 WebUI 中進行版本升級**。如需更新，請透過命令列執行上述命令。 ### Docker 部署 From b60fa038754f4bddcd87f687c699df4d89f4f13a Mon Sep 17 00:00:00 2001 From: LIghtJUNction Date: Thu, 2 Apr 2026 22:22:56 +0800 Subject: [PATCH 7/7] Update README_zh.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- README_zh.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README_zh.md b/README_zh.md index 00298a5a40..2469456589 100644 --- a/README_zh.md +++ b/README_zh.md @@ -93,7 +93,7 @@ uv tool upgrade astrbot ``` > [!WARNING] -> 通过 `uv` 部署的 AstrBot 不支持在 WebUI 中进行版本升级。如需更新，请通过命令行执行上述命令。 +> 通过 `uv` 部署的 AstrBot **不支持在 WebUI 中进行版本升级**。如需更新，请通过命令行执行上述命令。 ### Docker 部署