@yufengtadian/freedom-cli 1.12.17 → 1.12.18

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

@@ -46,30 +46,48 @@ func (a *App) applyCenter() {
 		mi.cbSize = uint32(unsafe.Sizeof(mi))
 		if r1, _, _ := procGetMonitorInfo.Call(mon, uintptr(unsafe.Pointer(&mi))); r1 != 0 {
 			work := mi.rcWork
-			sw := work.right - work.left
-			sh := work.bottom - work.top
-			x := work.left + (sw-int32(a.cfg.Width))/2
-			y := work.top + (sh-int32(a.cfg.Height))/2
-			if x < 0 {
-				x = 0
-			}
-			if y < 0 {
-				y = 0
-			}
+			sw := int(work.right - work.left)
+			sh := int(work.bottom - work.top)
+			// M5：窗口居中坐标双向 clamp。逻辑抽到 clampCentered 便于无头单测。
+			x, y := clampCentered(a.cfg.Width, a.cfg.Height, int(work.left), int(work.top), sw, sh)
 			procMoveWindow.Call(hwnd, uintptr(x), uintptr(y), uintptr(a.cfg.Width), uintptr(a.cfg.Height), 1)
 			return
 		}
 	}
-	// 回退：主屏全屏尺寸居中（原实现）
+	// 回退：主屏全屏尺寸居中（M5 同双向 clamp，上界不小于下界 0）
 	sw, _, _ := procGetSystemMetrics.Call(smCxScreen)
 	sh, _, _ := procGetSystemMetrics.Call(smCyScreen)
