[hot_topics]论坛热榜热

插件质量报告

插件：hot_topics

颜色说明：黄色表示有数据读写，红色表示 Hook 在系统循环中执行，浅蓝色表示有文件写入。“列表跳过”表示回调在列表路径会提前返回，“回调内”表示操作位于回调自身或其帮助函数的循环体内。“文件批处理”表示逐个处理用户一次提交的文件，属于必要操作，不标记修正。只有操作实际处于需要优化的循环路径时，才会标记“修正❗️”。

数据字典

未检测到插件数据表声明。

插件介绍

1. 多时间维度的热榜排行

• 支持 5 个时间窗口：24小时、3天、7天、15天、30天
• 所有时间窗口从当前时间往前推，滚动计算，不依赖自然月/自然周

2. 双指标排序

• 按评论数排行（统计发布窗口内的帖子，基于 app_topics.reply_count）
• 按浏览数排行（统计发布窗口内的帖子，基于 app_topics.view_count）
• 顶部胶囊切换，支持 AJAX 无刷新切换

3. 排名视觉体系

• TOP 3：渐变彩色徽章（金/银/铜）+ 橙色微渐变底 + 橙色热度标签
• TOP 3 外：浅灰底徽章 + 浅灰底条目 + 灰色热度标签
• 所有排名数字都有对应样式，拒绝单调

4. 热度标签

• 每条帖子右侧显示 🔥 热度数字
• 超过 1000 自动显示为 1.2k，超过 10000 显示为 1.5万
• TOP 3 橙色底，其余灰色底

5. 侧边栏卡片

• 支持在首页/主题页侧边栏展示热榜
• 可独立配置侧边栏的时间范围、排序方式、显示数量（3-20条）
• 右上角"24小时·评论"可一键跳转到热榜主页
• 每条帖子带排名徽章 + 标题（单行省略）+ 热度数字
• 显示/隐藏由系统插件列表的"侧边栏卡片"勾选控制

6. 快捷功能入口

• 自动出现在首页侧边栏"快捷功能"菜单
• 菜单名称可在后台自定义（默认"论坛热榜"）
• 移动端菜单同步显示

7. 后台设置

• 自定义快捷功能名称
• 配置热榜页显示数量（5-100条，默认12）
• 配置侧边栏卡片的时间范围、排序方式、显示数量
• 实时统计：全站主题数、近24小时发布数

8. 零额外存储

• 不建表、不追踪、不写缓存
• 数据全部来自论坛已有的 app_topics 表

9. AJAX 无刷新切换

• 点击时间 Tab 或指标胶囊时，页面内容即时替换，无整页刷新
• 加载过程有半透明反馈，请求失败自动回退为整页跳转

@桃子大人 很漂亮👍

全是大佬

V2.1.0
新增，数据缓存，减少频繁查询数据库压力
优化，侧边栏鼠标移入显示完整标题

V 2.1.1
1 优化，插件样式防止冲突
2 优化，侧边栏默认显示8条

后台增加关键词过滤 不然热帖全是抽奖帖
我的那个好像是每小时生成一次 不知道你这个有没有这个机制

@桃子大人 热榜只在首页侧边栏显示即可。版块、看帖页面不用显示。或者，插件增加自己的管理页面，可以控制是否显示在其他页面。可以参考签到卡片的配置写法

不错

版本 2.1.2 更新：
增加首页、版块列表、看帖页范围复选项。未选择时三处都显示；选择后仅在勾选页面显示

支持一下！

旧格式迁移：已将插件代码转存到开发日志，主题正文改为基础介绍。

授权码：PMR9197EE0CCEA2CEE2D84E4E28