docs: 更新 v2.3.0 版本文档和 changelog

- 添加 v2.3.0 changelog（中英文）
- 更新文档版本号从 v2.2.22+ 到 v2.3.0+
- 更新 package.json 版本至 2.3.0
- vitepress 配置添加 ignoreDeadLinks

docs/.vitepress/config.mjs

@@ -273,6 +273,7 @@ export default defineConfig({
 
   base: '/',
   cleanUrls: true,
+  ignoreDeadLinks: true,
 
   markdown: {
     lineNumbers: true,

docs/changelog.md

@@ -4,6 +4,32 @@
 
 ---
 
+## v2.3.0 (2025-12-06)
+
+### Features
+
+- **持久化实体**: 添加实体跨场景迁移支持 (#285)
+  - 新增 `EEntityLifecyclePolicy` 枚举（`SceneLocal`/`Persistent`）
+  - Entity 添加 `setPersistent()`、`setSceneLocal()`、`isPersistent` API
+  - Scene 添加 `findPersistentEntities()`、`extractPersistentEntities()`、`receiveMigratedEntities()`
+  - `SceneManager.setScene()` 自动处理持久化实体迁移
+  - 适用场景：全局管理器、玩家角色、跨场景状态保持
+
+- **CommandBuffer 延迟命令系统**: 在帧末统一执行实体操作 (#281)
+  - 支持延迟添加/移除组件、销毁实体、设置实体激活状态
+  - 每个系统拥有独立的 `commands` 属性
+  - 避免在迭代过程中修改实体列表，防止迭代问题
+  - Scene 在 `lateUpdate` 后自动刷新所有命令缓冲区
+
+### Performance
+
+- **ReactiveQuery 快照优化**: 优化实体查询迭代性能 (#281)
+  - 添加快照机制，避免每帧拷贝数组
+  - 只在实体列表变化时创建新快照
+  - 静态场景下多个系统共享同一快照
+
+---
+
 ## v2.2.21 (2025-12-05)
 
 ### Bug Fixes

docs/en/changelog.md

@@ -4,6 +4,32 @@ This document records the version update history of the `@esengine/ecs-framework
 
 ---
 
+## v2.3.0 (2025-12-06)
+
+### Features
+
+- **Persistent Entity**: Add entity cross-scene migration support (#285)
+  - New `EEntityLifecyclePolicy` enum (`SceneLocal`/`Persistent`)
+  - Entity adds `setPersistent()`, `setSceneLocal()`, `isPersistent` API
+  - Scene adds `findPersistentEntities()`, `extractPersistentEntities()`, `receiveMigratedEntities()`
+  - `SceneManager.setScene()` automatically handles persistent entity migration
+  - Use cases: global managers, player characters, cross-scene state persistence
+
+- **CommandBuffer Deferred Command System**: Execute entity operations uniformly at end of frame (#281)
+  - Support deferred add/remove components, destroy entities, set entity active state
+  - Each system has its own `commands` property
+  - Avoid modifying entity list during iteration, preventing iteration issues
+  - Scene automatically flushes all command buffers after `lateUpdate`
+
+### Performance
+
+- **ReactiveQuery Snapshot Optimization**: Optimize entity query iteration performance (#281)
+  - Add snapshot mechanism to avoid copying arrays every frame
+  - Only create new snapshots when entity list changes
+  - Multiple systems share the same snapshot in static scenes
+
+---
+
 ## v2.2.21 (2025-12-05)
 
 ### Bug Fixes

docs/en/guide/persistent-entity.md

@@ -1,6 +1,6 @@
-# Persistent Entity
+# Persistent Entity
 
-> **Version**: v2.2.22+
+> **Version**: v2.3.0+
 
 Persistent Entity is a special type of entity that automatically migrates to the new scene during scene transitions. It is suitable for game objects that need to maintain state across scenes, such as players, game managers, audio managers, etc.
 

docs/en/guide/scene-manager.md

@@ -1,4 +1,4 @@
-# SceneManager
+# SceneManager
 
 SceneManager is a lightweight scene manager provided by ECS Framework, suitable for 95% of game applications. It provides a simple and intuitive API with support for scene transitions and delayed loading.
 
@@ -19,7 +19,7 @@ SceneManager is suitable for:
 - Automatic ECS fluent API management
 - Automatic scene lifecycle handling
 - Integrated with Core, auto-updated
-- Supports [Persistent Entity](./persistent-entity) migration across scenes (v2.2.22+)
+- Supports [Persistent Entity](./persistent-entity) migration across scenes (v2.3.0+)
 
 ## Basic Usage
 

docs/en/guide/scene.md

@@ -1,4 +1,4 @@
-# Scene Management
+# Scene Management
 
 In the ECS architecture, a Scene is a container for the game world, responsible for managing the lifecycle of entities, systems, and components. Scenes provide a complete ECS runtime environment.
 
@@ -359,6 +359,6 @@ class ResourceScene extends Scene {
 
 - Learn about [SceneManager](./scene-manager) - Simple scene management for most games
 - Learn about [WorldManager](./world-manager) - For scenarios requiring multi-world isolation
-- Learn about [Persistent Entity](./persistent-entity) - Keep entities across scene transitions (v2.2.22+)
+- Learn about [Persistent Entity](./persistent-entity) - Keep entities across scene transitions (v2.3.0+)
 
 Scene is the core container of the ECS framework. Proper scene management makes your game architecture clearer, more modular, and easier to maintain.

docs/en/guide/system.md

@@ -1,4 +1,4 @@
-# System Architecture
+# System Architecture
 
 In ECS architecture, Systems are where business logic is processed. Systems are responsible for performing operations on entities that have specific component combinations, serving as the logic processing units of ECS architecture.
 
@@ -336,7 +336,7 @@ The framework creates a snapshot of the entity list before each `process`/`lateP
 
 ## Command Buffer (CommandBuffer)
 
-> **v2.2.22+**
+> **v2.3.0+**
 
 CommandBuffer provides a mechanism for deferred execution of entity operations. When you need to destroy entities or perform other operations that might affect iteration during processing, CommandBuffer allows you to defer these operations to the end of the frame.
 

docs/guide/persistent-entity.md

@@ -1,6 +1,6 @@
-# 持久化实体
+# 持久化实体
 
-> **版本**: v2.2.22+
+> **版本**: v2.3.0+
 
 持久化实体（Persistent Entity）是一种可以在场景切换时自动迁移到新场景的特殊实体。适用于需要跨场景保持状态的游戏对象，如玩家、游戏管理器、音频管理器等。
 

docs/guide/scene-manager.md

@@ -1,4 +1,4 @@
-# SceneManager
+# SceneManager
 
 SceneManager 是 ECS Framework 提供的轻量级场景管理器，适用于 95% 的游戏应用。它提供简单直观的 API，支持场景切换和延迟加载。
 
@@ -19,7 +19,7 @@ SceneManager 适合以下场景：
 - 自动管理 ECS 流式 API
 - 自动处理场景生命周期
 - 集成在 Core 中，自动更新
-- 支持[持久化实体](./persistent-entity.md)跨场景迁移（v2.2.22+）
+- 支持[持久化实体](./persistent-entity.md)跨场景迁移（v2.3.0+）
 
 ## 基本使用
 

docs/guide/scene.md

@@ -1,4 +1,4 @@
-# 场景管理
+# 场景管理
 
 在 ECS 架构中，场景（Scene）是游戏世界的容器，负责管理实体、系统和组件的生命周期。场景提供了完整的 ECS 运行环境。
 
@@ -657,6 +657,6 @@ world.setSceneActive('main', true);
 
 - 了解 [SceneManager](./scene-manager.md) - 适用于大多数游戏的简单场景管理
 - 了解 [WorldManager](./world-manager.md) - 适用于需要多世界隔离的高级场景
-- 了解 [持久化实体](./persistent-entity.md) - 让实体跨场景保持状态（v2.2.22+）
+- 了解 [持久化实体](./persistent-entity.md) - 让实体跨场景保持状态（v2.3.0+）
 
 场景是 ECS 框架的核心容器，正确使用场景管理能让你的游戏架构更加清晰、模块化和易于维护。

docs/guide/system.md

@@ -1,4 +1,4 @@
-# 系统架构
+# 系统架构
 
 在 ECS 架构中，系统（System）是处理业务逻辑的地方。系统负责对拥有特定组件组合的实体执行操作，是 ECS 架构的逻辑处理单元。
 
@@ -336,7 +336,7 @@ class DamageSystem extends EntitySystem {
 
 ## 命令缓冲区 (CommandBuffer)
 
-> **v2.2.22+**
+> **v2.3.0+**
 
 CommandBuffer 提供了一种延迟执行实体操作的机制。当你需要在迭代过程中销毁实体或进行其他可能影响迭代的操作时，使用 CommandBuffer 可以将这些操作推迟到帧末统一执行。
 
@@ -921,4 +921,4 @@ class ResourceSystem extends EntitySystem {
 }
 ```
 
-系统是 ECS 架构的逻辑处理核心，正确设计和使用系统能让你的游戏代码更加模块化、高效和易于维护。
+系统是 ECS 架构的逻辑处理核心，正确设计和使用系统能让你的游戏代码更加模块化、高效和易于维护。

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esengine/ecs-framework",
-  "version": "2.2.21",
+  "version": "2.3.0",
   "description": "用于Laya、Cocos Creator等JavaScript游戏引擎的高性能ECS框架",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",