v4.11.1

What's Changed

hotfix of v4.11.0

修复：

1. 修复: 部分情况下选择提供商的时候出现”暂无可用提供商的问题“，即使实际上已经配置了模型（提供商）。
2. 优化：提供商源 ID、提供商 ID 和模型 ID 的提示信息，帮助用户更好理解各个 ID 的含义。

新增

• 支持上下文自动压缩功能。入口：配置文件 -> 上下文管理策略 -> 超出模型上下文窗口时的处理方式。详情请查看： 自动上下文压缩 (#4322)
• 新增 on_waiting_llm_request 事件钩子 (#4319)
• WebUI 支持强制更新插件 (#4293)
• 社区已提供适用于 Matrix 平台的适配器插件

修复

• 修复微信公众号中由于 msg.id 数据类型不匹配导致的重试失败问题 (#4292)
• 修复调用 TTS 命令时出现的数据库锁定错误 (#4313)
• 修复 Anthropic 提供商中 token 用量始终为 0 的问题 (#4328)

优化

• 完善共享组件的国际化支持 (#4327)
• 优化下载大型备份文件时的稳定性，减少失败情况 (#4329)

What's Changed

• Fix: 修复微信公众号 msg.id 类型不匹配导致重试失败 (#1679) by @YukiRa1n in #4292
• feat(webui): supports force update plugins by @clown145 in #4293
• fix: database is locked error when invoking tts command by @Soulter in #4313
• ci(stale): Increase the operations-per-run limit for stale actions by @ocetars in #4256
• feat:加入on_waiting_llm_request钩子 by @advent259141 in #4319
• fix(dashboard): complete i18n support for shared components by @RC-CHN in #4327
• fix: token usage is always 0 in anthropic source by @Soulter in #4328
• feat: context compressor by @kawayiYokami and @Soulter in #4322
• feat(webui): enable Range request support for backup downloads by @RC-CHN in #4329

New Contributors

• @clown145 made their first contribution in #4293

Full Changelog: v4.10.6...v4.11.1

v4.11.0

What's Changed

新增

• 支持上下文自动压缩功能。入口：配置文件 -> 上下文管理策略 -> 超出模型上下文窗口时的处理方式。详情请查看： 自动上下文压缩 (#4322)
• 新增 on_waiting_llm_request 事件钩子 (#4319)
• WebUI 支持强制更新插件 (#4293)
• 社区已提供适用于 Matrix 平台的适配器插件

修复

• 修复微信公众号中由于 msg.id 数据类型不匹配导致的重试失败问题 (#4292)
• 修复调用 TTS 命令时出现的数据库锁定错误 (#4313)
• 修复 Anthropic 提供商中 token 用量始终为 0 的问题 (#4328)

优化

• 完善共享组件的国际化支持 (#4327)
• 优化下载大型备份文件时的稳定性，减少失败情况 (#4329)

v4.10.6

What's Changed

hotfix of v4.10.4

fix:

1. ‼️ 部分情况下使用 OpenAI 接口报错与 reasoning_content 有关的问题；

feat:

1. WebUI 已安装插件页支持记忆视图类型（列表/卡片），列表视图显示插件的人类友好名称和 logo。
2. 机器人适配器配置规则，支持使用 Shell Globbing 表达式。

What's Changed

• feat: use shell globbing to match umop config router by @Soulter in #4270
• fix: reasoning content inject for openai api by @tjc6666666666666 in #4284
• perf: list view mode toggle with localStorage support in ExtensionPage by @Soulter in #4288

New Contributors

• @tjc6666666666666 made their first contribution in #4284

Full Changelog: v4.10.5...v4.10.6

v4.10.5

What's Changed

hotfix of v4.10.4

fix: 部分配置项的输入框不显示，如飞书机器人配置的部分配置项。（#4268）

What's Changed v4.10.4

修复

• 修复钉钉适配器中"回复消息 At 发送人"功能失效的问题
• 修复 Xinference STT 在部分情况下无法使用的问题
• 修复"会话隔离"功能在非默认配置下无法生效的问题
• 修复部分 LLM 中转商因 token 使用情况不符合 OpenAI 标准接口规范导致请求报错的问题
• 修复 Deepseek 模型开启思考模式后工具调用报错的问题
• 修复部分操作系统环境下 pip 安装依赖时出现 UnicodeDecodeError 错误的问题

优化

• 全面优化对思考型模型的支持（如 Anthropic Extended Thinking、Deepseek 思考模式），完整回传 thinking 内容，提升模型推理性能
• 优化 WebUI 记忆侧边栏中"更多功能"和"平台日志"模块的展开状态记忆
• 为 MiniMax TTS 新增 "auto" 音色情绪选项，支持模型根据文本内容自动选择情绪
• 优化备份功能，支持大文件分片下载
• 为 WebSocket 连接添加 max_size 参数，以处理更大的消息并防止接收来自 Satori 平台的大负载时连接断开
• 优化插件安装流程，通过文件安装插件时，若插件已加载则先终止再重新加载，避免重复加载
• 知识库支持将 overlap 参数设置为 0

新增

• 为 dict 类型的 Schema 新增 JSON value 和 template schema 功能。详见 dict-类型的-schema。
• 新增 template_list 类型的 Schema，支持渲染指定 template 下的列表。详见 template-list-类型的-schema。

What's Changed

• fix: at sender users not working in dingtalk by @Soulter in #4219
• feat: two dashboard persistence optimizations by @ocetars in #4221
• perf: add auto voice emotion for minimax tts by @Soulter in #4228
• fix: Xinference STT failed: INVALID by @simplify123 in #4231
• fix: unique session config cannot be applied in non-default astrbot config by @Soulter in #4232
• feat: 为备份部分添加分片上传及备份文件相关管理功能 by @RC-CHN in #4237
• fix: handle None values in _extract_usage to prevent TypeError by @NieiR in #4244
• feat: add JSON value for custom_extra_body by @fluidcat in #4246
• perf: support extended thinking for Anthropic, DeepSeek reasoning mode, and Gemini text part thought signatures to improve multi-turn reasoning performance. by @Soulter in #4240
• chore: add github actions for marking bug issues stale by @ocetars in #4252
• fix(#4214): optimize pip install output decoding for cross-platform encoding compatibility by @ocetars in #4249
• perf(satori): increase websocket max message size to 10MB by @shangxueink in #4238
• feat: add template_list config type to support multiple repeated core/plugin config sets by @railgun19457 in #4208
• fix: ensure close aiodocker.Docker() by @fluidcat in #4251
• fix(#4188): terminate the same plugin when install the plugin via file by @ocetars in #4250
• Allow zero chunk overlap in recursive chunker by @Soulter in #4258
• perf: add Add button to ListConfigItem by @Soulter in #4259
• feat: enhance configuration editor with template schema support and UI improvements by @Soulter in #4267

New Contributors

• @simplify123 made their first contribution in #4231
• @NieiR made their first contribution in #4244
• @fluidcat made their first contribution in #4246

Full Changelog: v4.10.3...v4.10.4

v4.10.4

What's Changed

修复

• 修复钉钉适配器中"回复消息 At 发送人"功能失效的问题
• 修复 Xinference STT 在部分情况下无法使用的问题
• 修复"会话隔离"功能在非默认配置下无法生效的问题
• 修复部分 LLM 中转商因 token 使用情况不符合 OpenAI 标准接口规范导致请求报错的问题
• 修复 Deepseek 模型开启思考模式后工具调用报错的问题
• 修复部分操作系统环境下 pip 安装依赖时出现 UnicodeDecodeError 错误的问题

优化

• 全面优化对思考型模型的支持（如 Anthropic Extended Thinking、Deepseek 思考模式），完整回传 thinking 内容，提升模型推理性能
• 优化 WebUI 记忆侧边栏中"更多功能"和"平台日志"模块的展开状态记忆
• 为 MiniMax TTS 新增 "auto" 音色情绪选项，支持模型根据文本内容自动选择情绪
• 优化备份功能，支持大文件分片下载
• 为 WebSocket 连接添加 max_size 参数，以处理更大的消息并防止接收来自 Satori 平台的大负载时连接断开
• 优化插件安装流程，通过文件安装插件时，若插件已加载则先终止再重新加载，避免重复加载
• 知识库支持将 overlap 参数设置为 0

新增

• 为 dict 类型的 Schema 新增 JSON value 和 template schema 功能。详见 dict-类型的-schema。
• 新增 template_list 类型的 Schema，支持渲染指定 template 下的列表。详见 template-list-类型的-schema。

What's Changed

• fix: at sender users not working in dingtalk by @Soulter in #4219
• feat: two dashboard persistence optimizations by @ocetars in #4221
• perf: add auto voice emotion for minimax tts by @Soulter in #4228
• fix: Xinference STT failed: INVALID by @simplify123 in #4231
• fix: unique session config cannot be applied in non-default astrbot config by @Soulter in #4232
• feat: 为备份部分添加分片上传及备份文件相关管理功能 by @RC-CHN in #4237
• fix: handle None values in _extract_usage to prevent TypeError by @NieiR in #4244
• feat: add JSON value for custom_extra_body by @fluidcat in #4246
• perf: support extended thinking for Anthropic, DeepSeek reasoning mode, and Gemini text part thought signatures to improve multi-turn reasoning performance. by @Soulter in #4240
• chore: add github actions for marking bug issues stale by @ocetars in #4252
• fix(#4214): optimize pip install output decoding for cross-platform encoding compatibility by @ocetars in #4249
• perf(satori): increase websocket max message size to 10MB by @shangxueink in #4238
• feat: add template_list config type to support multiple repeated core/plugin config sets by @railgun19457 in #4208
• fix: ensure close aiodocker.Docker() by @fluidcat in #4251
• fix(#4188): terminate the same plugin when install the plugin via file by @ocetars in #4250
• Allow zero chunk overlap in recursive chunker by @Soulter in #4258
• perf: add Add button to ListConfigItem by @Soulter in #4259
• feat: enhance configuration editor with template schema support and UI improvements by @Soulter in #4267

New Contributors

• @simplify123 made their first contribution in #4231
• @NieiR made their first contribution in #4244
• @fluidcat made their first contribution in #4246

Full Changelog: v4.10.3...v4.10.4

v4.10.3

What's Changed

修复

1. 修复 FishAudio TTS 不可用的问题；
2. 修复 Anthropic API Chat Provider 部分情况下请求报错的问题；
3. 修复部分情况下 WebUI 日志重建连接之后丢失日志的问题；
4. 修复部分情况下 /provider 指令报错 index out of range 的问题；
5. 修复通过 uv 或者 cli 方式启动 AstrBot，缺少所有内置插件的问题。

优化

1. 丢弃值为 None 的 tool_call_id 和 tool_calls 字段，提高接口兼容性。

新增

1. 支持备份 AstrBot 数据和导入数据功能（Beta）。入口：WebUi -> 设置 -> 备份。
2. text_chat 和 text_chat_stream 接口支持额外用户内容块参数 extra_user_content_parts，用于在用户消息后添加额外的内容块（如系统提醒、指令等）。

Details

• feat: supports data backup by @RC-CHN in #4105
• fix: fix log loss on SSE reconnect using Last-Event-ID by @LinCheng-TCT in #4205
• fix: handle index out of range error when selecting provider by @advent259141 in #4206
• fix: failed to initialize FishAudio TTS instance and improve handling logic by @DBJD-CR in #4200
• fix: anthropic chat provider query error by @Soulter in #4212
• perf: drop unnecessary none-value fields in tool call loop by @Soulter in #4213
• feat: add extra user content block support by @kawayiYokami in #4189
• refactor: move builtin stars to astrbot package by @Soulter in #4209

New Contributors

• @LinCheng-TCT made their first contribution in #4205
• @DBJD-CR made their first contribution in #4200

Full Changelog: v4.10.2...v4.10.3

v4.10.2

What's Changed

修复

1. ‼️‼️ 修复了由 psutil 新版本导致的启动时报错的问题。

新增

1. 插件指令管理支持管理别名。

v4.10.1

What's Changed

📢 在升级前，请完整阅读本次更新日志。

特别提醒：

1. 本次升级如果再降级，会由于提供商配置的变更，导致提供商配置错乱，需要手动删除后重新添加。
2. 此版本 WebUI 包体相较上一个版本增加约 193%，共约 9.8 MB，升级可能会需要一些时间。
3. 升级后请务必确保 WebUI 和 AstrBot Core 版本一致，否则会产生预期之外的情况。（判断方法：日志中出现 WebUI 版本已是最新。 即为一致的版本，检测到 WebUI 版本 (xxx) 与当前 AstrBot 版本 (xxx) 不符。 即为不一致的版本。此版本的判断方法也可通查看 WebUI 右上角是否出现 Bot / Chat 的切换按钮控件来判断是否是新版本的 WebUI）。
4. 如果有任何问题请提交 Issue 并附带 v4.10.0 tag。

4.10.0 -> 4.10.1

• fix(core): 修复极少数情况下由于指令管理导致的 AstrBot 启动失败的问题
• fix(core): 修复当提供商源带有斜杠（“/”）时，无法删除 / 更新提供商源的问题（报错 405）
• perf(core): 优化 OneBot 适配器的消息段解析逻辑，修复部分情况下无法正确解析消息段的问题

重构与优化

• 重构 Provider 页面和提供商的配置结构，将 Chat Provider 配置拆分为 Provider Source（提供商源）和 Provider（代表提供商源的各个模型），引入了提供商模型自动发现、模型元数据自动发现的功能，提供更加便捷的模型添加体验。
• ⚠️ 将 “MCP” 页面移动到了 “插件” 页面中
• ⚠️ 将 “MCP” 页面中的工具管理移动到了 “插件” -> “管理行为” 中。
• ⚠️ 将 “QQ 个人号（OneBot v11）” 机器人适配器类型更名为 “OneBot v11”，并将其 Logo 更改为 OneBot 的 Logo。
• ⚠️ AstrBot WebChat 升级为 AstrBot ChatUI，入口从边栏修改为顶部（右上角）切换按钮。
• 优化引用消息的逻辑，减少对模型输入缓存的破坏。
• 优化当 Agent 达到最大步数时的处理。在达到最大步数后，会移除所有请求中的 tools 并告知模型根据上下文进行最终总结。
• 优化 LLM tools 执行的错误处理，减少工具调用无限循环的问题。

修复

• ‼️ 修复部分情况下，分段回复无法正常分段的问题。
• 修复处理工具返回结果的过程中，导致一些直接发送图片的工具（如生图工具）无法正确发送到用户的问题。
• 修复 WebChat 部分情况下，上一条消息文字内容增量到下一条消息的问题。

新增

• 支持指令管理，设置指令别名、解决指令冲突、查看指令详情等。入口：“插件” -> “管理行为”。
• 支持 Google Gemini 3 系列引入的 Thinking Level 配置。
• 支持记录每条 LLM 消息的耗时、Token 使用量、TTFT 数据，以及每次 Agent Loop 的各种统计数据。
• AstrBot ChatUI 支持查看每条消息的 TTFT、Token 使用量数据。
• AstrBot ChatUI 支持显示每次工具调用的耗时、参数和响应。
• AstrBot ChatUI 支持渲染 Mermaid、LateX 内容，优化了 Code Block 的显示效果（使用 Monaco Editor），并减少 DOM 更新于内存占用。（Powered by Simon-He95/markstream-vue）
• 支持查看 Changelog 历史版本更新日志。
• 🎄

Merry Christmas!

v4.10.0

🎄 What's Changed

📢 在升级前，请完整阅读本次更新日志。

特别提醒：

1. 本次升级如果再降级，会由于提供商配置的变更，导致提供商配置错乱，需要手动删除后重新添加。
2. 此版本 WebUI 包体相较上一个版本增加约 193%，共约 9.8 MB，升级可能会需要比以往更长时间。
3. 升级后请务必确保 WebUI 和 AstrBot Core 版本一致，否则会产生预期之外的情况。（判断方法：日志中出现 WebUI 版本已是最新。 即为一致的版本，检测到 WebUI 版本 (xxx) 与当前 AstrBot 版本 (xxx) 不符。 即为不一致的版本。此版本的判断方法也可通查看 WebUI 右上角是否出现 Bot / Chat 的切换按钮控件来判断是否是新版本的 WebUI）。
4. 如果有任何问题请提交 Issue 并附带 v4.10.0 tag。

重构与优化

• 重构 Provider 页面和提供商的配置结构，将 Chat Provider 配置拆分为 Provider Source（提供商源）和 Provider（代表提供商源的各个模型），引入了提供商模型自动发现、模型元数据自动发现的功能，提供更加便捷的模型添加体验。
• ⚠️ 将 “MCP” 页面移动到了 “插件” 页面中
• ⚠️ 将 “MCP” 页面中的工具管理移动到了 “插件” -> “管理行为” 中。
• ⚠️ 将 “QQ 个人号（OneBot v11）” 机器人适配器类型更名为 “OneBot v11”，并将其 Logo 更改为 OneBot 的 Logo。
• ⚠️ AstrBot WebChat 升级为 AstrBot ChatUI，入口从边栏修改为顶部（右上角）切换按钮。
• 优化引用消息的逻辑，减少对模型输入缓存的破坏。
• 优化当 Agent 达到最大步数时的处理。在达到最大步数后，会移除所有请求中的 tools 并告知模型根据上下文进行最终总结。
• 优化 LLM tools 执行的错误处理，减少工具调用无限循环的问题。

修复

• ‼️ 修复部分情况下，分段回复无法正常分段的问题。
• 修复处理工具返回结果的过程中，导致一些直接发送图片的工具（如生图工具）无法正确发送到用户的问题。
• 修复 WebChat 部分情况下，上一条消息文字内容增量到下一条消息的问题。

新增

• 支持指令管理，设置指令别名、解决指令冲突、查看指令详情等。入口：“插件” -> “管理行为”。
• 支持 Google Gemini 3 系列引入的 Thinking Level 配置。
• 支持记录每条 LLM 消息的耗时、Token 使用量、TTFT 数据，以及每次 Agent Loop 的各种统计数据。
• AstrBot ChatUI 支持查看每条消息的 TTFT、Token 使用量数据。
• AstrBot ChatUI 支持显示每次工具调用的耗时、参数和响应。
• AstrBot ChatUI 支持渲染 Mermaid、LateX 内容，优化了 Code Block 的显示效果（使用 Monaco Editor），并减少 DOM 更新于内存占用。（Powered by Simon-He95/markstream-vue）
• 支持查看 Changelog 历史版本更新日志。
• 🎄

Merry Christmas!

v4.10.0-alpha.2

What's Changed [XMAS UPDATE]

📢 在升级前，请完整阅读本次更新日志。

特别提醒：

1. 该版本为 alpha.2 预览版本。
2. 本次升级如果再降级，会由于提供商配置的变更，导致提供商配置错乱，需要手动删除后重新添加。
3. 此版本 WebUI 包体相较上一个版本增加约 193%，共约 9.8 MB，升级可能会需要一些时间。
4. 升级之后请务必确保 WebUI 和 AstrBot Core 版本一致，否则会产生预期之外的情况。（判断方法：日志中出现 WebUI 版本已是最新。 即为一致的版本，检测到 WebUI 版本 (xxx) 与当前 AstrBot 版本 (xxx) 不符。 即为不一致的版本。此版本的判断方法也可通查看 WebUI 右上角是否出现 Bot / Chat 的切换按钮控件来判断是否是新版本的 WebUI）。
5. 如果有任何问题请提交 Issue 并附带 v4.10.0 tag。

alpha.1 -> alpha.2

• 修复：“对话数据”页对话轨迹详情显示异常的问题
• 优化：当 Agent 达到最大步数时的处理。在达到最大步数后，会移除所有请求中的 tools 并告知模型根据上下文进行最终总结。
• 优化：LLM tools 执行的错误处理，减少工具调用无限循环的问题。
• 优化：ChatUI 打开模型选择菜单时，会重新获取提供商配置。
• 优化：ChatUI 新建对话并发送消息后，对话列表页自动选中该对话。

4.9.2 -> 4.10.0

重构与优化

• 重构 Provider 页面和提供商的配置结构，将 Chat Provider 配置拆分为 Provider Source（提供商源）和 Provider（代表提供商源的各个模型），引入了提供商模型自动发现、模型元数据自动发现的功能，提供更加便捷的模型添加体验。
• ⚠️ 将 “MCP” 页面移动到了 “插件” 页面中
• ⚠️ 将 “MCP” 页面中的工具管理移动到了 “插件” -> “管理行为” 中。
• ⚠️ 将 “QQ 个人号（OneBot v11）” 机器人适配器类型更名为 “OneBot v11”，并将其 Logo 更改为 OneBot 的 Logo。
• ⚠️ AstrBot WebChat 升级为 AstrBot ChatUI，入口从边栏修改为顶部（右上角）切换按钮。
• 优化引用消息的逻辑，减少对模型输入缓存的破坏。

修复

• ‼️ 修复部分情况下，分段回复无法正常分段的问题。
• 修复处理工具返回结果的过程中，导致一些直接发送图片的工具（如生图工具）无法正确发送到用户的问题。
• 修复 WebChat 部分情况下，上一条消息文字内容增量到下一条消息的问题。

新增

• 支持指令管理，设置指令别名、解决指令冲突、查看指令详情等。入口：“插件” -> “管理行为”。
• 支持 Google Gemini 3 系列引入的 Thinking Level 配置。
• 支持记录每条 LLM 消息的耗时、Token 使用量、TTFT 数据，以及每次 Agent Loop 的各种统计数据。
• AstrBot ChatUI 支持查看每条消息的 TTFT、Token 使用量数据。
• AstrBot ChatUI 支持显示每次工具调用的耗时、参数和响应。
• AstrBot ChatUI 支持渲染 Mermaid、LateX 内容，优化了 Code Block 的显示效果（使用 Monaco Editor），并减少 DOM 更新于内存占用。（Powered by Simon-He95/markstream-vue）
• 支持查看 Changelog 历史版本更新日志。
• 🎄

What's Changed alpha.1 -> alpha.2

• fix: webui conversation traj data display error by @Soulter in #4142
• perf(agent): add max step limit to prevent infinite tool call loops by @kawayiYokami in #4110
• fix: improve error handling in tool execution to prevent infinite tool call loops by @Soulter in #4143
• fix: enhance provider model menu and sidebar session selection handling by @Soulter in #4144

Full Changelog: v4.10.0-alpha.1...v4.10.0-alpha.2