76
- 文档目的#
这份文档面向后续插件开发者，描述当前仓库里已经落地的插件系统实现方式、目录约定、运行机制和开发流程。
先统一一个概念和约束：
产品和后台文案里叫“插件”
代码实现里实际使用的是 addon / addons-host
核心层只允许做“扩展点 / SDK 暴露”，不写这项业务逻辑本身；业务逻辑与渲染放到 addon 内部完成
后文里“插件”和“addon”表示同一套系统。
1.1 强制开发约束#
以下约束同时适用于插件前台 UI 和后台 UI，默认视为强制规范，不是“建议即可”：
插件 UI 必须优先复用宿主系统 UI；浏览器侧优先使用 sdk.ui 和 sdk.custom
可动态安装 / 覆盖安装的插件，页面级样式必须随插件交付到 assets/.css
2.2 强制开发约束#
以下约束同时适用于插件前台 UI 和后台 UI，默认视为强制规范，不是“建议即可”：
插件 UI 必须优先复用宿主系统 UI；浏览器侧优先使用 sdk.ui 和 sdk.custom
可动态安装 / 覆盖安装的插件，页面级样式必须随插件交付到 assets/.css
素质不详，遇强者强！