GUGUBot v2.0.0

⚠️ 重要提示

不兼容变更

本次更新为重大版本更新，包含大量不兼容变更。升级前请：

1. 备份配置文件：/config/GUGUbot/config.yml
2. 备份数据文件：绑定数据、白名单等
3. 阅读迁移指南：配置文件格式已完全改变
4. 检查依赖版本：部分依赖要求已变更

📋 系统要求变更

MCDReforged 版本要求

• 旧版要求：MCDReforged ≥ 2.0.0
• 新版要求：MCDReforged ≥ 2.14.7 ⚠️
• 影响：需要升级 MCDReforged

🏗️ 架构重构

代码结构完全重写

旧版结构（v1.11.19）

GUGUbot/
├── bot.py
├── config.py
├── system/          # 功能系统
└── utils/           # 工具类

新版结构（v2.0.0）

GUGUbot/
├── gugubot/
│   ├── builder/     # 消息构建器
│   ├── config/       # 配置管理（模块化）
│   ├── connector/    # 连接器（QQ、MC、Bridge）
│   ├── logic/        # 逻辑系统
│   │   ├── system/   # 核心系统
│   │   └── plugins/  # 插件功能
│   ├── parser/       # 消息解析器
│   ├── utils/        # 工具类
│   └── ws/           # WebSocket 服务
└── lang/             # 多语言支持

核心改进

1. 模块化设计

   • 连接器系统：QQ、Minecraft、Bridge 独立管理
   • 解析器系统：消息解析逻辑分离
   • 构建器系统：消息构建统一管理

2. 插件化架构

   • 功能系统可独立启用/禁用
   • 支持自定义插件开发
   • 更好的扩展性

3. 配置管理优化

   • 配置验证和迁移工具
   • 默认配置自动生成
   • 配置结构更清晰

📝 配置文件变更

配置格式完全改变

旧版配置（扁平结构）

admin_id:
  - 123456789
group_id:
  - 123456789
command_prefix: "#"
forward:
  mc_to_qq: true
  qq_to_mc: true

新版配置（嵌套结构）

GUGUBot:
  command_prefix: "#"

connector:
  QQ:
    enable: true
    connection:
      host: 127.0.0.1
      port: 8777
    permissions:
      admin_ids:
        - 123456789
      group_ids:
        - 123456789
  
  minecraft:
    enable: true
  
  minecraft_bridge:
    enable: true
    is_main_server: true

system:
  echo:
    enable: true
  bound:
    enable: true

主要配置变更

1. 连接器配置

   • QQ 连接配置独立为 connector.QQ
   • Minecraft 连接配置独立为 connector.minecraft
   • 多服互联配置独立为 connector.minecraft_bridge

2. 系统功能配置

   • 所有功能系统统一在 system 下配置
   • 每个系统都有独立的 enable 开关

3. 权限配置

   • 管理员配置移至 connector.QQ.permissions.admin_ids
   • 管理群配置移至 connector.QQ.permissions.admin_group_ids
   • 群组配置移至 connector.QQ.permissions.group_ids

✨ 新增功能

1. 内置 WebSocket 服务

• 不再依赖 cq_qq_api 插件
• 直接通过 WebSocket 连接 QQ 机器人
• 支持 SSL/TLS 加密连接
• 自动重连机制

2. 多服互联增强

• 更稳定的桥接连接
• 心跳检测机制
• 支持跨服命令执行
• 灵活的服务器配置

3. 消息构建器系统

• 统一的消息格式化
• 支持自定义消息模板
• 更好的消息类型处理

4. 多语言支持

• 内置中文和英文语言包
• 支持自定义语言文件
• 语言文件位于 lang/ 目录

5. 配置迁移工具

• 自动检测旧版配置
• 提供配置迁移功能
• 配置验证和错误提示

6. 插件化系统

• 功能模块可独立开发
• 支持热插拔功能
• 更好的代码组织

🔧 功能改进

绑定系统

• ✅ 支持 Java 版和基岩版分别绑定
• ✅ 绑定上限可配置（max_java_bound、max_bedrock_bound）
• ✅ 更完善的绑定验证

白名单系统

• ✅ 与绑定系统深度集成
• ✅ 支持多种白名单模式
• ✅ 自动白名单管理

消息转发

• ✅ 更灵活的消息过滤
• ✅ 支持正则表达式匹配
• ✅ 消息模板自定义

命令执行

• ✅ 更安全的命令验证
• ✅ 支持命令模式过滤
• ✅ 跨服命令执行支持

玩家管理

• ✅ 不活跃玩家检查优化
• ✅ 未绑定用户检查优化
• ✅ 更详细的检查配置

🐛 问题修复

• 修复了消息转发中的一些边界情况
• 修复了绑定系统的验证问题
• 修复了多服互联的连接稳定性
• 修复了配置加载的错误处理
• 修复了 WebSocket 连接的重连逻辑

注意：本次更新包含大量不兼容变更，请注意备份。

What's Changed

• Xue k66 2.0.0 by @XueK66 in #188

Full Changelog: https://github.com/LoosePrince/PF-GUGUBot/compare/v1.11.19...v2.0.0