feat(installer): add standalone Windows .exe installer (vp-setup.exe)

Add a standalone `vp-setup.exe` Windows installer binary that installs
the vp CLI without requiring PowerShell, complementing the existing
`irm https://vite.plus/ps1 | iex` script-based installer.

- Create `vite_setup` shared library crate extracting installation logic
  (platform detection, registry queries, integrity verification, tarball
  extraction, symlink/junction management) from `vite_global_cli`
- Create `vite_installer` binary crate producing `vp-setup.exe` with
  interactive prompts, silent mode (-y), progress bars, and Windows PATH
  modification via direct registry API (no PowerShell dependency)
- Update `vite_global_cli` to use `vite_setup` instead of inline upgrade
  modules, ensuring upgrade and installer share identical logic
- Add CI build/upload steps for installer in release workflow, attached
  as GitHub Release assets
- Add RFC document at rfcs/windows-installer.md

Author: fengmk2

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

@@ -47,6 +47,7 @@ runs:
           ${{ steps.rust-target.outputs.dir }}/${{ inputs.target }}/release/vp
           ${{ steps.rust-target.outputs.dir }}/${{ inputs.target }}/release/vp.exe
           ${{ steps.rust-target.outputs.dir }}/${{ inputs.target }}/release/vp-shim.exe
+          ${{ steps.rust-target.outputs.dir }}/${{ inputs.target }}/release/vp-setup.exe
         key: ${{ steps.cache-key.outputs.key }}
 
     # Apply Vite+ branding patches to vite source (CI checks out
@@ -143,6 +144,11 @@ runs:
       shell: bash
       run: cargo build --release --target ${{ inputs.target }} -p vite_trampoline
 
+    - name: Build installer 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_installer
+
     - name: Save NAPI binding cache
       if: steps.cache-restore.outputs.cache-hit != 'true'
       uses: actions/cache/save@94b89442628ad1d101e352b7ee38f30e1bef108e # v5
@@ -156,6 +162,7 @@ runs:
           ${{ steps.rust-target.outputs.dir }}/${{ inputs.target }}/release/vp
           ${{ steps.rust-target.outputs.dir }}/${{ inputs.target }}/release/vp.exe
           ${{ steps.rust-target.outputs.dir }}/${{ inputs.target }}/release/vp-shim.exe
+          ${{ steps.rust-target.outputs.dir }}/${{ inputs.target }}/release/vp-setup.exe
         key: ${{ steps.cache-key.outputs.key }}
 
     # Build vite-plus TypeScript after native bindings are ready

.github/workflows/release.yml

@@ -131,6 +131,14 @@ jobs:
             ./target/${{ matrix.settings.target }}/release/vp-shim.exe
           if-no-files-found: error
 
+      - name: Upload installer binary artifact (Windows only)
+        if: contains(matrix.settings.target, 'windows')
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        with:
+          name: vp-setup-${{ matrix.settings.target }}
+          path: ./target/${{ matrix.settings.target }}/release/vp-setup.exe
+          if-no-files-found: error
+
       - name: Remove .node files before upload dist
         if: ${{ matrix.settings.target == 'x86_64-unknown-linux-gnu' }}
         run: |
@@ -241,6 +249,12 @@ jobs:
           path: rust-cli-artifacts
           pattern: vite-global-cli-*
 
+      - name: Download installer binaries (Windows)
+        uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
+        with:
+          path: installer-artifacts
+          pattern: vp-setup-*
+
       - name: Move Rust CLI binaries to target directories
         run: |
           # Move each artifact's binary to the correct target directory
@@ -265,6 +279,19 @@ jobs:
           echo "Found binaries:"
           echo "$vp_files"
 
