@yufengtadian/freedom-cli 1.12.17 → 1.13.0

package/templates/go/pkg/freedom/window_windows.go

@@ -3,33 +3,12 @@
 package freedom
 
 import (
-	"bytes"
-	"encoding/base64"
-	"encoding/binary"
+	"encoding/json"
 	"fmt"
-	"image"
-	"image/color"
-	"image/png"
 	"syscall"
-
-	"golang.org/x/sys/windows"
-	"golang.org/x/sys/windows/registry"
+	"unsafe"
 )
 
-// 进程级 DPI 感知：让窗口坐标 / WebView 渲染统一按物理像素工作。
-// 若不设置，高 DPI 系统（如 125%/150% 缩放）下 GetWindowRect 返回逻辑坐标，
-// 与物理像素的鼠标坐标错位（UI 自动化难定位），且 WebView 内容渲染模糊。
-// 必须在窗口创建前生效，故放在 init()。
-func init() {
-	shcore := syscall.NewLazyDLL("shcore.dll")
-	procSetProcessDpiAwareness := shcore.NewProc("SetProcessDpiAwareness")
-	r, _, _ := procSetProcessDpiAwareness.Call(2) // PER_MONITOR_DPI_AWARE
-	if r != 0 {
-		// 回退到 user32 的旧版 API（Win 8 以下 / 调用失败时）
-		user32win.NewProc("SetProcessDPIAware").Call()
-	}
-}
-
 // Windows 平台原生窗口操作（user32 / dwmapi）。
 // 供标题栏策略（applyTitleBar）与前端 window.freedom.window.* 控制使用。
 
