世界语义

# 世界语义

本文件定义“什么是真的”。数据库、网络协议和渲染器都必须遵守这里的语义,不能各自创造一套世界。

## 1. 世界

一个世界由以下权威信息组成:

```text
World
├── world_id
├── seed
├── epoch
├── clock
├── terrain_version
├── regions
├── active_environment_events
└── decay_ruleset_version
```

- `world_id`:世界的稳定标识。
- `seed`:程序化地形及确定性环境生成的根种子。
- `epoch`:世界时间的起点。
- `clock`:当前权威世界时间。
- `terrain_version`:地形生成算法版本。
- `regions`:空间分区。
- `active_environment_events`:风、雨等当前有效的环境事件。
- `decay_ruleset_version`:解释痕迹衰减的规则版本。

## 2. 权威世界时间

服务端时间是唯一权威时间。客户端不得直接以设备墙上时钟判断痕迹年龄。

客户端维护:

```text
estimated_world_time =
  last_server_world_time
  + monotonic_elapsed_since_sync
```

要求:

- 每次区域快照和重要服务端消息都携带 `server_time`。
- 客户端使用单调计时器计算同步后的经过时间。
- 设备系统时间变化不影响世界时间。
- 重连后立即以新快照校正,不播放“倒着恢复”的痕迹动画。
- 服务端重启后,世界时间继续前进,不因进程生命周期重置。

## 3. 空间与区域

世界被划分为区域,以限制同步和查询范围。

区域必须满足:

- 坐标系和边界在同一 `terrain_version` 内稳定;
- 相邻区域允许短暂重叠订阅,避免跨边界时痕迹突然出现或消失;
- 客户端只接收视野附近及预取范围内的数据;
- 区域只是工程分区,不应在画面中形成可见边界。

建议的权威坐标采用世界平面坐标:

```text
x: 东西方向
z: 南北方向
y: 由地形函数推导,痕迹事件通常不必保存
```

如果未来支持洞穴或垂直地形,再升级空间模型,不在 MVP 中提前复杂化。

## 4. 四类状态

### 4.1 永久世界配置

包括世界 seed、地形版本、区域划分和规则版本。它们很少变化,变化时必须产生新版本。

### 4.2 有限寿命事件

包括人的路径、动物经过和环境变化。它们是权威事实,但只在自己的生命周期内存在。

### 4.3 短暂在线状态

包括当前旅人的位置、朝向和连接状态。它只用于实时偶遇,会话结束后失效。

### 4.4 客户端派生状态

包括脚印透明度、边缘侵蚀、粒子、光照、LOD、镜头和动画状态。它们不写入权威存储。

## 5. 共同事实与个人表现

同一区域的观察者必须在语义上共享:

- 哪条路径曾经产生;
- 哪只动物何时经过;
- 哪段时间发生过强风;
- 某条痕迹是否仍处于可见生命周期。

不同设备可以在以下方面有所不同:

- 沙粒和粒子数量;
- 脚印网格精度;
- 阴影质量;
- 远处对象细节等级;
- 低性能设备上的动画采样率。

但不能出现一台设备判定痕迹已经被遗忘,另一台仍判定它有效的情况。

## 6. 动物语义

动物是共享但短暂的世界事件。

服务端或确定性世界调度器决定:

```text
哪种动物
在什么时间
从哪个区域
沿哪条路径
经过多久
留下哪种痕迹
```

客户端负责:

- 按共享路径播放动物运动;
- 根据物种步态生成足迹;
- 按相同时间轴显示或隐藏动物;
- 在动物离开后继续渲染尚未消失的足迹。

不得由每个客户端独立随机生成共享动物,否则多人在同一地点会看到不同世界。

## 7. 人类旅人语义

- 用户输入首先是移动意图,不是权威位置。
- 服务端验证并接受路径片段后,该片段才成为共享事实。
- 实时位置可以低频同步;痕迹路径应按连续片段提交。
- 公开协议只提供短期 `presence_id`,不提供稳定用户标识。
- 断线后,实时存在立即或短暂超时后消失;已被接受的脚印继续按规则衰减。

## 8. 环境事件

风和雨等环境变化以有时间范围的事件表达,而不是逐个修改脚印。

```text
EnvironmentEvent
├── event_id
├── region_id
├── kind
├── starts_at
├── ends_at
├── intensity
├── direction(可选)
└── ruleset_version
```

痕迹状态由其生命周期与覆盖该时间区间的环境事件共同决定。

## 9. 规则版本

事件必须记录创建时适用的规则版本,避免部署新算法后让历史痕迹突然恢复或提前消失。

规则升级原则:

- 新事件使用新版本;
- 尚未过期的旧事件继续使用旧版本解释;
- 不对旧事件批量改写;
- 所有旧版本必须至少保留到使用它们的最后一条事件被清理。

## 10. 确定性边界

必须确定性一致的部分:

- 生命周期阶段;
- 是否可见;
- 是否可以清理;
- 动物经过的时空路径;
- 规则版本选择。

允许非确定性或设备差异的部分:

- 粒子细节;
- 沙纹微扰;
- 不影响事实判断的视觉噪声;
- 音频混合中的轻微变化。