feat(dbg): Improve debug flags

Author: Cryotechnic

Hi3Helper.Plugin.Wuwa/Management/WuwaGameInstaller.Patch.cs

@@ -460,7 +460,12 @@ await installer.RunAsync(kind, progressDelegate, progressStateDelegate, token)
                 // Check whether the installed files already match the TARGET version's hashes.
                 // This handles the case where both version JSONs are stale (e.g. game updated
                 // externally) but all files on disk are already at the target version.
-                if (!onlyDownload && patchIndex.GroupInfos.Length > 0)
+                if (manager.DEBUG_SkipPreflight)
+                {
+                    SharedStatic.InstanceLogger.LogWarning(
+                        "[Patch::RunAsync] Pre-flight validation SKIPPED (DEBUG_skipPreflight=true). Proceeding to download + patch.");
+                }
+                else if (!onlyDownload && patchIndex.GroupInfos.Length > 0)
                 {
                     currentProgressState = InstallProgressState.Verify;
 

Hi3Helper.Plugin.Wuwa/Management/WuwaGameManager.cs

@@ -85,6 +85,16 @@ private HttpClient ApiDownloadHttpClient
     /// </summary>
     internal GameVersion DEBUG_DowngradeVersionTarget { get; set; } = GameVersion.Empty;
 
+    /// <summary>
+    /// When true, the pre-flight validation (which checks whether local files already
+    /// match the target version) is skipped, forcing the patch flow to always download
+    /// and apply krpdiff patches. Useful for testing the actual patch-apply logic when
+    /// the game is already at the target version.
+    /// Persisted as <c>DEBUG_skipPreflight</c> in <c>app-game-config.json</c>.
+    /// The key is never written by default — add it manually to the JSON to enable.
+    /// </summary>
+    internal bool DEBUG_SkipPreflight { get; set; }
+
     protected override GameVersion CurrentGameVersion
     {
         get
@@ -367,10 +377,10 @@ private void LogGameStateOnce()
         SharedStatic.InstanceLogger.LogDebug(
             "[WuwaGameManager::GameState] IsInstalled={IsInstalled}, ApiGameVersion={ApiVer}, CurrentGameVersion={CurVer}, " +
             "ApiPreloadGameVersion={PreloadVer}, HasPendingPreloadPatch={PendingPatch}, PatchDir={PatchDir}, " +
-            "HasUpdate={HasUpdate}, HasPreload={HasPreload}, DEBUG_AllowDowngrade={AllowDowngrade}, DEBUG_DowngradeVersionTarget={DowngradeTarget}",
+            "HasUpdate={HasUpdate}, HasPreload={HasPreload}, DEBUG_AllowDowngrade={AllowDowngrade}, DEBUG_DowngradeVersionTarget={DowngradeTarget}, DEBUG_SkipPreflight={SkipPreflight}",
             IsInstalled, ApiGameVersion, CurrentGameVersion,
             ApiPreloadGameVersion, HasPendingPreloadPatch, patchTempPath,
-            HasUpdate, HasPreload, DEBUG_AllowDowngrade, DEBUG_DowngradeVersionTarget);
+            HasUpdate, HasPreload, DEBUG_AllowDowngrade, DEBUG_DowngradeVersionTarget, DEBUG_SkipPreflight);
     }
 
     protected override Task DownloadAssetAsyncInner(HttpClient? client, string fileUrl, Stream outputStream,
@@ -543,9 +553,11 @@ private void LoadDowngradeSettings()
 #if !USELIGHTWEIGHTJSONPARSER
         DEBUG_AllowDowngrade = CurrentGameConfigNode.GetConfigValue<bool?>("DEBUG_allowDowngrade") ?? false;
         string? targetStr = CurrentGameConfigNode.GetConfigValue<string?>("DEBUG_downgradeVersionTarget");
+        DEBUG_SkipPreflight = CurrentGameConfigNode.GetConfigValue<bool?>("DEBUG_skipPreflight") ?? false;
 #else
         DEBUG_AllowDowngrade = CurrentGameConfigNode["DEBUG_allowDowngrade"]?.GetValue<bool>() ?? false;
         string? targetStr = CurrentGameConfigNode["DEBUG_downgradeVersionTarget"]?.GetValue<string>();
+        DEBUG_SkipPreflight = CurrentGameConfigNode["DEBUG_skipPreflight"]?.GetValue<bool>() ?? false;
 #endif
 
         if (!string.IsNullOrEmpty(targetStr) &&
@@ -565,6 +577,12 @@ private void LoadDowngradeSettings()
                 "[WuwaGameManager::LoadDowngradeSettings] Downgrade enabled. Target version: {Ver}",
                 DEBUG_DowngradeVersionTarget);
         }
+
+        if (DEBUG_SkipPreflight)
+        {
+            SharedStatic.InstanceLogger.LogWarning(
+                "[WuwaGameManager::LoadDowngradeSettings] Pre-flight validation will be SKIPPED (DEBUG_skipPreflight=true).");
+        }
     }
 
     /// <summary>
@@ -682,6 +700,8 @@ public override void SaveConfig()
             else
                 CurrentGameConfigNode.Remove("DEBUG_downgradeVersionTarget");
         }
+        if (CurrentGameConfigNode.ContainsKey("DEBUG_skipPreflight"))
+            CurrentGameConfigNode["DEBUG_skipPreflight"] = DEBUG_SkipPreflight;
 
         if (CurrentGameVersion == GameVersion.Empty)
         {