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
parent 155411e743
commit c4f7a13b74
24 changed files with 1703 additions and 786 deletions
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -1,7 +1,6 @@
 name: Release NPM Packages

 on:
-  # æ ‡ç¾è§¦å<C2A6>‘ï¼šæ”¯æŒ?v* å’?{package}-v* æ ¼å¼<C3A5>
  # Tag trigger: supports v* and {package}-v* formats
  push:
    tags:
@@ -15,12 +14,11 @@ on:
      - 'physics-rapier2d-v*'
      - 'worker-generator-v*'

-  # ä¿<EFBFBD>ç•™æ‰‹åŠ¨è§¦å<EFBFBD>‘é€‰é¡¹
-  # Keep manual trigger option
+  # Manual trigger option
  workflow_dispatch:
    inputs:
      package:
-        description: 'é€‰æ‹©è¦<EFBFBD>å<EFBFBD>‘å¸ƒçš„åŒ?| 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
-            # ä»Žæ ‡ç¾è§£æž<C3A6>åŒ…å<E280A6><C3A5>å’Œç‰ˆæœ¬ | Parse package and version from tag
+            # Parse package and version from tag
            TAG="${GITHUB_REF#refs/tags/}"
            echo "tag=$TAG" >> $GITHUB_OUTPUT

-            # è§£æž<C3A6>æ ¼å¼<C3A5>ï¼š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
-            # æ‰‹åŠ¨è§¦å<C2A6>‘ï¼šä»Ž package.json è¯»å<C2BB>–å¹?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 }}"

-          # èŽ·å<C2B7>– 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
@@ -188,19 +183,18 @@ jobs:
        with:
          tag_name: ${{ steps.parse.outputs.tag }}
          name: "${{ steps.parse.outputs.package }} v${{ steps.version.outputs.value }}"
-          # ä¸<C3A4>è®¾ç½®ä¸º latestï¼Œlatest ä¿<C3A4>ç•™ç»™ç¼–è¾‘å™¨çƒæ›´æ–°ä½¿ç”?          # Don't mark as latest, reserve latest for editor auto-update
          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 }}
            ```

            ---
-            *è‡ªåŠ¨å<EFBFBD>‘å¸ƒ | Auto-released by GitHub Actions*
+            *Auto-released by GitHub Actions*
          generate_release_notes: true
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -215,15 +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 }}` åŒ…çš„ç‰ˆæœ¬å<EFBFBD>?
-            ### å<>˜æ›´
-            - âœ?å·²å<C2B2>‘å¸ƒåˆ° 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 }}`
+            This PR updates `@esengine/${{ steps.parse.outputs.package }}` package version.
+
+            ### 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 ç”±å<C2B1>‘å¸ƒå·¥ä½œæµ<C3A6>è‡ªåŠ¨åˆ›å»º*
+            *This PR was automatically created by the release workflow*
          labels: |
            release
            ${{ steps.parse.outputs.package }}