From 7ac169c5e81cee0acc1416d22d7ee4464a507a8d Mon Sep 17 00:00:00 2001
From: Soulter <905617992@qq.com>
Date: Fri, 6 Mar 2026 14:34:29 +0800
Subject: [PATCH] docs: add macOS usage note and update instructions for
 astrbot in multiple README files

---
 README.md       | 9 +++++++++
 README_fr.md    | 9 +++++++++
 README_ja.md    | 9 +++++++++
 README_ru.md    | 9 +++++++++
 README_zh-TW.md | 9 +++++++++
 README_zh.md    | 9 +++++++++
 6 files changed, 54 insertions(+)

diff --git a/README.md b/README.md
index 95c84b495..d9b3cf019 100644
--- a/README.md
+++ b/README.md
@@ -83,6 +83,15 @@ astrbot
 
 > Requires [uv](https://docs.astral.sh/uv/) to be installed.
 
+> [!NOTE]
+> For macOS user: due to macOS security checks, the first run of the `astrbot` command may take longer (about 10-20s).
+
+Update `astrbot`:
+
+```bash
+uv tool upgrade astrbot
+```
+
 ### 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 3a586adfc..179e42005 100644
--- a/README_fr.md
+++ b/README_fr.md
@@ -83,6 +83,15 @@ astrbot
 
 > [uv](https://docs.astral.sh/uv/) doit être installé.
 
+> [!NOTE]
+> Pour les utilisateurs macOS : en raison des vérifications de sécurité de macOS, la première exécution de la commande `astrbot` peut prendre plus de temps (environ 10-20s).
+
+Mettre à jour `astrbot` :
+
+```bash
+uv tool upgrade astrbot
+```
+
 ### 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 43b73884d..b8a7bba04 100644
--- a/README_ja.md
+++ b/README_ja.md
@@ -83,6 +83,15 @@ astrbot
 
 > [uv](https://docs.astral.sh/uv/) のインストールが必要です。
 
+> [!NOTE]
+> macOS ユーザーの場合：macOS のセキュリティチェックにより、`astrbot` コマンドの初回実行に時間がかかる場合があります（約 10〜20 秒）。
+
+`astrbot` の更新：
+
+```bash
+uv tool upgrade astrbot
+```
+
 ### Docker デプロイ
 
 コンテナ運用に慣れており、より安定した本番向けのデプロイ方法を求めるユーザーには、Docker / Docker Compose での AstrBot デプロイをおすすめします。
diff --git a/README_ru.md b/README_ru.md
index 8848dd92d..45cebf627 100644
--- a/README_ru.md
+++ b/README_ru.md
@@ -83,6 +83,15 @@ astrbot
 
 > Требуется установленный [uv](https://docs.astral.sh/uv/).
 
+> [!NOTE]
+> Для пользователей macOS: из-за проверок безопасности macOS первый запуск команды `astrbot` может занять больше времени (около 10-20 секунд).
+
+Обновить `astrbot`:
+
+```bash
+uv tool upgrade astrbot
+```
+
 ### Развёртывание Docker
 
 Для пользователей, знакомых с контейнерами и которым нужен более стабильный и подходящий для production способ, мы рекомендуем разворачивать AstrBot через Docker / Docker Compose.
diff --git a/README_zh-TW.md b/README_zh-TW.md
index efafbc73a..e42b228e5 100644
--- a/README_zh-TW.md
+++ b/README_zh-TW.md
@@ -83,6 +83,15 @@ astrbot
 
 > 需要安裝 [uv](https://docs.astral.sh/uv/)。
 
+> [!NOTE]
+> 對於 macOS 使用者：由於 macOS 安全性檢查，首次執行 `astrbot` 指令可能需要較長時間（約 10-20 秒）。
+
+更新 `astrbot`：
+
+```bash
+uv tool upgrade astrbot
+```
+
 ### Docker 部署
 
 對於熟悉容器、希望獲得更穩定且更適合正式環境部署方式的使用者，我們推薦使用 Docker / Docker Compose 部署 AstrBot。
diff --git a/README_zh.md b/README_zh.md
index abc5b3ef3..1c45ac5a9 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -83,6 +83,15 @@ astrbot
 
 > 需要安装 [uv](https://docs.astral.sh/uv/)。
 
+> [!NOTE]
+> 对于 macOS 用户：由于 macOS 安全检查，首次运行 `astrbot` 命令可能需要较长时间（约 10-20 秒）。
+
+更新 `astrbot`：
+
+```bash
+uv tool upgrade astrbot
+```
+
 ### Docker 部署
 
 对于熟悉容器、希望获得更稳定且更适合生产环境部署方式的用户，我们推荐使用 Docker / Docker Compose 部署 AstrBot。