已适配 Halo Pocket 移动端（Halo 2.x 博客管理端 App，华为应用市场搜索「Halo Pocket」免费下载），手机上也能随时查看站点数据。
plugin-article-analysis
Halo 文章数据趋势分析插件：在 Console 提供全站与单篇文章的数据看板，帮助站长掌握内容表现。
💬 使用交流：插件配套的 Umami 部署与数据统计教程见博客文章 《Halo 博客访问量统计系统：Umami 自托管部署完整教程》，遇到问题或有功能建议欢迎在文章下方留言评论，会及时回复。
功能特性
全站数据看板
- 汇总卡片：文章总数、总阅读量、总评论数、总点赞数
- 区间统计：浏览量、访客数、访问次数、跳出率、平均访问时长、点赞量
- 趋势图：每日浏览量折线图，支持悬停查看当日浏览量 / 访问次数 / 点赞量
- 数据列表：按天的浏览量 / 访问次数 / 点赞量明细
- 时间范围：近 7 天 / 近 30 天 / 近 90 天 / 自定义起止日期
单篇文章分析
- 文章列表：封面、标题、状态、分类、阅读、评论、点赞、发布时间
- 支持关键词搜索、分类筛选、状态页签（全部 / 已发布 / 草稿 / 待审核）、列头排序与分页
- 单篇详情抽屉：发布至今总数据（阅读 / 评论 / 点赞）+ 区间趋势图与每日明细
- 一键导出当前筛选结果为 CSV（带 BOM，Excel 可直接打开）
每日点赞统计
Halo 仅保存文章的累计点赞数，不记录每次点赞的时间。本插件通过周期性比对文章点赞计数快照，将增量归属到当日并持久化，从而提供按日维度的点赞统计：
- 全站视图展示全站文章当日点赞合计，单篇抽屉展示该文章的每日点赞
- 数据自插件启用后开始积累，启用前的历史点赞无法按日追溯；插件重启不丢数据
- 与前台展示口径一致，统计原始点赞计数（不扣减取消点赞）
- 统计时区默认为服务器时区，可在插件设置中修改（如
Asia/Shanghai）
安装
要求 Halo 2.21+（建议在 2.23 及以上版本使用）。
- 从 Releases 下载最新的
plugin-article-analysis-*.jar - Halo Console → 左侧「插件」→ 右上角「安装」→ 上传 jar 并启用
- 左侧「内容」下出现「文章数据」菜单即安装成功
升级：Console → 插件 → 「文章数据趋势分析」→「升级」，上传新版本 jar 即可，配置不会丢失。
配置
入口：Console → 插件 → 「文章数据趋势分析」→ 设置。
Umami 统计（可选）
趋势图中的浏览量、访客数、访问次数、跳出率、平均访问时长来自 Umami，需自行部署 Umami 并在插件设置中填写：
| 字段 | 说明 |
|---|---|
| Umami 服务地址 | 如 https://umami.example.com（不含末尾斜杠） |
| 站点 ID（Website ID） | Umami 网站详情中的 Website ID（UUID） |
| API Key | Umami 2.13+「设置 → API keys」中创建 |
| 登录用户名 / 密码 | 未配置 API Key 时，用账密登录换取访问令牌（兼容 Umami 2.13 以下版本） |
API Key / 账密仅保存在服务端 ConfigMap 中，由插件后端代理查询，不会下发到浏览器。未配置 Umami 时，文章列表、汇总卡片、每日点赞统计与导出功能均正常，仅趋势图区域提示未配置。
点赞统计
| 字段 | 说明 |
|---|---|
| 统计时区 | 每日点赞按此时区的自然日归档，例如 Asia/Shanghai；留空使用服务器默认时区 |
使用
入口：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