$npx -y skills add HOBOBO/AbilityKit --skill host-extensionAbilityKit Host 扩展包(com.abilitykit.host.extension)——含 5 个 IHostRuntimeModule(FrameSyncDriverModule/ClientPredictionDriverModule/ServerFrameTimeModule/WorldAutoStartModule/ServerRollbackModule)、Client/Server/FrameSync/CatchUp/Rollback/Time/WorldStart/Session 子系统、Moba 子树(Runtime/Ro
| 1 | # host-extension skill |
| 2 | |
| 3 | 基于源码核校(2026-07-20)。`com.abilitykit.host.extension` 包根:`Unity/Packages/com.abilitykit.host.extension/`,version `0.0.1`。 |
| 4 | |
| 5 | ## 包结构(7 个 asmdef) |
| 6 | |
| 7 | ``` |
| 8 | com.abilitykit.host.extension/ |
| 9 | ├── Runtime/ |
| 10 | │ ├── com.abilitykit.host.extension.asmdef [Host.Extensions](根,autoReferenced=true) |
| 11 | │ ├── FrameSync/ 共享层(Driver/Module/接口/CatchUp) |
| 12 | │ ├── Client/ [Host.Extensions.Client] |
| 13 | │ │ ├── FrameSync/ 客户端预测 generic primitives |
| 14 | │ │ └── StateSync/ RemoteClientInputSubmitQueue |
| 15 | │ ├── Server/ [Host.Extensions.Server] |
| 16 | │ │ ├── BattleHost/ BattleHost 生命周期 + tick/buffer/scheduler/snapshot/observer |
| 17 | │ │ └── FrameSync/CatchUp/ InMemoryFrameSyncInputHistory |
| 18 | │ ├── Rollback/ ServerRollbackModule |
| 19 | │ ├── Time/ FixedStepTickRunner + ServerFrameTimeModule |
| 20 | │ ├── WorldStart/ WorldAutoStartModule + IWorldAutoStartHandler |
| 21 | │ ├── Session/ RoomGatewaySessionFlow(8 阶段)+ FramePacketNetAdapter |
| 22 | │ └── Moba/ 三个 asmdef(Client/Server/Shared) |
| 23 | │ ├── Shared/ [Host.Extensions.Moba](依赖 Protocol.Moba) |
| 24 | │ ├── Client/ [Host.Extensions.Moba.Client] |
| 25 | │ └── Server/ [Host.Extensions.Moba.Server] |
| 26 | ├── Example/ LogicWorldServerExample(仅示例,不是框架类) |
| 27 | └── Document/ 设计文档 |
| 28 | ``` |
| 29 | |
| 30 | ## 5 个 IHostRuntimeModule(包核心) |
| 31 | |
| 32 | | Module | 文件 | 关键依赖 | |
| 33 | |--------|------|---------| |
| 34 | | `FrameSyncDriverModule` | `Runtime/FrameSync/FrameSyncDriverModule.cs` | 服务端帧同步权威驱动 | |
| 35 | | `ClientPredictionDriverModule` | `Runtime/FrameSync/ClientPredictionDriverModule.cs` | 客户端预测 + 回滚 + 对账 | |
| 36 | | `ServerFrameTimeModule` | `Runtime/Time/ServerFrameTimeModule.cs` | 弱依赖 IFrameSyncDriverEvents | |
| 37 | | `WorldAutoStartModule` | `Runtime/WorldStart/WorldAutoStartModule.cs` | world 自启 | |
| 38 | | `ServerRollbackModule` | `Runtime/Rollback/ServerRollbackModule.cs` | **强依赖** IFrameSyncDriverEvents | |
| 39 | |
| 40 | **安装顺序**(源码验证):`FrameSync → ServerFrameTime → WorldAutoStart → Rollback`(`MobaHostRuntimeBuilder.CreateModules` 实现)。 |
| 41 | |
| 42 | ## Sections |
| 43 | |
| 44 | - [host_modules.md](host_modules.md) — 5 个 IHostRuntimeModule + 顺序约束 |
| 45 | - [client_prediction.md](client_prediction.md) — ClientPredictionDriverModule + 配置接口(含新 IClientPredictionReconcileControl) |
| 46 | - [server_battlehost.md](server_battlehost.md) — BattleHost 生命周期 + tick/buffer/scheduler/snapshot/observer |
| 47 | - [catchup.md](catchup.md) — CatchUp 子系统 + WorldCatchUpDriver + 客户端 WorldStartFrameCatchUpCalculator |
| 48 | - [client_helpers.md](client_helpers.md) — ClientPredictionInputHistory / ReconciliationCoordinator / RemoteClientInputSubmitQueue / FramePacketNetAdapter |
| 49 | - [time_worldstart.md](time_worldstart.md) — FixedStepTickRunner + ServerFrameTimeModule + WorldAutoStartModule |
| 50 | - [session_flow.md](session_flow.md) — RoomGatewaySessionFlow 8 阶段 + FramePacketNetAdapter |
| 51 | - [moba_runtime.md](moba_runtime.md) — MobaHostRuntimeBuilder + IMobaBattleRuntimePort + MobaGameStartPort |
| 52 | - [moba_startsource.md](moba_startsource.md) — GameStartSource 路由(3 Source + Router) |
| 53 | - [moba_room.md](moba_room.md) — MobaRoomState + MobaRoomOrchestrator + 命令应用 |
| 54 | - [moba_roomsync.md](moba_roomsync.md) — Client/Server RoomSync + Outbox + Broadcaster |
| 55 | - [moba_startgame.md](moba_startgame.md) — MobaGameStartOrchestrator + IMobaServerGameLifecycle + WorldAutoStartHandler |
| 56 | - [moba_createworld.md](moba_createworld.md) — CreateWorld 数据模型(Spec/Plan/LaunchSpec/SimulationLaunchPlan) |
| 57 | |
| 58 | ## 相关 skill |
| 59 | |
| 60 | - 完整技能/触发/BUFF 见 [ability-kit](../ability-kit/SKILL.md) |
| 61 | - 客户端预测深度排查见 [framesync-prediction-rollback](../framesync-prediction-rollback/SKILL.md) |
| 62 | - 会话协调器见 [coordinator](../coordinator/SKILL.md) |
| 63 | - moba demo 见 [moba-demo](../moba-demo/SKILL.md) |