LAN host-drive & AFK co-op

LAN dual-instance testing: host hand-plays locally while AI drives the ENet client; AFK client blocks local combat input and mirrors map votes. Setup, logs, and regression checklist are in Chinese below.

DevMode 在 LAN 双开 场景下，让主机玩家手动操作本地角色（netId=1），由规则 AI 通过动作队列代打真实 ENet 客机（netId=1000）；客机开启 AFK 后不向本地队列提交战斗输入，地图投票由主机镜像。

每次改 DevMode 并 make compile / make deploy 后，两边游戏窗口都要完全重启。

双开时 不会 自动套用 LAN preset；开局后在各窗口 DevPanel → AI 托管 手动点击：

AFK 开关是 per-process（KitLibInstance.SessionLan）。

半配置会 desync： 只开客机 AFK、主机未开 LAN preset 时，1000 无人代打且 coop 回合门控易乱。双开时两边都要手动点。

1. Host profile1 + Client profile2（避免共享存档冲突）。
2. Host → LAN Host；Client → Join 127.0.0.1。
3. 主机点地图 → 客机自动镜像投票。
4. 进战斗：主机手打 1 号位；AI ~400ms poll 为 1000 出牌。
5. 成功：完整跑完玩家阶段 + 敌人阶段，无 StateDivergence。

官方源码（Slay the Spire 2/src/Core/）中 coop 战斗同步分 两层：

Vanilla 要求：两边在同一动作流上执行 EndPlayerTurnAction → 各自 SetReadyToEndTurn → 两边本地都满足 AllPlayersReadyToEndTurn() 后才进入 phase 1（EndPlayerTurnPhaseOneInternal），并生成 checksum "After player turn phase one end"。

1. NetEndPlayerTurnAction 无玩家 ID，只有 combatRound；玩家来自 ActionEnqueuedMessage.playerId（NetActionToGameAction）。
2. Host 侧 RequestEnqueue 默认 EnqueueAction(action, _netService.NetId) — 代 1000 出牌/结束回合时，client 会重建出 host 玩家 的 action。
3. SetReadyToEndTurn 不联网 — 只在调用它的进程更新 ready 集合；若仅 host 调用，client 永远到不了 AllPlayersReadyToEndTurn()，或 host 单方面先进 phase 1 → StateDivergence。

Play phase
  → 各玩家 RequestEnqueue(EndPlayerTurnAction) [playerId = sender]
  → 两边执行 action → SetReadyToEndTurn(各自玩家)
  → AllPlayersReadyToEndTurn → AfterAllPlayersReadyToEndTurn
  → Phase 1: EndPlayerTurnPhaseOneInternal → checksum "After player turn phase one end"
  → 各端 RequestEnqueue(ReadyToBeginEnemyTurnAction for GetMe)
  → SetReadyToBeginEnemyTurn × N → Phase 2 → 敌人回合 → RoundNumber++

DevMode host-drive 必须在 动作队列层 用正确的 playerId 广播，才能让 client 同步更新 ready 标志；不能依赖 host-only SetReadyToEndTurn。

双开时磁盘上的 godot.log 会交错；用 Dev 控制台或分文件日志按窗口查看。

