# T5 灵兽对战引擎（后端 / 纯逻辑，隐藏测试自动打分）

在当前目录写一个 **零依赖** 的 Node.js ES 模块 `battle.mjs`（Node 22，不许 npm install），实现一个五行灵兽回合制对战引擎。必须**逐字**按下面的规格实现，评测会用隐藏单元测试逐项核对（包括随机数调用顺序）。另外自己写 `battle.test.mjs`（用 `node:test`）覆盖你认为重要的情况，并确保 `node --test` 通过。

## 导出
```js
export const ELEMENTS = ['金','木','水','火','土'];
export function elementMultiplier(atkEl, defEl)   // 相克 2，被克 0.5，其余 1
export function createBeast(spec)                 // 见下
export function effectiveSpeed(beast)
export function calcDamage(attacker, defender, skill, rng)
export function runTurn(state, actionA, actionB, rng)
export function simulate(beastA, beastB, chooseA, chooseB, rng, maxTurns = 100)
```

## 五行相克（攻击方 → 被攻击方 = 2 倍）
金克木、木克土、土克水、水克火、火克金。反过来（如 木 打 金）= 0.5 倍。其余 = 1。

## createBeast(spec)
`spec = {name, element, hp, atk, def, spd, skills}`，`skills` 为数组，每个技能 `{name, element, power, accuracy, effect?}`，`effect` 可选，取值 `'灼烧'` 或 `'麻痹'`，表示命中后**额外**再用一次随机数判定 30% 概率（`rng() < 0.3`）附加该状态（目标已有任何状态则不附加，也**不调用** rng）。
返回一个新对象：包含 spec 的全部字段，外加 `curHp = hp`、`status = null`。不得修改传入的 spec。
参数不合法（hp/atk/def/spd 不是正整数，或 element 不在 ELEMENTS，或 skills 为空）时 `throw new TypeError(...)`。

## effectiveSpeed(beast)
麻痹时为 `Math.floor(spd / 2)`，否则为 `spd`。

## calcDamage(attacker, defender, skill, rng) → `{damage, crit, multiplier}`
**严格按此顺序调用 rng：先暴击、后浮动。**
```
mult   = elementMultiplier(skill.element, defender.element)
stab   = (skill.element === attacker.element) ? 1.5 : 1
crit   = rng() < 0.0625            // 第 1 次 rng
critM  = crit ? 1.5 : 1
rand   = 0.85 + rng() * 0.15       // 第 2 次 rng
base   = (2 * attacker.atk / defender.def) * skill.power / 10 + 2
damage = Math.max(1, Math.floor(base * mult * stab * critM * rand))
```
calcDamage 不修改任何对象。

## runTurn(state, actionA, actionB, rng)
`state = {a, b, turn, log, winner}`（a、b 为 createBeast 的结果；turn 从 0 开始；log 为字符串数组；winner 为 null / 'a' / 'b'）。`actionA`、`actionB` 是各自 skills 中的**下标**。返回**新的** state（深拷贝，不改原 state）。流程：
1. 若 winner 已非 null，原样返回拷贝。
2. 行动顺序：effectiveSpeed 高者先；相等时 a 先。
3. 每只灵兽行动时（若它此时 curHp > 0）：
   a. 若 status 为 `'麻痹'`：调用 rng，若 `< 0.25` 则本回合无法行动（log 记一条），跳到下一只。
   b. 命中判定：调用 rng，若 `rng() * 100 >= skill.accuracy` 则未命中（log 记一条）。
   c. 命中则调用 calcDamage（2 次 rng），目标 curHp 减去 damage（最低到 0），log 记一条。
   d. 若技能有 effect 且目标 curHp > 0 且目标 status 为 null：调用 rng，`< 0.3` 则附加状态。
   e. 若目标 curHp 变为 0：winner 设为行动方（'a' 或 'b'），**立即结束本回合**（后手不再行动、不结算灼烧）。
4. 双方都行动完后，**先 a 后 b** 结算灼烧：status 为 `'灼烧'` 且 curHp > 0 时扣 `Math.max(1, Math.floor(hp / 16))`；若因此倒下，winner 为对方；若 a 因灼烧倒下，b 不再结算。
5. turn + 1。
log 内容格式不考核，但每个事件至少一条。

## simulate(beastA, beastB, chooseA, chooseB, rng, maxTurns=100)
从 `{a: beastA, b: beastB, turn: 0, log: [], winner: null}` 开始循环：`chooseA(state)`、`chooseB(state)` 返回技能下标，调用 runTurn，直到有 winner 或 turn 达到 maxTurns。返回最终 state；若到达上限仍无胜负，winner 为 `'draw'`。

## 交付
- `battle.mjs`、`battle.test.mjs`，`node --test` 全绿。
- 一个 `README.md`，三五句话说明设计。
- 只在当前目录内写文件，不要删除任何文件，不要访问网络。

## 写文件的注意
- 单次输出有长度上限（约 3 万 token）。**不要把整个作品一次写进一个巨大的文件**：拆成多个 js 模块（每个文件几百行以内）分多次写入；需要改动时用编辑而不是整份重写。
