如何快速跑通原神小助手 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 路径,填写后才能用"启动游戏"功能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秘境名与层数,如"山脊守望 / 不移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),仅供参考
如何快速跑通原神小助手 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 路径,填写后才能用"启动游戏"功能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秘境名与层数,如"山脊守望 / 不移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),仅供参考