@yufengtadian/freedom-cli 1.12.15 → 1.12.17

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

@@ -0,0 +1,227 @@
+package freedom
+
+// security.go — 安全加固：high 模式资源加密与完整性校验。
+//
+// 与 lib/security.js 跨语言同步（改任一侧必须同步另一侧，否则无法解密）：
+//   - securityMasterKey / securityDeriveSalt / securityPbkdf2Iter / securityKeyLen
+//   - securityMagic / securityIVLen / securityTagLen（app.bin 容器头格式）
+//   - 派生算法：PBKDF2-HMAC-SHA256（RFC 2898），salt = "freedom:derive:v1:" + 应用标识
+//   - 应用标识 = exe 文件名去扩展名（CLI build 时的 name 与运行时 os.Executable() 一致）
+//
+// 加密算法说明：AES-256-CTR + HMAC-SHA256（Encrypt-then-MAC），
+// 与 Node crypto 的 aes-256-ctr + createHmac('sha256') 跨语言一致。
+// （不采用 GCM：在当前 Windows 环境的 Go 标准库 GCM/GHASH 存在确定性认证失败问题，
+//   经最小复现确认与缓存/CPU 指令无关；CTR+HMAC 语义等价且规避该问题。）
+//
+// high 模式产物布局（CLI build 写入，与明文模式互斥）：
+//   resources/app.bin     加密容器：magic(5B FRDM1)+iv(16B)+tag(16B)+ciphertext
+//                         解密载荷 JSON：{"html": <string>, "config": <string>}
+//   resources/.integrity  HMAC-SHA256 完整性清单（app.bin + backend/**）
+// 壳启动时在内存解密，磁盘无明文；exe 被重命名/资源被篡改 → 解密失败即拒绝运行。
+
+import (
+	"crypto/aes"
+	"crypto/cipher"
+	"crypto/hmac"
+	"crypto/sha256"
+	"encoding/binary"
+	"encoding/hex"
+	"encoding/json"
+	"errors"
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+)
+
+// ---- 与 lib/security.js 同步的派生与容器参数 ----
+const (
+	securityMasterKey  = "freedom-shell::kdf-master::v1::7f4e8c2a9b1d6e3f"
+	securityDeriveSalt = "freedom:derive:v1"
+	securityPbkdf2Iter = 60000
+	securityKeyLen     = 32
+	securityMagic      = "FRDM1"
+	securityIVLen      = 16 // AES-CTR 计数器长度 = AES 块大小
+	securityTagLen     = 16 // HMAC-SHA256 截断为 16 字节
+)
+
+// securePayload 是 app.bin 解密后的载荷（与 JS 侧加密载荷结构一致）。
+type securePayload struct {
+	HTML   string `json:"html"`
+	Config string `json:"config"`
+}
+
+// integrityFile 是 resources/.integrity 的磁盘结构（CLI build 生成）。
+type integrityFile struct {
+	V       int               `json:"v"`
+	AppBin  string            `json:"appBin"`
+	Backend map[string]string `json:"backend"`
+}
+
+// pbkdf2HMACSHA256 自实现 PBKDF2-HMAC-SHA256（RFC 2898），
+// 与 Node 的 crypto.pbkdf2Sync(password, salt, iter, keyLen, 'sha256') 结果一致。
+// 不引入 golang.org/x/crypto（go.mod 为 go 1.22，标准库未含 PBKDF2）。
+func pbkdf2HMACSHA256(password, salt []byte, iter, keyLen int) []byte {
+	hLen := sha256.Size
+	numBlocks := (keyLen + hLen - 1) / hLen
+	var dk []byte
+	for block := 1; block <= numBlocks; block++ {
+		mac := hmac.New(sha256.New, password)
+		mac.Write(salt)
+		var b [4]byte
+		binary.BigEndian.PutUint32(b[:], uint32(block))
+		mac.Write(b[:])
+		u := mac.Sum(nil)
+		t := make([]byte, len(u))
+		copy(t, u)
+		for i := 1; i < iter; i++ {
+			mac = hmac.New(sha256.New, password)
+			mac.Write(u)
+			u = mac.Sum(nil)
+			for j := range t {
+				t[j] ^= u[j]
+			}
+		}
+		dk = append(dk, t...)
+	}
+	return dk[:keyLen]
+}
+
+// appIdentityName 返回应用标识：exe 文件名去扩展名（.exe / .app）。
+func appIdentityName(name string) string {
+	s := strings.TrimSuffix(name, ".exe")
+	s = strings.TrimSuffix(s, ".app")
+	return s
+}
+
+// appIdentity 返回运行时应用标识（当前进程 exe 文件名去扩展名）。
+func appIdentity() (string, error) {
+	exe, err := os.Executable()
+	if err != nil {
+		return "", err
+	}
+	return appIdentityName(filepath.Base(exe)), nil
+}
+
+// deriveSecurityKey 派生 high 模式加密密钥（AES-256-CTR + HMAC-SHA256 共用同一 32B 密钥）。
+// salt 引入应用标识，使不同应用密钥不同；PBKDF2 迭代增加暴力破解成本。
+func deriveSecurityKey(appName string) []byte {
+	salt := []byte(securityDeriveSalt + ":" + appIdentityName(appName))
+	return pbkdf2HMACSHA256([]byte(securityMasterKey), salt, securityPbkdf2Iter, securityKeyLen)
+}
+
+// decryptAppBin 解密 resources/app.bin，返回载荷。
+// 先恒定时间校验 HMAC 认证标签（Encrypt-then-MAC），再 AES-256-CTR 解密。
+// 解密失败（exe 被重命名 / 资源被篡改 / 密钥不匹配）时返回错误。
+func decryptAppBin(appName string, data []byte) (*securePayload, error) {
+	if len(data) < len(securityMagic)+securityIVLen+securityTagLen {
+		return nil, errors.New("app.bin too short")
+	}
+	if string(data[:len(securityMagic)]) != securityMagic {
+		return nil, errors.New("app.bin bad magic")
+	}
+	off := len(securityMagic)
+	iv := data[off : off+securityIVLen]
+	off += securityIVLen
+	tag := data[off : off+securityTagLen]
+	off += securityTagLen
+	ct := data[off:]
+
+	key := deriveSecurityKey(appName)
+
+	// 1) 认证：HMAC-SHA256(ct) 前 16 字节，与容器头 tag 恒定时间比对。
+	mac := hmac.New(sha256.New, key)
+	mac.Write(ct)
+	if !hmac.Equal(tag, mac.Sum(nil)[:securityTagLen]) {
+		return nil, errors.New("app.bin 解密失败（exe 被重命名或资源被篡改？）：认证失败")
+	}
+
+	// 2) 解密：AES-256-CTR。
+	block, err := aes.NewCipher(key)
+	if err != nil {
+		return nil, err
+	}
+	stream := cipher.NewCTR(block, iv)
+	plain := make([]byte, len(ct))
+	stream.XORKeyStream(plain, ct)
+
+	var p securePayload
+	if err := json.Unmarshal(plain, &p); err != nil {
+		return nil, fmt.Errorf("app.bin 载荷无效：%w", err)
+	}
+	return &p, nil
+}
+
+// verifyIntegrity 校验 resources/.integrity 清单（存在时）。
+// 比对 app.bin 与 backend/** 各文件 HMAC-SHA256，防整体替换/篡改。
+// 无 .integrity 文件（CLI 旧版产物）时跳过，保持向后兼容。
+func verifyIntegrity(dir, appName string, appBin []byte) error {
+	raw, err := os.ReadFile(filepath.Join(dir, ".integrity"))
+	if err != nil {
+		if errors.Is(err, os.ErrNotExist) {
+			return nil
+		}
+		return err
+	}
+	var f integrityFile
+	if err := json.Unmarshal(raw, &f); err != nil {
+		return fmt.Errorf(".integrity 无效：%w", err)
+	}
+	key := deriveSecurityKey(appName)
+	if f.AppBin != "" {
+		mac := hmac.New(sha256.New, key)
+		mac.Write(appBin)
+		want, err := hex.DecodeString(f.AppBin)
+		if err != nil {
+			return fmt.Errorf(".integrity appBin 校验值非法：%w", err)
+		}
+		if !hmac.Equal(want, mac.Sum(nil)) {
+			return errors.New(".integrity 校验失败：resources/app.bin 被篡改")
+		}
+	}
+	for rel, wantHex := range f.Backend {
+		b, err := os.ReadFile(filepath.Join(dir, filepath.FromSlash(rel)))
+		if err != nil {
+			return fmt.Errorf(".integrity 校验失败：backend 文件缺失 %s：%w", rel, err)
+		}
+		mac := hmac.New(sha256.New, key)
+		mac.Write(b)
+		want, err := hex.DecodeString(wantHex)
+		if err != nil {
+			return fmt.Errorf(".integrity backend[%s] 校验值非法：%w", rel, err)
+		}
+		if !hmac.Equal(want, mac.Sum(nil)) {
+			return fmt.Errorf(".integrity 校验失败：backend 文件 %s 被篡改", rel)
+		}
+	}
+	return nil
+}
+
+// loadSecureResources 尝试加载 high 模式加密资源。
+// 返回 (载荷, 是否命中, 错误)：resources/app.bin 不存在时命中=false（非 high 产物），
+// 命中但解密/校验失败时返回错误（拒绝静默回退明文，避免降级攻击）。
+func loadSecureResources() (*securePayload, bool, error) {
+	dir, err := resourcesDir()
+	if err != nil {
+		return nil, false, err
+	}
+	data, err := os.ReadFile(filepath.Join(dir, "app.bin"))
+	if err != nil {
+		if errors.Is(err, os.ErrNotExist) {
+			return nil, false, nil
+		}
+		return nil, false, err
+	}
+	name, err := appIdentity()
+	if err != nil {
+		return nil, false, err
+	}
+	if err := verifyIntegrity(dir, name, data); err != nil {
+		return nil, false, err
+	}
+	p, err := decryptAppBin(name, data)
+	if err != nil {
+		return nil, false, err
+	}
+	return p, true, nil
+}

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

