五级信任等级体系（user_level）

版本 2.5.1 · 借鉴 Discourse 信任等级核心思想，适配轻量 PHP 论坛架构

设计原则：等级判定 = 纯函数，永不落库（每次现算）；仅行为流水、累计计数器与显示缓存入库。

一、等级总览

线性阶梯：高档判定包含低档条件，天然满足"高档必须先满足低档"。

二、判定条件（默认阈值，全部后台可配）

TL1 见习

TL2 正式成员（须先满足 TL1）

TL3 社区骨干（须先满足 TL2，90 天滚动窗口）

TL4 社区领袖

纯手动授予，系统永不自动晋升或降级。权限建议通过用户组体系配置。

三、TL3 浮动机制

晋升：全部 100% 条件满足 → 写入晋升时间 tl3_at
保持：晋升后 14 天宽限期内无条件不掉级
     宽限期后，各项 ≥ 阈值的 90% 水位（自动向上取整）即保持
回落：跌破 90% 水位（或被禁言/封禁）→ 回落 TL2，清除晋升时间
再晋升：重新攒满 100% 条件，宽限期重新计时

禁言/封禁视为跌破：处罚期间不晋升、宽限期不保护。

四、TL0 新访客限制

管理员（can_manage / can_access_admin）豁免全部门控。

五、能力解锁矩阵

其他插件通过 hook('user_level.allow', true, ['ability' => '…']) 检查，返回非 true 即拦截：

六、行为采集口径

外部上报接口：

fire('user_level.log', ['uid' => ?, 'type' => ?, 'ref_id' => ?, 'src' => ?可选, 'day' => 'Y-m-d'可选]);

七、防刷规则（强制生效）

1. 私信内一切行为不计入统计（不采集）
2. 回复自己发布的话题不计入回复话题数
3. 同一话题多次回复仅计 1 次
4. TL3 校验点赞来源多样性（≥5 个不同用户），小号互刷无法达标
5. 被禁言/封禁的用户暂停晋升并回落
6. 编辑内容不产生任何计数；取消赞不回退计数（单调，宁低勿高）

八、显示缓存机制

等级判定每次现算（纯函数），但徽章显示走缓存列 map_lv（users 表一列，NULL = 未计算）：

权限判定（发帖门控、能力检查）不走缓存，始终现算，只有徽章显示可能滞后到当事人下次访问。

九、展示

后台可按等级自定义每级的 emoji 图标与文字，并追加自定义 CSS（如 .user_level-badge{border-radius:999px}）。

十、后台管理（admin_tabs: user_level）

1. 信任等级阈值：TL1 / TL2 / TL3 / TL3 保持策略（水位 90%、宽限 14 天）/ TL0 限制 / 能力解锁等级 / 徽章显示
2. 用户等级管理：设为 TL4、解除 TL4、锁定为当前等级、解除锁定、清空单个用户显示缓存

十一、数据表

插件配置（阈值、徽章等）存于内核 app_plugins.config_json。

十二、性能特征

全部单表查询、索引命中、无 JOIN；流水表体积有上界（90 天窗口）。

十三、迁移与卸载

• 升级自动迁移（schema_ver 水位守卫，幂等）：v1→v4 重建流水 PK 加点赞者维度、计数器从核心表全量重算
• 卸载 drop 全部插件表；配置随 app_plugins 行删除

十四、一期裁剪项（后续可选）

帖级已读统计与阅读时长心跳、待审队列、Wiki 编辑、群组私信、TL3 治理类权限（改分类/重命名/归档/查看已删帖/私密板块）。