Akebi-GC 入门指南:构建获取、注入启动流程与功能模块全景解析

原创2026-10-15 10:03:192,337 阅读
文章标签:逆向工程

Akebi-GC 入门指南:构建获取、注入启动流程与功能模块全景解析

导读

本文以 Akebi-GC 仓库的 README.md 及其简体中文版 README_zh-Hans.md 为核心骨架,系统讲解该项目的获取方式(稳定版 Release 与最新版 Action 构建)、注入启动流程、配置文件体系与六大类功能模块。同时结合仓库内 injector/、cheat-base/、cheat-library/ 的实际源码,从进程创建、DLL 注入、IL2CPP 初始化、事件 Hook 到热键系统逐层还原底层实现,帮助读者在拿到成品之外,真正理解这个基于 Windows + C++/ImGui 的注入式辅助框架是如何运转的。

项目状态与版本说明

在开始之前需要先了解项目的分发状态。仓库 README 顶部有明确的公告:项目作者近期收到了来自 HoYoverse 的 DMCA 下架通知,因此最新版本的源代码已转为私有,仅对贡献者开放;公开仓库只上传稳定版(Stable Release)构建产物。这意味着:

  • 普通用户应通过 Release 或 CI 构建产物获取可运行版本;
  • 想要获取最新源码并自行编译的开发者,需要先通过贡献渠道与维护者建立联系,或使用仓库中已公开的历史源码进行学习研究。

README 同时提供了多语言入口,本文内容与以下文档相互补充:

获取方式:稳定版与最新版

按 README 的指引,项目提供两条下载路径,按需求二选一即可。

稳定版(Stable Release)

  1. 前往仓库的 Releases 页面;
  2. 下载最新的二进制压缩包,解压后即为完整的可运行目录。

稳定版适合大多数普通用户:经过了维护者验证,功能相对保守但稳定性更高。

最新版(Latest Release,CI 构建)

  1. 前往仓库的 Actions 页面;
  2. 选择 Publish 工作流程,选取最近一次带绿色勾的构建记录;
  3. 关键:按你的客户端版本选择对应的构建目标——GLOBAL(国际服)/ CN(国服)/ BETA(测试服),不同客户端对应不同的游戏进程与函数地址,选错将无法正常注入;
  4. 在本次构建的 Artifacts 中下载 Akebi-GC-release 即可。

最新版基于当前主分支源码构建,通常包含最新的功能与修复,但也可能引入新的问题,适合愿意尝鲜并参与反馈的用户。

自行编译:仓库结构速览

README 指出源码构建方法可参考项目 Wiki 中的 "Building|建置" 页面。由于当前仓库源码已转为私有,此处基于仓库公开目录给出结构级指引,便于理解构建产物与源码的对应关系。

仓库由三个核心工程组成(解决方案文件为 akebi-gc.sln):

工程目录 构建产物 职责
injector injector.exe 启动器:以挂起方式启动游戏进程、注入 DLL、恢复线程
cheat-library CLibrary.dll 注入到游戏进程内的核心功能库(玩家/世界/传送/视觉/调试等)
cheat-base 静态框架 供上面两个工程共用的基础库:配置系统、事件系统、注入、渲染、热键、日志、模式扫描等

编译产出物布局上,injector.exe 与 CLibrary.dll 必须位于同一文件夹,其余运行时文件(字体、地图数据、签名文件等)以资源形式编译进 DLL(见 cheat-library/res/res.rc,其中定义了 IMGUI_FONT(Ruda-Bold.ttf)、SIGNATURES(signatures.json)、MAPTEYVATDATA(map_teyvat.json)等 RCDATA 资源)。

使用方法:注入启动三步走

按 README_zh-Hans.md 的官方说明,运行流程只有三步:

  1. 确认 CLibrary.dll 与 injector.exe 位于同一个文件夹内;
  2. 运行 injector.exe;
  3. 等待游戏登录界面出现后,按下 F1 键打开 Akebi GUI。

以下结合源码把这三步背后的真实流程展开。

第 1 步:DLL 与启动器同目录

injector.exe 运行时会以自身路径所在目录为基准定位 DLL。见 injector/src/main.cpp:

std::string filename = (argc == 2 ? argv[1] : "CLibrary.dll");
std::filesystem::path currentDllPath = std::filesystem::current_path() / filename;

即默认注入 CLibrary.dll,也支持通过命令行参数传入自定义 DLL 文件名。

第 2 步:injector.exe 的完整注入流程

