feat(env): use trampoline exe instead of .cmd wrappers on Windows

.github/actions/build-upstream/action.yml

@@ -40,6 +40,7 @@
           packages/cli/binding/index.d.cts
           target/${{ inputs.target }}/release/vp
           target/${{ inputs.target }}/release/vp.exe
+          target/${{ inputs.target }}/release/vp-shim.exe
         key: ${{ steps.cache-key.outputs.key }}
 
     # Apply Vite+ branding patches to rolldown-vite source (CI checks out
@@ -111,6 +112,11 @@
       shell: bash
       run: cargo build --release --target ${{ inputs.target }} -p vite_global_cli
 
+    - name: Build trampoline shim binary (Windows only)
+      if: steps.cache-restore.outputs.cache-hit != 'true' && contains(inputs.target, 'windows')
+      shell: bash
+      run: cargo build --release --target ${{ inputs.target }} -p vite_trampoline
+
     - name: Save NAPI binding cache
       if: steps.cache-restore.outputs.cache-hit != 'true'
       uses: actions/cache/save@94b89442628ad1d101e352b7ee38f30e1bef108e # v5
@@ -123,6 +129,7 @@
           packages/cli/binding/index.d.cts
           target/${{ inputs.target }}/release/vp
           target/${{ inputs.target }}/release/vp.exe
+          target/${{ inputs.target }}/release/vp-shim.exe
         key: ${{ steps.cache-key.outputs.key }}
 
     # Build vite-plus TypeScript after native bindings are ready

.github/workflows/e2e-test.yml

@@ -112,6 +112,7 @@ jobs:
           cd packages/cli && pnpm pack --pack-destination ../../tmp/tgz && cd ../..
           # Copy vp binary for e2e-test job (findVpBinary expects it in target/)
           cp target/${{ matrix.target }}/release/vp tmp/tgz/vp 2>/dev/null || cp target/${{ matrix.target }}/release/vp.exe tmp/tgz/vp.exe 2>/dev/null || true
+          cp target/${{ matrix.target }}/release/vp-shim.exe tmp/tgz/vp-shim.exe 2>/dev/null || true
           ls -la tmp/tgz
 
       - name: Upload tgz artifacts
@@ -289,12 +290,16 @@ jobs:
           # Place vp binary where install-global-cli.ts expects it (target/release/)
           mkdir -p target/release
           cp tmp/tgz/vp target/release/vp 2>/dev/null || cp tmp/tgz/vp.exe target/release/vp.exe 2>/dev/null || true
+          cp tmp/tgz/vp-shim.exe target/release/vp-shim.exe 2>/dev/null || true
           chmod +x target/release/vp 2>/dev/null || true
           node $GITHUB_WORKSPACE/packages/tools/src/install-global-cli.ts --tgz $GITHUB_WORKSPACE/tmp/tgz/vite-plus-0.0.0.tgz
-          echo "$HOME/.vite-plus/bin" >> $GITHUB_PATH
+          # Use USERPROFILE (native Windows path) instead of HOME (Git Bash path /c/Users/...)
+          # so cmd.exe and Node.js execSync can resolve binaries in PATH
+          echo "${USERPROFILE:-$HOME}/.vite-plus/bin" >> $GITHUB_PATH
 
       - name: Migrate in ${{ matrix.project.name }}
         working-directory: ${{ runner.temp }}/vite-plus-ecosystem-ci/${{ matrix.project.name }}${{ matrix.project.directory && format('/{0}', matrix.project.directory) || '' }}
+        shell: bash
         run: |
           node $GITHUB_WORKSPACE/ecosystem-ci/patch-project.ts ${{ matrix.project.name }}
           vp install --no-frozen-lockfile

.github/workflows/release.yml

@@ -124,6 +124,7 @@ jobs:
           path: |
             ./target/${{ matrix.settings.target }}/release/vp
             ./target/${{ matrix.settings.target }}/release/vp.exe
+            ./target/${{ matrix.settings.target }}/release/vp-shim.exe
           if-no-files-found: error
 
       - name: Remove .node files before upload dist

.github/workflows/test-standalone-install.yml

@@ -19,7 +19,7 @@ defaults:
     shell: bash
 
 env:
-  VITE_PLUS_VERSION: latest
+  VITE_PLUS_VERSION: alpha
 
 jobs:
   test-install-sh:
@@ -131,7 +131,7 @@ jobs:
         run: |
           docker run --rm --platform linux/arm64 \
             -v "${{ github.workspace }}:/workspace" \
-            -e VITE_PLUS_VERSION=latest \
+            -e VITE_PLUS_VERSION=alpha \
             ubuntu:20.04 bash -c "
               ls -al ~/
               apt-get update && apt-get install -y curl ca-certificates
