feat(ci): add version tagging to build artifacts and improve installer

- Add version determination step in CI workflow to tag artifacts with release version or 'dev'
- Enhance installer script with better architecture detection, TLS support, and PATH handling
- Add uninstall script for clean removal of Tricode-cli
- Improve error handling and logging in both installer and uninstaller scripts

Author: Trirrin

.github/workflows/ci.yml

@@ -42,15 +42,25 @@ jobs:
         with:
           python-version: '3.x'
 
+      - name: Determine version
+        id: meta
+        shell: bash
+        run: |
+          if [ "${{ github.event_name }}" = "release" ]; then
+            echo "version=${{ github.event.release.tag_name }}" >> "$GITHUB_OUTPUT"
+          else
+            echo "version=dev" >> "$GITHUB_OUTPUT"
+          fi
+
       # ==== Linux (native runners, no Docker) ====
       - name: Build on Linux (native)
         if: startsWith(matrix.os, 'ubuntu')
         run: |
           pip install -r requirements.txt
           pip install pyinstaller
           chmod +x build.sh
-          ./build.sh auto
-          mv dist/tricode dist/tricode-${{ matrix.asset_suffix }}
+          ./build.sh "${{ steps.meta.outputs.version }}"
+          mv dist/tricode dist/tricode-${{ matrix.asset_suffix }}-${{ steps.meta.outputs.version }}
 
       # ==== MacOS ====
       - name: Build on macOS
@@ -59,8 +69,8 @@ jobs:
           pip install -r requirements.txt
           pip install pyinstaller
           chmod +x build.sh
-          ./build.sh auto
-          mv dist/tricode dist/tricode-${{ matrix.asset_suffix }}
+          ./build.sh "${{ steps.meta.outputs.version }}"
+          mv dist/tricode dist/tricode-${{ matrix.asset_suffix }}-${{ steps.meta.outputs.version }}
 
       # ==== Windows ====
       - name: Build on Windows
@@ -69,14 +79,14 @@ jobs:
         run: |
           pip install -r requirements.txt
           pip install pyinstaller
-          .\build.bat auto
+          .\build.bat ${{ steps.meta.outputs.version }}
 
       - name: Rename Windows artifact
         if: startsWith(matrix.os, 'windows')
         shell: pwsh
         run: |
           $src = "dist/tricode.exe"
