docs(readme): update performance features and examples

- Clarified performance characteristics of the Archetype system.
- Added demo script to package.json for easier execution.
- Enhanced README with additional usage examples and details.

Author: codehz

README.md

@@ -4,10 +4,11 @@
 
 ## 特性
 
-- 🚀 高性能：基于原型的组件存储和高效的查询系统
+- 🚀 高性能：基于 Archetype 的组件存储和高效的查询系统
 - 🔧 类型安全：完整的 TypeScript 支持
 - 🏗️ 模块化：清晰的架构，支持自定义系统和组件
 - 📦 轻量级：零依赖，易于集成
+- ⚡ 内存高效：连续内存布局，优化的迭代性能
 
 ## 安装
 
@@ -44,6 +45,7 @@ world.flushCommands();
 
 // 创建查询并更新
 const query = world.createQuery([PositionId, VelocityId]);
+const deltaTime = 1.0 / 60.0; // 假设60FPS
 query.forEach([PositionId, VelocityId], (entity, position, velocity) => {
   position.x += velocity.x * deltaTime;
   position.y += velocity.y * deltaTime;
@@ -79,6 +81,12 @@ world.flushCommands(); // 钩子在这里被调用
 
 ### 运行示例
 
+```bash
+bun run demo
+```
+
+或者直接运行：
+
 ```bash
 bun run examples/simple/demo.ts
 ```
@@ -104,6 +112,8 @@ bun run examples/simple/demo.ts
 ### Query
 
 - `forEach(componentIds, callback)`: 遍历匹配的实体
+- `getEntities()`: 获取所有匹配实体的ID列表
+- `getEntitiesWithComponents(componentIds)`: 获取实体及其组件数据
 
 ### System
 
@@ -117,6 +127,13 @@ class MySystem implements System {
 }
 ```
 
+## 性能特点
+
+- **Archetype 系统**：实体按组件组合分组，实现连续内存访问
+- **缓存查询**：查询结果自动缓存，减少重复计算
+- **命令缓冲区**：延迟执行组件添加/移除，提高批处理效率
+- **类型安全**：编译时类型检查，无运行时开销
+
 ## 开发
 
 ### 运行测试
@@ -135,20 +152,28 @@ bunx tsc --noEmit
 
 ```
 src/
-├── index.ts          # 入口文件
-├── entity.ts         # 实体和组件管理
-├── world.ts          # 世界管理
-├── archetype.ts      # 原型系统
-├── query.ts          # 查询系统
-├── system.ts         # 系统接口
-├── command-buffer.ts # 命令缓冲区
-├── types.ts          # 类型定义
-└── utils.ts          # 工具函数
+├── index.ts              # 入口文件
+├── entity.ts             # 实体和组件管理
+├── world.ts              # 世界管理
+├── archetype.ts          # Archetype 系统（高效组件存储）
+├── query.ts              # 查询系统
+├── query-filter.ts       # 查询过滤器
+├── system.ts             # 系统接口
+├── command-buffer.ts     # 命令缓冲区
+├── types.ts              # 类型定义
+├── utils.ts              # 工具函数
+├── *.test.ts             # 单元测试
+├── query.example.ts      # 查询示例
+└── *.perf.test.ts        # 性能测试
 
 examples/
 └── simple/
-    ├── demo.ts       # 基本示例
-    └── README.md     # 示例说明
+    ├── demo.ts           # 基本示例
+    └── README.md         # 示例说明
+
+scripts/
+├── build.ts             # 构建脚本
+└── release.ts           # 发布脚本
 ```
 
 ## 许可证

package.json

@@ -7,6 +7,7 @@
   },
   "scripts": {
     "test": "bun test",
+    "demo": "bun run examples/simple/demo.ts",
     "release": "bun run scripts/release.ts"
   },
   "peerDependencies": {