用户排行榜（leaderboard）

在首页右侧栏展示积分财富榜和获赞明星榜，通过 SSG 服务端渲染双 Tab 切换，支持后台配置。

功能清单

首页排行榜

• 双榜并列 — 财富榜（积分排行 TOP）和明星榜（获赞排行 TOP），通过 Tab 切换
• 排名徽章 — 前三名金银铜色徽章，其余灰色序号
• 用户信息 — 头像 + 昵称/用户名 + 数值，点击行跳转用户主页
• 服务端渲染 — 所有 HTML + CSS 在服务端一次性生成，首屏不依赖 JS

后台配置

• 开关控制 — 独立控制排行榜总开关、财富榜和明星榜的显示/隐藏
• 展示条数 — 可选 TOP 5/10/15/20
• 文案自定义 — 支持自定义财富榜和明星榜的标题与描述文案

架构设计

text
addon.json                          ← 插件清单
dist/
  server.mjs                        ← 入口：slot 渲染 + 管理员 page/api
assets/
  leaderboard-client.js             ← 客户端 Tab 切换交互
  leaderboard-admin.js              ← 后台管理入口
  leaderboard-admin.controller.js   ← 状态管理
  leaderboard-admin.view.js         ← 配置表单视图

数据流

text
首页加载
  → executeSlot("home.right.top")
    → leaderboard render 函数
      → readConfig("config")  ← 读取配置
      → prisma.user.findMany() ← 查询 Top N 积分/获赞用户
      → 生成 HTML + CSS → 返回 AddonRenderResult
  → 客户端加载 leaderboard-client.js → 绑定 Tab 切换事件

安全措施

• 状态过滤 — 仅查询 status = "ACTIVE" 的用户，排除被封禁/禁言用户
• SQL 安全 — 使用 Prisma ORM 参数化查询，无 SQL 注入风险
• 配置校验 — maxEntries 限制 3~20，防止恶意拉取大量用户数据

权限声明

text
slot:register  — 注册首页右侧栏排行榜 slot
config:read    — 读取插件配置
config:write   — 保存插件配置
page:admin     — 后台管理页注册
api:admin      — 后台 API 注册
database:sql   — 执行原生 SQL 查询
database:orm   — 使用 Prisma ORM