游戏测试与质量保障：自动化回归、冒烟与性能基准

// 伤害公式：物理伤害 = 攻击 × 技能系数 × (1 - 防御减伤)
// 防御减伤有上限，避免高防御无敌
public static float ComputeDamage(float atk, float skillRate, float def, float maxReduce) {
    var reduce = Mathf.Min(def / (def + 100f), maxReduce);
    return atk * skillRate * (1f - reduce);
}

[Test]
public void DamageFormula_TableDriven() {
    var cases = new[] {
        (atk: 100f, skillRate: 2f, def: 100f,    expect: 100f),            // 常规
        (atk: 100f, skillRate: 2f, def: 0f,       expect: 200f),            // 无防御
        (atk: 100f, skillRate: 2f, def: 10000f,   expect: 20f),             // 触发减伤上限 90%
        (atk: 0f,   skillRate: 2f, def: 50f,      expect: 0f),              // 零攻击
    };
    foreach (var c in cases) {
        Assert.That(ComputeDamage(c.atk, c.skillRate, c.def, 0.9f),
                    Is.EqualTo(c.expect).Within(0.01f));
    }
}

// 角色状态机：Idle → Run → Attack → Idle，附条件迁移
[Test]
public void Fsm_AttackCanOnlyFromReady() {
    var fsm = new PlayerFsm();
    fsm.SetState(State.Idle);
    fsm.Handle(Event.MoveInput);   // Idle → Run
    Assert.That(fsm.Current, Is.EqualTo(State.Run));
    fsm.Handle(Event.AttackPress); // Run → Attack（允许）
    Assert.That(fsm.Current, Is.EqualTo(State.Attack));
    fsm.Handle(Event.AttackPress); // Attack 中重复按 → 忽略
    Assert.That(fsm.Current, Is.EqualTo(State.Attack));
}

  存档系统 ↔ 版本迁移：老版本存档 → 新版本能读且数值守恒
  输入系统 ↔ 战斗系统：按键事件 → 招式的帧窗口判定
  客户端 ↔ 服务端：登录包 → 状态同步包时序正确
  配置表 ↔ 数值系统：表格加载 → 公式计算用对数值

// 集成测试：存档版本迁移（固定夹具保证可复现）
[Test]
public void SaveMigrate_V1ToV2_KeepsCurrency() {
    var v1 = LoadFixture("save_v1.json");          // 固定夹具，不入业务代码
    var migrated = SaveSystem.Migrate(v1);
    Assert.That(migrated.gold,           Is.EqualTo(v1.gold));
    Assert.That(migrated.schemaVersion,  Is.EqualTo(2));
    Assert.That(migrated.petSystem,      Is.Not.Null); // 新系统字段已补齐默认值
}

// 注入随机种子，让「随机掉落」可复现
var rng = new Random(seed: 20261001);
var drops = lootTable.Roll(rng);       // 同一种子两次运行结果一致
Assert.That(drops.Count, Is.EqualTo(3));

回归用例选择示例：
  改动「伤害公式」→ 跑：战斗域全量 + 竞技场结算 + 全局冒烟
  改动「存档字段」→ 跑：存档迁移矩阵 + 云存档 + 商城（读档进店）
  改动「协议包」→ 跑：登录握手 + 状态同步 + 断线重连

冒烟脚本（核心链路）：
  1. 启动 → 进主菜单（检查崩溃、黑屏、卡加载）
  2. 登录 → 进游戏主城（检查网络握手、初始数据下发）
  3. 开始一局 → 打完结算（检查核心循环与结算发放）
  4. 打开商店/背包（检查 UI 与数据绑定）
  5. 退出 → 存档写入（检查持久化与云同步）

# 冒烟任务（GitHub Actions 示意）
smoke:
  runs-on: ubuntu-latest
  steps:
    - uses: actions/checkout@v4
    - name: Build headless client
      run: make build-headless
    - name: Run smoke suite
      run: ./ci/smoke --scenario login_play_finish
      env:
        SMOKE_SERVER: ci-preflight.example.com

截图回归的取舍：
  优点：抓「表现回归」、无需人工逐帧看
  缺点：对光照/粒子敏感易误报、基线维护有成本
  对策：阈值 + 白名单（已知抖动区域）+ 失败人工复核

// 帧时间采集器（轻量，挂全局单例）
public class FrameStats {
    public double total;       // 累计帧时间
    public int frames;
    public double maxFrameMs;  // P100
    public double[] p99Ring;   // 环形缓冲，供 P99 计算

    public void Record(float ms) {
        total += ms; frames++;
        maxFrameMs = Math.Max(maxFrameMs, ms);
        // 维护 90 个采样（1.5s @60fps）用于 P99
    }
    public double AvgMs => frames > 0 ? total / frames : 0;
}

基准阈值示例（目标 60FPS，帧预算 16.67ms）：
  ├── P50 帧时间  ≤ 10ms   （绿，健康）
  ├── P95 帧时间  ≤ 15ms   （黄，可发布但预警）
  ├── P99 帧时间  ≤ 25ms   （红，阻塞发布）
  └── 尖峰数（>33ms 的帧数）≤ 每 10 分钟 3 次

性能基准进 CI 的形态：
  ├── 每次合入跑「性能烟囱」（关键场景抽样，约 15 分钟）
  ├── 每周跑「全量基准」（所有场景 × 低/中/高端设备）
  └── 阈值触发告警 → 关联到本次改动文件（git bisect 辅助定位）

# CI 关卡（合入阻塞式，任一失败即阻断）
stages:
  - lint            # 静态检查、编译告警
  - unit            # 单元测试（秒级，全量）
  - integration     # 集成测试（分钟级，全量）
  - smoke           # 冒烟：核心链路（分钟级）
  - benchmark       # 性能烟囱（约 15 分钟，抽样设备）
  - package         # 出包 + 上传内测渠道
# 任一关卡失败 → 阻断合并，避免「红了还继续叠」

发布闸门（Release Gate）清单：
  1. 单元测试通过率 100%，核心域覆盖率 ≥ 80%
  2. 集成测试全绿（存档迁移、协议兼容）
  3. 冒烟链路通过（登录→开局→结算→存档）
  4. 性能基准无 P99 超阈值、无新内存尖峰
  5. P0/P1 Bug 清零，P2 有明确排期
  6. 回滚预案就绪（配置开关/热更/白名单）