From b2b8df9340277181b4eaba36063a70b9416b841f Mon Sep 17 00:00:00 2001
From: yhh <359807859@qq.com>
Date: Fri, 5 Dec 2025 16:10:24 +0800
Subject: [PATCH] chore(core): release v2.2.21
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 优化 HierarchySystem 性能 (#279)
- 更新 changelog
---
 docs/changelog.md          | 13 +++++++++++++
 docs/en/changelog.md       | 13 +++++++++++++
 packages/core/package.json |  2 +-
 3 files changed, 27 insertions(+), 1 deletion(-)

diff --git a/docs/changelog.md b/docs/changelog.md
index 8f53c438..b5eed9ea 100644
--- a/docs/changelog.md
+++ b/docs/changelog.md
@@ -4,6 +4,19 @@
 
 ---
 
+## v2.2.21 (2025-12-05)
+
+### Performance
+
+- **HierarchySystem 性能优化**: 优化层级系统避免每帧遍历所有实体 (#279)
+  - 使用脏实体集合代替每帧遍历所有实体
+  - 静态场景下 `process()` 从 O(n) 优化为 O(1)
+  - 1000 实体静态场景: 81.79μs → 0.07μs (快 1168 倍)
+  - 10000 实体静态场景: 939.43μs → 0.56μs (快 1677 倍)
+  - 服务端模拟 (100房间 x 100实体): 2.7ms → 1.4ms 每 tick
+
+---
+
 ## v2.2.20 (2025-12-04)
 
 ### Bug Fixes
diff --git a/docs/en/changelog.md b/docs/en/changelog.md
index 72b4595c..ee775737 100644
--- a/docs/en/changelog.md
+++ b/docs/en/changelog.md
@@ -4,6 +4,19 @@ This document records the version update history of the `@esengine/ecs-framework
 
 ---
 
+## v2.2.21 (2025-12-05)
+
+### Performance
+
+- **HierarchySystem optimization**: Optimize hierarchy system to avoid iterating all entities every frame (#279)
+  - Use dirty entity set instead of iterating all entities
+  - Static scene `process()` optimized from O(n) to O(1)
+  - 1000 entities static scene: 81.79μs → 0.07μs (1168x faster)
+  - 10000 entities static scene: 939.43μs → 0.56μs (1677x faster)
+  - Server simulation (100 rooms x 100 entities): 2.7ms → 1.4ms per tick
+
+---
+
 ## v2.2.20 (2025-12-04)
 
 ### Bug Fixes
diff --git a/packages/core/package.json b/packages/core/package.json
index 2c4ab429..40ccdb47 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@esengine/ecs-framework",
-  "version": "2.2.20",
+  "version": "2.2.21",
   "description": "用于Laya、Cocos Creator等JavaScript游戏引擎的高性能ECS框架",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",