🚗 日常类比：学开车 vs 成为老司机

┌─────────────────────────────────────────────────────────────────────┐
│   🚗 新手司机                        🏎️ 老司机                       │
│   ════════════                       ════════                       │
│   ✅ 能把车开走                      ✅ 能把车开走                   │
│   ❌ 油耗高（频繁刹车加速）          ✅ 油耗低（预判路况）           │
│   ❌ 容易堵车（不会选路线）          ✅ 避开拥堵（熟悉路况）         │
│   ❌ 乘客晕车（操作生硬）            ✅ 乘客舒适（平稳驾驶）         │
│                                                                     │
│   💡 区别不在于"会不会"，而在于"好不好"                             │
└─────────────────────────────────────────────────────────────────────┘

Iris 也是如此：
- 新手：能让对象同步（但可能卡顿、延迟、带宽爆炸）
- 老手：同步丝滑、带宽可控、支持大规模玩家

📧 日常类比：邮件 vs 微信消息

┌─────────────────────────────────────────────────────────────────────┐
│   📧 传统邮件（Poll 模式）           💬 微信消息（Push 模式）        │
│   ═════════════════════════          ═════════════════════════      │
│   你：每 5 分钟打开邮箱检查          微信：有消息直接弹通知          │
│       "有新邮件吗？"×100 次              "叮！你有新消息"            │
│                                                                     │
│   问题：99% 的检查都是白费劲         优点：只在有消息时才打扰你      │
└─────────────────────────────────────────────────────────────────────┘

性能对比（1000 个 Actor，每个 20 个属性）：
- Poll 模式：每帧检查 20,000 次 → 2.5 ms
- Push 模式：每帧检查 ~200 次 → 0.25 ms
🚀 10 倍提升！

// 1. 属性声明UPROPERTY(ReplicatedUsing = OnRep_Health)
float Health;

// 2. 修改时标脏void AMyCharacter::SetHealth(float NewHealth){
    if (Health != NewHealth)
    {
        Health = NewHealth;
        MARK_PROPERTY_DIRTY_FROM_NAME(AMyCharacter, Health, this);
    }
}

🏥 日常类比：医院巡房制度

┌─────────────────────────────────────────────────────────────────────┐
│   病房类型              │ 巡房频率    │ 原因                         │
│   ─────────────────────┼────────────┼───────────────────────────   │
│   🚨 ICU 重症监护       │ 每 5 分钟   │ 病情随时可能变化             │
│   🏥 普通病房           │ 每 2 小时   │ 病情相对稳定                 │
│   🏠 康复病房           │ 每天 1 次   │ 基本已经好了                 │
└─────────────────────────────────────────────────────────────────────┘

游戏对象配置建议：
- 🎮 玩家角色：PollFrequency=0（每帧）- ⚔️ 战斗敌人：PollFrequency=30（每秒30次）- 🚶 普通NPC：PollFrequency=10- 📦 拾取物品：PollFrequency=2- 🌳 环境装饰：PollFrequency=0.5

💤 日常类比：手机省电模式

屏幕长时间不操作 → 自动息屏 → 省电 90%
对象长时间不变化 → 自动休眠 → 省 CPU 90%

休眠模式：
- DORM_Never：永不休眠（玩家角色）- DORM_Awake：当前活跃，可以休眠- DORM_DormantAll：对所有人休眠（静止物体）

// 静态物体初始化后立即休眠void AMyStaticActor::BeginPlay(){
    Super::BeginPlay();
    SetNetDormancy(DORM_DormantAll);
}

// 被交互时唤醒void AMyStaticActor::OnInteract(){
    FlushNetDormancy();
    // 处理交互...
    // 5秒后重新休眠
    GetWorldTimerManager().SetTimer(Timer, this, &AMyStaticActor::GoBackToSleep, 5.0f);
}

📹 日常类比：视频压缩

┌─────────────────────────────────────────────────────────────────────┐
│   全量发送                           增量发送                       │
│   ═══════════                        ═══════════                    │
│   帧1: [完整数据 148字节]            帧1: [完整数据 148字节]        │
│   帧2: [完整数据 148字节]            帧2: [位置变化 12字节]         │
│   帧3: [完整数据 148字节]            帧3: [血量变化 4字节]          │
│                                                                     │
│   总计: 444 字节                     总计: 164 字节                 │
│                                      🚀 节省 63%！                  │
└─────────────────────────────────────────────────────────────────────┘

适用场景：
✅ 启用：属性多（>10个）、变化少的对象（角色、载具）
❌ 禁用：属性少（<5个）、生命周期短的对象（子弹、特效）

🔭 日常类比：望远镜视野

你站在山顶：
- 🏠 近处村庄（清晰，重点关注）→ 高频复制- 🌲 中距树林（模糊，偶尔看看）→ 低频复制  - ⛰️ 远处山脉（看不清，不关心）→ 不复制

配置建议：
┌─────────────────────────────────────────────────────────────────────┐
│   游戏类型      │ CellSize  │ CullDistance │ 说明                   │
│   ─────────────┼──────────┼─────────────┼───────────────────────   │
│   🔫 FPS       │ 5000     │ 10000       │ 小地图，快节奏           │
│   🏎️ 竞速      │ 20000    │ 30000       │ 高速移动，需要远视野     │
│   🌍 开放世界  │ 50000    │ 50000       │ 超大地图，分区加载       │
└─────────────────────────────────────────────────────────────────────┘

🏫 日常类比：学校班级管理

❌ 无分组："高三数学考试" → 全校 3000 人都收到
✅ 有分组："高三数学考试" → 只有高三 300 人收到

应用场景：
- 队伍系统：队友之间共享更多信息- 副本隔离：不同副本的玩家互不可见- 阵营系统：敌我双方的可见性控制

