JiYuTrainer新手入门指南：从安装到配置的全方位教程

一、项目架构探秘：如何理解JiYuTrainer的组成部分？

什么是JiYuTrainer的核心目录结构？

JiYuTrainer采用模块化设计，主要包含以下关键目录，每个目录承担不同功能：

目录路径	功能说明
JiYuTrainer/	主程序模块，包含核心逻辑实现，如进程管理、网络处理等
JiYuTrainerDriver/	驱动模块，负责与系统内核交互，提供底层硬件控制能力
JiYuTrainerHooks/	钩子模块，通过API拦截技术实现极域功能的修改与控制
JiYuTrainerUI/	用户界面模块，提供可视化操作窗口和交互逻辑
JiYuTrainerUpdater/	自动更新模块，负责程序版本检测与升级
Release/	发布目录，包含编译完成的可执行文件和依赖资源

💡 实用提示：新手无需深入每个目录的代码细节，重点关注JiYuTrainerUI（界面）和Release（可执行文件）即可快速上手。

模块之间如何协同工作？

各模块通过明确的职责分工实现整体功能：

1. 用户交互：JiYuTrainerUI接收用户操作（如点击"解除控制"按钮）
2. 核心处理：主程序模块JiYuTrainer调用Hooks模块修改极域行为
3. 底层支持：Driver模块提供系统级操作能力，如驱动卸载
4. 自我维护：Updater模块定期检查更新确保功能有效性

数据流向：UI输入 → 主程序处理 → Hooks注入 → Driver执行 → 结果反馈

💡 实用提示：如果界面操作无响应，可优先检查Release目录下的JiYuTrainer.exe是否正常运行。

二、开发环境搭建：如何编译和运行项目？

编译项目需要哪些准备工作？

在开始编译前，请确保你的开发环境满足以下要求：

• 操作系统：Windows 7/8/10（32位或64位）
• 开发工具：Visual Studio 2019及以上（推荐社区版，免费）
• 额外组件：
  • 安装Visual Studio时勾选"桌面开发使用C++"
  • WDK8及以上（仅驱动模块编译需要，普通用户可忽略）

💡 实用提示：学生可通过学校邮箱申请Visual Studio教育版，获得完整功能支持。

如何一步步编译出可执行文件？

编译步骤简单直观，按以下流程操作：

1. 获取代码：通过命令行克隆仓库

   git clone https://gitcode.com/gh_mirrors/ji/JiYuTrainer
   

2. 打开解决方案：双击项目根目录下的JiYuTrainer.sln文件
3. 配置编译选项：
   • 在Visual Studio工具栏选择"Release"配置
   • 平台选择"x86"（兼容大多数教学环境32位系统）
4. 开始编译：按下F7键或点击菜单"生成→生成解决方案"
5. 获取成果：编译完成后，可执行文件位于Release/JiYuTrainer.exe

💡 实用提示：编译时若出现"缺少依赖"错误，检查项目中的第三方库（如curl、mhook）是否已包含在代码中（项目已自带这些库，无需额外下载）。

如何直接运行现成的程序？

对于非开发人员，推荐使用已编译好的可执行文件：

1. 进入项目的Release目录
2. 找到JiYuTrainer.exe双击运行
3. 首次运行可能出现杀毒软件警告，选择"允许运行"（本软件无恶意代码）

运行界面示例：

💡 实用提示：若机房限制U盘使用，可通过管理员CMD执行以下命令解除限制：

sc stop TDFileFilter && sc delete TDFileFilter

三、配置与故障排除：如何自定义和解决常见问题？

有哪些常用配置项可以调整？

在JiYuTrainerUI模块中，通过修改配置文件可自定义程序行为：

1. 窗口位置记忆：设置RememberWindowPos=true保存上次关闭时的界面位置
2. 自动启动：添加AutoStart=1实现开机自动运行（需管理员权限）
3. 静默模式：设置SilentMode=true隐藏运行时的控制台窗口

配置文件路径：JiYuTrainerUI/ConfigWindow.cpp（开发视角）或通过界面"设置"按钮（用户视角）修改。

💡 实用提示：修改配置前建议备份原文件，避免错误配置导致程序无法启动。

遇到问题如何排查和解决？

常见故障及解决方案：

问题现象	可能原因	解决方法
界面无响应	极域进程未正常注入	重启程序并确保极域StudentMain.exe正在运行
驱动卸载失败	权限不足	右键程序选择"以管理员身份运行"
编译报错"缺少WDK"	未安装驱动开发工具	跳过驱动模块编译，直接使用Release目录下的现成文件
杀毒软件误报	钩子模块被识别为风险程序	添加程序目录到杀毒软件白名单

💡 实用提示：若遇到复杂问题，可查看程序日志文件（Release/logger.txt）获取详细错误信息。

如何确保程序持续有效？

极域电子教室可能通过更新对抗破解，保持程序有效性的方法：

1. 启用自动更新：在界面勾选"自动检查更新"
2. 关注版本公告：README.md会及时更新兼容信息
3. 手动替换文件：从项目Release目录下载最新的JiYuTrainer.exe覆盖旧文件

💡 实用提示：学校机房通常限制网络访问，建议定期用U盘拷贝最新版本到机房更新。

结语

通过本指南，你已经了解JiYuTrainer的基本架构、编译方法和配置技巧。记住，软件开发的核心是解决问题，这个项目的初衷就是帮助学生在机房环境中获得合理的操作自由。如果遇到功能需求或发现BUG，欢迎参与项目改进（项目已开源，详见LICENSE文件）。

最后提醒：合理使用本软件，平衡学习与自主操作，才是最佳实践哦！ 📚💻