chore: release packages (#348 )

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
chore: changeset for framework package configs (#347 )
2025-12-26 18:16:57 +08:00 · 2025-12-26 18:13:12 +08:00 · 2025-12-26 18:05:37 +08:00 · 2025-12-26 17:49:40 +08:00 · 2025-12-26 17:45:00 +08:00 · 2025-12-26 17:18:01 +08:00
1999 changed files with 8234 additions and 13873 deletions
--- a/.changeset/README.md
+++ b/.changeset/README.md
@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)
--- a/.changeset/config.json
+++ b/.changeset/config.json
@@ -0,0 +1,58 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.2/schema.json",
+  "changelog": [
+    "@changesets/changelog-github",
+    { "repo": "esengine/esengine" }
+  ],
+  "commit": false,
+  "fixed": [],
+  "linked": [
+    ["@esengine/ecs-framework", "@esengine/ecs-framework-math"]
+  ],
+  "access": "public",
+  "baseBranch": "master",
+  "updateInternalDependencies": "patch",
+  "ignore": [
+    "@esengine/engine-core",
+    "@esengine/runtime-core",
+    "@esengine/asset-system",
+    "@esengine/material-system",
+    "@esengine/ecs-engine-bindgen",
+    "@esengine/script-runtime",
+    "@esengine/platform-common",
+    "@esengine/platform-web",
+    "@esengine/platform-wechat",
+    "@esengine/sprite",
+    "@esengine/camera",
+    "@esengine/particle",
+    "@esengine/tilemap",
+    "@esengine/mesh-3d",
+    "@esengine/effect",
+    "@esengine/audio",
+    "@esengine/fairygui",
+    "@esengine/physics-rapier2d",
+    "@esengine/rapier2d",
+    "@esengine/world-streaming",
+    "@esengine/network-server",
+    "@esengine/editor-core",
+    "@esengine/editor-runtime",
+    "@esengine/editor-app",
+    "@esengine/sprite-editor",
+    "@esengine/camera-editor",
+    "@esengine/particle-editor",
+    "@esengine/tilemap-editor",
+    "@esengine/mesh-3d-editor",
+    "@esengine/fairygui-editor",
+    "@esengine/physics-rapier2d-editor",
+    "@esengine/behavior-tree-editor",
+    "@esengine/blueprint-editor",
+    "@esengine/asset-system-editor",
+    "@esengine/material-editor",
+    "@esengine/shader-editor",
+    "@esengine/world-streaming-editor",
+    "@esengine/node-editor",
+    "@esengine/sdk",
+    "@esengine/worker-generator",
+    "@esengine/engine"
+  ]
+}
--- a/.github/codeql/codeql-config.yml
+++ b/.github/codeql/codeql-config.yml
@@ -6,3 +6,8 @@ paths-ignore:
  - "**/node_modules"
  - "**/dist"
  - "**/bin"
+  - "**/tests"
+  - "**/*.test.ts"
+  - "**/*.spec.ts"
+  - "**/test"
+  - "**/__tests__"
--- a/.github/labeler.yml
+++ b/.github/labeler.yml
@@ -1,32 +0,0 @@
-# 自动标签配置
-# 根据 issue/PR 内容自动打标签
-
-'bug':
-  - '/(bug|错误|崩溃|crash|error|exception|问题)/i'
-
-'enhancement':
-  - '/(feature|功能|enhancement|improve|优化|建议)/i'
-
-'documentation':
-  - '/(doc|文档|readme|guide|tutorial|教程)/i'
-
-'question':
-  - '/(question|疑问|how to|如何|怎么)/i'
-
-'performance':
-  - '/(performance|性能|slow|慢|lag|卡顿|optimize)/i'
-
-'core':
-  - '/(@esengine\/ecs-framework|packages\/core|core package)/i'
-
-'editor':
-  - '/(editor|编辑器|tauri)/i'
-
-'network':
-  - '/(network|网络|multiplayer|多人)/i'
-
-'help wanted':
-  - '/(help wanted|需要帮助|求助)/i'
-
-'good first issue':
-  - '/(good first issue|新手友好|beginner)/i'
--- a/.github/workflows/ai-batch-analyze-issues.yml
+++ b/.github/workflows/ai-batch-analyze-issues.yml
@@ -1,73 +0,0 @@
-name: AI Batch Analyze Issues
-
-on:
-  workflow_dispatch:
-    inputs:
-      mode:
-        description: '分析模式'
-        required: true
-        type: choice
-        options:
-          - 'recent' # 最近 10 个 issue
-          - 'open' # 所有打开的 issue
-          - 'all' # 所有 issue（慎用）
-        default: 'recent'
-
-permissions:
-  issues: write
-  contents: read
-
-jobs:
-  analyze:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20.x'
-
-      - name: Install GitHub CLI
-        run: |
-          gh --version || (curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
-          echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
-          sudo apt update
-          sudo apt install gh)
-
-      - name: Batch Analyze Issues
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          MODE="${{ github.event.inputs.mode }}"
-
-          # 获取 issue 列表
-          if [ "$MODE" = "recent" ]; then
-            echo "📊 分析最近 10 个 issue..."
-            ISSUES=$(gh issue list --limit 10 --json number --jq '.[].number')
-          elif [ "$MODE" = "open" ]; then
-            echo "📊 分析所有打开的 issue..."
-            ISSUES=$(gh issue list --state open --json number --jq '.[].number')
-          else
-            echo "📊 分析所有 issue（这可能需要很长时间）..."
-            ISSUES=$(gh issue list --state all --limit 100 --json number --jq '.[].number')
-          fi
-
-          # 为每个 issue 添加 AI 分析评论
-          for issue_num in $ISSUES; do
-            echo "🤖 分析 Issue #$issue_num..."
-
-            # 获取 issue 内容
-            ISSUE_BODY=$(gh issue view $issue_num --json body --jq '.body')
-            ISSUE_TITLE=$(gh issue view $issue_num --json title --jq '.title')
-
-            # 添加触发评论
-            gh issue comment $issue_num --body "@ai-helper 请帮我分析这个 issue" || true
-
-            # 避免 API 限制
-            sleep 2
-          done
-
-          echo "✅ 批量分析完成！"
-          echo "查看结果：https://github.com/${{ github.repository }}/issues"
--- a/.github/workflows/ai-helper-tip.yml
+++ b/.github/workflows/ai-helper-tip.yml
@@ -1,61 +0,0 @@
-name: AI Helper Tip
-
-# 对所有新创建的 issue 自动回复 AI 助手使用说明（新老用户都适用）
-on:
-  issues:
-    types: [opened]
-
-permissions:
-  issues: write
-
-jobs:
-  tip:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Post AI Helper Usage Tip
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const message = [
-              "## 🤖 AI 助手可用 | AI Helper Available",
-              "",
-              "**中文说明：**",
-              "",
-              "本项目配备了 AI 智能助手，可以帮助你快速获得解答！",
-              "",
-              "**使用方法：** 在评论中提及 `@ai-helper`，AI 会自动搜索项目代码并提供解决方案。",
-              "",
-              "**示例：**",
-              "```",
-              "@ai-helper 如何创建一个新的 System？",
-              "@ai-helper 这个报错是什么原因？",
-              "```",
-              "",
-              "---",
-              "",
-              "**English:**",
-              "",
-              "This project has an AI assistant to help you get answers quickly!",
-              "",
-              "**How to use:** Mention `@ai-helper` in a comment, and AI will automatically search the codebase and provide solutions.",
-              "",
-              "**Examples:**",
-              "```",
-              "@ai-helper How do I create a new System?",
-              "@ai-helper What causes this error?",
-              "```",
-              "",
-              "---",
-              "",
-              "💡 *AI 助手基于代码库提供建议，复杂问题建议等待维护者回复*",
-              "💡 *AI suggestions are based on the codebase. For complex issues, please wait for maintainer responses*"
-            ].join('\n');
-
-            await github.rest.issues.createComment({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: context.issue.number,
-              body: message
-            });
-
-            console.log('✅ AI helper tip posted successfully');
--- a/.github/workflows/ai-issue-helper.yml
+++ b/.github/workflows/ai-issue-helper.yml
@@ -1,85 +0,0 @@
-name: AI Issue Helper
-
-on:
-  issue_comment:
-    types: [created]
-
-permissions:
-  issues: write
-  contents: read
-  models: read
-
-jobs:
-  ai-helper:
-    runs-on: ubuntu-latest
-    # 只在真实用户提到 @ai-helper 时触发，忽略机器人评论
-    if: |
-      contains(github.event.comment.body, '@ai-helper') &&
-      github.event.comment.user.type != 'Bot'
-    steps:
-      - name: Checkout Repository
-        uses: actions/checkout@v4
-
-      - name: Get Issue Details
-        id: issue
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const issue = await github.rest.issues.get({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: context.issue.number
-            });
-
-            // 限制长度，避免超过 token 限制
-            const maxLength = 1000;
-            const truncate = (str, max) => {
-              if (!str) return '';
-              return str.length > max ? str.substring(0, max) + '...[内容过长已截断]' : str;
-            };
-
-            core.exportVariable('ISSUE_TITLE', truncate(issue.data.title || '', 200));
-            core.exportVariable('ISSUE_BODY', truncate(issue.data.body || '', maxLength));
-            core.exportVariable('COMMENT_BODY', truncate(context.payload.comment.body || '', 500));
-            core.exportVariable('ISSUE_NUMBER', context.issue.number);
-
-      - name: Create Prompt
-        id: prompt
-        run: |
-          cat > prompt.txt << 'PROMPT_EOF'
-          Issue #${{ env.ISSUE_NUMBER }}
-
-          标题: ${{ env.ISSUE_TITLE }}
-
-          内容: ${{ env.ISSUE_BODY }}
-
-          评论: ${{ env.COMMENT_BODY }}
-
-          请搜索项目代码并提供解决方案。
-          PROMPT_EOF
-
-      - name: AI Analysis
-        uses: actions/ai-inference@v1
-        id: ai
-        with:
-          model: 'gpt-4o'
-          enable-github-mcp: true
-          max-tokens: 1500
-          system-prompt: |
-            你是 ECS Framework (TypeScript ECS 框架) 的 AI 助手。
-            主要代码在 packages/core/src。
-            搜索相关代码后，用中文简洁回答问题，包含问题分析、解决方案和代码引用。
-          prompt-file: prompt.txt
-
-      - name: Post AI Response
-        env:
-          AI_RESPONSE: ${{ steps.ai.outputs.response }}
-        uses: actions/github-script@v7
-        with:
-          script: |
-            await github.rest.issues.createComment({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: context.issue.number,
-              body: process.env.AI_RESPONSE
-            });
--- a/.github/workflows/ai-issue-moderator.yml
+++ b/.github/workflows/ai-issue-moderator.yml
@@ -1,56 +0,0 @@
-name: AI Issue Moderator
-
-on:
-  issues:
-    types: [opened]
-  issue_comment:
-    types: [created]
-
-permissions:
-  issues: write
-  contents: read
-  models: read
-
-jobs:
-  moderate:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Check Content
-        uses: actions/ai-inference@v1
-        id: check
-        with:
-          model: 'gpt-4o-mini'
-          system-prompt: |
-            你是一个内容审查助手。
-            检查内容是否包含：
-            1. 垃圾信息或广告
-            2. 恶意或攻击性内容
-            3. 与项目完全无关的内容
-
-            只返回 "SPAM" 或 "OK"，不要其他内容。
-          prompt: |
-            标题：${{ github.event.issue.title || github.event.comment.body }}
-
-            内容：
-            ${{ github.event.issue.body || github.event.comment.body }}
-
-      - name: Mark as Spam
-        if: contains(steps.check.outputs.response, 'SPAM')
-        uses: actions/github-script@v7
-        with:
-          script: |
-            // 添加 spam 标签
-            github.rest.issues.addLabels({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: context.issue.number,
-              labels: ['spam']
-            });
-
-            // 添加评论
-            github.rest.issues.createComment({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: context.issue.number,
-              body: '🤖 这个内容被 AI 检测为可能的垃圾内容。如果这是误判，请联系维护者。\n\n🤖 This content was detected as potential spam by AI. If this is a false positive, please contact the maintainers.'
-            });
--- a/.github/workflows/batch-label-issues.yml
+++ b/.github/workflows/batch-label-issues.yml
@@ -1,160 +0,0 @@
-name: Batch Label Issues
-
-on:
-  workflow_dispatch:
-    inputs:
-      mode:
-        description: '标签模式'
-        required: true
-        type: choice
-        options:
-          - 'recent' # 最近 20 个 issue
-          - 'open' # 所有打开的 issue
-          - 'unlabeled' # 只处理没有标签的 issue
-          - 'all' # 所有 issue（慎用）
-        default: 'recent'
-
-      skip_labeled:
-        description: '跳过已有标签的 issue'
-        required: false
-        type: boolean
-        default: true
-
-permissions:
-  issues: write
-  contents: read
-
-jobs:
-  batch-label:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20.x'
-
-      - name: Batch Label Issues
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          MODE="${{ github.event.inputs.mode }}"
-          SKIP_LABELED="${{ github.event.inputs.skip_labeled }}"
-
-          echo "📊 开始批量打标签..."
-          echo "模式: $MODE"
-          echo "跳过已标签: $SKIP_LABELED"
-
-          # 获取 issue 列表
-          if [ "$MODE" = "recent" ]; then
-            echo "📋 获取最近 20 个 issue..."
-            ISSUES=$(gh issue list --limit 20 --json number,labels,title,body --jq '.[] | {number, labels: [.labels[].name], title, body}')
-          elif [ "$MODE" = "open" ]; then
-            echo "📋 获取所有打开的 issue..."
-            ISSUES=$(gh issue list --state open --json number,labels,title,body --jq '.[] | {number, labels: [.labels[].name], title, body}')
-          elif [ "$MODE" = "unlabeled" ]; then
-            echo "📋 获取没有标签的 issue..."
-            ISSUES=$(gh issue list --state all --json number,labels,title,body --jq '.[] | select(.labels | length == 0) | {number, labels: [.labels[].name], title, body}')
-          else
-            echo "📋 获取所有 issue（限制 100 个）..."
-            ISSUES=$(gh issue list --state all --limit 100 --json number,labels,title,body --jq '.[] | {number, labels: [.labels[].name], title, body}')
-          fi
-
-          # 临时文件
-          echo "$ISSUES" > /tmp/issues.json
-
-          # 处理每个 issue
-          cat /tmp/issues.json | jq -c '.' | while read -r issue; do
-            ISSUE_NUM=$(echo "$issue" | jq -r '.number')
-            EXISTING_LABELS=$(echo "$issue" | jq -r '.labels | join(",")')
-            TITLE=$(echo "$issue" | jq -r '.title')
-            BODY=$(echo "$issue" | jq -r '.body')
-
-            echo ""
-            echo "🔍 处理 Issue #$ISSUE_NUM: $TITLE"
-            echo "   现有标签: $EXISTING_LABELS"
-
-            # 跳过已有标签的 issue
-            if [ "$SKIP_LABELED" = "true" ] && [ ! -z "$EXISTING_LABELS" ]; then
-              echo "   ⏭️  跳过（已有标签）"
-              continue
-            fi
-
-            # 分析内容并打标签
-            LABELS_TO_ADD=""
-
-            # 检测 bug
-            if echo "$TITLE $BODY" | grep -iE "(bug|错误|崩溃|crash|error|exception|问题|fix)" > /dev/null; then
-              LABELS_TO_ADD="$LABELS_TO_ADD bug"
-              echo "   🐛 检测到: bug"
-            fi
-
-            # 检测 feature request
-            if echo "$TITLE $BODY" | grep -iE "(feature|功能|enhancement|improve|优化|建议|新增|添加|add)" > /dev/null; then
-              LABELS_TO_ADD="$LABELS_TO_ADD enhancement"
-              echo "   ✨ 检测到: enhancement"
-            fi
-
-            # 检测 question
-            if echo "$TITLE $BODY" | grep -iE "(question|疑问|how to|如何|怎么|为什么|why|咨询|\?|？)" > /dev/null; then
-              LABELS_TO_ADD="$LABELS_TO_ADD question"
-              echo "   ❓ 检测到: question"
-            fi
-
-            # 检测 documentation
-            if echo "$TITLE $BODY" | grep -iE "(doc|文档|readme|guide|tutorial|教程|说明)" > /dev/null; then
-              LABELS_TO_ADD="$LABELS_TO_ADD documentation"
-              echo "   📖 检测到: documentation"
-            fi
-
-            # 检测 performance
-            if echo "$TITLE $BODY" | grep -iE "(performance|性能|slow|慢|lag|卡顿|optimize|优化)" > /dev/null; then
-              LABELS_TO_ADD="$LABELS_TO_ADD performance"
-              echo "   ⚡ 检测到: performance"
-            fi
-
-            # 检测 core
-            if echo "$TITLE $BODY" | grep -iE "(@esengine/ecs-framework|packages/core|core package|核心包)" > /dev/null; then
-              LABELS_TO_ADD="$LABELS_TO_ADD core"
-              echo "   🎯 检测到: core"
-            fi
-
-            # 检测 editor
-            if echo "$TITLE $BODY" | grep -iE "(editor|编辑器|tauri)" > /dev/null; then
-              LABELS_TO_ADD="$LABELS_TO_ADD editor"
-              echo "   🎨 检测到: editor"
-            fi
-
-            # 检测 network
-            if echo "$TITLE $BODY" | grep -iE "(network|网络|multiplayer|多人|同步)" > /dev/null; then
-              LABELS_TO_ADD="$LABELS_TO_ADD network"
-              echo "   🌐 检测到: network"
-            fi
-
-            # 检测 help wanted
-            if echo "$TITLE $BODY" | grep -iE "(help wanted|需要帮助|求助)" > /dev/null; then
-              LABELS_TO_ADD="$LABELS_TO_ADD help wanted"
-              echo "   🆘 检测到: help wanted"
-            fi
-
-            # 添加标签
-            if [ ! -z "$LABELS_TO_ADD" ]; then
-              echo "   ✅ 添加标签: $LABELS_TO_ADD"
-              for label in $LABELS_TO_ADD; do
-                gh issue edit $ISSUE_NUM --add-label "$label" 2>&1 | grep -v "already exists" || true
-              done
-              echo "   💬 添加说明评论..."
-              gh issue comment $ISSUE_NUM --body $'🤖 自动标签系统检测到此 issue 并添加了相关标签。如有误判，请告知维护者。\n\n🤖 Auto-labeling system detected and labeled this issue. Please let maintainers know if this is incorrect.' || true
-            else
-              echo "   ℹ️  未检测到明确类型"
-            fi
-
-            # 避免 API 限制
-            sleep 1
-          done
-
-          echo ""
-          echo "✅ 批量标签完成！"
-          echo "查看结果: https://github.com/${{ github.repository }}/issues"
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -13,17 +13,31 @@ on:
      - '.github/workflows/ci.yml'
  pull_request:
    branches: [ master, main, develop ]
