更新日志

本文件记录项目的重要变更。

格式参考 Keep a Changelog， 版本号遵循 语义化版本。

[1.0.2] - 2026-08-20

修复

• 多人大厅各端人数 / 准备状态不一致；加入方人数以主机房间快照为准，不再用座位号推算
• 多人局域网联机时，同伴玩家映射不正确
• Ready / 心跳携带座位号，主机可按座位重绑对端端口（NAT 换端口或重连），避免误踢与人数错乱
• 拒绝空主机地址（如 :37241）以及保留端口 65535（Fusion 使用监听端口 +1）
• 加入方填写 IP:端口 时，同步监听端口与加入端口，避免大厅能进但对局连错端口
• 配置里只改监听端口或加入端口时，两侧强制保持一致
• 主机离开或对局重置时清除「对局进行中」状态，避免卡在等待开局界面
• 对局已开始后仍尝试加入时，明确提示「对局已开始」，而不再干等到连接超时
• 大厅内约 45 秒无心跳的死连接会被踢出，避免占坑导致无法全员准备
• 加入方大厅 Ready 保活不依赖游戏主循环；切出或短暂卡顿时仍发送，避免被主机误踢（界面显示 host left）
• 启动时开启 Application.runInBackground，避免切出游戏后主循环暂停导致大厅联机包无法收发
• 开局时可能未使用主机在大厅已选存档，存在误进其他存档或覆盖进度的风险
• 没有已有存档时，按解析结果新建存档槽，不再固定为槽位 0
• 存档界面点「返回」时，不再重复叠加取消监听

变更

• 姿态数据按座位分别存储与转发，不再被最后写入的玩家覆盖
• 「客户端已准备」表示任意已入座的非房主已准备，不再只检查 2 人局里的加入方
• 对局进行中不再清理空闲 UDP 座位，仅在大厅阶段踢出失联玩家
• 降低协议发送时的临时内存分配，减轻卡顿
• 缓存主菜单对象，避免每帧全场景查找
• Fusion 云服旁路每帧只执行一次；客户端启动连接后再补一次
• 每帧最多处理 64 个 UDP 包，并优先处理连接 / 准备 / 开局 / 离开等控制包

移除

• 已无实际作用的 UDP 释放占位接口，以及从未使用的探测序号字段

[1.0.1]

变更

• 说明文档：补充异地组网说明与推荐工具；澄清默认只需填写 IP

[1.0.0]

新增

• 首次公开发布
• 通过「局域网联机」支持局域网 / VPN IP 合作（房间 UDP + Fusion 直连）
• 原生菜单；按 IP 创建 / 加入；准备同步；进入合作对局