🤖 Epic 免费人 (AiHubMix 增强版)：利用 Gemini AI 实现全自动领取终极指南
作者/博主：一万AI分享
项目背景：本项目基于原作者 QIN2DIM/epic-awesome-gamer 进行二次开发与深度重构，针对国内环境及特殊领取逻辑进行了全面增强。
🌟 为什么选择这个增强版？
在众多的自动领取脚本中，本项目（AiHubMix Enhanced Edition）针对当前 Epic 的风控与领取痛点进行了深度优化：
- 🤖 AI 强力过验证：内置底层补丁，完美适配 AiHubMix 等中转站。即使在国内无法直连 Google，也能通过 Base64 直传调用 Gemini 系列模型，秒杀 hCaptcha 旋转/点击验证码。
- ⚡️ 独家支持即时结账：修复了类似《Blood West》这类点击 "Get" 后直接弹出支付窗口（Instant Checkout）的游戏无法领取的问题，彻底解决漏领隐患。
- 📦 全内容一网打尽：移除了原版的捆绑包过滤逻辑，无论是普通游戏还是 Bundles 捆绑包，所有免费内容全部自动入库。
- 🛡️ 智能弹窗处理：自动识别并点击“内容警告 (Content Warning)”和“年龄限制”弹窗，确保自动化流程零卡顿。
🛠️ 前置准备工作
在开始部署之前，请先准备好以下“原材料”：
- 账号调整：进入 Epic 账户设置，必须暂时禁用该账户的邮箱或手机二步验证 (2FA)。
- 获取 Gemini API Key：
- 方案 A（官方）：访问 Google AI Studio 免费获取（需海外环境）。
- 方案 B（推荐）：使用 AiHubMix 等第三方中转服务，支持国内直连。
- 项目源码：Fork 本项目仓库 到你的个人账号。
🚀 场景一：云端自动化 (GitHub Actions) —— 推荐 🔥
如果你没有 24 小时开机的服务器，利用 GitHub 的免费资源是最高效的选择。
1. 配置环境变量 (Secrets)
在 GitHub 仓库的 Settings -> Secrets and variables -> Actions 中添加以下变量：
| 变量名 | 必填 | 默认值 / 示例 | 功能说明 |
|---|---|---|---|
EPIC_EMAIL |
✅ | [email protected] |
Epic 账号邮箱（需关 2FA）。 |
EPIC_PASSWORD |
✅ | password123 |
Epic 账号密码。 |
GEMINI_API_KEY |
✅ | sk-xxxxxxxx |
你的 API Key。 |
GEMINI_BASE_URL |
❌ | https://aihubmix.com |
接口地址（官方填 https://generativelanguage.googleapis.com）。 |
GEMINI_MODEL |
❌ | gemini-2.5-pro |
建议： 2025 年末 Pro 模型配额受限，推荐用 1.5-flash。 |
2. 启用工作流
进入 Actions 页面，手动启用 Workflow 并点击 Run workflow 进行初次测试。此后它将根据 Cron 表达式每周定时运行。
3：项目私有化
因GitHub政策原因，建议将fork后的项目私有化
🏠 场景二：飞牛 NAS (FnOS) / Docker 本地部署
对于本地 NAS 用户，使用 Docker Compose 部署最为稳定，且方便管理运行日志。
1. 部署配置 (docker-compose.yaml)
在 NAS 中创建文件夹 epic-auto，新建 docker-compose.yaml
并填入以下内容，并修改核心账号配置。
name: epic-awesome-gamer
services:
epic-awesome-gamer:
image: ghcr.io/10000ge10000/epic-awesome-gamer:latest
restart: always
container_name: epic-awesome-gamer
environment:
- TZ=Asia/Shanghai
# ----------------------------------------
# 核心账号配置
# ----------------------------------------
- EPIC_EMAIL=你的邮箱@example.com
- EPIC_PASSWORD=你的密码
- GEMINI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxx
# ----------------------------------------
# AiHubMix / Gemini 配置
# ----------------------------------------
- GEMINI_BASE_URL=https://aihubmix.com
- GEMINI_MODEL=gemini-2.5-pro
# ----------------------------------------
# 运行参数
# ----------------------------------------
- ENABLE_APSCHEDULER=true
- DISABLE_BEZIER_TRAJECTORY=true
- EXECUTION_TIMEOUT=120
- RESPONSE_TIMEOUT=30
- RETRY_ON_FAILURE=true
- WAIT_FOR_CHALLENGE_VIEW_TO_RENDER_MS=1500
- CONSTRAINT_RESPONSE_SCHEMA=true
- CHALLENGE_CLASSIFIER_MODEL=gemini-2.5-flash
- IMAGE_CLASSIFIER_MODEL=gemini-2.5-pro
- SPATIAL_POINT_REASONER_MODEL=gemini-2.5-pro
- SPATIAL_PATH_REASONER_MODEL=gemini-2.5-pro
- IMAGE_CLASSIFIER_THINKING_BUDGET=970
- SPATIAL_POINT_THINKING_BUDGET=1387
- SPATIAL_PATH_THINKING_BUDGET=1652
volumes:
- "./volumes/:/app/app/volumes/"
entrypoint: [ "/usr/bin/tini", "--" ]
command: xvfb-run --auto-servernum --server-num=1 --server-args='-screen 0, 1920x1080x24' uv run app/deploy.py
mem_limit: 4g
shm_size: '2gb'
2. 启动与持久化
- 启动：在终端运行
docker compose up -d。 - 重要：务必确认
./volumes/目录已生成，它保存了你的 Cookies 和运行日志，确保下次运行无需重新验证。
🔍 如何确认运行状态？
通过查看容器日志（docker logs -f epic-awesome-gamer），你可以实时观察 AI 的操作：
- 识别补丁：日志显示
🚀 Base64 文件绕过补丁加载成功。 - 即时结账：遇到特殊游戏时，日志显示
🚀 Triggering Instant Checkout Flow...。 - 成功标志：看到
🎉 Successfully collected，恭喜，游戏入库！
💡 进阶小贴士 (Tips)
[!IMPORTANT]
关于登录超时：GitHub Actions 的共享 IP 有时会被 Epic 风控导致 Timeout。这通常是暂时性的，手动重试一次或等待下一次自动执行即可，无需频繁修改配置。
- 安全性：切勿将包含密码的
.env文件上传到任何公开平台。 - 模型建议：如果你的 API 配额充足，使用
gemini-2.5-pro会有更高的验证码识别成功率；若追求极致稳定，gemini-1.5-flash是首选。
✍️ 结语
技术存在的意义，就是为了让繁琐的生活变得更加优雅。希望这个增强版工具能帮你守住每一个“喜加一”的机会。
如果你觉得本教程有用，欢迎关注我的频道 「一万AI分享」。我在评论区等着你的部署好消息！
评论区