登录问题排查：密码重置与面板 404 处理
登录相关的故障就四类，每类按部署方式对号入座。
一、初始密码找不到
初始密码每次全新启动随机生成，没有默认值。去启动日志里找带 ✨ 横幅的那段，Initial password 字样后面就是。各部署方式的日志位置：
- Docker：docker logs astrbot
- uv / pip / 源码 / 启动器：启动时的终端输出
- 桌面客户端：客户端日志界面
注意横幅只在生成新密码时打印。如果之前已经登录改过密码，日志里那段不再出现——那是第二类问题。
二、忘记密码（已改过）
三条路按部署方式选：
Docker 部署——容器内置 CLI：
sudo docker exec -it astrbot astrbot password
sudo docker restart astrbot同时改用户名加 --username 新用户名。第一个 astrbot 是容器名，不对就用 docker ps 查。
uv / pip 部署——在当初 astrbot init 的工作目录里执行：
astrbot password其他部署方式（源码、面板类等）——改配置文件。打开 data/cmd_config.json 找到 dashboard 字段，把 username、password、pbkdf2_password、password_storage_upgraded、password_change_required、jwt_secret 六个字段连同值一起删除，保存重启。程序会重新生成随机密码并打印在日志里，用户名回到 astrbot。
改完密码都要重启才生效。
三、升级后密码正确却登不进
旧版 WebUI 静态文件缓存与新版后端不兼容所致：
- 停止程序
- 删除 data 目录下的 dist 文件夹
- 重启（程序会重新拉取匹配当前版本的界面文件）
- 浏览器强制刷新：Ctrl+Shift+R（Mac 用 Cmd+Shift+R）
四、面板打开是 404
WebUI 静态文件没就位：
- 到项目 Releases 页下载 dist.zip（dashboard 命名的压缩包）
- 解压到 data 目录下
- 重启程序
还不行——重启电脑（官方 FAQ 原样收录的社区偏方，真实有效过）。