跳转到主要内容
YumeBot 是一个基于 NapCatQQ 的 QQ 机器人框架。

核心概念

插件系统

每个功能都是一个插件:
class MyPlugin : PluginPackage() {
    override val id = "com.example.myplugin"
    override val name = "我的插件"
    override val version = "1.0.0"
    
    override suspend fun onBotContextReady() {
        // 插件初始化逻辑
    }
}

事件监听器

处理 QQ 事件的核心机制:
pluginContext.onGroupMessage(
    filter = Filters.groupKeyword("关键词")
) { event ->
    // 处理群消息事件
}

过滤器系统

精确匹配事件:
// 关键词过滤
Filters.groupKeyword("你好", "hello")

// 前缀过滤
Filters.groupStartsWith("/cmd")

// 组合过滤
Filters.and(
    Filters.groupKeyword("搜索"),
    Filters.fromGroup(123456789)
)

消息构建器

DSL 风格的消息构建:
val message = message {
    text("Hello ")
    at(userId)
    image("https://example.com/image.jpg")
}.build()

架构

下一步