@@ -233,7 +233,7 @@ jobs:
             exit 1
           }
 
-          $expectedShims = @("node.cmd", "npm.cmd", "npx.cmd")
+          $expectedShims = @("node.exe", "npm.exe", "npx.exe")
           foreach ($shim in $expectedShims) {
             $shimFile = Join-Path $binPath $shim
             if (-not (Test-Path $shimFile)) {
@@ -300,7 +300,7 @@ jobs:
             exit 1
           }
 
-          $expectedShims = @("node.cmd", "npm.cmd", "npx.cmd")
+          $expectedShims = @("node.exe", "npm.exe", "npx.exe")
           foreach ($shim in $expectedShims) {
             $shimFile = Join-Path $binPath $shim
             if (-not (Test-Path $shimFile)) {
@@ -380,8 +380,8 @@ jobs:
             exit 1
           }
 
-          # Verify shim executables exist (all use .cmd wrappers on Windows)
-          $expectedShims = @("node.cmd", "npm.cmd", "npx.cmd")
+          # Verify shim executables exist (trampoline .exe files on Windows)
+          $expectedShims = @("node.exe", "npm.exe", "npx.exe")
           foreach ($shim in $expectedShims) {
             $shimFile = Join-Path $binPath $shim
             if (-not (Test-Path $shimFile)) {
@@ -419,8 +419,8 @@ jobs:
           set "BIN_PATH=%USERPROFILE%\.vite-plus\bin"
           dir "%BIN_PATH%"
 
-          REM Verify shim executables exist (Windows uses .cmd wrappers)
-          for %%s in (node.cmd npm.cmd npx.cmd vp.cmd) do (
+          REM Verify shim executables exist (Windows uses trampoline .exe files)
+          for %%s in (node.exe npm.exe npx.exe vp.exe) do (
             if not exist "%BIN_PATH%\%%s" (
               echo Error: Shim not found: %BIN_PATH%\%%s
               exit /b 1
@@ -462,22 +462,13 @@ jobs:
             exit 1
           fi
 
-          # Verify .cmd wrappers exist (for cmd.exe/PowerShell)
-          for shim in node.cmd npm.cmd npx.cmd vp.cmd; do
+          # Verify trampoline .exe files exist
+          for shim in node.exe npm.exe npx.exe vp.exe; do
             if [ ! -f "$BIN_PATH/$shim" ]; then
-              echo "Error: .cmd wrapper not found: $BIN_PATH/$shim"
+              echo "Error: Trampoline shim not found: $BIN_PATH/$shim"
               exit 1
             fi
-            echo "Found .cmd wrapper: $BIN_PATH/$shim"
-          done
-
-          # Verify shell scripts exist (for Git Bash)
-          for shim in node npm npx vp; do
-            if [ ! -f "$BIN_PATH/$shim" ]; then
-              echo "Error: Shell script not found: $BIN_PATH/$shim"
-              exit 1
-            fi
-            echo "Found shell script: $BIN_PATH/$shim"
+            echo "Found trampoline shim: $BIN_PATH/$shim"
           done
 
           # Verify vp env doctor works

Cargo.toml

@@ -318,3 +318,8 @@ codegen-units = 1
 strip = "symbols" # set to `false` for debug information
 debug = false # set to `true` for debug information
 panic = "abort" # Let it crash and force ourselves to write safe Rust.
+
+# The trampoline binary is copied per shim tool (~5-10 copies), so optimize for
+# size instead of speed. This reduces it from ~200KB to ~100KB on Windows.
+[profile.release.package.vite_trampoline]
+opt-level = "z"

crates/vite_global_cli/src/commands/env/doctor.rs

@@ -239,8 +239,8 @@ async fn check_bin_dir() -> bool {
 fn shim_filename(tool: &str) -> String {
     #[cfg(windows)]
     {
-        // All tools use .cmd wrappers on Windows (including node)
-        format!("{tool}.cmd")
+        // All tools use trampoline .exe files on Windows
+        format!("{tool}.exe")
     }
 
     #[cfg(not(windows))]
@@ -739,10 +739,10 @@ mod tests {
 
         #[cfg(windows)]
         {
-            // All shims should use .cmd on Windows (matching setup.rs)
-            assert_eq!(node, "node.cmd");
-            assert_eq!(npm, "npm.cmd");
-            assert_eq!(npx, "npx.cmd");
+            // All shims should use .exe on Windows (trampoline executables)
+            assert_eq!(node, "node.exe");
+            assert_eq!(npm, "npm.exe");
+            assert_eq!(npx, "npx.exe");
         }
 
         #[cfg(not(windows))]