如何快速跑通原神小助手 Genshin Impact Assistant:从克隆到自动刷秘境的完整新手指南

如何快速跑通原神小助手 Genshin Impact Assistant:从克隆到自动刷秘境的完整新手指南

【免费下载链接】genshin_impact_assistant原神小助手 Genshin Assistant (CN/EN) | 自动战斗,秘境,领日常,半自动委托项目地址: https://gitcode.com/GitHub_Trending/ge/genshin_impact_assistant

原神小助手(genshin_impact_assistant)是一款基于图像识别与模拟按键的多功能原神自动辅助开源工具,能帮你完成自动战斗、自动刷秘境、大世界材料采集、日常委托和领取日常奖励等重复操作——程序替你打怪跑图,你只负责选队伍和养成角色。本文带你从零环境到跑通界面,并逐条讲清关键配置项。

一、它到底能替你做哪些事

README 中列出的六大核心能力:

功能说明对应代码位置
战斗辅助按你预设的队伍与技能 CD 自动放招、切人、走位source/combat/
自动秘境读条进本、挑战 N 次、完成后返回(支持 20/40 树脂)source/task/domain/
自动采集基于任务路径在大世界刷材料、矿石、敌人掉落source/task/auto_collector/
每日委托自动完成部分日常委托并交付source/commission/
领取日常奖励一键领取原石等每日奖励source/task/claim_reward/
地脉衍出自动领取地脉花收益(财富/启示)source/task/ley_line_outcrop/

另外还有一套"半自动"体系:source/ingame_assist/ 提供剧情跳过、source/pickup/ 提供自动拾取等轻量功能,通过快捷键随时开关,不需要跑完整任务。

二、三步跑起来

第 1 步:克隆仓库

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

第 2 步:准备环境与依赖

该工具依赖 pywin32、pydirectinput、pypiwin32 等 Windows 专属库,所以必须在 Windows 上运行。README 标注的版本为 Python 3.7.6,建议使用与之一致的解释器(可用 conda 建虚拟环境)。然后在仓库根目录安装依赖:

pip install -r requirements.txt

依赖里包含 OpenCV、PaddleOCR 相关推理库(giaocr、giayolo)、YOLOX 检测、PyQt5/pywebview 界面组件,体积较大,首次安装耐心等待即可。

第 3 步:启动入口文件

仓库根目录的 genshin_assistant.py 是主入口,运行:

python genshin_assistant.py

它做了三件事(逻辑很直观,可以对照源码看):

  1. 起一个后台线程,在localhost:22268端口用 pywebio 启动 Web 服务;
  2. 用 pywebview 拉起一个 Qt 窗口加载这个页面,也就是你看到的操作界面;
  3. 启动 source/listening.py 的监听循环,负责接收快捷键指令、调度任务管理器。

启动后界面上可切换主页、设置、战斗设置、任务页等(页面注册逻辑在 source/webio/webio.py 的main函数里)。开发调试时,仓库自带的 console.bat 是一个内置 git/python/pip 的调试控制台,依赖toolkit目录,普通用户用不到。

三、目录职责对照表

目录职责
genshin_assistant.py程序入口:Web 服务 + Qt 窗口 + 监听线程
config/所有配置:模板、实际配置、队伍文件、采集路径
assets/图像识别模板库:Yolox/PPOCR 模型、角色数据、域名表、采集黑名单
source/核心源码:webio(界面)、task(任务调度)、combat(战斗)、funclib(功能库)、map(地图定位)、device(设备控制)
source/config/配置加载与生成逻辑(GIAconfig单例)
yolox/YOLOX 目标检测模型完整实现(训练+推理)
yoloxtools/检测推理封装
missions/存放任务路径文件(Mission 数据)
dev_tools/、dev_assets/tlpp/开发者工具与路径规划数据
exps/YOLOX 各规模模型的实验配置
tests/测试脚本
translation/、py-gettext-markdown/多语言翻译资源与工具

四、配置项逐个看

很多新手找不到"配置文件",是因为config/settings/里只有一个占位文件。真实机制是:首次启动时,程序会把 config/json_template/ 下的每个*.jsontemplate模板复制到config/settings/生成同名.json(逻辑见 source/config/config.py 的merge方法),之后你改的都是这些.json。config/json_doc/ 下的 YAML 只是设置界面的表单定义,无需手改。

以下是各配置文件的常用项(均可在启动后的 Web 设置页中修改,等效于改 JSON):

General(通用设置)

配置项默认值含义
GenshinEXEPath空原神启动器/游戏 exe 路径,填写后才能用"启动游戏"功能
Langzh_CN界面语言,可选en_US
CaptureModefast截屏模式,fast速度最快
InteractionModeDesktop交互模式(键鼠模拟 / 模拟器 ADB 等)
DevicePaddlecpuPaddleOCR 推理设备,目前仅 cpu
DeviceTorchautoYOLOX 等 torch 模型推理设备,可选cpu/gpu/auto
CorrDegree0.95图像匹配总置信度,越低越宽松,误识别会变多
DEBUGfalse调试开关,开启会跳过模型校验并输出 DEBUG 日志

