@yufengtadian/freedom-cli 1.12.1 → 1.12.13

package/templates/go/pkg/freedom/assets/index.html

@@ -45,7 +45,7 @@
     font-size: 13px;
   }
 
-  /* 无边框模式：前端自绘标题栏（hidden / frameless 时显示） */
+  /* 无边框模式：前端自绘标题栏（frameless 时显示） */
   .titlebar {
     display: none;
     height: 36px;

package/templates/go/pkg/freedom/backend_proc.go

@@ -134,12 +134,12 @@ func (p *ProcBackend) Handle(method string, params []json.RawMessage) (interface
 	id := p.nextID
 	ch := make(chan procResp, 1)
 	p.pending[id] = ch
-	msg := procMessage{ID: id, Method: method, Params: paramsJSON}
-	line, _ := json.Marshal(msg)
-	_, err = p.stdin.Write(append(line, '\n'))
+	w := p.stdin // 锁内取引用，锁外写，避免持锁阻塞（后端不消费 stdin 时 Write 可能挂起）
 	p.mu.Unlock()
 
-	if err != nil {
+	msg := procMessage{ID: id, Method: method, Params: paramsJSON}
+	line, _ := json.Marshal(msg)
+	if _, err := w.Write(append(line, '\n')); err != nil {
 		p.cancel(id, fmt.Errorf("freedom: proc backend write: %w", err))
 		return nil, err
 	}

package/templates/go/pkg/freedom/configfile.go

@@ -12,6 +12,8 @@ package freedom
 
 import (
 	"encoding/json"
+	"errors"
+	"fmt"
 	"os"
 	"path/filepath"
 )
@@ -47,19 +49,24 @@ func resourcesDir() (string, error) {
 }
 
 // loadRuntimeConfig 读取 exe 同目录 resources/config.json，将命中的字段覆盖到应用配置。
-// 文件不存在或内容非法时静默回退（返回 nil），保持编译期/默认配置不变。
+// 文件不存在时视为未配置（返回 nil，保持编译期/默认配置不变）；
+// 文件存在但读取/解析失败时返回具体错误，由调用方打印告警，避免用户手改配置出错时无感知。
 func (a *App) loadRuntimeConfig() error {
 	dir, err := resourcesDir()
 	if err != nil {
-		return nil
+		return err
 	}
-	data, err := os.ReadFile(filepath.Join(dir, "config.json"))
+	cfgPath := filepath.Join(dir, "config.json")
+	data, err := os.ReadFile(cfgPath)
 	if err != nil {
-		return nil
+		if errors.Is(err, os.ErrNotExist) {
+			return nil // 未配置：正常回退默认
+		}
+		return fmt.Errorf("read %s: %w", cfgPath, err)
 	}
 	var rc runtimeConfigFile
 	if err := json.Unmarshal(data, &rc); err != nil {
-		return nil
+		return fmt.Errorf("parse %s: %w", cfgPath, err)
 	}
 	if rc.Title != "" {
 		a.cfg.Title = rc.Title
@@ -69,8 +76,6 @@ func (a *App) loadRuntimeConfig() error {
 	switch rc.TitleBar {
 	case "native":
 		a.cfg.TitleBar = TitleBarNative
-	case "hidden":
-		a.cfg.TitleBar = TitleBarHidden
 	case "frameless":
 		a.cfg.TitleBar = TitleBarFrameless
 	}

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

@@ -29,14 +29,11 @@ import (
 type TitleBarMode string
 
 const (
-	// TitleBarNative 保留系统原生标题栏（默认）。
+	// TitleBarNative 保留系统原生标题栏（默认），标题栏图标与 exe 图标一致。
 	TitleBarNative TitleBarMode = "native"
-	// TitleBarHidden 隐藏标题栏视觉，但保留系统原生最小化 / 最大化 / 关闭按钮。
-	// 当前仅 Windows 生效（基于 DWM 扩展实现）；macOS / Linux 上回退为原生标题栏。
-	TitleBarHidden TitleBarMode = "hidden"
 	// TitleBarFrameless 完全无边框，客户区铺满整个窗口。
-	// 最小化 / 最大化 / 关闭按钮需由前端自绘（通过 window.freedom.window.* 控制），
-	// 三平台行为一致。
+	// 标题栏与系统原生最小化 / 最大化 / 关闭按钮均不存在，
+	// 需由前端自绘（通过 window.freedom.window.* 控制），三平台行为一致。
 	TitleBarFrameless TitleBarMode = "frameless"
 )
 
@@ -125,7 +122,10 @@ func (a *App) Unbind(name string) {
 func (a *App) Run() {
 	// 通用壳：先加载 exe 同目录 resources/config.json 覆盖窗口与后端配置
 	//（CLI build 时写入；缺失则使用编译期/默认配置）。
-	_ = a.loadRuntimeConfig()
+	// 配置存在但非法时打印告警（不中断启动），避免用户手改配置出错时静默无感。
+	if err := a.loadRuntimeConfig(); err != nil {
+		fmt.Printf("freedom: warning: %v\n", err)
+	}
 
 	html, err := a.resolveHTML()
 	if err != nil {
@@ -162,6 +162,7 @@ func (a *App) Run() {
 	}
 	a.applyCenter()
 	a.applyTitleBar()
+	a.setWindowIcon()
 
 	// 注入前端 SDK：window.freedom 全局对象。
 	w.Init(jsSDK)
@@ -195,7 +196,15 @@ func (a *App) Run() {
 // bridge 是前端调用后端的统一入口（JSON-RPC 风格）。
 // 前端 SDK 通过 window.__freedom_bridge(method, paramsJson) 调用，
 // 桥接层把请求转发给当前绑定的后端（内嵌 Go 方法或任意语言进程）。
-func (a *App) bridge(method string, paramsJSON string) (json.RawMessage, error) {
+func (a *App) bridge(method string, paramsJSON string) (result json.RawMessage, err error) {
+	// 防御后端方法 panic 导致整个窗口崩溃：统一转为错误回传前端。
+	defer func() {
+		if r := recover(); r != nil {
+			result = nil
+			err = fmt.Errorf("freedom: method %q panicked: %v", method, r)
+		}
+	}()
+
 	var params []json.RawMessage
 	if len(paramsJSON) > 0 && paramsJSON != "null" {
 		if err := json.Unmarshal([]byte(paramsJSON), &params); err != nil {
@@ -203,11 +212,18 @@ func (a *App) bridge(method string, paramsJSON string) (json.RawMessage, error)
 		}
 	}
 
-	result, err := a.backend.Handle(method, params)
+	// 框架内置方法特判：__freedom__ping 由 webview Bind 注册为全局函数
+	// window.__freedom__ping()，同时兼容经 freedom.call()/__freedom_bridge 路由的旧写法，
+	// 避免模板"测试桥接"自检报"method not bound"。
+	if method == "__freedom__ping" {
+		return json.RawMessage(`"pong"`), nil
+	}
+
+	raw, err := a.backend.Handle(method, params)
 	if err != nil {
 		return nil, err
 	}
-	data, err := json.Marshal(result)
+	data, err := json.Marshal(raw)
 	if err != nil {
 		return nil, fmt.Errorf("freedom: method %q: cannot marshal result: %w", method, err)
 	}
@@ -251,7 +267,7 @@ func (a *App) WindowHandle() uintptr {
 // windowControl 处理前端 window.freedom.window.* 的窗口控制请求。
 // 具体实现按平台分文件：window_windows.go（Windows）/ window_other.go（macOS、Linux）。
 func (a *App) windowControl(action string) (interface{}, error) {
-	return windowControl(a.WindowHandle(), action, a.cfg.TitleBar)
+	return windowControl(a, action)
 }
 
 // resolveHTML 依据配置返回页面内容。

package/templates/go/pkg/freedom/window_other.go

@@ -2,24 +2,76 @@
 
 package freedom
 
-import "fmt"
+import (
+	"fmt"
 
-// applyTitleBar 在 macOS / Linux 上为空实现：
-// 原生标题栏由窗口管理器接管，hidden / frameless 模式暂回退为原生标题栏，
-// 前端仍可通过 window.freedom.window.isFrameless() 感知当前是否无边框。
-func (a *App) applyTitleBar() {}
+	webview "github.com/webview/webview_go"
+)
 
-// windowControl 处理前端 window.freedom.window.* 请求（macOS / Linux 占位实现）。
-func windowControl(hwnd uintptr, action string, mode TitleBarMode) (interface{}, error) {
+// applyTitleBar 在 macOS / Linux 上通过 webview 层的 set_decorated 控制原生标题栏：
+//   - frameless：GTK 走 gtk_window_set_decorated(FALSE)，Cocoa 走隐藏标题栏 + 透明标题栏
+//     + 移除原生最小化/关闭按钮，彻底去除"UI 上方残留原生标题栏"问题；
+//   - native：恢复系统原生标题栏。
+//
+// 窗口在 webview.New() 时已创建，故此处可安全调用（须在 UI 线程，即 Run 流程内）。
+func (a *App) applyTitleBar() {
+	if a.view == nil {
+		return
+	}
+	a.view.SetDecorated(a.cfg.TitleBar != TitleBarFrameless)
+}
+
+// setWindowIcon 在 macOS / Linux 上为空实现（图标由应用包 / 窗口管理器决定）。
+func (a *App) setWindowIcon() {}
+
+// windowControl 处理前端 window.freedom.window.* 请求（macOS / Linux 实现）。
+//
+// 窗口控制类动作（最小化/最大化/还原/关闭/查询）直接转发到 webview 层的原生
+// 窗口控制（GTK GtkWindow / Cocoa NSWindow），前端自绘标题栏三按钮因此可用：
+//   - GTK: gtk_window_iconify / maximize / unmaximize / close / is_maximized
+//   - Cocoa: performMiniaturize: / zoom: / performClose: / isZoomed
+//
+// 注意：webview 层窗口控制动作在 UI 线程执行（前端桥接本身运行于 UI 线程回调中，
+// webview_go 的 binding 回调在主线程派发），无需额外 Dispatch。
+func windowControl(a *App, action string) (interface{}, error) {
+	if a.view == nil {
+		return nil, fmt.Errorf("window not ready")
+	}
+	var act webview.WindowAction
 	switch action {
-	case "isFrameless":
-		return mode == TitleBarFrameless || mode == TitleBarHidden, nil
+	case "minimize":
+		act = webview.WindowMinimize
+	case "maximize":
+		act = webview.WindowMaximize
+	case "unmaximize", "restore":
+		act = webview.WindowRestore
+	case "toggleMaximize":
+		act = webview.WindowToggleMaximize
+	case "close":
+		act = webview.WindowClose
 	case "isMaximized":
-		return false, nil
-	case "minimize", "maximize", "unmaximize", "restore", "toggleMaximize", "close":
-		// 非 Windows 平台暂不提供底层窗口控制，前端自绘按钮可对事件静默处理
+		act = webview.WindowIsMaximized
+	case "isFrameless":
+		return a.cfg.TitleBar == TitleBarFrameless, nil
+	case "appIcon":
+		// macOS / Linux 暂不提供 exe 内嵌图标提取，前端隐藏标题栏图标。
+		return "", nil
+	case "startDrag":
+		// 无边框窗口拖动：GTK 走 gtk_window_begin_move_drag（root_x/y=-1 用当前指针），
+		// Cocoa 走 performWindowDragWithEvent:（用当前鼠标位置合成事件）。
+		// 与 Windows 的 WM_NCLBUTTONDOWN+HTCAPTION 语义等价，保留页面双击/右键事件。
+		if a.view.BeginMoveDrag() != 0 {
+			return nil, fmt.Errorf("window drag is not supported on this platform")
+		}
 		return nil, nil
 	default:
 		return nil, fmt.Errorf("unknown window action %q", action)
 	}
+	if act == webview.WindowIsMaximized {
+		return a.view.WindowControl(act) == 1, nil
+	}
+	if r := a.view.WindowControl(act); r != 0 {
+		return nil, fmt.Errorf("window action %q is not supported on this platform", action)
+	}
+	return nil, nil
 }

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

@@ -3,9 +3,16 @@
 package freedom
 
 import (
+	"bytes"
+	"encoding/base64"
+	"encoding/binary"
 	"fmt"
+	"image"
+	"image/color"
+	"image/png"
 	"syscall"
-	"unsafe"
+
+	"golang.org/x/sys/windows"
 )
 
 // 进程级 DPI 感知：让窗口坐标 / WebView 渲染统一按物理像素工作。
@@ -27,6 +34,7 @@ func init() {
 
 var (
 	user32win = syscall.NewLazyDLL("user32.dll")
+	kernel32  = syscall.NewLazyDLL("kernel32.dll")
 
 	procGetWindowLongPtr = user32win.NewProc("GetWindowLongPtrW")
 	procSetWindowLongPtr = user32win.NewProc("SetWindowLongPtrW")
@@ -35,22 +43,41 @@ var (
 	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")
+	procMonitorFromWindow = user32win.NewProc("MonitorFromWindow")
+	procGetMonitorInfo   = user32win.NewProc("GetMonitorInfoW")
+	procMoveWindow       = user32win.NewProc("MoveWindow")
+
+	procDestroyIcon = user32win.NewProc("DestroyIcon")
 
 	dwmapi                     = syscall.NewLazyDLL("dwmapi.dll")
 	procDwmExtendFrameIntoArea = dwmapi.NewProc("DwmExtendFrameIntoClientArea")
 )
 
 const (
-	wsCaption   = 0x00C00000 // WS_CAPTION = WS_BORDER | WS_DLGFRAME
-	wsSysMenu   = 0x00080000
+	wsCaption    = 0x00C00000 // WS_CAPTION = WS_BORDER | WS_DLGFRAME
+	wsSysMenu    = 0x00080000
 	wsThickFrame = 0x00040000
 
-	wmClose     = 0x0010 // WM_CLOSE：请求窗口正常关闭（触发 GoWnd 的关闭回调）
-	swHide      = 0
-	swShow      = 5
-	swMinimize  = 6
-	swRestore   = 9
-	swMaximize  = 3
+	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
@@ -82,7 +109,8 @@ func refreshFrame(hwnd uintptr) {
 }
 
 // windowControl 处理前端 window.freedom.window.* 请求（Windows 实现）。
-func windowControl(hwnd uintptr, action string, mode TitleBarMode) (interface{}, error) {
+func windowControl(a *App, action string) (interface{}, error) {
+	hwnd := a.WindowHandle()
 	if hwnd == 0 {
 		return nil, fmt.Errorf("window not ready")
 	}
@@ -91,16 +119,16 @@ func windowControl(hwnd uintptr, action string, mode TitleBarMode) (interface{},
 		procShowWindow.Call(hwnd, swMinimize)
 		return nil, nil
 	case "maximize":
-		procShowWindow.Call(hwnd, swMaximize)
+		maximizeWindow(hwnd)
 		return nil, nil
 	case "unmaximize", "restore":
-		procShowWindow.Call(hwnd, swRestore)
+		restoreWindow(hwnd)
 		return nil, nil
 	case "toggleMaximize":
-		if isZoomed(hwnd) {
-			procShowWindow.Call(hwnd, swRestore)
+		if isWindowMaximized(hwnd) {
+			restoreWindow(hwnd)
 		} else {
-			procShowWindow.Call(hwnd, swMaximize)
+			maximizeWindow(hwnd)
 		}
 		return nil, nil
 	case "close":
@@ -109,14 +137,101 @@ func windowControl(hwnd uintptr, action string, mode TitleBarMode) (interface{},
 		procPostMessage.Call(hwnd, wmClose, 0, 0)
 		return nil, nil
 	case "isMaximized":
-		return isZoomed(hwnd), nil
+		return isWindowMaximized(hwnd), nil
 	case "isFrameless":
-		return mode == TitleBarFrameless || mode == TitleBarHidden, nil
+		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)
+		return nil, nil
 	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)
+}
+
+// restoreWindow 还原窗口（系统 SW_RESTORE，恢复到最大化前的位置与尺寸）。
+func restoreWindow(hwnd uintptr) {
+	procShowWindow.Call(hwnd, swRestore)
+}
+
+// isWindowMaximized 判断窗口当前是否处于最大化状态。
+func isWindowMaximized(hwnd uintptr) bool {
+	return isZoomed(hwnd)
+}
+
+// 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
+	}
+	// FindResourceW(hModule, MAKEINTRESOURCE(1), MAKEINTRESOURCE(RT_ICON))
+	resInfo, err := windows.FindResource(hInst, windows.ResourceID(1), windows.ResourceID(rtIcon))
+	if err != nil {
+		return nil
+	}
+	data, err := windows.LoadResourceData(hInst, resInfo)
+	if err != nil {
+		return nil
+	}
+	return data
+}
+
+// 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'
+}
+
+// loadExeIcon 从 exe 内嵌的 RT_GROUP_ICON 资源加载 HICON。
+// rcedit 注入的 group icon 资源 ID 固定为 0（LoadImageW 需按该 ID 加载；
+// 历史按 ID=1 硬编码导致加载失败，故此处显式用 0）。
+// 调用方用完须 procDestroyIcon 释放；加载失败返回 0。
+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)
+}
+
 func isZoomed(hwnd uintptr) bool {
 	r, _, _ := procIsZoomed.Call(hwnd)
 	return r != 0
@@ -130,21 +245,121 @@ func (a *App) applyTitleBar() {
 	}
 	switch a.cfg.TitleBar {
 	case TitleBarFrameless:
-		// 完全无边框：去掉标题栏 / 系统菜单，客户区铺满整个窗口。
-		// 最小化 / 最大化 / 关闭按钮由前端自绘（window.freedom.window.*）。
+		// 完全无边框：去掉标题栏 / 系统菜单 / 可调边框（WS_THICKFRAME）。
+		// - 标题栏与系统原生最小化 / 最大化 / 关闭按钮均不存在，由前端自绘
+		//   （window.freedom.window.*）接管；
+		// - 去掉 WS_THICKFRAME 是最大化行为正确的关键：只要该位存在，系统在
+		//   WM_GETMINMAXINFO 之后仍会按 AdjustWindowRectEx 追加标题栏 + 边框空间，
+		//   导致最大化窗口溢出工作区、盖住任务栏（F11 全屏感）；
+		// - 边缘拖拽 resize 由壳层 WndProc 的 WM_NCHITTEST 手动实现（返回 HT* 边界值），
+		//   不依赖 WS_THICKFRAME。
 		style := getWindowStyle(hwnd)
-		style &^= wsCaption | wsSysMenu
+		style &^= wsCaption | wsSysMenu | wsThickFrame
 		setWindowStyle(hwnd, style)
 		refreshFrame(hwnd)
-	case TitleBarHidden:
-		// 隐藏标题栏视觉但保留系统原生按钮：DWM 玻璃扩展。
-		// 标题栏区域透明化并并入客户区，右上角的最小化 / 最大化 / 关闭按钮
-		// 由 DWM 继续原生绘制，标题文字置空。
-		m := margins{cxLeftWidth: 0, cxRightWidth: 0, cyTopHeight: 0, cyBottomHeight: 1}
-		procDwmExtendFrameIntoArea.Call(hwnd, uintptr(unsafe.Pointer(&m)))
-		// 标题文字一并清除，标题栏区域只保留系统按钮
-		procSetWindowText.Call(hwnd, uintptr(unsafe.Pointer(syscall.StringToUTF16Ptr(""))))
+	default: // TitleBarNative：补齐系统原生标题栏与可调边框。
+		// webview_go 底层创建的窗口默认 style 不含 WS_CAPTION（见 WebView2 窗口创建），
+		// 因此 native 模式必须显式补回标题栏 / 系统菜单 / 可调边框，
+		// 否则窗口会表现为无边框（无原生三按钮、不可拖拽调整大小）。
+		style := getWindowStyle(hwnd)
+		style |= wsCaption | wsSysMenu | wsThickFrame
+		setWindowStyle(hwnd, style)
 		refreshFrame(hwnd)
-	default: // TitleBarNative：不处理
 	}
 }
+
+// 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})
+		}
+	}
+	var buf bytes.Buffer
+	if err := png.Encode(&buf, img); err != nil {
+		return nil, err
+	}
+	return buf.Bytes(), nil
+}

package/templates/go/webview_go/.github/workflows/ci.yaml

@@ -0,0 +1,62 @@
+name: CI Pipeline
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ${{ matrix.image }}
+    strategy:
+      fail-fast: false
+      matrix:
+        # Go 1.23 was the latest version as of 2024-08-31 but the action output a "warning":
+        # Failed to restore: "/usr/bin/tar" failed with error: The process '/usr/bin/tar' failed with exit code 2
+        # Go 1.22 didn't output the above "warning" so we're using this version.
+        # Go 1.14 made -mod=vendor default.
+        # Go 1.13 is the version set in go.mod.
+        include:
+          - { image: macos-14,     go: '1.22' }
+          - { image: macos-14,     go: '1.21' }
+          - { image: macos-14,     go: '1.20' }
+          # Go 1.19 is the earliest version available for ARM64.
+          - { image: macos-14,     go: '1.19' }
+          # macos-12 runner has x86_64 support which is needed for old versions of Go
+          - { image: macos-12,     go: '1.18' }
+          - { image: macos-12,     go: '1.17' }
+          - { image: macos-12,     go: '1.16' }
+          - { image: macos-12,     go: '1.15' }
+          - { image: macos-12,     go: '1.14' }
+          - { image: macos-12,     go: '1.13' }
+          - { image: ubuntu-22.04, go: '1.22', apt: libgtk-4-dev libwebkitgtk-6.0-dev }
+          - { image: ubuntu-22.04, go: '1.22', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.22', apt: libgtk-3-dev libwebkit2gtk-4.0-dev }
+          - { image: ubuntu-22.04, go: '1.21', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.20', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.19', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.18', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.17', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.16', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.15', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.14', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: ubuntu-22.04, go: '1.13', apt: libgtk-3-dev libwebkit2gtk-4.1-dev }
+          - { image: windows-2022, go: '1.22' }
+          - { image: windows-2022, go: '1.21' }
+          # Go 1.20 is the earliest version that is usable in this environment as of 2024-08-31.
+          # Compilation fails with older versions:
+          # [...]/bin/ld.exe: [...]\go-link-3209855222\000008.o: in function `x_cgo_thread_start':
+          # \\_\_\runtime\cgo/gcc_util.c:18: undefined reference to `__imp___iob_func'
+          - { image: windows-2022, go: '1.20' }
+    name: Build (${{ matrix.image }}, go ${{ matrix.go }})
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install dependencies
+        if: runner.os == 'Linux'
+        run: sudo apt-get update && sudo apt-get install -y libwebkit2gtk-4.0-dev
+      - uses: actions/setup-go@v5
+        with:
+          go-version: ${{ matrix.go }}
+      - name: Build examples
+        run: >
+          go build
+          ./examples/basic
+          ./examples/bind
+      - name: Run tests
+        run: go test

package/templates/go/webview_go/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+### Migrating from v0.1.1 to v0.10.0
+
+1. `Webview.Open()` has been removed. Use other webview APIs to create a window, open a link and run main UI loop.
+2. `Webview.Debug()` and `webview.Debugf()` have been removed. Use your favorite logging library to debug webview apps.
+3. `Webview.Settings` struct has been removed. Title, URL and size are controlled via other API setters and can be updated at any time, not only when webview is created.
+4. `Webview.Loop()` has been removed. Use `Run()` instead.
+5. `WebView.Run()`, `WebView.Terminate()`, `WebView.SetTitle()`, `WebView.Dispatch()` stayed the same.
+6. `WebView.Exit()` has been renamed to `WebView.Destroy()`
+7. `WebView.SetColor()` and `WebView.SetFullScreen()` have been removed. Use `Window()` to get native window handle and probably write some Cgo code to adjust native window to your taste.
+8. `Webview.Dialog` has been removed. But it is likely to be brought back as a standalone module.
+9. `WebView.Eval()` remained the same.
+10. `WebView.InjectCSS()` has been removed. Use eval to inject style tag with CSS inside.
+11. `WebView.Bind()` kept the name, but changed the semantics. Only functions can be bound. Not the structs, like in Lorca.