跳到主要内容

升级指南

本文档适用于从 2.1.0-dev6 及更早的 2.1.0-dev 系列版本升级至 2.1.1-dev.1 的用户。

概述

2.1.1-dev.1 是一个包含多项破坏性变更(Breaking Changes)的重大更新,也是 dev 频道的一次强制更新——所有 dev 频道用户均会收到此次升级推送。

不过无需担心数据安全:EasyBot 已内置兼容性处理机制,在首次启动新版本时会自动备份旧版数据库,随后再尝试迁移至新版本格式,最大程度保障数据完整性。

请仔细阅读下方的破坏性变更详情,了解此次更新对你现有配置和插件的影响。

主要变更摘要

类别变更内容影响范围
协议支持新增 Telegram 协议适配支持-
协议支持新增 Milky 协议适配支持所有 QQ 平台用户
机器人实现推荐 LLBot 替代 NapCat (Windows)Windows QQ 用户
插件系统插件 HTTP 服务器架构调整插件开发者
配置结构部分配置文件格式变更所有用户
API 接口部分 SDK 接口签名调整插件开发者

升级方式

dev 频道用户无需手动下载安装包,更新将在以下任意场景自动触发

  • 重启软件 — 关闭后重新打开 EasyBot
  • 打开软件 — 正常启动 EasyBot
  • 网页端点击更新 — 在管理面板中点击更新按钮

EasyBot 在更新时会自动备份旧版数据库,随后迁移至新版本格式,无需手动干预。

建议

在触发更新之前,建议手动备份一下运行目录或数据持久化目录下的 dp 文件夹,以应对极端情况。

破坏性变更详情

变更: 数据库垃圾数据移除

我们删除了数据库中从0.1就存在的一些历史遗留垃圾数据,其中包括服务器分组、服务器数据统计、服务器系统信息记录表等实际上并未使用的表。

变更:多适配器支持

我们重构了适配器管理页面以及后端,现在允许你同时创建多个适配器,但他的代价是你需要重新配置所有和群相关的东西,因为他们需要

新增:Milky 协议支持

变更说明:2.1.1-dev.1 新增了对 Milky 协议的原生支持。如果你此前使用 OneBot 11 协议连接机器人,升级后可以选择切换到 Milky 协议以获得更好的性能与稳定性。

新增:Telegram 协议支持

变更说明:2.1.1-dev.1 新增了对 新增:Telegram 协议的原生支持,请查看 Telegram 适配器配置

变更:推荐机器人实现端变更

变更说明:经过长期测试,LLBot(LuckyLilliaBot) 在 Windows 平台上的稳定性显著优于 NapCat。建议 Windows 用户在此次升级中将实现端切换为 LLBot。

参考文档:

回滚方案

如果升级后遇到无法解决的问题,可以按以下步骤回滚:

  1. 停止 EasyBot
  2. 用备份的旧版本文件替换新版本
  3. 用备份的目录覆盖当前数据
  4. 重新启动

遇到麻烦了?

有偿服务

我们提供有偿代安装服务,解决您的环境配置烦恼。

了解详情
Miku

少年,买服务器吗?

持证经营

专注高性价比游戏云VPS,铂金 / I7 / R9 / 物理机

💰 最低六元起、买不了吃亏买不了上当,快来看看吧~

快来看看