@@ -0,0 +1,153 @@
+package freedom
+
+import (
+	"bytes"
+	"crypto/aes"
+	"crypto/cipher"
+	"crypto/hmac"
+	"crypto/sha256"
+	"encoding/hex"
+	"os"
+	"path/filepath"
+	"testing"
+)
+
+// 跨语言一致性：deriveSecurityKey 的期望值由 Node crypto.pbkdf2Sync 生成
+// （见 lib/security.js 测试 / 开发时用 node -e 复算）。两侧必须一致，
+// 否则 CLI high 模式 build 的加密资源壳无法解密。
+var deriveExpect = map[string]string{
+	"demo":       "87186aa64360bdecb9d87f3bc78c20afabc04ff99abbf04b202d5ead7aea9484",
+	"myapp.exe":  "853b7b028120502eaefae453e05f36df7e4d2948e3d6766272a6965e0401675d",
+	"HelloApp":   "30255eaff0c089efdcb22736ae255a98f5a2bb8e3c00741440102811e1345f9a",
+	"HelloApp.app": "30255eaff0c089efdcb22736ae255a98f5a2bb8e3c00741440102811e1345f9a",
+}
+
+func TestDeriveKeyMatchesNode(t *testing.T) {
+	for name, wantHex := range deriveExpect {
+		got := hex.EncodeToString(deriveSecurityKey(name))
+		if got != wantHex {
+			t.Errorf("deriveSecurityKey(%q) = %s, want %s", name, got, wantHex)
+		}
+	}
+}
+
+func TestAppIdentityName(t *testing.T) {
+	cases := map[string]string{
+		"demo":         "demo",
+		"myapp.exe":    "myapp",
+		"HelloApp.app": "HelloApp",
+		// 与 lib/security.js appIdentityFor 正则语义一致：仅去除最后一个 .exe/.app 后缀
+		"app.exe.app": "app.exe",
+	}
+	for in, want := range cases {
+		if got := appIdentityName(in); got != want {
+			t.Errorf("appIdentityName(%q) = %q, want %q", in, got, want)
+		}
+	}
+}
+
+func TestPBKDF2RFCVector(t *testing.T) {
+	// RFC 6070 向量：PBKDF2-HMAC-SHA1("password", "salt", 1, 20)
+	// 我们实现的 PRF 是 SHA256，此处验证实现不 panic 且长度正确 + 与 SHA256 自我一致。
+	dk := pbkdf2HMACSHA256([]byte("password"), []byte("salt"), 4096, 32)
+	if len(dk) != 32 {
+		t.Fatalf("pbkdf2 len = %d, want 32", len(dk))
+	}
+	// 确定性：同参重复调用结果一致
+	dk2 := pbkdf2HMACSHA256([]byte("password"), []byte("salt"), 4096, 32)
+	if !bytes.Equal(dk, dk2) {
+		t.Fatal("pbkdf2 not deterministic")
+	}
+}
+
+func TestDecryptAppBinRoundtrip(t *testing.T) {
+	payload := []byte(`{"html":"<html>hello</html>","config":"{\"title\":\"demo\"}"}`)
+	name := "demo"
+	key := deriveSecurityKey(name)
+
+	// 用标准 AES-GCM 加密构造 app.bin（模拟 CLI build 产物）
+	data, err := encryptForTest(name, payload)
+	if err != nil {
+		t.Fatalf("encryptForTest: %v", err)
+	}
+	p, err := decryptAppBin(name, data)
+	if err != nil {
+		t.Fatalf("decryptAppBin: %v", err)
+	}
+	if p.HTML != "<html>hello</html>" || p.Config != "{\"title\":\"demo\"}" {
+		t.Fatalf("roundtrip mismatch: %+v", p)
+	}
+	_ = key
+
+	// 篡改测试：改动密文任一位 → 解密失败（HMAC 认证标签校验）
+	bad := append([]byte(nil), data...)
+	bad[len(bad)-1] ^= 0x01
+	if _, err := decryptAppBin(name, bad); err == nil {
+		t.Fatal("tampered ciphertext should fail")
+	}
+}
+
+func TestDecryptAppBinWrongName(t *testing.T) {
+	payload := []byte(`{"html":"x","config":"{}"}`)
+	data, err := encryptForTest("demo", payload)
+	if err != nil {
+		t.Fatalf("encryptForTest: %v", err)
+	}
+	// 用错误应用名（相当于 exe 被重命名）解密 → 必须失败
+	if _, err := decryptAppBin("other", data); err == nil {
+		t.Fatal("decrypt with wrong app name should fail")
+	}
+}
+
+func TestVerifyIntegrity(t *testing.T) {
+	dir := t.TempDir()
+	name := "demo"
+	appBin := []byte("FRDM1-fake-bin-content")
+	key := deriveSecurityKey(name)
+	mac := hmac.New(sha256.New, key)
+	mac.Write(appBin)
+	want := hex.EncodeToString(mac.Sum(nil))
+
+	// 正常：匹配
+	good := `{"v":1,"appBin":"` + want + `","backend":{}}`
+	if err := os.WriteFile(filepath.Join(dir, ".integrity"), []byte(good), 0o644); err != nil {
+		t.Fatal(err)
+	}
+	if err := verifyIntegrity(dir, name, appBin); err != nil {
+		t.Fatalf("verifyIntegrity should pass: %v", err)
+	}
+
+	// 篡改：app.bin 内容变化 → 校验失败
+	if err := verifyIntegrity(dir, name, append(appBin, 0x00)); err == nil {
+		t.Fatal("tampered appBin should fail integrity")
+	}
+
+	// 无 .integrity → 跳过（向后兼容）
+	dir2 := t.TempDir()
+	if err := verifyIntegrity(dir2, name, appBin); err != nil {
+		t.Fatalf("missing .integrity should pass: %v", err)
+	}
+}
+
+// ---- 测试辅助 ----
+
+// encryptForTest 用与 CLI lib/security.js 相同的容器格式加密载荷（供壳单测使用）。
+// 算法与正式流程一致：AES-256-CTR 加密 → HMAC-SHA256(密文) 截 16B 认证标签。
+func encryptForTest(name string, plain []byte) ([]byte, error) {
+	key := deriveSecurityKey(name)
+	block, err := aes.NewCipher(key)
+	if err != nil {
+		return nil, err
+	}
+	iv := make([]byte, securityIVLen) // 固定 iv 便于确定性（仅测试）
+	stream := cipher.NewCTR(block, iv)
+	ct := make([]byte, len(plain))
+	stream.XORKeyStream(ct, plain)
+	mac := hmac.New(sha256.New, key)
+	mac.Write(ct)
+	tag := mac.Sum(nil)[:securityTagLen]
+	out := append([]byte(securityMagic), iv...)
+	out = append(out, tag...)
+	out = append(out, ct...)
+	return out, nil
+}

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

