- [更新日志(简体中文)](#chinese)
- [Changelog(English)](#english)

<a id="chinese"></a>

## What's Changed

### 优化

- Dashboard 更新流程新增两阶段下载进度，升级项目时会先下载 WebUI，再下载项目代码，并在界面中展示每个阶段的进度。
- 新增更新后重启等待体验：WebUI 会在更新前记录 AstrBot 启动时间，更新完成后展示正在重启状态，并轮询启动时间变化后自动刷新页面。
- 新增 `ASTRBOT_DASHBOARD_INITIAL_PASSWORD` 环境变量，可为首次生成的 Dashboard 密码指定初始值。
- `astrbot init` 现在会识别 `ASTRBOT_DASHBOARD_INITIAL_PASSWORD`，并在初始化阶段创建 `data/cmd_config.json` 写入哈希后的初始密码，便于自动化部署。
- 优化 Dashboard 更新项目弹窗，减少对用户无用的信息，保留独立更新 WebUI 到最新版本的兜底入口，并将其收起到高级设置中。
- 优化 Release 列表加载状态和预发布版本提示逻辑：Release 未加载完成时显示表格 loading，第一页没有预发布版本时不再显示提醒。
- 优化升级后旧版 Dashboard 密码登录失败时的提示，引导用户参考 FAQ 处理升级后密码正确但无法登录的情况。
- 更新 FAQ 文档，补充升级后密码正确但无法登录时可删除 `data/dist` 后重启 AstrBot 的处理方案。

### 修复

- 修复 Shipyard Neo 在显式配置 profile 时可能未正确尊重该配置的问题。（[#8167](https://github.com/AstrBotDevs/AstrBot/pull/8167)）
- 修复 `message_tools` 在目标路径不存在时未抛出异常并阻止消息发送的问题。（[#8149](https://github.com/AstrBotDevs/AstrBot/pull/8149)）

<a id="english"></a>

## What's Changed (EN)

### Improvements

- Added two-stage download progress to the Dashboard update flow. Project upgrades now download the WebUI first, then the core project code, with per-stage progress shown in the UI.
- Added a restart-waiting experience after updates. The WebUI records AstrBot's start time before updating, shows a restarting state after the update completes, polls for a changed start time, and refreshes automatically.
- Added the `ASTRBOT_DASHBOARD_INITIAL_PASSWORD` environment variable to specify the first generated Dashboard password.
- `astrbot init` now recognizes `ASTRBOT_DASHBOARD_INITIAL_PASSWORD` and creates `data/cmd_config.json` during initialization with the hashed initial password, making automated deployments easier.
- Improved the Dashboard project update dialog by hiding low-value details, keeping the standalone WebUI update fallback, and moving it under Advanced Settings.
- Improved Release list loading and prerelease notices: the table now shows a loading state before releases are loaded, and the prerelease warning is hidden when the first page has no prerelease entries.
- Improved the login failure message for legacy Dashboard password upgrade cases, guiding users to the FAQ when a correct password no longer works after upgrading.
- Updated the FAQ with recovery steps for upgrade cases where the correct password cannot log in: delete `data/dist` and restart AstrBot.

### Bug Fixes

- Fixed Shipyard Neo so explicit profile configuration is respected. ([#8167](https://github.com/AstrBotDevs/AstrBot/pull/8167))
- Fixed `message_tools` so missing target paths raise an exception and block message sending. ([#8149](https://github.com/AstrBotDevs/AstrBot/pull/8149))