@@ -40,51 +19,127 @@ var (
 	procGetWindowLongPtr = user32win.NewProc("GetWindowLongPtrW")
 	procSetWindowLongPtr = user32win.NewProc("SetWindowLongPtrW")
 	procShowWindow       = user32win.NewProc("ShowWindow")
+	procPostMessage      = user32win.NewProc("PostMessageW")
 	procIsZoomed         = user32win.NewProc("IsZoomed")
 	procSetWindowPos     = user32win.NewProc("SetWindowPos")
 	procSetWindowText    = user32win.NewProc("SetWindowTextW")
-	procPostMessage      = user32win.NewProc("PostMessageW")
-	procGetModuleHandle  = kernel32.NewProc("GetModuleHandleW")
-	procLoadImage        = user32win.NewProc("LoadImageW")
-	procGetSystemMetrics = user32win.NewProc("GetSystemMetrics")
-	procSendMessage      = user32win.NewProc("SendMessageW")
-	procReleaseCapture   = user32win.NewProc("ReleaseCapture")
-	procGetWindowRect    = user32win.NewProc("GetWindowRect")
+	// 以下 proc 供 center_windows.go 的 applyCenter 使用（窗口居中），
+	// 统一在此声明，避免多文件各自 NewLazyDLL/NewProc 重复加载 user32。
+	procGetSystemMetrics  = user32win.NewProc("GetSystemMetrics")
 	procMonitorFromWindow = user32win.NewProc("MonitorFromWindow")
-	procGetMonitorInfo   = user32win.NewProc("GetMonitorInfoW")
-	procMoveWindow       = user32win.NewProc("MoveWindow")
-
-	procDestroyIcon = user32win.NewProc("DestroyIcon")
+	procGetMonitorInfo    = user32win.NewProc("GetMonitorInfoW")
+	procMoveWindow        = user32win.NewProc("MoveWindow")
+	// 以下 proc 供 tray_windows.go / syscap_windows.go 使用（图标加载与释放），
+	// 与模板 window_windows.go 保持一致，避免多文件重复声明。
+	procGetModuleHandle = kernel32.NewProc("GetModuleHandleW")
+	procLoadImage       = user32win.NewProc("LoadImageW")
+	procDestroyIcon     = user32win.NewProc("DestroyIcon")
 
 	dwmapi                     = syscall.NewLazyDLL("dwmapi.dll")
 	procDwmExtendFrameIntoArea = dwmapi.NewProc("DwmExtendFrameIntoClientArea")
+
+	// 以下 proc 供 events_windows.go（窗口事件/全屏）与 windowControl 扩展动作使用。
+	comctl32 = syscall.NewLazyDLL("comctl32.dll")
+
+	procSetWindowSubclass = comctl32.NewProc("SetWindowSubclass")
+	procDefSubclassProc   = comctl32.NewProc("DefSubclassProc")
+
+	procGetWindowRect   = user32win.NewProc("GetWindowRect")
+	procGetClientRect   = user32win.NewProc("GetClientRect")
+	procBringWindowToTop    = user32win.NewProc("BringWindowToTop")
+	procIsIconic            = user32win.NewProc("IsIconic")
+	procIsWindowVisible     = user32win.NewProc("IsWindowVisible")
+	procGetForegroundWindow = user32win.NewProc("GetForegroundWindow")
+	procGetDpiForWindow     = user32win.NewProc("GetDpiForWindow")
+	procGetWindowTextLength = user32win.NewProc("GetWindowTextLengthW")
+	procGetWindowText       = user32win.NewProc("GetWindowTextW")
+	// 显示器枚举（sysCapCall 的 window.monitors 使用）。
+	procEnumDisplayMonitors = user32win.NewProc("EnumDisplayMonitors")
+
+	// W6 审查修复追加：PNG→HICON 绘制（gdi32）、图标合成、子类化摘除、单实例互斥量。
+	gdi32                  = syscall.NewLazyDLL("gdi32.dll")
+	procCreateDIBSection   = gdi32.NewProc("CreateDIBSection")
+	procDeleteObject       = gdi32.NewProc("DeleteObject")
+	procCreateIconIndirect = user32win.NewProc("CreateIconIndirect")
+	procRemoveWindowSubclass = comctl32.NewProc("RemoveWindowSubclass")
+	procCreateMutexW       = kernel32.NewProc("CreateMutexW")
+
+	shcore               = syscall.NewLazyDLL("shcore.dll")
+	procGetDpiForMonitor = shcore.NewProc("GetDpiForMonitor")
+
+	// 以下 proc 供 W2 系统集成（msgwindow/剪贴板/通知/外壳/注册表）使用，
+	// 按约定集中在本文件声明，其他文件复用。
+	procRegisterHotKey   = user32win.NewProc("RegisterHotKey")
+	procUnregisterHotKey = user32win.NewProc("UnregisterHotKey")
+	procPostQuitMessage  = user32win.NewProc("PostQuitMessage")
+	procGetMessageW      = user32win.NewProc("GetMessageW")
+	procTranslateMessage = user32win.NewProc("TranslateMessage")
+	procDispatchMessageW = user32win.NewProc("DispatchMessageW")
+
+	procOpenClipboard         = user32win.NewProc("OpenClipboard")
+	procCloseClipboard        = user32win.NewProc("CloseClipboard")
+	procGetClipboardData      = user32win.NewProc("GetClipboardData")
+	procEmptyClipboard        = user32win.NewProc("EmptyClipboard")
+	procSetClipboardData      = user32win.NewProc("SetClipboardData")
+	procIsClipboardFormatAvai = user32win.NewProc("IsClipboardFormatAvailable")
+
+	// Global* 复用上方 kernel32 声明。
+	procGlobalAlloc  = kernel32.NewProc("GlobalAlloc")
+	procGlobalLock   = kernel32.NewProc("GlobalLock")
+	procGlobalUnlock = kernel32.NewProc("GlobalUnlock")
+	procGlobalSize   = kernel32.NewProc("GlobalSize")
+	procGlobalFree   = kernel32.NewProc("GlobalFree")
+
+	procFindWindowW        = user32win.NewProc("FindWindowW")
+	procSendMessageTimeoutW = user32win.NewProc("SendMessageTimeoutW")
+
+	procShellExecuteW = shell32.NewProc("ShellExecuteW")
+	shlwapi            = syscall.NewLazyDLL("shlwapi.dll")
+	procSHDeleteKeyW   = shlwapi.NewProc("SHDeleteKeyW")
+
+	advapi32              = syscall.NewLazyDLL("advapi32.dll")
+	procRegOpenKeyExW     = advapi32.NewProc("RegOpenKeyExW")
+	procRegCreateKeyExW   = advapi32.NewProc("RegCreateKeyExW")
+	procRegSetValueExW    = advapi32.NewProc("RegSetValueExW")
+	procRegQueryValueExW  = advapi32.NewProc("RegQueryValueExW")
+	procRegDeleteValueW   = advapi32.NewProc("RegDeleteValueW")
+	procRegCloseKey       = advapi32.NewProc("RegCloseKey")
+
+	procSetProcessDpiAwarenessContext = user32win.NewProc("SetProcessDpiAwarenessContext")
 )
 