🎯 核心需求：低延迟（<50ms）、高精度、快响应

配置要点：
┌─────────────────────────────────────────────────────────────────────┐
│   对象类型      │ 轮询频率   │ 过滤策略      │ 增量压缩              │
│   ─────────────┼───────────┼──────────────┼─────────────────────   │
│   🎮 玩家       │ 每帧       │ 空间+视野     │ ✅ 启用               │
│   🔫 投射物     │ 每帧       │ 空间         │ ❌ 禁用（生命周期短） │
│   ⚔️ 武器       │ 30 Hz      │ 跟随拥有者   │ ✅ 启用               │
│   📦 拾取物     │ 5 Hz       │ 空间         │ ❌ 禁用               │
└─────────────────────────────────────────────────────────────────────┘

关键优化：
- 玩家位置使用每帧轮询 + Push Model- 投射物禁用增量压缩（生命周期太短）- 命中判定使用服务器权威 + 延迟补偿

🎯 核心需求：大世界、多NPC、持久化

配置要点：
┌─────────────────────────────────────────────────────────────────────┐
│   对象类型      │ 轮询频率   │ 休眠策略      │ 特殊处理              │
│   ─────────────┼───────────┼──────────────┼─────────────────────   │
│   🎮 玩家       │ 每帧       │ 永不休眠      │ Push Model            │
│   ⚔️ 战斗怪物   │ 15 Hz      │ 远离时休眠   │ 战斗时唤醒            │
│   🚶 普通NPC    │ 5 Hz       │ 可休眠       │ 交互时唤醒            │
│   🏪 商店NPC    │ 2 Hz       │ 可休眠       │ 只关心交互            │
│   🌲 资源点     │ 1 Hz       │ 深度休眠     │ 采集时唤醒            │
└─────────────────────────────────────────────────────────────────────┘

关键优化：
- 使用关卡流送（World Partition）- 远处 NPC 进入休眠状态- 背包内物品不需要网络复制

📊 带宽挑战计算：

100 玩家 × 100 字节/人 × 99 人 × 60 帧 = 57 MB/s 💀

优化后：
- 空间过滤：每人只看附近 20 人 → 减少 80%
- 增量压缩：70% 压缩率 → 再减少 70%
最终：57 MB/s → 3.4 MB/s 🚀 节省 94%！

配置要点：
┌─────────────────────────────────────────────────────────────────────┐
│   对象类型      │ 可见范围   │ 优先级策略    │ 特殊处理              │
│   ─────────────┼───────────┼──────────────┼─────────────────────   │
│   🎮 玩家       │ 300m      │ 视野优先     │ 战斗中提升优先级      │
│   🚗 载具       │ 500m      │ 距离优先     │ 高速移动需更大范围    │
│   📦 掉落物     │ 100m      │ 低优先级     │ 被捡后立即销毁        │
│   ☠️ 死亡盒子   │ 150m      │ 低优先级     │ 休眠处理              │
└─────────────────────────────────────────────────────────────────────┘

🏗️ 架构设计：

┌─────────────────────────────────────────────────────────────────────┐
│                        ┌─────────────────┐                          │
│                        │   网关服务器     │                          │
│                        └────────┬────────┘                          │
│              ┌──────────────────┼──────────────────┐                │
│              ▼                  ▼                  ▼                │
│     ┌────────────────┐ ┌────────────────┐ ┌────────────────┐       │
│     │  区域服务器 1   │ │  区域服务器 2   │ │  区域服务器 3   │       │
│     │  (主城)        │ │  (野外)        │ │  (副本)        │       │
│     │  Iris 实例 1   │ │  Iris 实例 2   │ │  Iris 实例 3   │       │
│     └────────────────┘ └────────────────┘ └────────────────┘       │
└─────────────────────────────────────────────────────────────────────┘

优化策略：
1️⃣ 区域分服：每个区域独立服务器
2️⃣ 兴趣区域（AOI）：只同步视野内对象
3️⃣ 分层复制：近处完整、远处简化
4️⃣ 大型活动：动态调整更新频率

┌─────────────────────────────────────────────────────────────────────┐
│   阶段 1：并行测试（1-2 周）                                         │
│   • 在测试环境启用 Iris，不修改代码                                 │
│   • 验证基本功能，对比性能指标                                      │
│                                                                     │
│   阶段 2：配置优化（1-2 周）                                         │
│   • 配置轮询频率、过滤器、优先级器                                  │
│   • 验证配置效果                                                    │
│                                                                     │
│   阶段 3：代码适配（2-4 周）                                         │
│   • 启用 Push Model，添加 MARK_PROPERTY_DIRTY                       │
│   • 优化休眠策略，处理自定义序列化                                  │
│                                                                     │
│   阶段 4：测试验证（1-2 周）                                         │
│   • 功能测试、性能测试、压力测试                                    │
│                                                                     │
│   阶段 5：正式上线                                                   │
│   • 灰度发布 → 监控 → 全量发布                                      │
└─────────────────────────────────────────────────────────────────────┘

□ Push Model：频繁变化的属性启用，修改时正确标脏
□ 轮询频率：玩家每帧，战斗对象 10-30Hz，静态对象 <2Hz
□ 休眠策略：静态物体使用 DORM_DormantAll
□ 增量压缩：复杂对象启用，简单对象禁用

□ 空间过滤：根据游戏类型设置合适的 CellSize 和 CullDistance
□ 滞后配置：设置合适的帧数防止闪烁
□ 组过滤：为队伍/副本创建独立的组

□ 环境准备：UE5.0+，启用插件，备份项目
□ 分阶段迁移：测试→配置→代码→验证→上线
□ 回滚方案：保留传统系统作为后备