AstrBot/changelogs/v4.25.0.md

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

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

## 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)）


<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](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.