+// DPI Per-Monitor V2 经进程启动时 API 声明，而非 .syso 内嵌 manifest——
+// WinLibs mingw 链接期会自动注入 default-manifest.o，与自定义 manifest 冲突。
+// init 先于消息循环执行，确保首个窗口创建前生效（对标 Tauri manifest 声明）。
+func init() {
+	if procSetProcessDpiAwarenessContext.Find() != nil {
+		return // Win10 1703 之前无此 API：保持系统默认感知级
+	}
+	const dpiPerMonitorV2 = ^uintptr(3) // (DPI_HANDLE)-4：DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2
+	procSetProcessDpiAwarenessContext.Call(dpiPerMonitorV2)
+}
+
 const (
 	wsCaption    = 0x00C00000 // WS_CAPTION = WS_BORDER | WS_DLGFRAME
 	wsSysMenu    = 0x00080000
 	wsThickFrame = 0x00040000
 
-	wmClose   = 0x0010 // WM_CLOSE：请求窗口正常关闭（触发 GoWnd 的关闭回调）
-	wmSetIcon = 0x0080 // WM_SETICON：设置窗口大/小图标（ICON_BIG=1 / ICON_SMALL=0）
-
-	rtIcon     = 3 // RT_ICON 资源类型（rcedit 注入图标二进制）
 	swHide     = 0
 	swShow     = 5
 	swMinimize = 6
 	swRestore  = 9
 	swMaximize = 3
 
-	smCXIcon  = 11 // SM_CXICON
-	smCYIcon  = 12 // SM_CYICON
-	smCXSmall = 13 // SM_CXSMICON
-	smCYSmall = 14 // SM_CYSMICON
-
 	swpFrameChanged = 0x0020
 	swpNoMove       = 0x0002
 	swpNoSize       = 0x0001
 	swpNoZOrder     = 0x0004
 	swpNoActivate   = 0x0010
+
+	wmClose = 0x0010 // WM_CLOSE：请求窗口正常关闭（触发 DestroyWindow 释放 WebView 资源）
+
+	smCXSmall = 13 // SM_CXSMICON
+	smCYSmall = 14 // SM_CYSMICON
 )
 
 // gwlStyle = GWL_STYLE（-16）。用变量声明，避免 uintptr 常量转换溢出。
@@ -110,151 +165,348 @@ func refreshFrame(hwnd uintptr) {
 }
 
 // windowControl 处理前端 window.freedom.window.* 请求（Windows 实现）。
