Genshin Impact Assistant：基于图像识别的原神自动化辅助工具

Genshin Impact Assistant（简称GIA）是一款基于图像识别和模拟按键技术的开源自动化辅助工具，旨在为《原神》玩家提供日常任务处理、战斗辅助及资源采集等自动化功能。该工具通过非侵入式技术实现游戏操作自动化，帮助玩家减少重复操作负担，提升游戏体验。

安全与合规说明

本工具采用纯图像识别技术，不修改游戏内存或数据包，不读取游戏内部数据，完全通过模拟用户手动操作实现功能。使用前请确保符合游戏用户协议，仅用于个人学习交流，禁止用于商业代练或其他违规行为。

技术实现原理

Genshin Impact Assistant基于以下核心技术构建：

• 图像识别模块：采用YOLOX模型进行游戏界面元素检测，通过PPOCR实现文本信息提取
• 路径规划：使用A*算法实现角色移动路径优化
• 模拟输入：通过ADB协议或Windows API实现跨平台的鼠标键盘模拟

核心技术模块分布在项目的以下目录：

• 图像识别实现：source/api/
• 路径规划实现：source/astar/
• 设备控制实现：source/device/

核心功能解析

执行自动战斗任务

提供基于预设策略的自动战斗功能，支持角色技能循环、目标锁定及战斗状态判断。系统会根据敌方位置和血量自动调整攻击策略，适用于深渊、世界BOSS等场景。

功能实现：source/combat/

完成秘境挑战自动化

支持主流秘境的全自动挑战流程，包括传送至秘境入口、调整队伍配置、执行战斗策略及领取奖励等完整流程，减少重复刷本操作。

功能实现：source/task/domain/

处理每日委托任务

提供半自动委托处理机制，支持大部分常见委托类型的自动完成，包括对话选择、目标追踪和任务提交等环节。

功能实现：source/commission/

管理资源采集任务

基于Mission系统实现地图资源的自动采集，支持矿石、植物等资源点的精准定位与最优路径规划，提升资源收集效率。

功能实现：source/mission/

配置运行环境

系统要求

• 操作系统：Windows 10/11（64位）
• Python版本：3.7.6
• 游戏分辨率：推荐1920×1080窗口模式

安装步骤

1. 克隆项目仓库

   git clone https://gitcode.com/GitHub_Trending/ge/genshin_impact_assistant
   

2. 安装依赖包

   cd genshin_impact_assistant
   pip install -r requirements.txt
   

3. 启动程序

   python genshin_assistant.py
   

使用指南

基础配置

首次运行程序后，需通过配置界面完成以下设置：

• 游戏窗口位置校准
• 图像识别精度调整
• 角色技能释放策略配置
• 快捷键映射设置

执行自动化任务

1. 在主界面选择任务类型（秘境挑战/每日委托/资源采集）
2. 根据任务要求配置具体参数
3. 点击"开始任务"按钮启动自动化流程
4. 程序运行期间保持游戏窗口在前台

高级功能

• 自定义任务模板：通过config/json_template/目录下的配置文件定义个性化任务流程
• 多语言支持：通过assets/LangData/目录下的语言文件切换界面语言
• 战斗策略编辑：在config/tactic/目录下配置自定义战斗逻辑

模块架构说明

项目核心代码组织如下：

• source/task/：任务管理核心模块，包含各类自动化任务实现
• source/manager/：资源管理模块，处理图像、文本等资源加载
• source/interaction/：用户交互模块，处理输入输出和界面交互
• source/config/：配置系统，管理应用各项参数设置

注意事项

1. 使用前请确保游戏客户端为官方最新版本
2. 不同硬件配置可能需要调整识别参数以获得最佳效果
3. 网络环境不稳定可能影响部分在线功能
4. 长时间连续使用建议设置任务间隔，避免账号风险

本项目开源免费，所有功能均在GPL许可下发布。用户可根据自身需求修改和扩展功能，但需遵守开源协议和游戏用户协议。