xuuyuan/scorebot-go

ScoreBot-Go is a Go language backend for a chatbot that lets students look up their exam grades from several Chinese educational platforms. Users send commands to the bot, either through a command line terminal or a QQ messaging bot, and the system fetches their scores, subject details, rankings, and class averages from the connected platforms. The project is split into three interchangeable layers. The command core parses what the user typed and runs the main logic. The chat adapter connects to whichever messaging surface you are using, currently a command line terminal or a QQ Bot, a popular Chinese messaging platform. The store adapter handles saving user account bindings and cached data, and you can choose from JSON file, SQLite, MySQL, or in memory storage depending on your setup. Students first bind their school account credentials to the bot, then use slash commands like query or exam details to retrieve their latest results. The system also supports a teacher side view with richer data including year group rankings, class averages, and subject breakdowns, provided a teacher account has been registered separately. The project is written in Go and runs as a single compiled binary with no external dependencies for the default JSON or SQLite modes. It can be deployed as a local terminal tool, a Linux system service, or on cloud function infrastructure for QQ Bot integration. The README notes the project handles sensitive data such as account credentials and tokens, is released under the MIT license, and advises operators to obtain proper user consent before deploying publicly. The full README is longer than what was shown.