+      - name: Prepare installer binaries for release
+        run: |
+          mkdir -p installer-release
+          for artifact_dir in installer-artifacts/vp-setup-*/; do
+            if [ -d "$artifact_dir" ]; then
+              dir_name=$(basename "$artifact_dir")
+              target_name=${dir_name#vp-setup-}
+              cp "$artifact_dir/vp-setup.exe" "installer-release/vp-setup-${target_name}.exe"
+            fi
+          done
+          echo "Installer binaries:"
+          ls -la installer-release/ || echo "No installer binaries found"
+
       - name: Set npm packages version
         run: |
           sed -i 's/"version": "0.0.0"/"version": "${{ env.VERSION }}"/' packages/core/package.json
@@ -318,6 +345,8 @@ jobs:
           ${INSTALL_PS1}
           \`\`\`
 
+          Or download and run \`vp-setup.exe\` from the assets below.
+
           View the full commit: https://github.com/${{ github.repository }}/commit/${{ github.sha }}
           EOF
 
@@ -332,6 +361,8 @@ jobs:
           name: vite-plus v${{ env.VERSION }}
           tag_name: v${{ env.VERSION }}
           target_commitish: ${{ github.sha }}
+          files: |
+            installer-release/vp-setup-*.exe
 
       - name: Send Discord notification
         if: ${{ inputs.npm_tag == 'latest' }}

Cargo.lock

@@ -197,6 +197,7 @@ vite_js_runtime = { path = "crates/vite_js_runtime" }
 vite_glob = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "eb746ad3f35bd994ddb39be001eaf58986f48388" }
 vite_install = { path = "crates/vite_install" }
 vite_migration = { path = "crates/vite_migration" }
+vite_setup = { path = "crates/vite_setup" }
 vite_shared = { path = "crates/vite_shared" }
 vite_static_config = { path = "crates/vite_static_config" }
 vite_path = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "eb746ad3f35bd994ddb39be001eaf58986f48388" }
@@ -334,3 +335,7 @@ panic = "abort" # Let it crash and force ourselves to write safe Rust.
 # size instead of speed. This reduces it from ~200KB to ~100KB on Windows.
 [profile.release.package.vite_trampoline]
 opt-level = "z"
+
+# The installer binary is downloaded by users, so optimize for size.
+[profile.release.package.vite_installer]
+opt-level = "z"

Cargo.toml

@@ -12,17 +12,13 @@ name = "vp"
 path = "src/main.rs"
 
 [dependencies]
-base64-simd = { workspace = true }
 chrono = { workspace = true }
 clap = { workspace = true, features = ["derive"] }
 clap_complete = { workspace = true, features = ["unstable-dynamic"] }
 directories = { workspace = true }
-flate2 = { workspace = true }
 serde = { workspace = true }
 serde_json = { workspace = true }
 node-semver = { workspace = true }
-sha2 = { workspace = true }
-tar = { workspace = true }
 thiserror = { workspace = true }
 tokio = { workspace = true, features = ["full"] }
 tracing = { workspace = true }
@@ -34,6 +30,7 @@ vite_install = { workspace = true }
 vite_js_runtime = { workspace = true }
 vite_path = { workspace = true }
 vite_command = { workspace = true }
+vite_setup = { workspace = true }
 vite_shared = { workspace = true }
 vite_str = { workspace = true }
 vite_workspace = { workspace = true }

crates/vite_global_cli/Cargo.toml

@@ -3,16 +3,12 @@
 //! Downloads and installs a new version of the CLI from the npm registry
 //! with SHA-512 integrity verification.
 
-mod install;
-mod integrity;
-mod platform;
-pub(crate) mod registry;
-
 use std::process::ExitStatus;
 
 use owo_colors::OwoColorize;
 use vite_install::request::HttpClient;
 use vite_path::AbsolutePathBuf;
+use vite_setup::{install, integrity, platform, registry};
 use vite_shared::output;
 
 use crate::{commands::env::config::get_vp_home, error::Error};
@@ -35,9 +31,6 @@ pub struct UpgradeOptions {
     pub registry: Option<String>,
 }
 
-/// Maximum number of old versions to keep.
-const MAX_VERSIONS_KEEP: usize = 5;
-
 /// Execute the upgrade command.
 #[allow(clippy::print_stdout, clippy::print_stderr)]
 pub async fn execute(options: UpgradeOptions) -> Result<ExitStatus, Error> {
@@ -189,7 +182,8 @@ async fn install_platform_and_main(
     if let Some(ref prev) = previous_version {
         protected.push(prev.as_str());
     }
-    if let Err(e) = install::cleanup_old_versions(install_dir, MAX_VERSIONS_KEEP, &protected).await
+    if let Err(e) =
+        install::cleanup_old_versions(install_dir, vite_setup::MAX_VERSIONS_KEEP, &protected).await
     {
         output::warn(&format!("Old version cleanup failed (non-fatal): {e}"));
     }

crates/vite_global_cli/src/commands/upgrade/mod.rs

@@ -52,9 +52,6 @@ pub enum Error {
     #[error("Upgrade error: {0}")]
     Upgrade(Str),
 
-    #[error("Integrity mismatch: expected {expected}, got {actual}")]
-    IntegrityMismatch { expected: Str, actual: Str },
-
-    #[error("Unsupported integrity format: {0} (only sha512 is supported)")]
-    UnsupportedIntegrity(Str),
+    #[error("{0}")]
+    Setup(#[from] vite_setup::error::Error),
 }

crates/vite_global_cli/src/error.rs

@@ -12,7 +12,7 @@ use std::{
 use owo_colors::OwoColorize;
 use serde::{Deserialize, Serialize};
 
-use crate::commands::upgrade::registry;
+use vite_setup::registry;
 
 const CHECK_INTERVAL_SECS: u64 = 24 * 60 * 60;
 const PROMPT_INTERVAL_SECS: u64 = 24 * 60 * 60;

crates/vite_global_cli/src/upgrade_check.rs

@@ -0,0 +1,26 @@
+[package]
+name = "vite_installer"
+version = "0.0.0"
+authors.workspace = true
+edition.workspace = true
+license.workspace = true
+publish = false
+rust-version.workspace = true
+
+[[bin]]
+name = "vp-setup"
+path = "src/main.rs"
+
+[dependencies]
+clap = { workspace = true, features = ["derive"] }
+indicatif = { workspace = true }
+owo-colors = { workspace = true }
+tokio = { workspace = true, features = ["full"] }
+tracing = { workspace = true }
+vite_install = { workspace = true }
+vite_path = { workspace = true }
+vite_setup = { workspace = true }
+vite_shared = { workspace = true }
+
+[lints]
+workspace = true

crates/vite_installer/Cargo.toml

@@ -0,0 +1,83 @@
+//! CLI argument parsing for `vp-setup`.
+
+use clap::Parser;
+
+/// Vite+ Installer — standalone installer for the vp CLI.
+#[derive(Parser, Debug)]
+#[command(name = "vp-setup", about = "Install the Vite+ CLI")]
+struct Cli {
+    /// Accept defaults without prompting (for CI/unattended installs)
+    #[arg(short = 'y', long = "yes")]
+    yes: bool,
+
+    /// Suppress all output except errors
+    #[arg(short = 'q', long = "quiet")]
+    quiet: bool,
+
+    /// Install a specific version (default: latest)
+    #[arg(long = "version")]
+    version: Option<String>,
+
+    /// npm dist-tag to install (default: latest)
+    #[arg(long = "tag", default_value = "latest")]
+    tag: String,
+
+    /// Custom installation directory (default: ~/.vite-plus)
+    #[arg(long = "install-dir")]
+    install_dir: Option<String>,
+
+    /// Custom npm registry URL
+    #[arg(long = "registry")]
+    registry: Option<String>,
+
+    /// Skip Node.js version manager setup
+    #[arg(long = "no-node-manager")]
+    no_node_manager: bool,
+
+    /// Do not modify the User PATH
+    #[arg(long = "no-modify-path")]
+    no_modify_path: bool,
+}
+
+/// Parsed installation options.
+pub struct Options {
+    pub yes: bool,
+    pub quiet: bool,
+    pub version: Option<String>,
+    pub tag: String,
+    pub install_dir: Option<String>,
+    pub registry: Option<String>,
+    pub no_node_manager: bool,
+    pub no_modify_path: bool,
+}
+
+/// Parse CLI arguments, merging with environment variables.
+///
+/// CLI flags take precedence over environment variables.
+pub fn parse() -> Options {
+    let cli = Cli::parse();
+
+    // Environment variable overrides (CLI flags take precedence)
+    let version = cli.version.or_else(|| std::env::var("VP_VERSION").ok());
+    let install_dir = cli.install_dir.or_else(|| std::env::var("VP_HOME").ok());
+    let registry = cli.registry.or_else(|| std::env::var("NPM_CONFIG_REGISTRY").ok());
+
+    let no_node_manager = cli.no_node_manager
+        || std::env::var("VP_NODE_MANAGER")
+            .ok()
+            .is_some_and(|v| v.eq_ignore_ascii_case("no"));
+
+    // quiet implies yes
+    let yes = cli.yes || cli.quiet;
+
+    Options {
+        yes,
+        quiet: cli.quiet,
+        version,
+        tag: cli.tag,
+        install_dir,
+        registry,
+        no_node_manager,
+        no_modify_path: cli.no_modify_path,
+    }
+}