更新示例代码

Author: hobobo

Docs/design/07-NetworkSynchronization/04-ReplaySystem.md

@@ -1,6 +1,6 @@
 # 04-回放系统
 
-> 回放系统负责把“已经发生过的战斗/模拟过程”稳定地记录下来，并在后续以可控速度、可寻址方式重新播放。AbilityKit 里它不是单一实现，而是由通用记录容器、事件轨道、回放控制器、锁步文件格式以及 Demo 侧的回放录制/播放器共同组成。
+> 回放系统负责把“已经发生过的战斗/模拟过程”稳定地记录下来，并在后续以可控速度、可寻址方式重新播放。AbilityKit 里它不是单一实现，而是由通用记录容器、事件轨道、回放控制器、按帧记录文件格式以及 Demo 侧的回放录制/播放器共同组成。
 
 ## 1. 能力定位
 
@@ -28,7 +28,7 @@
 | 会话封装 | 统一管理容器、序列化器与轨道工厂 | [`RecordSession`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/Core/Session/RecordSession.cs:5)、[`IRecordSession`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/Core/Session/IRecordSession.cs:5) |
 | 回放控制 | 以固定步长推进事件消费 | [`BasicReplayController`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/Core/Replay/BasicReplayController.cs:6)、[`IReplayClock`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/Core/Replay/IReplayClock.cs:5) |
 | 事件分发 | 将通用事件解码为 typed 回调 | [`TypedReplayEventHandler`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/Adapters/Replay/TypedReplayEventHandler.cs:9) |
-| 锁步录制/回放 | 把输入、状态哈希、快照写入锁步文件并反向读取 | [`LockstepFrameRecordSink`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/Lockstep/LockstepFrameRecordSink.cs:7)、[`LockstepInputRecordReplaySource`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/Lockstep/LockstepInputRecordReplaySource.cs:10) |
+| 按帧录制/回放 | 把输入、状态哈希、快照写入按帧记录文件并反向读取 | [`FrameRecordSink`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/FrameRecord/FrameRecordSink.cs:7)、[`FrameRecordReplaySource`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/FrameRecord/FrameRecordReplaySource.cs:10) |
 | Demo 回放 | 为 MOBA 提供独立的二进制回放文件录制与播放 | [`ReplayRecorder`](../../../Unity/Packages/com.abilitykit.demo.moba.share/Runtime/Game/Flow/Battle/Replay/ReplayRecorder.cs:11)、[`ReplayPlayer`](../../../Unity/Packages/com.abilitykit.demo.moba.share/Runtime/Game/Flow/Battle/Replay/ReplayPlayer.cs:11) |
 
 ---
@@ -186,11 +186,11 @@ sequenceDiagram
 
 ---
 
-## 6. 锁步录制与回放源
+## 6. 按帧录制与回放源
 
 ### 6.1 录制出口
 
-[`LockstepFrameRecordSink`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/Lockstep/LockstepFrameRecordSink.cs:7) 负责把运行中的锁步数据写入底层 writer：
+[`FrameRecordSink`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/FrameRecord/FrameRecordSink.cs:7) 负责把运行中的按帧数据写入底层 writer：
 
 - `AppendInput`：记录输入。
 - `AppendStateHash`：记录状态哈希。
@@ -200,9 +200,9 @@ sequenceDiagram
 
 ### 6.2 文件/源结构
 
-[`LockstepInputRecordFile`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/Lockstep/LockstepInputRecordFile.cs) 定义了锁步回放文件的元数据、输入帧、状态哈希帧、快照帧和索引块。
+[`FrameRecordFile`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/FrameRecord/FrameRecordFile.cs) 定义了按帧回放文件的元数据、输入帧、状态哈希帧、快照帧和索引块。
 
