插件介绍
插件应用是 元点Saas 的核心扩展体系，用于把完整业务、复用能力、移动端页面和装修组件拆成可安装、可授权、可升级、可按租户启用的独立包。
插件解决什么问题
传统后台二开通常把业务代码直接写进主系统，后续会遇到升级困难、租户差异化难维护、移动端页面难按需裁剪等问题。元点Saas 的插件体系把业务能力封装到 server/plugins/{code}，由平台统一安装和授权，再由租户按权益启用。
插件可以做到：
- 平台统一上传、登记、安装、升级、卸载。
- 套餐按插件授权，不同租户拥有不同应用能力。
- 租户后台按插件生成菜单、权限和配置面板。
- 后端路由自动挂载租户上下文、生命周期、权益和 RBAC 中间件。
- 移动端构建时只合入租户已授权插件的 UniApp 分包。
- 装修系统可以渲染插件组件，例如商品列表、内容列表、营销入口。
两种插件形态
| 形态 | 适用场景 | 租户侧入口 |
|---|---|---|
app 一级应用 | 商城、CMS、CRM、工单、知识付费等完整业务 | 作为租户后台一级菜单，可包含多级页面 |
plugin 能力插件 | 积分兑换、营销组件、第三方接口、装修组件等能力 | 插件中心、配置面板，或被其他应用调用 |
如果插件本身能形成完整业务闭环，优先使用 kind=app。如果插件只是给其他模块提供能力或配置，使用 kind=plugin。
插件生命周期
text
开发插件
↓
平台上传 / 登记
↓
校验 manifest / 依赖 / 兼容版本
↓
安装：迁移、生命周期钩子、菜单权限同步、前端构建
↓
套餐授权：决定哪些租户可见
↓
租户启用：决定当前租户是否实际使用
↓
运行时访问：租户上下文 + 生命周期 + 权益 + RBAC
↓
升级 / 禁用 / 卸载目录位置
text
server/plugins/{code}/
├── plugin.json # 插件描述文件
├── icon.png # 插件图标
├── app/ # 插件后端代码
├── migrations/ # 插件数据库迁移
├── tenant/ # 租户后台页面和 API 封装
└── uniapp/ # UniApp 分包源码当前仓库内置 mall 和 cms 示例插件，可作为结构参考。
阅读路径
- 平台运营人员：先看 使用指南，了解上传、安装、套餐授权和租户启用。
- 插件开发者：先看 开发指南，再看 Manifest 规范。
- 移动端或装修开发者：看 移动端与装修。
- 遇到问题：看 常见问题。