如何快速跑通原神小助手 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 设置页中修改等效于改 JSONGeneral通用设置配置项默认值含义GenshinEXEPath空原神启动器/游戏 exe 路径填写后才能用启动游戏功能Langzh_CN界面语言可选en_USCaptureModefast截屏模式fast速度最快InteractionModeDesktop交互模式键鼠模拟 / 模拟器 ADB 等DevicePaddlecpuPaddleOCR 推理设备目前仅 cpuDeviceTorchautoYOLOX 等 torch 模型推理设备可选cpu/gpu/autoCorrDegree0.95图像匹配总置信度越低越宽松误识别会变多DEBUGfalse调试开关开启会跳过模型校验并输出 DEBUG 日志Collector采集配置项含义CollectionName目标名称如史莱姆CollectionTypeENEMY打怪或COLLECTION采集物CollectionModeAuto全自动 /ManualAssi手动辅助PickupBlacklist拾取黑名单过滤不想要的掉落Domain秘境配置项含义DomainName/DomainStageName秘境名与层数如山脊守望 / 不移IIChallengeTimes挑战次数Resin树脂消耗档位20或40用于估算体力FastMove赶路时是否开启快速移动Combat战斗队伍只有两个入口字段TeamFile指向 config/tactic/ 下的队伍文件AdaptiveTeamSetup控制是否自动适配阵容。队伍文件如 team_example_1.json里为每个角色定义name角色名如 Yoimiya、positionMain/Shield/Recovery 等定位、Ecd/Qcd系列技能冷却参数、priority出场优先级和trigger触发时机。想换阵容照着模板复制一份改角色名和 CD 即可结构定义参考 config/json_doc/Combat.yaml。其他keymap.json的StartStop全局快捷键默认[按下开始/停止当前任务见 source/listening.py 的add_hotkey。LeyLineOutcrop.jsonBlossomTypeWealth/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），仅供参考