原神小助手教程：自动战斗与领日常的新手完整指南

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

原神小助手（Genshin Impact Assistant）是一款基于图像识别与模拟按键的开源原神自动辅助工具，能帮你完成自动战斗、刷秘境、采集大世界材料、跑每日委托和领取日常奖励。这篇原神小助手教程带你从装环境到第一次跑起任务，全程约十分钟。

先核对运行环境

在动手安装原神小助手之前，先确认三件事：

• 系统：Windows 桌面环境。项目依赖pywin32、keyboard等库，截屏与模拟按键均按 PC 版原神设计；
• Python：建议 3.7 及以上，项目徽章标注的是 3.7.6；
• 显卡：非必须，识别模型支持 CPU 推理，配置项里也有DeviceTorch可切换。

依赖清单在 requirements.txt 里，核心是torch、opencv-python、PyAutoGUI、pywebio、keyboard这些包，一次装齐即可。

🚀 三步完成安装

第一步，克隆仓库到本地：

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

第二步，安装依赖。两种方式任选：

pip install -r requirements.txt

或者用项目自带的快捷安装（走清华源，速度更快）：

python setup.py install

第三步，启动程序：

python genshin_assistant.py

启动命令一览与第一次运行

入口文件 genshin_assistant.py 做了三件事：拉起本地 Web 服务（http://localhost:22268/）、弹出一个 1600x900 的窗口、启动按键与任务监听。日志输出到 source/listening.py。

第一次运行的建议流程：

1. 先把 PC 版原神启动并进入游戏；
2. 在弹出的界面里进入对应功能页，按提示配置队伍或采集目标；
3. 回到游戏主界面，按默认热键[（Keymap_StartStop）唤出游戏内辅助窗口；
4. 新手建议先选一个小规模采集任务跑通全流程，再尝试自动战斗或刷秘境。

📂 目录导读：只认这几处

仓库文件不少，但你日常打交道的主要是这些：

• source/task/：全部自动任务的实现地，刷秘境、领奖励、委托、地脉衍出都在这里；
• source/mission/：任务（Mission）执行框架与模板，missions/ 里存放可执行的具体任务文件；
• source/combat/：自动战斗核心，含队伍切换、瞄准与技能触发；
• source/map/ 与 source/ocr/：地图检测、秘境识别与文字识别能力；
• assets/：图像模板、角色数据与推理模型文件；
• config/：运行配置（下面细讲）。

⚙️ 配置文件速查

程序首次启动时，会读取 config/json_template/ 下的模板文件，合并生成 config/settings/ 里的 JSON 配置。常用项如下：

配置示例（General.json片段）：

{ "GenshinEXEPath": "D:\\Genshin\\YuanShen.exe", "CaptureMode": "fast", "CorrDegree": 0.95 }

⚠️ 注意事项

• 别手改 settings 里的 JSON。配置类被设计为只读，且每次启动会用模板重新合并，手动改动可能被覆盖。所有设置都建议通过界面页修改。
• 账号风险自负。项目基于 GPLv3 开源、免费，仅供学习交流。用辅助代练产生的任何后果与项目无关。

项目仍在持续更新，功能细节与版本变化请以最新 README 为准。

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