fix: improve startup diagnostics

Author: dreamguxiang

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -39,7 +39,12 @@ body:
       label: Version
       description: The version of the application you are using. (e.g. 1.0.0)
 
+  - type: textarea
+    attributes:
+      label: Logs
+      description: If LeviLauncher fails to open or closes immediately, please attach `%APPDATA%\\levilauncher.exe\\logs\\startup.log`.
+
   - type: textarea
     attributes:
       label: Additional context
-      description: Add any other context about the problem here.
+      description: Add any other context about the problem here. If startup fails before the UI appears, include `%APPDATA%\\levilauncher.exe\\logs\\startup.log` when possible.

docs/guide/update-troubleshooting.md

@@ -19,6 +19,12 @@ Use this page when LeviLauncher installs, updates, or launches do not behave as
 - Move your managed content path to a writable location in **Settings**.
 - If the launcher requests elevation for install or self-update, allow it when you trust the action.
 
+### LeviLauncher closes immediately or never shows a window
+
+- On Windows, LeviLauncher now starts WebView2 in a safer software-rendered mode to reduce startup crashes on some GPU and driver combinations.
+- If the launcher still fails before the UI appears, check `%APPDATA%\levilauncher.exe\logs\startup.log`.
+- Retry once after a failed launch. If it still happens, attach `startup.log` when opening a GitHub issue.
+
 ### A version fails to launch
 
 - test the same version without mods
@@ -59,4 +65,3 @@ When reporting, include:
 - screenshots or logs if available
 
 Open issues here: [GitHub Issues](https://github.com/LiteLDev/LeviLauncher/issues)
-

docs/zh-CN/guide/update-troubleshooting.md

@@ -19,6 +19,12 @@
 - 在 **Settings** 中把托管内容路径改到可写位置。
 - 如果启动器在安装或自更新时要求提升权限，只在你确认可信时允许执行。
 
+### LeviLauncher 本体一闪即退或双击没反应
+
+- 在 Windows 上，LeviLauncher 现在会以更保守的 WebView2 软件渲染模式启动，以降低部分显卡和驱动组合下的启动崩溃概率。
+- 如果界面还没出现就退出，请先检查 `%APPDATA%\levilauncher.exe\logs\startup.log`。
+- 失败后可以先重试一次；如果仍然复现，提交 Issue 时请附上 `startup.log`。
+
 ### 某个版本无法启动
 
 - 先测试该版本在无 Mods 情况下能否启动
@@ -59,4 +65,3 @@ LeviLauncher 可以检查、下载并安装应用更新。若安装目录不可
 - 截图或日志（如果有）
 
 问题反馈入口： [GitHub Issues](https://github.com/LiteLDev/LeviLauncher/issues)
-

go.mod

@@ -10,7 +10,7 @@ require (
 	github.com/google/go-github/v30 v30.1.0
 	github.com/joho/godotenv v1.5.1
 	github.com/mouuff/go-rocket-update v1.5.6
-	github.com/wailsapp/wails/v3 v3.0.0-alpha.74
+	github.com/wailsapp/wails/v3 v3.0.0-alpha.77
 	golang.org/x/sys v0.40.0
 	gopkg.in/natefinch/npipe.v2 v2.0.0-20160621034901-c1b8fa8bdcce
 )

go.sum

@@ -122,8 +122,8 @@ github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu
 github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
 github.com/wailsapp/go-webview2 v1.0.23 h1:jmv8qhz1lHibCc79bMM/a/FqOnnzOGEisLav+a0b9P0=
 github.com/wailsapp/go-webview2 v1.0.23/go.mod h1:qJmWAmAmaniuKGZPWwne+uor3AHMB5PFhqiK0Bbj8kc=
-github.com/wailsapp/wails/v3 v3.0.0-alpha.74 h1:wRm1EiDQtxDisXk46NtpiBH90STwfKp36NrTDwOEdxw=
-github.com/wailsapp/wails/v3 v3.0.0-alpha.74/go.mod h1:4saK4A4K9970X+X7RkMwP2lyGbLogcUz54wVeq4C/V8=
+github.com/wailsapp/wails/v3 v3.0.0-alpha.77 h1:7oM39SMUKP3cG3i1XZ6rLwuOTjkEEGW7m7weFe/GRsQ=
+github.com/wailsapp/wails/v3 v3.0.0-alpha.77/go.mod h1:4saK4A4K9970X+X7RkMwP2lyGbLogcUz54wVeq4C/V8=
 github.com/xanzy/ssh-agent v0.3.3 h1:+/15pJfg/RsTxqYcX6fHqOXZwwMP+2VyYWJeWM2qQFM=
 github.com/xanzy/ssh-agent v0.3.3/go.mod h1:6dzNDKs0J9rVPHPhaGCukekBHKqfl+L3KghI1Bc68Uw=
 golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=

internal/apppath/apppath.go

@@ -16,6 +16,20 @@ func SetBaseRootOverride(path string) {
 	baseRootOverride = path
 }
 
+func executableStorageRoot() string {
+	exeName := "levilauncher.exe"
+	if exe, err := os.Executable(); err == nil {
+		base := strings.TrimSpace(filepath.Base(exe))
+		if base != "" {
+			exeName = strings.ToLower(base)
+		}
+	}
+
+	root := filepath.Join(AppData(), exeName)
+	_ = os.MkdirAll(root, 0o755)
+	return root
+}
+
 func LauncherDir() string {
 	exe, err := os.Executable()
 	if err != nil {
@@ -36,22 +50,23 @@ func AppData() string {
 }
 
 func ConfigPath() string {
-	exeName := "levilauncher.exe"
-	if exe, err := os.Executable(); err == nil {
-		b := strings.TrimSpace(filepath.Base(exe))
-		if b != "" {
-			exeName = strings.ToLower(b)
-		}
-	}
-	base := filepath.Join(AppData(), exeName)
-	_ = os.MkdirAll(base, 0o755)
-	return filepath.Join(base, "config.json")
+	return filepath.Join(executableStorageRoot(), "config.json")
 }
 
 func ConfigDir() string {
 	return filepath.Dir(ConfigPath())
 }
 
+func LogsDir() string {
+	dir := filepath.Join(executableStorageRoot(), "logs")
+	_ = os.MkdirAll(dir, 0o755)
+	return dir
+}
+
+func StartupLogPath() string {
+	return filepath.Join(LogsDir(), "startup.log")
+}
+
 func BaseRoot() string {
 	if v := strings.TrimSpace(baseRootOverride); v != "" {
 		_ = os.MkdirAll(v, 0o755)
@@ -65,17 +80,7 @@ func BaseRoot() string {
 		}
 	}
 
-	exeName := "levilauncher.exe"
-	if exe, err := os.Executable(); err == nil {
-		base := strings.TrimSpace(filepath.Base(exe))
-		if base != "" {
-			exeName = strings.ToLower(base)
-		}
-	}
-
-	root := filepath.Join(AppData(), exeName)
-	_ = os.MkdirAll(root, 0o755)
-	return root
+	return executableStorageRoot()
 }
 
 func InstallersDir() (string, error) {