// 示例：Vampirefall 调试指令集
/add_perk [perk_id] [level]      // 添加特定天赋
/remove_perk [perk_id]           // 移除天赋
/set_stat [stat_name] [value]    // 强制修改属性(如暴击率)
/spawn_enemy [enemy_id] [count]  // 生成特定敌人
/god_mode [bool]                 // 无敌模式(测试受击触发用)

// 伪代码：配置热重载监听
public class ConfigReloader : MonoBehaviour {
    void OnEnable() {
        FileWatcher.Watch("StreamingAssets/Data", OnDataChanged);
    }

    void OnDataChanged() {
        GameTables.Reload(); // 重新加载 Luban 表
        EventManager.Trigger(new OnConfigReloadedEvent());
        Debug.Log("♻️ Configs Hot-Reloaded!");
    }
}

public static class BuildSerializer {
    // 示例输出: "VF1$H:1,L:20$P:3,4,12$I:40:2$C:9A"
    // VF1=版本, H=Hero, P=Perks, I=Items(ID:Count), C=Checksum
    
    public static string Serialize(PlayerData data) {
        StringBuilder sb = new StringBuilder();
        sb.Append("VF1$"); // Version Header
        
        // 1. Hero
        sb.Append($"H:{GlobalIDMap.ToInt(data.HeroId)}");
        sb.Append($",L:{data.Level}$");
        
        // 2. Perks (只存 ID)
        sb.Append("P:");
        var perkCodes = data.Perks.Select(p => GlobalIDMap.ToInt(p.Id).ToString());
        sb.Append(string.Join(",", perkCodes));
        sb.Append("$");

        // 3. Checksum
        string raw = sb.ToString();
        sb.Append($"C:{ComputeHash(raw)}");
        
        return Convert.ToBase64String(Encoding.UTF8.GetBytes(sb.ToString()));
    }
}

{
    "meta": { "timestamp": 12345678, "game_version": "0.5.2" },
    "player": { ... }, // 完整的玩家存档数据
    "level_state": {
        "chapter_id": "chapter_2_swamp",
        "current_wave": 5,
        "rng_sseed": 998244353, // 关键：随机数种子
        "difficulty_factor": 1.5
    }
}

#if UNITY_EDITOR
[UnityEditor.MenuItem("Debug/Load Dump From Clipboard")]
public static void LoadDump() {
    string json = GUIUtility.systemCopyBuffer;
    var dump = JsonUtility.FromJson<DumpData>(json);
    
    // 设置一个全局标记，告诉游戏启动时不要走正常流程
    DebugContext.CurrentDump = dump;
    EditorApplication.isPlaying = true;
}
#endif

// 游戏初始化逻辑
void Start() {
    if (DebugContext.CurrentDump != null) {
        RestoreFromDump(DebugContext.CurrentDump);
    } else {
        StartNormalGame();
    }
}

[System.Serializable]
public class GameSnapshot {
    // 1. 元数据
    public string Version = "1.0";
    public long Timestamp;
    
    // 2. 玩家状态 (极其重要：不仅是静态属性，还有动态状态)
    public PlayerDump Player;
    
    // 3. 关卡环境 (复现现场的核心)
    public EnvironmentDump Env;
}

[System.Serializable]
public class PlayerDump {
    // 基础
    public string HeroId; 
    public int Level;
    
    // 构建 (Build)
    public List<string> InventoryItemIds; // 装备
    public List<string> ActivePerkIds;    // 词条
    
    // 运行时状态 (进房时的状态)
    public float CurrentHp;          // 也许进房时就只有 10% 血
    public float CurrentEnergy;
    public List<string> ActiveBuffs; // 只有进房时带入的 Buff 才算 (如药水效果)
}

[System.Serializable]
public class EnvironmentDump {
    public string ChapterId;      // 比如 "Level_1_3"
    public int WaveIndex;         // 当前是第几波
    public int RngSeed;           // 【核心】地图和刷怪的随机种子
    public float DifficultyScale; // 难度系数
    
    // 进阶：如果有关卡特效
    public List<string> MapAffixes; // 例如 "地面打滑", "敌人死亡爆炸"
}

// DebugContext.cs
public static class DebugContext {
    // 这里存储待恢复的快照
    // 如果为 null，说明是正常启动；如果不为 null，说明是 Debug 启动
    public static GameSnapshot SnapshotToLoad; 
}

// SnapshotLoader.cs (放在 Editor 文件夹)
using UnityEditor;
using UnityEngine;

public static class SnapshotLoader {
    [MenuItem("Tools/🐛 Debug/Run From Clipboard Snapshot")]
    public static void RunSnapshot() {
        // 1. 获取剪贴板内容
        string json = GUIUtility.systemCopyBuffer;
        if (string.IsNullOrEmpty(json)) {
            Debug.LogError("Clipboard is empty!");
            return;
        }

        try {
            // 2. 解析数据
            var snapshot = JsonUtility.FromJson<GameSnapshot>(json);
            
            // 3. 注入上下文
            DebugContext.SnapshotToLoad = snapshot;
            
            // 4. 打开并运行战斗场景
            // 注意：不要加载 MainMenu，直接加载 BattleScene
            UnityEditor.SceneManagement.EditorSceneManager.OpenScene("Assets/Scenes/BattleScene.unity");
            EditorApplication.isPlaying = true;
            
            Debug.Log($"🚀 Launching snapshot from Seed: {snapshot.Env.RngSeed}");
        } catch (System.Exception e) {
            Debug.LogError($"Failed to parse snapshot: {e.Message}");
        }
    }
}

// GameManager.cs
void Awake() {
    if (DebugContext.SnapshotToLoad != null) {
        // A. 走调试流程
        InitializeFromSnapshot(DebugContext.SnapshotToLoad);
        
        // 重要：用完后清空，防止下次正常停止播放后，再次启动时还残留数据
        DebugContext.SnapshotToLoad = null; 
    } else {
        // B. 走正常流程 (读取本地存档、生成新关卡...)
        InitializeNormalGame();
    }
}

void InitializeFromSnapshot(GameSnapshot snap) {
    Debug.LogWarning("⚠️ Game Initialized from Debug Snapshot!");

    // 1. 还原随机数生成器 (最关键的一步)
    // 所有的怪物生成、掉落、地图构造都必须依赖这个种子
    RandomService.Init(snap.Env.RngSeed); 

    // 2. 还原玩家
    var player = PlayerFactory.Create(snap.Player.HeroId);
    player.SetStats(snap.Player.Level, snap.Player.InventoryItemIds);
    player.SetHp(snap.Player.CurrentHp); // 还原残血状态
    
    // 3. 还原环境
    LevelManager.LoadLevel(snap.Env.ChapterId);
    WaveManager.JumpToWave(snap.Env.WaveIndex); // 跳过前几波
    
    // 4. 应用特殊词条
    AffixManager.ApplyMapAffixes(snap.Env.MapAffixes);
}