| v4.25.3 | - [更新日志(简体中文)](#chinese) - [Changelog(English)](#english) <a id="chinese"></a> ## What's Changed ### 重点更新 - 修复钉钉 Stream 任务异常退出后无法持续重连的问题,提升钉钉适配器长连接稳定性。([#8610](https://github.com/AstrBotDevs/AstrBot/pull/8610)) - Dashboard 登录新增 TOTP 双因素认证。([#8189](https://github.com/AstrBotDevs/AstrBot/pull/8189)) - Dashboard 侧边栏新增插件 WebUI 入口,并支持 MDI 图标;插件页面现在会同步 Dashboard 主题。([#8569](https://github.com/AstrBotDevs/AstrBot/pull/8569), [#8390](https://github.com/AstrBotDevs/AstrBot/pull/8390)) - 优 | High | 6/5/2026 |
| v4.25.2 | - [更新日志(简体中文)](#chinese) - [Changelog(English)](#english) <a id="chinese"></a> ## What's Changed ### 新增与优化 - 启用平滑 Markdown 流式渲染。([#8371](https://github.com/AstrBotDevs/AstrBot/pull/8371)) - 优化群聊上下文感知的缓存命中率。([#8226](https://github.com/AstrBotDevs/AstrBot/pull/8226)) - 为知识库加入 Markdown 感知分块器,提升结构化文档导入后的分块质量。([#8151](https://github.com/AstrBotDevs/AstrBot/pull/8151)) - 为 ChatUI 添加指令候选能力,支持自定义唤醒词和悬浮提示。([#8279](https://github.com/AstrBotDevs/AstrBot/pull/8279), [#8353](https://github.c | High | 5/30/2026 |
| v4.25.1 | - [更新日志(简体中文)](#chinese) - [Changelog(English)](#english) <a id="chinese"></a> ## What's Changed ### 优化 - 个人微信和钉钉扫码创建成功后,平台配置 ID 会自动追加随机 4 位小写字母后缀,例如 `_abcd`,降低多个扫码创建配置之间的 ID 冲突概率。 ### 修复 - 修复 WebUI 全局字体栈未完整覆盖西里尔文字场景的问题,改善俄文等多语言文本显示效果。([#8205](https://github.com/AstrBotDevs/AstrBot/pull/8205)) <a id="english"></a> ## What's Changed (EN) ### Improvements - Personal WeChat and DingTalk QR setup now append a random four-letter lowercase suffix to the generated platform config ID, such as | High | 5/17/2026 |
| v4.24.4 | - [更新日志(简体中文)](#chinese) - [Changelog(English)](#english) <a id="chinese"></a> ## What's Changed ### 优化 - 强化 Dashboard 登录与密码安全:首次启动生成强随机初始密码,密码存储升级为 PBKDF2,保留旧版 MD5 兼容升级流程,并在需要时引导用户完成安全升级。([#7338](https://github.com/AstrBotDevs/AstrBot/pull/7338)) - 增强插件页面国际化能力,插件页面、扩展页和相关 Dashboard 文案可更好地按当前语言展示。([#7998](https://github.com/AstrBotDevs/AstrBot/pull/7998)) - 新增 WebUI 指标开关配置 `disable_metrics`,可在 Dashboard 中关闭指标统计。([#7946](https://github.com/AstrBotDevs/AstrBot/pull/7946)) - 新增控制台自动 | High | 5/12/2026 |
| v4.24.2 | - [更新日志(简体中文)](#chinese) - [Changelog(English)](#english) <a id="chinese"></a> > 我们将推出更好的 AstrBot 插件分享和管理平台,敬请期待! ## What's Changed ### 新增 - 新增插件自定义 WebUI 页面(Plugin Pages)能力,插件可通过 `pages/` 目录和注册 Web 路由来向 Dashboard 暴露自定义页面。详见开发文档。([#5940](https://github.com/AstrBotDevs/AstrBot/pull/5940)) - 新增插件国际化支持,插件可在 `.astrbot-plugin/i18n` 中提供多语言名称、描述和配置文本,Dashboard 组件会按当前语言解析展示。详见开发文档。([#7919](https://github.com/AstrBotDevs/AstrBot/pull/7919)) - 新增插件技能支持,插件可通过 `skills/` 提供 skills。([#7945]( | High | 5/3/2026 |
| v4.23.6 | - [更新日志(简体中文)](#chinese) - [Changelog(English)](#english) <a id="chinese"></a> ## What's Changed ### 新增 - 新增 `/stats` 命令,可查看当前会话的 Token 使用统计,并按总量、输入(缓存)、输入(其他)与输出拆分展示。([#7831](https://github.com/AstrBotDevs/AstrBot/pull/7831)) - 新增 Firecrawl Web 搜索与网页提取工具,支持搜索结果处理、网页内容提取、会话管理、请求校验与相关测试。([#7764](https://github.com/AstrBotDevs/AstrBot/pull/7764)) - 微信客服文本消息新增 15 秒内去重,减少重复消息处理。([#7788](https://github.com/AstrBotDevs/AstrBot/pull/7788)) ### 优化 - 优化 Provider 配置界面性能与响应式显示,改善相关组件的字 | High | 4/27/2026 |
| v4.23.5 | - [更新日志(简体中文)](#chinese) - [Changelog(English)](#english) <a id="chinese"></a> ## What's Changed ### 新增 - WebUI ChatUI 新增消息重新编辑、从重新生成 AI 回复、分支询问面板(划选 AI 回复内容即可看到)与会话 checkpoint 支持。([#7673](https://github.com/AstrBotDevs/AstrBot/pull/7673)) - WebUI ChatUI 适配思考时的工具调用的模式,并自动将该 Loop 过程合并到独立的侧边栏面板中,以时间线呈现,大幅提升用户体验。([#7742](https://github.com/AstrBotDevs/AstrBot/pull/7742)) - WebUI ChatUI 附件处理新增预览与 Dedup 校验,改善上传前的附件识别与展示体验,修复用户消息气泡无法正常显示图片的问题。([commit](https://github.com/AstrBotDevs/Ast | High | 4/23/2026 |
| v4.23.2 | - [更新日志(简体中文)](#chinese) - [Changelog(English)](#english) <a id="chinese"></a> ## What's Changed ### 新增 - 知识库稀疏检索阶段新增 SQLite FTS5 支持,大幅优化万到十万级别分块时造成的召回时的显著卡顿。([#7648](https://github.com/AstrBotDevs/AstrBot/pull/7648)) - KOOK 平台新增角色提及支持,包含角色记录、事件解析、API 类型与相关测试。([#7626](https://github.com/AstrBotDevs/AstrBot/pull/7626)) - 新增 MiniMax Token Plan Provider。([#7609](https://github.com/AstrBotDevs/AstrBot/pull/7609)) - 新增 `on_agent_begin`、`on_using_llm_tool`、`on_llm_tool_respond`、`on_age | High | 4/19/2026 |
| v4.23.1 | - [更新日志(简体中文)](#chinese) - [Changelog(English)](#english) <a id="chinese"></a> ## What's Changed *这是 v4.23.0 的热修复版本:v4.23.1* - 将 `python-ripgrep` 依赖降级到 `0.0.8`,修复 Python 3.13, 3.14 版本无法正常启动的问题。([#7514](https://github.com/AstrBotDevs/AstrBot/pull/7514)) - 修复会话 ID 包含冒号 `:` 时,平台路由在 Dashboard 中无法显示的问题。([#7517](https://github.com/AstrBotDevs/AstrBot/pull/7517)) - 适配 DeerFlow 2.0,更新 DeerFlow Runner、API Client、会话命令、Provider 管理逻辑、配置文档与相关测试。([#7500](https://github.com/AstrBotDevs/AstrBot/p | High | 4/13/2026 |
| v4.23.0 | - [更新日志(简体中文)](#chinese) - [Changelog(English)](#english) <a id="chinese"></a> ## What's Changed ### 新增 - 为电脑使用能力支持文件读取(read)、写入(write)、编辑(edit)、Grep 搜索(ripgrep)与按会话隔离的 workspace。([#7402](https://github.com/AstrBotDevs/AstrBot/pull/7402)) - 微信个人号适配器支持引用消息的解析。([#7380](https://github.com/AstrBotDevs/AstrBot/pull/7380)) - 新增 Brave Search 网页搜索工具,移除旧的默认网页搜索实现。([#6847](https://github.com/AstrBotDevs/AstrBot/pull/6847)) - 新增 Mattermost 平台适配器支持。([#7369](https://github.com/AstrBotDevs/Ast | Medium | 4/12/2026 |
| v4.23.0-beta.1 | - [更新日志(简体中文)](#chinese) - [Changelog(English)](#english) <a id="chinese"></a> ## What's Changed ### 新增 - 为电脑使用能力支持文件读取(read)、写入(write)、编辑(edit)、Grep 搜索(ripgrep)与按会话隔离的 workspace。([#7402](https://github.com/AstrBotDevs/AstrBot/pull/7402)) - 新增 Brave Search 网页搜索工具,替代旧的默认网页搜索实现。([#6847](https://github.com/AstrBotDevs/AstrBot/pull/6847)) - 新增 Mattermost 平台适配器支持。([#7369](https://github.com/AstrBotDevs/AstrBot/pull/7369)) - 新增 NVIDIA Rerank Provider。([#7227](https://github.com/AstrBotDevs/AstrBot | High | 4/11/2026 |
| v4.22.3 | - [更新日志(简体中文)](#chinese) - [Changelog(English)](#english) <a id="chinese"></a> ## What's Changed ### 新增 - 新增 `vllm_rerank` 提供商支持可配置的 `rerank_api_suffix`,可灵活适配不同 API 路径。([#7278](https://github.com/AstrBotDevs/AstrBot/pull/7278)) - 适配 llama.cpp 的 token 用量提取支持,增强 token 统计与计费分析能力。([#7358](https://github.com/AstrBotDevs/AstrBot/pull/7358)) - WebUI 捆绑 Monaco Editor 的 worker 文件,防止从 CDN 下载失败。([#7249](https://github.com/AstrBotDevs/AstrBot/pull/7249)) - 全新的模型/平台总览统计面板。([#7152](https://git | High | 4/4/2026 |
| v4.22.2 | ## What's Changed ### 新增 - 个人微信 新增“对方正在输入...”状态控制能力。([#6977](https://github.com/AstrBotDevs/AstrBot/pull/6977)) - 配置管理页支持从现有配置复制生成新配置,减少重复创建成本。([#6785](https://github.com/AstrBotDevs/AstrBot/pull/6785)) ### 优化 - Chat Provider text_chat 接口新增 `tool_choice` 参数,并为模型空响应引入统一的 `EmptyModelOutputError` 与增强重试逻辑,改善 “skills-like” 工具调用模式下的稳定性。([#7101](https://github.com/AstrBotDevs/AstrBot/pull/7101)、[#7104](https://github.com/AstrBotDevs/AstrBot/pull/7104)) - SSL 证书配置错误时自动回退到非 SSL 模式,而不是程序直接退出 | Medium | 3/28/2026 |
| v4.22.1 | ## What's Changed ### 新增 - 增强 Skills 安装流程,不再限制上传的压缩包顶级必须是一个目录。并支持中文技能名称显示。([#6952](https://github.com/AstrBotDevs/AstrBot/pull/6952)) - OpenAI Embedding 模型配置支持自动补齐 `/v1` 基础路径。([#6863](https://github.com/AstrBotDevs/AstrBot/pull/6863)) - 为 `/api/file` 新增 GET 端点并支持多种请求方式。([#6874](https://github.com/AstrBotDevs/AstrBot/pull/6874)) - WebUI 设置页新增日志与缓存清理能力。([#6822](https://github.com/AstrBotDevs/AstrBot/pull/6822)) - Lark 平台新增可折叠 Thinking 面板能力与消息处理优化。([#6831](https://github.com/AstrBotDevs/AstrBot/p | Medium | 3/25/2026 |
| v4.22.0 | ## What's Changed ### 新增 - 新增**个人微信**接入能力(微信官方提供)。详见 [个人微信接入](https://docs.astrbot.app/platform/weixin_oc.html)([#6777](https://github.com/AstrBotDevs/AstrBot/pull/6777)) - 新增图片压缩能力,支持图片尺寸、JPEG 质量限制。([#6794](https://github.com/AstrBotDevs/AstrBot/pull/6794)) - 新增 WebUI 已安装插件置顶与拖拽重排能力。([#6776](https://github.com/AstrBotDevs/AstrBot/pull/6776)) ### 优化 - 知识库为空时自动跳过检索,避免无效搜索调用。([#6750](https://github.com/AstrBotDevs/AstrBot/pull/6750)) - 修复 `frontmatter` 转义换行符保留行为并更新相关测试与 CI 工作流(含文档与配 | Low | 3/22/2026 |
| v4.21.0 | ## What's Changed ### 新增 - 为插件市场新增分类筛选并优化界面组件。([#6762](https://github.com/AstrBotDevs/AstrBot/pull/6762)) - 新增 Kimi Coding Plan Provider(兼容 Anthropic API)。([#6559](https://github.com/AstrBotDevs/AstrBot/pull/6559)) - 统一并重命名 `skill.md` 文件为 `SKILL.md`。([#6757](https://github.com/AstrBotDevs/AstrBot/pull/6757)) - 新增 Ollama 关闭思考模式开关。([#5941](https://github.com/AstrBotDevs/AstrBot/pull/5941)) - 新增小米 MiMo TTS 与 STT Provider。([#6643](https://github.com/AstrBotDevs/AstrBot/pull/6643)) - 新增多模态 | Low | 3/21/2026 |
| v4.20.1 | ## What's Changed ### 新增 - 补充 MiniMax Provider。([#6318](https://github.com/AstrBotDevs/AstrBot/pull/6318)) - 新增 WebUI ChatUI 页面的会话批量删除功能。([#6160](https://github.com/AstrBotDevs/AstrBot/pull/6160)) - 新增 WebUI ChatUI 配置发送快捷键。([#6272](https://github.com/AstrBotDevs/AstrBot/pull/6272)) ### 优化 - 优化 UMO 处理兼容性。([#5996](https://github.com/AstrBotDevs/AstrBot/pull/5996)) - 重构 `_extract_session_id`,改进聊天类型分支处理。(#5775) - 优化聊天组件行为,使用 `shiki` 进行代码块渲染。([#6286](https://github.com/AstrBotDevs/AstrBot/pull/62 | Low | 3/16/2026 |
| v4.20.0 | ## What's Changed ### 新增 - 新增俄语翻译([#6081](https://github.com/AstrBotDevs/AstrBot/pull/6081))。 - QQ 官方 Bot 新增文件、语音、视频消息支持(含 WebSocket 模式)([#6063](https://github.com/AstrBotDevs/AstrBot/pull/6063))。 ### 优化 - 优化 QQ 官方 Bot 的流式消息投递可靠性与主动媒体发送能力([#6131](https://github.com/AstrBotDevs/AstrBot/pull/6131))。 - 优化边界场景下 booter 选择逻辑与消息发送工具([#6064](https://github.com/AstrBotDevs/AstrBot/pull/6064))。 ### 修复 - 修复 Dashboard README 对话框锚点导航失效([#6083](https://github.com/AstrBotDevs/AstrBot/pull/6 | Low | 3/12/2026 |
| v4.19.5 | ## What's Changed ### 新增 - Lark 适配器支持 CardKit 流式输出(飞书)([#5777](https://github.com/AstrBotDevs/AstrBot/pull/5777))。 - WebUI 已安装插件列表新增筛选与排序功能 ([#5923](https://github.com/AstrBotDevs/AstrBot/pull/5923))。 ### 优化 - 启动时后台加载 MCP Server,不阻塞加载流程 ([#5993](https://github.com/AstrBotDevs/AstrBot/pull/5993))。 ### 修复 - 部分情况下 MCP 页报错 500 导致查看不了 MCP 服务器 ([#5993](https://github.com/AstrBotDevs/AstrBot/pull/5993))。 - 修复 TTS Provider 测试:增加文件大小校验,并补充 MiniMax 空音频检测 ([#5999](https://github.com/AstrBotDevs/AstrBo | Low | 3/10/2026 |
| v4.19.4 | ## What's Changed ### 新增 - 企业微信智能机器人支持长连接模式。[#5930](https://github.com/AstrBotDevs/AstrBot/pull/5930) ### New - Wecom AI Bot supports long-connection mode(Websockets). [#5930](https://github.com/AstrBotDevs/AstrBot/pull/5930) | Low | 3/9/2026 |
| v4.19.3 | ## What's Changed ### 新增 - 新增 Skills 批量上传能力 ([#5804](https://github.com/AstrBotDevs/AstrBot/pull/5804))。 ### 修复 - 修复 MCP Server 配置异常时可能导致崩溃的问题 ([#5666](https://github.com/AstrBotDevs/AstrBot/pull/5666), [#5673](https://github.com/AstrBotDevs/AstrBot/pull/5673))。 - 修复钉钉适配器文本消息被忽略、无法主动发送文件的问题 ([#5921](https://github.com/AstrBotDevs/AstrBot/pull/5921))。 - 修复钉钉适配器无法接收图片与文件的问题 ([#5920](https://github.com/AstrBotDevs/AstrBot/pull/5920))。 - fix(provider): handle MiniMax ThinkingBlock whe | Low | 3/8/2026 |
| v4.19.2 | ## What's Changed ### 新增 - 集成 KOOK 平台适配器 ([#5658](https://github.com/AstrBotDevs/AstrBot/pull/5658))。 - 新增 Discord pre-react Emoji 支持 ([#5609](https://github.com/AstrBotDevs/AstrBot/pull/5609))。 - 新增 Telegram 支持 `sendMessageDraft` 流式实时输出 API ([#5726](https://github.com/AstrBotDevs/AstrBot/issues/5726)) - 支持在 Agent 运行时进行消息跟进能力,跟进的消息实时注入给 Agent ([#5484](https://github.com/AstrBotDevs/AstrBot/pull/5484))。 - 集成 DeerFlow Agent Runner 并优化流式处理 ([#5581](https://github.com/AstrBotDevs/AstrBot/p | Low | 3/5/2026 |
| v4.18.3 | ## What's Changed ### 新增 - 新增桌面端通用更新桥接能力,便于接入客户端内更新流程 ([#5424](https://github.com/AstrBotDevs/AstrBot/issues/5424))。 ### 修复 - 修复新增平台对话框中 Line 适配器未显示的问题。 - 修复 Telegram 无法发送 Video 的问题 ([#5430](https://github.com/AstrBotDevs/AstrBot/issues/5430))。 - 修复创建 embedding provider 时无法自动识别向量维度的问题 ([#5442](https://github.com/AstrBotDevs/AstrBot/issues/5442))。 - 修复 QQ 官方平台发送媒体消息时 markdown 字段未清理的问题 ([#5445](https://github.com/AstrBotDevs/AstrBot/issues/5445))。 - 修复上下文管理策略 -> 上下文截断时 tool call / | Low | 2/26/2026 |
| v4.18.2 | ## What's Changed ### 新增 - 新增 Agent 会话停止能力,并优化 stop 请求处理流程,支持 /stop 指令终止 Agent 运行并尽量不丢失已运行输出的结果。 ([#5380](https://github.com/AstrBotDevs/AstrBot/issues/5380))。 - 新增 SubAgent 交接场景下的 computer-use 工具支持 ([#5399](https://github.com/AstrBotDevs/AstrBot/issues/5399))。 - 新增 Agent 执行过程中展示工具调用结果的能力,提升执行过程可观测性 ([#5388](https://github.com/AstrBotDevs/AstrBot/issues/5388))。 - 新增插件加载/卸载 Hook,扩展插件生命周期能力 ([#5331](https://github.com/AstrBotDevs/AstrBot/issues/5331))。 - 新增插件加载失败后的热重载能力,提升插件开发与恢复效率 ([#5334 | Low | 2/24/2026 |
| v4.18.1 | ## What's Changed ### 修复 - fix: 修复插件市场出现插件显示为空白的 bug;纠正已安装插件卡片的排版,统一大小 ([#5309](https://github.com/AstrBotDevs/AstrBot/issues/5309)) ### 新增 - SubAgent 支持后台执行模式配置:当 `background: true` 时,子代理将在后台运行,主对话无需等待子代理完成即可继续进行。当子代理完成后,会收到通知。适用于长时间运行或用户不需要立即结果的任务。([#5081](https://github.com/AstrBotDevs/AstrBot/issues/5081)) - 配置 Schema 新增密码渲染支持:`string` 与 `text` 类型可通过 `password: true`(或 `render_type: "password"`)在 WebUI 中按密码输入方式显示。 ## What's Changed (EN) ### Fixes - fix: Fixed a bug where the | Low | 2/22/2026 |
| v4.18.0 | ## What's Changed ### 新增 - 新增 AstrBot HTTP API,支持基于 API Key 的对话、会话查询、配置查询、文件上传与 IM 消息发送能力。详见[AstrBot HTTP API (Beta)](https://docs.astrbot.app/dev/openapi.html) ([#5280](https://github.com/AstrBotDevs/AstrBot/issues/5280))。 - 新增 Telegram 指令别名注册能力,别名可同步展示在 Telegram 指令菜单中 ([#5234](https://github.com/AstrBotDevs/AstrBot/issues/5234))。 - 新增 Anthropic 自适应思考参数配置(type/effort),增强思考策略可控性 ([#5209](https://github.com/AstrBotDevs/AstrBot/issues/5209))。 ### 修复 - 修复 QQ 官方频道消息发送异常问题,提升消息下发稳定性 ([#5287 | Low | 2/21/2026 |
| v4.17.6 | ## What's Changed ### 新增 - 新增 Python / Shell 执行工具的管理员权限校验,提升高风险操作安全性 ([#5214](https://github.com/AstrBotDevs/AstrBot/issues/5214))。 - 新增插件 `astrbot-version` 与平台版本要求校验支持,增强插件兼容性管理能力 ([#5235](https://github.com/AstrBotDevs/AstrBot/issues/5235))。 - 账号密码修改流程新增“确认新密码”校验,减少误输导致的配置问题 ([#5247](https://github.com/AstrBotDevs/AstrBot/issues/5247))。 ### 修复 - 修复 MCP 工具完整暴露给主 Agent,无视人格 tool 选择的问题 ([#5252](https://github.com/AstrBotDevs/AstrBot/issues/5252))。 - 改进微信公众号被动回复处理机制,引入缓冲与分片回复并优化超时行为,提升回 | Low | 2/20/2026 |
| v4.17.5 | ## What's Changed ### 新增 - 支持 QQ 官方机器人平台发送 Markdown 消息,提升富文本消息呈现能力 ([#5173](https://github.com/AstrBotDevs/AstrBot/issues/5173))。 - 新增在插件市场中集成随机插件推荐能力 ([#5190](https://github.com/AstrBotDevs/AstrBot/issues/5190))。 - 新增插件错误钩子(plugin error hook),支持自定义错误路由处理,便于插件统一异常控制 ([#5192](https://github.com/AstrBotDevs/AstrBot/issues/5192))。 ### 修复 - 修复全部 LLM Provider 失败时重复显示错误信息的问题,减少冗余报错干扰 ([#5183](https://github.com/AstrBotDevs/AstrBot/issues/5183))。 - 修复从“选择配置文件”进入配置管理后直接关闭弹窗时,显示配置文件不正确的问题 ([#5 | Low | 2/18/2026 |
| v4.17.4 | ## What's Changed ### 新增 - 新增 NVIDIA Provider 模板,便于快速接入 NVIDIA 模型服务 ([#5157](https://github.com/AstrBotDevs/AstrBot/issues/5157))。 - 支持在 WebUI 搜索配置 ### 修复 - 修复 CronJob 页面操作列按钮重叠问题,提升任务管理可用性 ([#5163](https://github.com/AstrBotDevs/AstrBot/issues/5163))。 ### 优化 - 优化 Python / Shell 本地执行工具的权限拒绝提示信息引导,提升排障可读性。 - Provider 来源面板样式升级,新增菜单交互并完善移动端适配。 - PersonaForm 组件增强响应式布局与样式细节,改进不同屏幕下的编辑体验 ([#5162](https://github.com/AstrBotDevs/AstrBot/issues/5162))。 - 配置页面新增未保存变更提示,减少误操作导致的配置丢失。 - 配置相关组件新增搜索能力并同步更新 | Low | 2/17/2026 |
| v4.17.3 | ## What's Changed ### 修复 - ‼️ 修复 Python 3.14 环境下 `'Plain' object has no attribute 'text'` 报错问题 ([#5154](https://github.com/AstrBotDevs/AstrBot/issues/5154))。 - ‼️ 修复插件元数据处理流程:在实例化前注入必要属性,避免初始化阶段元数据缺失 ([#5155](https://github.com/AstrBotDevs/AstrBot/issues/5155))。 - 修复桌面端后端构建中 AstrBot 内置插件运行时依赖未打包的问题 ([#5146](https://github.com/AstrBotDevs/AstrBot/issues/5146))。 - 修复通过 AstrBot Launcher 启动时仍被检测并触发更新的问题。 ### 优化 - Webchat 下,使用 `astrbot_execute_ipython` 工具如果返回了图片,会自动将图片发送到聊天中。 ### 其他 - 执行 `ruff fo | Low | 2/17/2026 |
| v4.17.2 | ## What's Changed hotfix of 4.17.0 - 修复:MCP 服务器的 Tools 没有被正确添加到上下文中。 - 修复:Electron 桌面应用部署时,系统自带插件未被正确加载的问题。 - fix: Tools from MCP server were not properly added to context. - fix: built-in plugins were not properly loaded in Electron desktop application deployment. | Low | 2/16/2026 |
| v4.17.1 | ## What's Changed hotfix of 4.17.0 - 修复:当开启了 “启用文件日志” 后,无法启动 AstrBot,报错 `ValueError: Invalid unit value while parsing duration: 'files'`。这是由于日志轮转设置中保留配置错误导致的,已通过根据备份数量正确设置保留参数进行修复。 - fix: When "Enable file logging" is turned on, AstrBot fails to start with error `ValueError: Invalid unit value while parsing duration: 'files'`. This is due to an incorrect retention configuration in the log rotation setup, which has been fixed by properly setting the retention parameter based on backup count. | Low | 2/15/2026 |
| v4.17.0 | ## What's Changed ### 新增 - 新增 LINE 平台适配器与相关配置支持 ([#5085](https://github.com/AstrBotDevs/AstrBot/issues/5085)) - 新增备用回退聊天模型列表,当主模型报错时自动切换到备用模型 ([#5109](https://github.com/AstrBotDevs/AstrBot/issues/5109)) - 新增插件加载失败后的热重载支持,便于插件修复后快速恢复 ([#5043](https://github.com/AstrBotDevs/AstrBot/issues/5043)) - WebUI 新增 SSL 配置选项并同步更新相关日志行为 ([#5117](https://github.com/AstrBotDevs/AstrBot/issues/5117)) ### 修复 - 修复 Dockerfile 中依赖导出流程,增加 `uv lock` 步骤并移除不必要的 `--frozen` 参数,提升构建稳定性 ([#5091](https://github.com/AstrB | Low | 2/15/2026 |
| v4.16.0 | ## What's Changed ### 新增 - QQ 官方机器人平台支持主动推送消息,私聊场景支持接收文件 ([#5066](https://github.com/AstrBotDevs/AstrBot/issues/5066)) - 为 Telegram 平台适配器新增等待 AI 回复时自动展示 “正在输入”、“正在上传图片” 等状态的功能 ([#5037](https://github.com/AstrBotDevs/AstrBot/issues/5037)) - 为飞书适配器增加接收文件、读取引用消息的内容(包括引用的图片、视频、文件、文字等) ([#5018](https://github.com/AstrBotDevs/AstrBot/issues/5018)) - 新增自定义平台适配器 i18n 支持 ([#5045](https://github.com/AstrBotDevs/AstrBot/issues/5045)) - 新增临时文件处理能力,可在系统配置中限制 data/temp 目录的最大大小。 ([#5026](https://github | Low | 2/12/2026 |
| v4.15.0 | ## What's Changed > ⚠️ 提醒 **v4.14.8** 用户:由于 v4.14.8 版本 Bug,若您未使用 Electron AstrBot 桌面应用,会被错误地通过 WebUI 对话框跳转到 Github Releases 页。 > 类似出现如下对话框: > <img width="400" height="710" alt="image" src="https://github.com/user-attachments/assets/e9a0e3e1-d41d-42c5-b36c-6b9efe298dac" /> > 如果是这种情况,不要下载和安装下面的安装包。您有两种升级方式: > 1. **您可能需要手动重新部署 AstrBot 才能升级**。(如果可以打开更新页面切换新版本则可以忽略此提醒) > 2. 下载[此文件](https://github.com/AstrBotDevs/AstrBot/releases/download/v4.15.0/AstrBot-v4.15.0-dashboard.zip),解压后放到 AstrBot 的 | Low | 2/10/2026 |
| v4.14.8 | ## What's Changed hotfix of 4.14.7 - 为 AstrBot Electron App 增加特殊的更新处理。 ### 修复 - 人格预设对话可能会重复添加到上下文 ([#4961](https://github.com/AstrBotDevs/AstrBot/issues/4961)) ### 新增 - 增加提供商级别的代理支持 ([#4949](https://github.com/AstrBotDevs/AstrBot/issues/4949)) - WebUI 管理行为增加插件指令权限管理功能 ([#4887](https://github.com/AstrBotDevs/AstrBot/issues/4887)) - 允许 LLM 预览工具返回的图片并自主决定是否发送 ([#4895](https://github.com/AstrBotDevs/AstrBot/issues/4895)) - Telegram 平台添加媒体组(相册)支持 ([#4893](https://github.com/AstrBotDevs/AstrBot/is | Low | 2/8/2026 |
| v4.14.7 | ## What's Changed ### 修复 - 人格预设对话可能会重复添加到上下文 ([#4961](https://github.com/AstrBotDevs/AstrBot/issues/4961)) ### 新增 - 增加提供商级别的代理支持 ([#4949](https://github.com/AstrBotDevs/AstrBot/issues/4949)) - WebUI 管理行为增加插件指令权限管理功能 ([#4887](https://github.com/AstrBotDevs/AstrBot/issues/4887)) - 允许 LLM 预览工具返回的图片并自主决定是否发送 ([#4895](https://github.com/AstrBotDevs/AstrBot/issues/4895)) - Telegram 平台添加媒体组(相册)支持 ([#4893](https://github.com/AstrBotDevs/AstrBot/issues/4893)) - 增加欢迎功能,支持本地化内容和新手引导步骤 - 支持 Electron 桌面应用部 | Low | 2/8/2026 |
| v4.14.6 | ## What's Changed ### 修复 - 修复一些原因导致 Tavily WebSearch、Bocha WebSearch 无法使用的问题 ### 新增 - 飞书支持 Bot 发送文件、图片和视频消息类型。 ### 优化 - 优化 WebChat 和 企业微信 AI 会话队列生命周期管理,减少内存泄漏,提高性能。 ## What's Changed * feat: implement feishu / lark media file handling utilities for file, audio and video processing by @Soulter in https://github.com/AstrBotDevs/AstrBot/pull/4938 * perf: optimize webchat and wecom ai queue lifecycle by @Soulter in https://github.com/AstrBotDevs/AstrBot/pull/4941 **Full Changel | Low | 2/7/2026 |
| v4.14.5 | ## What's Changed ### Fix - fix: `fix: messages[x] assistant content must contain at least one part` after tool calling ([#4928](https://github.com/AstrBotDevs/AstrBot/issues/4928)) after tool calls. - fix: TypeError when MCP schema type is a list ([#4867](https://github.com/AstrBotDevs/AstrBot/issues/4867)) - fix: Fixed an issue that caused scheduled task execution failures with specific providers 修复特定提供商导致的定时任务执行失败的问题 ([#4872](https://github.com/AstrBotDevs/AstrBot/issues/4872)) ### Feature | Low | 2/6/2026 |
| v4.14.4 | ## What's Changed hotfix of v4.14.0 ### hotfix - 修复 token 统计错误的问题,修复在多轮 tool call 情况下或者其他极端情况下可能造成 tool 无限调用的问题。 - 修复 `on_llm_request` 钩子可能无法应用效果的问题 - 由 `event.request_llm()` 过时导致的群聊上下文感知-主动回复功能可能不可用的问题 ## What's Changed - BIG AND BEAUTIFUL VERSION > 如果在之前版本使用了 Skill,这次更新之后**需要重新配置** Skill Runtime 相关选项。 ### 新增 - 🔥 新增未来任务系统(Future Tasks)。给 AstrBot 布置的未来任务,让 AstrBot 能够在某一时刻自动唤醒,帮你完成任务。详见 [主动任务](https://docs.astrbot.app/use/proactive-agent.html) 。(实验性) ([#4697](https://github.co | Low | 2/4/2026 |
| v4.14.3 | ## What's Changed hotfix of v4.14.0 ### hotfix - 修复 `on_llm_request` 钩子可能无法应用效果的问题 - 由 `event.request_llm()` 过时导致的群聊上下文感知-主动回复功能可能不可用的问题 ## What's Changed - BIG AND BEAUTIFUL VERSION > 如果在之前版本使用了 Skill,这次更新之后**需要重新配置** Skill Runtime 相关选项。 ### 新增 - 🔥 新增未来任务系统(Future Tasks)。给 AstrBot 布置的未来任务,让 AstrBot 能够在某一时刻自动唤醒,帮你完成任务。详见 [主动任务](https://docs.astrbot.app/use/proactive-agent.html) 。(实验性) ([#4697](https://github.com/AstrBotDevs/AstrBot/issues/4831)) - 🔥 新增子代理(SubAgent)编排器。(实验性)( | Low | 2/4/2026 |
| v4.14.2 | ## What's Changed ### 新增 - 控制台页面新增调试提示和本地化文件 ([#4852](https://github.com/AstrBotDevs/AstrBot/pull/4852)) ### 修复 - 修复插件热重载时平台适配器未清理导致注册冲突的问题 ([#4859](https://github.com/AstrBotDevs/AstrBot/pull/4859)) ### 其他 - 更新 ruff 版本至 0.15.0 - 新增 robots.txt ([#4847](https://github.com/AstrBotDevs/AstrBot/pull/4847)) ## What's Changed (EN) ### New Features - Add debug hint to console page and localization files ([#4852](https://github.com/AstrBotDevs/AstrBot/pull/4852)) ### Bug Fixes - | Low | 2/4/2026 |
| v4.14.1 | ## What's Changed - BIG AND BEAUTIFUL VERSION hotfix of v4.14.0 fixes: - 由 `event.request_llm()` 过时导致的群聊上下文感知-主动回复功能可能不可用的问题 > 如果在之前版本使用了 Skill,这次更新之后**需要重新配置** Skill Runtime 相关选项。 ### 新增 - 🔥 新增未来任务系统(Future Tasks)。给 AstrBot 布置的未来任务,让 AstrBot 能够在某一时刻自动唤醒,帮你完成任务。详见 [主动任务](https://docs.astrbot.app/use/proactive-agent.html) 。(实验性) ([#4697](https://github.com/AstrBotDevs/AstrBot/issues/4831)) - 🔥 新增子代理(SubAgent)编排器。(实验性)([#4697](https://github.com/AstrBotDevs/AstrBot/issues/4831)) | Low | 2/3/2026 |
| v4.14.0 | ## What's Changed - BIG AND BEAUTIFUL VERSION > 如果在之前版本使用了 Skill,这次更新之后**需要重新配置** Skill Runtime 相关选项。 ### 新增 - 🔥 新增未来任务系统(Future Tasks)。给 AstrBot 布置的未来任务,让 AstrBot 能够在某一时刻自动唤醒,帮你完成任务。详见 [主动任务](https://docs.astrbot.app/use/proactive-agent.html) 。(实验性) ([#4697](https://github.com/AstrBotDevs/AstrBot/issues/4831)) - 🔥 新增子代理(SubAgent)编排器。(实验性)([#4697](https://github.com/AstrBotDevs/AstrBot/issues/4831)) - 🔥 AstrBot 目前可以直接通过调用 tool 将图片 / 文件推送给用户,大大提高交互效果。 - 新增 Computer Use 运行时配置,以融合 Skil | Low | 2/3/2026 |
| v4.13.2 | ## What's Changed ### fixes - feat(chat): feat: trace and log file config ([#4747](https://github.com/AstrBotDevs/AstrBot/issues/4747)) - fix: WebUI shows success message when skills upload failed ([#4768](https://github.com/AstrBotDevs/AstrBot/issues/4768)) - fix: cannot use tools when using skills-like tool schema mode ([#4775](https://github.com/AstrBotDevs/AstrBot/issues/4775)) - fix(context): llm tools' origin in WebUI displayed `unknown` ([#4776](https://github.com/AstrBotDevs/AstrBot/is | Low | 1/31/2026 |
| v4.13.1 | ## What's Changed ### fixes - feat(chat): refactor message rendering and introduce ToolCallItem component - fix(db): using lambda expression to ensure updated_at field ([#4730](https://github.com/AstrBotDevs/AstrBot/issues/4730)) - fix(skills): update SANDBOX_SKILLS_ROOT path to use relative directory ## What's Changed * fix(db): using lambda expression to ensure updated_at field by @SXP-Simon in https://github.com/AstrBotDevs/AstrBot/pull/4730 **Full Changelog**: https://github | Low | 1/29/2026 |
| v4.13.0 | ## What's Changed ### 新功能 - 支持 Anthropic Skills 导入和使用。参见 [Skills](https://docs.astrbot.app/use/skills.html); - 支持新的 Tool Schema 模式:Skill-like。通过两阶段调用来减少 Tool 过多的情况下,占用过多上下文的问题。 - 支持通过环境变量配置提供商 API Key。([#4696](https://github.com/AstrBotDevs/AstrBot/issues/4696)) - 支持插件的上传文件功能配置项类型 `file` ([#4539](https://github.com/AstrBotDevs/AstrBot/issues/4539)) ### 修复 - Gemini API 部分情况下工具无限循环调用 ([#4686](https://github.com/AstrBotDevs/AstrBot/issues/4686)) - 修复 WebUI GitHub 代理选择器问题及卸载插件后出现的错误 | Low | 1/28/2026 |
| v4.12.4 | ## What's Changed ### 新功能 - 为 ChatUI 添加文件拖拽上传功能 ([#4583](https://github.com/AstrBotDevs/AstrBot/issues/4583)) - 实现人格文件夹以进行高级人格管理 ([#4443](https://github.com/AstrBotDevs/AstrBot/issues/4443)) - 添加人格文件夹管理以支持层级组织 (db) - 支持 Genie TTS ### 修复 - 增强提供商选择错误处理和日志记录,避免出现 `Provider 不是 Provider 类型` 的错误 ([#4654](https://github.com/AstrBotDevs/AstrBot/issues/4654)) - aiocqhttp 适配器中的 Markdown KeyError 或 UnboundLocalError 问题 ([#4656](https://github.com/AstrBotDevs/AstrBot/issues/4656)) - 确保 provider | Low | 1/24/2026 |
| v4.12.3 | ## What's Changed - fix: 只跳过 AstrBot 预设的位于开头的 System Message,防止一些非预期行为。 - feat: 优化 ChatUI 默认的 System Message - feat: 新增 tool 调用时 `on_using_llm_tool`、tool 调用后 `on_llm_tool_respond` 的事件钩子。 - feat: 优化 ChatUI 对 Tavily 网页搜索工具的渲染,支持内联搜索引用、引用网页。 hotfix of 4.12.2 - fix: tool call error in some cases | Low | 1/17/2026 |
| v4.12.2 | ## What's Changed - fix: 只跳过 AstrBot 预设的位于开头的 System Message,防止一些非预期行为。 - feat: 优化 ChatUI 默认的 System Message - feat: 新增 tool 调用时 `on_using_llm_tool`、tool 调用后 `on_llm_tool_respond` 的事件钩子。 - feat: 优化 ChatUI 对 Tavily 网页搜索工具的渲染,支持内联搜索引用、引用网页。 | Low | 1/17/2026 |
| v4.12.1 | ## What's Changed hotfix of v4.12.0 fix: 修复会话隔离功能失效的问题。 ### 新增 - AstrBot Agent 沙箱环境(改进的代码解释器) ([#4449](https://github.com/AstrBotDevs/AstrBot/issues/4449)),详见[文档](https://docs.astrbot.app/use/astrbot-agent-sandbox.html) - ChatUI 支持项目管理 ([#4477](https://github.com/AstrBotDevs/AstrBot/issues/4477)) - 自定义规则支持批量处理。 ### 修复 - 发送 OpenAI 风格的 image_url 导致 Anthropic 返回 400 无效标签错误 ([#4444](https://github.com/AstrBotDevs/AstrBot/issues/4444)) - ChatUI 标题显示问题 ([#4486](https://github.com/ | Low | 1/15/2026 |
| v4.12.0 | ## What's Changed ### 新增 - AstrBot 代理沙箱环境(改进的代码解释器) ([#4449](https://github.com/AstrBotDevs/AstrBot/issues/4449)),详见[文档](https://docs.astrbot.app/use/astrbot-agent-sandbox.html) - ChatUI 支持项目管理 ([#4477](https://github.com/AstrBotDevs/AstrBot/issues/4477)) - 自定义规则支持批量处理。 ### 修复 - 发送 OpenAI 风格的 image_url 导致 Anthropic 返回 400 无效标签错误 ([#4444](https://github.com/AstrBotDevs/AstrBot/issues/4444)) - ChatUI 标题显示问题 ([#4486](https://github.com/AstrBotDevs/AstrBot/issues/4486)) - 确保 ChatUI 消息流顺序正确 ([#44 | Low | 1/15/2026 |
| v4.11.4 | ## What's Changed ### Fixes - detect image MIME type from binary data for Anthropic API ([#4426](https://github.com/AstrBotDevs/AstrBot/issues/4426)) - correct duplicate word in agent logger warning ([#4390](https://github.com/AstrBotDevs/AstrBot/issues/4390)) - sannitize llm context by modalities ([#4367](https://github.com/AstrBotDevs/AstrBot/issues/4367)) - fix list config being saved as [""] instead of [] after deletion ([#4401](https://github.com/AstrBotDevs/AstrBot/issues/4401)) | Low | 1/12/2026 |
| v4.11.3 | ## What's Changed ### Fixes - detect image MIME type from binary data for Anthropic API ([#4426](https://github.com/AstrBotDevs/AstrBot/issues/4426)) - correct duplicate word in agent logger warning ([#4390](https://github.com/AstrBotDevs/AstrBot/issues/4390)) - sannitize llm context by modalities ([#4367](https://github.com/AstrBotDevs/AstrBot/issues/4367)) - fix list config being saved as [""] instead of [] after deletion ([#4401](https://github.com/AstrBotDevs/AstrBot/issues/4401)) ### Imp | Low | 1/12/2026 |
| v4.11.2 | ## What's Changed ### Features - feat: supports to display plugin CHANGELOG.md ([#4337](https://github.com/AstrBotDevs/AstrBot/issues/4337)) ### Fixes - fix: conversation was still saved to the context after `stop_event` ([#4345](https://github.com/AstrBotDevs/AstrBot/issues/4345)) - fix: on_waiting_llm_request hook did not check message validity ([#4349](https://github.com/AstrBotDevs/AstrBot/issues/4349)) fix(webui): maintain international consistency of the 'repo' button ([#4358](https:// | Low | 1/8/2026 |
| v4.11.1 | ## What's Changed hotfix of v4.11.0 修复: 1. 修复: 部分情况下选择提供商的时候出现”暂无可用提供商的问题“,即使实际上已经配置了模型(提供商)。 2. 优化:提供商源 ID、提供商 ID 和模型 ID 的提示信息,帮助用户更好理解各个 ID 的含义。 ### 新增 - 支持上下文自动压缩功能。入口:配置文件 -> 上下文管理策略 -> 超出模型上下文窗口时的处理方式。详情请查看: [自动上下文压缩](https://docs.astrbot.app/use/context-compress.html) ([#4322](https://github.com/AstrBotDevs/AstrBot/issues/4322)) - 新增 `on_waiting_llm_request` 事件钩子 ([#4319](https://github.com/AstrBotDevs/AstrBot/issues/4319)) - WebUI 支持强制更新插件 ([#4293](https://github.com/Ast | Low | 1/5/2026 |
| v4.11.0 | ## What's Changed ### 新增 - 支持上下文自动压缩功能。入口:配置文件 -> 上下文管理策略 -> 超出模型上下文窗口时的处理方式。详情请查看: [自动上下文压缩](https://docs.astrbot.app/use/context-compress.html) ([#4322](https://github.com/AstrBotDevs/AstrBot/issues/4322)) - 新增 `on_waiting_llm_request` 事件钩子 ([#4319](https://github.com/AstrBotDevs/AstrBot/issues/4319)) - WebUI 支持强制更新插件 ([#4293](https://github.com/AstrBotDevs/AstrBot/issues/4293)) - 社区已提供适用于 [Matrix](https://github.com/stevessr/astrbot_plugin_matrix_adapter) 平台的适配器插件 ### 修复 - 修复微信公众号中由于 msg. | Low | 1/5/2026 |