ThirdBattleLine

把元素组合、伤害来源、天气快照、概率与随机结果收束为不可变结果对象；同一入口既能用于正式结算，也能用于 AI 预演与测试注入。

• 显式传入 WeatherSnapshot，避免读取易变的全局天气状态
• rollPercent 可注入，使概率逻辑能够稳定复现并编写单元测试
• 配置数据库与 FallbackRules 双路径，兼顾数据驱动和资源缺失兜底

public readonly struct ElementalReactionResult
{
    public readonly bool Triggered;
    public readonly ElementalReactionType ReactionType;
    public readonly int ChancePercent;
    public readonly int RollPercent;
}

public static ElementalReactionResult PreviewCombat(
    RuntimeCard attacker,
    RuntimeCard defender,
    WeatherSnapshot weather,
    int? rollPercent = null)
{
    var result = Preview(
        attacker.NativeElement,
        defender.NativeElement,
        DamageSourceType.Combat,
        attacker.CurrentAttack,
        weather,
        rollPercent);

    return IsSuppressedByExtinguish(attacker, defender, result)
        ? ElementalReactionResult.NoReaction
        : result;
}

法术、部署、持续触发、普攻和死亡共用同一表现入口。表现层在命中关键帧调用 onImpact，规则层不需要知道弹道、全屏动画或目标锚点如何实现。

• Projectile、SpawnAtTarget、Fullscreen、CardCollision 与自定义 Presenter 统一分发
• EffectContext 保存逻辑语义，PresentationProfile 保存视觉语义
• 旧资源字段可自动解析为新 Profile，支持渐进式迁移而非一次性重写

IEnumerator PlayRoutine(
    EffectPresentationRequest request,
    Func<IEnumerator> onImpact = null,
    Action onComplete = null);

// 表现层只在命中关键帧提交规则结算
yield return presentationService.PlayRoutine(
    request,
    onImpact: () => ResolveSpellImpactRoutine(context),
    onComplete: () => ReleasePresentation(request));

网络层通过独立程序集接入 Nakama，将玩家意图 PlayerCommandDto 与服务器/Relay 结果 GameEventDto 分开处理，再由 NetworkGameOrchestrator 负责入队、去重和远端回放。

• 设备认证、Session 缓存、Socket、Matchmaker 与 Relay 已形成隔离封装
• OpCode、DTO 与序列化集中管理，降低客户端和服务端协议漂移风险
• NetworkCardLocator 使用 runtimeCardId、手牌索引与 sourceCardId 多级定位远端卡牌

public interface IMatchNetworkClient
{
    event Action<PlayerCommandDto> OnPlayerCommand;
    event Action<GameEventDto> OnGameEvent;

    Task ConnectAsync();
    Task SendCommandAsync(PlayerCommandDto command);
}

// Orchestrator 统一接收、去重并排队回放
private void HandleRemoteCommand(PlayerCommandDto command)
{
    if (!processedCommandIds.Add(command.commandId)) return;
    pendingCommands.Enqueue(command);
}