v4.27.0

4.27.0 - 2026-08-02

Per aspera ad astra.

Added

• Added persistent group message history with configurable retention, normalized storage, and an LLM tool for searching and retrieving messages from the current group. (#9465)
• Added managed local shell sessions with incremental output, stdin writes, interruption, termination, timeouts, and lifecycle cleanup; Windows sessions now use PowerShell and line-oriented programs support explicit line writes. (#9470, #9471, #9501)
• Added a unified extension and persona management experience with shared capability selectors, routed plugin workspaces, and clearer MCP server, tool, and Skill provenance and status. (#9499)
• Added built-in skill-creator, documents, pdf, and spreadsheets Skills for creating reusable Skills and working with office documents, PDFs, and spreadsheets.
• Added installation and updates for plugins hosted in generic HTTP(S), SSH, and SCP-style Git repositories. (#9493)
• Converted ChatUI pastes longer than 10,000 characters into text attachments. (#9496)
• Added sensitive API key sub-scopes for administrator chat access and administrator configuration changes, plus generated scope-to-endpoint reference documentation. (#9503)

Changed

• Improved knowledge base retrieval quality with normalized dense/sparse relative-score fusion and source-document diversification. (#9455)
• Enriched knowledge base embeddings with document context and preserved heading paths. (#9457)
• Centralized core, dashboard, and plugin update flows behind a safer updater architecture with package and metadata verification. (#9493)
• Formalized existing deprecated APIs with runtime warnings and corrected the OpenAI tool-call conversion method name while retaining a backward-compatible alias. (#9468, #9469)
• Refined the Skills cards, persona management, extension workspace, and project chat composer layouts.
• Used compact timestamp-based transient filenames and clearer workspace-relative path guidance to reduce tool path token usage. (#9505)
• Returned concise plain-text results for completed local shell commands while retaining managed-session metadata for active commands. (#9507)

Fixed

• Deferred the BM25 dependency import so AstrBot can start and use FTS5 retrieval on CPUs incompatible with the installed NumPy build. (#9435)
• Made knowledge base rank fusion deterministic and surfaced vLLM rerank response failures. (#9454)
• Preserved ChatUI streaming response tails and prevented QQ Official streaming buffers from losing leading characters. (#9439, #9444)
• Localized future task timestamps with the system timezone. (#9462)
• Isolated managed local shell sessions by sender, while allowing conversation administrators to manage sessions in their conversation. (#9479)
• Hardened API key authorization boundaries for administrator identities, sensitive configuration, and project workspace paths. (#9503)
• Persisted terminal tool calls, results, and trusted token usage when no assistant response is produced. (#9500)
• Prevented expanded ChatUI composers, replies, and attachments from overlapping the latest messages. (#9496)
• Removed the double scrollbar from the mobile plugin configuration dialog. (#9491)
• Recreated the tool image cache directory after storage cleanup so new images can still be saved. (#9490)
• Kept outbound TTS and QQ Official audio available until global temporary-file cleanup so asynchronous downloads do not fail. (#9506)

Documentation

• Added QQ community groups 15 and 16 to the community documentation.

Maintenance

• Removed an unused tool image cleanup path in favor of the global temporary-directory cleaner. (#9504)

中文

新增

• 新增可配置保留数量的群消息历史持久化能力，支持标准化存储，并提供供 LLM 搜索和读取当前群历史消息的工具。 (#9465)
• 新增本地托管 Shell 会话，支持增量输出、标准输入、打断、终止、超时和生命周期清理；Windows 会话改用 PowerShell，并支持显式按行写入。 (#9470, #9471, #9501)
• 统一扩展与人格管理体验，提供共享的能力选择器、路由化插件工作区，以及更清晰的 MCP 服务、工具和 Skill 来源与状态展示。 (#9499)
• 新增内置的 skill-creator、documents、pdf 和 spreadsheets Skills，支持创建可复用 Skill，以及处理办公文档、PDF 和电子表格。
• 支持从通用 HTTP(S)、SSH 和 SCP 风格 Git 仓库安装和更新插件。 (#9493)
• ChatUI 粘贴超过 10,000 字符的文本时，自动转换为文本附件。 (#9496)
• 新增管理员聊天访问和管理员配置修改的敏感 API Key 子权限，并生成权限到接口的参考文档。 (#9503)

变更

• 通过归一化稠密/稀疏相对分数融合和来源文档去重，提升知识库检索质量。 (#9455)
• 使用文档上下文增强知识库 Embedding，并保留标题层级路径。 (#9457)
• 将核心、Dashboard 和插件更新流程统一到更安全的更新架构中，并增加安装包与元数据校验。 (#9493)
• 为已有废弃 API 增加运行时警告，修正 OpenAI 工具调用转换方法名，同时保留向后兼容别名。 (#9468, #9469)
• 优化 Skill 卡片、人格管理、扩展工作区和项目聊天输入区的布局。
• 使用紧凑的时间戳临时文件名并明确工作区相对路径指引，减少工具路径占用的 Token。 (#9505)
• 对已完成的本地 Shell 命令返回精简纯文本结果，对运行中的命令继续保留托管会话元数据。 (#9507)

修复

• 延迟导入 BM25 依赖，使安装的 NumPy 与 CPU 不兼容时，AstrBot 仍可启动并使用 FTS5 检索。 (#9435)
• 确保知识库排名融合结果稳定，并正确暴露 vLLM 重排序响应错误。 (#9454)
• 保留 ChatUI 流式响应末尾内容，并避免 QQ 官方机器人流式缓冲丢失开头字符。 (#9439, #9444)
• 使用系统时区处理未来任务时间。 (#9462)
• 按发送者隔离本地托管 Shell 会话，同时允许会话管理员管理所在会话中的 Shell 会话。 (#9479)
• 加固 API Key 对管理员身份、敏感配置和项目工作区路径的授权边界。 (#9503)
• 在没有助手回复时，仍持久化终端工具调用、结果和可信 Token 用量。 (#9500)
• 避免展开后的 ChatUI 输入区、回复和附件遮挡最新消息。 (#9496)
• 移除移动端插件配置弹窗中的双重滚动条。 (#9491)
• 存储清理后自动重建工具图片缓存目录，确保仍可保存新图片。 (#9490)
• 将 TTS 和 QQ 官方机器人出站音频保留到全局临时文件清理，避免异步下载失败。 (#9506)

文档

• 在社区文档中新增 QQ 群 15 和 16。

维护

• 移除未使用的工具图片独立清理逻辑，统一交由全局临时目录清理器管理。 (#9504)

What's Changed

• fix: lazily import BM25 dependency by @Soulter in #9435
• fix: preserve streaming response tail by @wcqqq1214 in #9439
• feat: implement group message history persistence and retrieval features by @Soulter in #9465
• refactor: formalize deprecation markings with @deprecated decorators by @RC-CHN in #9468
• refactor: rename LLMResponse.to_openai_to_calls_model to to_openai_tool_calls_model by @RC-CHN in #9469
• feat: add managed local shell sessions by @Soulter in #9470
• feat: use PowerShell for Windows local shell by @Soulter in #9471
• fix: localize future task times by @wcqqq1214 in #9462
• perf: enrich knowledge base embeddings with document context by @lxfight in #9457
• fix: correct knowledge base ranking behavior by @lxfight in #9454
• fix(qqofficial): prevent leading char loss in streaming buffer by @OWWZO in #9444
• fix: isolate local shell sessions by sender by @Soulter in #9479
• refactor: simplify updater architecture by @Soulter in #9493
• fix: improve ChatUI composer behavior by @Soulter in #9496
• feat: unify extension and persona management by @Soulter in #9499
• fix: support line writes for managed shell sessions by @Soulter in #9501
• fix: harden API key scope boundaries by @Soulter in #9503
• fix: persist terminal tool history and token usage by @xiaoxuan010 in #9500
• fix: resolve double scrollbar in plugin config dialog by @Rain-0x01-39 in #9491
• refactor: remove unused tool image cleanup by @Soulter in #9504
• fix(core): recreate tool image cache directory after cleanup by @piexian in #9490
• refactor: reduce path token usage by @Soulter in #9505
• fix: simplify completed shell command output by @Soulter in #9507
• fix: defer cleanup of outbound audio files by @Soulter in #9506
• perf: improve knowledge base retrieval quality by @lxfight in #9455
• chore: bump version to 4.27.0 by @Soulter in #9509

New Contributors

• @OWWZO made their first contribution in #9444
• @xiaoxuan010 made their first contribution in #9500

Full Changelog: v4.26.8...v4.27.0