Epic Awesome Gamer

Epic Awesome Gamer（AiHubMix版）是一款基于Python开发的全自动Epic Games Store免费游戏领取工具，核心定位为GitHub Actions环境量身打造的免费游戏领取机器人，实现“配置一次，永久自动运行”，无需本地挂机，零成本帮你不漏掉任何一款Epic免费游戏。

本项目基于原作者QIN2DIM的epic-awesome-gamer进行二次开发与深度重构，在保留原版核心领取功能的基础上，解决了诸多实际使用中的痛点问题，同时新增了多项实用功能，让免费游戏领取更稳定、更高效。在此特别感谢原作者的开源贡献与灵感！

相较于原版，本修改版的核心改进集中在三个方面：

1. 集成AiHubMix（Gemini）多模态大模型，通过底层补丁完美解决中转站API兼容性问题，轻松突破hCaptcha验证。
2. 专门针对GitHub Actions环境进行深度优化，适配云端运行场景，无需本地部署挂机，降低使用门槛。
3. 新增即时结账（Instant Checkout）和弹窗拦截逻辑，修复了特殊游戏、捆绑包无法领取的问题，提升领取成功率。

核心特性：全自动、高成功率、零成本运行

Epic Awesome Gamer（AiHubMix版）的功能围绕“稳定、高效、全自动领取Epic免费游戏”展开，核心特性覆盖领取全流程，解决各类领取痛点，具体如下：

推荐部署：GitHub Actions（永久免费，一次配置终身受益）

这是最推荐的部署方式，完全免费，无需自有服务器，配置一次即可实现永久自动运行，适合大多数普通用户。

步骤1：Fork项目仓库

打开项目GitHub页面，点击页面右上角的Fork按钮，将本项目克隆到你自己的GitHub账号下（需提前登录GitHub账号），Fork完成后，该项目会出现在你的个人仓库列表中。

步骤2：配置仓库Secrets（核心必填）

Secrets用于存储你的Epic账号信息、API密钥等敏感数据，确保信息不泄露，配置步骤如下：

1. 进入你Fork后的项目仓库，依次点击：Settings（设置）-> Secrets and variables（密钥和变量）-> Actions（工作流）-> New repository secret（新建仓库密钥）。
2. 依次添加以下3个必填变量，缺一不可：

步骤3：可选高级配置（按需调整）

如果需要更换Gemini中转站或模型，可额外添加以下可选变量，不添加则使用默认值：

步骤4：启动工作流，测试运行效果

1. 点击项目仓库上方的Actions（行动）标签页。
2. 若看到绿色按钮I understand my workflows...，点击该按钮启用工作流（首次使用GitHub Actions需完成此步骤）。
3. 在左侧工作流列表中，选择Epic Free Games工作流。
4. 点击右侧的Run workflow（运行工作流），选择默认分支后点击Run workflow，手动触发第一次运行测试。

✅ 成功提示：首次手动运行测试通过后，后续脚本会根据.github/workflows目录中的定时配置自动运行（默认每周定时执行），无需再手动干预，全程自动领取免费游戏。

备选部署：本地/Docker（自有服务器专属，支持数据持久化）

如果你拥有自己的服务器（VPS、NAS、云服务器等），可以选择Docker Compose一键部署，该方式支持数据持久化，重启容器无需重新登录Epic账号，适合希望更自主掌控运行流程的用户。

前置准备

提前在服务器上安装Docker和Docker Compose（推荐最新稳定版）。

步骤1：克隆项目代码，进入Docker目录

# 克隆项目源码到本地服务器
git clone https://github.com/10000ge10000/epic-awesome-gamer.git
# 进入项目的Docker部署目录
cd epic-awesome-gamer/docker

步骤2：配置账号与API密钥

直接编辑当前目录下的docker-compose.yaml文件，修改environment节点下的环境变量，填写你的真实信息：

version: '3'
services:
  epic-awesome-gamer:
    image: ghcr.io/10000ge10000/epic-awesome-gamer:latest
    environment:
      # 以下3项为必填，替换为你的真实信息
      - EPIC_EMAIL=your_email@example.com      # <--- 修改：Epic账号邮箱（关闭2FA）
      - EPIC_PASSWORD=your_password            # <--- 修改：Epic账号密码
      - GEMINI_API_KEY=sk-xxxxxxxxxxxx         # <--- 修改：Gemini API Key
      # 可选：修改Gemini中转站地址，不修改则使用默认值
      - GEMINI_BASE_URL=https://aihubmix.com
    volumes:
      # 数据持久化挂载，保存登录凭证、日志等
      - ./volumes:/app/data
    restart: always # 容器异常退出时自动重启

步骤3：启动Docker容器，后台运行

# 一键启动容器（后台运行模式）
docker compose up -d

关键说明：数据持久化

容器启动后，你的Epic账号登录凭证（Cookies）、验证截图和运行日志，会自动保存在当前目录下的./volumes文件夹中。即使后续删除、重启容器，只要./volumes文件夹未被删除，再次启动容器时无需重新登录Epic账号，直接复用原有登录凭证，提升使用便捷性。

常见问题（FAQ）：解决使用中的核心痛点

Q1：为什么日志显示 "Login with Email ... Timeout"（登录超时）？

A1：这是因为GitHub Actions的共享IP段可能被Epic Games临时风控，导致脚本无法正常完成登录流程。

• 典型现象：脚本能正常打开Epic登录页面，但在点击登录按钮后无任何反应，最终超时退出。
• 解决方法：
  1. GitHub Actions工作流会自动重试，可先等待一段时间观察是否恢复。
  2. 若连续失败，可等待1-2小时后，手动进入仓库Actions页面，重新触发Epic Free Games工作流，GitHub分配新的IP后通常即可恢复正常。

Q2：使用中转API报错 "400 Bad Request" 或 "File API not supported"（文件API不支持）？

A2：请确保你使用的是本仓库的最新代码，这是解决该问题的核心。

• 本项目内置了utils.py文件底层补丁，会自动拦截Google SDK的文件上传行为，将图片文件转换为Inline Base64格式数据进行传输，完美绕过了中转站对文件上传API的限制。
• 若仍报错，可尝试更新项目代码（Fork仓库后同步上游最新代码），或更换其他AiHubMix类中转站。

Q3：必须关闭二步验证（2FA）吗？有没有其他替代方案？

A3：是的，必须关闭二步验证（2FA），暂时没有其他有效替代方案。

• 由于脚本运行在无头模式（Headless）下，无法像人工操作一样接收并输入短信、邮件或验证器中的验证码，因此无法处理2FA验证步骤。
• 操作建议：在Epic Games官网的账户设置中暂时禁用2FA，待脚本部署完成并正常运行后，若担心账号安全，可在确认领取流程稳定后，根据自身需求考虑是否重新开启（重新开启后脚本将无法正常登录）。