Select-String -Path "$env:APPDATA\SlayTheSpire2\logs\godot.log" `
  -Pattern "LAN host preset|AFK client enabled|GameLoop|Enqueued end turn|StateDivergence|Ready end turn \(live ENet\)"

• 有 LAN host preset applied
• 有 [MpAiTeammate] GameLoop（1000 由 AI 驱动）
• 有 Enqueued end turn netId=1000（live ENet 同步路径）
• 每个 round 至多 1 条 Enqueued end turn netId=1000（无 duplicate）
• Enqueued end turn 在对应 Player 1000 playing ... finished execution 之后
• 无 StateDivergence
• 无 Ready end turn (live ENet)（已废弃路径）
• 每个 round 先 host/client 均出现 After player turn phase one end（id N）
• 再 client Sending message to host requesting to enqueue action ReadyToBeginEnemyTurnAction 1000（vanilla，非 DevMode log）
• 再 after player turn phase two end（id N+1）
• 无 [MpAiTeammate] AFK client ready-to-begin-enemy-turn 或 [PseudoCoop] Enqueued ready-to-begin-enemy-turn
• 无 EndPlayerTurnPhaseTwo called while the current side is Enemy
• 随后应有 After enemy turn start，不应长时间停在 No action is ready + 仅 ping

• 双方 AI EndPlayerTurn（P1000 + P1）→ EndTurnPhaseOne；P1 ReadyToBeginEnemyTurn 已执行
• 无 P1000 ready → 卡在 No action is ready，仅 ping
• 成功路径 197996：P1 ready 时 NotPlayPhase → 旧 AFK hook 触发 AFK client ready-to-begin-enemy-turn
• 210300：EndTurnPhaseOne 路径不经过 NotPlayPhase，且 #6 后 live ENet 被 skip
• 修复：与 end-turn 对称，host owner-routed enqueue P1000 ready

• #9 后无软锁，host 有 Enqueued ready-to-begin-enemy-turn netId=1000
• 客机 EndTurnPhaseOne 兜底 TrySignalReadyToBeginEnemyTurn → 第二条 Ready（action id 11）
• Round 1：client EndPlayerTurnPhaseTwo called while the current side is Enemy
• Round 2：checksum 17 — host After player turn phase one end，client after player turn phase two end；敌人 HP 56 vs 62
• 修复：仅 host ReadySimulatedPeersToBeginEnemyTurn 单路径；AFK 不再本地 enqueue Ready

• #10 后无 duplicate Ready，但第一回合 checksum 6 即 StateDivergence
• Host：After player turn phase one end id 6 → host broadcast P1000 Ready → phase two id 7
• Client：P1+P1000 Ready 连续执行 → after player turn phase two end 作为 id 6（跳过 phase1 checkpoint）
• 成功路径 203024：P1 Ready → phase1 checksum → client RequestEnqueue P1000 → phase2
• 修复：host 不再 enqueue live ENet P1000 Ready；AFK client 在 P1 Ready 执行后 RequestEnqueue self

• #11 client hook 在 P1 Ready 执行中 RequestEnqueue → 仍跳过 phase-1 checkpoint
• 成功 203024：P1 Ready → phase1 checksum → vanilla Sending message to host requesting... Ready 1000
• 修复：移除 MpAiTeammateAfkPeerReadyPatch；AFK 只放行 ReadyToBeginEnemyTurnAction，不干预 vanilla 时机

• Round 1–2：通过（checksum 连续，无 phase 1 desync）
• Round 3：checksum 27 After enemy turn end — UndeadSpirit 14 vs 17，属 LustTravel2 边界（非本次 DevMode 范围）

• 主机 log 无 LAN host preset applied；第一轮 无 GameLoop
• 客机 alone AFK → 1000 未 ready，phase 门控分叉
• 客机 SetReadyToBeginEnemyTurn(1000) 可能提前进入 phase 2
• 手牌/敌人 HP 不一致；UndeadSpirit 两侧一致 → 非 LustTravel2 UndeadSoul 问题

• 主机 log：Ready end turn (live ENet) netId=1000 出现在 strike began 与 finished 之间
• 根因：host-only SetReadyToEndTurn 不更新 client 本地 ready 集合；host 满足 AllPlayersReadyToEndTurn() 后进入 phase 1 + checksum 6，client 仍在 round 1 play phase
• 修复：PseudoCoopHostEnqueuePatch 使 PlayCard / EndPlayerTurn 以 action.OwnerId 广播；live ENet 改回 RequestEnqueue(EndPlayerTurnAction)；live ENet 跳过 host-only SetReadyToBeginEnemyTurn

• 主机 log：round 3 连续两条 Enqueued end turn netId=1000 round=3（EnsureHostDrivenPeersEndTurn + ReadySimulatedPeersToEndTurn 重叠）
• round 2：Enqueued end turn 出现在 strike began 与 finished 之间（in-flight / executing action 门控不足）
• 修复：postfix 仅 phantom 走 SetReadyToEndTurn；host-driven 统一 CanSignalEndTurn（pending + queued end turn + running player-driven action）

1. 两边重启并加载最新 DLL。
2. 主机 log：LAN host preset applied（DevPanel 手动点击后）。
3. 客机 log：AFK client enabled。
4. live ENet 路径应有 Enqueued end turn netId=1000；不应有 Ready end turn (live ENet)；同一 round 仅一条 end turn log。
5. desync 时对照 Enqueued end turn / phase log 与 Player 1000 playing 顺序（须在 finished execution 之后）。
6. UndeadSpirit 一致但 HP/牌堆不同 → 查 DevMode 时序；checksum 27 敌人回合末 UndeadSpirit 分叉 → LustTravel2 边界。

UndeadSoul 等 mod 字段在 LustTravel2 仓库维护。DevMode #7 修复后 round 1–2 已通过；round 3 checksum 27（After enemy turn end）出现 UndeadSpirit 14 vs 17，需在 LustTravel2 侧调查 HpOrb/UndeadSoul 同步。

• 进战斗 in-game toast 提示 AFK 已生效
• 单窗（非双开）手动测试时 UI 强提示「主机必须先开 LAN preset」

cd DevMode
make deploy   # build + 复制到游戏 mods/KitLib

修改 Harmony patch 或 MpAiTeammate 后必须 recompile，双实例均需重启。