V4.25.0

• 更新日志(简体中文)
• Changelog(English)

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

What's Changed

修复

• 修复 Tencent SILK 音频带 \x02 前缀时未被识别，导致后续 ffmpeg 转换失败的问题。（#8009）
• 修复个人微信媒体消息发送失败时错误未向上暴露的问题。（#8175）
• 修复 Claude API 对无参数工具返回 None 参数时工具调用失败的问题。（#8136）
• 修复 register_platform_adapter_type 与 register_permission_type 未正确透传 **kwargs 的问题。（#8141）
• 修复 MiniMax TTS timber weight 配置为空或非法 JSON 时可能导致初始化崩溃的问题。

新功能

• 新增 Ollama Embedding 与 NVIDIA NIM Embedding 提供商适配器。（#8104）
• 新增飞书扫码一键创建能力。（#8191）
• 新增钉钉扫码一键创建能力。（#8198）
• 新增个人微信创建时扫码登录流程，选择个人微信后直接在创建弹窗中显示二维码，登录成功后再保存机器人配置。（#8196）

优化

• 优化个人微信登录态处理：当接口返回 session timeout 时清理旧登录态，避免继续高频请求失效会话。（#8196）
• 优化 AMR 音频转换质量，并复用通用音频转换逻辑简化 Opus 转换实现。（#8153）
• 优化 WebUI 资源选择逻辑：当 data/dist 中的 Dashboard 版本旧于当前核心版本时，优先使用随包内置的 Dashboard，避免旧前端资源造成兼容问题。（#8172）
• Dashboard 新增 Noto Sans 字体支持，改善西里尔文字等多语言文本显示效果。（#8015）
• 优化控制台自动滚动状态同步，刷新后能正确恢复并同步到日志显示组件。（#8186）
• 更新飞书、钉钉、个人微信平台文档，补充扫码创建 / 登录说明、飞书权限开通提醒，以及个人微信新版创建流程。
• 更新 AI 插件开发文档，明确 context.register_llm_tool() 已弃用，并补充 LLM Tool docstring 参数解析要求。（#8178）

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

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)
• 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)
• 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)
• Added Ollama Embedding and NVIDIA NIM Embedding provider adapters. (#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)
• Improved AMR audio conversion quality and simplified Opus conversion by reusing the shared audio conversion path. (#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)
• Added Noto Sans support to the Dashboard for better Cyrillic and multilingual text rendering. (#8015)
• Improved console auto-scroll state synchronization so the restored preference is applied to the log display component after refresh. (#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)

Bug Fixes

• Fixed Tencent SILK audio with a leading \x02 byte not being detected, which could cause ffmpeg conversion failures. (#8009)
• Fixed Personal WeChat media send failures not being surfaced properly. (#8175)
• Fixed tool calls failing when the Claude API returns None arguments for no-parameter tools. (#8136)
• Fixed register_platform_adapter_type and register_permission_type not forwarding **kwargs correctly. (#8141)
• Fixed MiniMax TTS initialization crashes when timber weight config is empty or invalid JSON.