-[`LockstepInputRecordReplaySource`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/Lockstep/LockstepInputRecordReplaySource.cs:10) 则把该文件反向整理为按帧查询的数据源：
+[`FrameRecordReplaySource`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/FrameRecord/FrameRecordReplaySource.cs:10) 则把该文件反向整理为按帧查询的数据源：
 
 - `TryGetInputs(FrameIndex frame, out IReadOnlyList<PlayerInputCommand> inputs)`
 - `TryGetSnapshots(FrameIndex frame, out IReadOnlyList<WorldStateSnapshot> snapshots)`
@@ -213,8 +213,8 @@ sequenceDiagram
 
 ```mermaid
 flowchart TB
-    Writer[LockstepFrameRecordSink] --> File[LockstepInputRecordFile]
-    File --> ReplaySource[LockstepInputRecordReplaySource]
+    Writer[FrameRecordSink] --> File[FrameRecordFile]
+    File --> ReplaySource[FrameRecordReplaySource]
     ReplaySource --> Inputs[输入查询]
     ReplaySource --> Snapshots[快照查询]
     ReplaySource --> Hashes[哈希查询]
@@ -270,7 +270,7 @@ MOBA Demo 还实现了一套独立的二进制回放格式，用于战斗回放
 ```mermaid
 sequenceDiagram
     participant Runtime as 战斗运行时
-    participant Sink as LockstepFrameRecordSink
+    participant Sink as FrameRecordSink
     participant Writer as 底层写入器
     participant Session as RecordSession
 
@@ -312,10 +312,10 @@ sequenceDiagram
 - [`BasicReplayController`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/Core/Replay/BasicReplayController.cs:6)
 - [`TypedReplayEventHandler`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/Adapters/Replay/TypedReplayEventHandler.cs:9)
 
-### 锁步与文件回放
+### 按帧记录与文件回放
 
-- [`LockstepFrameRecordSink`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/Lockstep/LockstepFrameRecordSink.cs:7)
-- [`LockstepInputRecordReplaySource`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/Lockstep/LockstepInputRecordReplaySource.cs:10)
+- [`FrameRecordSink`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/FrameRecord/FrameRecordSink.cs:7)
+- [`FrameRecordReplaySource`](../../../Unity/Packages/com.abilitykit.record/Runtime/Record/FrameRecord/FrameRecordReplaySource.cs:10)
 
 ### Demo 二进制回放
 
@@ -329,6 +329,6 @@ sequenceDiagram
 回放系统在 AbilityKit 里有两个层次：
 
 - **通用层**：以 `RecordContainer`、`RecordSession`、`BasicReplayController` 为核心，适合抽象化记录与回放。
-- **业务层**：以锁步文件与 Demo 二进制回放为核心，适合战斗调试、问题复现和产品功能落地。
+- **业务层**：以按帧记录文件与 Demo 二进制回放为核心，适合战斗调试、问题复现和产品功能落地。
 
 两者共享“按帧组织历史数据”的思想，但在文件结构、序列化方式和调用者角色上各自独立。

Docs/design/08-GameplayModules/00-GameplayCapabilityMap.md

@@ -374,7 +374,7 @@ Record 模块不是玩法层的一部分，但它是玩法问题复现和确定
 | BasicReplayController | `Unity/Packages/com.abilitykit.record/Runtime/Record/Core/Replay/BasicReplayController.cs` | 按 ReplayClock 消费指定帧事件并交给 handler |
 | RecordContainer | `Unity/Packages/com.abilitykit.record/Runtime/Record/Core/Container/RecordContainer.cs` | 记录容器 |
 | EventTrack | `Unity/Packages/com.abilitykit.record/Runtime/Record/Core/Tracks/EventTrack.cs` | 事件轨道 |
-| LockstepFrameRecordSink | `Unity/Packages/com.abilitykit.record/Runtime/Record/Lockstep/LockstepFrameRecordSink.cs` | 帧同步输入记录 |
+| FrameRecordSink | `Unity/Packages/com.abilitykit.record/Runtime/Record/FrameRecord/FrameRecordSink.cs` | 按帧输入记录 |
 
 回放 Tick 流程：