This release includes breaking changes for platform teams planning a safe upgrade.
✓ No known CVEs patched in this version
Topics
+8 more
ReleasePort's take
Light signalVersion v4.25.2 of AstrBot adds several UI features and resolves multiple bugs across the platform.
Why it matters: Addresses ChatUI voice upload failures, OpenAI streaming metadata loss, and SQLAlchemy macOS compatibility—critical for uninterrupted operation.
Summary
AI summaryBroad release touches Documentation and Maintenance, 修复, Bug Fixes, and 新增与优化.
Changes in this release
| Type | Severity | Summary | CVE |
|---|---|---|---|
| Feature | Medium |
Adds command to change AstrBot Dashboard password. Adds command to change AstrBot Dashboard password. Source: llm_adapter@2026-05-30 Confidence: high |
— |
| Feature | Medium |
Adds Markdown‑aware knowledge base chunker for structured documents. Adds Markdown‑aware knowledge base chunker for structured documents. Source: llm_adapter@2026-05-30 Confidence: high |
— |
| Feature | Medium |
Adds capability icons for configured models. Adds capability icons for configured models. Source: llm_adapter@2026-05-30 Confidence: high |
— |
| Feature | Medium |
Adds Xiaomi and Xiaomi Token Plan LLM providers. Adds Xiaomi and Xiaomi Token Plan LLM providers. Source: llm_adapter@2026-05-30 Confidence: high |
— |
| Feature | Medium |
Enables smooth Markdown streaming. Enables smooth Markdown streaming. Source: llm_adapter@2026-05-30 Confidence: high |
— |
| Feature | Medium |
Improves default LLM compression prompt for better continuity. Improves default LLM compression prompt for better continuity. Source: llm_adapter@2026-05-30 Confidence: high |
— |
| Bugfix | Medium |
Fixes ChatUI voice recording and upload failure. Fixes ChatUI voice recording and upload failure. Source: llm_adapter@2026-05-30 Confidence: high |
— |
| Bugfix | Medium |
Fixes empty LLM summary handling. Fixes empty LLM summary handling. Source: llm_adapter@2026-05-30 Confidence: high |
— |
| Bugfix | Medium |
Fixes missing usage metadata in OpenAI streaming responses. Fixes missing usage metadata in OpenAI streaming responses. Source: llm_adapter@2026-05-30 Confidence: high |
— |
| Bugfix | Medium |
Fixes SQLAlchemy compatibility issues on macOS. Fixes SQLAlchemy compatibility issues on macOS. Source: llm_adapter@2026-05-30 Confidence: high |
— |
Full changelog
What's Changed
新增与优化
- 启用平滑 Markdown 流式渲染。(#8371)
- 优化群聊上下文感知的缓存命中率。(#8226)
- 为知识库加入 Markdown 感知分块器,提升结构化文档导入后的分块质量。(#8151)
- 为 ChatUI 添加指令候选能力,支持自定义唤醒词和悬浮提示。(#8279, #8353)
- 为已配置模型增加能力图标,便于识别模型支持的能力。(#8405)
- 新增小米和 Xiaomi Token Plan LLM 提供商。(#7744)
- 优化 QQ 官方适配器的消息链媒体拆分和发送逻辑,并透传 QQ webhook 扩展字段。(#8376, #6274)
- 为首次通知增加 EULA 提示。(#7955)
- WebUI 插件卡片新增直接访问按钮,并改善内嵌页面高度。(#8369)
- Dashboard 开发和构建流程自动生成 MDI 图标字体子集。(#8264)
- 新增修改 AstrBot Dashboard 密码的命令。(#8272)
- 优化默认 LLM 压缩提示词,使上下文续接更自然。(#8424)
修复
- 修复 ChatUI 语音输入录制与上传失效的问题。(#8440)
- 修复 ChatUI 思考过程标题摘要展示,并让右侧图标保持垂直居中。
- 修复特定情况下单个插件加载失败会影响其他插件重载的问题,增强失败插件状态清理。(#8441)
- 修复空 LLM 摘要处理问题。(#8195)
- 修复 RST 和 AsciiDoc 知识库上传支持。(#8255)
- 修复 T2I Shiki 相关问题。(#8013)
- 修复流式响应
delta=None分块导致 SDKto_dict()报错的问题。(#8244) - 修复 skills_like 工具重新查询时未保留原始
completion_text的问题。(#8240) - 修复 OpenAI 流式响应末尾 usage 信息丢失的问题。(#8306)
- 修复 macOS 上 SQLAlchemy 兼容性问题。(#7724)
- 修复 WebUI 移动端 Provider Source 删除能力。(#8321)
- 修复 Mimo voice design 模型请求包含无效 voice 参数的问题。(#8326)
- 修复 Mimo reasoning content 相关问题。(#8327)
- 修复 Anthropic API
tool_choiceschema 转换问题。(#8328) - 修复插件 metadata repo 字段类型保护。(#8207)
- 修复核心图片请求路由到视觉 fallback 的问题。(#8089)
- 修复文件组件中的文件名清理。(#8318)
- 修复 Dashboard 子命令数量标签和插件重复展示问题。(#8388, #8389)
- 修复无专用图片描述 provider 时,多模态主 provider 重复处理引用图片的问题。(#8401)
- 修复分段回复中多余空行问题。(#8304)
- 修复插件市场插件名称与本地插件名称不一致的问题。(#8276)
- 修复 Dashboard 列表配置项无法输入空格的问题。(#8403)
- 修复 stale command hints 相关问题。(#8245)
- 改善
SendMessageToUserTool的描述。(commit)
文档与工程
- 更新 release 版本发布说明。(commit)
- 更新 FAQ 中 Dashboard 下载链接、强制刷新说明和删除数量说明。(#8359, #8235, commit)
- 修正文档中的 QQ 官方 WebSocket 机器人中文说明 typo。(#8351)
- 更新 GitHub Actions 依赖。(#8233, #8335)
- 移除无用日志。(commit)
What's Changed (EN)
Features and Improvements
- Added a Markdown-aware knowledge base chunker for better structured document ingestion. (#8151)
- Added ChatUI command suggestions, including custom wake-up words and hover information. (#8279, #8353)
- Added capability icons for configured models. (#8405)
- Added Xiaomi and Xiaomi Token Plan LLM providers. (#7744)
- Improved QQ Official media-chain splitting and message sending, and passed through QQ webhook extra fields. (#8376, #6274)
- Added an EULA hint for the first notification. (#7955)
- Added direct access buttons on WebUI plugin cards and improved embedded page height. (#8369)
- Enabled smooth Markdown streaming. (#8371)
- Automated MDI icon font subsetting during Dashboard dev and build workflows. (#8264)
- Added a command to change the AstrBot Dashboard password. (#8272)
- Improved the default LLM compression prompt for better continuity. (#8424)
Bug Fixes
- Fixed ChatUI voice recording and upload. (#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)
- Fixed empty LLM summaries. (#8195)
- Fixed RST and AsciiDoc knowledge uploads. (#8255)
- Fixed T2I Shiki issues. (#8013)
- Fixed
delta=Nonestreaming chunks that could trigger SDKto_dict()errors. (#8244) - Preserved original
completion_textin skills_like tool re-query. (#8240) - Fixed missing final usage metadata in OpenAI streaming responses. (#8306)
- Fixed SQLAlchemy compatibility issues on macOS. (#7724)
- Restored mobile Provider Source deletion in the WebUI. (#8321)
- Fixed invalid voice parameters in Mimo voice design model requests. (#8326)
- Fixed Mimo reasoning content handling. (#8327)
- Fixed Anthropic API
tool_choiceschema conversion. (#8328) - Added a type guard for plugin metadata repo values. (#8207)
- Fixed core image request routing to vision fallback. (#8089)
- Sanitized file names in file components. (#8318)
- Fixed Dashboard sub-command count labels and duplicate plugin display. (#8388, #8389)
- Prevented duplicate processing of quoted images by multimodal main providers when no dedicated image caption provider is configured. (#8401)
- Removed extra blank lines in segmented replies. (#8304)
- Fixed plugin name mismatches between the marketplace and local plugins. (#8276)
- Fixed Dashboard list config items being unable to input spaces. (#8403)
- Fixed stale command hints. (#8245)
- Improved the
SendMessageToUserTooldescription. (commit)
Documentation and Maintenance
- Updated release version instructions. (commit)
- Updated FAQ Dashboard download links, hard refresh instructions, and deletion count wording. (#8359, #8235, commit)
- Fixed a typo in the Chinese QQ Official WebSocket bot setup documentation. (#8351)
- Updated GitHub Actions dependencies. (#8233, #8335)
- Removed unused logs. (commit)
What's Changed
- fix: skip empty llm summaries by @he-yufeng in https://github.com/AstrBotDevs/AstrBot/pull/8195
- chore(deps): bump pnpm/action-setup from 6.0.7 to 6.0.8 in the github-actions group by @dependabot[bot] in https://github.com/AstrBotDevs/AstrBot/pull/8233
- docs: fix typo of the count in FAQ deletion instructions by @dnamw in https://github.com/AstrBotDevs/AstrBot/pull/8235
- fix: support rst and adoc knowledge uploads by @he-yufeng in https://github.com/AstrBotDevs/AstrBot/pull/8255
- feat: ignore字体集的生成文件,并在编译时自动生成 by @M1LKT in https://github.com/AstrBotDevs/AstrBot/pull/8264
- feat(password): add command to change AstrBot dashboard password by @Soulter in https://github.com/AstrBotDevs/AstrBot/pull/8272
- Fix/stale command hints by @lingyun14beta in https://github.com/AstrBotDevs/AstrBot/pull/8245
- fix: t2i shiki issue by @lingyun14beta in https://github.com/AstrBotDevs/AstrBot/pull/8013
- fix: handle delta=None chunks in streaming to prevent SDK to_dict() error by @x1051445024 in https://github.com/AstrBotDevs/AstrBot/pull/8244
- fix: skills_like 模式下保留原始 completion_text,修复上下文分裂问题 by @EmilyCheoh in https://github.com/AstrBotDevs/AstrBot/pull/8240
- Fix/docs by @lingyun14beta in https://github.com/AstrBotDevs/AstrBot/pull/8229
- feat: 为ChatUI添加指令候选功能 by @elecvoid243 in https://github.com/AstrBotDevs/AstrBot/pull/8279
- fix(openai): 修复流式响应末尾usage信息丢失问题 by @NayukiChiba in https://github.com/AstrBotDevs/AstrBot/pull/8306
- fix SQLAlchemy compatibility issues on macOS by @hibiki233i in https://github.com/AstrBotDevs/AstrBot/pull/7724
- fix(docs): 更新FAQ,添加强制刷新页面的说明 by @VanillaNahida in https://github.com/AstrBotDevs/AstrBot/pull/8359
- fixed typo in the QQ official WebSocket documentation by @EmilyCheoh in https://github.com/AstrBotDevs/AstrBot/pull/8351
- fix(webui): restore mobile provider source deletion by @letr007 in https://github.com/AstrBotDevs/AstrBot/pull/8321
- chore(deps): bump the github-actions group with 3 updates by @dependabot[bot] in https://github.com/AstrBotDevs/AstrBot/pull/8335
- feat: enable smooth markdown streaming by @Simon-He95 in https://github.com/AstrBotDevs/AstrBot/pull/8371
- feat(webui): add direct access button on plugin cards and improve embedded page height by @lxfight in https://github.com/AstrBotDevs/AstrBot/pull/8369
- feat: add Xiaomi and Xiaomi Token Plan LLM Provider by @HosisoraLing in https://github.com/AstrBotDevs/AstrBot/pull/7744
- fix: 8267 mimo reasoning content by @NayukiChiba in https://github.com/AstrBotDevs/AstrBot/pull/8327
- feat: add EULA hint for first notification by @lingyun14beta in https://github.com/AstrBotDevs/AstrBot/pull/7955
- fix(mimo): 修复voice design模型请求中包含无效voice参数的问题 by @NayukiChiba in https://github.com/AstrBotDevs/AstrBot/pull/8326
- feat(qqofficial): split message chain by media and update sending logic by @Soulter in https://github.com/AstrBotDevs/AstrBot/pull/8376
- Fix/plugin metadata repo type guard by @lingyun14beta in https://github.com/AstrBotDevs/AstrBot/pull/8207
- fix(core): route image requests to vision fallback by @he-yufeng in https://github.com/AstrBotDevs/AstrBot/pull/8089
- fix: sanitize file name in file component by @liuwanwan1 in https://github.com/AstrBotDevs/AstrBot/pull/8318
- fix(dashboard): add sub-command count label by @he-yufeng in https://github.com/AstrBotDevs/AstrBot/pull/8388
- fix(dashboard): fix plugin displayed dup by @Dt8333 in https://github.com/AstrBotDevs/AstrBot/pull/8389
- feat: sync dashboard theme to plugin pages and prevent flash on load by @lxfight in https://github.com/AstrBotDevs/AstrBot/pull/8377
- fix(plugin): plugin name in the marketplace does not match the local plugin by @Waterwzy in https://github.com/AstrBotDevs/AstrBot/pull/8276
- fix(command-suggestion): support custom wake-up words & hover information by @elecvoid243 in https://github.com/AstrBotDevs/AstrBot/pull/8353
- feat: 为已配置的模型增加能力图标 by @M1LKT in https://github.com/AstrBotDevs/AstrBot/pull/8405
- fix: Dashboard list config item cannot input spaces by @Blueteemo in https://github.com/AstrBotDevs/AstrBot/pull/8403
- feat: Add extra fields to the QQ Official Webhook adapter by @KBVsent in https://github.com/AstrBotDevs/AstrBot/pull/6274
- fix(anthropic): Anthropic API tool_choice schema conversion by @NayukiChiba in https://github.com/AstrBotDevs/AstrBot/pull/8328
- feat(context): improve default LLM compression prompt for better continuity by @kawayiYokami in https://github.com/AstrBotDevs/AstrBot/pull/8424
- perf: increase the cache hit rate of group context awareness by @RC-CHN in https://github.com/AstrBotDevs/AstrBot/pull/8226
- fix(provider): 修复 base64:// 图片引用的 MIME 类型声明不准确问题 by @NayukiChiba in https://github.com/AstrBotDevs/AstrBot/pull/8177
- feat(kb): add Markdown-aware chunker for structured documents by @Loagaeth in https://github.com/AstrBotDevs/AstrBot/pull/8151
- fix: recording issue on chatui by @Soulter in https://github.com/AstrBotDevs/AstrBot/pull/8440
- fix(plugin_manager): improve plugin state cleanup and add tests for unbinding and loading plugins by @Soulter in https://github.com/AstrBotDevs/AstrBot/pull/8441
New Contributors
- @dnamw made their first contribution in https://github.com/AstrBotDevs/AstrBot/pull/8235
- @x1051445024 made their first contribution in https://github.com/AstrBotDevs/AstrBot/pull/8244
- @EmilyCheoh made their first contribution in https://github.com/AstrBotDevs/AstrBot/pull/8240
- @hibiki233i made their first contribution in https://github.com/AstrBotDevs/AstrBot/pull/7724
- @Simon-He95 made their first contribution in https://github.com/AstrBotDevs/AstrBot/pull/8371
- @HosisoraLing made their first contribution in https://github.com/AstrBotDevs/AstrBot/pull/7744
- @liuwanwan1 made their first contribution in https://github.com/AstrBotDevs/AstrBot/pull/8318
- @Loagaeth made their first contribution in https://github.com/AstrBotDevs/AstrBot/pull/8151
Full Changelog: https://github.com/AstrBotDevs/AstrBot/compare/v4.25.1...v4.25.2
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About AstrBot
All releases →Related context
Related tools
Beta — feedback welcome: [email protected]