前后台模式最小示例

约 479 字大约 2 分钟

2025-04-28

前台模式

main.py

from ncatbot.core import BotClient
from ncatbot.core.event import PrivateMessageEvent

bot = BotClient()

@bot.on_private_message()
async def on_private_message(event: PrivateMessageEvent):
    print("收到私聊消息")

bot.run_frontend()

运行

终端执行 python main.py 直接运行，收到私聊消息会在终端打印 收到私聊消息。

程序会永远阻塞在 bot.run_frontend()，除非按下 Ctrl+C 或者以其它方式终止，否则程序不会停止。

后台模式

main.py

from ncatbot.core import BotClient
from ncatbot.core.event import PrivateMessageEvent

bot = BotClient()

@bot.on_private_message()
async def on_private_message(event: PrivateMessageEvent):
    print("收到私聊消息")

api = bot.run_backend()
# 同步接口主动发消息（示例群号/QQ 号请替换）
api.send_private_text_sync(876543, "Bot 已经启动")
print("后台已运行，继续做其他同步任务……")
bot.exit() # 需要主动退出 Bot