🍷 优雅、智能、全自动。
专为 GitHub Actions 打造的 Epic Games Store 免费游戏领取机器人。
Epic Awesome Gamer (AiHubMix 版) 是一款基于 Python 的全自动 Epic 游戏领取工具。
本项目基于原作者 QIN2DIM/epic-awesome-gamer 进行二次开发与深度重构。在此特别感谢原作者的开源贡献与灵感！
本修改版的主要改进：
- 集成了 AiHubMix (Gemini) 多模态大模型，通过底层补丁完美解决中转站 API 兼容性问题。
- 专门针对 GitHub Actions 环境优化，无需本地挂机。
- 新增 即时结账 (Instant Checkout) 和 弹窗拦截 逻辑，修复了无法领取 特殊游戏 的问题。
| 模块 | 功能描述 |
|---|---|
| 🤖 AI 强力驱动 | 内置针对 google-genai SDK 的底层补丁，适配 AiHubMix 等中转站，支持 Base64 图片直传，0 报错通过 hCaptcha 验证。 |
| ⚡️ 即时结账支持 | 独家支持 Instant Checkout 流程。自动识别点击 "Get" 后弹出的支付窗口，不再因为找不到购物车而漏领。 |
| 🛡️ 智能弹窗处理 | 自动识别并处理 "内容警告 (Content Warning)" 和年龄限制弹窗，确保脚本不会卡在确认页面。 |
| 📦 全内容收集 | 移除了原版的捆绑包过滤逻辑，无论是普通游戏还是 Bundles，所有免费内容一网打尽。 |
| ☁️ 云端自动运行 | 深度适配 GitHub Actions，利用 uv 极速管理依赖，每周定时自动执行，零成本守护游戏库。 |
这是最推荐的部署方式，完全免费，配置一次即可永久自动运行。
点击页面右上角的 Fork 按钮，将本项目克隆到你自己的 GitHub 账号下。
进入你 Fork 后的仓库，依次点击：
Settings -> Secrets and variables -> Actions -> New repository secret
添加以下必要变量：
| 变量名 | 必填 | 说明 | 示例 |
|---|---|---|---|
EPIC_EMAIL |
✅ | Epic 账号邮箱 (必须关闭 2FA) | [email protected] |
EPIC_PASSWORD |
✅ | Epic 账号密码 | password123 |
GEMINI_API_KEY |
✅ | AiHubMix 或 Google 的 API Key | sk-xxxxxxxx |
| 变量名 | 默认值 | 说明 |
|---|---|---|
GEMINI_BASE_URL |
https://aihubmix.com |
如果使用官方接口，请填 https://generativelanguage.googleapis.com |
GEMINI_MODEL |
gemini-2.5-pro |
推荐使用 2.5 Pro 或 1.5 Pro，视觉识别能力更强 |
- 点击仓库上方的 Actions 标签页。
- 如果看到绿色按钮 I understand my workflows...，请点击启用。
- 选择左侧的
Epic Free Games工作流。 - 点击右侧的 Run workflow 手动触发第一次运行测试。
✅ 成功提示：之后的每周，脚本都会根据
.github/workflows中的定时配置自动运行。
如果您拥有自己的服务器（VPS/NAS），可以使用 Docker Compose 一键部署。此版本已配置数据持久化，重启容器无需重新登录。
git clone https://github.com/10000ge10000/epic-awesome-gamer.git
cd epic-awesome-gamer/docker
直接编辑 docker-compose.yaml 文件，修改 environment 下的变量：
version: '3'
services:
epic-awesome-gamer:
image: ghcr.io/10000ge10000/epic-awesome-gamer:latest
environment:
- [email protected] # <--- 修改这里
- EPIC_PASSWORD=your_password # <--- 修改这里
- GEMINI_API_KEY=sk-xxxxxxxxxxxx # <--- 修改这里
# 可选：修改中转地址
- GEMINI_BASE_URL=[https://aihubmix.com](https://aihubmix.com)
# ...
docker compose up -d
💾 关于数据持久化： 容器启动后，您的登录凭证（Cookies）、截图和日志会自动保存在当前目录下的
./volumes文件夹中。 即使删除或重启容器，只要./volumes文件夹还在，就不需要重新登录。
Q: 为什么日志显示 "Login with Email ... Timeout"?
A: 这是因为 GitHub Actions 的共享 IP 段可能被 Epic 临时风控。
- 现象：脚本能打开页面，但在点击登录按钮时无反应。
- 解决：通常 GitHub 会自动重试。如果连续失败，请等待 1-2 小时后手动重新运行工作流，GitHub 分配新 IP 后即可恢复。
Q: 使用中转 API 报错 "400 Bad Request" 或 "File API not supported"?
A: 请确保你使用的是本仓库的最新代码。
- 本项目内置了
utils.py补丁，会拦截 Google SDK 的文件上传行为，将其转换为 Inline Base64 数据。 - 这完美绕过了中转站对文件上传 API 的限制。
Q: 必须关闭二步验证 (2FA) 吗？
A: 是的，必须关闭。 由于脚本运行在无头模式 (Headless) 下，无法处理短信或邮件验证码。请在 Epic 官网账户设置中暂时禁用 2FA。
- 本项目仅供 Python 学习与技术交流使用。
- 使用脚本自动化操作可能违反 Epic Games 的服务条款，使用者需自行承担风险。
- 请勿将本项目用于任何商业用途。