feat: add error handling with detailed error output

- Wrap extraction in try-catch block
- Show detailed error message and stack trace on failure

Author: dongly

tools/install.ps1

@@ -974,49 +974,56 @@ function Extract-PortablePython {
     New-Item -ItemType Directory -Path $pythonTargetDir -Force | Out-Null
 
     # Extract zip file, excluding Doc directory
-    Add-Type -AssemblyName System.IO.Compression.FileSystem
-    Add-Type -AssemblyName System.IO.Compression
-    Write-LogInfo "extracting_archive" $archivePath
-    $zip = [System.IO.Compression.ZipFile]::OpenRead($archivePath)
     try {
-        $totalEntries = ($zip.Entries | Where-Object { $_.FullName -notlike 'Doc/*' -and $_.FullName -ne 'Doc' }).Count
-        $current = 0
-        foreach ($entry in $zip.Entries) {
-            if ($entry.FullName -like 'Doc/*' -or $entry.FullName -eq 'Doc') { continue }
-            $current++
-            if ($current % 10 -eq 0 -or $current -eq $totalEntries) {
-                Write-Progress -Activity "Extracting Python" -Status "File $current of $totalEntries" -PercentComplete (($current / $totalEntries) * 100) -Id 1
-            }
-            $entryPath = Join-Path $pythonTargetDir $entry.FullName
-            if ($entry.Name -eq '') {
-                # Directory entry
-                New-Item -ItemType Directory -Path $entryPath -Force | Out-Null
-            }
-            else {
-                $entryDir = Split-Path $entryPath -Parent
-                if (-not (Test-Path $entryDir)) {
-                    New-Item -ItemType Directory -Path $entryDir -Force | Out-Null
+        Add-Type -AssemblyName System.IO.Compression.FileSystem
+        Add-Type -AssemblyName System.IO.Compression
+        Write-LogInfo "extracting_archive" $archivePath
+        $zip = [System.IO.Compression.ZipFile]::OpenRead($archivePath)
+        try {
+            $totalEntries = ($zip.Entries | Where-Object { $_.FullName -notlike 'Doc/*' -and $_.FullName -ne 'Doc' }).Count
+            $current = 0
+            foreach ($entry in $zip.Entries) {
+                if ($entry.FullName -like 'Doc/*' -or $entry.FullName -eq 'Doc') { continue }
+                $current++
+                if ($current % 10 -eq 0 -or $current -eq $totalEntries) {
+                    Write-Progress -Activity "Extracting Python" -Status "File $current of $totalEntries" -PercentComplete (($current / $totalEntries) * 100) -Id 1
                 }
-                # Use .NET 4.5+ method to extract file
-                $stream = [System.IO.File]::Create($entryPath)
-                try {
-                    $entryStream = $entry.Open()
+                $entryPath = Join-Path $pythonTargetDir $entry.FullName
+                if ($entry.Name -eq '') {
+                    # Directory entry
+                    New-Item -ItemType Directory -Path $entryPath -Force | Out-Null
+                }
+                else {
+                    $entryDir = Split-Path $entryPath -Parent
+                    if (-not (Test-Path $entryDir)) {
+                        New-Item -ItemType Directory -Path $entryDir -Force | Out-Null
+                    }
+                    # Use .NET 4.5+ method to extract file
+                    $stream = [System.IO.File]::Create($entryPath)
                     try {
-                        $entryStream.CopyTo($stream)
+                        $entryStream = $entry.Open()
+                        try {
+                            $entryStream.CopyTo($stream)
+                        }
+                        finally {
+                            $entryStream.Dispose()
+                        }
                     }
                     finally {
-                        $entryStream.Dispose()
+                        $stream.Dispose()
                     }
                 }
-                finally {
-                    $stream.Dispose()
-                }
             }
+            Write-Progress -Activity "Extracting Python" -Completed -Id 1
+        }
+        finally {
+            $zip.Dispose()
         }
-        Write-Progress -Activity "Extracting Python" -Completed -Id 1
     }
-    finally {
-        $zip.Dispose()
+    catch {
+        Write-Host "  [错误详情] $_" -ForegroundColor Red
+        Write-Host "  [错误位置] $($_.ScriptStackTrace)" -ForegroundColor Red
+        exit 1
     }
 
     # Cleanup archive