-    paths:
-      - 'packages/**'
-      - 'package.json'
-      - 'pnpm-lock.yaml'
-      - 'tsconfig.json'
-      - 'turbo.json'
-      - 'jest.config.*'
-      - '.github/workflows/ci.yml'
+    # Run on all PRs to satisfy branch protection, but skip build if no code changes

 jobs:
+  # Check if we need to run the full CI
+  check-changes:
+    runs-on: ubuntu-latest
+    outputs:
+      should-run: ${{ steps.filter.outputs.code }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dorny/paths-filter@v3
+        id: filter
+        with:
+          filters: |
+            code:
+              - 'packages/**'
+              - 'package.json'
+              - 'pnpm-lock.yaml'
+              - 'tsconfig.json'
+              - 'turbo.json'
+              - 'jest.config.*'
+
  ci:
+    needs: check-changes
+    if: needs.check-changes.outputs.should-run == 'true'
    runs-on: ubuntu-latest
    env:
      TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
@@ -42,57 +56,35 @@ jobs:
        node-version: '20.x'
        cache: 'pnpm'

-    - name: Install Rust stable
-      uses: dtolnay/rust-toolchain@stable
-      with:
-        targets: wasm32-unknown-unknown
-
-    # 缓存 Rust 编译结果
-    - name: Cache Rust dependencies
-      uses: Swatinem/rust-cache@v2
-      with:
-        workspaces: packages/engine
-        cache-on-failure: true
-
-    # 缓存 wasm-pack
-    - name: Cache wasm-pack
-      uses: actions/cache@v4
-      with:
-        path: ~/.cargo/bin/wasm-pack
-        key: wasm-pack-${{ runner.os }}
-
-    - name: Install wasm-pack
-      run: |
-        if ! command -v wasm-pack &> /dev/null; then
-          cargo install wasm-pack
-        fi
-
    - name: Install dependencies
      run: pnpm install --no-frozen-lockfile

-    # 构建所有包 (使用 Turborepo Remote Cache)
-    - name: Build all packages
-      run: pnpm run build
-
-    - name: Copy WASM files to ecs-engine-bindgen
+    # 构建 framework 包 (可独立发布的通用库，无外部依赖)
+    - name: Build framework packages
      run: |
-        mkdir -p packages/ecs-engine-bindgen/src/wasm
-        cp packages/engine/pkg/es_engine.js packages/ecs-engine-bindgen/src/wasm/
-        cp packages/engine/pkg/es_engine.d.ts packages/ecs-engine-bindgen/src/wasm/
-        cp packages/engine/pkg/es_engine_bg.wasm packages/ecs-engine-bindgen/src/wasm/
-        cp packages/engine/pkg/es_engine_bg.wasm.d.ts packages/ecs-engine-bindgen/src/wasm/
+        pnpm --filter @esengine/ecs-framework build
+        pnpm --filter @esengine/ecs-framework-math build
+        pnpm --filter @esengine/behavior-tree build
+        pnpm --filter @esengine/blueprint build
+        pnpm --filter @esengine/fsm build
+        pnpm --filter @esengine/timer build
+        pnpm --filter @esengine/spatial build
+        pnpm --filter @esengine/procgen build
+        pnpm --filter @esengine/pathfinding build
+        pnpm --filter @esengine/network-protocols build
+        pnpm --filter @esengine/network build

-    # 类型检查
-    - name: Type check
-      run: pnpm run type-check
+    # 类型检查 (仅 framework 包)
+    - name: Type check (framework packages)
+      run: pnpm run type-check:framework

-    # Lint 检查
-    - name: Lint check
-      run: pnpm run lint
+    # Lint 检查 (仅 framework 包)
+    - name: Lint check (framework packages)
+      run: pnpm run lint:framework

-    # 测试
+    # 测试 (仅 framework 包)
    - name: Run tests with coverage
-      run: pnpm run test:ci
+      run: pnpm run test:ci:framework

    - name: Upload coverage to Codecov
      uses: codecov/codecov-action@v4
@@ -103,9 +95,11 @@ jobs:
        name: codecov-umbrella
        fail_ci_if_error: false

-    # 构建 npm 包
+    # 构建 npm 包 (core 和 math)
    - name: Build npm packages
-      run: pnpm run build:npm
+      run: |
+        pnpm run build:npm:core
+        pnpm run build:npm:math

    # 上传构建产物
    - name: Upload build artifacts
@@ -113,6 +107,6 @@ jobs:
      with:
        name: build-artifacts
        path: |
-          packages/*/dist/
-          packages/*/bin/
+          packages/framework/**/dist/
+          packages/framework/**/bin/
        retention-days: 7
--- a/.github/workflows/cleanup-dependabot.yml
+++ b/.github/workflows/cleanup-dependabot.yml
@@ -1,146 +0,0 @@
-name: Cleanup Old Dependabot PRs
-
-# 手动触发的 workflow，用于清理堆积的 Dependabot PR
-on:
-  workflow_dispatch:
-    inputs:
-      days_old:
-        description: '关闭多少天前创建的 PR（默认 7 天）'
-        required: false
-        default: '7'
-      dry_run:
-        description: '试运行模式（true=仅显示，不关闭）'
-        required: false
-        default: 'true'
-        type: choice
-        options:
-          - 'true'
-          - 'false'
-
-jobs:
-  cleanup:
-    runs-on: ubuntu-latest
-    permissions:
-      pull-requests: write
-      issues: write
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: List and Close Old Dependabot PRs
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const daysOld = parseInt('${{ github.event.inputs.days_old }}') || 7;
-            const dryRun = '${{ github.event.inputs.dry_run }}' === 'true';
-            const cutoffDate = new Date();
-            cutoffDate.setDate(cutoffDate.getDate() - daysOld);
-
-            console.log(`🔍 查找超过 ${daysOld} 天的 Dependabot PR...`);
-            console.log(`📅 截止日期: ${cutoffDate.toISOString()}`);
-            console.log(`🏃 模式: ${dryRun ? '试运行（不会实际关闭）' : '实际执行'}`);
-            console.log('---');
-
-            // 获取所有 Dependabot PR
-            const { data: pulls } = await github.rest.pulls.list({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              state: 'open',
-              per_page: 100
-            });
-
-            const dependabotPRs = pulls.filter(pr =>
-              pr.user.login === 'dependabot[bot]' &&
-              new Date(pr.created_at) < cutoffDate
-            );
-
-            console.log(`📊 找到 ${dependabotPRs.length} 个符合条件的 Dependabot PR`);
-            console.log('');
-
-            if (dependabotPRs.length === 0) {
-              console.log('✅ 没有需要清理的 PR');
-              return;
-            }
-
-            // 按类型分组
-            const byType = {
-              dev: [],
-              prod: [],
-              actions: [],
-              other: []
-            };
-
-            for (const pr of dependabotPRs) {
-              const title = pr.title.toLowerCase();
-              const labels = pr.labels.map(l => l.name);
-
-              let type = 'other';
-              if (title.includes('dev-dependencies') || title.includes('development')) {
-                type = 'dev';
-              } else if (title.includes('production-dependencies')) {
-                type = 'prod';
-              } else if (labels.includes('github-actions')) {
-                type = 'actions';
-              }
-
-              byType[type].push(pr);
-            }
-
-            console.log('📋 PR 分类统计:');
-            console.log(`  🔧 开发依赖: ${byType.dev.length} 个`);
-            console.log(`  📦 生产依赖: ${byType.prod.length} 个`);
-            console.log(`  ⚙️  GitHub Actions: ${byType.actions.length} 个`);
-            console.log(`  ❓ 其他: ${byType.other.length} 个`);
-            console.log('');
-
-            // 处理每个 PR
-            for (const pr of dependabotPRs) {
-              const age = Math.floor((Date.now() - new Date(pr.created_at)) / (1000 * 60 * 60 * 24));
-
-              console.log(`${dryRun ? '🔍' : '🗑️ '} #${pr.number}: ${pr.title}`);
-              console.log(`   创建时间: ${pr.created_at} (${age} 天前)`);
-              console.log(`   链接: ${pr.html_url}`);
-
-              if (!dryRun) {
-                await github.rest.pulls.update({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  pull_number: pr.number,
-                  state: 'closed'
-                });
-
-                await github.rest.issues.createComment({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  issue_number: pr.number,
-                  body: `🤖 **自动关闭旧的 Dependabot PR**
-
-此 PR 已超过 ${daysOld} 天未合并，已被自动关闭以清理积压。
-
-📌 **下一步：**
- Dependabot 已配置为月度运行，届时会创建新的分组更新
- 新的 Mergify 规则会智能处理不同类型的依赖更新
- 开发依赖和 GitHub Actions 会自动合并（即使 CI 失败）
- 生产依赖需要 CI 通过才会自动合并
-
-如果需要立即应用此更新，请手动更新依赖。
-
---
-*此操作由仓库维护者手动触发的清理工作流执行*`
-                });
-
-                console.log('   ✅ 已关闭并添加说明');
-              } else {
-                console.log('   ℹ️  试运行模式 - 未执行操作');
-              }
-              console.log('');
-            }
-
-            console.log('---');
-            if (dryRun) {
-              console.log(`✨ 试运行完成！共发现 ${dependabotPRs.length} 个待清理的 PR`);
-              console.log('💡 要实际执行清理，请将 dry_run 参数设为 false 重新运行');
-            } else {
-              console.log(`✅ 清理完成！已关闭 ${dependabotPRs.length} 个 Dependabot PR`);
-            }
--- a/.github/workflows/codecov.yml
+++ b/.github/workflows/codecov.yml
@@ -28,7 +28,7 @@ jobs:

      - name: Run tests with coverage
        run: |
-          cd packages/core
+          cd packages/framework/core
          pnpm run test:coverage

      - name: Upload coverage to Codecov
@@ -36,7 +36,7 @@ jobs:
        continue-on-error: true
        with:
          token: ${{ secrets.CODECOV_TOKEN }}
-          files: ./packages/core/coverage/coverage-final.json
+          files: ./packages/framework/core/coverage/coverage-final.json
          flags: core
          name: core-coverage
          fail_ci_if_error: false
@@ -46,4 +46,4 @@ jobs:
        uses: actions/upload-artifact@v4
        with:
          name: coverage-report
-          path: packages/core/coverage/
+          path: packages/framework/core/coverage/
--- a/.github/workflows/issue-labeler.yml
+++ b/.github/workflows/issue-labeler.yml
@@ -1,23 +0,0 @@
-name: Issue Labeler
-
-on:
-  issues:
-    types: [opened, edited]
-
-permissions:
-  issues: write
-  contents: read
-
-jobs:
-  label:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Label Issues
-        uses: github/issue-labeler@v3.4
-        with:
-          repo-token: ${{ secrets.GITHUB_TOKEN }}
-          configuration-path: .github/labeler.yml
-          enable-versioned-regex: 1
--- a/.github/workflows/issue-translator.yml
+++ b/.github/workflows/issue-translator.yml
@@ -1,28 +0,0 @@
-name: Issue Translator
-
-on:
-  issue_comment:
-    types: [created]
-  issues:
-    types: [opened]
-
-permissions:
-  issues: write
-
-jobs:
-  translate:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Translate Issues
-        uses: tomsun28/issues-translate-action@v2.7
-        with:
-          IS_MODIFY_TITLE: false
-          # 设置为 true 会修改标题，false 只在评论中添加翻译
-          CUSTOM_BOT_NOTE: |
-            <details>
-            <summary>🌏 Translation / 翻译</summary>
-
-            Bot detected the issue body's language is not English, translate it automatically.
-            机器人检测到 issue 内容非英文，自动翻译。
-
-            </details>
--- a/.github/workflows/release-changesets.yml
+++ b/.github/workflows/release-changesets.yml
@@ -0,0 +1,70 @@
+name: Release (Changesets)
+
+on:
+  push:
+    branches:
+      - master
+    paths:
+      - '.changeset/**'
+      - 'packages/*/package.json'
+      - 'packages/*/*/package.json'
+      - 'packages/*/*/*/package.json'
+  workflow_dispatch:
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      id-token: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: 'https://registry.npmjs.org'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build framework packages
+        run: |
+          # Only build packages managed by Changesets (not in ignore list)
+          pnpm --filter "@esengine/ecs-framework" build
+          pnpm --filter "@esengine/ecs-framework-math" build
+          pnpm --filter "@esengine/behavior-tree" build
+          pnpm --filter "@esengine/blueprint" build
+          pnpm --filter "@esengine/fsm" build
+          pnpm --filter "@esengine/timer" build
+          pnpm --filter "@esengine/spatial" build
+          pnpm --filter "@esengine/procgen" build
+          pnpm --filter "@esengine/pathfinding" build
+          pnpm --filter "@esengine/network-protocols" build
+          pnpm --filter "@esengine/network" build
+          pnpm --filter "@esengine/cli" build
+
+      - name: Create Release Pull Request or Publish
+        id: changesets
+        uses: changesets/action@v1
+        with:
+          version: pnpm changeset:version
+          publish: pnpm changeset:publish
+          title: 'chore: release packages'
+          commit: 'chore: release packages'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
--- a/.github/workflows/release-editor.yml
+++ b/.github/workflows/release-editor.yml
@@ -50,7 +50,7 @@ jobs:
      - name: Rust cache
        uses: Swatinem/rust-cache@v2
        with:
-          workspaces: packages/editor-app/src-tauri
+          workspaces: packages/editor/editor-app/src-tauri
          cache-on-failure: true

      - name: Install dependencies (Ubuntu)
@@ -65,7 +65,7 @@ jobs:
      - name: Update version in config files (for manual trigger)
        if: github.event_name == 'workflow_dispatch'
        run: |
-          cd packages/editor-app
+          cd packages/editor/editor-app
          node -e "const pkg=require('./package.json'); pkg.version='${{ github.event.inputs.version }}'; require('fs').writeFileSync('./package.json', JSON.stringify(pkg, null, 2)+'\n')"
          node scripts/sync-version.js

@@ -80,15 +80,15 @@ jobs:
      - name: Copy WASM files to ecs-engine-bindgen
        shell: bash
        run: |
-          mkdir -p packages/ecs-engine-bindgen/src/wasm
-          cp packages/engine/pkg/es_engine.js packages/ecs-engine-bindgen/src/wasm/
-          cp packages/engine/pkg/es_engine.d.ts packages/ecs-engine-bindgen/src/wasm/
-          cp packages/engine/pkg/es_engine_bg.wasm packages/ecs-engine-bindgen/src/wasm/
-          cp packages/engine/pkg/es_engine_bg.wasm.d.ts packages/ecs-engine-bindgen/src/wasm/
+          mkdir -p packages/engine/ecs-engine-bindgen/src/wasm
+          cp packages/rust/engine/pkg/es_engine.js packages/engine/ecs-engine-bindgen/src/wasm/
+          cp packages/rust/engine/pkg/es_engine.d.ts packages/engine/ecs-engine-bindgen/src/wasm/
+          cp packages/rust/engine/pkg/es_engine_bg.wasm packages/engine/ecs-engine-bindgen/src/wasm/
+          cp packages/rust/engine/pkg/es_engine_bg.wasm.d.ts packages/engine/ecs-engine-bindgen/src/wasm/

      - name: Bundle runtime files for Tauri
        run: |
-          cd packages/editor-app
+          cd packages/editor/editor-app
          node scripts/bundle-runtime.mjs

      - name: Build Tauri app
@@ -99,7 +99,7 @@ jobs:
          TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
          TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
        with:
-          projectPath: packages/editor-app
+          projectPath: packages/editor/editor-app
          tagName: ${{ github.event_name == 'workflow_dispatch' && format('editor-v{0}', github.event.inputs.version) || github.ref_name }}
          releaseName: 'ECS Editor v${{ github.event.inputs.version || github.ref_name }}'
          releaseBody: 'See the assets to download this version and install.'
@@ -116,8 +116,8 @@ jobs:
        with:
          name: windows-unsigned
          path: |
-            packages/editor-app/src-tauri/target/release/bundle/nsis/*.exe
-            packages/editor-app/src-tauri/target/release/bundle/msi/*.msi
+            packages/editor/editor-app/src-tauri/target/release/bundle/nsis/*.exe
+            packages/editor/editor-app/src-tauri/target/release/bundle/msi/*.msi
          retention-days: 1

  # SignPath 代码签名（Windows）
@@ -221,7 +221,7 @@ jobs:

      - name: Update version files
        run: |
-          cd packages/editor-app
+          cd packages/editor/editor-app
          node -e "const pkg=require('./package.json'); pkg.version='${{ github.event.inputs.version }}'; require('fs').writeFileSync('./package.json', JSON.stringify(pkg, null, 2)+'\n')"
          node scripts/sync-version.js

@@ -239,8 +239,8 @@ jobs:
            This PR updates the editor version after successful release build.

            ### Changes
-            - Updated `packages/editor-app/package.json` → `${{ github.event.inputs.version }}`
-            - Updated `packages/editor-app/src-tauri/tauri.conf.json` → `${{ github.event.inputs.version }}`
+            - Updated `packages/editor/editor-app/package.json` → `${{ github.event.inputs.version }}`
+            - Updated `packages/editor/editor-app/src-tauri/tauri.conf.json` → `${{ github.event.inputs.version }}`

            ### Release
            - [GitHub Release](https://github.com/${{ github.repository }}/releases/tag/editor-v${{ github.event.inputs.version }})
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -1,7 +1,6 @@
 name: Release NPM Packages

 on:
-  # 标签触发：支持 v* 和 {package}-v* 格式
  # Tag trigger: supports v* and {package}-v* formats
  push:
    tags:
@@ -15,12 +14,11 @@ on:
      - 'physics-rapier2d-v*'
      - 'worker-generator-v*'

-  # 保留手动触发选项
-  # Keep manual trigger option
+  # Manual trigger option
  workflow_dispatch:
    inputs:
      package:
-        description: '选择要发布的包 | Select package to publish'
+        description: 'Select package to publish'
        required: true
        type: choice
        options:
@@ -33,7 +31,7 @@ on:
          - physics-rapier2d
          - worker-generator
      version_type:
-        description: '版本更新类型 | Version bump type'
+        description: 'Version bump type'
        required: true
        type: choice
        options:
@@ -61,11 +59,10 @@ jobs:
        id: parse
        run: |
          if [ "${{ github.event_name }}" = "push" ]; then
-            # 从标签解析包名和版本 | Parse package and version from tag
+            # Parse package and version from tag
            TAG="${GITHUB_REF#refs/tags/}"
            echo "tag=$TAG" >> $GITHUB_OUTPUT

-            # 解析格式：v1.0.0 或 package-v1.0.0
            # Parse format: v1.0.0 or package-v1.0.0
            if [[ "$TAG" =~ ^v([0-9]+\.[0-9]+\.[0-9]+.*)$ ]]; then
              PACKAGE="core"
@@ -82,10 +79,9 @@ jobs:
            echo "package=$PACKAGE" >> $GITHUB_OUTPUT
            echo "version=$VERSION" >> $GITHUB_OUTPUT
            echo "mode=tag" >> $GITHUB_OUTPUT
-            echo "📦 Package: $PACKAGE"
-            echo "📌 Version: $VERSION"
+            echo "Package: $PACKAGE"
+            echo "Version: $VERSION"
          else
-            # 手动触发：从 package.json 读取并 bump 版本
            # Manual trigger: read from package.json and bump version
            PACKAGE="${{ github.event.inputs.package }}"
            echo "package=$PACKAGE" >> $GITHUB_OUTPUT
@@ -112,7 +108,6 @@ jobs:
          PACKAGE="${{ steps.parse.outputs.package }}"
          EXPECTED_VERSION="${{ steps.parse.outputs.version }}"

-          # 获取 package.json 中的版本
          # Get version from package.json
          ACTUAL_VERSION=$(node -p "require('./packages/$PACKAGE/package.json').version")

@@ -125,7 +120,7 @@ jobs:
            exit 1
          fi

-          echo "✅ Version verified: $EXPECTED_VERSION"
+          echo "Version verified: $EXPECTED_VERSION"

      - name: Bump version (manual mode)
        if: steps.parse.outputs.mode == 'manual'
@@ -147,7 +142,7 @@ jobs:
          node -e "const fs=require('fs'); const pkg=JSON.parse(fs.readFileSync('package.json')); pkg.version='$NEW_VERSION'; fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2)+'\n')"

          echo "version=$NEW_VERSION" >> $GITHUB_OUTPUT
-          echo "📌 Bumped version: $CURRENT → $NEW_VERSION"
+          echo "Bumped version: $CURRENT -> $NEW_VERSION"

      - name: Set final version
        id: version
@@ -161,7 +156,7 @@ jobs:
      - name: Build core package (if needed)
        if: ${{ steps.parse.outputs.package != 'core' && steps.parse.outputs.package != 'node-editor' && steps.parse.outputs.package != 'worker-generator' }}
        run: |
-          cd packages/core
+          cd packages/framework/core
          pnpm run build

      - name: Build node-editor package (if needed for blueprint)
@@ -188,17 +183,18 @@ jobs:
        with:
          tag_name: ${{ steps.parse.outputs.tag }}
          name: "${{ steps.parse.outputs.package }} v${{ steps.version.outputs.value }}"
+          make_latest: false
          body: |
-            ## 🚀 @esengine/${{ steps.parse.outputs.package }} v${{ steps.version.outputs.value }}
+            ## @esengine/${{ steps.parse.outputs.package }} v${{ steps.version.outputs.value }}

-            📦 **NPM**: [@esengine/${{ steps.parse.outputs.package }}@${{ steps.version.outputs.value }}](https://www.npmjs.com/package/@esengine/${{ steps.parse.outputs.package }}/v/${{ steps.version.outputs.value }})
+            **NPM**: [@esengine/${{ steps.parse.outputs.package }}@${{ steps.version.outputs.value }}](https://www.npmjs.com/package/@esengine/${{ steps.parse.outputs.package }}/v/${{ steps.version.outputs.value }})

            ```bash
            npm install @esengine/${{ steps.parse.outputs.package }}@${{ steps.version.outputs.value }}
            ```

            ---
-            *自动发布 | Auto-released by GitHub Actions*
+            *Auto-released by GitHub Actions*
          generate_release_notes: true
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -213,16 +209,16 @@ jobs:
          delete-branch: true
          title: "chore(${{ steps.parse.outputs.package }}): Release v${{ steps.version.outputs.value }}"
          body: |
-            ## 🚀 Release v${{ steps.version.outputs.value }}
+            ## Release v${{ steps.version.outputs.value }}

-            此 PR 更新 `@esengine/${{ steps.parse.outputs.package }}` 包的版本号
+            This PR updates `@esengine/${{ steps.parse.outputs.package }}` package version.

-            ### 变更
-            - ✅ 已发布到 npm: [@esengine/${{ steps.parse.outputs.package }}@${{ steps.version.outputs.value }}](https://www.npmjs.com/package/@esengine/${{ steps.parse.outputs.package }}/v/${{ steps.version.outputs.value }})
-            - ✅ 更新 `packages/${{ steps.parse.outputs.package }}/package.json` → `${{ steps.version.outputs.value }}`
+            ### Changes
+            - Published to npm: [@esengine/${{ steps.parse.outputs.package }}@${{ steps.version.outputs.value }}](https://www.npmjs.com/package/@esengine/${{ steps.parse.outputs.package }}/v/${{ steps.version.outputs.value }})
+            - Updated `packages/${{ steps.parse.outputs.package }}/package.json` to `${{ steps.version.outputs.value }}`

            ---
-            *此 PR 由发布工作流自动创建*
+            *This PR was automatically created by the release workflow*
          labels: |
            release
            ${{ steps.parse.outputs.package }}
--- a/.github/workflows/size-limit.yml
+++ b/.github/workflows/size-limit.yml
@@ -1,46 +0,0 @@
-name: Size Limit
-
-on:
-  pull_request:
-    branches:
-      - master
-      - main
-    paths:
-      - 'packages/core/src/**'
-      - 'packages/core/package.json'
-      - '.size-limit.json'
-
-permissions:
-  contents: read
-  pull-requests: write
-  issues: write
-
-jobs:
-  size:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20.x'
-          cache: 'pnpm'
-
-      - name: Install dependencies
-        run: pnpm install
-
-      - name: Build core package
-        run: |
-          cd packages/core
-          pnpm run build:npm
-
-      - name: Check bundle size
-        uses: andresz1/size-limit-action@v1
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          skip_step: install
--- a/.github/workflows/welcome.yml
+++ b/.github/workflows/welcome.yml
@@ -1,58 +0,0 @@
-name: Welcome
-
-on:
-  issues:
-    types: [opened]
-  pull_request_target:
-    types: [opened]
-
-permissions:
-  issues: write
-  pull-requests: write
-
-jobs:
-  welcome:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Welcome new contributors
-        uses: actions/first-interaction@v1.3.0
-        with:
-          repo-token: ${{ secrets.GITHUB_TOKEN }}
-          issue-message: |
-            👋 你好！感谢你提交第一个 issue！
-
-            我们会尽快查看并回复。同时，建议你：
-            - 📚 查看[文档](https://esengine.github.io/ecs-framework/)
-            - 🤖 使用 [AI 文档助手](https://deepwiki.com/esengine/esengine)
-            - 💬 加入 [QQ 交流群](https://jq.qq.com/?_wv=1027&k=29w1Nud6)
-
-            ---
-
-            👋 Hello! Thanks for opening your first issue!
-
-            We'll review it as soon as possible. Meanwhile, you might want to:
-            - 📚 Check the [documentation](https://esengine.github.io/ecs-framework/)
-            - 🤖 Use [AI documentation assistant](https://deepwiki.com/esengine/esengine)
-
-          pr-message: |
-            👋 你好！感谢你提交第一个 Pull Request！
-
-            在我们 Review 之前，请确保：
-            - ✅ 代码遵循项目规范
-            - ✅ 通过所有测试
-            - ✅ 更新了相关文档
-            - ✅ Commit 遵循 [Conventional Commits](https://www.conventionalcommits.org/) 规范
-
-            查看完整的[贡献指南](https://github.com/esengine/esengine/blob/master/CONTRIBUTING.md)。
-
-            ---
-
-            👋 Hello! Thanks for your first Pull Request!
-
-            Before we review, please ensure:
-            - ✅ Code follows project conventions
-            - ✅ All tests pass
-            - ✅ Documentation is updated
-            - ✅ Commits follow [Conventional Commits](https://www.conventionalcommits.org/)
-
-            See the full [Contributing Guide](https://github.com/esengine/esengine/blob/master/CONTRIBUTING.md).
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@
 </h1>

 <p align="center">
-  <strong>Cross-platform 2D Game Engine</strong>
+  <strong>Modular Game Framework for TypeScript</strong>
 </p>

 <p align="center">
@@ -23,64 +23,58 @@
 <p align="center">
  <a href="https://esengine.cn/">Documentation</a> ·
  <a href="https://esengine.cn/api/README">API Reference</a> ·
-  <a href="https://github.com/esengine/esengine/releases">Download Editor</a> ·
  <a href="./examples/">Examples</a>
 </p>

 ---

-> **Just need ECS?** The core ECS framework [`@esengine/ecs-framework`](./packages/core/) can be used standalone with Cocos Creator, Laya, or any JS engine. [View ECS Documentation](./packages/core/README.md)
+## What is ESEngine?

-## Overview
+ESEngine is a collection of **engine-agnostic game development modules** for TypeScript. Use them with Cocos Creator, Laya, Phaser, PixiJS, or any JavaScript game engine.

-ESEngine is a cross-platform 2D game engine built from the ground up with modern web technologies. It provides a comprehensive toolset that enables developers to focus on creating games rather than building infrastructure.
-
-Export your games to multiple platforms including web browsers, WeChat Mini Games, and other mini-game platforms from a single codebase.
-
-## Key Features
-
-| Feature | Description |
-|---------|-------------|
-| **ECS Architecture** | Data-driven Entity-Component-System pattern for flexible and cache-friendly game logic |
-| **High-Performance Rendering** | Rust/WebAssembly 2D renderer with automatic sprite batching and WebGL 2.0 backend |
-| **Visual Editor** | Cross-platform desktop editor built with Tauri for scene management and asset workflows |
-| **Modular Design** | Import only what you need - each feature is a standalone package |
-| **Multi-Platform Export** | Deploy to Web, WeChat Mini Games, and more from one codebase |
-| **Physics Integration** | 2D physics powered by Rapier with editor visualization |
-| **Visual Scripting** | Behavior trees and blueprint system for designers |
-
-## Tech Stack
-
- **Runtime**: TypeScript, Rust, WebAssembly
- **Renderer**: WebGL 2.0, WGPU (planned)
- **Editor**: Tauri, React, Zustand
- **Physics**: Rapier2D
- **Build**: pnpm, Turborepo, Rollup
-
-## License
-
-ESEngine is **free and open source** under the [MIT License](LICENSE). No royalties, no strings attached.
-
-## Installation
-
-### npm
+The core is a high-performance **ECS (Entity-Component-System)** framework, accompanied by optional modules for AI, networking, physics, and more.

 ```bash
 npm install @esengine/ecs-framework
 ```

-### Editor
+## Features

-Download pre-built binaries from the [Releases](https://github.com/esengine/esengine/releases) page (Windows, macOS).
+| Module | Description | Engine Required |
+|--------|-------------|:---------------:|
+| **ECS Core** | Entity-Component-System framework with reactive queries | No |
+| **Behavior Tree** | AI behavior trees with visual editor support | No |
+| **Blueprint** | Visual scripting system | No |
+| **FSM** | Finite state machine | No |
+| **Timer** | Timer and cooldown systems | No |
+| **Spatial** | Spatial indexing and queries (QuadTree, Grid) | No |
+| **Pathfinding** | A* and navigation mesh pathfinding | No |
+| **Network** | Client/server networking with TSRPC | No |
+
+> All framework modules can be used standalone with any rendering engine.

 ## Quick Start

+### Using CLI (Recommended)
+
+The easiest way to add ECS to your existing project:
+
+```bash
+# In your project directory
+npx @esengine/cli init
+```
+
+The CLI automatically detects your project type (Cocos Creator 2.x/3.x, LayaAir 3.x, or Node.js) and generates the necessary integration code.
+
+### Manual Setup
+
 ```typescript
 import {
    Core, Scene, Entity, Component, EntitySystem,
    Matcher, Time, ECSComponent, ECSSystem
 } from '@esengine/ecs-framework';

+// Define components (data only)
@ECSComponent('Position')
 class Position extends Component {
    x = 0;
@@ -93,6 +87,7 @@ class Velocity extends Component {
    dy = 0;
 }

+// Define system (logic)
@ECSSystem('Movement')
 class MovementSystem extends EntitySystem {
    constructor() {
@@ -120,7 +115,7 @@ player.addComponent(new Velocity());

 Core.setScene(scene);

-// Game loop
+// Integrate with your game loop
 function gameLoop(currentTime: number) {
    Core.update(currentTime / 1000);
    requestAnimationFrame(gameLoop);
@@ -128,109 +123,132 @@ function gameLoop(currentTime: number) {
 requestAnimationFrame(gameLoop);
 ```

-## Packages
+## Using with Other Engines

-ESEngine is organized as a monorepo with 50+ modular packages. Install only what you need.
+ESEngine's framework modules are designed to work alongside your preferred rendering engine:

-### Essential
+### With Cocos Creator

-```bash
-npm install @esengine/ecs-framework  # Core ECS (can be used standalone)
-npm install @esengine/engine-core    # Full engine with module system
+```typescript
+import { Component as CCComponent, _decorator } from 'cc';
+import { Core, Scene, Matcher, EntitySystem } from '@esengine/ecs-framework';
+import { BehaviorTreeExecutionSystem } from '@esengine/behavior-tree';
+
+const { ccclass } = _decorator;
+
+@ccclass('GameManager')
+export class GameManager extends CCComponent {
+    private ecsScene!: Scene;
+
+    start() {
+        Core.create();
+        this.ecsScene = new Scene();
+
+        // Add ECS systems
+        this.ecsScene.addSystem(new BehaviorTreeExecutionSystem());
+        this.ecsScene.addSystem(new MyGameSystem());
+
+        Core.setScene(this.ecsScene);
+    }
+
+    update(dt: number) {
+        Core.update(dt);
+    }
+}
 ```

-### Popular Modules
+### With Laya 3.x
+
+```typescript
+import { Core, Scene } from '@esengine/ecs-framework';
+import { FSMSystem } from '@esengine/fsm';
+
+const { regClass } = Laya;
+
+@regClass()
+export class ECSManager extends Laya.Script {
+    private ecsScene = new Scene();
+
+    onAwake(): void {
+        Core.create();
+        this.ecsScene.addSystem(new FSMSystem());
+        Core.setScene(this.ecsScene);
+    }
+
+    onUpdate(): void {
+        Core.update(Laya.timer.delta / 1000);
+    }
+
+    onDestroy(): void {
+        Core.destroy();
+    }
+}
+```
+
+## Packages
+
+### Framework (Engine-Agnostic)
+
+These packages have **zero rendering dependencies** and work with any engine:
+
+```bash
+npm install @esengine/ecs-framework      # Core ECS
+npm install @esengine/behavior-tree      # AI behavior trees
+npm install @esengine/blueprint          # Visual scripting
+npm install @esengine/fsm                # State machines
+npm install @esengine/timer              # Timers & cooldowns
+npm install @esengine/spatial            # Spatial indexing
+npm install @esengine/pathfinding        # Pathfinding
+npm install @esengine/network            # Networking
+```
+
+### ESEngine Runtime (Optional)
+
+If you want a complete engine solution with rendering:

 | Category | Packages |
 |----------|----------|
-| **Rendering** | `sprite`, `tilemap`, `particle`, `mesh-3d`, `fairygui` |
+| **Core** | `engine-core`, `asset-system`, `material-system` |
+| **Rendering** | `sprite`, `tilemap`, `particle`, `camera`, `mesh-3d` |
 | **Physics** | `physics-rapier2d` |
-| **AI & Logic** | `behavior-tree`, `blueprint` |
-| **Network** | `network`, `network-server` |
 | **Platform** | `platform-web`, `platform-wechat` |

-<details>
-<summary><b>View all 50+ packages</b></summary>
+### Editor (Optional)

-#### Core
- `@esengine/ecs-framework` - ECS framework core
- `@esengine/math` - Vector, matrix utilities
- `@esengine/engine` - Rust/WASM renderer
- `@esengine/engine-core` - Module lifecycle
+A visual editor built with Tauri for scene management:

-#### Runtime
- `@esengine/sprite` - 2D sprites & animation
- `@esengine/tilemap` - Tile-based maps
- `@esengine/particle` - Particle effects
- `@esengine/physics-rapier2d` - 2D physics
- `@esengine/behavior-tree` - AI behavior trees
- `@esengine/blueprint` - Visual scripting
- `@esengine/camera` - Camera system
- `@esengine/audio` - Audio playback
- `@esengine/fairygui` - FairyGUI integration
- `@esengine/mesh-3d` - 3D mesh (FBX/GLTF/OBJ)
- `@esengine/material-system` - Materials & shaders
- `@esengine/asset-system` - Asset management
- `@esengine/world-streaming` - Large world streaming
+- Download from [Releases](https://github.com/esengine/esengine/releases)
+- Supports behavior tree editing, tilemap painting, visual scripting

-#### Network
- `@esengine/network` - Client (TSRPC)
- `@esengine/network-server` - Server runtime
- `@esengine/network-protocols` - Shared protocols
+## Project Structure

-#### Editor Extensions
-All runtime modules have corresponding `-editor` packages for visual editing.
-
-#### Platform
- `@esengine/platform-common` - Platform abstraction
- `@esengine/platform-web` - Web runtime
- `@esengine/platform-wechat` - WeChat Mini Game
-
-</details>
-
-## Editor
-
-The ESEngine Editor is a cross-platform desktop application built with Tauri and React.
-
-### Features
-
- Scene hierarchy and entity management
- Component inspector with custom property editors
- Asset browser with drag-and-drop
- Tilemap editor with paint and fill tools
- Behavior tree visual editor
- Blueprint visual scripting
- Material and shader editing
- Built-in performance profiler
- Localization (English, Chinese)
-
-### Screenshot
-
-![ESEngine Editor](screenshots/main_screetshot.png)
-
-## Platform Support
-
-| Platform | Runtime | Editor |
-|----------|:-------:|:------:|
-| Web Browser | ✓ | - |
-| Windows | - | ✓ |
-| macOS | - | ✓ |
-| WeChat Mini Game | In Progress | - |
-| Playable Ads | Planned | - |
-| Android | Planned | - |
-| iOS | Planned | - |
+```
+esengine/
+├── packages/
+│   ├── framework/          # Engine-agnostic modules (NPM publishable)
+│   │   ├── core/          # ECS Framework
+│   │   ├── math/          # Math utilities
+│   │   ├── behavior-tree/ # AI behavior trees
+│   │   ├── blueprint/     # Visual scripting
+│   │   ├── fsm/           # Finite state machine
+│   │   ├── timer/         # Timer system
+│   │   ├── spatial/       # Spatial queries
+│   │   ├── pathfinding/   # Pathfinding
+│   │   ├── procgen/       # Procedural generation
+│   │   └── network/       # Networking
+│   │
+│   ├── engine/            # ESEngine runtime
+│   ├── rendering/         # Rendering modules
+│   ├── physics/           # Physics modules
+│   ├── editor/            # Visual editor
+│   └── rust/              # WASM renderer
+│
+├── docs/                   # Documentation
+└── examples/               # Examples
+```

 ## Building from Source

-### Prerequisites
-
- Node.js 18+
- pnpm 10+
- Rust toolchain (for WASM renderer)
- wasm-pack
-
-### Setup
-
 ```bash
 git clone https://github.com/esengine/esengine.git
 cd esengine
@@ -238,54 +256,28 @@ cd esengine
 pnpm install
 pnpm build

-# Optional: Build WASM renderer
-pnpm build:wasm
+# Type check framework packages
+pnpm type-check:framework
+
+# Run tests
+pnpm test
 ```

-### Run Editor
-
-```bash
-cd packages/editor-app
-pnpm tauri:dev
-```
-
-### Project Structure
-
-```
-esengine/
-├── packages/
-│   ├── core/                    # ECS Framework (@esengine/ecs-framework)
-│   ├── math/                    # Math library (@esengine/math)
-│   ├── engine-core/             # Engine lifecycle management
-│   ├── sprite/                  # 2D sprite rendering
-│   ├── tilemap/                 # Tilemap system
-│   ├── physics-rapier2d/        # Physics engine
-│   ├── behavior-tree/           # AI behavior trees
-│   ├── editor-app/              # Desktop editor (Tauri)
-│   └── ...                      # Other modules
-├── docs/                        # Documentation source
-├── examples/                    # Example projects
-├── scripts/                     # Build utilities
-└── thirdparty/                  # Third-party dependencies
-```
-
-> **Looking for ECS source code?** The ECS framework is in `packages/core/`
-
 ## Documentation

- [Getting Started](https://esengine.cn/guide/getting-started.html)
- [Architecture Guide](https://esengine.cn/guide/)
+- [ECS Framework Guide](./packages/framework/core/README.md)
+- [Behavior Tree Guide](./packages/framework/behavior-tree/README.md)
 - [API Reference](https://esengine.cn/api/README)

 ## Community

- [Discord](https://discord.gg/gCAgzXFW) - Chat with the community
 - [GitHub Issues](https://github.com/esengine/esengine/issues) - Bug reports and feature requests
 - [GitHub Discussions](https://github.com/esengine/esengine/discussions) - Questions and ideas
+- [Discord](https://discord.gg/gCAgzXFW) - Chat with the community

 ## Contributing

-Contributions are welcome. Please read the contributing guidelines before submitting a pull request.
+Contributions are welcome! Please read our contributing guidelines before submitting a pull request.

 1. Fork the repository
 2. Create a feature branch (`git checkout -b feature/amazing-feature`)
@@ -295,10 +287,10 @@ Contributions are welcome. Please read the contributing guidelines before submit

 ## License

-ESEngine is licensed under the [MIT License](LICENSE).
+ESEngine is licensed under the [MIT License](LICENSE). Free for personal and commercial use.

 ---

 <p align="center">
-  Made with ❤️ by the ESEngine team
+  Made with care by the ESEngine community
 </p>
--- a/README_CN.md
+++ b/README_CN.md
@@ -5,7 +5,7 @@
 </h1>

 <p align="center">
-  <strong>跨平台 2D 游戏引擎</strong>
+  <strong>TypeScript 模块化游戏框架</strong>
 </p>

 <p align="center">
@@ -23,64 +23,58 @@
 <p align="center">
  <a href="https://esengine.cn/">文档</a> ·
  <a href="https://esengine.cn/api/README">API 参考</a> ·
-  <a href="https://github.com/esengine/esengine/releases">下载编辑器</a> ·
  <a href="./examples/">示例</a>
 </p>

 ---

-> **只需要 ECS？** 核心 ECS 框架 [`@esengine/ecs-framework`](./packages/core/) 可独立使用，支持 Cocos Creator、Laya 或任何 JS 引擎。[查看 ECS 文档](./packages/core/README_CN.md)
+## ESEngine 是什么？

-## 概述
+ESEngine 是一套**引擎无关的游戏开发模块**，可与 Cocos Creator、Laya、Phaser、PixiJS 等任何 JavaScript 游戏引擎配合使用。

-ESEngine 是一款基于现代 Web 技术从零构建的跨平台 2D 游戏引擎。它提供完整的工具集，让开发者专注于游戏创作而非基础设施搭建。
-
-一套代码即可导出到 Web 浏览器、微信小游戏等多个平台。
-
-## 核心特性
-
-| 特性 | 描述 |
-|-----|------|
-| **ECS 架构** | 数据驱动的实体-组件-系统模式，提供灵活且缓存友好的游戏逻辑 |
-| **高性能渲染** | Rust/WebAssembly 2D 渲染器，支持自动精灵批处理和 WebGL 2.0 |
-| **可视化编辑器** | 基于 Tauri 的跨平台桌面编辑器，支持场景管理和资源工作流 |
-| **模块化设计** | 按需引入，每个功能都是独立的包 |
-| **多平台导出** | 一套代码部署到 Web、微信小游戏等平台 |
-| **物理集成** | 基于 Rapier 的 2D 物理，支持编辑器可视化 |
-| **可视化脚本** | 行为树和蓝图系统，适合策划使用 |
-
-## 技术栈
-
- **运行时**: TypeScript, Rust, WebAssembly
- **渲染器**: WebGL 2.0, WGPU (计划中)
- **编辑器**: Tauri, React, Zustand
- **物理**: Rapier2D
- **构建**: pnpm, Turborepo, Rollup
-
-## 许可证
-
-ESEngine **完全免费开源**，采用 [MIT 协议](LICENSE)。无版税，无附加条件。
-
-## 安装
-
-### npm
+核心是一个高性能的 **ECS（实体-组件-系统）** 框架，配套 AI、网络、物理等可选模块。

 ```bash
 npm install @esengine/ecs-framework
 ```

-### 编辑器
+## 功能模块

-从 [Releases](https://github.com/esengine/esengine/releases) 页面下载预编译版本（支持 Windows、macOS）。
+| 模块 | 描述 | 需要渲染引擎 |
+|------|------|:----------:|
+| **ECS 核心** | 实体-组件-系统框架，支持响应式查询 | 否 |
+| **行为树** | AI 行为树，支持可视化编辑 | 否 |
+| **蓝图** | 可视化脚本系统 | 否 |
+| **状态机** | 有限状态机 | 否 |
+| **定时器** | 定时器和冷却系统 | 否 |
+| **空间索引** | 空间查询（四叉树、网格） | 否 |
+| **寻路** | A* 和导航网格寻路 | 否 |
+| **网络** | 客户端/服务端网络通信 (TSRPC) | 否 |
+
+> 所有框架模块都可以独立使用，无需依赖特定渲染引擎。

 ## 快速开始

+### 使用 CLI（推荐）
+
+在现有项目中添加 ECS 的最简单方式：
+
+```bash
+# 在项目目录中运行
+npx @esengine/cli init
+```
+
+CLI 会自动检测项目类型（Cocos Creator 2.x/3.x、LayaAir 3.x 或 Node.js）并生成相应的集成代码。
+
+### 手动配置
+
 ```typescript
 import {
    Core, Scene, Entity, Component, EntitySystem,
    Matcher, Time, ECSComponent, ECSSystem
 } from '@esengine/ecs-framework';

+// 定义组件（纯数据）
@ECSComponent('Position')
 class Position extends Component {
    x = 0;
@@ -93,6 +87,7 @@ class Velocity extends Component {
    dy = 0;
 }

+// 定义系统（逻辑）
@ECSSystem('Movement')
 class MovementSystem extends EntitySystem {
    constructor() {
@@ -120,7 +115,7 @@ player.addComponent(new Velocity());

 Core.setScene(scene);

-// 游戏循环
+// 集成到你的游戏循环
 function gameLoop(currentTime: number) {
    Core.update(currentTime / 1000);
    requestAnimationFrame(gameLoop);
@@ -128,109 +123,132 @@ function gameLoop(currentTime: number) {
 requestAnimationFrame(gameLoop);
 ```

-## 模块
+## 与其他引擎配合使用

-ESEngine 采用 Monorepo 组织，包含 50+ 个模块化包。按需引入即可。
+ESEngine 的框架模块设计为可与你喜欢的渲染引擎配合使用：

-### 核心安装
+### 与 Cocos Creator 配合

-```bash
-npm install @esengine/ecs-framework  # ECS 核心（可独立使用）
-npm install @esengine/engine-core    # 完整引擎模块系统
+```typescript
+import { Component as CCComponent, _decorator } from 'cc';
+import { Core, Scene, Matcher, EntitySystem } from '@esengine/ecs-framework';
+import { BehaviorTreeExecutionSystem } from '@esengine/behavior-tree';
+
+const { ccclass } = _decorator;
+
+@ccclass('GameManager')
+export class GameManager extends CCComponent {
+    private ecsScene!: Scene;
+
+    start() {
+        Core.create();
+        this.ecsScene = new Scene();
+
+        // 添加 ECS 系统
+        this.ecsScene.addSystem(new BehaviorTreeExecutionSystem());
+        this.ecsScene.addSystem(new MyGameSystem());
+
+        Core.setScene(this.ecsScene);
+    }
+
+    update(dt: number) {
+        Core.update(dt);
+    }
+}
 ```

-### 常用模块
+### 与 Laya 3.x 配合
+
+```typescript
+import { Core, Scene } from '@esengine/ecs-framework';
+import { FSMSystem } from '@esengine/fsm';
+
+const { regClass } = Laya;
+
+@regClass()
+export class ECSManager extends Laya.Script {
+    private ecsScene = new Scene();
+
+    onAwake(): void {
+        Core.create();
+        this.ecsScene.addSystem(new FSMSystem());
+        Core.setScene(this.ecsScene);
+    }
+
+    onUpdate(): void {
+        Core.update(Laya.timer.delta / 1000);
+    }
+
+    onDestroy(): void {
+        Core.destroy();
+    }
+}
+```
+
+## 包列表
+
+### 框架包（引擎无关）
+
+这些包**零渲染依赖**，可与任何引擎配合使用：
+
+```bash
+npm install @esengine/ecs-framework      # ECS 核心
+npm install @esengine/behavior-tree      # AI 行为树
+npm install @esengine/blueprint          # 可视化脚本
+npm install @esengine/fsm                # 状态机
+npm install @esengine/timer              # 定时器和冷却
+npm install @esengine/spatial            # 空间索引
+npm install @esengine/pathfinding        # 寻路
+npm install @esengine/network            # 网络
+```
+
+### ESEngine 运行时（可选）
+
+如果你需要完整的引擎解决方案：

 | 分类 | 包名 |
 |------|------|
-| **渲染** | `sprite`, `tilemap`, `particle`, `mesh-3d`, `fairygui` |
+| **核心** | `engine-core`, `asset-system`, `material-system` |
+| **渲染** | `sprite`, `tilemap`, `particle`, `camera`, `mesh-3d` |
 | **物理** | `physics-rapier2d` |
-| **AI 逻辑** | `behavior-tree`, `blueprint` |
-| **网络** | `network`, `network-server` |
 | **平台** | `platform-web`, `platform-wechat` |

-<details>
-<summary><b>查看全部 50+ 个包</b></summary>
+### 编辑器（可选）

-#### 核心
- `@esengine/ecs-framework` - ECS 框架核心
- `@esengine/math` - 向量、矩阵工具
- `@esengine/engine` - Rust/WASM 渲染器
- `@esengine/engine-core` - 模块生命周期
+基于 Tauri 构建的可视化编辑器：

-#### 运行时
- `@esengine/sprite` - 2D 精灵和动画
- `@esengine/tilemap` - 瓦片地图
- `@esengine/particle` - 粒子特效
- `@esengine/physics-rapier2d` - 2D 物理
- `@esengine/behavior-tree` - AI 行为树
- `@esengine/blueprint` - 可视化脚本
- `@esengine/camera` - 相机系统
- `@esengine/audio` - 音频播放
- `@esengine/fairygui` - FairyGUI 集成
- `@esengine/mesh-3d` - 3D 模型 (FBX/GLTF/OBJ)
- `@esengine/material-system` - 材质和着色器
- `@esengine/asset-system` - 资源管理
- `@esengine/world-streaming` - 大世界流式加载
+- 从 [Releases](https://github.com/esengine/esengine/releases) 下载
+- 支持行为树编辑、Tilemap 绘制、可视化脚本

-#### 网络
- `@esengine/network` - 客户端 (TSRPC)
- `@esengine/network-server` - 服务端运行时
- `@esengine/network-protocols` - 共享协议
+## 项目结构

-#### 编辑器扩展
-所有运行时模块都有对应的 `-editor` 包用于可视化编辑。
-
-#### 平台
- `@esengine/platform-common` - 平台抽象层
- `@esengine/platform-web` - Web 运行时
- `@esengine/platform-wechat` - 微信小游戏
-
-</details>
-
-## 编辑器
-
-ESEngine 编辑器是基于 Tauri 和 React 构建的跨平台桌面应用。
-
-### 功能
-
- 场景层级和实体管理
- 组件检视器，支持自定义属性编辑器
- 资源浏览器，支持拖放
- Tilemap 编辑器，支持绘制和填充工具
- 行为树可视化编辑器
- 蓝图可视化脚本
- 材质和着色器编辑
- 内置性能分析器
- 多语言支持（英文、中文）
-
-### 截图
-
-![ESEngine Editor](screenshots/main_screetshot.png)
-
-## 平台支持
-
-| 平台 | 运行时 | 编辑器 |
-|------|:------:|:------:|
-| Web 浏览器 | ✓ | - |
-| Windows | - | ✓ |
-| macOS | - | ✓ |
-| 微信小游戏 | 开发中 | - |
-| Playable 可玩广告 | 计划中 | - |
-| Android | 计划中 | - |
-| iOS | 计划中 | - |
+```
+esengine/
+├── packages/
+│   ├── framework/          # 引擎无关模块（可发布到 NPM）
+│   │   ├── core/          # ECS 框架
+│   │   ├── math/          # 数学工具
+│   │   ├── behavior-tree/ # AI 行为树
+│   │   ├── blueprint/     # 可视化脚本
+│   │   ├── fsm/           # 有限状态机
+│   │   ├── timer/         # 定时器系统
+│   │   ├── spatial/       # 空间查询
+│   │   ├── pathfinding/   # 寻路
+│   │   ├── procgen/       # 程序化生成
+│   │   └── network/       # 网络
+│   │
+│   ├── engine/            # ESEngine 运行时
+│   ├── rendering/         # 渲染模块
+│   ├── physics/           # 物理模块
+│   ├── editor/            # 可视化编辑器
+│   └── rust/              # WASM 渲染器
+│
+├── docs/                   # 文档
+└── examples/               # 示例
+```

 ## 从源码构建

-### 前置要求
-
- Node.js 18+
- pnpm 10+
- Rust 工具链（用于 WASM 渲染器）
- wasm-pack
-
-### 安装
-
 ```bash
 git clone https://github.com/esengine/esengine.git
 cd esengine
@@ -238,55 +256,29 @@ cd esengine
 pnpm install
 pnpm build

-# 可选：构建 WASM 渲染器
-pnpm build:wasm
+# 框架包类型检查
+pnpm type-check:framework
+
+# 运行测试
+pnpm test
 ```

-### 运行编辑器
-
-```bash
-cd packages/editor-app
-pnpm tauri:dev
-```
-
-### 项目结构
-
-```
-esengine/
-├── packages/
-│   ├── core/                    # ECS 框架 (@esengine/ecs-framework)
-│   ├── math/                    # 数学库 (@esengine/math)
-│   ├── engine-core/             # 引擎生命周期管理
-│   ├── sprite/                  # 2D 精灵渲染
-│   ├── tilemap/                 # Tilemap 系统
-│   ├── physics-rapier2d/        # 物理引擎
-│   ├── behavior-tree/           # AI 行为树
-│   ├── editor-app/              # 桌面编辑器 (Tauri)
-│   └── ...                      # 其他模块
-├── docs/                        # 文档源码
-├── examples/                    # 示例项目
-├── scripts/                     # 构建工具
-└── thirdparty/                  # 第三方依赖
-```
-
-> **寻找 ECS 源码？** ECS 框架位于 `packages/core/`
-
 ## 文档

- [快速入门](https://esengine.cn/guide/getting-started.html)
- [架构指南](https://esengine.cn/guide/)
+- [ECS 框架指南](./packages/framework/core/README.md)
+- [行为树指南](./packages/framework/behavior-tree/README.md)
 - [API 参考](https://esengine.cn/api/README)

 ## 社区

- [Discord](https://discord.gg/gCAgzXFW) - 国际社区
 - [QQ 交流群](https://jq.qq.com/?_wv=1027&k=29w1Nud6) - 中文社区
+- [Discord](https://discord.gg/gCAgzXFW) - 国际社区
 - [GitHub Issues](https://github.com/esengine/esengine/issues) - Bug 反馈和功能建议
 - [GitHub Discussions](https://github.com/esengine/esengine/discussions) - 问题和想法

 ## 贡献

-欢迎贡献代码。提交 PR 前请阅读贡献指南。
+欢迎贡献代码！提交 PR 前请阅读贡献指南。

 1. Fork 仓库
 2. 创建功能分支 (`git checkout -b feature/amazing-feature`)
@@ -296,10 +288,10 @@ esengine/

 ## 许可证

-ESEngine 基于 [MIT 协议](LICENSE) 开源。
+ESEngine 基于 [MIT 协议](LICENSE) 开源，个人和商业使用均免费。

 ---

 <p align="center">
-  由 ESEngine 团队用 ❤️ 打造
+  由 ESEngine 社区用心打造
 </p>
--- a/docs/.vitepress/config.mjs
+++ b/docs/.vitepress/config.mjs
@@ -6,7 +6,7 @@ import { fileURLToPath } from 'url'

 const __dirname = dirname(fileURLToPath(import.meta.url))
 const corePackageJson = JSON.parse(
-  readFileSync(join(__dirname, '../../packages/core/package.json'), 'utf-8')
+  readFileSync(join(__dirname, '../../packages/framework/core/package.json'), 'utf-8')
 )

 // Import i18n messages
--- a/docs/changelog.md
+++ b/docs/changelog.md
@@ -4,6 +4,36 @@

 ---

+## v2.4.2 (2025-12-25)
+
+### Features
+
+- **IncrementalSerializer 实体过滤**: 增量序列化支持 `entityFilter` 选项 (#335)
+  - 创建快照时可按条件过滤实体
+  - 支持按标签、组件类型等自定义过滤逻辑
+  - 适用于只同步部分实体的场景（如只同步玩家）
+
+```typescript
+// 只快照玩家实体
+const snapshot = IncrementalSerializer.createSnapshot(scene, {
+    entityFilter: (entity) => entity.tag === PLAYER_TAG
+});
+
+// 只快照有特定组件的实体
+const snapshot = IncrementalSerializer.createSnapshot(scene, {
+    entityFilter: (entity) => entity.hasComponent(PlayerMarker)
+});
+```
+
+### Refactor
+
+- 优化 `PlatformWorkerPool` 代码规范，提取为独立模块 (#335)
+- 优化 `WorkerEntitySystem` 实现，改进代码结构 (#334)
+- 代码规范化与依赖清理 (#317)
+- 代码结构优化，添加 `GlobalTypes.ts` 统一类型定义 (#316)
+
+---
+
 ## v2.4.1 (2025-12-23)

 ### Bug Fixes
--- a/docs/en/changelog.md
+++ b/docs/en/changelog.md
@@ -4,6 +4,36 @@ This document records the version update history of the `@esengine/ecs-framework

 ---

+## v2.4.2 (2025-12-25)
+
+### Features
+
+- **IncrementalSerializer Entity Filter**: Incremental serialization supports `entityFilter` option (#335)
+  - Filter entities by condition when creating snapshots
+  - Support custom filter logic by tag, component type, etc.
+  - Suitable for scenarios that only sync partial entities (e.g., only sync players)
+
+```typescript
+// Only snapshot player entities
+const snapshot = IncrementalSerializer.createSnapshot(scene, {
+    entityFilter: (entity) => entity.tag === PLAYER_TAG
+});
+
+// Only snapshot entities with specific component
+const snapshot = IncrementalSerializer.createSnapshot(scene, {
+    entityFilter: (entity) => entity.hasComponent(PlayerMarker)
+});
+```
+
+### Refactor
+
+- Optimize `PlatformWorkerPool` code style, extract as standalone module (#335)
+- Optimize `WorkerEntitySystem` implementation, improve code structure (#334)
+- Code standardization and dependency cleanup (#317)
+- Code structure optimization, add `GlobalTypes.ts` for unified type definitions (#316)
+
+---
+
 ## v2.4.1 (2025-12-23)

 ### Bug Fixes
--- a/docs/en/guide/getting-started.md
+++ b/docs/en/guide/getting-started.md
@@ -4,7 +4,24 @@ This guide will help you get started with ECS Framework, from installation to cr

 ## Installation

-### NPM Installation
+### Using CLI (Recommended)
+
+The easiest way to add ECS to your existing project:
+
+```bash
+# In your project directory
+npx @esengine/cli init
+```
+
+The CLI automatically detects your project type (Cocos Creator 2.x/3.x, LayaAir 3.x, or Node.js) and generates the necessary integration code, including:
+
+- `ECSManager` component/script - Manages ECS lifecycle
+- Example components and systems - Helps you get started quickly
+- Automatic dependency installation
+
+### Manual NPM Installation
+
+If you prefer manual configuration:

 ```bash
 # Using npm
@@ -333,27 +350,39 @@ function gameLoop(deltaTime: number) {

 ## Game Engine Integration

-### Laya Engine Integration
+### Laya 3.x Engine Integration
+
+Using `Laya.Script` component to manage ECS lifecycle is recommended:

 ```typescript
-import { Stage } from "laya/display/Stage";
-import { Laya } from "Laya";
-import { Core } from '@esengine/ecs-framework';
+import { Core, Scene } from '@esengine/ecs-framework';

-// Initialize Laya
-Laya.init(800, 600).then(() => {
-  // Initialize ECS
-  Core.create(true);
-  Core.setScene(new GameScene());
+const { regClass } = Laya;

-  // Start game loop
-  Laya.timer.frameLoop(1, this, () => {
-    const deltaTime = Laya.timer.delta / 1000;
-    Core.update(deltaTime);  // Auto-updates global services and scene
-  });
-});
+@regClass()
+export class ECSManager extends Laya.Script {
+  private ecsScene = new GameScene();
+
+  onAwake(): void {
+    // Initialize ECS
+    Core.create({ debug: true });
+    Core.setScene(this.ecsScene);
+  }
+
+  onUpdate(): void {
+    // Auto-updates global services and scene
+    Core.update(Laya.timer.delta / 1000);
+  }
+
+  onDestroy(): void {
+    // Cleanup resources
+    Core.destroy();
+  }
+}
 ```

+In Laya IDE, attach the `ECSManager` script to a node in your scene.
+
 ### Cocos Creator Integration

 ```typescript
--- a/docs/guide/getting-started.md
+++ b/docs/guide/getting-started.md
@@ -4,7 +4,24 @@

 ## 安装

-### NPM 安装
+### 使用 CLI（推荐）
+
+在现有项目中添加 ECS 的最简单方式：
+
+```bash
+# 在项目目录中运行
+npx @esengine/cli init
+```
+
+CLI 会自动检测项目类型（Cocos Creator 2.x/3.x、LayaAir 3.x 或 Node.js）并生成相应的集成代码，包括：
+
+- `ECSManager` 组件/脚本 - 负责 ECS 生命周期管理
+- 示例组件和系统 - 帮助快速上手
+- 自动安装依赖
+
+### NPM 手动安装
+
+如果你更喜欢手动配置，可以直接安装：

 ```bash
 # 使用 npm
@@ -333,27 +350,39 @@ function gameLoop(deltaTime: number) {

 ## 与游戏引擎集成

-### Laya 引擎集成
+### Laya 3.x 引擎集成
+
+推荐使用 `Laya.Script` 组件来管理 ECS 生命周期：

 ```typescript
-import { Stage } from "laya/display/Stage";
-import { Laya } from "Laya";
-import { Core } from '@esengine/ecs-framework';
+import { Core, Scene } from '@esengine/ecs-framework';

-// 初始化 Laya
-Laya.init(800, 600).then(() => {
-  // 初始化 ECS
-  Core.create(true);
-  Core.setScene(new GameScene());
+const { regClass } = Laya;

-  // 启动游戏循环
-  Laya.timer.frameLoop(1, this, () => {
-    const deltaTime = Laya.timer.delta / 1000;
-    Core.update(deltaTime);  // 自动更新全局服务和场景
-  });
-});
+@regClass()
+export class ECSManager extends Laya.Script {
+  private ecsScene = new GameScene();
+
+  onAwake(): void {
+    // 初始化 ECS
+    Core.create({ debug: true });
+    Core.setScene(this.ecsScene);
+  }
+
+  onUpdate(): void {
+    // 自动更新全局服务和场景
+    Core.update(Laya.timer.delta / 1000);
+  }
+
+  onDestroy(): void {
+    // 清理资源
+    Core.destroy();
+  }
+}
 ```

+在 Laya IDE 中，将 `ECSManager` 脚本挂载到场景中的节点上即可。
+
 ### Cocos Creator 集成

 ```typescript
--- a/package.json
+++ b/package.json
@@ -5,7 +5,16 @@
  "private": true,
  "packageManager": "pnpm@10.22.0",
  "workspaces": [
-    "packages/*"
+    "packages/framework/*",
+    "packages/engine/*",
+    "packages/rendering/*",
+    "packages/physics/*",
+    "packages/streaming/*",
+    "packages/network-ext/*",
+    "packages/editor/*",
+    "packages/editor/plugins/*",
+    "packages/rust/*",
+    "packages/tools/*"
  ],
  "keywords": [
    "ecs",
@@ -17,6 +26,9 @@
    "egret"
  ],
  "scripts": {
+    "changeset": "changeset",
+    "changeset:version": "changeset version",
+    "changeset:publish": "changeset publish",
    "bootstrap": "lerna bootstrap",
    "clean": "turbo run clean",
    "build": "turbo run build",
@@ -25,23 +37,24 @@
    "build:math": "turbo run build --filter=@esengine/ecs-framework-math",
    "build:editor": "turbo run build --filter=@esengine/editor-app...",
    "build:npm": "turbo run build:npm",
-    "build:npm:core": "cd packages/core && npm run build:npm",
-    "build:npm:math": "cd packages/math && npm run build:npm",
+    "build:npm:core": "cd packages/framework/core && npm run build:npm",
+    "build:npm:math": "cd packages/framework/math && npm run build:npm",
    "test": "turbo run test",
    "test:coverage": "turbo run test:coverage",
    "test:ci": "turbo run test:ci",
+    "test:ci:framework": "turbo run test:ci --filter=@esengine/ecs-framework --filter=@esengine/ecs-framework-math --filter=@esengine/behavior-tree --filter=@esengine/blueprint --filter=@esengine/fsm --filter=@esengine/timer --filter=@esengine/spatial --filter=@esengine/procgen --filter=@esengine/pathfinding --filter=@esengine/network-protocols --filter=@esengine/network",
    "prepare:publish": "npm run build:npm && node scripts/pre-publish-check.cjs",
    "sync:versions": "node scripts/sync-versions.cjs",
    "publish:all": "npm run prepare:publish && npm run publish:all:dist",
    "publish:all:dist": "npm run publish:core && npm run publish:math",
-    "publish:core": "cd packages/core && npm run publish:npm",
-    "publish:core:patch": "cd packages/core && npm run publish:patch",
-    "publish:math": "cd packages/math && npm run publish:npm",
-    "publish:math:patch": "cd packages/math && npm run publish:patch",
+    "publish:core": "cd packages/framework/core && npm run publish:npm",
+    "publish:core:patch": "cd packages/framework/core && npm run publish:patch",
+    "publish:math": "cd packages/framework/math && npm run publish:npm",
+    "publish:math:patch": "cd packages/framework/math && npm run publish:patch",
    "publish": "lerna publish",
    "version": "lerna version",
    "release": "semantic-release",
-    "release:core": "cd packages/core && semantic-release",
+    "release:core": "cd packages/framework/core && semantic-release",
    "contributors:add": "all-contributors add",
    "contributors:generate": "all-contributors generate",
    "contributors:check": "all-contributors check",
@@ -55,15 +68,19 @@
    "format": "prettier --write \"packages/**/src/**/*.{ts,tsx,js,jsx}\"",
    "format:check": "prettier --check \"packages/**/src/**/*.{ts,tsx,js,jsx}\"",
    "type-check": "turbo run type-check",
+    "type-check:framework": "turbo run type-check --filter=@esengine/ecs-framework --filter=@esengine/ecs-framework-math --filter=@esengine/behavior-tree --filter=@esengine/blueprint --filter=@esengine/fsm --filter=@esengine/timer --filter=@esengine/spatial --filter=@esengine/procgen --filter=@esengine/pathfinding --filter=@esengine/network-protocols --filter=@esengine/network",
    "lint": "turbo run lint",
+    "lint:framework": "turbo run lint --filter=@esengine/ecs-framework --filter=@esengine/ecs-framework-math --filter=@esengine/behavior-tree --filter=@esengine/blueprint --filter=@esengine/fsm --filter=@esengine/timer --filter=@esengine/spatial --filter=@esengine/procgen --filter=@esengine/pathfinding --filter=@esengine/network-protocols --filter=@esengine/network",
    "lint:fix": "turbo run lint:fix",
-    "build:wasm": "cd packages/engine && wasm-pack build --dev --out-dir pkg",
-    "build:wasm:release": "cd packages/engine && wasm-pack build --release --out-dir pkg",
+    "build:wasm": "cd packages/rust/engine && wasm-pack build --dev --out-dir pkg",
+    "build:wasm:release": "cd packages/rust/engine && wasm-pack build --release --out-dir pkg",
    "copy-modules": "node scripts/copy-engine-modules.mjs"
  },
  "author": "yhh",
  "license": "MIT",
  "devDependencies": {
+    "@changesets/changelog-github": "^0.5.2",
+    "@changesets/cli": "^2.29.8",
    "@commitlint/cli": "^18.6.0",
    "@commitlint/config-conventional": "^18.6.0",
    "@eslint/js": "^9.39.1",
@@ -121,4 +138,3 @@
    "ws": "^8.18.2"
  }
 }
