feat: add one-liner install and fix installation docs

- Add quick-install.ps1 for one-command installation - Fix installation docs to include 'git checkout windows' step - Add .gitignore rules for main branch specific files - Users can now install with: iwr -useb https://...quick-install.ps1 | iex Addresses installation confusion from Issue #309
2026-02-10 06:09:16 +00:00 · 2026-01-14 10:42:10 +08:00
parent 66cb7e7229
commit e37a0ec090
3 changed files with 118 additions and 10 deletions
--- a/quick-install.ps1
+++ b/quick-install.ps1
@@ -0,0 +1,87 @@
+#!/usr/bin/env pwsh
+# Mole Quick Installer for Windows
+# One-liner install: iwr -useb https://raw.githubusercontent.com/tw93/Mole/windows/quick-install.ps1 | iex
+
+#Requires -Version 5.1
+
+$ErrorActionPreference = "Stop"
+Set-StrictMode -Version Latest
+
+# Colors
+$ESC = [char]27
+$Colors = @{
+    Green  = "$ESC[32m"
+    Yellow = "$ESC[33m"
+    Cyan   = "$ESC[36m"
+    Red    = "$ESC[31m"
+    NC     = "$ESC[0m"
+}
+
+function Write-Step {
+    param([string]$Message)
+    Write-Host "  $($Colors.Cyan)→$($Colors.NC) $Message"
+}
+
+function Write-Success {
+    param([string]$Message)
+    Write-Host "  $($Colors.Green)✓$($Colors.NC) $Message"
+}
+
+function Write-ErrorMsg {
+    param([string]$Message)
+    Write-Host "  $($Colors.Red)✗$($Colors.NC) $Message"
+}
+
+# Main installation
+try {
+    Write-Host ""
+    Write-Host "  $($Colors.Cyan)Mole Quick Installer$($Colors.NC)"
+    Write-Host "  $($Colors.Yellow)Installing experimental Windows version...$($Colors.NC)"
+    Write-Host ""
+
+    # Check prerequisites
+    Write-Step "Checking prerequisites..."
+
+    if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
+        Write-ErrorMsg "Git is not installed. Please install Git first:"
+        Write-Host "    https://git-scm.com/download/win"
+        exit 1
+    }
+
+    Write-Success "Git found"
+
+    # Create temp directory
+    $TempDir = Join-Path $env:TEMP "mole-install-$(Get-Random)"
+    Write-Step "Downloading Mole..."
+
+    # Clone windows branch
+    git clone --quiet --depth 1 --branch windows https://github.com/tw93/Mole.git $TempDir 2>&1 | Out-Null
+
+    if (-not (Test-Path "$TempDir\install.ps1")) {
+        Write-ErrorMsg "Failed to download installer"
+        exit 1
+    }
+
+    Write-Success "Downloaded to temp directory"
+
+    # Run installer
+    Write-Step "Running installer..."
+    Write-Host ""
+
+    & "$TempDir\install.ps1" -AddToPath
+
+    Write-Host ""
+    Write-Success "Installation complete!"
+    Write-Host ""
+    Write-Host "  Run ${Colors.Green}mole$($Colors.NC) to get started"
+    Write-Host ""
+
+} catch {
+    Write-ErrorMsg "Installation failed: $_"
+    exit 1
+} finally {
+    # Cleanup
+    if (Test-Path $TempDir) {
+        Remove-Item $TempDir -Recurse -Force -ErrorAction SilentlyContinue
+    }
+}