-	x := int(sw/2) - a.cfg.Width/2
-	y := int(sh/2) - a.cfg.Height/2
-	if x < 0 {
-		x = 0
+	// 主屏全屏居中：等价于左上 (0,0) 的工作区，同走 clampCentered 双向 clamp。
+	x, y := clampCentered(a.cfg.Width, a.cfg.Height, 0, 0, int(sw), int(sh))
+	procMoveWindow.Call(hwnd, uintptr(x), uintptr(y), uintptr(a.cfg.Width), uintptr(a.cfg.Height), 1)
+}
+
+// clampCentered 计算窗口在其所在工作区内的居中左上角坐标，并做双向 clamp：
+// 窗口小于工作区时严格居中；窗口大于工作区时贴左上缘，保证窗口整体落在
+// 工作区内、可被拖拽恢复（M5——此前只 clamp 下界，窗口超屏时上界 work.right-w
+// 越过下界 work.left，上下界互打架会把坐标钳回负值；现上界不小于下界）。
+func clampCentered(winW, winH, left, top, workW, workH int) (int, int) {
+	x := left + (workW-winW)/2
+	y := top + (workH-winH)/2
+	upperX := left + workW - winW
+	if upperX < left {
+		upperX = left
 	}
-	if y < 0 {
-		y = 0
+	upperY := top + workH - winH
+	if upperY < top {
+		upperY = top
 	}
-	procMoveWindow.Call(hwnd, uintptr(x), uintptr(y), uintptr(a.cfg.Width), uintptr(a.cfg.Height), 1)
+	if x < left {
+		x = left
+	}
+	if x > upperX {
+		x = upperX
+	}
+	if y < top {
+		y = top
+	}
+	if y > upperY {
+		y = upperY
+	}
+	return x, y
 }

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

@@ -0,0 +1,32 @@
+//go:build windows
+
+package freedom
+
+import "testing"
+
+// TestClampCentered 覆盖 M5 双向 clamp 的所有分支：
+// 小窗严格居中 / 超屏贴左上（上下界互打架）/ 副屏负坐标 / 右缘与下缘不越界。
+func TestClampCentered(t *testing.T) {
+	cases := []struct {
+		name                         string
+		winW, winH, left, top        int
+		workW, workH, wantX, wantY   int
+	}{
+		{"主屏小窗严格居中", 240, 180, 0, 0, 1920, 1040, 840, 430},
+		{"主屏超屏贴左上角", 3000, 2000, 0, 0, 1920, 1040, 0, 0},
+		{"副屏负坐标居中", 800, 600, -1920, 0, 1920, 1080, -1360, 240},
+		{"右缘不越界", 1900, 1000, 0, 0, 1920, 1080, 10, 40},
+		{"窗口恰等于工作区", 1920, 1040, 0, 0, 1920, 1040, 0, 0},
+		{"副屏超屏上界回贴左上", 3000, 2000, -1920, 0, 1920, 1040, -1920, 0},
+		{"高度触下缘", 200, 1040, 0, 0, 1920, 1040, 860, 0},
+	}
+	for _, c := range cases {
+		t.Run(c.name, func(t *testing.T) {
+			x, y := clampCentered(c.winW, c.winH, c.left, c.top, c.workW, c.workH)
+			if x != c.wantX || y != c.wantY {
+				t.Fatalf("clampCentered(%d,%d,%d,%d,%d,%d) = (%d,%d), want (%d,%d)",
+					c.winW, c.winH, c.left, c.top, c.workW, c.workH, x, y, c.wantX, c.wantY)
+			}
+		})
+	}
+}

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

@@ -18,13 +18,28 @@ import (
 	"path/filepath"
 )
 
+// secureFatalError 表示 high 安全模式下资源加载/校验失败（app.bin 存在但读取、
+// 解密或完整性校验不通过）。此类错误必须"拒绝运行"（不显示窗口、不回退占位页），
+// 防止资源被篡改/替换/密钥不匹配后静默降级运行（H2）。
+type secureFatalError struct{ err error }
+
+func (e *secureFatalError) Error() string { return e.err.Error() }
+func (e *secureFatalError) Unwrap() error { return e.err }
+
+// secureFatal 将 loadSecureResources 的错误包装为安全致命错误。
+// loadSecureResources 已区分：app.bin 不存在时返回 hit=false（非 high 产物），
+// 其余错误均为"存在但读取/解密/校验失败"，正是需要拒绝运行的场景。
+func secureFatal(err error) error {
+	return &secureFatalError{err: err}
+}
+
 // loadRuntimeConfig 读取 exe 同目录 resources/config.json，将命中的字段覆盖到应用配置。
 // 文件不存在时视为未配置（返回 nil，保持编译期/默认配置不变）；
 // 文件存在但读取/解析失败时返回具体错误，由调用方打印告警，避免用户手改配置出错时无感知。
 func (a *App) loadRuntimeConfig() error {
 	// high 安全模式：配置与页面封装在加密容器 app.bin 内，优先内存解密加载。
 	if p, hit, err := loadSecureResources(); err != nil {
-		return err
+		return secureFatal(err)
 	} else if hit {
 		var rc runtimeConfigFile
 		if err := json.Unmarshal([]byte(p.Config), &rc); err != nil {
@@ -95,6 +110,12 @@ func (a *App) loadRuntimeConfigPlain() error {
 
 // applyRuntimeConfig 把解析后的运行时配置覆盖到应用配置（明文与加密路径共用）。
 func (a *App) applyRuntimeConfig(rc *runtimeConfigFile) error {
+	// 窗口标题：config.json 的 title 覆盖编译期默认（"Freedom App"）。
+	// 此前只解析未应用，导致改 freedom.config.js 的 name/title 无效、
+	// 打包产物窗口标题永远停留在默认值（"无法修改程序名字"）。
+	if rc.Title != "" {
+		a.cfg.Title = rc.Title
+	}
 	switch rc.TitleBar {
 	case "native":
 		a.cfg.TitleBar = TitleBarNative
@@ -138,7 +159,7 @@ func (a *App) applyRuntimeConfig(rc *runtimeConfigFile) error {
 // 否则读取 exe 同目录 resources/index.html）。文件不存在时返回空串。
 func loadRuntimeHTML() (string, error) {
 	if p, hit, err := loadSecureResources(); err != nil {
-		return "", err
+		return "", secureFatal(err)
 	} else if hit {
 		return p.HTML, nil
 	}

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

@@ -19,6 +19,7 @@ package freedom
 
 import (
 	"encoding/json"
+	"errors"
 	"fmt"
 	"sync"
 	"unsafe"
@@ -30,9 +31,10 @@ import (
 type TitleBarMode string
 
 const (
-	// TitleBarNative 保留系统原生标题栏（默认），标题栏图标与 exe 图标一致。
+	// TitleBarNative 保留系统原生标题栏，标题栏图标与 exe 图标一致。
 	TitleBarNative TitleBarMode = "native"
 	// TitleBarFrameless 完全无边框，客户区铺满整个窗口。
+	// 为框架默认策略（与 CLI 默认一致，见 M1）。
 	// 标题栏与系统原生最小化 / 最大化 / 关闭按钮均不存在，
 	// 需由前端自绘（通过 window.freedom.window.* 控制），三平台行为一致。
 	TitleBarFrameless TitleBarMode = "frameless"
@@ -42,7 +44,7 @@ const (
 type Config struct {
 	// Title 是窗口标题。
 	Title string
-	// TitleBar 指定标题栏策略（默认 TitleBarNative）。可通过 freedom CLI 一键切换。
+	// TitleBar 指定标题栏策略（默认 TitleBarFrameless，与 CLI 默认一致）。可通过 freedom CLI 一键切换。
 	TitleBar TitleBarMode
 	// Width / Height 是窗口初始尺寸（像素）。
 	Width  int
@@ -77,8 +79,11 @@ func New(cfg Config) *App {
 	if cfg.Title == "" {
 		cfg.Title = "Freedom App"
 	}
+	// M1：Go 侧默认与 CLI 默认（freedom.config.js / build.js 均默认 frameless）统一，
+	// 避免 resources/config.json 缺失时 Go 走 native 而模板前端自绘标题栏，
+	// 造成双标题栏错位。
 	if cfg.TitleBar == "" {
-		cfg.TitleBar = TitleBarNative
+		cfg.TitleBar = TitleBarFrameless
 	}
 	if cfg.Width <= 0 {
 		cfg.Width = 1024
@@ -149,6 +154,13 @@ func (a *App) Run() {
 	//（CLI build 时写入；缺失则使用编译期/默认配置）。
 	// 配置存在但非法时打印告警（不中断启动），避免用户手改配置出错时静默无感。
 	if err := a.loadRuntimeConfig(); err != nil {
+		// H2：high 安全模式资源解密/完整性校验失败必须"拒绝运行"——
+		// 不显示窗口、不回退占位页，防止资源被篡改/替换后静默降级运行。
+		var se *secureFatalError
+		if errors.As(err, &se) {
+			fmt.Printf("freedom: 安全模式资源校验失败，拒绝运行：%v\n", err)
+			return
+		}
 		fmt.Printf("freedom: warning: %v\n", err)
 	}
 
@@ -224,11 +236,38 @@ func (a *App) Run() {
 		fmt.Printf("freedom: failed to bind window control: %v\n", err)
 		return
 	}
-
-	if a.onReady != nil {
-		a.onReady(a)
+	// 框架内置方法：原生系统能力（wails v3 对标层）。
+	// 支持方法：taskbar.*（进度/状态/角标）、window.backdrop/corner/borderColor、
+	// dialog.message/open/save。平台实现分文件：syscap_windows.go / syscap_other.go。
+	if err := w.Bind("__freedom_sys", a.sysCapCall); err != nil {
+		fmt.Printf("freedom: failed to bind sys capability: %v\n", err)
+		return
+	}
+	// 框架内置方法：系统托盘与原生菜单栏。
+	// 支持方法：tray.create/destroy/tooltip/menu、menu.set。
+	// 平台实现分文件：tray_windows.go / tray_other.go。
+	if err := w.Bind("__freedom_tray", a.trayCall); err != nil {
+		fmt.Printf("freedom: failed to bind tray: %v\n", err)
+		return
+	}
+	// 框架内置方法：页面就绪回调（H3）。前端 SDK 在 DOMContentLoaded 后调用，
+	// 保证 onReady 触发时页面已加载、监听器已注册；此前 onReady 在 SetHtml 前
+	// 触发，期间 Emit 的初始化事件因 window.freedom 尚未建立而丢失。
+	// 页面可能因导航/重载多次触发 DOMContentLoaded，用 once 兜底只执行一次。
+	var readyOnce sync.Once
+	if err := w.Bind("__freedom__ready", func() {
+		readyOnce.Do(func() {
+			if a.onReady != nil {
+				a.onReady(a)
+			}
+		})
+	}); err != nil {
+		fmt.Printf("freedom: failed to bind ready: %v\n", err)
+		return
 	}
 
+	// 注：onReady 不再在 SetHtml 前触发（H3），改由前端 SDK 在页面
+	// DOMContentLoaded 后经 __freedom__ready 回调，保证初始化事件不丢失。
 	w.SetHtml(html)
 	w.Run()
 }
@@ -307,16 +346,33 @@ 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) {
+func (a *App) windowControl(action string) (result interface{}, err error) {
+	// H1：windowControl 直接经 w.Bind 暴露给前端，不经 bridge 的 recover 兜底；
+	// 平台实现（如 appIcon → dibToPNG 解析越界）一旦 panic 会直接崩掉整个壳进程。
+	// 这里统一加 recover，把 panic 转成错误回传前端（页面 catch 后提示，进程不崩）。
+	defer func() {
+		if r := recover(); r != nil {
+			result = nil
+			err = fmt.Errorf("freedom: window action %q panicked: %v", action, r)
+		}
+	}()
 	return windowControl(a, action)
 }
 
 // resolveHTML 依据配置返回页面内容。
 // 优先级：exe 同目录 resources/index.html（预编译通用壳，CLI build 写入）> cfg.HTML > 内置占位页。
 func (a *App) resolveHTML() (string, error) {
-	if html, err := loadRuntimeHTML(); err == nil && html != "" {
+	html, err := loadRuntimeHTML()
+	if err == nil && html != "" {
 		return html, nil
 	}
+	// H2 双保险：high 安全模式资源解密/完整性校验失败时禁止回退占位页（拒绝运行）。
+	// 正常路径下 Run 已在 loadRuntimeConfig 捕获 secureFatalError 并提前 return，
+	// 此处防御未来调用顺序调整导致的静默降级。
+	var se *secureFatalError
+	if errors.As(err, &se) {
+		return "", err
+	}
 	if a.cfg.HTML != nil {
 		return a.cfg.HTML()
 	}

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

@@ -0,0 +1,10 @@
+//go:build !windows
+
+package freedom
+
+import "fmt"
+
+// sysCapCall 非 Windows 平台暂不提供系统能力（任务栏/窗口效果/对话框）。
+func (a *App) sysCapCall(method string, paramsJSON string) (interface{}, error) {
+	return nil, fmt.Errorf("freedom: sys method %q is not supported on this platform", method)
+}