常見問題與反饋

識別或點選不穩定

依次檢查：

解析度是否為 16:9 且不低於 1600×900（900P）。
是否使用預設亮度，並關閉顯示卡濾鏡、銳化和畫面懸浮層。
遊戲視窗是否未最小化，螢幕是否未鎖定或熄滅。
執行期間滑鼠或手動輸入是否干擾了前臺遊戲視窗。
遊戲幀率是否穩定，且遊戲和程式許可權是否一致。

安裝或啟動失敗

確認使用最新版安裝包，並將安裝目錄加入安全軟體信任列表。
避免在 Program Files 或包含中文字元的目錄執行程式。
原始碼執行時重新執行 uv sync，安裝與當前專案匹配的依賴。
以管理員許可權執行終端、IDE 和程式。

官方啟動器要求與渠道啟動方式

國服與 GRYPHLINK 國際服共用啟動流程：從遊戲目錄的 Endfield_Data/app.info 讀取 Hypergryph / Gryphline 公司標識，查詢對應渠道的官方啟動器，並要求 Windows Authenticode 有效、證書指紋在兩服共用的官方白名單中，並核對所嘗試啟動器的已簽名產品名。不會根據安裝目錄名字判斷國服或國際服，也不會僅憑釋出者名稱放寬簽名驗證。兩服的登錄檔安裝位置分別查詢；優先選擇遊戲對應型別，候選和快取均校驗共用官方指紋及所嘗試的啟動器產品名。查詢、校驗、建立臨時父程序或建立遊戲程序失敗時，會清理本輪臨時父程序，再嘗試另一種官方啟動器；兩種型別各嘗試一次。遊戲程序一旦建立成功，後續錯誤或初始化超時不會觸發再次啟動。回退只更換臨時父程序，遊戲渠道、引數和日誌公司目錄不變。

程式為官方 Games.exe 建立專屬的掛起臨時例項，作為遊戲的直接父程序；不復用或結束使用者已有的啟動器，也不需要點選“開始遊戲”。請保留至少一種官方啟動器，並把遊戲路徑設定為 Endfield.exe。兩服直啟都保留已有命令列引數，不額外注入語言或渠道引數。

兩服都只讀取當前渠道 LocalAppDataLow/<公司标识>/Endfield/sdklogs/OneChannelLC.log 中本次新增的完整日誌行。收到時間屬於本輪啟動、PID 匹配本次臨時程序的 Parent process check success:<PID> 後，立即回收本次專屬 Games.exe，不再等待 u8sdk_pc.log 的 SDK 初始化完成；這隻表示父程序檢查通過，不表示遊戲登入或所有資源載入完成。當前國際服實測在該訊號後回收，後續 SDK 仍初始化成功；該實驗不代表所有版本均已驗證。

120 秒內沒有成功訊號時不憑超時強行回收，而是保持掛起父程序，等遊戲退出後清理。讀取日誌或監視執行緒失敗時，兩服也共用備用監視及退出清理策略。下次 OK-EF 啟動會檢查 owned_temporary_launchers/ 恢復記錄：僅在原建立者已退出、PID/建立時間/完整路徑匹配，且遊戲或其他子程序均已退出後回收。無法確認身份或許可權不足時保留記錄並警告，不按程序名批次結束。

Steam 標準安裝通過 Steam URI 啟動；Epic 安裝目錄有 .egstore/ 時通過 Epic 的安裝目錄 URI 啟動。這兩種渠道由各自平臺管理，不建立上述臨時父程序，也不結束 Steam/Epic 客戶端。平臺 URI 無法轉發 OK-EF 自定義啟動引數時會明確報錯，請在平臺客戶端配置。Steam/Epic 的完整實機啟動仍待驗證。

無法讀取或識別遊戲公司標識，或兩種官方啟動器均不可用時，請修復安裝或先用對應客戶端手動啟動。已經執行的遊戲仍可由 OK-EF 識別，不會重複啟動。啟動異常請檢視 logs/ok-script.log。

反饋問題

在 GitHub Issues 提交問題時，請提供清晰的錯誤截圖或錄屏、已脫敏的相關日誌、復現步驟、實際結果、期望結果及軟體版本。不要上傳賬號資訊、個人路徑、金鑰或其他敏感資料。