更新内容

📱 适配 Halo Pocket 移动端

• 插件简介与文档补充 Halo Pocket 适配说明
• 开放 umami/metrics?type=referrer 来源分布维度 API（v1.1.3 起），供 Halo Pocket 统计页展示访客来源构成

Halo Pocket 是 Halo 2.x 博客的管理端移动客户端，现已上架华为应用市场，搜索「Halo Pocket」即可免费下载使用。

升级说明

• Console → 插件 →「文章数据趋势分析」→「升级」，上传新版本 jar 即可，配置与点赞统计数据不会丢失

Generated from v1.1.4

查看版本详情

更新内容

📱 适配 Halo Pocket 移动端

• 开放 umami/metrics?type=referrer 来源分布维度 API，供 Halo Pocket（Halo 2.x 跨平台移动客户端）统计页展示访客来源构成（按域名聚合，直接访问单独归类）
• App 首页「最新动态」的每日点赞汇总、统计看板数据均来自本插件 API，升级后移动端体验更完整

升级说明

• Console → 插件 →「文章数据趋势分析」→「升级」，上传新版本 jar 即可，配置与点赞统计数据不会丢失
• 未使用 Halo Pocket 的用户无感知，可正常升级

Generated from v1.1.3

查看版本详情

新增：地域分布（中国省份地图 + 世界地图）

• 「文章数据 → 地域分布」页签（与趋势图 / 数据列表同级）
• 中国 34 省级行政区热力地图（默认视图，按会话量着色，省份标签 + 悬停详情）
• 世界地图切换（按国家着色，175 国），国家 / 地区 Top12 排行（国旗 emoji）
• 国内省份 / 地区排行，兼容 CN-GD / GD / CN-11 三种 region 码并按省去重
• 后端新增 GET umami/metrics?type=country|region|city&startAt=&endAt=&limit= 代理端点（复用登录换 token，未配置/异常自动降级）
• 支持近 7 / 30 / 90 天与自定义起止日期
• 地图数据来源：Natural Earth 110m（世界）、DataV GeoAtlas（中国省份）

Generated from v1.1.2

查看版本详情

变更

修复：Umami 认证方式统一为登录账密，移除无效的 API Key 字段

自托管 Umami（任意版本，含 v2.x / v3.x）均没有「设置 → API keys」功能，API Key 仅为 Umami Cloud 的特性。原设置项对用户产生误导，且此前设置界面没有账密输入项（后端早已支持账密登录换令牌）。

• 设置表单：移除 API Key，新增「登录用户名」「登录密码」
• 后端：移除 apiKey 优先逻辑，统一通过 /api/auth/login 换取访问令牌
• Console 提示文案与 README 同步修正

升级提示

升级后请前往插件设置重新填写 Umami 登录用户名和密码，原 API Key 配置项不再生效。

Full Changelog: v1.0.7...v1.0.8

Generated from v1.0.8

查看版本详情

v1.0.7 数据区间与点赞明细

• 单篇文章分析支持数据区间（近7/30/90天/自定义）：新增「区间阅读」「区间点赞」可排序列，CSV 导出同步包含
• 全站数据列表新增「点赞明细」列：当天被赞文章一目了然，点击直达单篇数据抽屉
• 区间阅读基于 Umami 按 URL 聚合（兼容新旧版本 Umami），区间点赞基于按日明细求和

要求 Halo 2.21+。

查看版本详情

v1.0.6 数据区间与点赞明细

• 单篇文章分析支持数据区间（近7/30/90天/自定义）：新增「区间阅读」「区间点赞」可排序列，CSV 导出同步包含
• 全站数据列表新增「点赞明细」列：当天被赞文章一目了然，点击直达单篇数据抽屉
• 区间阅读基于 Umami 按 URL 聚合（兼容新旧版本 Umami），区间点赞基于按日明细求和

要求 Halo 2.21+。

查看版本详情

v1.0.1 应用市场审核整改

• 数据生命周期：每日点赞统计改为有界存储——默认仅保留 90 天（可配置 7-365），过期数据每次轮询自动清理；已删除文章的快照自动移除；每日单篇明细上限 1000 篇；新增 DELETE 重置端点；README 补充完整的数据存储、清理、备份与卸载说明
• 性能：点赞计数轮询间隔从 60 秒降至默认 300 秒（可配置 60-3600 秒）
• 合规：Java 包与自定义 API group 从平台保留的 run.halo 命名空间迁移至 io.github.shirainbown
• 许可：补充 MIT LICENSE 文件并随制品分发，仓库、制品与市场资料保持一致

要求 Halo 2.21+。

查看版本详情