From 02291a3217c92faa0c577bf9d89076949c40954c Mon Sep 17 00:00:00 2001
From: Soulter <905617992@qq.com>
Date: Sat, 16 May 2026 01:39:02 +0800
Subject: [PATCH] chore: bump version to 4.25.0
---
astrbot/cli/__init__.py | 2 +-
astrbot/core/config/default.py | 2 +-
changelogs/v4.25.0.md | 61 ++++++++++++++++++++++++++++++++++
pyproject.toml | 2 +-
4 files changed, 64 insertions(+), 3 deletions(-)
create mode 100644 changelogs/v4.25.0.md
diff --git a/astrbot/cli/__init__.py b/astrbot/cli/__init__.py
index 9a9d305f3..8900bf5ca 100644
--- a/astrbot/cli/__init__.py
+++ b/astrbot/cli/__init__.py
@@ -1 +1 @@
-__version__ = "4.24.5"
+__version__ = "4.25.0"
diff --git a/astrbot/core/config/default.py b/astrbot/core/config/default.py
index 7f6881ba7..7f7140a9c 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.24.5"
+VERSION = "4.25.0"
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.0.md b/changelogs/v4.25.0.md
new file mode 100644
index 000000000..29e1745be
--- /dev/null
+++ b/changelogs/v4.25.0.md
@@ -0,0 +1,61 @@
+- [更新日志(简体中文)](#chinese)
+- [Changelog(English)](#english)
+
+
+
+## What's Changed
+
+### 修复
+
+- 修复 Tencent SILK 音频带 `\x02` 前缀时未被识别，导致后续 ffmpeg 转换失败的问题。（[#8009](https://github.com/AstrBotDevs/AstrBot/pull/8009)）
+- 修复个人微信媒体消息发送失败时错误未向上暴露的问题。（[#8175](https://github.com/AstrBotDevs/AstrBot/pull/8175)）
+- 修复 Claude API 对无参数工具返回 `None` 参数时工具调用失败的问题。（[#8136](https://github.com/AstrBotDevs/AstrBot/pull/8136)）
+- 修复 `register_platform_adapter_type` 与 `register_permission_type` 未正确透传 `**kwargs` 的问题。（[#8141](https://github.com/AstrBotDevs/AstrBot/pull/8141)）
+- 修复 MiniMax TTS timber weight 配置为空或非法 JSON 时可能导致初始化崩溃的问题。
+
+### 新功能
+
+- 新增 Ollama Embedding 与 NVIDIA NIM Embedding 提供商适配器。（[#8104](https://github.com/AstrBotDevs/AstrBot/pull/8104)）
+- 新增飞书扫码一键创建能力。（[#8191](https://github.com/AstrBotDevs/AstrBot/pull/8191)）
+- 新增钉钉扫码一键创建能力。（[#8198](https://github.com/AstrBotDevs/AstrBot/pull/8198)）
+- 新增个人微信创建时扫码登录流程，选择个人微信后直接在创建弹窗中显示二维码，登录成功后再保存机器人配置。（[#8196](https://github.com/AstrBotDevs/AstrBot/pull/8196)）
+
+### 优化
+
+- 优化个人微信登录态处理：当接口返回 session timeout 时清理旧登录态，避免继续高频请求失效会话。（[#8196](https://github.com/AstrBotDevs/AstrBot/pull/8196)）
+- 优化 AMR 音频转换质量，并复用通用音频转换逻辑简化 Opus 转换实现。（[#8153](https://github.com/AstrBotDevs/AstrBot/pull/8153)）
+- 优化 WebUI 资源选择逻辑：当 `data/dist` 中的 Dashboard 版本旧于当前核心版本时，优先使用随包内置的 Dashboard，避免旧前端资源造成兼容问题。（[#8172](https://github.com/AstrBotDevs/AstrBot/pull/8172)）
+- Dashboard 新增 Noto Sans 字体支持，改善西里尔文字等多语言文本显示效果。（[#8015](https://github.com/AstrBotDevs/AstrBot/pull/8015)）
+- 优化控制台自动滚动状态同步，刷新后能正确恢复并同步到日志显示组件。（[#8186](https://github.com/AstrBotDevs/AstrBot/pull/8186)）
+- 更新飞书、钉钉、个人微信平台文档，补充扫码创建 / 登录说明、飞书权限开通提醒，以及个人微信新版创建流程。
+- 更新 AI 插件开发文档，明确 `context.register_llm_tool()` 已弃用，并补充 LLM Tool docstring 参数解析要求。（[#8178](https://github.com/AstrBotDevs/AstrBot/pull/8178)）
+
+
+
+
+## What's Changed (EN)
+
+### New Features
+
+- Added one-click QR setup for Feishu / Lark. When creating a bot, users can choose Feishu China or Lark Global, scan the QR code, and automatically fill `app_id`, `app_secret`, and domain settings. AstrBot also fetches the bot name for the generated config ID display. ([#8191](https://github.com/AstrBotDevs/AstrBot/pull/8191))
+- Added one-click QR setup for DingTalk. Users can create or bind a DingTalk app by scanning a QR code, automatically filling `ClientID` and `ClientSecret`, while manual setup remains available. ([#8198](https://github.com/AstrBotDevs/AstrBot/pull/8198))
+- Added QR login during Personal WeChat bot creation. The creation dialog now shows the login QR code directly and allows saving after login succeeds. ([#8196](https://github.com/AstrBotDevs/AstrBot/pull/8196))
+- Added Ollama Embedding and NVIDIA NIM Embedding provider adapters. ([#8104](https://github.com/AstrBotDevs/AstrBot/pull/8104))
+
+### Improvements
+
+- Improved Personal WeChat login-state handling by clearing stale login state when the API reports session timeout, avoiding repeated requests against an invalid session. ([#8196](https://github.com/AstrBotDevs/AstrBot/pull/8196))
+- Improved AMR audio conversion quality and simplified Opus conversion by reusing the shared audio conversion path. ([#8153](https://github.com/AstrBotDevs/AstrBot/pull/8153))
+- Improved WebUI asset selection: when `data/dist` contains a Dashboard older than the current core version, AstrBot now prefers the bundled Dashboard to avoid stale frontend compatibility issues. ([#8172](https://github.com/AstrBotDevs/AstrBot/pull/8172))
+- Added Noto Sans support to the Dashboard for better Cyrillic and multilingual text rendering. ([#8015](https://github.com/AstrBotDevs/AstrBot/pull/8015))
+- Improved console auto-scroll state synchronization so the restored preference is applied to the log display component after refresh. ([#8186](https://github.com/AstrBotDevs/AstrBot/pull/8186))
+- Updated Feishu / Lark, DingTalk, and Personal WeChat platform docs with QR setup / login instructions, Feishu permission reminders, and the new Personal WeChat creation flow.
+- Updated the AI plugin development guide to clarify that `context.register_llm_tool()` is deprecated and to document the required LLM Tool docstring argument format. ([#8178](https://github.com/AstrBotDevs/AstrBot/pull/8178))
+
+### Bug Fixes
+
+- Fixed Tencent SILK audio with a leading `\x02` byte not being detected, which could cause ffmpeg conversion failures. ([#8009](https://github.com/AstrBotDevs/AstrBot/pull/8009))
+- Fixed Personal WeChat media send failures not being surfaced properly. ([#8175](https://github.com/AstrBotDevs/AstrBot/pull/8175))
+- Fixed tool calls failing when the Claude API returns `None` arguments for no-parameter tools. ([#8136](https://github.com/AstrBotDevs/AstrBot/pull/8136))
+- Fixed `register_platform_adapter_type` and `register_permission_type` not forwarding `**kwargs` correctly. ([#8141](https://github.com/AstrBotDevs/AstrBot/pull/8141))
+- Fixed MiniMax TTS initialization crashes when timber weight config is empty or invalid JSON.
diff --git a/pyproject.toml b/pyproject.toml
index 16055d72f..22a5904a1 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "AstrBot"
-version = "4.24.5"
+version = "4.25.0"
description = "Easy-to-use multi-platform LLM chatbot and development framework"
readme = "README.md"
license = { text = "AGPL-3.0-or-later" }