运行 injector.exe 后,主程序依次执行以下步骤(源码对应 injector/src/main.cpp):

  1. 等待游戏关闭:调用 WaitForCloseProcess 轮询 GenshinImpact.exe(国际服)与 YuanShen.exe(国服)进程,确保没有残留的游戏实例后继续,随后再等待 1 秒卸载残留 DLL(WaitForCloseProcess 实现在 injector/src/util.cpp,通过 Toolhelp32 快照枚举进程);
  2. 读取配置:加载同目录下的 cfg.ini(ini.LoadFile("cfg.ini"));
  3. 提权并挂起启动游戏:OpenGenshinProcess 内部先打开当前进程令牌,再通过 explorer.exe 的进程句柄构造 PROCESS_THREAD_ATTRIBUTE_PARENT_PROCESS 属性列表,最后以 CreateProcessAsUserA + CREATE_SUSPENDED 挂起方式创建游戏进程(见 injector/src/main.cpp);
  4. 注入 DLL:在 Debug 构建下先将 DLL 复制到系统临时目录再注入(便于替换调试),Release 下直接注入原路径(见 injector/src/injector.cpp,其中 MANUAL_MAP 宏切换手动映射 ManualMapDLL 与常规 LoadLibraryDLL 两种注入方式,实现在 cheat-base/src/cheat-base/inject/);
  5. 恢复线程:注入完成后 Sleep(2000) 等待 DLL 初始化,再 ResumeThread(hThread) 让游戏正式运行。

第 3 步:DLL 内初始化与 F1 菜单

DLL 被注入后,cheat-library/src/framework/dllmain.cpp 在 DLL_PROCESS_ATTACH 时创建线程执行 Run。Run(见 cheat-library/src/user/main.cpp)的初始化顺序为:

  1. 设置资源模块句柄与当前工作目录;
  2. 初始化配置系统(读取 DLL 同目录下的 cfg.json,config::Initialize(...));
  3. 按配置启用文件日志 / 控制台日志;
  4. DebuggerBypassPre() 预处理调试器检测;
  5. 轮询等待 UserAssembly.dll(IL2CPP 核心程序集)加载;
  6. 等待约 15 秒等待游戏初始化完成(Debug 构建为 10 秒 + 附加延迟);
  7. DebuggerBypassPost() 后处理;
  8. init_il2cpp() 初始化 IL2CPP 运行时;
  9. cheat::Init() 注册全部功能模块并安装事件 Hook。

菜单按键本身来自全局设置(cheat-base/src/cheat-base/cheat/misc/Settings.cpp):NF(f_MenuKey, "Show Cheat Menu Key", "General", Hotkey(VK_F1)),默认即 F1。同时提供 Fast Exit 快捷键(默认 F12)用于快速退出进程(见 OnExitKeyPressed,且菜单打开时不会触发)。

配置文件体系

整套工具运行时会读写以下文件(均位于 injector.exe / DLL 所在目录):

文件 用途 生成/读取方
cfg.ini 注入器配置:游戏可执行文件路径(GenshinPath)、启动命令行(GenshinCommandLine),由 injector.exe 读写 injector/src/main.cpp
cfg.json 功能配置:所有功能字段、多配置档案(Profile) cheat-library/src/user/main.cpp、cheat-base/src/cheat-base/config/Config.h
imgui.ini ImGui 界面布局持久化 cheat-base/src/cheat-base/render/renderer.cpp
themes/ ImGui 主题 JSON 文件,可导入/导出/删除 cheat-base/src/cheat-base/cheat/misc/Settings.cpp
logs/ 文件日志输出目录(需在设置中开启 File Logging) cheat-library/src/user/main.cpp

关于 cfg.ini 中的 GenshinPath,源码注释给出了明确提示:若启动失败,可手动在 cfg.ini 中修正游戏可执行文件路径(injector/src/main.cpp)。启动器首次运行时会弹出文件选择对话框,选择 GenshinImpact.exe 或 YuanShen.exe 后将自动写入配置并保存。

cfg.json 背后的配置系统值得注意:每个功能字段通过宏 NF/NFS 注册(见 cheat-base/src/cheat-base/config/Config.h),支持多配置档案(Profile)、字段级序列化、以及"共享字段/非共享字段"的区分——后者是实现多账号独立配置的基础。账号与配置档案的绑定逻辑见 cheat-library/src/user/cheat/GenshinCM.cpp:检测到账号切换(events::AccountChangedEvent)时自动 config::ChangeProfile 切换到该账号对应的档案。

功能模块全景

