What's Changed

• fix: respect existing provider source IDs in config so that manually edited IDs are preserved on save instead of being silently reset. (#8915) (42ca89d)
• fix: created unnecessary data dir when executing astrbot command (#8932) (39d4253)
• fix: add sdist build artifact path to allow dashboard artifact to be included (#8933) (05148df)

Release v4.25.6-rc.3

Release v4.25.6-rc.2

• fix: improve WebUI update stability

Release v4.25.6-rc.1

• fix: improve WebUI update stability

• 更新日志(简体中文)
• Changelog(English)

What's Changed

• 优化更新过程的稳定性，减少更新出错的概率。
• AstrBot Core 更新包优先从 AstrBot Registry 下载，失败时回退到 GitHub zipball。
• 修复 pip 包体未正确包含 Dashboard 构建资源的问题。

What's Changed (EN)

Bug Fixes

• Changed WebUI project updates to run as backend tasks, preventing updates from being cancelled when the frontend is closed or refreshed.
• Made the update flow download and verify both WebUI and Core packages before applying files, reducing partial-update risk after download failures.
• Prefer AstrBot Registry for Core update packages, with GitHub zipball fallback.
• During update restarts, WebUI now polls backend start time and performs a cache-busted full refresh after restart completion to avoid stale frontend assets.

Build

• Updated Hatch artifact configuration so both sdist and wheel include bundled Dashboard assets.
• Added Core package build and Registry upload steps to the release workflow.

What's Changed

• fix: keep system tools with persona tool lists (#8908) (da7f53d)
• docs: 文档更新 - 指令、FAQ、网页搜索、插件发布等 (#8912) (0a0c677)
• fix: restore static runtime version (d36987d)
• fix: clarify WebUI recovery hint (ddc4e14)
• feat: add prerelease visibility toggle (f9d4082)

• 更新日志(简体中文)
• Changelog(English)

What's Changed

• 为 OpenAI、Gemini、Anthropic 等模型请求加入可配置的重试机制，并新增请求最大重试次数配置，提升临时网络错误与 5xx 服务端错误下的稳定性。(#8893)
• 新增托管 Core 包下载能力，并加强 Core 与 Dashboard 包下载归档校验。(#8888)
• 支持在请求中加载 workspace skills，并加固 workspace skill 发现流程。(#8884)
• 修复 OpenAPI 文件上传能力，恢复 /api/v1/file OpenAPI 暴露、文件范围 API Key 与相关文档/客户端产物。
• 修复新版 MCP 中 Streamable HTTP client 重命名导致的兼容问题，并保持 mcp 依赖小于 2。
• 加固人格工具边界，确保人格限定的工具范围在主 Agent 请求中正确生效。(#8786)
• 加强 Future Task 所有者校验，避免越权访问定时任务。(#8881)
• 在受限本地文件系统工具中拒绝 hardlink 文件，避免通过工作区 hardlink 别名读写允许目录外的文件。
• 新增 scripts/prepare_release.py，统一 release 分支、版本号、changelog 与校验流程。(#8891)
• 明确 OpenAPI Chat 中 username 字段的身份含义。(#8880)

What's Changed (EN)

Highlights

• Added configurable retry handling for OpenAI, Gemini, Anthropic, and related provider requests, including a maximum request retry setting to improve stability for transient network failures and 5xx server errors. (#8893)
• Added hosted Core package downloads and strengthened archive validation for hosted Core and Dashboard packages. (#8888)
• Added workspace skills support in requests and hardened workspace skill discovery. (#8884)

Bug Fixes

• Restored OpenAPI file uploads by exposing /api/v1/file, enabling file-scoped API keys, and regenerating docs/client artifacts.
• Fixed compatibility with the renamed MCP Streamable HTTP client while keeping the mcp dependency below 2.
• Hardened persona tool boundaries so persona-restricted tool scopes are enforced correctly in main Agent requests. (#8786)
• Enforced Future Task owner checks to prevent unauthorized scheduled-task access. (#8881)
• Rejected hardlinked files in restricted local filesystem tools to prevent workspace hardlink aliases from reading or overwriting files outside allowed directories.

Release Process

• Added scripts/prepare_release.py to standardize release branches, version bumps, changelog generation, and validation. (#8891)

Docs

• Clarified the identity semantics of the username field in OpenAPI Chat. (#8880)

• 更新日志(简体中文)
• Changelog(English)

What's Changed

修复

• 恢复 WebUI 在接口返回 401 时跳转登录页，避免会话失效后停留在异常状态。(#8903)
• 保持 Core 版本与 WebUI 静态资源版本同步，修复打包或升级后可能加载旧 dist、资源版本错配的问题。(#8901)
• 将知识库上下文作为临时 user 内容注入，提高缓存命中率。(#8904)

What's Changed (EN)

Bug Fixes

• Restored the WebUI login redirect when API requests return 401, preventing expired sessions from staying in a broken state. (#8903)
• Kept Core and WebUI static asset versions in sync, fixing stale dist loading and asset version mismatches after packaging or upgrades. (#8901)
• Injected knowledge base context as temporary user content, increase kv cache rate(#8904)

• 更新日志(简体中文)
• Changelog(English)

What's Changed

重点更新

• 优化 WebUI 升级流程：Core 更新改为后台任务，并在检测到 WebUI 与 Core 版本错配时提供自动恢复重启引导，避免刷新页面后卡在 Missing API key。(#8846)
• 增强 QQ 官方机器人群聊能力，支持群消息创建类型，并允许 Webhook 适配器在无缓存 msg_id 时主动发送群消息。(#8838, #8841)

修复

• 修复人格编辑时重名校验不准确的问题。(#8843)
• 加固沙箱文件传输与 CUA 健康检查流程，降低异常环境下的文件操作风险。(#8840)

其他

• 将 faiss-cpu 版本基线从 1.12.0 调整为 1.14.3。(#8837)

What's Changed (EN)

Highlights

• Improved the WebUI upgrade flow by running Core updates as background tasks and adding guided recovery when WebUI/Core version mismatches are detected, preventing refreshes from leaving users stuck at Missing API key. (#8846)
• Enhanced QQ Official Bot group chat support with group message create events and proactive Webhook group sends without requiring a cached msg_id. (#8838, #8841)

Bug Fixes

• Fixed duplicate-name validation when editing personas. (#8843)
• Hardened sandbox file transfers and CUA health checks to reduce file-operation risk in abnormal environments. (#8840)

Other

• Changed the faiss-cpu version baseline from 1.12.0 to 1.14.3. (#8837)

• 更新日志(简体中文)
• Changelog(English)

What's Changed

• 修复 Gemini 工具定义没有正确传回模型导致的 Gemini 类模型重复工具调用的问题。(#8833)
• 修复 onboarding 平台配置与备份上传相关问题。(#8834)
• 修复人格设定中将工具和 Skills 从指定列表切回“默认使用全部”后不生效的问题。(#8835)
• 新增启动时重置 WebUI 密码的命令行参数 --reset-password，便于无法登录时恢复访问。(commit)

What's Changed (EN)

• Added a startup flag to reset the WebUI password, making it easier to recover access when login is unavailable. (commit)
• Fixed Gemini Provider tool definitions not being passed back to the model correctly, which could cause repeated tool calls. (#8833)
• Fixed onboarding platform configuration and backup upload issues. (#8834)
• Fixed persona tool and Skill settings not taking effect after switching from selected items back to “use all by default”. (#8835)