v4.17.4

What's Changed

新增

• 新增 NVIDIA Provider 模板，便于快速接入 NVIDIA 模型服务 (#5157)。
• 支持在 WebUI 搜索配置

修复

• 修复 CronJob 页面操作列按钮重叠问题，提升任务管理可用性 (#5163)。

优化

• 优化 Python / Shell 本地执行工具的权限拒绝提示信息引导，提升排障可读性。
• Provider 来源面板样式升级，新增菜单交互并完善移动端适配。
• PersonaForm 组件增强响应式布局与样式细节，改进不同屏幕下的编辑体验 (#5162)。
• 配置页面新增未保存变更提示，减少误操作导致的配置丢失。
• 配置相关组件新增搜索能力并同步更新界面交互，提升配置项定位效率 (#5168)。

What's Changed (EN)

New Features

• Added an NVIDIA provider template for faster integration with NVIDIA model services (#5157).
• Added an announcement section to the Welcome page, with localized announcement title support.
• Added an FAQ link to the vertical sidebar and updated navigation for localization.

Fixes

• Fixed overlapping action buttons in the CronJob page action column to improve task management usability (#5163).
• Improved permission-denied messages for local execution in Python and shell tools for better troubleshooting clarity.

Improvements

• Enhanced the provider sources panel with a refined menu style and better mobile support.
• Improved PersonaForm with responsive layout and styling updates for better editing experience across screen sizes (#5162).
• Added an unsaved-changes notice on the configuration page to reduce accidental config loss.
• Added search functionality to configuration components and updated related UI interactions for faster settings discovery (#5168).

v4.17.3

What's Changed

修复

• ‼️ 修复 Python 3.14 环境下 'Plain' object has no attribute 'text' 报错问题 (#5154)。
• ‼️ 修复插件元数据处理流程：在实例化前注入必要属性，避免初始化阶段元数据缺失 (#5155)。
• 修复桌面端后端构建中 AstrBot 内置插件运行时依赖未打包的问题 (#5146)。
• 修复通过 AstrBot Launcher 启动时仍被检测并触发更新的问题。

优化

• Webchat 下，使用 astrbot_execute_ipython 工具如果返回了图片，会自动将图片发送到聊天中。

其他

• 执行 ruff format 代码格式整理。

What's Changed (EN)

Fixes

• ‼️ Fixed plugin metadata handling by injecting required attributes before instantiation to avoid missing metadata during initialization (#5155).
• ‼️ Fixed 'Plain' object has no attribute 'text' error when using Python 3.14 (#5154).
• Fixed missing runtime dependencies for built-in plugins in desktop backend builds (#5146).
• Fixed update checks being triggered when AstrBot is launched via AstrBot Launcher.

Improvements

• In Webchat, when using the astrbot_execute_ipython tool, if an image is returned, it will automatically be sent to the chat.

Others

• Applied ruff format code formatting.

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.

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.

新增

• 新增 LINE 平台适配器与相关配置支持 (#5085)
• 新增备用回退聊天模型列表，当主模型报错时自动切换到备用模型 (#5109)
• 新增插件加载失败后的热重载支持，便于插件修复后快速恢复 (#5043)
• WebUI 新增 SSL 配置选项并同步更新相关日志行为 (#5117)

修复

• 修复 Dockerfile 中依赖导出流程，增加 uv lock 步骤并移除不必要的 --frozen 参数，提升构建稳定性 (#5091, #5089)
• 修复首次启动公告 FIRST_NOTICE.md 的本地化路径解析问题，补充兼容路径处理 (#5083, #5082)

优化

• 日志系统由 colorlog 切换为 loguru，增强日志输出与展示能力 (#5115)

What's Changed (EN)

New Features

• Added LINE platform adapter support with related configuration options (#5085)
• Added fallback chat model chain support in tool loop runner, with corresponding config and improved provider selection display (#5109)
• Added hot reload support after plugin load failure for faster recovery during plugin development and maintenance (#5043)
• Added SSL configuration options for WebUI and updated related logging behavior (#5117)

Fixes

• Fixed Dockerfile dependency export flow by adding a uv lock step and removing unnecessary --frozen flag to improve build stability (#5091, #5089)
• Fixed locale path resolution for FIRST_NOTICE.md and added compatible fallback handling (#5083, #5082)

Improvements

• Replaced colorlog with loguru to improve logging capabilities and console display (#5115)

v4.17.0

What's Changed

新增

• 新增 LINE 平台适配器与相关配置支持 (#5085)
• 新增备用回退聊天模型列表，当主模型报错时自动切换到备用模型 (#5109)
• 新增插件加载失败后的热重载支持，便于插件修复后快速恢复 (#5043)
• WebUI 新增 SSL 配置选项并同步更新相关日志行为 (#5117)

修复

• 修复 Dockerfile 中依赖导出流程，增加 uv lock 步骤并移除不必要的 --frozen 参数，提升构建稳定性 (#5091, #5089)
• 修复首次启动公告 FIRST_NOTICE.md 的本地化路径解析问题，补充兼容路径处理 (#5083, #5082)

优化

• 日志系统由 colorlog 切换为 loguru，增强日志输出与展示能力 (#5115)

What's Changed (EN)

New Features

• Added LINE platform adapter support with related configuration options (#5085)
• Added fallback chat model chain support in tool loop runner, with corresponding config and improved provider selection display (#5109)
• Added hot reload support after plugin load failure for faster recovery during plugin development and maintenance (#5043)
• Added SSL configuration options for WebUI and updated related logging behavior (#5117)

Fixes

• Fixed Dockerfile dependency export flow by adding a uv lock step and removing unnecessary --frozen flag to improve build stability (#5091, #5089)
• Fixed locale path resolution for FIRST_NOTICE.md and added compatible fallback handling (#5083, #5082)

Improvements

• Replaced colorlog with loguru to improve logging capabilities and console display (#5115)

v4.16.0

What's Changed

新增

• QQ 官方机器人平台支持主动推送消息，私聊场景支持接收文件 (#5066)
• 为 Telegram 平台适配器新增等待 AI 回复时自动展示 “正在输入”、“正在上传图片” 等状态的功能 (#5037)
• 为飞书适配器增加接收文件、读取引用消息的内容（包括引用的图片、视频、文件、文字等） (#5018)
• 新增自定义平台适配器 i18n 支持 (#5045)
• 新增临时文件处理能力，可在系统配置中限制 data/temp 目录的最大大小。 (#5026)
• 增加首次启动公告功能，支持多语言与 WebUI 集成

修复

• 修复 OpenRouter DeepSeek 场景下的 chunk 错误 (#5069)
• 修复备份时人格文件夹映射缺失问题 (#5042)
• 修复更新日志与官方文档弹窗双滚动条问题 (#5060)
• 修复 provider 额外参数弹窗 key 显示异常
• 修复连接失败时错误日志提示不准确的问题
• 修复提前返回时未等待 reset 协程导致的资源清理问题 (#5033)
• 提升打包版桌面端启动稳定性并优化插件依赖处理 (#5031)
• 为 Electron 与后端日志增加按大小轮转 (#5029)
• 加固冻结运行时（frozen app runtime）插件依赖加载流程 (#5015)

优化

• 完善合并消息、引用解析与图片回退，并支持配置化控制 (#5054)
• 配置页面支持通过侧边栏子项切换普通配置/系统配置，并补充相关路由修复
• 优化分段回复间隔时间初始化逻辑 (#5068)

文档与维护

• 同步并修正 README 文档内容与拼写 (#5055, #5014)
• 新增 AUR 安装方式说明 (#4879)
• 执行代码格式化（ruff）

What's Changed (EN)

New Features

• Added proactive message push and private-chat file receiving support for the QQ official bot adapter (#5066)
• Added automatic "typing..." and "uploading image..." status display while waiting for AI response in the Telegram adapter (#5037)
• Added file receiving and quoted message content reading (including quoted images, videos, files, text, etc.) for the Feishu adapter (#5018)
• Added i18n support for custom platform adapters (#5045)
• Introduced temporary file handling and TempDirCleaner (#5026)
• Added a first-launch notice feature with multilingual content and WebUI integration

Fixes

• Added sidebar child-tab switching for normal/system config and fixed related routing behavior on the config page
• Fixed chunk errors when using OpenRouter DeepSeek (#5069)
• Improved forwarded-quote parsing and image fallback with configurable controls (#5054)
• Fixed missing persona-folder mapping in backup exports (#5042)
• Fixed double scrollbar issue in changelog and official docs dialogs (#5060)
• Fixed key rendering issues in the provider extra-params dialog
• Improved error log wording for connection failures
• Fixed unawaited reset coroutine cleanup on early returns (#5033)
• Improved packaged desktop startup stability and plugin dependency handling (#5031)
• Added size-based log rotation for Electron and backend logs (#5029)
• Hardened plugin dependency loading in frozen app runtime (#5015)

Improvements

• Optimized initialization logic for segmented-reply interval timing (#5068)

Docs & Maintenance

• Synced and fixed README docs and typos (#5055, #5014)
• Added AUR installation instructions (#4879)
• Applied code formatting with ruff

Details

• fix: harden plugin dependency loading in frozen app runtime by @zouyonghe in #5015
• feat: adding support for media and quoted message attachments for feishu by @Soulter in #5018
• docs: add AUR installation method by @LIghtJUNction in #4879
• fix(desktop): 为 Electron 与后端日志增加按大小轮转 by @zouyonghe in #5029
• fix: 提升打包版桌面端启动稳定性并优化插件依赖处理 by @zouyonghe in #5031
• feat: temporary file handling and introduce TempDirCleaner by @Soulter in #5026
• fix: close unawaited reset coroutine on early return by @Limitless2023 in #5033
• docs: clean and sync README by @letr007 in #5014
• feat: add send_chat_action for Telegram platform adapter by @evpeople in #5037
• fix: 修复更新日志、官方文档弹窗双滚动条问题 by @SnowNightt in #5060
• docs: sync and fix readme typo by @letr007 in #5055
• fix: 修复备份时缺失的人格文件夹映射 by @xzj0898 in #5042
• feat: QQ 官方机器人平台支持主动推送消息、私聊场景下支持接收文件 by @Soulter in #5066
• perf: 优化分段回复间隔时间的初始化逻辑 by @Soulter in #5068
• fix: chunk err when using openrouter deepseek by @Soulter in #5069
• feat: add i18n supports for custom platform adapters by @stevessr in #5045
• fix: 完善转发引用解析与图片回退并支持配置化控制 by @zouyonghe in #5054

New Contributors

• @Limitless2023 made their first contribution in #5033
• @evpeople made their first contribution in #5037
• @SnowNightt made their first contribution in #5060
• @xzj0898 made their first contribution in #5042

Full Changelog: v4.15.0...v4.16.0

v4.15.0

What's Changed

⚠️ 提醒 v4.14.8 用户：由于 v4.14.8 版本 Bug，若您未使用 Electron AstrBot 桌面应用，会被错误地通过 WebUI 对话框跳转到 Github Releases 页。
类似出现如下对话框：

如果是这种情况，不要下载和安装下面的安装包。您有两种升级方式：

1. 您可能需要手动重新部署 AstrBot 才能升级。（如果可以打开更新页面切换新版本则可以忽略此提醒）
2. 下载此文件，解压后放到 AstrBot 的 data 目录下，替换 dist 目录，然后刷新 WebUI 界面，重新点击更新按钮即可恢复原来的更新对话框。

新增

• 企业微信智能机器人支持主动消息推送，并新增视频、文件等消息类型支持 (#4999)
• 企业微信应用支持主动消息推送，并优化企微应用、微信公众号、微信客服的音频处理流程 (#4998)
• 钉钉适配器支持主动消息推送，并新增图片、视频、音频等消息类型支持 (#4986)
• 人格管理弹窗新增删除按钮 (#4978)

修复

• 修复 SubAgents 工具去重相关问题 (#4990)
• 改进 WeCom AI Bot 的流式消息处理逻辑，提升分段与流式回复稳定性 (#5000)
• 稳定源码与 Electron 打包环境下的 pip 安装行为，并修复非 Electron 场景点击 WebUI 更新按钮时误触发跳转对话框的问题 (#4996)
• 修复桌面端后端构建时 certifi 数据收集问题 (#4995)
• 修复冻结运行时（frozen runtime）中的 pip install 执行问题 (#4985)
• 为 Windows ARM64 通过 vcpkg 预置 OpenSSL，修复相关构建准备问题

优化

• 更新 pydantic 依赖版本 (#4980)
• 调整 GHCR namespace 的 CI 配置

What's Changed (EN)

New Features

• Enhanced persona tool management and improved UI localization for subagent orchestration (#4990)
• Added proactive message push for WeCom AI Bot, with support for video, file, and more message types (#4999)
• Added proactive message push for WeCom app, and improved audio handling for WeCom app, WeChat Official Account, and WeCom customer service (#4998)
• Enhanced Dingtalk adapter with proactive push and support for image, video, and audio message types (#4986)
• Added a delete button to the persona management dialog for better usability (#4978)

Fixes

• Improved streaming message handling in WeCom AI Bot for better segmented and streaming reply stability (#5000)
• Stabilized pip installation behavior in source and Electron packaged environments, and fixed the unexpected redirect dialog when clicking WebUI update in non-Electron mode (#4996)
• Fixed certifi data collection in desktop backend build (#4995)
• Fixed pip install execution in frozen runtime (#4985)
• Prepared OpenSSL via vcpkg for Windows ARM64 build flow

Improvements

• Updated pydantic dependency version (#4980)
• Updated CI configuration for GHCR namespace

Details

• feat: refactor release workflow and add special update handling for electron app by @Soulter in #4969
• chore: auto ann fix by ruff by @Dt8333 in #4903
• chore: update pydantic dependency version by @Soulter in #4980
• feat: add delete button to persona management dialog by @Copilot in #4978
• feat: enhance Dingtalk adapter with active push message and image, video, audio message type by @Soulter in #4986
• fix: handle pip install execution in frozen runtime by @zouyonghe in #4985
• 修复electron打包方式下证书问题 by @Raven95676 in #4995
• feat: 企业微信应用 支持主动消息推送，并优化企微应用、微信公众号、微信客服音频相关的处理 by @Soulter in #4998
• feat: 企业微信智能机器人支持主动消息推送以及发送视频、文件等消息类型支持 by @Soulter in #4999
• feat: enhance WecomAIBotAdapter and WecomAIBotMessageEvent for improved streaming message handling by @Soulter in #5000
• feat: enhance persona tool management and update UI localization for subagent orchestration by @Soulter in #4990
• perf: 稳定源码与 Electron 打包环境下的 pip 安装行为，并修复非 Electron 环境下点击 WebUI 更新按钮时出现跳转对话框的问题 by @zouyonghe in #4996
• fix: 'HandoffTool' object has no attribute 'agent' by @Li-shi-ling in #5005
• chore(deps): bump the github-actions group with 2 updates by @dependabot[bot] in #5006
• fix: stabilize packaged runtime pip/ssl behavior and mac font fallback by @zouyonghe in #5007
• fix: 修复 Windows 打包版后端重启失败问题 by @zouyonghe in #5009
• fix: 修复app内重启异常，修复app内点击重启不能立刻提示重启，以及在后端就绪时及时刷新界面的问题 by @zouyonghe in #5013
• chore: bump version to 4.15.0 by @Soulter in #5003

Full Changelog: v4.14.7...v4.15.0

v4.14.8

What's Changed

hotfix of 4.14.7

• 为 AstrBot Electron App 增加特殊的更新处理。

修复

• 人格预设对话可能会重复添加到上下文 (#4961)

新增

• 增加提供商级别的代理支持 (#4949)
• WebUI 管理行为增加插件指令权限管理功能 (#4887)
• 允许 LLM 预览工具返回的图片并自主决定是否发送 (#4895)
• Telegram 平台添加媒体组（相册）支持 (#4893)
• 增加欢迎功能，支持本地化内容和新手引导步骤
• 支持 Electron 桌面应用部署 (#4952)

注意

• 更新 AstrBot Python 版本要求至 3.12 (#4963)

What's Changed

Fixes

• Fixed issue where persona preset conversations could be duplicated in context (#4961)

Features

• Added provider-level proxy support (#4949)
• Added plugin command permission management to WebUI management behavior (#4887)
• Allowed LLMs to preview images returned by tools and autonomously decide whether to send them (#4895)
• Added media group (album) support for Telegram platform (#4893)
• Added welcome feature with support for localized content and onboarding steps
• Supported Electron desktop application deployment (#4952)

Notice

• Updated AstrBot Python version requirement to 3.12 (#4963)

v4.14.7

What's Changed

修复

• 人格预设对话可能会重复添加到上下文 (#4961)

新增

• 增加提供商级别的代理支持 (#4949)
• WebUI 管理行为增加插件指令权限管理功能 (#4887)
• 允许 LLM 预览工具返回的图片并自主决定是否发送 (#4895)
• Telegram 平台添加媒体组（相册）支持 (#4893)
• 增加欢迎功能，支持本地化内容和新手引导步骤
• 支持 Electron 桌面应用部署 (#4952)

注意

• 更新 AstrBot Python 版本要求至 3.12 (#4963)

What's Changed

Fixes

• Fixed issue where persona preset conversations could be duplicated in context (#4961)

Features

• Added provider-level proxy support (#4949)
• Added plugin command permission management to WebUI management behavior (#4887)
• Allowed LLMs to preview images returned by tools and autonomously decide whether to send them (#4895)
• Added media group (album) support for Telegram platform (#4893)
• Added welcome feature with support for localized content and onboarding steps
• Supported Electron desktop application deployment (#4952)

Notice

• Updated AstrBot Python version requirement to 3.12 (#4963)

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 #4938
• perf: optimize webchat and wecom ai queue lifecycle by @Soulter in #4941

Full Changelog: v4.14.5...v4.14.6