本文件描述满足世界语义的最小系统结构,不绑定具体云厂商。
1. 总体结构
浏览器客户端
├── 地形与光照渲染
├── 痕迹派生与衰减
├── 输入采样与路径分段
├── 动物动画
└── 实时连接
│
▼
世界网关 / 实时服务
├── 会话与短期 presence
├── 区域订阅
├── 命令验证
├── 事件广播
└── 服务端时间
│
├────────► 世界调度器
│ ├── 动物经过
│ └── 环境事件
│
▼
有限寿命事件存储
├── 痕迹片段
├── 动物路径
├── 环境事件
└── 空间与过期索引
│
▼
清理任务
├── 删除过期索引
├── 删除事件
└── 失效区域缓存
2. 浏览器客户端
职责:
- 根据世界 seed 和地形版本生成可见地形;
- 维护经服务端校正的世界时间;
- 将用户移动采样为连续路径片段;
- 根据权威事件和规则派生脚印状态;
- 播放共享动物事件;
- 对低频 presence 更新进行插值;
- 在性能不足时降低视觉精度,不改变事实判断。
客户端不得:
- 宣布自己的路径已经成为共享事实;
- 使用设备时间决定权威生命周期;
- 永久保存其他人的轨迹;
- 独立随机生成应被多人共同看见的动物。
3. 世界网关与实时服务
职责:
- 建立匿名短期会话;
- 返回权威世界时间;
- 管理区域订阅;
- 验证路径命令;
- 为接受的片段生成权威事件;
- 广播区域增量事件;
- 维护短期 presence;
- 对重复
client_message_id提供幂等响应。
该服务不需要竞技游戏级帧同步。重点是:
- 路径最终一致;
- 偶遇位置足够平滑;
- 同一事件的时间语义一致;
- 断线重连不会制造重复脚印。
4. 世界调度器
世界调度器负责低频共享事件:
- 动物何时、在哪里经过;
- 环境风力何时变化;
- 事件使用哪套规则版本。
调度器生成事件,不直接生成最终画面。
MVP 可以使用单进程定时任务,但输出必须走与正式服务相同的事件模型,不能在前端写一套临时随机逻辑。
5. 事件存储
MVP 需要的能力:
- 按
event_id幂等写入; - 按区域和时间查询仍有效事件;
- 按
purge_after批量清理; - 支持路径片段的空间索引;
- 不要求永久事件溯源。
逻辑索引:
by_event_id
by_region_and_render_expiry
by_purge_after
by_trace_id_and_time
by_trace_id_and_time 只服务片段连续性和生命周期内重建,不得扩展为跨会话用户历史。
6. 技术选型建议
客户端
优先:
- TypeScript;
- Three.js 或 React Three Fiber;
- WebGL,后续再评估 WebGPU;
- Web Worker 处理路径采样和衰减批计算。
服务端
MVP 可选择熟悉的单体服务:
- Go、Rust、TypeScript 或 Python 均可;
- HTTP 提供快照;
- WebSocket 提供实时事件;
- 单进程调度器产生动物和风事件。
存储
第一版不必引入复杂流处理系统。可以使用:
- PostgreSQL 加空间索引;或
- SQLite 作为单机原型,外加明确的区域和过期索引。
当连接规模证明需要扩展时,再拆分实时网关和事件存储。
7. 路径采样
路径采样需要同时满足:
- 视觉连续;
- 消息量可控;
- 服务端可验证;
- 不依赖具体脚印模型。
建议流程:
高频读取本地移动
→ 距离/时间阈值降采样
→ 形成短路径片段
→ 提交服务端
→ 本地先显示候选痕迹
→ 收到确认后转为权威痕迹
→ 被拒绝时平滑移除候选痕迹
候选痕迹只能存在于当前客户端,不能广播给别人。
8. 衰减计算
客户端和服务端共享同一语义实现或同一组测试向量。
- 客户端计算视觉阶段和参数;
- 服务端计算是否应进入快照、是否可以清理;
- 两端必须对
visible、phase和purge_eligible达成一致; - 浮点视觉参数允许小误差;
- 不允许生命周期边界发生分歧。
9. 区域快照与增量
进入区域时:
- 客户端请求区域快照;
- 服务端按当前世界时间过滤过期事件;
- 客户端构建当前可见痕迹;
- WebSocket 继续接收快照版本之后的增量事件;
- 离开区域后取消订阅并释放派生渲染对象。
跨区域时允许短暂双订阅,避免路径和动物在边界跳变。
10. 故障处理
客户端休眠
恢复后先校时和取增量;如果中断过久,直接重取快照,不从旧动画进度继续。
服务端重启
- presence 可以丢失并重新建立;
- 已接受的路径事件不能丢失;
- 世界时间不能重置;
- 调度器不得重复产生相同动物事件。
数据库暂时不可用
- 不得先广播后落库;
- 路径提交返回可重试错误;
- 客户端可以短暂保留候选痕迹,但不能把它当共享事实。
11. 安全边界
至少限制:
- 单条消息大小;
- 路径点数量;
- 提交频率;
- 合法坐标范围;
- 速度和转向;
- 区域订阅数量;
- WebSocket 空闲连接时间。
不得因为反滥用而建立永久用户轨迹。安全数据和作品数据必须分库存储或至少逻辑隔离,并使用独立保留期。
12. 可观测性
记录聚合指标:
活跃连接数
区域订阅数
路径提交数与拒绝率
消息大小分布
快照生成耗时
事件存储延迟
过期事件清理数量
客户端性能档位
不记录完整真实路径 payload。
13. 演进原则
先保持单体和少量明确模块。只有出现真实瓶颈时才拆分:
- 实时连接成为瓶颈,再拆网关;
- 空间查询成为瓶颈,再升级存储;
- 调度规模扩大,再拆世界调度器;
- 不为假设中的百万并发提前引入事件总线、微服务和多区域一致性。