告别手动记录！Hydra自动生成游戏时间报告全攻略

你是否也曾困惑：明明只打算玩半小时游戏，却不知不觉度过了整个下午？想统计自己在《赛博朋克2077》中究竟投入了多少小时，却翻遍设置也找不到详细记录？现在，Hydra游戏启动器（项目路径）的游戏时间统计功能，让这些问题成为过去。

读完本文你将学会：

• 启用自动游戏时长追踪
• 手动调整与校准游戏时间
• 生成个性化时间报告
• 同步数据至云端

时间追踪原理：无缝记录你的游戏历程

Hydra通过双重机制实现精准计时：当你点击"开始游戏"按钮时，系统会启动进程监控器(src/main/services/process-watcher.ts)，自动记录游戏运行时长。即使意外关闭游戏，数据也会安全保存至本地数据库(src/main/level/sublevels/games.ts)。

核心实现位于changeGamePlaytime函数：

await gamesSublevel.put(gameKey, {
  ...game,
  playTimeInMilliseconds: playTimeInSeconds * 1000,
  hasManuallyUpdatedPlaytime: true,
});

这段代码将毫秒级时间戳转换为人类可读格式，并标记手动调整记录，确保数据准确性。

开启自动统计：三步完成设置

1. 确认游戏已添加至库
   确保游戏已通过"添加游戏到库"功能(src/main/events/library/add-game-to-library.ts)正确导入，未入库游戏无法追踪时长。

2. 启用自动监控
   进入游戏详情页，勾选"自动记录游戏时间"选项。系统会自动关联可执行文件路径(src/main/events/helpers/parse-executable-path.ts)，无需额外配置。

3. 验证追踪状态
   启动游戏后，打开任务管理器可看到hydra-process-watcher进程在后台运行，这表明计时系统已激活。

手动校准：精确到秒的时间管理

当你需要调整时间记录时（如导入其他平台存档），可通过两种方式操作：

快速调整

1. 在游戏卡片右键菜单选择"调整游戏时间"
2. 输入分钟数（支持正负值）
3. 系统自动计算新时长并同步至云端：

await HydraApi.put(`/profile/games/${shop}/${objectId}/playtime`, {
  playTimeInSeconds,
});

精确校准

对于需要毫秒级精度的场景，编辑配置文件(src/main/level/sublevels/games.ts)直接修改playTimeInMilliseconds字段值，适用于高级用户。

生成报告：数据可视化你的游戏生活

Hydra提供三种时间报告类型，所有数据来源于getGameStats接口(src/main/events/catalogue/get-game-stats.ts)：

1. 周度摘要

自动统计过去7天游戏时长，以环形图展示各游戏占比。数据缓存机制确保快速加载：

const LOCAL_CACHE_EXPIRATION = 1000 * 60 * 30; // 30分钟缓存
if (cachedStats && cachedStats.updatedAt + LOCAL_CACHE_EXPIRATION > Date.now()) {
  return cachedStats;
}

2. 月度趋势分析

以折线图展示30天内游戏习惯变化，帮助识别沉迷风险。可通过"数据导出"按钮保存为CSV格式，用于制作个人游戏日记。

3. 成就解锁时间线

将游戏时长与成就解锁时间关联，生成交互式时间轴。这项高级功能需要在设置中启用"详细日志记录"(src/main/events/user-preferences/update-user-preferences.ts)。

数据安全：本地存储与云端同步

Hydra采用混合存储方案保护你的游戏时间数据：

• 本地优先：所有原始数据存储在LevelDB数据库(src/main/level/index.ts)，即使断网也能正常记录
• 加密同步：启用云同步后，数据会加密传输至Hydra服务器(src/main/services/hydra-api.ts)
• 隐私保护：时间记录仅用于个人统计，不会共享给第三方开发者

常见问题解决

时间统计异常？

• 检查游戏进程名称是否匹配(src/main/events/helpers/verify-executable-path.ts)
• 手动触发同步：设置 > 高级 > 重建时间统计缓存

无法生成报告？

确保缓存未过期，或通过以下代码强制刷新：

await gamesStatsCacheSublevel.clear(); // 清除缓存

未来展望

下版本将新增：

• 多设备时间合并算法
• 游戏时段分析（工作日/周末对比）
• 好友游戏时长排行榜

立即更新Hydra至最新版体验完整功能！如有疑问，可查阅官方文档(docs/)或提交issue反馈。

提示：定期导出时间报告可参与Hydra社区月度游戏挑战活动，优质报告有机会获得官方周边奖励。