-          $dst = "dist/tricode-${{ matrix.asset_suffix }}.exe"
+          $dst = "dist/tricode-${{ matrix.asset_suffix }}-${{ steps.meta.outputs.version }}.exe"
           if (!(Test-Path $src)) { Write-Error "Source not found: $src"; exit 1 }
           if (Test-Path $dst) { Remove-Item $dst -Force }
           try {
@@ -90,28 +100,28 @@ jobs:
         if: startsWith(matrix.os, 'windows')
         uses: actions/upload-artifact@v4
         with:
-          name: tricode-${{ matrix.asset_suffix }}
+          name: tricode-${{ matrix.asset_suffix }}-${{ steps.meta.outputs.version }}
           path: |
-            dist/tricode-${{ matrix.asset_suffix }}.exe
+            dist/tricode-${{ matrix.asset_suffix }}-${{ steps.meta.outputs.version }}.exe
 
       - name: Upload artifact (Unix)
         if: startsWith(matrix.os, 'ubuntu') || startsWith(matrix.os, 'macos')
         uses: actions/upload-artifact@v4
         with:
-          name: tricode-${{ matrix.asset_suffix }}
+          name: tricode-${{ matrix.asset_suffix }}-${{ steps.meta.outputs.version }}
           path: |
-            dist/tricode-${{ matrix.asset_suffix }}
+            dist/tricode-${{ matrix.asset_suffix }}-${{ steps.meta.outputs.version }}
           
       - name: Upload to release (Windows)
         if: github.event_name == 'release' && startsWith(matrix.os, 'windows')
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          gh release upload ${{ github.event.release.tag_name }} dist/tricode-${{ matrix.asset_suffix }}.exe --clobber
+          gh release upload ${{ github.event.release.tag_name }} dist/tricode-${{ matrix.asset_suffix }}-${{ steps.meta.outputs.version }}.exe --clobber
 
       - name: Upload to release (Unix)
         if: github.event_name == 'release' && (startsWith(matrix.os, 'ubuntu') || startsWith(matrix.os, 'macos'))
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          gh release upload ${{ github.event.release.tag_name }} dist/tricode-${{ matrix.asset_suffix }} --clobber
+          gh release upload ${{ github.event.release.tag_name }} dist/tricode-${{ matrix.asset_suffix }}-${{ steps.meta.outputs.version }} --clobber

install_tricode.ps1

@@ -9,6 +9,11 @@ $REPO = "Trirrin/Tricode-cli"
 $INSTALL_DIR = "$env:LOCALAPPDATA\Tricode"
 $GITHUB_API = "https://api.github.com/repos/$REPO/releases/latest"
 
+# Try to ensure TLS1.2 for older systems
+try {
+    [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
+} catch {}
+
 # ==== TEXTS 说明文本（EN/中）====
 $TEXT_START = "Installing Tricode-cli..."
 $TEXT_DOWNLOAD = "Downloading the latest release..."
@@ -42,37 +47,54 @@ function Write-Error-Exit {
 # ==== MAIN 主流程 ====
 Write-Info $TEXT_START
 
-# 1. Detect Architecture 检测架构
-$ARCH = $env:PROCESSOR_ARCHITECTURE
-Write-Host "Detected Architecture: $ARCH"
+# 1. Detect Architecture 检测架构（兼容 32 位 PowerShell）
+$archRaw = $env:PROCESSOR_ARCHITECTURE
+$archWow = $env:PROCESSOR_ARCHITEW6432
+$isArm64 = ($archRaw -match 'ARM64') -or ($archWow -match 'ARM64')
+$is64OS = [Environment]::Is64BitOperatingSystem
+Write-Host "Detected Architecture: raw=$archRaw, wow64=$archWow, is64OS=$is64OS"
 
-if ($ARCH -eq "AMD64" -or $ARCH -eq "x64") {
-    $ASSET_ARCH = "windows-x86_64"
-} elseif ($ARCH -eq "ARM64") {
+if ($isArm64) {
     $ASSET_ARCH = "windows-arm64"
+} elseif ($is64OS) {
+    $ASSET_ARCH = "windows-x86_64"
 } else {
-    Write-Error-Exit "Unsupported architecture: $ARCH"
+    Write-Error-Exit "Unsupported architecture or 32-bit OS is not supported."
 }
 
-Write-Host "Looking for release: tricode-$ASSET_ARCH.exe"
+Write-Host "Looking for release asset matching: $ASSET_ARCH (.exe preferred)"
 
-# 2. Get download URL from GitHub API 通过GitHub API获取下载链接
+# 2. Get download URL from GitHub API 通过 GitHub API 获取下载链接
 Write-Info $TEXT_DOWNLOAD
 
 try {
-    $API_RESPONSE = Invoke-RestMethod -Uri $GITHUB_API -ErrorAction Stop
+    $headers = @{ 'User-Agent' = 'tricode-installer' }
+    $API_RESPONSE = Invoke-RestMethod -Uri $GITHUB_API -Headers $headers -ErrorAction Stop
 } catch {
     Write-Error-Exit "Cannot connect to GitHub API. Please check your network.`nError: $_" 2
 }
 
-$ASSET_URL = $API_RESPONSE.assets | Where-Object { $_.name -like "*$ASSET_ARCH*" } | Select-Object -First 1 -ExpandProperty browser_download_url
+# Prefer .exe; fallback to .zip; only match files containing the arch and with .exe/.zip suffix
+$assets = @($API_RESPONSE.assets)
+if (-not $assets -or $assets.Count -eq 0) {
+    Write-Error-Exit "No assets found in latest release." 2
+}
+
+$archPattern = [Regex]::Escape($ASSET_ARCH)
+$exeCandidates = $assets | Where-Object { $_.name -match "(?i)$archPattern.*\.exe$" }
+$zipCandidates = $assets | Where-Object { $_.name -match "(?i)$archPattern.*\.zip$" }
+
+$asset = $null
+if ($exeCandidates) { $asset = $exeCandidates | Select-Object -First 1 }
+elseif ($zipCandidates) { $asset = $zipCandidates | Select-Object -First 1 }
 
-if (-not $ASSET_URL) {
+if (-not $asset) {
     Write-Host "Debug: Available assets:" -ForegroundColor Yellow
-    $API_RESPONSE.assets | ForEach-Object { Write-Host "  - $($_.name)" }
-    Write-Error-Exit "Cannot find matching release binary for tricode-$ASSET_ARCH.exe`nPlease check if the release exists at: https://github.com/$REPO/releases" 2
+    $assets | ForEach-Object { Write-Host "  - $($_.name)" }
+    Write-Error-Exit "Cannot find matching release binary for $ASSET_ARCH (.exe or .zip).`nPlease check: https://github.com/$REPO/releases" 2
 }
 
+$ASSET_URL = $asset.browser_download_url
 Write-Host "Downloading from: $ASSET_URL"
 
 # 3. Download binary 下载二进制文件
@@ -81,7 +103,7 @@ New-Item -ItemType Directory -Path $TMP_DIR -Force | Out-Null
 
 try {
     $DOWNLOAD_FILE = Join-Path $TMP_DIR (Split-Path $ASSET_URL -Leaf)
-    Invoke-WebRequest -Uri $ASSET_URL -OutFile $DOWNLOAD_FILE -ErrorAction Stop
+    Invoke-WebRequest -Uri $ASSET_URL -OutFile $DOWNLOAD_FILE -UseBasicParsing -ErrorAction Stop
 } catch {
     Write-Error-Exit "Failed to download binary.`nError: $_" 3
 }
@@ -115,24 +137,44 @@ try {
     Write-Error-Exit "Failed to copy binary to $INSTALL_DIR`nError: $_" 5
 }
 
-# 6. Add to PATH 添加到PATH
+# 6. Add to PATH 添加到 PATH（去重、规范化、无多余分号）
 Write-Info $TEXT_PATH
 
 $USER_PATH = [Environment]::GetEnvironmentVariable("Path", "User")
+$normalizedInstall = $INSTALL_DIR.TrimEnd('\\')
 
-if ($USER_PATH -notlike "*$INSTALL_DIR*") {
+$parts = @()
+if ($null -ne $USER_PATH -and $USER_PATH -ne '') {
+    $parts = $USER_PATH -split ';' | Where-Object { $_ -and $_ -ne '' }
+}
+
+$exists = $false
+foreach ($p in $parts) {
+    if ($p.Trim().TrimEnd('\\') -ieq $normalizedInstall) { $exists = $true; break }
+}
+
+if (-not $exists) {
     try {
-        $NEW_PATH = "$USER_PATH;$INSTALL_DIR"
+        $cleanParts = @()
+        foreach ($p in $parts) {
+            $pp = $p.Trim()
+            if ($pp -ne '') { $cleanParts += $pp }
+        }
+        $cleanParts += $normalizedInstall
+        $NEW_PATH = ($cleanParts) -join ';'
         [Environment]::SetEnvironmentVariable("Path", $NEW_PATH, "User")
-        Write-Host "Added $INSTALL_DIR to User PATH"
-        
-        # Update current session PATH
-        $env:Path = "$env:Path;$INSTALL_DIR"
+        Write-Host "Added $normalizedInstall to User PATH"
+
+        # Update current session PATH（若当前会话不存在则追加）
+        $sessionHas = $false
+        $sessionParts = ($env:Path -split ';')
+        foreach ($sp in $sessionParts) { if ($sp.Trim().TrimEnd('\\') -ieq $normalizedInstall) { $sessionHas = $true; break } }
+        if (-not $sessionHas) { $env:Path = "$env:Path;$normalizedInstall" }
     } catch {
-        Write-Warning "Failed to add to PATH automatically. Please add manually:`n  $INSTALL_DIR"
+        Write-Warning "Failed to add to PATH automatically. Please add manually:`n  $normalizedInstall"
     }
 } else {
-    Write-Host "$INSTALL_DIR is already in PATH"
+    Write-Host "$normalizedInstall is already in PATH"
 }
 
 # 7. Cleanup 清理
@@ -148,3 +190,4 @@ if (Test-Path "$INSTALL_DIR\tricode.exe") {
 } else {
     Write-Warning "Installation may have issues. Binary not found."
 }
+

uninstall_tricode.ps1

@@ -0,0 +1,91 @@
+<#
+Tricode-cli Uninstaller for Windows (PowerShell)
+Removes installed binary and PATH modifications made by install_tricode.ps1
+#>
+
+$ErrorActionPreference = "Stop"
+$REPO = "Trirrin/Tricode-cli"
+$INSTALL_DIR = Join-Path $env:LOCALAPPDATA "Tricode"
+$TARGET = Join-Path $INSTALL_DIR "tricode.exe"
+
+function Write-Info {
+    param([string]$Message)
+    Write-Host $Message -ForegroundColor Green
+}
+
+function Write-Error-Exit {
+    param([string]$Message, [int]$Code = 1)
+    Write-Host "`n[ERROR] $Message" -ForegroundColor Red
+    Write-Host "Please report issues to: https://github.com/$REPO/issues" -ForegroundColor Yellow
+    exit $Code
+}
+
+Write-Info "Uninstalling Tricode-cli..."
+
+# 1) Remove binary
+try {
+    if (Test-Path $TARGET) {
+        Remove-Item -Path $TARGET -Force
+        Write-Host "Removed binary: $TARGET"
+    } else {
+        Write-Host "Binary not found at: $TARGET (already removed)"
+    }
+} catch {
+    Write-Error-Exit "Failed to remove binary at $TARGET`nError: $_" 1
+}
+
+# 2) Remove INSTALL_DIR from User PATH if present (precise match only)
+try {
+    $USER_PATH = [Environment]::GetEnvironmentVariable("Path", "User")
+    $normalizedInstall = $INSTALL_DIR.TrimEnd('\\')
+    if ($null -ne $USER_PATH -and $USER_PATH -ne '') {
+        $segments = $USER_PATH -split ";"
+        $filtered = foreach ($seg in $segments) {
+            if ($null -eq $seg -or $seg -eq '') { continue }
+            $segTrim = $seg.Trim()
+            $segNorm = $segTrim.TrimEnd('\\')
+            if ($segNorm -ieq $normalizedInstall) { continue }
+            $segTrim
+        }
+        $NEW_PATH = ($filtered | Where-Object { $_ -and $_ -ne '' }) -join ";"
+        [Environment]::SetEnvironmentVariable("Path", $NEW_PATH, "User")
+        Write-Host "Removed $INSTALL_DIR from User PATH"
+
+        # Update current session PATH similarly
+        $sessionPath = $env:Path
+        if ($null -ne $sessionPath -and $sessionPath -ne '') {
+            $sSegments = $sessionPath -split ";"
+            $sFiltered = foreach ($seg in $sSegments) {
+                if ($null -eq $seg -or $seg -eq '') { continue }
+                $segTrim = $seg.Trim()
+                $segNorm = $segTrim.TrimEnd('\\')
+                if ($segNorm -ieq $normalizedInstall) { continue }
+                $segTrim
+            }
+            $env:Path = ($sFiltered | Where-Object { $_ -and $_ -ne '' }) -join ";"
+        }
+    } else {
+        Write-Host "$INSTALL_DIR was not in User PATH"
+    }
+} catch {
+    Write-Host "Warning: Failed to update PATH automatically. You may remove it manually from Environment Variables." -ForegroundColor Yellow
+}
+
+# 3) Remove install directory if empty
+try {
+    if (Test-Path $INSTALL_DIR) {
+        $items = Get-ChildItem -Path $INSTALL_DIR -Force -ErrorAction SilentlyContinue
+        if (-not $items) {
+            Remove-Item -Path $INSTALL_DIR -Force -Recurse
+            Write-Host "Removed empty directory: $INSTALL_DIR"
+        }
+    }
+} catch {
+    Write-Host "Warning: Failed to remove directory $INSTALL_DIR. You can delete it manually." -ForegroundColor Yellow
+}
+
+Write-Host "`n[Success] Tricode-cli uninstalled."
+Write-Host "(成功) Tricode-cli 已卸载。"
+Write-Host "Note: Please restart your terminal or PowerShell."
+Write-Host "提示: 请重启终端或 PowerShell。"
+