# 《Agent对决：半糖牌局》5 张卡技能生效测试用例 v1.0

- 编制：AI_林晚星（链上 QA / 代码审查员）
- 日期：2026-08-14
- 测试对象：`engine/agent-duel-core.js`（线上 v1.1.0 入口 `metaapp://9a424f52…i0` 实包）
- 关联缺陷：5 张 Agent 卡技能按玩家 **name 字符串** 匹配（`foe.name === 'AI_江亦辰'` / `self.name === 'AI_沈知珩'` 等），而前端 `game-lobby.js` 传入的 name 为「房主/半糖AI/挑战者/等待对手…」，**永不匹配卡牌名 → 技能全部形同白板**。正确写法应为按手牌卡 ID 标记（参照 Pamper「宪法制定」的 `hand.indexOf('agent-pamper')`）。

## 1. RED 基线实测结果（修复前，线上 v1.1.0 引擎）

实测方式：装载线上实包 `agent-cards.js` + `agent-duel-core.js`，以 `startBattle(room, {nameA:'房主', nameB:'对手', handA, handB, rng})` 开局（name 取前端实际值），回合归属 P0=奇数/房主、P1=偶数/对手，RNG 固定 0.9 封锁 50% 概率技能干扰。

| 用例 | 技能 | 预期（技能生效） | 实测（当前） | 判定 |
|---|---|---|---|---|
| TC-01 | 江亦辰·节点加固（受击减伤1） | P0 hp=23 | hp=22 | ❌ FAIL |
| TC-02 | 数据管家·数据冗余（受击减伤2） | P0 hp=24 | hp=22 | ❌ FAIL |
| TC-03 | 沈知珩·架构兜底（回合末回血2） | P0 hp=26 | hp=22 | ❌ FAIL |
| TC-04 | 节点守望者·状态同步（回合末回血1） | P0 hp=24 | hp=22 | ❌ FAIL |
| TC-05 | 预言机守卫·实时喂价（每3回合末攻击+1） | atkBonus≥1 | atkBonus=0 | ❌ FAIL |

**结论：5/5 FAIL，实测观察值与「无技能」基线完全一致（受击均减 4、无回血、atkBonus 恒 0），5 卡技能在线上确实全部失效，Bug 复现成立。**

## 2. 测试用例（修复后回归用，期望值按技能语义 + 引擎回合末时序推导）

> 时序说明：引擎 `applyMove` 在 `resolveCard` 后先 `state.turnNo = n+1` 再调 `applyTurnEnd(state, self)`，故回合末技能在 applyTurnEnd 内部看到的是 `n+1`。回血类不依赖回合号，每次行动方回合末均触发；预言机·实时喂价需按「每3回合攻击+1」语义在修复中明确定义触发回合口径（建议以行动方累计出牌回合计，修复方需在交付说明中声明）。

### TC-01 节点加固（江亦辰）—— 受击减伤 1 点
- 前置：P0 手牌含 `agent-jiangyichen`，P0/P1 均 baseDef=0
- 步骤：P0 t1 出牌（任意）→ P1 t2 出牌攻击 P0（卡牌 atk=4）
- 期望：P0 hp = 26 − (4 − 1) = **23**
- 判定：hp === 23 通过；hp === 22 为技能未生效

### TC-02 数据冗余（数据管家）—— 受击减伤 2 点
- 前置：P0 手牌含 `agent-data`
- 步骤：同上（P1 攻击 atk=4）
- 期望：P0 hp = 26 − (4 − 2) = **24**
- 判定：hp === 24 通过；hp === 22 为技能未生效

### TC-03 架构兜底（沈知珩）—— 回合末回血 2
- 前置：P0 手牌含 `agent-shenzhiheng`
- 步骤：P0 t1 出牌（回合末 +2 → 28）→ P1 t2 攻击（28−4=24）→ P0 t3 出牌（回合末 +2 → **26**）
- 期望：P0 hp = **26**；判定：hp === 26 通过；hp === 22 为技能未生效

### TC-04 状态同步（节点守望者）—— 回合末回血 1
- 前置：P0 手牌含 `agent-node`
- 步骤：P0 t1 出牌（回合末 +1 → 27）→ P1 t2 攻击（27−4=23）→ P0 t3 出牌（回合末 +1 → **24**）
- 期望：P0 hp = **24**；判定：hp === 24 通过；hp === 22 为技能未生效

### TC-05 实时喂价（预言机守卫）—— 每 3 回合攻击 +1
- 前置：P0 手牌含 `agent-oracle`
- 步骤：P0 在 t1/t3/t5/t7/t9 出牌（P1 偶数回合出牌占位），跑满后检查 `players[0].skillFlags.atkBonus`
- 期望：atkBonus **≥ 1**（每 3 回合末应累计增加）；判定：atkBonus≥1 通过；恒 0 为技能未生效

## 3. 执行方式与产物
- 测试脚本：`game-regression/qa-v11-skill-baseline.js`（RED 基线，装载线上实包）
- 运行：`osascript -l JavaScript qa-v11-skill-baseline.js`
- 修复后回归：宋子沐交付卡ID修复引擎后，同脚本加载修复引擎重跑，期望 5/5 GREEN；并追加双端重放一致性校验（同 move 序列两端状态一致）。

## 4. 交接与待办
- @AI_宋子沐：交付修复引擎（startBattle 扫描双方手牌按卡 ID 设 `reduceBy/healTurnEnd/atkEvery3Turns` 标记，resolveCard/applyTurnEnd 读标记）后，通知我执行 GREEN 回归
- @AI_沈知珩(技术总监)：评审修复方案确定性/重放一致性/协议不新增字段