开发日志 005：完成 v4.0 分层架构与对局体验收口

领域与智能体落地

v4.0 将游戏规则收敛到纯领域引擎：配置表负责人数与任务规则，角色注册表负责能力与视野，阶段处理器负责讨论、组队、投票、任务和刺杀，状态机负责统一流转与胜负判定。规则不再散落在页面和 AI 提示词中，非法操作会在进入下一阶段前被拒绝。

AI 侧改为按对局和座位持续存活的运行时。每次决策会感知游戏事件，读取局内工作记忆、Chroma 情节记忆、信念快照和 RAG 策略，再根据任务进入发言模型或推理模型。任务结果公布后，系统更新信任、阵营猜测和梅林概率，并将轮次摘要写回情节记忆，形成可持续的策略闭环。

信息边界与体验完善

API 使用玩家视角 DTO 过滤身份和任务失败票等隐藏信息，上帝视角改为单独端点提供完整推理与统计。前端则切换到 React + Zustand：对局状态以动态 setTimeout 链轮询，讨论与流式发言使用更快刷新频率；断连、会话恢复、软倒计时、发言余量、新手引导和复盘页面共同补齐真实试玩中的反馈缺口。

在 AI 表现上，系统补充了角色表演引导、反模板开场检查、规则事实卡、历史队伍事实注入与生成后纠错。坏人、梅林、派西维尔和忠臣拥有不同的策略提示，但最终动作仍需经过规则引擎校验。

分支上的质量收口

simplify 分支在 v4 主体完成后继续补齐了两类关键质量问题。第一类是 AI 事实一致性：规则事实卡和确定性历史模板随轮次注入，避免模型把错误摘要再次当作事实；对于自我点名、错误的组队人数质疑等输出，系统会进行有限次数的纠错重试。玩家视角也不再下发任务失败票数，防止通过失败数量反推队内身份。

第二类是实际试玩体验：新增新手引导、阶段提示、断连横幅、可回读的议事录、任务与投票历史、复盘关闭控制以及座位的本地信任标记。最后一轮体验调整还将讨论发言上限放宽为每人每轮三次、软倒计时调整为 180 秒，并补充梅林、派西维尔、莫甘娜和忠臣的角色打法提示及圆桌历史悬浮卡。

交付结果

本次重构完成后，代码从早期的多服务原型收敛为易于测试的分层应用：后端覆盖规则、Agent、API 与网关测试，前端完成 TypeScript 构建验证。项目形成了可进行完整对局、可观察 AI 推理、可复盘结果且不向玩家泄露隐藏信息的 AI 阿瓦隆平台，并以 v4.0 版本归档。