插件系统

Monibuca 采用插件化架构设计，通过插件机制来扩展功能。插件系统是 Monibuca 的核心特性之一，它允许开发者以模块化的方式添加新功能，而不需要修改核心代码。

插件生命周期

插件系统具有完整的生命周期管理，主要包含以下阶段：

插件通过 InstallPlugin 泛型函数进行注册，在此阶段会：

创建插件元数据(PluginMeta)，包含：
- 插件名称：自动从插件结构体名称中提取(去除"Plugin"后缀)
- 插件版本：从调用者的文件路径或包路径中提取，如果无法提取则默认为"dev"
- 插件类型：通过反射获取插件结构体类型
注册可选功能：
- 退出处理器(OnExitHandler)
- 默认配置(DefaultYaml)
- 拉流器(Puller)
- 推流器(Pusher)
- 录制器(Recorder)
- 转换器(Transformer)
- 发布认证(AuthPublisher)
- 订阅认证(AuthSubscriber)
- gRPC服务(ServiceDesc)
- gRPC网关处理器(RegisterGRPCHandler)
将插件元数据添加到全局插件列表中

注册阶段是插件生命周期的第一个阶段，它为插件系统提供了插件的基本信息和功能定义，为后续的初始化和启动做准备。

插件通过 Plugin.Init 方法进行初始化，此阶段包含以下步骤：

实例化检查
- 检查插件是否实现了 IPlugin 接口
- 通过反射获取插件实例
基础设置
- 设置插件元数据和服务器引用
- 配置插件日志记录器
- 设置插件名称和版本信息
环境检查
- 检查环境变量是否禁用插件(通过 {PLUGIN_NAME}_ENABLE=false)
- 检查全局禁用状态(DisableAll)
- 检查用户配置中的启用状态(enable)
配置加载
- 解析通用配置
- 加载默认YAML配置
- 合并用户配置
- 应用最终配置并记录
数据库初始化（如果需要）
- 检查数据库连接配置(DSN)
- 建立数据库连接
- 自动迁移数据库表结构(针对录制功能)
状态记录
- 记录插件版本
- 记录用户配置
- 设置日志级别
- 记录初始化状态

如果在初始化过程中发生错误：

初始化阶段为插件的运行准备必要的环境和资源，是确保插件正常运行的关键阶段。

插件通过 Plugin.Start 方法启动，此阶段按顺序执行以下操作：

gRPC服务注册（如果配置）
- 注册gRPC服务
- 注册gRPC网关处理器
- 处理gRPC相关错误
插件管理
- 将插件添加到服务器的插件列表中
- 设置插件状态为运行中
网络监听初始化
- HTTP/HTTPS服务启动
- TCP/TLS服务启动（如果实现了ITCPPlugin接口）
- UDP服务启动（如果实现了IUDPPlugin接口）
- QUIC服务启动（如果实现了IQUICPlugin接口）
插件初始化回调
- 调用插件的OnInit方法
- 处理初始化错误
定时任务设置
- 配置服务器保活任务（如果启用）
- 设置其他定时任务

如果在启动过程中发生错误：

启动阶段是插件开始提供服务的关键阶段，此时插件完成了所有准备工作，可以开始处理业务逻辑。

插件的停止阶段通过 Plugin.OnStop 方法和相关的停止处理逻辑实现，主要包含以下步骤：

停止阶段的主要目标是确保插件能够安全、干净地停止运行，不影响系统的其他部分。

插件的销毁阶段通过 Plugin.Dispose 方法实现，这是插件生命周期的最后阶段，主要包含以下步骤：

销毁阶段的主要目标是确保插件完全清理所有资源，不留下任何残留状态，防止内存泄漏和资源泄露。