原神小助手 genshin_impact_assistant 實戰(zhàn)解析圖像識別驅(qū)動的自動戰(zhàn)斗、刷秘境與日常全流程【免費下載鏈接】genshin_impact_assistant原神小助手 Genshin Assistant (CN/EN) | 自動戰(zhàn)斗,秘境,領日常,半自動委托項目地址: https://gitcode.com/GitHub_Trending/ge/genshin_impact_assistantgenshin_impact_assistant原神小助手用圖像識別加模擬按鍵把原神里重復的自動戰(zhàn)斗、刷秘境、領日常、大世界采集打包成一鍵任務讓你只管選角色和培養(yǎng)。從一次手滑斷掉的本說起你肯定經(jīng)歷過掛著自動秘境刷樹脂結(jié)果切出去看了條消息回來發(fā)現(xiàn)角色卡在墻角戰(zhàn)斗早就停了?；蛘吣闶謩狱c單人挑戰(zhàn)手指一抖點錯了本一管樹脂白丟。這類任務本身不復雜但重復、要盯著屏幕、容錯全靠手速——人最容易在第三、第四個循環(huán)時走神。genshin_impact_assistant 的思路很簡單把看屏幕—做判斷—按按鍵這三件事全交給程序人只在開始前配置一次。它不讀游戲內(nèi)存只靠截下來的畫面判斷當前到了哪一步再用模擬鍵鼠去操作全程走的是玩家能用的普通輸入通道。項目全貌一條截圖→識別→按鍵的流水線用一句話概括它的數(shù)據(jù)流輸入是游戲窗口截圖加你在配置里填的目標刷哪個秘境、采哪個材料、跑幾次處理是先用模板匹配和本地 OCR 認出當前 UI 狀態(tài)再交給狀態(tài)機決定下一步該做什么輸出是一連串模擬的鼠標點擊、鍵盤動作。上圖示意一張游戲截圖如何被切分識別并轉(zhuǎn)化為操作序列。整個系統(tǒng)沒有中央大腦去硬編碼每一步而是拆成兩層底層是 source/interaction/interaction_core.py 里的itt交互對象負責截圖和按鍵上層是各種 TaskDomainTask、MissionTask、ClaimRewardTask等每個任務內(nèi)部用狀態(tài)機 子線程把流程串起來。下面拆三個最影響體驗的機制。核心機制拆解機制一不聯(lián)網(wǎng)靠模板匹配加本地 OCR看懂屏幕解決什么問題程序得知道現(xiàn)在這個按鈕點沒點亮這是哪個秘境名稱但原神沒有開放接口只能從像素里找答案。怎么做的它對按鈕、圖標用模板匹配把一張小圖標在截屏里找最相似的位置對動態(tài)文字用本地 OCR。關(guān)鍵點是 OCR 模型按游戲語言懶加載——你開的是中文服就只加載中文模型省內(nèi)存# source/ocr/models.py按語言懶加載 OCR 模型 OCR_MODEL OcrModel() LOCAL_OCR_MODEL OCR_MODEL.get_by_lang(GLOBAL_LANG) cached_property def zhs(self): return TextSystem(zhs) # 首次用到才加載截圖也分通道處理因為原神 UI 有半透明效果直接拿 3 通道圖匹配容易誤判# source/interaction/interaction_core.py四通道截圖轉(zhuǎn)單通道 ret self.capture_obj.capture(recapture_limitrecapture_limit) if posi is not None: ret crop(ret, posi) # 只截目標小區(qū)域加速 if jpgmode 1: ret self.png2jpg(ret, channelbg) # 摳背景 elif jpgmode 2: ret self.png2jpg(ret, channelui) # 摳 UI對開發(fā)者的啟示把找小圖標限制在小裁剪區(qū)域內(nèi)再用通道分離處理透明 UI是這類圖像自動化項目提速和降誤判的兩個通用手段。機制二任務用狀態(tài)機編排異常自帶可能原因解決什么問題長流程一跑就是幾百步中途任何一步?jīng)]識別到就會卡死。你希望能快速知道卡在哪、為什么而不是面對一坨 traceback。怎么做的每個異常都繼承GIABaseException帶一個POSSIBLE_REASONS列表任務管理器捕獲異常后逐條打印可能原因并在出錯瞬間截一張圖存盤方便復盤# source/task/task_manager.py任務異常統(tǒng)一出口 def task_excepthook(self, args): exception_instance args.exc_value logger.exception(exception_instance) if isinstance(exception_instance, GIABaseException): if args.exc_value.stop_task_flag: self.stop_tasklist() for pr in exception_instance.POSSIBLE_REASONS: logger.error(fPossible Reason: {pr}) if isinstance(exception_instance, SnapshotException): exception_instance.save_snapshot(itt.capture(jpgmodeFOUR_CHANNELS))同時按鍵前有一個焦點守衛(wèi)發(fā)現(xiàn)當前活動窗口不是原神就先暫停避免把操作打到別的程序上# source/interaction/interaction_core.py操作前確認窗口焦點 winname get_active_window_process_name() if winname not in PROCESS_NAME: while get_active_window_process_name() not in PROCESS_NAME: logger.info(當前窗口焦點不是原神操作暫停) time.sleep(5 - (time.time() % 5)) return func(*args, **kwargs)對開發(fā)者的啟示給每個可失敗步驟配人話原因并在出錯時自動留現(xiàn)場截圖比裸拋異常省掉大量復現(xiàn)半天的時間。大地圖尋路則是把采集點、傳送點建成一張有向圖用 A* 求路徑見 source/map/tianli_navigator.py距離用經(jīng)緯度差近似讓自動跑到材料點不用你手動拖地圖。上手步驟與常見報錯處理先說環(huán)境它面向 Windows依賴pyautogui、pydirectinput、OpenCV、torch等推薦 Python 3.7.6直接pip install -r requirements.txt裝全依賴。典型場景刷秘境在秘境頁填本名、層數(shù)、次數(shù)選隊伍啟動DomainTask它會自己跑過去、進本、打、出本、繼續(xù)下一輪。大世界采集在采集設置里框出材料點MissionTask沿路采集、打怪、撿掉落。領日常跑一遍委托再領獎勵對應CommissionTaskClaimRewardTask。關(guān)鍵配置窗口保持 1920x1080有邊框/無邊框要在設置里勾對游戲語言必須和 OCR 模型對應中文服配中文否則識別不到按鈕文字鍵位按你習慣在keymap里改。常見報錯及思路日志刷操作暫停窗口焦點丟了把原神拉回前臺即恢復。截圖 shape 報錯分辨率或窗口模式?jīng)]對上回到 1080p 全屏。找不到秘境名稱放棄選擇多半是 OCR 語言不匹配或本名有全角冒號/羅馬數(shù)字程序會先做文本歸一化再匹配。任務中途停翻日志里的Possible Reason再對照Logs目錄里的現(xiàn)場截圖定位卡點。后續(xù)能做什么它把任務抽象成了可復用的 TaskTemplate社區(qū)還單獨維護了一個任務倉庫用mission_template就能描述一條新的采集/探索路線你錄好路徑就能生成可分享的任務文件。想深入的話從 source/funclib/ 里的combat_lib、collector_lib入手把新角色或新材料接進現(xiàn)有狀態(tài)機就是最快的上手路徑。從自己盯著屏幕到配置一次然后去干別的genshin_impact_assistant 證明了一件事只要把截圖識別和狀態(tài)編排做扎實重復到讓人抓狂的游戲日常就能交給程序去跑?！久赓M下載鏈接】genshin_impact_assistant原神小助手 Genshin Assistant (CN/EN) | 自動戰(zhàn)斗,秘境,領日常,半自動委托項目地址: https://gitcode.com/GitHub_Trending/ge/genshin_impact_assistant創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考