升级指南
本文档适用于从 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 适配器配置