feat(auth): add legacy password login failure message and FAQ guidance for upgrade issues

docs/en/faq.md

@@ -70,6 +70,18 @@ The segment should look like:
 
 After restart, AstrBot will automatically generate a random password with the fixed username `astrbot`; check the startup logs.
 
+### Correct Password Cannot Log In After Upgrading AstrBot
+
+If you are sure the dashboard password is correct but still cannot log in after upgrading AstrBot, the old WebUI static files may be incompatible with the newer backend.
+
+Solution:
+
+1. Stop AstrBot.
+2. Delete the `dist` folder under AstrBot's `data` directory: `AstrBot/data/dist`.
+3. Restart AstrBot.
+
+After restart, AstrBot will reload or download WebUI files that match the current version.
+
 ## Bot Core Related
 
 ### How to Let AstrBot Control My Mac / Windows / Linux Computer?

docs/zh/faq.md

@@ -71,6 +71,18 @@ Set dashboard.host in data/cmd_config.json to enable remote access.
 
 重启后 AstrBot 将会自动生成随机的密码以及固定的用户名 `astrbot`，请在日志查看。
 
+### 升级 AstrBot 后密码正确但无法登录
+
+如果你确认管理面板密码正确，但升级 AstrBot 后仍然无法登录，可能是旧版 WebUI 静态文件缓存与新版后端不兼容。
+
+解决方案：
+
+1. 停止 AstrBot。
+2. 删除 AstrBot 的 `data` 目录下的 `dist` 文件夹，即 `AstrBot/data/dist`。
+3. 重新启动 AstrBot。
+
+重启后，AstrBot 会重新加载或下载匹配当前版本的 WebUI 文件。
+
 ## AstrBot 使用相关
 
 ### 如何让 AstrBot 控制我的 Mac / Windows / Linux 电脑？