From fe96d72ac67176fe02a3ed7bd8fbba4f66839aa8 Mon Sep 17 00:00:00 2001
From: yhh <359807859@qq.com>
Date: Fri, 5 Dec 2025 16:17:18 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=20v2.2.21=20changelo?=
 =?UTF-8?q?g=20=E4=B8=AD=E9=81=97=E6=BC=8F=E7=9A=84=E8=BF=AD=E4=BB=A3?=
 =?UTF-8?q?=E5=AE=89=E5=85=A8=E4=BF=AE=E5=A4=8D=20(#272)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/changelog.md    | 5 +++++
 docs/en/changelog.md | 5 +++++
 2 files changed, 10 insertions(+)

diff --git a/docs/changelog.md b/docs/changelog.md
index b5eed9ea..f501cd5b 100644
--- a/docs/changelog.md
+++ b/docs/changelog.md
@@ -6,6 +6,11 @@
 
 ## v2.2.21 (2025-12-05)
 
+### Bug Fixes
+
+- **迭代安全修复**: 修复 `process`/`lateProcess` 迭代时组件变化导致跳过实体的问题 (#272)
+  - 在系统处理过程中添加/移除组件不再导致实体被意外跳过
+
 ### Performance
 
 - **HierarchySystem 性能优化**: 优化层级系统避免每帧遍历所有实体 (#279)
diff --git a/docs/en/changelog.md b/docs/en/changelog.md
index ee775737..79c4f0fd 100644
--- a/docs/en/changelog.md
+++ b/docs/en/changelog.md
@@ -6,6 +6,11 @@ This document records the version update history of the `@esengine/ecs-framework
 
 ## v2.2.21 (2025-12-05)
 
+### Bug Fixes
+
+- **Iteration safety fix**: Fix issue where component changes during `process`/`lateProcess` iteration caused entities to be skipped (#272)
+  - Adding/removing components during system processing no longer causes entities to be unexpectedly skipped
+
 ### Performance
 
 - **HierarchySystem optimization**: Optimize hierarchy system to avoid iterating all entities every frame (#279)