@@ -24,6 +24,10 @@ func (a *App) applyTitleBar() {
 // setWindowIcon 在 macOS / Linux 上为空实现（图标由应用包 / 窗口管理器决定）。
 func (a *App) setWindowIcon() {}
 
+// webview2Available 非 Windows 平台恒返回 true（macOS WKWebView / Linux WebKitGTK，
+// 不依赖 WebView2 Runtime）。
+func webview2Available() bool { return true }
+
 // windowControl 处理前端 window.freedom.window.* 请求（macOS / Linux 实现）。
 //
 // 窗口控制类动作（最小化/最大化/还原/关闭/查询）直接转发到 webview 层的原生

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

@@ -13,6 +13,7 @@ import (
 	"syscall"
 
 	"golang.org/x/sys/windows"
+	"golang.org/x/sys/windows/registry"
 )
 
 // 进程级 DPI 感知：让窗口坐标 / WebView 渲染统一按物理像素工作。
@@ -232,6 +233,25 @@ func exeAppIconDataURL() string {
 	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
+	}
+	return false
+}
+
 func isZoomed(hwnd uintptr) bool {
 	r, _, _ := procIsZoomed.Call(hwnd)
 	return r != 0

package/templates/go/webview_go/webview.go

@@ -199,6 +199,13 @@ func New(debug bool) WebView { return NewWindow(debug, nil) }
 func NewWindow(debug bool, window unsafe.Pointer) WebView {
 	w := &webview{}
 	w.w = C.webview_create(boolToInt(debug), window)
+	// B55：webview_create 在目标平台 WebView 初始化失败时可能返回 NULL
+	//（如 Linux 缺 WebKitGTK、macOS WebKit 不可用），此时返回 nil 让调用方
+	//（freedom.go Run 的 w == nil 分支）走失败提示，而非持 nil webview_t
+	// 继续调用 SetTitle/SetSize/Init 等 C API 触发空指针崩溃。
+	if w.w == nil {
+		return nil
+	}
 	return w
 }
 
@@ -209,52 +216,85 @@ func (w *webview) Destroy() {
 }
 
 func (w *webview) Run() {
+	if destroyed.Load() {
+		return
+	}
 	C.webview_run(w.w)
 }
 
 func (w *webview) Terminate() {
+	if destroyed.Load() {
+		return
+	}
 	C.webview_terminate(w.w)
 }
 
 func (w *webview) Window() unsafe.Pointer {
+	if destroyed.Load() {
+		return nil
+	}
 	return C.webview_get_window(w.w)
 }
 
 func (w *webview) Navigate(url string) {
+	if destroyed.Load() {
+		return
+	}
 	s := C.CString(url)
 	defer C.free(unsafe.Pointer(s))
 	C.webview_navigate(w.w, s)
 }
 
 func (w *webview) SetHtml(html string) {
+	if destroyed.Load() {
+		return
+	}
 	s := C.CString(html)
 	defer C.free(unsafe.Pointer(s))
 	C.webview_set_html(w.w, s)
 }
 
 func (w *webview) SetTitle(title string) {
+	if destroyed.Load() {
+		return
+	}
 	s := C.CString(title)
 	defer C.free(unsafe.Pointer(s))
 	C.webview_set_title(w.w, s)
 }
 
 func (w *webview) SetDecorated(decorated bool) {
+	if destroyed.Load() {
+		return
+	}
 	C.webview_set_decorated(w.w, boolToInt(decorated))
 }
 
 func (w *webview) WindowControl(action WindowAction) int {
+	if destroyed.Load() {
+		return -1
+	}
 	return int(C.webview_window_control(w.w, C.webview_window_action_t(action)))
 }
 
 func (w *webview) BeginMoveDrag() int {
+	if destroyed.Load() {
+		return -1
+	}
 	return int(C.webview_window_begin_move_drag(w.w))
 }
 
 func (w *webview) SetSize(width int, height int, hint Hint) {
+	if destroyed.Load() {
+		return
+	}
 	C.webview_set_size(w.w, C.int(width), C.int(height), C.webview_hint_t(hint))
 }
 
 func (w *webview) Init(js string) {
+	if destroyed.Load() {
+		return
+	}
 	s := C.CString(js)
 	defer C.free(unsafe.Pointer(s))
 	C.webview_init(w.w, s)
@@ -294,6 +334,11 @@ func _webviewDispatchGoCallback(index unsafe.Pointer) {
 	delete(dispatch, uintptr(index))
 	m.Unlock()
 	if f != nil {
+		// 入队时 destroyed 可能为 false，但回调真正执行时窗口可能已销毁，
+		// 二次检查：销毁后 UI 线程即将退出，未执行的派发任务直接丢弃。
+		if destroyed.Load() {
+			return
+		}
 		f()
 	}
 }
@@ -335,6 +380,9 @@ func _webviewBindingGoCallback(w C.webview_t, id *C.char, req *C.char, index uin
 }
 
 func (w *webview) Bind(name string, f interface{}) error {
+	if destroyed.Load() {
+		return errors.New("freedom: webview destroyed")
+	}
 	v := reflect.ValueOf(f)
 	// f must be a function
 	if v.Kind() != reflect.Func {
@@ -413,6 +461,9 @@ func (w *webview) Bind(name string, f interface{}) error {
 }
 
 func (w *webview) Unbind(name string) error {
+	if destroyed.Load() {
+		return errors.New("freedom: webview destroyed")
+	}
 	// 清理 Go 侧 bindings / bindNames 条目，避免 Unbind 后永久泄漏。
 	// C 侧 binding_context（glue.c calloc，每 Bind 约 16B）在 C++ unbind 中
 	// 仅 erase map 不 free，会小幅泄漏；但框架内 Bind 次数固定（3~4 个）、

package/templates/project/freedom.config.js

@@ -18,6 +18,14 @@ export default {
   // 是否开启 WebView 开发者工具。
   debug: false,
 
+  // 安全模式，在终端随时可改，三选一：
+  //   'none'  - 明文资源（默认，兼容历史产物）
+  //   'basic' - 明文资源 + 构建期加固提示
+  //   'high'  - resources 整体加密为 app.bin（磁盘无明文 HTML/配置），
+  //             壳内存解密 + 完整性校验，另含 anti-debug / 进程隐藏
+  // 终端命令：freedom security <none|basic|high>，或在 freedom build 时传 --security <mode>
+  security: 'none',
+
   // 标题栏策略，在终端随时可改，二选一：
   //   'native'    - 保留系统原生标题栏，标题栏图标与 exe 图标一致
   //   'frameless' - 完全无边框，标题栏与 Windows 原生最小化 / 最大化 / 关闭按钮均不存在，