@yufengtadian/freedom-cli 1.12.14 → 1.12.15

package/README.md

@@ -1,9 +1,13 @@
 # freedom-cli
 
-Freedom 桌面壳打包工具：把你的 Web 前端一键打包成跨平台桌面应用（v1.12.14）。
+Freedom 桌面壳打包工具：把你的 Web 前端一键打包成跨平台桌面应用（v1.12.15）。
 
 基于自研 Freedom WebView 壳层（对标 Wails / Tauri）：前端完全自由、后端可任意语言、渲染复用系统 WebView（Windows WebView2 / macOS WKWebView / Linux WebKitGTK），产物为单个可执行文件 + resources 目录，前端页面内存加载，不占本地端口。
 
+**v1.12.15 补发壳生命周期稳定性修复**：v1.12.14 的 npm 上架时间早于修复提交，上架版预编译壳未包含悬垂指针修复（窗口操作 / 代理端口触发随机退出的根因）；本版正式把含 B50 修复的预编译壳随 npm 包分发——
+- 壳销毁生命周期修复：`webview.Destroy()` 后经 Emit / Quit / WindowHandle / binding 回调访问已释放 C 对象（悬垂指针）导致随机退出；新增 `destroyed` 原子标记，Dispatch / Eval / binding 回调销毁后一律跳过原生调用，`Run` 在 `Destroy` 前清空 `App.view`，事件与绑定回调加 `recover` 兜底；
+- 使用全局包构建的下游应用（如 DSH）升级到本版后，随机退出问题一并消除（可用二进制字符串指纹 `freedom: binding panic` 核对）。
+
 **v1.12.14 稳定性 / 兼容性 / 打包链路修复**：
 - **Go 壳层并发安全**：`Dispatch` 修复解锁后读共享 index 的数据竞争（消除 UI 事件丢失 / 偶发 panic）；`App.view` 增加互斥锁，`Emit / Quit / WindowHandle` 可在任意 goroutine 安全调用（后端事件推送不再与 Run 竞态）；
 - **多屏适配**：窗口居中改为按窗口所在监视器工作区（rcWork）居中，副屏 / 负坐标 / 任务栏遮挡下均正确；实现改用纯 syscall，不再依赖 `x/sys/windows` 新版 API（老版本 Go 亦可编译）；

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yufengtadian/freedom-cli",
-  "version": "1.12.14",
+  "version": "1.12.15",
   "description": "Freedom WebView desktop shell packaging tool - no Go toolchain required, one command packs three-platform desktop apps",
   "keywords": [
     "desktop",

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

@@ -231,7 +231,12 @@ func (p *ProcBackend) dispatchEvent(event string, dataJSON json.RawMessage) {
 	fn := p.onEvent
 	p.mu.Unlock()
 	if fn != nil {
-		fn(event, data)
+		// 事件回调在 readLoop goroutine 执行；内部若 panic（如推送期间窗口已销毁）
+		// 一旦外泄到 readLoop 会崩掉整个壳进程，此处统一兜底。
+		func() {
+			defer func() { _ = recover() }()
+			fn(event, data)
+		}()
 	}
 }
 

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

@@ -158,6 +158,10 @@ func (a *App) Run() {
 	a.setView(w)
 	defer func() {
 		_ = a.backend.Close()
+		// 先清空视图引用再销毁：Destroy 后 C 层 webview 对象已被 delete，
+		// 若此时仍有并发 goroutine（如后端事件推送触发的 Emit/Quit/WindowHandle）
+		// 持旧引用调用会访问悬垂指针导致随机崩溃。
+		a.setView(nil)
 		w.Destroy()
 	}()
 

package/templates/go/webview_go/webview.go

@@ -31,9 +31,11 @@ import (
 	_ "github.com/webview/webview_go/libs/webview/include"
 	"encoding/json"
 	"errors"
+	"fmt"
 	"reflect"
 	"runtime"
 	"sync"
+	"sync/atomic"
 	"unsafe"
 )
 
@@ -170,6 +172,11 @@ var (
 	dispatch  = map[uintptr]func(){}
 	bindings  = map[uintptr]func(id, req string) (interface{}, error){}
 	bindNames = map[string]uintptr{} // name -> index，供 Unbind 清理 bindings 条目
+	// destroyed 标记 C 层 webview 对象已被销毁。Destroy() 置位后：
+	//   - Dispatch / Eval 直接跳过 C 调用，避免向已释放的 webview_t 发消息（悬垂指针崩溃）；
+	//   - binding 回调跳过 C.webview_return，避免访问已释放的 C 内存。
+	// 壳为单窗口单 webview，全局单例标记即可。
+	destroyed atomic.Bool
 )
 
 func boolToInt(b bool) C.int {
@@ -196,6 +203,8 @@ func NewWindow(debug bool, window unsafe.Pointer) WebView {
 }
 
 func (w *webview) Destroy() {
+	// 先置销毁标记：销毁后任何并发 Dispatch/Eval/binding 回调不得再触碰 C 内存。
+	destroyed.Store(true)
 	C.webview_destroy(w.w)
 }
 
@@ -252,12 +261,18 @@ func (w *webview) Init(js string) {
 }
 
 func (w *webview) Eval(js string) {
+	if destroyed.Load() {
+		return
+	}
 	s := C.CString(js)
 	defer C.free(unsafe.Pointer(s))
 	C.webview_eval(w.w, s)
 }
 
 func (w *webview) Dispatch(f func()) {
+	if destroyed.Load() {
+		return
+	}
 	m.Lock()
 	for ; dispatch[index] != nil; index++ {
 	}
@@ -272,11 +287,15 @@ func (w *webview) Dispatch(f func()) {
 
 //export _webviewDispatchGoCallback
 func _webviewDispatchGoCallback(index unsafe.Pointer) {
+	// 兜底：回调内任何 panic 不得外泄到 C 层崩掉整个进程。
+	defer func() { _ = recover() }()
 	m.Lock()
 	f := dispatch[uintptr(index)]
 	delete(dispatch, uintptr(index))
 	m.Unlock()
-	f()
+	if f != nil {
+		f()
+	}
 }
 
 //export _webviewBindingGoCallback
@@ -286,15 +305,29 @@ func _webviewBindingGoCallback(w C.webview_t, id *C.char, req *C.char, index uin
 	m.Unlock()
 	jsString := func(v interface{}) string { b, _ := json.Marshal(v); return string(b) }
 	status, result := 0, ""
-	if res, err := f(C.GoString(id), C.GoString(req)); err != nil {
-		status = -1
-		result = jsString(err.Error())
-	} else if b, err := json.Marshal(res); err != nil {
-		status = -1
-		result = jsString(err.Error())
-	} else {
-		status = 0
-		result = string(b)
+	// 兜底：绑定回调内任何 panic 转为错误回传前端，绝不外泄到 C 层崩进程。
+	func() {
+		defer func() {
+			if r := recover(); r != nil {
+				status = -1
+				result = jsString(fmt.Sprintf("freedom: binding panic: %v", r))
+			}
+		}()
+		if res, err := f(C.GoString(id), C.GoString(req)); err != nil {
+			status = -1
+			result = jsString(err.Error())
+		} else if b, err := json.Marshal(res); err != nil {
+			status = -1
+			result = jsString(err.Error())
+		} else {
+			status = 0
+			result = string(b)
+		}
+	}()
+	// 窗口已销毁：C 层 webview 对象已被 delete，不能再调用 webview_return，
+	// 否则访问悬垂 webview_t 导致进程随机崩溃。
+	if destroyed.Load() {
+		return
 	}
 	s := C.CString(result)
 	defer C.free(unsafe.Pointer(s))