README 的功能列表在源码中均有一一对应的实现模块。所有功能通过 cheat-library/src/user/cheat/cheat.cpp 中的 manager.AddFeatures({...}) 注册,并按 SetModuleOrder 指定的顺序在 GUI 中排列:Player → World → Teleport → ESP → Visuals → Hotkeys → Settings → About → Debug。

通用(General)

玩家(Player)

功能 实现文件 说明
上帝模式(God Mode) player/GodMode.h 无敌
攻击修改(Multi-Hit/Target/Animation) player/RapidFire.h 等 多次攻击/多目标/多动画
无冷却(技能/大招/冲刺/弓箭) player/NoCD.h Skill/Ultimate/Sprint/Bow
无限体力 player/InfiniteStamina.h Unlimited Stamina
自由飞行(No Clip) player/NoClip.h 穿墙飞行
其他 player/AutoRun.h、player/FallControl.h 自动奔跑、坠落控制

大世界(World)

README 中列出的大世界功能几乎全部可在 cheat-library/src/user/cheat/world/ 目录中找到对应实现,包括但不限于:

  • 仙灵自动归位(AutoSeelie)、立即打开队伍(OpenTeamImmediately);
  • 游戏全局加速(GameSpeed)、笨怪(DumbEnemies)、冻结敌人(FreezeEnemies);
  • 自动摧毁矿石/护盾/杂物/植物(AutoDestroy)、自动收集/开宝箱(AutoLoot)、拾取范围(VacuumLoot)、吸怪(MobVacuum);
  • 自动交谈(DialogSkip)、自动砍树(AutoTreeFarm)、自动烹饪(AutoCook)、自动钓鱼(AutoFish)、自动挑战(AutoChallenge);
  • 伪造时间(FakeTime)、杀戮光环(KillAura)、自定义天气(CustomWeather)。

以 GameSpeed 为例看实现细节(world/GameSpeed.cpp):默认快捷键 VK_CAPITAL(CapsLock),速度倍率默认 5.0、可调范围 0~20,按住快捷键期间通过 app::Time_set_timeScale 修改全局时间缩放,松开后恢复 1.0。其 GUI 描述特别警告:不要在开放世界使用,仅在菜单等界面中使用,非常危险——这是一个值得用户注意的风险提示。

传送(Teleport)

实体管理依赖 cheat/game/EntityManager.cpp:从 MoleMole_EntityManager 单例拉取全部 BaseEntity,过滤存活实体后封装为 Entity 列表供各功能遍历。

视觉效果(Visuals)

目录 cheat-library/src/user/cheat/visuals/ 覆盖 README 列出的全部视觉功能:

  • 透视 ESP:esp/ESP.cpp;
  • 互动地图:imap/InteractiveMap.cpp,地图数据(提瓦特/层岩巨渊/渊下宫/金苹果群岛)以 JSON 资源内嵌(见 cheat-library/res/res.rc),并配套大量 256x256 高清图标的 PNG 资源;
  • 元素视野常驻、除雾(NoFog)、FPS 解锁(FPSUnlock)、无限视距(CameraZoom)、宝箱探测(ShowChestIndicator)、隐藏 UI(HideUI)、游戏内浏览器(Browser,基于内嵌浏览器控件)、窥视模型不消失(EnablePeeking)、自由视角(FreeCamera)、派蒙跟随(PaimonFollow)、材质替换(TextureChanger)、动作替换(AnimationChanger);
  • 个人界面自定义(Profile Changer):可修改 UID / 昵称 / 冒险等级 / 世界等级 / 角色 / 名片,visuals/ProfileChanger.cpp。

调试(Debugging)

  • 实体管理器(Entities Manager)、位置信息(Position Info)、FPS 曲线图(FPS Graph);
  • 抓包工具:README 关联了独立项目 Akebi-PacketSniffer,同时仓库内置 cheat/misc/sniffer/PacketSniffer.h 模块供在游戏内进行网络包监听。

热键系统与 GUI 渲染

热键机制

热键是整套工具交互的核心。Hotkey 类(cheat-base/src/cheat-base/Hotkey.h、Hotkey.cpp)支持单个按键或组合键:

  • 监听窗口过程 WndProc 中的 WM_KEYUP/鼠标按键抬起消息(cheat-base/src/cheat-base/render/renderer.cpp),触发 events::KeyUpEvent;
  • Hotkey::IsPressed() 要求组合键全部按下才算触发,IsReleased() 用于边沿检测;
  • 支持键盘按键(A-Z、F1-F12、方向键、数字键等)与鼠标按键(LMB/RMB/MMB/X1/X2)混合绑定;
  • Hotkey::GetPressedHotkey() 用于录制模式——在 GUI 中点击热键框后按下新组合即可完成绑定。

