漢更新日志 CHANGELOG
V0.0.4 2026-07-22
- 🚪 房间生命周期：等待或已结束阶段断线、以及主动返回大厅时会退出房间，自动释放房主权限并移除房主添加的 AI。
- 👤 单账号单房间：同一账号同时只能进入一个房间，多浏览器或多页签重复进入会被服务端拒绝。
- ⏳ 累计重连时间：每名真人选手每局共有 5 分钟重连时间，多次掉线累计扣减；掉线期间普通棋钟继续运行，任一时间先耗尽均按完败结算。
- 🔁 大厅快捷重连：断线选手仍占用原房间座位时，从大厅点击该房间会直接重连，不再显示身份选择；其他账号的进入流程保持不变。
- 🧩 房间三栏布局：选手、计时、棋局设置和操作集中在左侧，棋盘保持居中，对局状态、观众和聊天集中在右侧；窄屏自动纵向排列。
- 🧾 日志栏精简：右侧日志固定在房间布局内并支持纵向滚动；不再逐步记录每一步走棋，仅保留聊天、房间事件和关键对局告警。
- 📖 更新日志独立页签：从大厅或房间查看更新日志时在新页签打开，原页面及 WebSocket 房间连接保持不变。
V0.0.3-alpha 2026-07-21
- 🪑 无颜色入座：等待阶段改为房主选手与对手选手两个座位，不再提前选择红绿阵营。
- 🔄 首局随机与连续轮换：固定两名选手首次开局随机决定绿方先手，双方未离座时后续每局自动交换阵营；换座后重新随机。
- ♟️ 顺序摆子：红方后手先选择并公开象马阵型，绿方看到红方阵型后再选择；双方完成后才启动棋钟。
- 🔢 剩余棋子分：实时显示车 13、炮 7、马 5、象 3、士 3、兵 2 的剩余分值，红方带 1.5 分补偿。
- 🤝 求和与比赛积分：新增 15 秒求和协商；计分和棋按剩余棋子分区分和胜/和败。完胜 3 分、和胜 2 分、和败 1 分、完败 0 分。
- ⚔️ 老将对脸三选一：对脸方只能移动老将、落子遮挡，或点击双方老将触发飞将计分和棋；服务端与 AI 均执行相同校验。
- 🚦 总步数上限：房主可配置总步数（默认 150 步），最后 10 步逐步预警；到达上限后按剩余棋子分结算。
- 🧭 棋盘视角：绿方选手始终绿方在下、红方选手始终红方在下；观战者可随时翻转并保存本地偏好。
- 💾 幂等结算：所有终局统一结算，对局结果与本地比赛积分在同一事务中写入，重复终局不会重复加分。
- 🔒 并发与重连：每个房间使用独立异步锁；摆子或对局中的登录选手临时断线保留座位，不会打乱下一局阵营轮换。
V0.0.2-alpha 2026-07-16
- 🏛️ 多人联机大厅：从单机单局升级为 20 间在线房间的大厅，实时展示各房状态、对局双方与观战人数。
- 🪑 入座与观战：可选择执楚（绿）/执汉（红）入座，或作为观众观战；进入房间时弹窗选择身份。
- 👑 房主管理：房主可调整房间配置、踢人/拉黑、添加或移除电脑 AI；房主离开后自动移交给其他玩家。
- 🤖 AI 难度真正生效：接入引擎 Skill Level（0–20），四档难度对应不同棋力（此前仅思考时间不同）。
- 🔄 观众替代 AI：观战者可申请接替某一方的电脑 AI，经房主同意后入座续战。
- ♟️ 摆子阶段：开局进入摆子环节，双方各自从四种阵型（默认 / 左换 / 右换 / 双换）中独立选择。
- ↩️ 悔棋协商：走子后可请求悔棋，需对方同意；支持「本局内不再接受悔棋」；请求 15 秒无响应自动拒绝。
- 💬 房间聊天：新增房内实时聊天与系统提示消息（走子、入座、认输等广播）。
- ⏱️ 计时改为读秒制：分「总用时」和「步时读秒」两阶段——总用时耗尽后进入读秒，每步限时一个步时；超一个步时即消耗一次「步时次数」，用尽自动判负（可多次读秒，取代原增秒制）。新增「步时次数」配置。
- 🐛 修复计时配置不生效：此前把总用时设为 60 秒以下会导致整条配置被忽略、静默回退默认 15 分钟；现已修复并放开总用时下限（最低 10 秒），配置发送前自动钳制到合法范围。
- 🕐 时钟显示优化：读秒阶段时钟显示为
读秒 Ns ×次数 并高亮提示，总用时阶段显示 分:秒。
- 💾 对局落库：对局与每一步棋持久化到数据库，认输 / 超时 / 绝杀等终局结果一并记录。
- 🔧 终局判定修复：修正胜负 / 困毙判定的引擎调用方式，避免误判。
- 🚫 规则计时修复：非法走子不再白扣时间与重置回合计时（改为先校验合法性再落时）；对局自第一手起即开始计时。
- 🔌 断线与多端：支持同一账号多连接，断线后自动清理房间内的座位 / 观战状态。
- 🔗 登录回跳原房间：带房间链接登录后可回到原房间；房间内不再因切换后台 / 页面恢复被强制重新登录。
- 🖼️ 前端稳定性：修复棋盘棋子图片在子路径下加载失败、优化点击判定容差与将 / 帅选中高亮；页面刷新与深链不再 404。
- 🚀 构建优化：引擎二进制下载改为可缓存方式，避免每次构建重复下载。
V0.0.1-alpha 2026-07-14
- ✨ 首次公开测试版发布
- ♟️ 核心对战：完成基础的棋盘渲染、走子规则校验，支持标准的朝鲜象棋（Janggi）变体规则。
- 🤖 人机对战 (PVE)：接入强大的 Fairy-Stockfish NNUE 引擎，支持人机对战。
- ⚙️ 开局配置：支持楚汉摆子（象马互换），四种标准阵型（默认、左换、右换、双换）均可选择。
- 🧠 难度分级：新增四档 AI 难度选择（简单、普通、困难、大师），对应引擎不同的极限思考时间。
- 🔧 系统优化：修复了前端走棋动画与网络断开连接状态可能存在的并发状态覆盖 Bug。
- 🚀 性能调优：针对轻量云服务器进行了极致的 Docker 内存与 MySQL 性能优化，杜绝高负载 OOM。