-
--- a/packages/audio/package.json
+++ b/packages/audio/package.json
@@ -1,46 +0,0 @@
-{
-    "name": "@esengine/audio",
-    "version": "1.0.0",
-    "description": "ECS-based audio system",
-    "esengine": {
-        "plugin": true,
-        "pluginExport": "AudioPlugin",
-        "category": "audio",
-        "isEnginePlugin": true
-    },
-    "main": "dist/index.js",
-    "module": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "type": "module",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        }
-    },
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "build": "tsup",
-        "build:watch": "tsup --watch",
-        "type-check": "tsc --noEmit",
-        "clean": "rimraf dist"
-    },
-    "devDependencies": {
-        "@esengine/ecs-framework": "workspace:*",
-        "@esengine/engine-core": "workspace:*",
-        "@esengine/build-config": "workspace:*",
-        "rimraf": "^5.0.5",
-        "tsup": "^8.0.0",
-        "typescript": "^5.3.3"
-    },
-    "keywords": [
-        "ecs",
-        "audio",
-        "sound",
-        "music"
-    ],
-    "author": "yhh",
-    "license": "MIT"
-}
--- a/packages/audio/tsconfig.json
+++ b/packages/audio/tsconfig.json
@@ -1,13 +0,0 @@
-{
-    "extends": "../../tsconfig.base.json",
-    "compilerOptions": {
-        "composite": true,
-        "outDir": "./dist",
-        "rootDir": "./src"
-    },
-    "include": ["src/**/*"],
-    "exclude": ["node_modules", "dist"],
-    "references": [
-        { "path": "../core" }
-    ]
-}
--- a/packages/behavior-tree-editor/package.json
+++ b/packages/behavior-tree-editor/package.json
@@ -1,52 +0,0 @@
-{
-    "name": "@esengine/behavior-tree-editor",
-    "version": "1.0.0",
-    "description": "Editor support for @esengine/behavior-tree - visual editor, inspectors, and tools",
-    "main": "dist/index.js",
-    "module": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "type": "module",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        }
-    },
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "build": "tsup",
-        "build:watch": "tsup --watch",
-        "type-check": "tsc --noEmit",
-        "clean": "rimraf dist"
-    },
-    "dependencies": {
-        "@esengine/behavior-tree": "workspace:*"
-    },
-    "peerDependencies": {
-        "@esengine/editor-core": "workspace:*"
-    },
-    "devDependencies": {
-        "@esengine/ecs-framework": "workspace:*",
-        "@esengine/engine-core": "workspace:*",
-        "@esengine/editor-core": "workspace:*",
-        "@esengine/editor-runtime": "workspace:*",
-        "@esengine/node-editor": "workspace:*",
-        "@esengine/build-config": "workspace:*",
-        "lucide-react": "^0.545.0",
-        "react": "^18.3.1",
-        "zustand": "^5.0.8",
-        "@types/react": "^18.3.12",
-        "rimraf": "^5.0.5",
-        "tsup": "^8.0.0",
-        "typescript": "^5.3.3"
-    },
-    "keywords": [
-        "ecs",
-        "behavior-tree",
-        "editor"
-    ],
-    "author": "",
-    "license": "MIT"
-}
--- a/packages/behavior-tree-editor/tsconfig.json
+++ b/packages/behavior-tree-editor/tsconfig.json
@@ -1,17 +0,0 @@
-{
-    "extends": "../../tsconfig.base.json",
-    "compilerOptions": {
-        "composite": true,
-        "outDir": "./dist",
-        "rootDir": "./src",
-        "declaration": true,
-        "jsx": "react-jsx"
-    },
-    "include": ["src/**/*"],
-    "exclude": ["node_modules", "dist"],
-    "references": [
-        { "path": "../core" },
-        { "path": "../editor-core" },
-        { "path": "../behavior-tree" }
-    ]
-}
--- a/packages/behavior-tree/src/index.ts
+++ b/packages/behavior-tree/src/index.ts
@@ -1,41 +0,0 @@
-/**
- * @esengine/behavior-tree
- *
- * AI Behavior Tree System with runtime execution and visual editor support
- * AI 行为树系统，支持运行时执行和可视化编辑
- *
- * @packageDocumentation
- */
-
-// Constants
-export { BehaviorTreeAssetType } from './constants';
-
-// Types
-export * from './Types/TaskStatus';
-
-// Execution (runtime core)
-export * from './execution';
-
-// Utilities
-export * from './BehaviorTreeStarter';
-export * from './BehaviorTreeBuilder';
-
-// Serialization
-export * from './Serialization/NodeTemplates';
-export * from './Serialization/BehaviorTreeAsset';
-export * from './Serialization/EditorFormatConverter';
-export * from './Serialization/BehaviorTreeAssetSerializer';
-export * from './Serialization/EditorToBehaviorTreeDataConverter';
-
-// Services
-export * from './Services/GlobalBlackboardService';
-
-// Blackboard types (excluding BlackboardValueType which is already exported from TaskStatus)
-export type { BlackboardTypeDefinition } from './Blackboard/BlackboardTypes';
-export { BlackboardTypes } from './Blackboard/BlackboardTypes';
-
-// Runtime module and plugin
-export { BehaviorTreeRuntimeModule, BehaviorTreePlugin } from './BehaviorTreeRuntimeModule';
-
-// Service tokens | 服务令牌
-export { BehaviorTreeSystemToken } from './tokens';
--- a/packages/blueprint-editor/package.json
+++ b/packages/blueprint-editor/package.json
@@ -1,52 +0,0 @@
-{
-    "name": "@esengine/blueprint-editor",
-    "version": "1.0.0",
-    "description": "Editor support for @esengine/blueprint - visual scripting editor",
-    "main": "dist/index.js",
-    "module": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "type": "module",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        }
-    },
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "build": "tsup",
-        "build:watch": "tsup --watch",
-        "type-check": "tsc --noEmit",
-        "clean": "rimraf dist"
-    },
-    "dependencies": {
-        "@esengine/blueprint": "workspace:*"
-    },
-    "peerDependencies": {
-        "@esengine/editor-core": "workspace:*"
-    },
-    "devDependencies": {
-        "@esengine/ecs-framework": "workspace:*",
-        "@esengine/engine-core": "workspace:*",
-        "@esengine/editor-core": "workspace:*",
-        "@esengine/node-editor": "workspace:*",
-        "@esengine/build-config": "workspace:*",
-        "lucide-react": "^0.545.0",
-        "react": "^18.3.1",
-        "zustand": "^5.0.8",
-        "@types/react": "^18.3.12",
-        "rimraf": "^5.0.5",
-        "tsup": "^8.0.0",
-        "typescript": "^5.3.3"
-    },
-    "keywords": [
-        "ecs",
-        "blueprint",
-        "editor",
-        "visual-scripting"
-    ],
-    "author": "",
-    "license": "MIT"
-}
--- a/packages/blueprint/src/index.ts
+++ b/packages/blueprint/src/index.ts
@@ -1,40 +0,0 @@
-/**
- * @esengine/blueprint - Visual scripting system for ECS Framework
- * 蓝图可视化脚本系统
- */
-
-// Types
-export * from './types';
-
-// Runtime
-export * from './runtime';
-
-// Triggers
-export * from './triggers';
-
-// Composition
-export * from './composition';
-
-// Nodes (import to register)
-import './nodes';
-
-// Re-export commonly used items
-export { NodeRegistry, RegisterNode } from './runtime/NodeRegistry';
-export { BlueprintVM } from './runtime/BlueprintVM';
-export {
-    createBlueprintComponentData,
-    initializeBlueprintVM,
-    startBlueprint,
-    stopBlueprint,
-    tickBlueprint,
-    cleanupBlueprint
-} from './runtime/BlueprintComponent';
-export {
-    createBlueprintSystem,
-    triggerBlueprintEvent,
-    triggerCustomBlueprintEvent
-} from './runtime/BlueprintSystem';
-export { createEmptyBlueprint, validateBlueprintAsset } from './types/blueprint';
-
-// Plugin
-export { BlueprintPlugin } from './BlueprintPlugin';
--- a/packages/build-config/package.json
+++ b/packages/build-config/package.json
@@ -1,39 +0,0 @@
-{
-    "name": "@esengine/build-config",
-    "version": "1.0.0",
-    "description": "Shared build configuration for ES Engine packages",
-    "type": "module",
-    "main": "src/index.ts",
-    "exports": {
-        ".": "./src/index.ts",
-        "./presets": "./src/presets/index.ts",
-        "./presets/tsup": "./src/presets/plugin-tsup.ts",
-        "./plugins": "./src/plugins/index.ts"
-    },
-    "scripts": {
-        "type-check": "tsc --noEmit"
-    },
-    "keywords": [
-        "build",
-        "tsup",
-        "config"
-    ],
-    "author": "yhh",
-    "license": "MIT",
-    "devDependencies": {
-        "@vitejs/plugin-react": "^4.3.4",
-        "tsup": "^8.0.0",
-        "typescript": "^5.8.3",
-        "vite": "^6.3.5",
-        "vite-plugin-dts": "^4.5.4"
-    },
-    "peerDependencies": {
-        "tsup": "^8.0.0",
-        "vite": "^6.0.0"
-    },
-    "peerDependenciesMeta": {
-        "vite": {
-            "optional": true
-        }
-    }
-}
--- a/packages/camera-editor/package.json
+++ b/packages/camera-editor/package.json
@@ -1,48 +0,0 @@
-{
-    "name": "@esengine/camera-editor",
-    "version": "1.0.0",
-    "description": "Editor components for camera system",
-    "main": "dist/index.js",
-    "module": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "type": "module",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        }
-    },
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "build": "tsup",
-        "build:watch": "tsup --watch",
-        "type-check": "tsc --noEmit",
-        "clean": "rimraf dist"
-    },
-    "dependencies": {
-        "@esengine/camera": "workspace:*"
-    },
-    "peerDependencies": {
-        "@esengine/editor-core": "workspace:*"
-    },
-    "devDependencies": {
-        "@esengine/ecs-framework": "workspace:*",
-        "@esengine/engine-core": "workspace:*",
-        "@esengine/editor-core": "workspace:*",
-        "@esengine/build-config": "workspace:*",
-        "react": "^18.3.1",
-        "@types/react": "^18.2.0",
-        "rimraf": "^5.0.5",
-        "tsup": "^8.0.0",
-        "typescript": "^5.3.3"
-    },
-    "keywords": [
-        "ecs",
-        "camera",
-        "editor"
-    ],
-    "author": "yhh",
-    "license": "MIT"
-}
--- a/packages/camera-editor/tsconfig.json
+++ b/packages/camera-editor/tsconfig.json
@@ -1,16 +0,0 @@
-{
-    "extends": "../../tsconfig.base.json",
-    "compilerOptions": {
-        "composite": true,
-        "outDir": "./dist",
-        "rootDir": "./src",
-        "jsx": "react-jsx"
-    },
-    "include": ["src/**/*"],
-    "exclude": ["node_modules", "dist"],
-    "references": [
-        { "path": "../core" },
-        { "path": "../camera" },
-        { "path": "../editor-core" }
-    ]
-}
--- a/packages/camera/package.json
+++ b/packages/camera/package.json
@@ -1,48 +0,0 @@
-{
-    "name": "@esengine/camera",
-    "version": "1.0.0",
-    "description": "Camera component and systems for 2D/3D rendering",
-    "esengine": {
-        "plugin": true,
-        "pluginExport": "CameraPlugin",
-        "category": "core",
-        "isEnginePlugin": true
-    },
-    "main": "dist/index.js",
-    "module": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "type": "module",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        }
-    },
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "build": "tsup",
-        "build:watch": "tsup --watch",
-        "type-check": "tsc --noEmit",
-        "clean": "rimraf dist"
-    },
-    "devDependencies": {
-        "@esengine/ecs-framework": "workspace:*",
-        "@esengine/ecs-framework-math": "workspace:*",
-        "@esengine/engine-core": "workspace:*",
-        "@esengine/build-config": "workspace:*",
-        "rimraf": "^5.0.5",
-        "tsup": "^8.0.0",
-        "typescript": "^5.3.3"
-    },
-    "keywords": [
-        "ecs",
-        "camera",
-        "2d",
-        "3d",
-        "rendering"
-    ],
-    "author": "yhh",
-    "license": "MIT"
-}
--- a/packages/camera/tsconfig.json
+++ b/packages/camera/tsconfig.json
@@ -1,13 +0,0 @@
-{
-    "extends": "../../tsconfig.base.json",
-    "compilerOptions": {
-        "composite": true,
-        "outDir": "./dist",
-        "rootDir": "./src"
-    },
-    "include": ["src/**/*"],
-    "exclude": ["node_modules", "dist"],
-    "references": [
-        { "path": "../core" }
-    ]
-}
--- a/packages/camera/tsup.config.ts
+++ b/packages/camera/tsup.config.ts
@@ -1,7 +0,0 @@
-import { defineConfig } from 'tsup';
-import { runtimeOnlyPreset } from '../build-config/src/presets/plugin-tsup';
-
-export default defineConfig({
-    ...runtimeOnlyPreset(),
-    tsconfig: 'tsconfig.build.json'
-});
--- a/packages/ecs-engine-bindgen/package.json
+++ b/packages/ecs-engine-bindgen/package.json
@@ -1,62 +0,0 @@
-{
-    "name": "@esengine/ecs-engine-bindgen",
-    "version": "0.1.0",
-    "description": "Bridge layer between ECS Framework and Rust Engine | ECS框架与Rust引擎之间的桥接层",
-    "main": "dist/index.js",
-    "module": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "type": "module",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        }
-    },
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "build": "tsup",
-        "build:watch": "tsup --watch",
-        "clean": "rimraf dist"
-    },
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/esengine/esengine.git",
-        "directory": "packages/ecs-engine-bindgen"
-    },
-    "keywords": [
-        "ecs",
-        "game-engine",
-        "bridge",
-        "wasm",
-        "typescript"
-    ],
-    "author": "ESEngine Team",
-    "license": "MIT",
-    "dependencies": {
-        "@esengine/ecs-framework": "workspace:*",
-        "@esengine/ecs-framework-math": "workspace:*",
-        "@esengine/engine-core": "workspace:*",
-        "@esengine/asset-system": "workspace:*",
-        "@esengine/material-system": "workspace:*"
-    },
-    "peerDependencies": {
-        "@esengine/sprite": "workspace:*",
-        "@esengine/camera": "workspace:*"
-    },
-    "peerDependenciesMeta": {
-        "@esengine/sprite": { "optional": true },
-        "@esengine/camera": { "optional": true }
-    },
-    "optionalDependencies": {
-        "es-engine": "file:../engine/pkg"
-    },
-    "devDependencies": {
-        "@esengine/sprite": "workspace:*",
-        "@esengine/camera": "workspace:*",
-        "tsup": "^8.5.1",
-        "typescript": "^5.8.0",
-        "rimraf": "^5.0.0"
-    }
-}
--- a/packages/editor/editor-app/.gitignore
+++ b/packages/editor/editor-app/.gitignore
--- a/packages/editor/editor-app/.swcrc
+++ b/packages/editor/editor-app/.swcrc
--- a/packages/editor/editor-app/index.html
+++ b/packages/editor/editor-app/index.html
--- a/packages/editor/editor-app/package.json
+++ b/packages/editor/editor-app/package.json
--- a/packages/editor/editor-app/pnpm-lock.yaml
+++ b/packages/editor/editor-app/pnpm-lock.yaml
--- a/packages/editor/editor-app/public/assets/react-dom-shim.js
+++ b/packages/editor/editor-app/public/assets/react-dom-shim.js
--- a/packages/editor/editor-app/public/assets/react-jsx-runtime-shim.js
+++ b/packages/editor/editor-app/public/assets/react-jsx-runtime-shim.js
--- a/packages/editor/editor-app/public/assets/react-shim.js
+++ b/packages/editor/editor-app/public/assets/react-shim.js
--- a/packages/editor/editor-app/public/runtime.config.json
+++ b/packages/editor/editor-app/public/runtime.config.json
--- a/packages/editor/editor-app/runtime.config.json
+++ b/packages/editor/editor-app/runtime.config.json
--- a/packages/editor/editor-app/scripts/bundle-runtime.mjs
+++ b/packages/editor/editor-app/scripts/bundle-runtime.mjs
--- a/packages/editor/editor-app/scripts/kill-dev-server.js
+++ b/packages/editor/editor-app/scripts/kill-dev-server.js
--- a/packages/editor/editor-app/scripts/sync-version.js
+++ b/packages/editor/editor-app/scripts/sync-version.js
--- a/packages/editor/editor-app/src-tauri/Cargo.lock
+++ b/packages/editor/editor-app/src-tauri/Cargo.lock
--- a/packages/editor/editor-app/src-tauri/Cargo.toml
+++ b/packages/editor/editor-app/src-tauri/Cargo.toml
--- a/packages/editor/editor-app/src-tauri/build.rs
+++ b/packages/editor/editor-app/src-tauri/build.rs
--- a/packages/editor/editor-app/src-tauri/capabilities/http.json
+++ b/packages/editor/editor-app/src-tauri/capabilities/http.json
--- a/packages/editor/editor-app/src-tauri/icons/128x128.png
+++ b/packages/editor/editor-app/src-tauri/icons/128x128.png
--- a/packages/editor/editor-app/src-tauri/icons/128x128@2x.png
+++ b/packages/editor/editor-app/src-tauri/icons/128x128@2x.png
--- a/packages/editor/editor-app/src-tauri/icons/256x256.png
+++ b/packages/editor/editor-app/src-tauri/icons/256x256.png
--- a/packages/editor/editor-app/src-tauri/icons/32x32.png
+++ b/packages/editor/editor-app/src-tauri/icons/32x32.png
--- a/packages/editor/editor-app/src-tauri/icons/512x512.png
+++ b/packages/editor/editor-app/src-tauri/icons/512x512.png
--- a/packages/editor/editor-app/src-tauri/icons/64x64.png
+++ b/packages/editor/editor-app/src-tauri/icons/64x64.png
--- a/packages/editor/editor-app/src-tauri/icons/Square107x107Logo.png
+++ b/packages/editor/editor-app/src-tauri/icons/Square107x107Logo.png
--- a/packages/editor/editor-app/src-tauri/icons/Square142x142Logo.png
+++ b/packages/editor/editor-app/src-tauri/icons/Square142x142Logo.png
--- a/packages/editor/editor-app/src-tauri/icons/Square150x150Logo.png
+++ b/packages/editor/editor-app/src-tauri/icons/Square150x150Logo.png
--- a/packages/editor/editor-app/src-tauri/icons/Square284x284Logo.png
+++ b/packages/editor/editor-app/src-tauri/icons/Square284x284Logo.png
--- a/packages/editor/editor-app/src-tauri/icons/Square30x30Logo.png
+++ b/packages/editor/editor-app/src-tauri/icons/Square30x30Logo.png
--- a/packages/editor/editor-app/src-tauri/icons/Square310x310Logo.png
+++ b/packages/editor/editor-app/src-tauri/icons/Square310x310Logo.png
--- a/packages/editor/editor-app/src-tauri/icons/Square44x44Logo.png
+++ b/packages/editor/editor-app/src-tauri/icons/Square44x44Logo.png
--- a/packages/editor/editor-app/src-tauri/icons/Square71x71Logo.png
+++ b/packages/editor/editor-app/src-tauri/icons/Square71x71Logo.png
--- a/packages/editor/editor-app/src-tauri/icons/Square89x89Logo.png
+++ b/packages/editor/editor-app/src-tauri/icons/Square89x89Logo.png
--- a/packages/editor/editor-app/src-tauri/icons/StoreLogo.png
+++ b/packages/editor/editor-app/src-tauri/icons/StoreLogo.png
--- a/packages/editor/editor-app/src-tauri/icons/android/mipmap-hdpi/ic_launcher.png
+++ b/packages/editor/editor-app/src-tauri/icons/android/mipmap-hdpi/ic_launcher.png
--- a/packages/editor/editor-app/src-tauri/icons/android/mipmap-hdpi/ic_launcher_foreground.png
+++ b/packages/editor/editor-app/src-tauri/icons/android/mipmap-hdpi/ic_launcher_foreground.png
--- a/packages/editor/editor-app/src-tauri/icons/android/mipmap-hdpi/ic_launcher_round.png
+++ b/packages/editor/editor-app/src-tauri/icons/android/mipmap-hdpi/ic_launcher_round.png
--- a/packages/editor/editor-app/src-tauri/icons/android/mipmap-mdpi/ic_launcher.png
+++ b/packages/editor/editor-app/src-tauri/icons/android/mipmap-mdpi/ic_launcher.png
--- a/packages/editor/editor-app/src-tauri/icons/android/mipmap-mdpi/ic_launcher_foreground.png
+++ b/packages/editor/editor-app/src-tauri/icons/android/mipmap-mdpi/ic_launcher_foreground.png
--- a/packages/editor/editor-app/src-tauri/icons/android/mipmap-mdpi/ic_launcher_round.png
+++ b/packages/editor/editor-app/src-tauri/icons/android/mipmap-mdpi/ic_launcher_round.png
--- a/packages/editor/editor-app/src-tauri/icons/android/mipmap-xhdpi/ic_launcher.png
+++ b/packages/editor/editor-app/src-tauri/icons/android/mipmap-xhdpi/ic_launcher.png
--- a/packages/editor/editor-app/src-tauri/icons/android/mipmap-xhdpi/ic_launcher_foreground.png
+++ b/packages/editor/editor-app/src-tauri/icons/android/mipmap-xhdpi/ic_launcher_foreground.png
--- a/packages/editor/editor-app/src-tauri/icons/android/mipmap-xhdpi/ic_launcher_round.png
+++ b/packages/editor/editor-app/src-tauri/icons/android/mipmap-xhdpi/ic_launcher_round.png
--- a/packages/editor/editor-app/src-tauri/icons/android/mipmap-xxhdpi/ic_launcher.png
+++ b/packages/editor/editor-app/src-tauri/icons/android/mipmap-xxhdpi/ic_launcher.png
--- a/packages/editor/editor-app/src-tauri/icons/android/mipmap-xxhdpi/ic_launcher_foreground.png
+++ b/packages/editor/editor-app/src-tauri/icons/android/mipmap-xxhdpi/ic_launcher_foreground.png
--- a/packages/editor/editor-app/src-tauri/icons/android/mipmap-xxhdpi/ic_launcher_round.png
+++ b/packages/editor/editor-app/src-tauri/icons/android/mipmap-xxhdpi/ic_launcher_round.png
--- a/packages/editor/editor-app/src-tauri/icons/android/mipmap-xxxhdpi/ic_launcher.png
+++ b/packages/editor/editor-app/src-tauri/icons/android/mipmap-xxxhdpi/ic_launcher.png
--- a/packages/editor/editor-app/src-tauri/icons/android/mipmap-xxxhdpi/ic_launcher_foreground.png
+++ b/packages/editor/editor-app/src-tauri/icons/android/mipmap-xxxhdpi/ic_launcher_foreground.png
--- a/packages/editor/editor-app/src-tauri/icons/android/mipmap-xxxhdpi/ic_launcher_round.png
+++ b/packages/editor/editor-app/src-tauri/icons/android/mipmap-xxxhdpi/ic_launcher_round.png
--- a/packages/editor/editor-app/src-tauri/icons/icon.icns
+++ b/packages/editor/editor-app/src-tauri/icons/icon.icns
--- a/packages/editor/editor-app/src-tauri/icons/icon.ico
+++ b/packages/editor/editor-app/src-tauri/icons/icon.ico
--- a/packages/editor/editor-app/src-tauri/icons/icon.png
+++ b/packages/editor/editor-app/src-tauri/icons/icon.png
--- a/packages/editor/editor-app/src-tauri/icons/icon.svg
+++ b/packages/editor/editor-app/src-tauri/icons/icon.svg
--- a/packages/editor/editor-app/src-tauri/icons/ios/AppIcon-20x20@1x.png
+++ b/packages/editor/editor-app/src-tauri/icons/ios/AppIcon-20x20@1x.png
--- a/packages/editor/editor-app/src-tauri/icons/ios/AppIcon-20x20@2x-1.png
+++ b/packages/editor/editor-app/src-tauri/icons/ios/AppIcon-20x20@2x-1.png
--- a/packages/editor/editor-app/src-tauri/icons/ios/AppIcon-20x20@2x.png
+++ b/packages/editor/editor-app/src-tauri/icons/ios/AppIcon-20x20@2x.png
--- a/packages/editor/editor-app/src-tauri/icons/ios/AppIcon-20x20@3x.png
+++ b/packages/editor/editor-app/src-tauri/icons/ios/AppIcon-20x20@3x.png
--- a/packages/editor/editor-app/src-tauri/icons/ios/AppIcon-29x29@1x.png
+++ b/packages/editor/editor-app/src-tauri/icons/ios/AppIcon-29x29@1x.png
--- a/packages/editor/editor-app/src-tauri/icons/ios/AppIcon-29x29@2x-1.png
+++ b/packages/editor/editor-app/src-tauri/icons/ios/AppIcon-29x29@2x-1.png
--- a/packages/editor/editor-app/src-tauri/icons/ios/AppIcon-29x29@2x.png
+++ b/packages/editor/editor-app/src-tauri/icons/ios/AppIcon-29x29@2x.png
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
github-actions[bot]	27b9e174eb	chore: release packages (#348 ) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>	2025-12-26 18:16:57 +08:00
YHH	ede440d277	chore: changeset for framework package configs (#347 ) * chore: add changeset for framework package configs * fix(docs): 修复 VitePress 配置中的包路径	2025-12-26 18:13:12 +08:00
YHH	5cb83f0743	fix(framework): 补充包配置 peerDeps/repository/keywords (#346 ) * fix(framework): 补充 peerDependencies, repository 和 keywords 配置 - fsm: 添加 peerDeps, repository, keywords - timer: 添加 peerDeps, repository, keywords - spatial: 添加 peerDeps, repository, keywords - procgen: 添加 peerDeps, repository, keywords - pathfinding: 移除重复的 dependencies，添加 repository, keywords * chore: update pnpm-lock.yaml	2025-12-26 18:05:37 +08:00
yhh	7cbf92b8c7	fix(docs): 修复 tsconfig.json 中的 references 路径	2025-12-26 17:49:40 +08:00
YHH	a049bbe2f5	fix: add private:true to packages not meant for npm (#345 ) * fix(ci): run on all PRs with conditional skip - Remove paths filter from pull_request trigger - Add check-changes job to detect code changes - Skip full CI if no code files changed - Satisfies branch protection while avoiding unnecessary builds * fix: add private:true to packages not meant for npm Prevents changesets from trying to publish internal packages: - engine/* (8 packages) - rendering/* (8 packages) - physics/* (2 packages) - streaming/* (1 package) - tools/sdk, tools/worker-generator	2025-12-26 17:45:00 +08:00
github-actions[bot]	ec72df7af5	chore: release packages (#343 ) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: YHH <359807859@qq.com>	2025-12-26 17:18:01 +08:00
YHH	9327c1cef5	fix(ci): run on all PRs with conditional skip (#344 ) - Remove paths filter from pull_request trigger - Add check-changes job to detect code changes - Skip full CI if no code files changed - Satisfies branch protection while avoiding unnecessary builds	2025-12-26 17:15:02 +08:00
YHH	da5bf2116a	fix(changesets): remove network-protocols and build-config from ignore (#342 ) * fix(changesets): remove network-protocols and build-config from ignore These packages are dependencies of non-ignored packages: - @esengine/network depends on @esengine/network-protocols - Multiple packages depend on @esengine/build-config (private, won't publish) * fix(ci): add .changeset to CI trigger paths	2025-12-26 17:05:41 +08:00
YHH	67e97f89c6	fix(ci): update typedoc path and add workflow_dispatch (#341 ) * fix: update Laya examples, add CLI docs, fix changesets workflow - Update Laya examples to use Laya 3.x Script pattern (@regClass) - Add CLI tool quick start section to README (npx @esengine/cli init) - Fix changesets workflow to only build framework packages - Remove unnecessary Rust/WASM build steps from changesets workflow - Remove redundant 'pnpm build' from changeset:publish script * docs: add CLI documentation and update Laya examples - Add CLI quick start section to getting-started.md (zh/en) - Update Laya examples to use Laya 3.x Script pattern * fix(ci): update typedoc path and add workflow_dispatch - Fix typedoc entry point: packages/core -> packages/framework/core - Add workflow_dispatch to release-changesets for manual triggering - Add deeper package paths to trigger on nested packages	2025-12-26 16:52:29 +08:00
YHH	31fd34b221	fix: update Laya examples, add CLI docs, fix changesets workflow (#340 ) * fix: update Laya examples, add CLI docs, fix changesets workflow - Update Laya examples to use Laya 3.x Script pattern (@regClass) - Add CLI tool quick start section to README (npx @esengine/cli init) - Fix changesets workflow to only build framework packages - Remove unnecessary Rust/WASM build steps from changesets workflow - Remove redundant 'pnpm build' from changeset:publish script * docs: add CLI documentation and update Laya examples - Add CLI quick start section to getting-started.md (zh/en) - Update Laya examples to use Laya 3.x Script pattern	2025-12-26 16:37:37 +08:00
YHH	c4f7a13b74	feat(cli): add CLI tool for adding ECS framework to existing projects (#339 ) * feat(cli): add CLI tool for adding ECS framework to existing projects - Support Cocos Creator 2.x/3.x, LayaAir 3.x, and Node.js platforms - Auto-detect project type based on directory structure - Generate ECSManager with full configuration (debug, remote debug, WebSocket URL) - Auto-install dependencies with npm/yarn/pnpm detection - Platform-specific decorators and lifecycle methods * chore: add changeset for @esengine/cli * fix(ci): fix YAML syntax error in ai-issue-helper workflow * fix(cli): resolve file system race conditions (CodeQL) * chore(ci): remove unused and broken workflows * fix(ci): fix YAML encoding in release.yml	2025-12-26 16:18:59 +08:00
YHH	155411e743	refactor: reorganize package structure and decouple framework packages (#338 ) * refactor: reorganize package structure and decouple framework packages ## Package Structure Reorganization - Reorganized 55 packages into categorized subdirectories: - packages/framework/ - Generic framework (Laya/Cocos compatible) - packages/engine/ - ESEngine core modules - packages/rendering/ - Rendering modules (WASM dependent) - packages/physics/ - Physics modules - packages/streaming/ - World streaming - packages/network-ext/ - Network extensions - packages/editor/ - Editor framework and plugins - packages/rust/ - Rust WASM engine - packages/tools/ - Build tools and SDK ## Framework Package Decoupling - Decoupled behavior-tree and blueprint packages from ESEngine dependencies - Created abstracted interfaces (IBTAssetManager, IBehaviorTreeAssetContent) - ESEngine-specific code moved to esengine/ subpath exports - Framework packages now usable with Cocos/Laya without ESEngine ## CI Configuration - Updated CI to only type-check and lint framework packages - Added type-check:framework and lint:framework scripts ## Breaking Changes - Package import paths changed due to directory reorganization - ESEngine integrations now use subpath imports (e.g., '@esengine/behavior-tree/esengine') * fix: update es-engine file path after directory reorganization * docs: update README to focus on framework over engine * ci: only build framework packages, remove Rust/WASM dependencies * fix: remove esengine subpath from behavior-tree and blueprint builds ESEngine integration code will only be available in full engine builds. Framework packages are now purely engine-agnostic. * fix: move network-protocols to framework, build both in CI * fix: update workflow paths from packages/core to packages/framework/core * fix: exclude esengine folder from type-check in behavior-tree and blueprint * fix: update network tsconfig references to new paths * fix: add test:ci:framework to only test framework packages in CI * fix: only build core and math npm packages in CI * fix: exclude test files from CodeQL and fix string escaping security issue	2025-12-26 14:50:35 +08:00
YHH	a84ff902e4	fix: 修复 changesets 验证错误 (#337 ) - 简化 ignore 配置，只保留 editor-app - 设置内部包为 private: true - build-config, engine, ecs-engine-bindgen - editor-core, editor-runtime - 所有 *-editor 插件包这样 changesets 可以正常工作，private 包不会被发布	2025-12-26 09:06:52 +08:00
YHH	54038e3250	feat: 配置 changesets 版本管理和自动发布 (#336 ) - 安装 @changesets/cli 和 @changesets/changelog-github - 配置 .changeset/config.json - 添加 npm scripts - 创建 release-changesets.yml GitHub Action	2025-12-25 23:07:44 +08:00
yhh	5544fca002	docs: update changelog for v2.4.2	2025-12-25 20:42:15 +08:00
yhh	88b5ffc0a7	fix(ci): don't mark npm package releases as latest	2025-12-25 20:37:50 +08:00