烛札 · 双人对战卡牌

1
graph TD
2
    subgraph AOT["AOT 启动层（打进 APK/EXE）"]
3
        Boot["Bootstrap\n启动装配 + 热更加载"]
4
        Asset["Assets\nYooAsset 门面 + 补丁状态机"]
5
        Set["Settings\n用户偏好 + SfxId 契约"]
6
    end
7
    subgraph HOT["热更业务层（打进 bundle，运行时 Load）"]
8
        Net["Network · GameManager / Player"]
9
        UI["UI · Card · AI · Presentation"]
10
    end
11
    subgraph CORE["纯 C# 逻辑层（零 UnityEngine 依赖，可单测）"]
12
        BS["BattleSession · CombatResolver"]
13
        RW["RewardCalculator · LevelCurve"]
14
    end
15

16
    AOT -->|"单向依赖（反向禁止）"| HOT
17
    HOT -->|"订阅 event / 调方法（单向）"| CORE

1
// 高明之处：第 1、3 步是新手最容易漏的——漏 ① 泛型在真机炸 ExecutionEngineException；漏 ③ NGO 的
2
// NetworkVariable 序列化 / RPC 派发表为空（晚加载的 DLL 不会被引擎自动扫描 RuntimeInitializeOnLoad）。
3
RuntimeApi.LoadMetadataForAOTAssembly(aotBytes, HomologousImageMode.SuperSet); // ① 补 AOT 元数据
4
var hot = Assembly.Load(hotDllBytes);                                          // ② 注入热更字节码
5
InvokeRuntimeInits(hot);                                                       // ③ 手动补触发 NGO 注册

1
// 高明之处：URL 不含版本段 → 客户端代码零改动；版本由 YooAsset 读 .version 自动协商；
2
// bundle 用 hash 命名多版本共存，ClearUnusedBundleFiles 回收旧包，服务器磁盘不膨胀。
3
string GetRemoteMainURL(string fileName) => $"{_hostServerIP}/CDN/{_platformName}/{fileName}";

1
public class BattleSession            // 零 UnityEngine 依赖，可脱离引擎单测
2
{
3
    public event Action<CombatOutcome, PendingCardData, PendingCardData> OnCombatResolved;
4
    public void ResetAll() { _p1Card = default; _p2Card = default; _p1RematchReady = _p2RematchReady = false; }
5
}
6
// CombatPresenter（MonoBehaviour）只订阅事件、起协程放动画，不含任何战斗规则

1
public void TakeDamage(int dmg) { if (!IsServer) return; netCurrentHealth.Value -= dmg; } // 写权限锁服务端，自动广播

1
void IBattleApi.SubmitCard(...)  => SubmitCardServerRpc(...);   // 真人：走 ServerRpc
2
public void SubmitCardForAI(...) => _session.SubmitCard(...);   // AI：Host 本地直调，两路同一出口

1
// Lv3：枚举每张手牌 × 4 种假想敌（均匀概率）求加权期望收益，argmax 选最优；EvaluateExpectedScore 是无状态纯函数
2
float avg = EvaluateExpectedScore(myCard.cardType, myCard.powerValue);  // Σ Resolve(enemy, my) / 4