ContextQMD
Back to Astrbot

V4.27.0

changelogs/v4.27.0.md

4.27.16.8 KB
Original Source

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)