AstrBotDevs/AstrBot v4.29.0-beta.2

on GitHub

[4.29.0-beta.2] - 2026-10-11

This prerelease includes changes since v4.29.0-beta.1.

Major Additions

• WebUI: Added model settings shortcuts beside selected models and in model/fallback menus. Changes save immediately for every configuration profile using that model. (#10321)
• WebUI: Added console log search and keyword highlighting, source badges for Skills, staged image previews in ChatUI, and remembered the last opened Data & Logs tab. (#10327, #10339, #10376, #10251)
• WebUI: Added configuration profile editing in a side drawer from the bot editor. (#10310)
• Docker: Included the astrbot CLI for password reset inside containers. (#10442)

Major Optimizations

• WebUI: Significantly reduced initial loading overhead and improved loading speed by lazy-loading VAD, Monaco, translations, and ApexCharts, and enabling gzip responses. (#10413)
• WebUI: Kept content borders and corners fixed while scrolling, added 6px desktop right/bottom gaps, and pinned configuration/settings headers and section navigation while the content pane scrolls. (#10480)
• Computer Use: Clarified local permission access modes, kept execution and file access controls visible when local isolation is unavailable, and linked setup guidance to the consolidated Agent Sandbox guide. (#10444, #10445, #10487)
• Docs: Refreshed Chinese and English plugin and built-in AI guides with current workflows, troubleshooting, and localized screenshots; updated Slack and Lark/Feishu setup instructions. (#10487, #10353, #10400)

Major Fixes

• Agent: Stopping a session now stops its background agent work and prevents late main-agent wakeups. Cleaned up session waiters only once and kept async tool generators in the same task. (#10323, #10347, #10474)
• Agent: Warned when a background task result is not delivered to the user and avoided recording cron sends without a matching platform. (#10398, #10468)
• Core: Fell back promptly after failed context summaries, matched command group names as whole words, maintained one editable system default persona, and preserved child folders when deleting persona folders. (#10436, #10372, #10287, #10361)
• Providers: Preserved Anthropic tool calls with empty streamed input, merged custom server tools with registered tools, replaced the retired Gemini embedding default with gemini-embedding-001, and handled CRLF separators in Dify streams. (#10432, #10437, #10393, #10392)
• Images: Rejected unresolved and non-regular image references instead of fabricating local paths, retained pending-path handling for audio/video/files, and skipped invalid images during non-strict payload assembly. Added tolerance for oversized base64 payloads and long Windows paths. (#10434)
• Audio: Degraded unresolvable voice attachments without failing the turn, avoided blocking format probes, and closed FishAudio TTS clients after requests. (#10337, #10055, #10358)
• Platforms: Fixed UTF-16 offsets and case-insensitive bot mentions in Telegram, and left the Telegram token empty by default. Preserved Slack code blocks, quotes, lists, links, and mentions, and resolved remote Slack files before upload. Sent Discord video components as attachments and prevented self-reply loops. (#10367, #10399, #10365, #10380, #10447, #10448, #10355, #10423, #10425)
• WebUI: Enforced session ownership when sending chat messages, stored attachments under unique names, restored plugin README anchors, and corrected dark-mode log search and default-profile localization. (#10346, #10356, #10341, #10351, #10296)
• WebUI: Refreshed navigation and provider icons, corrected the configuration test-chat button theme color, and updated the plugin submission link and label. Reused logo tokens and refreshed expired platform caches. (#10304, #10332, #10309, #10471, #10294)

Navigation and Configuration Changes

• Sidebar: Core entries are grouped under System; Personas, Knowledge Base, scheduled tasks, subagent orchestration, and plugin Views appear under Extensions. The version is displayed in the sidebar footer. (#10304, #10307)
• Configuration: Moved administrator and whitelist settings to Access Control, and renamed Platform to Platforms & Messages. (#10321)
• Configuration: Moved text-to-image rendering settings from System Settings to the Extensions section of configuration profiles. Each profile now has its own text-to-image settings. (#10306)
• Appearance: Removed the Customize Sidebar feature. (#10480)
• Docs: Improved the guides in the Usage section. (#10487)

中文

本预发布版本包含自 v4.29.0-beta.1 以来的变更。

主要新增

• WebUI：模型选择器旁及模型、回退模型菜单内新增设置入口，修改后立即影响引用该模型的所有配置文件。 (#10321)
• WebUI：新增控制台日志搜索与关键词高亮、Skills 来源标识、ChatUI 待发送图片预览，并记住「数据与日志」页上次打开的标签。 (#10327, #10339, #10376, #10251)
• WebUI：支持在机器人编辑器的侧边抽屉中编辑配置文件。 (#10310)
• Docker：镜像内包含 astrbot CLI，可在容器中重置密码。 (#10442)

主要优化

• WebUI：延迟加载 VAD、Monaco、多语言资源及 ApexCharts，并启用 gzip 响应，大幅降低首屏加载开销，提高加载速度。 (#10413)
• WebUI：滚动时固定内容卡片边框与圆角，桌面端右侧和底部各保留 6px 间隔；配置页和设置页固定顶部及分区导航，仅滚动内容区域。 (#10480)
• 电脑使用：明确本地权限访问模式，在本地隔离不可用时继续显示执行与文件访问控制，并通过设置引导弹窗链接到整合后的 Agent 沙箱指南。 (#10444, #10445, #10487)
• 文档：更新中英文插件及内置 AI 指南，补充当前操作流程、故障排查与本地化截图；更新 Slack 和飞书配置说明。 (#10487, #10353, #10400)

主要修复

• Agent：停止会话时同步停止后台 Agent 工作，避免稍后重新唤醒主 Agent；会话等待器仅清理一次，异步工具生成器始终在同一任务中执行。 (#10323, #10347, #10474)
• Agent：后台任务结果未发送给用户时提供提示；不存在匹配平台时不再记录 cron 发送成功。 (#10398, #10468)
• Core：上下文摘要失败后及时回退，命令组名称按完整单词匹配，保留唯一可编辑的系统默认人格，并在删除人格文件夹时保留子文件夹。 (#10436, #10372, #10287, #10361)
• 模型提供商：保留流式输入为空的 Anthropic 工具调用，将自定义服务端工具与已注册工具合并，将退役的 Gemini 默认嵌入模型替换为 gemini-embedding-001，并兼容 Dify 流式响应的 CRLF 分隔符。 (#10432, #10437, #10393, #10392)
• 图片：无法解析或指向非普通文件的图片引用不再伪装成本地路径；保留音频、视频和文件的待生成路径行为，非严格模式组装请求时跳过无效图片，并兼容超长 base64 数据及 Windows 长路径。 (#10434)
• 音频：无法解析的语音附件不再导致整轮请求失败，音频格式探测不再阻塞，并在请求后关闭 FishAudio TTS 客户端。 (#10337, #10055, #10358)
• 消息平台：修复 Telegram 提及的 UTF-16 偏移与大小写匹配，默认留空机器人令牌；保留 Slack 代码块、引用、列表、链接及用户提及，上传前解析远程文件；Discord 视频组件按附件发送，并避免机器人自回复循环。 (#10367, #10399, #10365, #10380, #10447, #10448, #10355, #10423, #10425)
• WebUI：发送聊天消息时校验会话归属，附件使用唯一文件名，恢复插件 README 锚点跳转，并修复深色模式日志搜索及默认配置文件名称的本地化。 (#10346, #10356, #10341, #10351, #10296)
• WebUI：更新导航及模型提供商图标，修正配置试聊按钮主题色，更新插件提交入口及文案；复用 logo 令牌并刷新过期的平台缓存。 (#10304, #10332, #10309, #10471, #10294)

导航与配置迁移

• 侧边栏：核心入口归入「系统」；人格、知识库、定时任务、子 Agent 编排及插件视图归入「扩展功能」，版本号移至侧边栏底部。 (#10304, #10307)
• 配置：将管理员、白名单配置挪动到 访问控制 分区；平台分区更名为「平台与消息」。 (#10321)
• 配置：将设置中的 文本转图片渲染 配置挪动到 扩展功能 分区，文转图配置按配置文件隔离。 (#10306)
• 外观：移除 “自定义侧边栏” 功能 (#10480)
• 文档：完善文档的 “使用” 部分下的各个文档。 (#10487)

Full Changelog: v4.29.0-beta.1...v4.29.0-beta.2