前言

一、整体融合原则

1. 插件前后台全部页面、所有功能模块，必须和子比主题高度原生融合，不做独立风格、不自定义独立 UI 体系。
2. 全程优先复用子比主题内置样式、原生框架、自带 CSS 类名、按钮组件、弹窗组件、通知提示组件。
3. 任何场景只要子比已有现成样式 / 组件 / 交互，一律直接调用，禁止重复写自定义样式、自定义按钮、自定义弹窗。

二、UI 与交互硬性要求

1. 前台、后台所有按钮、输入框、开关、卡片、列表、标签、分页等控件，统一使用子比主题原生样式。
2. 所有弹窗、悬浮提示、消息通知、成功 / 失败弹窗、确认框，全部调用子比主题自带弹窗与通知框架，不引入第三方弹窗、不自己写弹窗样式。
3. 配色、圆角、边距、字体大小、hover 悬浮效果、点击交互，严格对齐子比原生设计逻辑，保证视觉无割裂、无违和。
4. 若遇到子比主题无对应内置样式、无可用组件、框架无法实现的需求，禁止自行开发自定义样式，必须先咨询确认方案，获批后再进行开发。

三、后台设置与布局规范

1. 插件后台设置页嵌入子比主题原生后台布局结构，保持和主题原生设置页面排版、风格一致。
2. 配置项分组、标题、描述、保存按钮、重置按钮，全部沿用子比原生组件样式。
3. 后台提示、保存成功 / 失败通知、权限提示，统一调用子比通知接口。

四、版本更新规范

1. 插件每一次迭代更新，必须同步修改插件主文件版本号、后台显示版本号，版本号按正规语义化版本递增。
2. 每次更新必须同步更新插件介绍说明、更新日志，清晰写明：新增功能、功能优化、BUG 修复、适配子比版本、已知问题修复。
3. 更新日志需按版本逐条记录，保留历史版本记录，可长期查阅追溯。

五、开发完整闭环要求

1. 从需求开发、UI 适配、主题兼容测试、版本打包、版本发布、更新日志编写、后续适配维护，形成完整闭环。
2. 后续子比主题版本升级，需及时跟进适配插件样式、接口、兼容逻辑，保证长期可用不失效。
3. 插件所有入口、菜单、配置、提示、交互全部依附子比主题原生架构，不脱离主题独立运行展示。
4. 不随意引入多余第三方 CSS、JS 框架，能复用子比原生代码的一律复用，保持插件轻量化、原生化。

六、补充约定