plugin-article-analysis

Halo 文章数据趋势分析插件：在 Console 提供全站与单篇文章的数据看板，帮助站长掌握内容表现。

功能特性

全站数据看板

• 汇总卡片：文章总数、总阅读量、总评论数、总点赞数
• 区间统计：浏览量、访客数、访问次数、跳出率、平均访问时长、点赞量
• 趋势图：每日浏览量折线图，支持悬停查看当日浏览量 / 访问次数 / 点赞量
• 数据列表：按天的浏览量 / 访问次数 / 点赞量明细
• 时间范围：近 7 天 / 近 30 天 / 近 90 天 / 自定义起止日期

单篇文章分析

• 文章列表：封面、标题、状态、分类、阅读、评论、点赞、发布时间
• 支持关键词搜索、分类筛选、状态页签（全部 / 已发布 / 草稿 / 待审核）、列头排序与分页
• 单篇详情抽屉：发布至今总数据（阅读 / 评论 / 点赞）+ 区间趋势图与每日明细
• 一键导出当前筛选结果为 CSV（带 BOM，Excel 可直接打开）

每日点赞统计

Halo 仅保存文章的累计点赞数，不记录每次点赞的时间。本插件通过周期性比对文章点赞计数快照，将增量归属到当日并持久化，从而提供按日维度的点赞统计：

• 全站视图展示全站文章当日点赞合计，单篇抽屉展示该文章的每日点赞
• 数据自插件启用后开始积累，启用前的历史点赞无法按日追溯；插件重启不丢数据
• 与前台展示口径一致，统计原始点赞计数（不扣减取消点赞）
• 统计时区默认为服务器时区，可在插件设置中修改（如 Asia/Shanghai）

安装

要求 Halo 2.21+（建议在 2.23 及以上版本使用）。

1. 从 Releases 下载最新的 plugin-article-analysis-*.jar
2. Halo Console → 左侧「插件」→ 右上角「安装」→ 上传 jar 并启用
3. 左侧「内容」下出现「文章数据」菜单即安装成功

升级：Console → 插件 → 「文章数据趋势分析」→「升级」，上传新版本 jar 即可，配置不会丢失。

配置

入口：Console → 插件 → 「文章数据趋势分析」→ 设置。

Umami 统计（可选）

趋势图中的浏览量、访客数、访问次数、跳出率、平均访问时长来自 Umami，需自行部署 Umami 并在插件设置中填写：

API Key / 账密仅保存在服务端 ConfigMap 中，由插件后端代理查询，不会下发到浏览器。未配置 Umami 时，文章列表、汇总卡片、每日点赞统计与导出功能均正常，仅趋势图区域提示未配置。

点赞统计

使用

入口：Console → 内容 → 文章数据。

• 趋势图：全站每日趋势，鼠标悬停查看单日数据
• 数据列表：全站每日明细（倒序）
• 单篇文章分析：文章管理表格，行内「数据」打开单篇详情抽屉，「编辑」跳转编辑器，「查看」跳转前台页面
• 导出数据：右上角导出当前筛选结果为 CSV

构建

# 前端（产物写入 src/main/resources/console）
pnpm -C ui install && pnpm -C ui build

# 插件 jar（产物 build/libs/plugin-article-analysis-<version>.jar，需 JDK 21）
./gradlew build -x test

License

MIT