[Bug]Astr launcher内置的webUI部分页面加载不出来（如插件页面全部、知识库、人格设定，更多功能；模型提供商、配置文件可以）

[HunterJuly]

What happened / 发生了什么

[Bug]Astr launcher内置的WebUI部分页面加载不出来（如插件页面全部、知识库、人格设定，更多功能；模型提供商、配置文件可以）
显示为一直读蓝条，出不来后续。
但是使用地址：端口的方式在手机或电脑浏览器打开的WebUI所有页面均可正常打开。
使用不同版本的launcher均是如此，从v4.24.1到最新的v4.24.5，甚至在首次使用最新的v4.24.5时出现启动超时的情况。但之前是v4.23没出现这种情况。
在页面卡蓝条时，后台日志并未输出任何前端相关的 ERROR 报错。

Reproduce / 如何复现？

在AstrBot Launcher打开示例，进入WebUI页面，点击（如插件页面全部、知识库、人格设定，更多功能）都是读蓝条，没有显示。用地址：端口的形式都能打开，且QQ测试正常回复应答，仅webUI特定页面无法打开。

AstrBot version, deployment method (e.g., Windows Docker Desktop deployment), provider used, and messaging platform used. / AstrBot 版本、部署方式（如 Windows Docker Desktop 部署）、使用的提供商、使用的消息平台适配器

操作系统：Windows Server 2019 DataCenter 64bit CN（腾讯云轻量服务器，服务器在日本）。
硬件配置：2核 2GB 内存（开启了 4G 虚拟内存）。
使用AstrBot Launcher：v0.3.5
napcat一键部署，一切正常

OS

Windows

Logs / 报错日志

[日志已深度脱敏处理]
[23:42:38.480] [Core] [INFO] [core.core_lifecycle:148]: AstrBot v4.24.1
[23:42:38.712] [Core] [INFO] [core.persona_mgr:38]: Loaded 3 personas.
... (中间插件加载过程正常，伴有版本兼容的WARN警告) ...
[23:42:50.199] [Core] [WARN] [v4.24.1] [star.star_manager:995]: 插件 astrbot_plugin_web_analyzer 元数据载入失败: 'StarMetadata' object has no attribute 'pages'。使用默认元数据。
...
[23:42:51.875] [Core] [INFO] [core.plugin_initializer:134]: Provider check passed: embedding and llm providers are ready.
[23:42:51.876] [Core] [INFO] [core.plugin_initializer:296]: 开始完整初始化流程...
[23:42:52.080] [Core] [INFO] [core.plugin_initializer:570]: 索引一致性检查通过: 索引状态正常
[23:42:53.157] [Core] [INFO] [dashboard.server:421]: Starting WebUI at http://0.0.0.0:[WebUI端口]
[23:42:54.169] [Core] [INFO] [dashboard.server:460]:
✨✨✨
AstrBot v4.24.1 WebUI is ready
➜ Local: http://localhost:[WebUI端口]
➜ Network: http://[内网IP]:[WebUI端口]
➜ Network: http://[本地IP]:[WebUI端口]
✨✨✨
[23:42:54.170] [Core] [INFO] [core.core_lifecycle:341]: AstrBot started.
[2026-05-15 23:42:54 +0800] [1236] [INFO] Running on http://0.0.0.0:[WS通信端口] (CTRL + C to quit)
[2026-05-15 23:42:54 +0800] [1236] [INFO] Running on http://0.0.0.0:[WebUI端口] (CTRL + C to quit)
INFO: Started server process [1236]
INFO: Waiting for application startup.
INFO: Application startup complete.
INFO: Uvicorn running on http://[本地IP]:8888 (Press CTRL+C to quit)
[23:42:55.365] [Core] [INFO] [webui.server:157]: WebUI 已启动: http://[本地IP]:8888
[23:42:57.509] [Core] [INFO] [aiocqhttp.aiocqhttp_platform_adapter:107]: aiocqhttp(OneBot v11) 适配器已连接。

Are you willing to submit a PR? / 你愿意提交 PR 吗？

• Yes!

Code of Conduct

• I have read and agree to abide by the project's Code of Conduct。

[dosubot]

这是一个 v4.24.x 已知的 WebUI 缓存兼容性问题。v4.24.x 对前后端架构做了较大调整（包括插件页面功能引入了 StarMetadata.pages 属性等），Launcher 内置浏览器的缓存中仍是旧版前端资源，导致与新后端 API 不兼容，部分页面加载卡住。而用外部浏览器访问时缓存较新，所以正常。

建议的修复步骤：

1. 删除 data/dist 目录并重启 AstrBot（最关键）—— 让 AstrBot 重新下载与当前版本匹配的 WebUI 资源 [1]
2. 如果 Launcher 有清除内置浏览器缓存的选项，也建议清除一下
3. 日志中的 'StarMetadata' object has no attribute 'pages' 是 astrbot_plugin_web_analyzer 插件的旧元数据与 v4.24.x 新增的 pages 字段不兼容所致 [2]，可以尝试卸载并重新安装该插件

删除 data/dist 后重启是 v4.24.x WebUI 问题的标准解决方案，多个类似报告都通过此方法解决 [3]。

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.

[NayukiChiba]

删除dist文件夹，然后重启试一下