内置等级账号权限

一、插件简介

内置等级是面向运营的等级预设助手：一键套用成长值区间、名称、颜色与图标，写入系统已有的 user_level 表。不改变核心成长值计算与等级匹配逻辑，社区身份、用户绑定关系仍由系统用户等级页管理。

二、核心能力

三、依赖与安装

1. 将插件目录置于 plugins/UserLevel/。
2. 在应用中心安装「内置等级」。
3. 安装时调用系统 UserLevelService::ensureSchema() 确保等级表结构就绪，并注册后台菜单与权限。
4. 硬依赖：主程序用户等级体系（user_level / UserLevelService）。
5. 软依赖：社区等会展示用户等级徽章的前台模块（有则自动受益）。
6. 卸载只移除本插件菜单与配置，不会删除系统等级表中的等级数据。

四、应用中心基础配置

在应用中心 → 内置等级 → 配置：

五、后台重点配置

菜单「内置等级」为主要操作面：

• 浏览五套内置预设及自建预设，预览每级名称、成长值区间、图标与说明。
• 点「应用」写入系统用户等级。
• 「快速新建预设」可自定义多级；结束值填 0 表示不设上限。
• 「管理现有等级」跳转系统用户等级列表，做精细调整。

内置预设概要：

六、前台用户流程

1. 用户无直接操作本插件页面。
2. 运营在后台应用预设后，用户按系统规则累计成长值（积分、金币、发帖等，以站点配置为准）。
3. 达到区间后自动匹配对应等级名称、颜色与徽章，在资料、列表等已对接处展示。

七、后台审核与运维

无独立审核队列。预设应用会写系统等级表；自建预设存于插件配置 custom_presets。

相关后台接口

八、特殊说明

• 不删用户数据：应用预设时多余旧等级默认停用，不物理删除，避免历史绑定丢失。
• 区间需递增：自定义预设成长值起点应从小到大；结束值 0 表示开放上限。
• 权限文案：预设里的「权限 / 特征」多为说明文案，是否真正鉴权取决于站点其他权限配置。
• 与 VIP 区别：本插件管成长值等级称号；付费会员请用 VIP 等独立插件。

九、推荐上线清单

• 安装并启用「内置等级」
• 按站点风格选一套预设并应用（建议先在测试环境预览）
• 到「管理现有等级」核对区间是否连续、顶层是否开放上限
• 抽检前台会员资料 / 列表是否显示新等级名称与图标
• 如需个性化，再建自定义预设后应用，勿直接改配置 JSON

十、常见问题

Q：应用后前台没变？ 确认已点「应用」而非仅预览；清缓存后刷新。等级仍按用户当前成长值匹配。

Q：会清空现有等级吗？ 会重建/对齐等级定义，尽量复用记录；多余等级停用，用户成长值数据本身不删。

Q：自定义预设存在哪？ 插件配置 custom_presets，请在页面操作，勿手改乱码。

Q：卸载插件等级还在吗？ 在。系统 user_level 数据保留，只是失去预设助手菜单。

Q：和后台「用户等级」菜单什么关系？ 「内置等级」负责套预设；「用户等级」负责逐条维护。两者共用同一套表。