痕迹是世界对一次经过的短暂记忆。系统保存路径事件及时间,不保存脚印最终像素。
1. 核心对象
Trace
一段连续活动形成的逻辑痕迹。
Trace
├── trace_id
├── origin
├── world_id
├── started_at
├── last_segment_at
└── status
TraceSegment
为了上传、同步和区域查询而切分的一小段连续路径。
TraceSegment
├── schema_version
├── event_type
├── event_id
├── trace_id
├── segment_id
├── world_id
├── region_id
├── origin
├── started_at
├── ended_at
├── points
├── surface
├── initial_strength
├── decay_profile
└── ruleset_version
TracePoint
路径中的采样点,不等于一枚具体脚印。
TracePoint
├── offset_ms
├── x
├── z
├── heading
└── strength(可选)
客户端根据路径、物种、步幅和地形,生成具体左右脚或爪印。
2. 为什么保存路径片段
不把每枚脚印作为独立事件,原因包括:
- 降低消息和存储数量;
- 保留连续运动语义;
- 允许不同设备使用不同渲染精度;
- 不把当前脚印 mesh 固化进协议;
- 便于验证速度、连续性和区域边界;
- 允许在生命周期内重建同一条路径。
3. 来源
origin.kind 的 MVP 值:
human
animal
未来可以增加 environment,但环境造成的大面积变化优先使用环境事件,而不是伪造大量痕迹点。
示例:
{
"kind": "animal",
"variant": "desert_fox"
}
不得在发送给其他用户的 origin 中包含稳定账户 ID。
4. 示例事件
{
"schema_version": 1,
"event_type": "trace.segment.created",
"event_id": "evt_01J...",
"world_id": "desert_main",
"region_id": "region_12_08",
"trace_id": "trace_01J...",
"segment_id": "segment_01J...",
"origin": {
"kind": "human",
"variant": "walker"
},
"started_at": "2026-10-21T00:00:00.000Z",
"ended_at": "2026-10-21T00:00:04.200Z",
"points": [
{
"offset_ms": 0,
"x": 182.4,
"z": 76.1,
"heading": 1.82,
"strength": 0.91
},
{
"offset_ms": 740,
"x": 182.8,
"z": 76.6,
"heading": 1.84,
"strength": 0.89
}
],
"surface": "fine_dry_sand",
"initial_strength": 0.91,
"decay_profile": "human_footprint_v1",
"ruleset_version": "desert_decay_v1"
}
5. 时间语义
started_at和ended_at使用服务端校正后的世界时间。offset_ms相对started_at,避免每个点重复完整时间戳。- 客户端提交的时间只是候选值,服务端可以校正或拒绝。
ended_at必须不早于started_at。- 相邻片段允许少量时间重叠用于去抖,但服务端必须去重。
6. 衰减模型
当前视觉状态由以下函数决定:
trace_state = decay(
trace_age,
initial_strength,
surface,
overlapping_environment_events,
decay_profile,
ruleset_version
)
规范输出至少包含:
phase: fresh | softening | fading | forgotten
visible: boolean
purge_eligible: boolean
normalized_life: 0..1
渲染器可以再根据 normalized_life 推导深度、颜色、边缘侵蚀和透明度。
7. 标准生命周期
profile: human_footprint_v1
phases:
fresh:
range: [0.0, 0.15]
softening:
range: [0.15, 0.65]
fading:
range: [0.65, 1.0]
forgotten:
after: 1.0
这里的数值是标准化生命周期,不是分钟。实际寿命由世界参数决定:
lifetime =
base_lifetime
× surface_factor
× strength_factor
× weather_factor
MVP 可以使用简单分段曲线,但输入、阶段和清理判断必须稳定。
8. 环境影响
风不修改每个脚印事件。系统查询痕迹生命周期内覆盖该区域的环境事件,再计算加速衰减。
要求:
- 同一环境事件不能被重复计入;
- 环境事件结束后仍保留到受其影响的痕迹全部过期;
- 规则版本必须说明多个环境事件如何叠加;
- 强风可以缩短剩余寿命,但不能让客户端和服务端产生不同的
forgotten判断。
9. 服务端验证
服务端接受人类路径片段前至少检查:
- 消息大小和点数上限;
- 时间范围是否合法;
- 速度和转向是否在允许范围;
- 路径是否连续;
- 是否跨越不可达区域;
client_segment_id是否重复;- 会话是否有权在该区域提交;
- 坐标和数值是否有限且非 NaN。
验证目的是保护共享空间,避免恶意客户端瞬间画满整片沙漠,而不是建立竞技反作弊系统。
10. 明确不保存的字段
以下字段不得进入权威痕迹记录:
opacity
blur_radius
mesh_id
texture_id
particle_state
animation_progress
current_pixel_mask
client_camera
render_lod
如果某个功能要求保存这些字段,应先证明它为什么不能由路径、时间和规则推导。