logo
0
1
WeChat Login

/Release/v1.0.0

v1.0.0
latest
OverviewDeployMetadata

v1.0.0 - 模块化重构正式发布

🎉 首个正式版本

这是 ECUST Minecraft QQ Bot 的第一个正式版本。本次版本对整个项目进行了全面的重构,将原来单文件 main.py(1200+ 行)拆分为清晰的模块化架构。

✨ 主要变化

架构重构

  • 将原来臃肿的单文件拆分为 handlers/utils/config.pybot_client.py 等模块
  • 每个功能独立成模块,便于维护和扩展
  • 删除已废弃的 main.py,统一使用 main_new.py 作为入口

功能增强

  • AI 对话:新增 /ai 命令,支持多模态图片输入、模型切换(/model)、模型列表分页过滤(/models
  • Minecraft 交互/mc 命令新增交互式按钮支持
  • 校车查询:新增 /校车 命令,支持双向时刻表查询
  • 空教室查询:新增 /空教室 命令,支持按教学楼、楼层、时间段查询
  • 三角洲密码:新增 /三角洲密码 命令
  • 通知推送:新增 /通知 命令,获取学校最新通知
  • 消息格式优化:天气、塔罗牌、一言、黄历等回复升级为 Markdown 格式
  • 找群功能/找群 支持关键词搜索和飞书数据联动

Bug 修复

  • 修复空消息内容导致 AI 请求无输入的问题
  • 修复 AI 模型温度参数兼容性
  • 修正交互事件 ID 和 WebSocket 事件 ID 的使用
  • 修复按钮交互回复消息的发送顺序

📋 支持的命令

分类命令说明
天气/校园天气查询奉贤/徐汇校区天气
服务器/服务器状态 /status /添加服务器 /移除服务器MC 服务器管理
每日/一言 /今日黄历 /今日人品 /今日运势 /通知每日内容与通知
娱乐/塔罗牌 /求签 vv /三角洲密码娱乐功能
网络工具/ip /nslookup /ping网络诊断
Minecraft/mc服务器 RCON 命令
AI/ai /model /modelsAI 对话与模型管理
校园/校车 /空教室校车时刻表、空教室查询
群组/找群搜索群组
帮助/帮助 /wiki帮助信息

📦 项目结构

ecustmc-qqbot/
├── main_new.py          # 主入口
├── bot_client.py        # 机器人客户端
├── config.py            # 配置管理
├── handlers/            # 命令处理器(12个模块)
│   ├── ai.py
│   ├── bus.py
│   ├── classroom.py
│   ├── daily.py
│   ├── entertainment.py
│   ├── fortune.py
│   ├── group_management.py
│   ├── help.py
│   ├── minecraft.py
│   ├── network_tools.py
│   ├── server.py
│   └── weather.py
├── utils/               # 工具模块
│   ├── database.py
│   └── network.py
└── data files           # 数据文件(JSON等)
Attachment
2026-04-29 02:47:04
2026-04-29 02:47:04