[insight_board]站长运营看板

插件质量报告

插件：insight_board

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

数据字典

plugin_insight_board_snapshots

plugin_insight_board_reports

版本 1.0.0 更新：
1.0.0 首次发布 · 站长运营看板

· 后台新增「数据看板」：今天 / 近 7 天 / 近 30 天的新增用户、新增主题、新增回帖、活跃人数、
签到人数与积分发放消耗一眼看清，另有产出趋势图（只取每日快照，不实时重算历史）。
· 活跃分层与滚动留存：新用户 / 活跃 / 沉默 / 流失四层，次日、7 日、30 日回访率。
· 本周期 Top 版块与 Top 作者（匿名内容永不进作者维度）。
· 每天自动记一份全站快照，每小时滚动更新；保留天数、时区、采样上限等 10 项可配。
· 每周自动生成一份「上周 vs 上上周」的数据周报，也可在后台一键立即生成。
· 支持按时间范围（7/30/90/180 天）筛选，并可导出 CSV（日快照 / Top 作者 / Top 版块）。
· 新增「插件生态体检」页：各插件的数据表行数、站点标记、计划任务状态与页面开销，方便判断该留该关。
· 仅管理团队可见；只读取论坛数据，不会改动任何内容与其它插件的数据。

版本 1.1.0 更新：
1.1.0 · 日快照不再漏记

• 修复（数据完整性）：日快照只补「缺失的那一天」，而写快照的唯一入口就是这个函数 ⇒ 每天最后一轮计划任务之后的活动（最多约一个小时）永久进不了统计，任何配置都补不回。现在每天都把「昨天」重算一次（更早的历史行仍不重写，保持"历史行绝不回写"的既有语义）。
• 附带：匿名口径的快照夹具更稳（只统计非匿名行，避免与匿名区插件的数据变化耦合）。

升级：覆盖文件即生效，无数据结构变更。

版本 1.1.1 更新：
1.1.1 · 结构版本戳扶正：覆盖文件升级也能自愈

• 修复（升级路径）：本插件的"结构版本戳"此前是只写不读的 —— 安装时写下、卸载时清掉，没有任何代码读它，而补列/建索引只发生在 install() 里。

后果：覆盖插件文件升级（不跑 install）时，若库里的表缺列/缺索引，运行期不会有任何东西去补 —— 那句"与标记比对"的注释描述的护栏其实不存在。
（这条是工具找出来的：设置键审计的"写了没人读 = 不存在的护栏"口径。）

• 现在：做成真的运行期自愈，与本站其它五款插件同款口径：
• 三道门（内存副本 → 设置标记 → 才真正 DDL）；结构版本戳升到 2，语义 = "自愈机制上线即视为一次结构修订"；
• 老站（标记为 1 或缺失）会在首次请求做一次幂等补齐（缺列补齐 + 缺索引补建）并把标记写成 2，之后回到零额外查询的快路径；
• 建表/补列/建索引的定义只写一份（install 与自愈共用），不会再出现两处定义漂移；
• DDL 段不抛异常（并发下后到者失败只会这一次没补上，下次请求再补，不会导致插件被停用）。
• 本版不改结构：没有新增/删除任何表、列、索引 —— 结构与 1.1.0 逐字节相同；页面的查询预算不变（后台看板仍是它自己的 6 条聚合）。
• 对本站：装不装都不影响前台；升级后第一次打开后台看板时顺手把结构对齐，之后一切照旧。