fix: improve Windows support and GPU discovery

1. Allow agent registration without GPU detection:
   - Users with AMD GPUs or no GPUs can now register agents
   - Registration continues with warning instead of failing
   - GPU configuration can be added later via dashboard

2. Fix PowerShell execution policy blocking env.ps1:
   - Added comprehensive usage instructions to env.ps1
   - Updated install.ps1 quick start guide
   - Recommend eval-style activation to bypass ExecutionPolicy

3. Improve VSCode error handling on Windows:
   - Better detection of "command not found" errors (code 9009, 1)
   - Detect Chinese error messages (不是内部或外部命令)
   - Show friendly English error with install guide link

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: andystime

cmd/ggo/agent/agent.go

@@ -210,18 +210,24 @@ func newRegisterCmd() *cobra.Command {
 
 			gpus, err := discoverGPUs()
 			if err != nil {
-				cmd.SilenceUsage = true
+				// GPU discovery failed (e.g., unsupported GPU vendor like AMD, or no GPU drivers)
+				// Log a warning but allow registration to continue with empty GPU list.
+				// This enables users to install the agent on machines without supported GPUs
+				// and add GPU configuration later via the dashboard.
 				if !out.IsJSON() {
-					out.Error(fmt.Sprintf("Failed to discover GPUs: %v", err))
+					out.Warning(fmt.Sprintf("Failed to discover GPUs: %v", err))
+					out.Warning("Registering agent without GPU configuration. You can configure GPUs later via the dashboard.")
 				}
-				return err
+				klog.Warningf("Failed to discover GPUs, continuing registration: error=%v", err)
+				gpus = []api.GPUInfo{} // Empty GPU list
 			}
-			if len(gpus) == 0 {
-				cmd.SilenceUsage = true
+			if len(gpus) == 0 && err == nil {
+				// No error but no GPUs found - warn but allow registration
 				if !out.IsJSON() {
-					out.Error("No GPUs found. Please check your GPU configuration or use GPU_GO_MOCK_GPUS for testing")
+					out.Warning("No GPUs found. Registering agent without GPU configuration.")
+					out.Info("Tip: Use GPU_GO_MOCK_GPUS=1 for testing, or configure GPUs via the dashboard.")
 				}
-				return fmt.Errorf("no GPUs found")
+				klog.Warningf("No GPUs discovered, continuing registration with empty GPU list")
 			}
 
 			agentInstance := agent.NewAgent(client, configMgr)

internal/studio/env.go

@@ -416,6 +416,20 @@ func GeneratePowerShellScript(config *GPUEnvConfig, paths *platform.Paths) (stri
 	script.WriteString("# GPU Go environment setup script (PowerShell)\n")
 	script.WriteString("# Generated by ggo use\n")
 	script.WriteString("#\n")
+	script.WriteString("# USAGE:\n")
+	script.WriteString("# If you get an ExecutionPolicy error when running this script,\n")
+	script.WriteString("# use one of these methods instead:\n")
+	script.WriteString("#\n")
+	script.WriteString("# Method 1 (Recommended): Use eval-style activation\n")
+	script.WriteString("#   ggo use <share-link> -y | Out-String | Invoke-Expression\n")
+	script.WriteString("#\n")
+	script.WriteString("# Method 2: Bypass execution policy for this script\n")
+	script.WriteString("#   powershell -ExecutionPolicy Bypass -File env.ps1\n")
+	script.WriteString("#\n")
+	script.WriteString("# Method 3: Unblock the file (requires admin)\n")
+	script.WriteString("#   Unblock-File -Path env.ps1\n")
+	script.WriteString("#   . .\\env.ps1\n")
+	script.WriteString("#\n")
 	script.WriteString("# IMPORTANT: Windows DLL loading note\n")
 	script.WriteString("# Setting PATH helps but System32 DLLs still take priority.\n")
 	script.WriteString("# For reliable GPU library loading, use: ggo launch <program>\n")

scripts/install.ps1

@@ -414,8 +414,8 @@ function Install-Ggo {
         Write-Host "  # Register as agent (on GPU server)" -ForegroundColor Gray
         Write-Host "  ggo agent register --token <your-token>" -ForegroundColor White
         Write-Host ""
-        Write-Host "  # Use a shared GPU" -ForegroundColor Gray
-        Write-Host "  ggo use <short-link>" -ForegroundColor White
+        Write-Host "  # Use a shared GPU (PowerShell)" -ForegroundColor Gray
+        Write-Host "  ggo use <short-link> -y | Out-String | Invoke-Expression" -ForegroundColor White
         Write-Host ""
     }
     finally {

vscode-extension/src/cli/cli.ts

@@ -332,29 +332,54 @@ export class CLI {
             let stderr = '';
 
             child.stdout.on('data', (data: Buffer) => {
-                stdout += data.toString();
+                // On Windows, try to decode using the correct encoding
+                // Node.js Buffer.toString() defaults to UTF-8, but Windows CMD outputs in the system codepage (e.g., GBK for Chinese Windows)
+                if (process.platform === 'win32') {
+                    // For Windows, we use UTF-8 as modern Windows shells should support it
+                    // If there are encoding issues, the user should ensure their terminal uses UTF-8
+                    stdout += data.toString('utf8');
+                } else {
+                    stdout += data.toString();
+                }
             });
 
             child.stderr.on('data', (data: Buffer) => {
-                stderr += data.toString();
+                if (process.platform === 'win32') {
+                    stderr += data.toString('utf8');
+                } else {
+                    stderr += data.toString();
+                }
             });
 
             child.on('close', (code) => {
                 if (code === 0) {
                     Logger.log(`Command success: ${args[0]}`);
                     resolve(stdout);
                 } else {
-                    const msg = stderr || `Command failed with code ${code}`;
+                    let msg = stderr || `Command failed with code ${code}`;
                     Logger.error(`Command failed (code ${code}):`, msg);
 
                     // Special handling for CLI not found
-                    if (code === 127) {
+                    // On Unix: code 127, On Windows: code 1 or 9009 with specific error patterns
+                    const isCliNotFound = code === 127 ||
+                                         code === 9009 ||
+                                         (process.platform === 'win32' && code === 1 && (
+                                             stderr.includes('is not recognized') ||
+                                             stderr.includes('不是内部或外部命令') ||
+                                             stderr.includes('not found')
+                                         ));
+
+                    if (isCliNotFound) {
+                        msg = `GPUGo CLI not found at '${cliPath}'. Please ensure ggo.exe is installed and in your PATH, or configure the path in settings.`;
                         vscode.window.showErrorMessage(
-                            `GPUGo CLI not found at '${cliPath}'. Please check your settings.`,
+                            msg,
+                            'Install Guide',
                             'Settings'
                         ).then(s => {
                             if (s === 'Settings') {
                                 vscode.commands.executeCommand('workbench.action.openSettings', 'gpugo.cliPath');
+                            } else if (s === 'Install Guide') {
+                                vscode.env.openExternal(vscode.Uri.parse('https://go.gpu.tf/docs'));
                             }
                         });
                     }