From c376c4bdd26feebf08346ba2f71a4ee492fbd5ff Mon Sep 17 00:00:00 2001
From: machina <1531829828@qq.com>
Date: Thu, 19 Mar 2026 16:58:10 +0800
Subject: [PATCH 1/2] fix: update hint for ID whitelist configuration to
 clarify behavior when empty

---
 astrbot/core/config/default.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/astrbot/core/config/default.py b/astrbot/core/config/default.py
index 3ba68fa898..47dffdd56e 100644
--- a/astrbot/core/config/default.py
+++ b/astrbot/core/config/default.py
@@ -3308,7 +3308,7 @@ class ChatProviderTemplate(TypedDict):
                         "description": "白名单 ID 列表",
                         "type": "list",
                         "items": {"type": "string"},
-                        "hint": "使用 /sid 获取 ID。",
+                        "hint": "使用 /sid 获取 ID。当白名单列表为空时，代表不启用白名单（即所有 ID 都在白名单内）。",
                     },
                     "platform_settings.id_whitelist_log": {
                         "description": "输出日志",

From 05678f2e47ad4692c347713f30c406b0f7f9bb7e Mon Sep 17 00:00:00 2001
From: Soulter <905617992@qq.com>
Date: Thu, 19 Mar 2026 19:06:30 +0800
Subject: [PATCH 2/2] fix: update whitelist hint

---
 .../src/i18n/locales/en-US/features/config-metadata.json      | 4 ++--
 .../src/i18n/locales/zh-CN/features/config-metadata.json      | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/dashboard/src/i18n/locales/en-US/features/config-metadata.json b/dashboard/src/i18n/locales/en-US/features/config-metadata.json
index b8473dae63..18c78bc829 100644
--- a/dashboard/src/i18n/locales/en-US/features/config-metadata.json
+++ b/dashboard/src/i18n/locales/en-US/features/config-metadata.json
@@ -628,11 +628,11 @@
       "platform_settings": {
         "enable_id_white_list": {
           "description": "Enable Whitelist",
-          "hint": "When enabled, only sessions in the whitelist will be responded to."
+          "hint": "When enabled, only sessions in the whitelist will be responded to. If the whitelist is empty, the whitelist is disabled and all IDs are allowed."
         },
         "id_whitelist": {
           "description": "Whitelist ID List",
-          "hint": "Use /sid to get IDs."
+          "hint": "Use /sid to get IDs. If the list is empty, it means whitelist is disabled (all IDs are in the whitelist)."
         },
         "id_whitelist_log": {
           "description": "Output Logs",
diff --git a/dashboard/src/i18n/locales/zh-CN/features/config-metadata.json b/dashboard/src/i18n/locales/zh-CN/features/config-metadata.json
index e3a52258f3..fd5a2a155c 100644
--- a/dashboard/src/i18n/locales/zh-CN/features/config-metadata.json
+++ b/dashboard/src/i18n/locales/zh-CN/features/config-metadata.json
@@ -631,11 +631,11 @@
       "platform_settings": {
         "enable_id_white_list": {
           "description": "启用白名单",
-          "hint": "启用后,只有在白名单内的会话会被响应。"
+          "hint": "启用后,只有在白名单内的会话会被响应，白名单列表为空时代表不启用白名单（所有 ID 都会被放行）。"
         },
         "id_whitelist": {
           "description": "白名单 ID 列表",
-          "hint": "使用 /sid 获取 ID。"
+          "hint": "使用 /sid 获取 ID。列表为空时表示该白名单不启用（即所有 ID 都在白名单内）。"
         },
         "id_whitelist_log": {
           "description": "输出日志",