Skip to content
Lingchu Bot

Project Introduction

灵初 · Lingchu Bot

A NoneBot2 group-management bot, breathed into life.

An application-side group-management bot — plugins, config, storage, and async data flowing through one typed NoneBot2 runtime.

Quick StartArchitecture

See it in action

Section titled “See it in action”
QQ group management — sample commands (en_US locale)
menu                        # list available submenus
member-management           # member management submenu
mute @user 10m              # mute a member for 10 minutes
mass-announcement <content> all  # broadcast announcement to all groups
restart-protocol-endpoint   # restart the OneBot V11 protocol endpoint
Message storage pipeline
Event, processing, lifecycle, and API call summaries flowing through async storage

Quick navigation

Section titled “Quick navigation”

Overview

Understand project status, runtime setup, and command capabilities.

Quick Start

Install dependencies and choose plugin loading or Docker runtime.

Architecture

Understand project structure, architecture, and design decisions.

Development Workflow

Contribution setup, branch conventions, and testing.

Current capabilities

Section titled “Current capabilities”
  • NoneBot2 corePlugin entrypoint with declared local plugin directories and adapters.
  • QQ group managementMute, member management, announcements, kicks, and group profile updates.
  • OneBot V11 defaultSingle active adapter; Milky, QQ, and OneBot V12 are deprecated and removed.
  • Message storageOptional event, processing, lifecycle, and API call summary recording.
  • TOML + ORMlocalstore path management and async CRUD helpers across SQLite, PostgreSQL, MySQL, and MariaDB.
  • i18n runtimegettext / Babel catalogs for zh_CN and en_US.
  • Developer toolingprek hooks, tests, and CI checks for general commands.
  • Extension roomCross-platform and non-group-management features for later iterations.
Section titled “Repository links”