插件化

Zongsoft 插件化应用的基本概念和运行方式。

插件化是 Zongsoft 的核心特征。一个插件式应用由宿主程序和多个插件共同组成，宿主负责启动和承载，插件负责提供业务能力与扩展点。

插件是什么

在 Zongsoft 中，插件不是单个程序集的别名，而是一组文件和元数据的组合。最常见的插件内容包括：

• 插件描述文件 *.plugin。

• 插件程序集 *.dll。

• 选项配置 *.option。

• 数据映射 *.mapping。

• 本地化资源目录，如 zh-Hans、zh-CN。

• 证书、模板、静态资源等附属文件。

插件如何加载

宿主程序启动后，插件框架会扫描宿主目录下的 plugins/ 目录，读取插件描述文件，加载程序集并建立应用上下文。插件可以注册服务、命令、事件处理器、Web 控制器或其它模块能力。

为什么使用插件化

插件化解决的是大型业务系统的组织问题：

• 业务模块可以独立发布。

• 运行宿主可以保持轻量和稳定。

• 不同环境可以通过部署文件组合不同插件。

• 不依赖特定交互或协议的业务插件可以在不同宿主形态中复用；控制器及 ASP.NET 中间件等则必须附属 Web 宿主。

• 配置、映射和资源可以随插件一起部署。

插件化设计专题

以下文章结合论坛模块的实际实现，讨论设计选择及其代价。建议按顺序阅读，也可以从正在面对的问题进入。配图中的“设计示意”表示待设计的能力或方案，具体实现状态以正文说明为准。

1. 为什么需要插件化：巨石应用的痛点，分层、切块与按业务组织目录带来的变化。

2. 从业务变化确定模块边界：以审核、正文和统计的共同变化判断业务归属。

3. 让业务能力跨宿主复用：明确业务动作、入口适配、身份和生命周期的分工。

4. 把扩展点设计成协作契约：设计扩展路径、服务调用、命名和失败语义。

5. 从局部改造到可验证的插件交付：验证发布组合，并处理数据兼容与进程拆分的取舍。

文档阅读建议

先阅读 插件框架 理解应用模型，再阅读 部署第一个插件 了解插件如何进入宿主。需要深入数据访问时，再进入 数据引擎。

扩展点也是契约

一个插件提供服务或集合挂载点，另一个插件声明依赖并贡献实现。依赖不仅决定程序集可见性，也说明“需要先有哪些组件才能工作”。扩展路径、服务名和配置键应像公开 API 一样维护，变更时同步消费者。

插件化不等于任意热替换，也不等于进程级隔离。加载到同一宿主的组件共享进程资源，版本冲突或错误工作器可能影响整个应用。需要独立故障边界时，应考虑独立进程和通信协议。

背景术语见基础概念，完整组合路径见首个业务插件。