输入锁定

当 GUI 菜单显示时,渲染层会通过输入锁(AddInputLocker/IsInputLocked)拦截键盘鼠标事件,避免菜单操作穿透到游戏(cheat-base/src/cheat-base/render/renderer.cpp)。

GUI 渲染栈

渲染层同时支持 DirectX 11 与 DirectX 12 后端(cheat-base/src/cheat-base/render/backend/dx11-hook.cpp、dx12-hook.cpp),在 SwapChain Present 前后注入 ImGui 帧;自定义字体从资源 Ruda-Bold.ttf 加载,并支持 8~64 号字体的动态缩放(renderer.cpp)。

设置面板详解

全局设置(Settings 模块)提供以下分组(cheat-base/src/cheat-base/cheat/misc/Settings.cpp):

  • General:菜单开关按键(F1,不可为空,忘记时可到配置文件查看)、全局热键启用开关;
  • Logging:控制台日志(默认开启,改动需重启生效)、文件日志(开启后日志写入 logs/ 目录,改动需重启生效);
  • Status / Info / FPS 窗口:各叠加窗口的显示与拖拽开关;
  • Notifications:右下角通知开关与通知间隔(1~10000ms);
  • Fast Exit:快速退出总开关与退出快捷键(默认 F12);
  • Interface Customization:字体大小(8~64)、主题保存/替换/选择/删除、ImGui 内置主题编辑器开关。

问题反馈规范(Bug Reporting)

README 对 bug 报告给出了明确步骤,照此提交能显著提高问题定位效率:

  1. 复现 bug,记录问题发生时"发生了什么"以及你的初步判断;
  2. 判断能否稳定复现:能复现则尽量清晰描述触发条件(开启了哪些功能、什么操作序列);不能复现则不建议提交(README 简中版原话调侃:那就别报告了,建议重启);
  3. 务必附上版本标识:复制你构建所用最新提交的 SHA 或版本号,例如 bd17a00ec388f3b93624280cde9e1c66e740edf9 或 Release 0.7——没有版本号的报告几乎无法定位;
  4. 在 Issues 页按模板提交(README 要求使用英文,且提供了现成的 Issue 模板)。

贡献方式(Contributing)

README 提供的协作流程是标准的 GitHub 工作流,同时面向"增加功能"与"提建议"两种场景:

增加一个功能:

  1. Fork 本项目;
  2. 创建功能分支:git checkout -b feature/AmazingFeature;
  3. 提交更改:git commit -m 'Add some AmazingFeature';
  4. 推送到分支:git push origin feature/AmazingFeature;
  5. 打开 Pull Request。

提建议: 在 Issues 中用英文新建 issue,标题写清建议,描述部分尽量详细具体,让维护者能够理解"想要什么、希望怎么实现"。结合上文提到的 DMCA 公告,参与贡献同时也是获取最新私有源码的途径之一。

风险与合规提示

基于仓库文档与源码可确认以下事实,使用者应自行评估风险:

  • 项目收到过来自 HoYoverse 的 DMCA 下架通知,最新源码已转为私有(见 README.md 公告);
  • 保护绕过功能会关闭 mhyprot2 设备句柄并 Hook 数据上报与崩溃报告函数(见 ProtectionBypass.cpp),对抗性质明显,账号与设备风险均由使用者自负;
  • 部分功能自带危险警告,例如 GameSpeed 明确提示"不要在开放世界使用"(GameSpeed.cpp);
  • 本文仅介绍项目的查看、获取、运行与配置方式,不构成对任何违规行为的鼓励。

总结

Akebi-GC 是一个结构清晰的注入式辅助框架:injector.exe 负责以挂起方式拉起游戏进程并注入 CLibrary.dll,DLL 内通过 IL2CPP 初始化、事件 Hook 与 ImGui 渲染构建出完整的六大类功能体系(通用/玩家/世界/传送/视觉/调试)。其配置系统(cfg.ini + cfg.json + 多 Profile)与热键系统(组合键录制、集中管理)设计成熟,README 提供的三步启动流程(同目录放置 DLL → 运行 injector.exe → F1 打开菜单)与实际源码执行路径完全吻合。对想深入理解 Windows DLL 注入、IL2CPP 游戏逆向与 ImGui 覆盖层的开发者而言,公开源码中的 cheat-base 与 cheat-library 目录是很有参考价值的研读材料。

登录后查看全文
Akebi-GC