Collector(采集)

配置项含义
CollectionName目标名称,如"史莱姆"
CollectionTypeENEMY(打怪)或COLLECTION(采集物)
CollectionModeAuto全自动 /ManualAssi手动辅助
PickupBlacklist拾取黑名单,过滤不想要的掉落

Domain(秘境)

配置项含义
DomainName/DomainStageName秘境名与层数,如"山脊守望 / 不移II"
ChallengeTimes挑战次数
Resin树脂消耗档位,20或40,用于估算体力
FastMove赶路时是否开启快速移动

Combat(战斗队伍)

只有两个入口字段:TeamFile指向 config/tactic/ 下的队伍文件,AdaptiveTeamSetup控制是否自动适配阵容。队伍文件(如 team_example_1.json)里为每个角色定义name(角色名,如 Yoimiya)、position(Main/Shield/Recovery 等定位)、Ecd/Qcd系列技能冷却参数、priority出场优先级和trigger触发时机。想换阵容,照着模板复制一份改角色名和 CD 即可,结构定义参考 config/json_doc/Combat.yaml。

其他

  • keymap.json的StartStop:全局快捷键,默认[,按下开始/停止当前任务(见 source/listening.py 的add_hotkey)。
  • LeyLineOutcrop.json:BlossomType(Wealth/Revelation)与CollectionTimes领取次数。
  • Dev.json:路径录制相关,RecordPath_CollectionType/Name指定录制目标,普通使用不动它。

五、高频疑问与避坑

  1. 界面白屏或启动闪退:先确认是 Windows + Python 3.7.x 环境且依赖装全;再确认 22268 端口未被占用(Web 服务固定使用它)。
  2. 改了GenshinEXEPath仍无法启动游戏:路径要指向实际可执行文件,且游戏需以窗口/无边框模式运行,程序靠截屏+图像识别工作。
  3. 想加新配置项?不要只改settings/里的 JSON,模板在config/json_template/,程序每次启动会拿模板合并配置,缺的键会以默认值补回。
  4. 误识别太多/太敏感:调General的CorrDegree,默认 0.95 偏严格;放宽后速度提升但可能点错 UI。
  5. 合规提示:本项目基于图像识别与模拟键鼠,GPL v3.0 开源、免费仅供学习交流,请自行评估账号风险。

下一步建议:先用默认配置跑通"领取日常奖励"这类短任务熟悉全流程,再到战斗设置页基于team_example_1.json复制一份属于自己主力队的队伍文件,最后尝试 20 树脂的自动秘境。遇到识别失败,可结合 source/manager/ 下的图像/文字管理器查看具体哪一步的模板没匹配上。

【免费下载链接】genshin_impact_assistant原神小助手 Genshin Assistant (CN/EN) | 自动战斗,秘境,领日常,半自动委托项目地址: https://gitcode.com/GitHub_Trending/ge/genshin_impact_assistant

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

认识vgg16_bn.tv_in1k:经典VGG16图像分类预训练模型完整介绍

认识vgg16_bn.tv_in1k:经典VGG16图像分类预训练模型完整介绍

【免费下载链接】vgg16_bn.tv_in1k 项目地址: https://ai.gitcode.com/hf_mirrors/timm/vgg16_bn.tv_in1k 点击查看 免费下载 vgg16_bn.tv_in1k 是 timm 库提供的经典 VGG16 图像分类预训练模型,采用带批归一化(BatchNorm)的 VGG…

2026/11/17 5:37:23 阅读更多 →
知识工作者必备:打造高效插件化知识管理全流程工作流

知识工作者必备:打造高效插件化知识管理全流程工作流

每次提到知识工作者,我脑子里冒出来的画面就是:桌面上开着十几个标签页,笔记软件里堆了几百条待整理的剪藏,写一篇文章要在三个工具之间来回倒腾,最后输出的时候格式又乱成一团。这不是效率问题,这是工具链…

2026/11/16 23:27:36 阅读更多 →
DeepSeek提示词工程全攻略:从信息密度到五要素模板,榨干AI潜力

DeepSeek提示词工程全攻略:从信息密度到五要素模板,榨干AI潜力

同样用DeepSeek,为什么有人得到神回复、有人只得到废话?最近后台收到好几位读者的私信,问的几乎是同一个问题:"我一直听说DeepSeek很强,为什么我让它写个计划书,它给我输出的东西又空又泛,…

2026/11/14 11:40:03 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/16 8:22:12 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/16 6:41:34 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/16 8:22:12 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/16 8:22:12 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/16 7:30:18 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/16 8:22:12 阅读更多 →

日新闻

周新闻

月新闻