FIT2CLOUD
Steam 信息展示 的图标

Steam 信息展示

986
282

在 Halo 博客中展示 Steam 用户资料、游戏库和最近游玩记录

0.2.0-beta.2
TimOxO 发布于

v0.2.0-beta.2

预发布
>=2.22.1

本次更新包含 核心算法重构资源命名规范化,旨在彻底解决时长统计异常问题并提升插件的长期稳定性。

⚠️ 重要升级提示

由于对 Custom Resource Group 进行了规范化修正(steam.halo.runsteam.timxs.com),本次更新将重置所有历史统计数据
升级后,插件将基于新算法重新开始记录游戏时长与热力图数据,旧数据虽然保留在数据库中但不再显示。建议在升级后手动点击控
制台的「刷新缓存」按钮。
也可以在升级前通过数据工厂导出模型 DailyPlaytimeRecord 与模型 PlaytimeSnapshot 记录,批量修改 "apiVersion": "steam.halo.run/v1alpha1""apiVersion": "steam.timxs.com/v1alpha1" 即可保留数据。

🐛 问题修复 (Bug Fixes)

  • 重构游戏时长统计算法(智能平滑处理)

    • 修复了因 服务中断定时任务漏跑(如 Halo 重启、网络波动)导致的数据堆积问题。
    • 旧版行为:当检测间隔跨越多个日期时(例如插件停机两天后恢复),累积时长会全部记在恢复当天,导致单日数据虚高
      且中间日期断层。
    • 新版行为:引入 时间窗口加权算法,自动检测时间跨度,将累积时长按比例平滑分配给期间的每一天,确保热力图数据的连续性与合理性。
  • 修复 API 路由与资源命名不规范

    • 将所有 API 路由域名统一修正为 api.steam.timxs.com
    • 修正了 CRD Group 定义,符合 Halo 插件开发的最佳实践。
  • 修复前端页面与设置项的死链

    • 修复了设置页面的「验证配置」、「刷新缓存」、「手动追踪」按钮因 API 地址变更失效的问题。
    • 修复了 steam.html 模板中热力图数据加载失败的问题。

⚡ 改进与优化 (Improvements)

  • 新增异常数据熔断保护

    • 当检测到数据跨度超过 60天(如长期弃坑后回归)时,系统将跳过每日明细生成,仅更新总时长快照。这有效防止了极端脏数据破坏热力图的可读性。
  • 提升系统健壮性

    • 增强了 PlaytimeTrackingService 对异常时间窗口(如负数时间差)的防御性检查。

Generated from v0.2.0-beta.2

资源下载

  • plugin-steam-0.2.0-beta.2.jar