如何快速跑通原神小助手 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它做了三件事（逻辑很直观，可以对照源码看）：
- 起一个后台线程，在
localhost:22268端口用 pywebio 启动 Web 服务； - 用 pywebview 拉起一个 Qt 窗口加载这个页面，也就是你看到的操作界面；
- 启动 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 路径，填写后才能用"启动游戏"功能 |
Lang | zh_CN | 界面语言，可选en_US |
CaptureMode | fast | 截屏模式，fast速度最快 |
InteractionMode | Desktop | 交互模式（键鼠模拟 / 模拟器 ADB 等） |
DevicePaddle | cpu | PaddleOCR 推理设备，目前仅 cpu |
DeviceTorch | auto | YOLOX 等 torch 模型推理设备，可选cpu/gpu/auto |
CorrDegree | 0.95 | 图像匹配总置信度，越低越宽松，误识别会变多 |
DEBUG | false | 调试开关，开启会跳过模型校验并输出 DEBUG 日志 |
Collector（采集）
| 配置项 | 含义 |
|---|---|
CollectionName | 目标名称，如"史莱姆" |
CollectionType | ENEMY（打怪）或COLLECTION（采集物） |
CollectionMode | Auto全自动 /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指定录制目标，普通使用不动它。
五、高频疑问与避坑
- 界面白屏或启动闪退：先确认是 Windows + Python 3.7.x 环境且依赖装全；再确认 22268 端口未被占用（Web 服务固定使用它）。
- 改了
GenshinEXEPath仍无法启动游戏：路径要指向实际可执行文件，且游戏需以窗口/无边框模式运行，程序靠截屏+图像识别工作。 - 想加新配置项？不要只改
settings/里的 JSON，模板在config/json_template/，程序每次启动会拿模板合并配置，缺的键会以默认值补回。 - 误识别太多/太敏感：调
General的CorrDegree，默认 0.95 偏严格；放宽后速度提升但可能点错 UI。 - 合规提示：本项目基于图像识别与模拟键鼠，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），仅供参考
