Architecture

架构设计

yes-core 框架自底向上分为四个核心层级。我们坚持 “微内核管调度，适配器管协议，管理器管抽象，业务插件管逻辑” 的设计哲学。

架构流向图

graph TD
subgraph 业务层
A[业务插件 A: 群管]
B[业务插件 B: AI 对话]
C[业务插件 C: 自定义渲染器]
end

subgraph 抽象与调度层
    D[adapter-manager]
end

subgraph 协议适配层
    E[adapter-onebot]
    F[adapter-telegram...]
end

subgraph 微内核层
    G[yes-core]
end

A -. 依赖 .-> D
B -. 依赖 .-> D
C -. 重载渲染器 .-> D

D -->|转换/分发事件| A
D -->|调用接口| E

E -->|WebSocket/HTTP| H(QQ/NapCat)
G -->|管理生命周期| D
G -->|管理生命周期| E

Loading

各层职责

1. 微内核层 (yes-core) 极度纯粹，不包含任何业务逻辑和协议代码。提供 Init, Start, Stop 生命周期管理，Publish/Subscribe 事件总线，以及基于 DependsOn 的依赖注入。

2. 基础服务层 (plugin-config) 提供统一的配置读取能力，让任何插件都能通过统一的接口反序列化配置文件。

3. 抽象与调度层 (adapter-manager) 连接底层适配器与业务插件的桥梁。监听适配器抛出的原始事件，将其打磨成强类型的 MessageEvent；提供跨平台的 MessageSegment 消息段构造器；注入便捷闭包。

4. 协议适配层 (adapter-onebot 等) 连接底层协议端（如 NapCat）。将原始报文解析为内存对象，并将框架的主动调用编码为协议端能识别的格式。实现了 adapter-manager 规定的 Adapter 接口。

5. 业务插件层 专注于实现机器人功能。只依赖 adapter-manager，代码极度清爽，实现跨平台兼容。