真实在线运行画面与技术分层组合；当前为专业预览，商业 AAA 视觉仍待正式验收。

摘要｜玩家按下 W 只是一步，但要让另一个浏览器实时看到，还要支持昵称、公屏、掉线消失、进度保存、跨租户安装和固定网址升级，就需要 Unity、Microi.Unity、V8、SignalR、Redis、FormEngine、HDFS 与 Protocol v3 分层协作。

✦ ① 游戏帧循环与业务状态不是一回事

WASD、跳跃、普攻和镜头旋转必须在 Unity 本地即时响应。若每帧请求服务器，延迟、流量和写放大会一起出现。因此客户端只在固定节奏或动作变化时上报位置、朝向、动作、序列号等有业务含义的状态。

每帧本地渲染：输入 → CharacterController / Animator → 摄像机
低频语义同步：位置 + 朝向 + 动作 + sequence → V8 心跳
远端显示：最新快照 → 插值 → 其他玩家模型

边界｜真实截图证明在线可运行与交互布局，不替代人物、植被、地形和环境的正式 AAA 视觉验收。

✦ ② Microi.Unity 桥把 WebGL 放回租户体系

Unity 不硬编码 API 地址、租户名或管理员密钥。网页宿主读取当前上下文，把 ApiBaseUrl、OsClient、DiyToken 和设备标识通过受控桥接交给 WebGL；令牌刷新时再同步更新。游戏因此没有另建一套账号体系，权限与租户隔离仍服从吾码。

✦ ③ V8 接口引擎是游戏业务网关

业务原则：进入、心跳、改昵称、公屏聊天、进度保存、排行榜等规则都由 V8 接口引擎编排。它负责参数清洗、幂等、频率限制、速度边界、表情白名单与可审计返回；Unity 只消费稳定契约，不直接碰数据表。

var leaseKey = 'Microi:' + V8.OsClient + ':Unity:Presence:' + playerId;
V8.Cache.Set(leaseKey, JSON.stringify(snapshot), 10);
V8.RealtimeEvent = { Event: 'PresenceChanged', Data: snapshot };
return { Code: 1, Data: snapshot };

升级策略｜官方核心接口使用 Managed，租户扩展使用 CreateIfMissing，修复核心契约时不会覆盖客户已经接管的扩展脚本。

✦ ④ SignalR 负责快，快照负责稳

V8 SignalR 不是任何连接都可广播。连接先以 DiyToken 授权，再按租户与场景入组；心跳、聊天、昵称和动作经过 V8 校验后形成 RealtimeEvent。重连时同时返回 Redis 在线快照与最近消息，客户端先恢复基线，再接收增量事件。

• SignalR：低延迟广播。
• Redis 快照：掉线重连后的状态补偿。
• Unity 插值：把离散网络状态还原为平滑动作。

✦ ⑤ Redis 与 FormEngine 各做擅长的事

位置变化快、生命周期短，适合 Redis：每次有效心跳续租 10 秒，玩家掉线超过 10 秒后租约自然失效。聊天限流、消息去重和幂等键也放在这一层。聊天记录、桃花灵韵、存档、排行与运营统计需要长期查询，因此写入 FormEngine。

冷热分层｜公屏消息既走 SignalR 即时广播，也进入 FormEngine 供重连补齐与后台运营；进度保存使用幂等键避免网络重试重复累计。

✦ ⑥ 大文件不能靠一次上传赌成功

WebGL、纹理、音频和 Windows 安装包会迅速超过普通接口的舒适区。Protocol v3 使用分片、断点续传与逐文件 SHA-256，完成后生成不可变版本目录；新版本上线只移动当前版本指针。

1. 固定体验入口永远不带版本号。
2. 历史版本使用不可变只读目录。
3. 稳定壳向最终资源来源明确委托 fullscreen 权限。
4. 发布记录、哈希和公开回读分别验收。

✦ ⑦ 它是 AI 应用，不是平台菜单

桃源云梦包含 Web 前端、Unity 资源、V8 接口、Manifest 和资源策略，可进入 AI 应用列表并被其他租户安装升级，但不应给每个租户偷偷新增平台菜单。租户需要运营后台时，应在自己的应用扩展点显式启用。

✦ ⑧ 证据要拆开验收

本轮应用契约测试 26 / 26 通过，稳定入口构建测试 7 / 7 通过；真实浏览器触发全屏后没有再出现权限策略弹窗，控制台也没有相关异常。源码、测试、公开回读和视觉对比四类证据分别记录，互不替代。

结论｜Unity 守住手感，V8 守住业务，SignalR 守住实时，Redis 守住瞬时状态，FormEngine 守住可运营数据，Protocol v3 守住大文件发布。当前闭环可用；首屏拆包与商业 AAA 视觉仍是下一阶段的独立验收项。