-func windowControl(a *App, action string) (interface{}, error) {
-	hwnd := a.WindowHandle()
+// paramsJSON 为动作参数（JSON object，可空），与 sysCapCall 的 params 风格一致。
+func windowControl(hwnd uintptr, action string, mode TitleBarMode, paramsJSON string) (interface{}, error) {
 	if hwnd == 0 {
 		return nil, fmt.Errorf("window not ready")
 	}
+	p := parseWinParams(paramsJSON)
 	switch action {
 	case "minimize":
 		procShowWindow.Call(hwnd, swMinimize)
 		return nil, nil
 	case "maximize":
-		maximizeWindow(hwnd)
+		procShowWindow.Call(hwnd, swMaximize)
 		return nil, nil
 	case "unmaximize", "restore":
-		restoreWindow(hwnd)
+		procShowWindow.Call(hwnd, swRestore)
 		return nil, nil
 	case "toggleMaximize":
-		if isWindowMaximized(hwnd) {
-			restoreWindow(hwnd)
+		if isZoomed(hwnd) {
+			procShowWindow.Call(hwnd, swRestore)
 		} else {
-			maximizeWindow(hwnd)
+			procShowWindow.Call(hwnd, swMaximize)
 		}
 		return nil, nil
 	case "close":
-		// 发送 WM_CLOSE 请求正常关闭（触发 GoWnd 关闭回调，释放 WebView 资源）。
-		// 注意：不能使用 user32.CloseWindow —— 该 API 语义是最小化窗口。
+		// force=true 时先解除关闭拦截，保证前端确认后能真正关闭。
+		if force, _ := p.boolean("force"); force {
+			if rt, err := runtimeFor(hwnd); err == nil {
+				rt.interceptClose.Store(false)
+			}
+		}
+		// 发送 WM_CLOSE 走正常关闭流程（触发 DestroyWindow，释放 WebView 资源）。
+		// 不能使用 user32.CloseWindow——该 API 的语义是最小化窗口而非关闭。
 		procPostMessage.Call(hwnd, wmClose, 0, 0)
 		return nil, nil
 	case "isMaximized":
-		return isWindowMaximized(hwnd), nil
+		return isZoomed(hwnd), nil
 	case "isFrameless":
-		return a.cfg.TitleBar == TitleBarFrameless, nil
-	case "appIcon":
-		// 从 exe 内嵌图标（PE 资源 ID=1）提取，转为 PNG data URL 供前端标题栏显示。
-		// 不依赖 resources 文件夹里的任何图标文件。
-		return exeAppIconDataURL(), nil
-	case "startDrag":
-		// 前端标题栏 mousedown 时发起窗口拖动（WM_NCLBUTTONDOWN + HTCAPTION）。
-		// 相比 -webkit-app-region: drag，可保留双击最大化 / 右键菜单等页面事件。
-		procReleaseCapture.Call()
-		procSendMessage.Call(hwnd, 0x00A1 /*WM_NCLBUTTONDOWN*/, 2 /*HTCAPTION*/, 0)
+		// 仅 frameless 返回 true：hidden 模式保留 DWM 原生按钮，
+		// 前端若据 isFrameless 自绘按钮会与原生按钮重叠。
+		return mode == TitleBarFrameless, nil
+
+	// ---- W1 对标 Tauri：位置 / 尺寸 ----
+	case "setPosition":
+		r, err := getWindowRect(hwnd)
+		if err != nil {
+			return nil, err
+		}
+		x, okx := p.intv("x")
+		y, oky := p.intv("y")
+		if !okx || !oky {
+			return nil, fmt.Errorf("setPosition requires x,y")
+		}
+		procMoveWindow.Call(hwnd, uintptr(int32(x)), uintptr(int32(y)),
+			uintptr(r.right-r.left), uintptr(r.bottom-r.top), 1)
+		return nil, nil
+	case "setSize":
+		r, err := getWindowRect(hwnd)
+		if err != nil {
+			return nil, err
+		}
+		w, okw := p.intv("width")
+		h, okh := p.intv("height")
+		if !okw || !okh {
+			return nil, fmt.Errorf("setSize requires width,height")
+		}
+		procMoveWindow.Call(hwnd, uintptr(r.left), uintptr(r.top), uintptr(int32(w)), uintptr(int32(h)), 1)
+		return nil, nil
+	case "getPosition":
+		r, err := getWindowRect(hwnd)
+		if err != nil {
+			return nil, err
+		}
+		return map[string]int{"x": int(r.left), "y": int(r.top)}, nil
+	case "getSize":
+		r, err := getWindowRect(hwnd)
+		if err != nil {
+			return nil, err
+		}
+		return map[string]int{"width": int(r.right - r.left), "height": int(r.bottom - r.top)}, nil
+	case "innerSize":
+		r := getClientRect(hwnd)
+		return map[string]int{"width": int(r.right - r.left), "height": int(r.bottom - r.top)}, nil
+	case "center":
+		r, err := getWindowRect(hwnd)
+		if err != nil {
+			return nil, err
+		}
+		x, y := centeredForWindow(hwnd, int(r.right-r.left), int(r.bottom-r.top))
+		procMoveWindow.Call(hwnd, uintptr(int32(x)), uintptr(int32(y)),
+			uintptr(r.right-r.left), uintptr(r.bottom-r.top), 1)
+		return nil, nil
+	case "setTitle":
+		s, ok := p.strv("title")
+		if !ok {
+			return nil, fmt.Errorf("setTitle requires title")
+		}
+		ptr, err := syscall.UTF16PtrFromString(s)
+		if err != nil {
+			return nil, fmt.Errorf("setTitle: title must not contain NUL")
+		}
+		procSetWindowText.Call(hwnd, uintptr(unsafe.Pointer(ptr)))
 		return nil, nil
+
+	// ---- W1：可见性 / 层级 / 焦点 ----
+	case "show":
+		procShowWindow.Call(hwnd, swShow)
+		return nil, nil
+	case "hide":
+		procShowWindow.Call(hwnd, swHide)
+		return nil, nil
+	case "focus":
+		if isIconic(hwnd) {
+			procShowWindow.Call(hwnd, swRestore)
+		}
+		procBringWindowToTop.Call(hwnd)
+		procSetForegroundWindow.Call(hwnd)
+		return nil, nil
+	case "isVisible":
+		r, _, _ := procIsWindowVisible.Call(hwnd)
+		return r != 0, nil
+	case "isFocused":
+		fg, _, _ := procGetForegroundWindow.Call()
+		return fg == hwnd, nil
+	case "isMinimized":
+		return isIconic(hwnd), nil
+	case "setAlwaysOnTop":
+		on, ok := p.boolean("on")
+		if !ok {
+			return nil, fmt.Errorf("setAlwaysOnTop requires on")
+		}
+		top := hwndNotopmost
+		if on {
+			top = hwndTopmost
+		}
+		procSetWindowPos.Call(hwnd, top, 0, 0, 0, 0, swpNoMove|swpNoSize|swpNoActivate)
+		return nil, nil
+	case "setSkipTaskbar":
+		on, ok := p.boolean("on")
+		if !ok {
+			return nil, fmt.Errorf("setSkipTaskbar requires on")
+		}
+		ex, _, _ := procGetWindowLongPtr.Call(hwnd, uintptr(int(gwlExStyle)))
+		if on {
+			ex |= wsExToolwindow
+		} else {
+			ex &^= wsExToolwindow
+		}
+		procSetWindowLongPtr.Call(hwnd, uintptr(int(gwlExStyle)), ex)
+		// 任务栏按钮变化需 SWP_FRAMECHANGED + 显示标志才能即时生效。
+		procSetWindowPos.Call(hwnd, 0, 0, 0, 0, 0,
+			swpFrameChanged|swpNoMove|swpNoSize|swpNoZOrder|swpNoActivate|swpShowWindow)
+		return nil, nil
+
+	// ---- W1：行为开关 ----
+	case "setResizable":
+		on, ok := p.boolean("on")
+		if !ok {
+			return nil, fmt.Errorf("setResizable requires on")
+		}
+		style := getWindowStyle(hwnd)
+		if on {
+			style |= wsThickFrame
+		} else {
+			style &^= wsThickFrame
+		}
+		setWindowStyle(hwnd, style)
+		refreshFrame(hwnd)
+		return nil, nil
+	case "setMaximizable":
+		on, ok := p.boolean("on")
+		if !ok {
+			return nil, fmt.Errorf("setMaximizable requires on")
+		}
+		style := getWindowStyle(hwnd)
+		if on {
+			style |= wsMaximizeBox
+		} else {
+			style &^= wsMaximizeBox
+		}
+		setWindowStyle(hwnd, style)
+		refreshFrame(hwnd)
+		return nil, nil
+	case "setMinimizable":
+		on, ok := p.boolean("on")
+		if !ok {
+			return nil, fmt.Errorf("setMinimizable requires on")
+		}
+		style := getWindowStyle(hwnd)
+		if on {
+			style |= wsMinimizeBox
+		} else {
+			style &^= wsMinimizeBox
+		}
+		setWindowStyle(hwnd, style)
+		refreshFrame(hwnd)
+		return nil, nil
+
+	// ---- W1：全屏 / 关闭拦截 ----
+	case "setFullscreen":
+		on, ok := p.boolean("on")
+		if !ok {
+			return nil, fmt.Errorf("setFullscreen requires on")
+		}
+		return nil, setFullscreen(hwnd, on)
+	case "isFullscreen":
+		rt, err := runtimeFor(hwnd)
+		if err != nil {
+			return false, nil
+		}
+		return rt.getFullscreen(), nil
+	case "interceptClose":
+		on, ok := p.boolean("on")
+		if !ok {
+			return nil, fmt.Errorf("interceptClose requires on")
+		}
+		rt, err := runtimeFor(hwnd)
+		if err != nil {
+			return nil, err
+		}
+		rt.interceptClose.Store(on)
+		return nil, nil
+
+	// ---- W1：信息查询 ----
+	case "getInfo":
+		return getWindowInfo(hwnd, mode)
 	default:
 		return nil, fmt.Errorf("unknown window action %q", action)
 	}
 }
 
-// maximizeWindow 最大化窗口。
-// 直接走系统 SW_MAXIMIZE：壳层（webview_go fork）在 WndProc 的 WM_GETMINMAXINFO 中
-// 已把无边框窗口的最大化边界限定到监视器工作区（rcWork），
-// 因此"最大化 = 铺满任务栏上方的工作区"，而非 F11 式整屏全屏。
-func maximizeWindow(hwnd uintptr) {
-	procShowWindow.Call(hwnd, swMaximize)
+// getWindowInfo 聚合窗口状态（物理像素；scaleFactor 为 DPI 缩放）。
+func getWindowInfo(hwnd uintptr, mode TitleBarMode) (map[string]interface{}, error) {
+	r, err := getWindowRect(hwnd)
+	if err != nil {
+		return nil, err
+	}
+	cr := getClientRect(hwnd)
+	ex, _, _ := procGetWindowLongPtr.Call(hwnd, uintptr(int(gwlExStyle)))
+	vis, _, _ := procIsWindowVisible.Call(hwnd)
+	fg, _, _ := procGetForegroundWindow.Call()
+	rt, rtErr := runtimeFor(hwnd)
+	return map[string]interface{}{
+		"title":       getWindowText(hwnd),
+		"outerX":      int(r.left),
+		"outerY":      int(r.top),
+		"outerWidth":  int(r.right - r.left),
+		"outerHeight": int(r.bottom - r.top),
+		"innerWidth":  int(cr.right - cr.left),
+		"innerHeight": int(cr.bottom - cr.top),
+		"scaleFactor": windowScaleFactor(hwnd),
+		"visible":     vis != 0,
+		"focused":     fg == hwnd,
+		"maximized":   isZoomed(hwnd),
+		"minimized":   isIconic(hwnd),
+		"alwaysOnTop": ex&wsExTopmost != 0,
+		"skipTaskbar": ex&wsExToolwindow != 0,
+		"frameless":   mode == TitleBarFrameless,
+		"fullscreen":  rtErr == nil && rt.getFullscreen(),
+	}, nil
 }
 
-// restoreWindow 还原窗口（系统 SW_RESTORE，恢复到最大化前的位置与尺寸）。
-func restoreWindow(hwnd uintptr) {
-	procShowWindow.Call(hwnd, swRestore)
+func isIconic(hwnd uintptr) bool {
+	r, _, _ := procIsIconic.Call(hwnd)
+	return r != 0
 }
 
-// isWindowMaximized 判断窗口当前是否处于最大化状态。
-func isWindowMaximized(hwnd uintptr) bool {
-	return isZoomed(hwnd)
+// getWindowText 读取窗口标题（GetWindowTextW）。
+func getWindowText(hwnd uintptr) string {
+	n, _, _ := procGetWindowTextLength.Call(hwnd)
+	if n == 0 {
+		return ""
+	}
+	buf := make([]uint16, n+1)
+	procGetWindowText.Call(hwnd, uintptr(unsafe.Pointer(&buf[0])), uintptr(len(buf)))
+	return syscall.UTF16ToString(buf)
 }
 
-// exeIconData 读取当前 exe 内嵌的 RT_ICON 资源原始字节（rcedit 注入时资源 ID=1）。
-// 不依赖 RT_GROUP_ICON 的 ID（rcedit 固定写入 0，而 LoadImageW 按硬编码 ID 加载会失败），
-// 直接取 RT_ICON 二进制，兼容任意注入工具。
-// 使用 x/sys/windows 类型化 API（LoadResourceData 直接返回字节副本，无需 unsafe 指针转换）。
-func exeIconData() []byte {
-	var hInst windows.Handle
-	if err := windows.GetModuleHandleEx(0, nil, &hInst); err != nil {
-		return nil
+// winParams 是窗口动作的 JSON 参数对象。
+type winParams map[string]json.RawMessage
+
+func parseWinParams(paramsJSON string) winParams {
+	var p winParams
+	if len(paramsJSON) > 0 && paramsJSON != "null" {
+		_ = json.Unmarshal([]byte(paramsJSON), &p)
 	}
-	// FindResourceW(hModule, MAKEINTRESOURCE(1), MAKEINTRESOURCE(RT_ICON))
-	resInfo, err := windows.FindResource(hInst, windows.ResourceID(1), windows.ResourceID(rtIcon))
-	if err != nil {
-		return nil
+	return p
+}
+
+func (p winParams) intv(k string) (int, bool) {
+	if v, ok := p[k]; ok {
+		var f float64
+		if json.Unmarshal(v, &f) == nil {
+			return int(f), true
+		}
 	}
-	data, err := windows.LoadResourceData(hInst, resInfo)
-	if err != nil {
-		return nil
+	return 0, false
+}
+
+func (p winParams) strv(k string) (string, bool) {
+	if v, ok := p[k]; ok {
+		var s string
+		if json.Unmarshal(v, &s) == nil {
+			return s, true
+		}
 	}
-	return data
+	return "", false
 }
 
-// isPNG 判断字节流是否为 PNG 编码（rcedit 注入的 .ico 内嵌 PNG 时 RT_ICON 数据即 PNG）。
-func isPNG(b []byte) bool {
-	return len(b) >= 8 && b[0] == 0x89 && b[1] == 'P' && b[2] == 'N' && b[3] == 'G'
+func (p winParams) boolean(k string) (bool, bool) {
+	if v, ok := p[k]; ok {
+		var b bool
+		if json.Unmarshal(v, &b) == nil {
+			return b, true
+		}
+	}
+	return false, false
+}
+
+func isZoomed(hwnd uintptr) bool {
+	r, _, _ := procIsZoomed.Call(hwnd)
+	return r != 0
 }
 
 // loadExeIcon 从 exe 内嵌的 RT_GROUP_ICON 资源加载 HICON。
 // rcedit 注入的 group icon 资源 ID 固定为 0（LoadImageW 需按该 ID 加载；
 // 历史按 ID=1 硬编码导致加载失败，故此处显式用 0）。
 // 调用方用完须 procDestroyIcon 释放；加载失败返回 0。
+// 供 tray_windows.go 托盘图标与 syscap_windows.go 窗口效果使用。
 func loadExeIcon(cx, cy uintptr) uintptr {
 	hInst, _, _ := procGetModuleHandle.Call(0)
 	if hInst == 0 {
 		return 0
 	}
-	// LoadImageW(hInst, MAKEINTRESOURCE(0), IMAGE_ICON, cx, cy, LR_DEFAULTCOLOR)
-	r, _, _ := procLoadImage.Call(hInst, 0, 1 /*IMAGE_ICON*/, cx, cy, 0 /*LR_DEFAULTCOLOR*/)
-	return r
-}
-
-// exeAppIconDataURL 从当前 exe 的 PE 资源图标（rcedit 注入的 RT_ICON）提取为 PNG data URL。
-// 无法提取时返回空字符串（前端隐藏图标）。
-func exeAppIconDataURL() string {
-	data := exeIconData()
-	if len(data) == 0 {
-		return ""
-	}
-	// rcedit 注入 .ico 内嵌 PNG 时，RT_ICON 数据即 PNG 字节，直接编码
-	if isPNG(data) {
-		return "data:image/png;base64," + base64.StdEncoding.EncodeToString(data)
-	}
-	// 非 PNG（BMP/DIB）：纯 Go 解析像素并编码为 PNG，无需 GDI 绘制
-	img, err := dibToPNG(data)
-	if err != nil {
-		return ""
-	}
-	return "data:image/png;base64," + base64.StdEncoding.EncodeToString(img)
-}
-
-// webview2Available 检测 Windows 是否已安装 WebView2 Runtime。
-// webview_create（WEBVIEW_EDGE）失败的最常见原因是缺少 WebView2 Runtime，
-// 检测其安装注册表键（EdgeUpdate Clients GUID）判断状态，便于给出可操作提示。
-// 返回值仅用于决定错误文案，不参与窗口创建逻辑。
-func webview2Available() bool {
-	guid := `{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}`
-	key := `SOFTWARE\WOW6432Node\Microsoft\EdgeUpdate\Clients\` + guid
-	if k, err := registry.OpenKey(registry.LOCAL_MACHINE, key, registry.QUERY_VALUE|registry.READ); err == nil {
-		k.Close()
-		return true
-	}
-	key2 := `SOFTWARE\Microsoft\EdgeUpdate\Clients\` + guid
-	if k, err := registry.OpenKey(registry.LOCAL_MACHINE, key2, registry.QUERY_VALUE|registry.READ); err == nil {
-		k.Close()
-		return true
+	// 先按 rcedit 注入约定 RT_GROUP_ICON ID=0 加载；失败回退 ID=1（M3：
+	// 与 appIcon 的 RT_ICON ID 假设解耦，兼容不同注入工具的资源 ID）。
+	for _, id := range []uintptr{0, 1} {
+		// LoadImageW(hInst, MAKEINTRESOURCE(id), IMAGE_ICON, cx, cy, LR_DEFAULTCOLOR)
+		if r, _, _ := procLoadImage.Call(hInst, id, 1 /*IMAGE_ICON*/, cx, cy, 0 /*LR_DEFAULTCOLOR*/); r != 0 {
+			return r
+		}
 	}
-	return false
-}
-
-func isZoomed(hwnd uintptr) bool {
-	r, _, _ := procIsZoomed.Call(hwnd)
-	return r != 0
+	return 0
 }
 
 // applyTitleBar 依据配置调整窗口标题栏（Windows 实现）。
@@ -265,121 +517,24 @@ func (a *App) applyTitleBar() {
 	}
 	switch a.cfg.TitleBar {
 	case TitleBarFrameless:
-		// 完全无边框：去掉标题栏 / 系统菜单 / 可调边框（WS_THICKFRAME）。
-		// - 标题栏与系统原生最小化 / 最大化 / 关闭按钮均不存在，由前端自绘
-		//   （window.freedom.window.*）接管；
-		// - 去掉 WS_THICKFRAME 是最大化行为正确的关键：只要该位存在，系统在
-		//   WM_GETMINMAXINFO 之后仍会按 AdjustWindowRectEx 追加标题栏 + 边框空间，
-		//   导致最大化窗口溢出工作区、盖住任务栏（F11 全屏感）；
-		// - 边缘拖拽 resize 由壳层 WndProc 的 WM_NCHITTEST 手动实现（返回 HT* 边界值），
-		//   不依赖 WS_THICKFRAME。
+		// 完全无边框：去掉标题栏 / 系统菜单，客户区铺满整个窗口。
+		// 最小化 / 最大化 / 关闭按钮由前端自绘（window.freedom.window.*）。
 		style := getWindowStyle(hwnd)
-		style &^= wsCaption | wsSysMenu | wsThickFrame
+		style &^= wsCaption | wsSysMenu
 		setWindowStyle(hwnd, style)
 		refreshFrame(hwnd)
-	default: // TitleBarNative：补齐系统原生标题栏与可调边框。
-		// webview_go 底层创建的窗口默认 style 不含 WS_CAPTION（见 WebView2 窗口创建），
-		// 因此 native 模式必须显式补回标题栏 / 系统菜单 / 可调边框，
-		// 否则窗口会表现为无边框（无原生三按钮、不可拖拽调整大小）。
-		style := getWindowStyle(hwnd)
-		style |= wsCaption | wsSysMenu | wsThickFrame
-		setWindowStyle(hwnd, style)
-		refreshFrame(hwnd)
-	}
-}
-
-// setWindowIcon 把 exe 内嵌的应用程序图标同步到窗口标题栏与任务栏：
-//   - native 模式：标题栏图标（ICON_SMALL）与任务栏 / Alt-Tab 图标（ICON_BIG）均来自 exe 图标，
-//     保证「标题栏图标 = exe 图标」；
-//   - frameless 模式：无标题栏，但任务栏 / Alt-Tab 仍显示 exe 图标。
-//
-// 图标经 LoadImageW 从 PE 资源 RT_GROUP_ICON(ID=0) 加载（rcedit 注入的 group icon ID=0），
-// 不依赖 resources 文件夹里的任何图标文件。
-func (a *App) setWindowIcon() {
-	hwnd := a.WindowHandle()
-	if hwnd == 0 {
-		return
-	}
-	cxIcon, _, _ := procGetSystemMetrics.Call(smCXIcon)
-	cyIcon, _, _ := procGetSystemMetrics.Call(smCYIcon)
-	cxSmall, _, _ := procGetSystemMetrics.Call(smCXSmall)
-	cySmall, _, _ := procGetSystemMetrics.Call(smCYSmall)
-	big := loadExeIcon(cxIcon, cyIcon)
-	small := loadExeIcon(cxSmall, cySmall)
-	if big != 0 {
-		procSendMessage.Call(hwnd, wmSetIcon, 1 /* ICON_BIG */, big)
-		procDestroyIcon.Call(big)
-	}
-	if small != 0 {
-		procSendMessage.Call(hwnd, wmSetIcon, 0 /* ICON_SMALL */, small)
-		procDestroyIcon.Call(small)
-	}
-}
-
-// dibToPNG 将 ICO 内嵌的 DIB 图像（BITMAPINFOHEADER 起始的裸 DIB，即 rcedit 注入
-// 非 PNG .ico 时的 RT_ICON 数据）纯 Go 解析为 PNG 字节，替代原 GDI
-// CreateDIBSection+DrawIconEx 绘制路径（消除对 gdi32/user32 绘图 API 的依赖）。
-// 支持 32/24 bpp；透明由 AND mask 决定（对应位=1 表示透明）。
-func dibToPNG(data []byte) ([]byte, error) {
-	if len(data) < 40 {
-		return nil, fmt.Errorf("DIB too short: %d bytes", len(data))
-	}
-	biSize := binary.LittleEndian.Uint32(data[0:4])
-	if biSize < 40 {
-		return nil, fmt.Errorf("unsupported BITMAPINFOHEADER size %d", biSize)
-	}
-	width := int(binary.LittleEndian.Uint32(data[4:8]))
-	heightRaw := int32(binary.LittleEndian.Uint32(data[8:12]))
-	bitCount := binary.LittleEndian.Uint16(data[14:16])
-	if width <= 0 || heightRaw == 0 {
-		return nil, fmt.Errorf("bad dimensions %dx%d", width, heightRaw)
-	}
-	bpp := (int(bitCount) + 7) / 8 // bytes per pixel
-	if bpp != 3 && bpp != 4 {
-		return nil, fmt.Errorf("unsupported bitcount %d", bitCount)
-	}
-	height := int(heightRaw)
-	if height < 0 {
-		height = -height
-	}
-	// ICO 的 DIB 高度可能为实际像素高度的 2 倍（上方 XOR + 下方 AND mask），
-	// 此时需折半，否则图像会被纵向拉伸。
-	pixelRowBytes := (width*bpp + 3) &^ 3 // 每行按 4 字节对齐
-	andRowBytes := ((width + 31) / 32) * 4
-	pxLen := pixelRowBytes * height
-	if pxLen > len(data)-int(biSize) && height%2 == 0 {
-		height /= 2
-		pxLen = pixelRowBytes * height
-	}
-	pxStart := int(biSize)
-	andStart := pxStart + pxLen
-	hasAndMask := heightRaw > 0 // 正高度表示 DIB 末尾带 AND mask
-	if !hasAndMask {
-		hasAndMask = andStart+andRowBytes*height <= len(data)
-	}
-	img := image.NewRGBA(image.Rect(0, 0, width, height))
-	for y := 0; y < height; y++ {
-		srcY := height - 1 - y // DIB 自底向上：数据首行是图像末行
-		row := pxStart + srcY*pixelRowBytes
-		andRow := andStart + srcY*andRowBytes
-		for x := 0; x < width; x++ {
-			off := row + x*bpp
-			if off+bpp > len(data) {
-				return nil, fmt.Errorf("DIB data truncated at x=%d,y=%d", x, y)
-			}
-			b := data[off]
-			g := data[off+1]
-			r := data[off+2]
-			a := uint8(255)
-			if hasAndMask && (data[andRow+x/8]>>uint(7-x%8))&1 == 1 {
-				a = 0
-			}
-			img.SetRGBA(x, y, color.RGBA{r, g, b, a})
+	case TitleBarHidden:
+		// 隐藏标题栏视觉但保留系统原生按钮：DWM 玻璃扩展。
+		// 标题栏区域透明化并并入客户区，右上角的最小化 / 最大化 / 关闭按钮
+		// 由 DWM 继续原生绘制，标题文字置空。
+		// 标题栏区域并入客户区须扩展顶部（cyTopHeight），扩展底部不影响标题栏视觉。
+		m := margins{cxLeftWidth: 0, cxRightWidth: 0, cyTopHeight: 1, cyBottomHeight: 0}
+		procDwmExtendFrameIntoArea.Call(hwnd, uintptr(unsafe.Pointer(&m)))
+		// 标题文字一并清除，标题栏区域只保留系统按钮
+		if title, err := syscall.UTF16PtrFromString(""); err == nil {
+			procSetWindowText.Call(hwnd, uintptr(unsafe.Pointer(title)))
 		}
+		refreshFrame(hwnd)
+	default: // TitleBarNative：不处理
 	}
-	var buf bytes.Buffer
-	if err := png.Encode(&buf, img); err != nil {
-		return nil, err
-	}
-	return buf.Bytes(), nil
 }