alt text

感谢所有的开发者和用户对 AstrBot 的支持。AstrBot 在不断地发展和完善中，致力于为用户提供更好的体验和更多的功能。

功能更新

多配置文件

我们在这一版本引入了全新的多配置文件管理功能，这意味着，你可以灵活地创建配置文件，并将配置文件应用到你指定平台或用户，以实现更加灵活的机器人配置，包括但不限于：不同平台 / 会话应用不同的默认人格、知识库、默认聊天模型、插件。

要使用这个功能，只需要打开 WebUI -> 配置文件页，点击左上角的下拉框。

点击「管理配置文件」按钮，然后新建一个新的配置文件。

从上图可以看到，一个配置文件可以应用到多个消息平台，也可以自定义规则，自定义规则支持自由指定要应用的范围，精确到某一会话。为了实现这一点，我们抽象出了 umo 这个概念。

umo 是一个字符串，唯一表示某个消息平台下的某个会话。其格式为 [消息平台适配器 ID]:[消息类型(群聊或私聊)]:[会话 ID]。其中，会话 ID 可以使用 /sid 内置指令获取。例如：

  • telegram_1:GroupMessage:123456 表示 ID 为 telegram_1 的适配器下群组聊天中 ID 为 123456 的会话。
  • aiocqhttp_default:FriendMessage:905617992 表示 ID 为 aiocqhttp_default 的适配器下私聊中 QQ 为 905617992 的会话。

支持通配符或留空来匹配所有内容。

  • satori_1:GroupMessage:* 表示 ID 为 satori_1 的适配器下群组聊天中所有会话。
  • :FriendMessage:905617992 表示所有适配器下私聊中 QQ 为 905617992 的会话。

自定义规则允许你创建多个 umo 规则。

一个消息事件只会匹配到一个配置文件。默认情况下，AstrBot 自带一个名为 default 的配置文件，其规则为 ::，表示所有适配器、所有会话均使用该配置文件。其优先级也是最低的，当你创建了其他配置文件后，default 配置文件就只会作为兜底配置文件使用。

当规则在多个配置文件上冲突时（例如，一个消息事件的 umo 满足多个配置文件），WebUI 会给予警告提示，但你仍然可以继续创建，最终 AstrBot 执行会话匹配时，将使用第一个匹配的配置文件。

配置文件热重载

在 v4 版本中，我们引入了配置文件热重载功能。用户可以在不重启服务的情况下，实时更新配置文件的内容。这一功能极大地方便了用户的配置管理，提高了系统的灵活性。

注意：在修改配置文件后，您仍需手动点击右下角的保存按钮，否则更改将不会生效。

图片转述

我们注意到部分 LLM 并没有多模态能力，如 deepseek-chat，而这类模型仍然在被很多用户使用。因此我们引入了图片转述功能，允许用户设置一个专门用于图片转述的模型。图片将会由图片转述模型转述为文本再移交给聊天模型。

您可以在配置文件中配置图片转述模型。

同步 MCP 服务器

许多用户反应自己无法在本机部署 MCP 服务器，或者部署很麻烦。因此，我们现已支持将 ModelScope 平台的 MCP 服务器同步到 AstrBot。

你需要在 ModelScope 上找到你想要使用的 MCP 服务器，然后进入服务器详情页，填写右边的表单并点击连接，以在 ModelScope 上新建自己的 MCP 服务器实例，而不需要本地部署。

新建完成后，进入 WebUI -> MCP，点击右上角的 「同步服务器」，按照提示完成同步。

我们未来将增加更多对接平台的支持，如 Smithery、MCP.SO 等，敬请期待。

内置网页搜索支持 Tavily

v3 版本中，网页搜索的过程在本地进行，由于主要使用 Google，并且本质上是以爬虫的方式获取内容，所以稳定性无法得到保证。在 v4 版本中，我们内置了对 Tavily 的支持。Tavily 是一个强大的搜索引擎 API，可以提供更稳定的搜索服务。

要更换为使用 Tavily，只需在配置文件中找到网页搜索一节，然后选择网页搜索提供商为 tavity 即可。除此之外，你还可以选择 default，也就是使用内置的搜索引擎。

独立的人格设定

考虑到用户对角色扮演更高的需求，在 v4 版本，我们将人格设定独立为单独的 WebUI 页面，用户可以更方便地管理和配置不同的人格设定。

并且，人格设定现已支持选择 LLM 函数工具，以服务更好的角色扮演体验。

你可以在配置文件的人格一节中指定默认的聊天人格。

自定义 T2I 模版

Co-Authored by @RC-CHN.

用户可以根据自己的需求，自定义 T2I 模版，以实现个性化的文本转图像服务。

只需要打开配置文件 -> 系统，然后找到文本转图像自定义模版配置项，点击「自定义 T2I 模版」即可编辑 T2I 所需要的 jinja2 模版。

该功能需要一定的 HTML 编程基础。

新增 Satori 适配器

Co-Authored by @shangxueink.

在新版本，我们支持接入 Satori 协议实现端，以支持更多消息平台的接入。

其他功能

我们还增加了许多新的功能和优化，包括但不限于：

重要 BUG 修复

同时启动多个相同的消息平台适配器会导致上下文混乱

问题原因：v3 版本用于标识会话的 umo 中 platform_id 字段被错误的设置为了消息平台的类型字符串，导致多个相同类型的消息平台实例在相同的会话中共享了 umo，即共享同一个聊天上下文，导致混乱。

解决方案：在 v4 版本中，我们对 platform_id 的设置进行了修正，确保每个消息平台实例都有独立的上下文。

升级到 v4.0.0

一般情况下，您只需要打开 WebUI，点击右上角的更新，然后切换到 v4.0.0 版本即可。

当升级成功后，WebUI 会自动弹出数据迁移助手，如果您要保留之前的消息记录，请务必迁移。