diff --git a/astrbot/cli/__init__.py b/astrbot/cli/__init__.py
index bf4d023cf..9d2b22c72 100644
--- a/astrbot/cli/__init__.py
+++ b/astrbot/cli/__init__.py
@@ -1 +1 @@
-__version__ = "4.25.1"
+__version__ = "4.25.2"
diff --git a/astrbot/core/config/default.py b/astrbot/core/config/default.py
index 2eb1dead9..ac5801994 100644
--- a/astrbot/core/config/default.py
+++ b/astrbot/core/config/default.py
@@ -5,7 +5,7 @@ import os
 from astrbot.core.computer.booters.cua_defaults import CUA_DEFAULT_CONFIG
 from astrbot.core.utils.astrbot_path import get_astrbot_data_path
 
-VERSION = "4.25.1"
+VERSION = "4.25.2"
 DB_PATH = os.path.join(get_astrbot_data_path(), "data_v4.db")
 PERSONAL_WECHAT_CONFIG_METADATA = {
     "weixin_oc_base_url": {
diff --git a/changelogs/v4.25.2.md b/changelogs/v4.25.2.md
new file mode 100644
index 000000000..b77afaf78
--- /dev/null
+++ b/changelogs/v4.25.2.md
@@ -0,0 +1,110 @@
+- [更新日志(简体中文)](#chinese)
+- [Changelog(English)](#english)
+
+<a id="chinese"></a>
+
+## What's Changed
+
+### 新增与优化
+
+- 为知识库加入 Markdown 感知分块器，提升结构化文档导入后的分块质量。([#8151](https://github.com/AstrBotDevs/AstrBot/pull/8151))
+- 新增长期记忆上下文压缩重构，提高记忆整理与续接体验。([#8226](https://github.com/AstrBotDevs/AstrBot/pull/8226))
+- 为 ChatUI 添加指令候选能力，支持自定义唤醒词和悬浮提示。([#8279](https://github.com/AstrBotDevs/AstrBot/pull/8279), [#8353](https://github.com/AstrBotDevs/AstrBot/pull/8353))
+- 为已配置模型增加能力图标，便于识别模型支持的能力。([#8405](https://github.com/AstrBotDevs/AstrBot/pull/8405))
+- 新增小米和 Xiaomi Token Plan LLM 提供商。([#7744](https://github.com/AstrBotDevs/AstrBot/pull/7744))
+- 优化 QQ 官方适配器的消息链媒体拆分和发送逻辑，并透传 QQ webhook 扩展字段。([#8376](https://github.com/AstrBotDevs/AstrBot/pull/8376), [#6274](https://github.com/AstrBotDevs/AstrBot/pull/6274))
+- 为首次通知增加 EULA 提示。([#7955](https://github.com/AstrBotDevs/AstrBot/pull/7955))
+- WebUI 插件卡片新增直接访问按钮，并改善内嵌页面高度。([#8369](https://github.com/AstrBotDevs/AstrBot/pull/8369))
+- 启用平滑 Markdown 流式渲染。([#8371](https://github.com/AstrBotDevs/AstrBot/pull/8371))
+- Dashboard 开发和构建流程自动生成 MDI 图标字体子集。([#8264](https://github.com/AstrBotDevs/AstrBot/pull/8264))
+- 新增修改 AstrBot Dashboard 密码的命令。([#8272](https://github.com/AstrBotDevs/AstrBot/pull/8272))
+- 优化默认 LLM 压缩提示词，使上下文续接更自然。([#8424](https://github.com/AstrBotDevs/AstrBot/pull/8424))
+
+### 修复
+
+- 修复 ChatUI 语音输入录制与上传失效的问题。([#8440](https://github.com/AstrBotDevs/AstrBot/pull/8440))
+- 修复 ChatUI 思考过程标题摘要展示，并让右侧图标保持垂直居中。
+- 修复特定情况下单个插件加载失败会影响其他插件重载的问题，增强失败插件状态清理。([#8441](https://github.com/AstrBotDevs/AstrBot/pull/8441))
+- 修复空 LLM 摘要处理问题。([#8195](https://github.com/AstrBotDevs/AstrBot/pull/8195))
+- 修复 RST 和 AsciiDoc 知识库上传支持。([#8255](https://github.com/AstrBotDevs/AstrBot/pull/8255))
+- 修复 T2I Shiki 相关问题。([#8013](https://github.com/AstrBotDevs/AstrBot/pull/8013))
+- 修复流式响应 `delta=None` 分块导致 SDK `to_dict()` 报错的问题。([#8244](https://github.com/AstrBotDevs/AstrBot/pull/8244))
+- 修复 skills_like 工具重新查询时未保留原始 `completion_text` 的问题。([#8240](https://github.com/AstrBotDevs/AstrBot/pull/8240))
+- 修复 OpenAI 流式响应末尾 usage 信息丢失的问题。([#8306](https://github.com/AstrBotDevs/AstrBot/pull/8306))
+- 修复 macOS 上 SQLAlchemy 兼容性问题。([#7724](https://github.com/AstrBotDevs/AstrBot/pull/7724))
+- 修复 WebUI 移动端 Provider Source 删除能力。([#8321](https://github.com/AstrBotDevs/AstrBot/pull/8321))
+- 修复 Mimo voice design 模型请求包含无效 voice 参数的问题。([#8326](https://github.com/AstrBotDevs/AstrBot/pull/8326))
+- 修复 Mimo reasoning content 相关问题。([#8327](https://github.com/AstrBotDevs/AstrBot/pull/8327))
+- 修复 Anthropic API `tool_choice` schema 转换问题。([#8328](https://github.com/AstrBotDevs/AstrBot/pull/8328))
+- 修复插件 metadata repo 字段类型保护。([#8207](https://github.com/AstrBotDevs/AstrBot/pull/8207))
+- 修复核心图片请求路由到视觉 fallback 的问题。([#8089](https://github.com/AstrBotDevs/AstrBot/pull/8089))
+- 修复文件组件中的文件名清理。([#8318](https://github.com/AstrBotDevs/AstrBot/pull/8318))
+- 修复 Dashboard 子命令数量标签和插件重复展示问题。([#8388](https://github.com/AstrBotDevs/AstrBot/pull/8388), [#8389](https://github.com/AstrBotDevs/AstrBot/pull/8389))
+- 修复无专用图片描述 provider 时，多模态主 provider 重复处理引用图片的问题。([#8401](https://github.com/AstrBotDevs/AstrBot/pull/8401))
+- 修复分段回复中多余空行问题。([#8304](https://github.com/AstrBotDevs/AstrBot/pull/8304))
+- 修复插件市场插件名称与本地插件名称不一致的问题。([#8276](https://github.com/AstrBotDevs/AstrBot/pull/8276))
+- 修复 Dashboard 列表配置项无法输入空格的问题。([#8403](https://github.com/AstrBotDevs/AstrBot/pull/8403))
+- 修复 stale command hints 相关问题。([#8245](https://github.com/AstrBotDevs/AstrBot/pull/8245))
+- 改善 `SendMessageToUserTool` 的描述。([commit](https://github.com/AstrBotDevs/AstrBot/commit/49036f8f9))
+
+### 文档与工程
+
+- 更新 release 版本发布说明。([commit](https://github.com/AstrBotDevs/AstrBot/commit/dceacd5a8))
+- 更新 FAQ 中 Dashboard 下载链接、强制刷新说明和删除数量说明。([#8359](https://github.com/AstrBotDevs/AstrBot/pull/8359), [#8235](https://github.com/AstrBotDevs/AstrBot/pull/8235), [commit](https://github.com/AstrBotDevs/AstrBot/commit/61b6813dc))
+- 修正文档中的 QQ 官方 WebSocket 机器人中文说明 typo。([#8351](https://github.com/AstrBotDevs/AstrBot/pull/8351))
+- 更新 GitHub Actions 依赖。([#8233](https://github.com/AstrBotDevs/AstrBot/pull/8233), [#8335](https://github.com/AstrBotDevs/AstrBot/pull/8335))
+- 移除无用日志。([commit](https://github.com/AstrBotDevs/AstrBot/commit/9fc03fa95))
+
+<a id="english"></a>
+
+## What's Changed (EN)
+
+### Features and Improvements
+
+- Added a Markdown-aware knowledge base chunker for better structured document ingestion. ([#8151](https://github.com/AstrBotDevs/AstrBot/pull/8151))
+- Redesigned long-term memory with context compaction for better memory continuity. ([#8226](https://github.com/AstrBotDevs/AstrBot/pull/8226))
+- Added ChatUI command suggestions, including custom wake-up words and hover information. ([#8279](https://github.com/AstrBotDevs/AstrBot/pull/8279), [#8353](https://github.com/AstrBotDevs/AstrBot/pull/8353))
+- Added capability icons for configured models. ([#8405](https://github.com/AstrBotDevs/AstrBot/pull/8405))
+- Added Xiaomi and Xiaomi Token Plan LLM providers. ([#7744](https://github.com/AstrBotDevs/AstrBot/pull/7744))
+- Improved QQ Official media-chain splitting and message sending, and passed through QQ webhook extra fields. ([#8376](https://github.com/AstrBotDevs/AstrBot/pull/8376), [#6274](https://github.com/AstrBotDevs/AstrBot/pull/6274))
+- Added an EULA hint for the first notification. ([#7955](https://github.com/AstrBotDevs/AstrBot/pull/7955))
+- Added direct access buttons on WebUI plugin cards and improved embedded page height. ([#8369](https://github.com/AstrBotDevs/AstrBot/pull/8369))
+- Enabled smooth Markdown streaming. ([#8371](https://github.com/AstrBotDevs/AstrBot/pull/8371))
+- Automated MDI icon font subsetting during Dashboard dev and build workflows. ([#8264](https://github.com/AstrBotDevs/AstrBot/pull/8264))
+- Added a command to change the AstrBot Dashboard password. ([#8272](https://github.com/AstrBotDevs/AstrBot/pull/8272))
+- Improved the default LLM compression prompt for better continuity. ([#8424](https://github.com/AstrBotDevs/AstrBot/pull/8424))
+
+### Bug Fixes
+
+- Fixed ChatUI voice recording and upload. ([#8440](https://github.com/AstrBotDevs/AstrBot/pull/8440))
+- Fixed ChatUI reasoning summary labels and centered the right-side icon vertically.
+- Fixed plugin reload failures where one plugin load failure could leave stale state and break other plugin reloads. ([#8441](https://github.com/AstrBotDevs/AstrBot/pull/8441))
+- Fixed empty LLM summaries. ([#8195](https://github.com/AstrBotDevs/AstrBot/pull/8195))
+- Fixed RST and AsciiDoc knowledge uploads. ([#8255](https://github.com/AstrBotDevs/AstrBot/pull/8255))
+- Fixed T2I Shiki issues. ([#8013](https://github.com/AstrBotDevs/AstrBot/pull/8013))
+- Fixed `delta=None` streaming chunks that could trigger SDK `to_dict()` errors. ([#8244](https://github.com/AstrBotDevs/AstrBot/pull/8244))
+- Preserved original `completion_text` in skills_like tool re-query. ([#8240](https://github.com/AstrBotDevs/AstrBot/pull/8240))
+- Fixed missing final usage metadata in OpenAI streaming responses. ([#8306](https://github.com/AstrBotDevs/AstrBot/pull/8306))
+- Fixed SQLAlchemy compatibility issues on macOS. ([#7724](https://github.com/AstrBotDevs/AstrBot/pull/7724))
+- Restored mobile Provider Source deletion in the WebUI. ([#8321](https://github.com/AstrBotDevs/AstrBot/pull/8321))
+- Fixed invalid voice parameters in Mimo voice design model requests. ([#8326](https://github.com/AstrBotDevs/AstrBot/pull/8326))
+- Fixed Mimo reasoning content handling. ([#8327](https://github.com/AstrBotDevs/AstrBot/pull/8327))
+- Fixed Anthropic API `tool_choice` schema conversion. ([#8328](https://github.com/AstrBotDevs/AstrBot/pull/8328))
+- Added a type guard for plugin metadata repo values. ([#8207](https://github.com/AstrBotDevs/AstrBot/pull/8207))
+- Fixed core image request routing to vision fallback. ([#8089](https://github.com/AstrBotDevs/AstrBot/pull/8089))
+- Sanitized file names in file components. ([#8318](https://github.com/AstrBotDevs/AstrBot/pull/8318))
+- Fixed Dashboard sub-command count labels and duplicate plugin display. ([#8388](https://github.com/AstrBotDevs/AstrBot/pull/8388), [#8389](https://github.com/AstrBotDevs/AstrBot/pull/8389))
+- Prevented duplicate processing of quoted images by multimodal main providers when no dedicated image caption provider is configured. ([#8401](https://github.com/AstrBotDevs/AstrBot/pull/8401))
+- Removed extra blank lines in segmented replies. ([#8304](https://github.com/AstrBotDevs/AstrBot/pull/8304))
+- Fixed plugin name mismatches between the marketplace and local plugins. ([#8276](https://github.com/AstrBotDevs/AstrBot/pull/8276))
+- Fixed Dashboard list config items being unable to input spaces. ([#8403](https://github.com/AstrBotDevs/AstrBot/pull/8403))
+- Fixed stale command hints. ([#8245](https://github.com/AstrBotDevs/AstrBot/pull/8245))
+- Improved the `SendMessageToUserTool` description. ([commit](https://github.com/AstrBotDevs/AstrBot/commit/49036f8f9))
+
+### Documentation and Maintenance
+
+- Updated release version instructions. ([commit](https://github.com/AstrBotDevs/AstrBot/commit/dceacd5a8))
+- Updated FAQ Dashboard download links, hard refresh instructions, and deletion count wording. ([#8359](https://github.com/AstrBotDevs/AstrBot/pull/8359), [#8235](https://github.com/AstrBotDevs/AstrBot/pull/8235), [commit](https://github.com/AstrBotDevs/AstrBot/commit/61b6813dc))
+- Fixed a typo in the Chinese QQ Official WebSocket bot setup documentation. ([#8351](https://github.com/AstrBotDevs/AstrBot/pull/8351))
+- Updated GitHub Actions dependencies. ([#8233](https://github.com/AstrBotDevs/AstrBot/pull/8233), [#8335](https://github.com/AstrBotDevs/AstrBot/pull/8335))
+- Removed unused logs. ([commit](https://github.com/AstrBotDevs/AstrBot/commit/9fc03fa95))
diff --git a/pyproject.toml b/pyproject.toml
index c3ff88b74..06fca70f8 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "AstrBot"
-version = "4.25.1"
+version = "4.25.2"
 description = "Easy-to-use multi-platform LLM chatbot and development framework"
 readme = "README.md"
 license = { text = "AGPL-3.0-or-later" }