把 Aemeath 的站点统计页移植到 Firefly
最近把 Aemeath 主题里的公开统计页搬到了这个 Firefly 主题里。Aemeath 是原作者的项目，站点地址：http://rainzt.cn。它把 Umami 公开数据、Waline 最新评论、GitHub 推送热力图聚合在一个独立的 /analytics 页面里，做成了一块”会呼吸”的真实数据面板。这篇文章记录移植过程，顺便说明新加了哪些文件。
Aemeath 的原页面地址是作者站点的
/analytics，思路来源与样式实现都值得细看；Firefly 这边做了本地适配。
一、新增的三个文件
1. src/pages/analytics.astro
独立的「站点统计」页面，访问 /analytics/。基于 Umami 的公开分享接口（只读鉴权，不需要管理员 Token），包含：
- 总览卡片：累计访客、累计浏览、今日访客、今日浏览
- 访问脉冲：7 / 30 / 90 天切换的浏览量与访客趋势
- 热门页面排行：按路径的 Top 页面
- 访客分布：设备、浏览器、国内地域分布的环形图与图例
- 流量来源：channel 维度来源渠道
- 部署动态：GitHub main 分支推送热力图
- 最新评论：读取 Waline 公开评论流
页面重点做了容错：单个接口超时只影响对应模块，其他模块照常显示；加了 2 分钟级 localStorage 缓存，Swup 切页后重新挂载动画与数据。
2. src/components/widget/AnalyticsSnapshot.astro
侧栏用的统计快照小组件，展示设备分布和浏览器偏好的环形图（donut），读取同一组 Umami 公开接口，适合挂在侧栏或首页。
3. src/pages/api/github-pushes.json.ts
构建期预渲染的 JSON 接口 /api/github-pushes.json：服务端执行 git log HEAD --since=53 weeks ago 读取提交时间，供统计页的部署热力图使用。移植时把硬编码的仓库名从 Jarvis0227/Aemeath 改成了本站的 qwc-ch/Firefly。
二、配置上的改动
只动了配置，不破坏原有结构：
src/config/analyticsConfig.ts：给 Umami 配置补shareId、shareApiBase（指向自建的https://umami.520781.xyz）、historicalStats、showPageViews、showSiteStatssrc/types/analyticsConfig.ts：同步补充对应类型字段src/config/navBarConfig.ts：「其他」下拉里原来指向 Umami 外部分享页的「统计」，改成本地/analytics/入口
Waline 已经在 src/config/commentConfig.ts 里启用，统计页的最新评论模块会直接复用它的 serverURL，不用额外配置。
三、验证方式
pnpm astro check：282 个文件，0 错误 0 警告pnpm exec biome ci对新增/改动文件：通过
构建流程没有跑完整 build（本地较慢），静态产物和接口在 pnpm astro check 的类型检查下已经通过；部署后访问 /analytics/ 和 /api/github-pushes.json 即可看到效果。
结语
这套统计页的价值在于”公开可读”——不需要暴露 Umami 管理后台，访客也能看到站点的真实活力。移植到 Firefly 后，主题原有的 UmamiStats 侧栏小组件保持不变，/analytics 只是多了一个更完整的数据总览入口。感谢 Aemeath 作者的开源与分享。
文章分享
如果这篇文章对你有帮助，欢迎分享给更多人！