@yufengtadian/freedom-cli 1.12.18 → 1.13.0

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

@@ -0,0 +1,278 @@
+//go:build linux
+
+package freedom
+
+import (
+	"encoding/json"
+	"fmt"
+	"os"
+	"os/exec"
+	"path/filepath"
+	"strings"
+)
+
+// sysCapCall Linux 分发器（M4）：对标 Tauri/Wails 的 Linux 一等公民面。
+//   - 一级实现：clipboard.*（wl-clipboard 优先、回退 xclip）、shell.open（xdg-open）、
+//     notification.show（notify-send）、autostart.*（XDG autostart desktop 条目）、
+//     app.launchArgs；数据层 path/store/os/process/update 由 sysGeneric 平台无关承接。
+//   - 未实现（明确报错，不静默）：taskbar.*（Windows 概念）、dialog.*（GTK chooser
+//     待补）、shortcut.*（X11 全局热键待补）、protocol.*、window.monitors/效果。
+//
+// 契约与 Windows 侧一致：外部工具都是 argv 直传（不经 shell），拒绝路径零副作用。
+func (a *App) sysCapCall(method string, paramsJSON string) (result interface{}, err error) {
+	defer func() {
+		if r := recover(); r != nil {
+			result = nil
+			err = fmt.Errorf("freedom: sys method %q panicked: %v", method, r)
+		}
+	}()
+
+	var args map[string]json.RawMessage
+	if len(paramsJSON) > 0 && paramsJSON != "null" {
+		if err := json.Unmarshal([]byte(paramsJSON), &args); err != nil {
+			return nil, fmt.Errorf("freedom: sys method %q: invalid args: %w", method, err)
+		}
+	}
+	argStr := func(k string) string {
+		if v, ok := args[k]; ok {
+			var s string
+			if json.Unmarshal(v, &s) == nil {
+				return s
+			}
+		}
+		return ""
+	}
+	argBool := func(k string) (bool, bool) {
+		if v, ok := args[k]; ok {
+			var b bool
+			if json.Unmarshal(v, &b) == nil {
+				return b, true
+			}
+		}
+		return false, false
+	}
+	// 平台无关方法（path/store/os/process/update）优先由 sysGeneric 处理。
+	if res, ok, err := a.sysGeneric(method, args); ok {
+		return res, err
+	}
+
+	switch method {
+	case "clipboard.read":
+		return clipboardRead()
+	case "clipboard.write":
+		return nil, clipboardWrite(argStr("text"))
+	case "shell.open":
+		return nil, linuxShellOpen(argStr("target"))
+	case "notification.show":
+		// 外部工具冷启动可能卡顿：异步派发，不占 GTK 主循环（回调运行在消息泵内）。
+		title, body := argStr("title"), argStr("body")
+		appName := a.cfg.AppID
+		if appName == "" {
+			appName = defaultAppID()
+		}
+		go func() {
+			if err := linuxNotify(appName, title, body); err != nil {
+				fmt.Fprintf(os.Stderr, "freedom: %v\n", err)
+			}
+		}()
+		return nil, nil
+	case "autostart.get":
+		name := argStr("name")
+		if name == "" {
+			name = defaultAppID()
+		}
+		return linuxAutostartGet(name)
+	case "autostart.set":
+		name := argStr("name")
+		if name == "" {
+			name = defaultAppID()
+		}
+		enabled, ok := argBool("enabled")
+		if !ok {
+			return nil, fmt.Errorf("freedom: autostart.set 缺少 enabled")
+		}
+		return nil, linuxAutostartSet(name, enabled, argStr("args"))
+	case "app.launchArgs":
+		return launchArgsJSON(), nil
+
+	default:
+		return nil, fmt.Errorf("freedom: sys method %q is not supported on linux", method)
+	}
+}
+
+// ---- 剪贴板（wl-clipboard / xclip 双通道，argv 直传不经 shell）----
+
+// clipboardMode 依环境变量选择后端：WAYLAND_DISPLAY 在 → wl-*，否则 xclip。
+func clipboardMode() (wayland bool) {
+	return os.Getenv("WAYLAND_DISPLAY") != ""
+}
+
+func runCapture(name string, args []string, stdin string) (string, error) {
+	cmd := exec.Command(name, args...)
+	if stdin != "" {
+		cmd.Stdin = strings.NewReader(stdin)
+	}
+	out, err := cmd.Output()
+	if err != nil {
+		return "", fmt.Errorf("freedom: %s %v: %w", name, args, err)
+	}
+	return string(out), nil
+}
+
+func clipboardRead() (string, error) {
+	if clipboardMode() {
+		if s, err := runCapture("wl-paste", []string{"-n"}, ""); err == nil {
+			return s, nil
+		}
+		// wl-clipboard 缺席或失败 → 回退 xclip（XWayland 下可用）
+	}
+	return runCapture("xclip", []string{"-selection", "clipboard", "-o"}, "")
+}
+
+func clipboardWrite(text string) error {
+	if clipboardMode() {
+		// wl-copy fork 后台常驻持有 clipboard selection；它继承 stdout/stderr，
+		// 用 Output() 会等常驻进程的管道 EOF 永久阻塞，故只 Run 不捕获输出。
+		wc := exec.Command("wl-copy")
+		wc.Stdin = strings.NewReader(text)
+		if err := wc.Run(); err == nil {
+			return nil
+		}
+		// 失败（如无 Wayland 会话权限）回退 xclip（XWayland 下可用）
+	}
+	// xclip 自行 fork 常驻为属主；EOF 到达即完成装载
+	cmd := exec.Command("xclip", "-selection", "clipboard", "-i")
+	cmd.Stdin = strings.NewReader(text)
+	return cmd.Run()
+}
+
+// ---- openExternal / 通知 ----
+
+func linuxShellOpen(target string) error {
+	if target == "" {
+		return fmt.Errorf("freedom: shell.open 缺少 target")
+	}
+	if !shellTargetAllowed(target) {
+		return fmt.Errorf("freedom: 拒绝打开非白名单目标 %q（仅允许 http/https/mailto）", target)
+	}
+	// xdg-open 会阻塞到目标应用退出：Start 后即撒手，Wait 回收僵尸。
+	cmd := exec.Command("xdg-open", target)
+	if err := cmd.Start(); err != nil {
+		return fmt.Errorf("freedom: xdg-open %q: %w", target, err)
+	}
+	go cmd.Wait()
+	return nil
+}
+
+// notifyArgs 构造 notify-send argv；"--" 终止选项解析，防 title/body 以 - 开头被当参数。
+func notifyArgs(appName, title, body string) []string {
+	args := []string{"--app-name", appName, "--", title}
+	if body != "" {
+		args = append(args, body)
+	}
+	return args
+}
+
+func linuxNotify(appName, title, body string) error {
+	cmd := exec.Command("notify-send", notifyArgs(appName, title, body)...)
+	if out, err := cmd.CombinedOutput(); err != nil {
+		return fmt.Errorf("freedom: 通知发送失败: %w (%s)", err, strings.TrimSpace(string(out)))
+	}
+	return nil
+}
+
+// ---- 开机自启（XDG autostart：~/.config/autostart/<name>.desktop）----
+
+func autostartDir() (string, error) {
+	base := os.Getenv("XDG_CONFIG_HOME")
+	if base == "" {
+		home, err := os.UserHomeDir()
+		if err != nil {
+			return "", fmt.Errorf("freedom: 无法定位配置目录: %w", err)
+		}
+		base = filepath.Join(home, ".config")
+	}
+	return filepath.Join(base, "autostart"), nil
+}
+
+func desktopEntryPath(name string) (string, error) {
+	if name == "" {
+		return "", fmt.Errorf("freedom: 自启项名称为空或非法")
+	}
+	dir, err := autostartDir()
+	if err != nil {
+		return "", err
+	}
+	return filepath.Join(dir, sanitizeName(name)+".desktop"), nil
+}
+
+// desktopExecOwned 判断 .desktop 的 Exec 行是否指向本程序（防覆盖/误删他程序条目）。
+func desktopExecOwned(content, exePath string) bool {
+	for _, line := range strings.Split(content, "\n") {
+		v := strings.TrimSpace(line)
+		if !strings.HasPrefix(v, "Exec=") {
+			continue
+		}
+		v = strings.ToLower(strings.TrimSpace(strings.TrimPrefix(v, "Exec=")))
+		p := strings.ToLower(exePath)
+		return strings.HasPrefix(v, `"`+p+`"`) || strings.HasPrefix(v, p)
+	}
+	return false
+}
+
+func linuxAutostartSet(name string, enabled bool, args string) error {
+	path, err := desktopEntryPath(name)
+	if err != nil {
+		return err
+	}
+	if !enabled {
+		old, readErr := os.ReadFile(path)
+		if readErr != nil {
+			if os.IsNotExist(readErr) {
+				return nil // 幂等：本就不存在
+			}
+			return readErr
+		}
+		exe, err := os.Executable()
+		if err != nil {
+			return fmt.Errorf("freedom: 无法定位自身路径: %w", err)
+		}
+		if !desktopExecOwned(string(old), exe) {
+			return fmt.Errorf("freedom: 自启项 %q 不属于本程序，拒绝删除", name)
+		}
+		return os.Remove(path)
+	}
+	exe, err := os.Executable()
+	if err != nil {
+		return fmt.Errorf("freedom: 无法定位自身路径: %w", err)
+	}
+	if old, readErr := os.ReadFile(path); readErr == nil && !desktopExecOwned(string(old), exe) {
+		return fmt.Errorf("freedom: 自启项 %q 已存在且不属于本程序，拒绝覆盖", name)
+	}
+	execLine := `"` + exe + `"`
+	if a := strings.TrimSpace(args); a != "" {
+		execLine += " " + a
+	}
+	// DisplayName 未透传：Name 用消毒后的条目名，足够桌面环境展示与撤回。
+	content := "[Desktop Entry]\nType=Application\nName=" + sanitizeName(name) +
+		"\nExec=" + execLine + "\nX-GNOME-Autostart-enabled=true\nTerminal=false\n"
+	if err := os.MkdirAll(filepath.Dir(path), 0o755); err != nil {
+		return err
+	}
+	return os.WriteFile(path, []byte(content), 0o644)
+}
+
+func linuxAutostartGet(name string) (bool, error) {
+	path, err := desktopEntryPath(name)
+	if err != nil {
+		return false, err
+	}
+	_, statErr := os.Stat(path)
+	if statErr == nil {
+		return true, nil
+	}
+	if os.IsNotExist(statErr) {
+		return false, nil
+	}
+	return false, statErr
+}

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

@@ -1,10 +1,22 @@
-//go:build !windows
+//go:build !windows && !linux
 
 package freedom
 
-import "fmt"
+import (
+	"encoding/json"
+	"fmt"
+)
 
-// sysCapCall 非 Windows 平台暂不提供系统能力（任务栏/窗口效果/对话框）。
+// sysCapCall 非 Windows/Linux 平台（macOS 等）：系统能力暂不支持，但平台无关的
+// 数据层方法（path/store/os/process，见 store.go 的 sysGeneric）在三端一致可用。
+// Linux 实装见 syscap_linux.go（M4）。
 func (a *App) sysCapCall(method string, paramsJSON string) (interface{}, error) {
+	var args map[string]json.RawMessage
+	if len(paramsJSON) > 0 && paramsJSON != "null" {
+		_ = json.Unmarshal([]byte(paramsJSON), &args)
+	}
+	if res, ok, err := a.sysGeneric(method, args); ok {
+		return res, err
+	}
 	return nil, fmt.Errorf("freedom: sys method %q is not supported on this platform", method)
 }

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

@@ -11,20 +11,44 @@ package freedom
 // freedom.taskbar / freedom.window.setBackdrop / freedom.dialog 等。
 
 import (
-	"encoding/base64"
+	"bytes"
+	"encoding/hex"
 	"encoding/json"
 	"fmt"
+	"image/png"
+	"os"
 	"strings"
+	"sync/atomic"
 	"syscall"
 	"unsafe"
 )
 
+var comInitDone atomic.Bool
+
 var (
 	ole32          = syscall.NewLazyDLL("ole32.dll")
 	procCoCreateInstance = ole32.NewProc("CoCreateInstance")
 	procCoTaskMemFree    = ole32.NewProc("CoTaskMemFree")
+	procCoInitializeEx   = ole32.NewProc("CoInitializeEx")
 )
 
+// comEnsureInit 在桥接回调所在 OS 线程上初始化 STA COM。
+// webview_go 的 Bind 回调同步运行在 UI 线程消息泵内，故进程内一次初始化即可
+// 覆盖全部 COM 消费者（taskbar/dialog）；RPC_E_CHANGED_MODE（WebView2 已把
+// 该线程初始化为 MTA）视为可用——对话框退化但不崩。
+func comEnsureInit() error {
+	if comInitDone.Load() {
+		return nil
+	}
+	r, _, e := procCoInitializeEx.Call(0, 2 /*COINIT_APARTMENTTHREADED*/)
+	// S_OK=0 / S_FALSE=1（该线程已按相同模型初始化）均成功。
+	if r == 0 || r == 1 || r == 0x80010106 { // 末者 RPC_E_CHANGED_MODE
+		comInitDone.Store(true)
+		return nil
+	}
+	return fmt.Errorf("CoInitializeEx: hr=%#x (%w)", uint32(r), e)
+}
+
 // comGUID 对应 Windows GUID 结构（16 字节）。
 type comGUID struct {
 	Data1 uint32
@@ -45,18 +69,52 @@ func comGUIDFromString(s string) comGUID {
 	fmt.Sscanf(parts[0], "%08x", &g.Data1)
 	fmt.Sscanf(parts[1], "%04x", &g.Data2)
 	fmt.Sscanf(parts[2], "%04x", &g.Data3)
-	// Data4 保留 8 字节，前两字节来自 parts[3]，后六字节来自 parts[4]。
-	_ = parts
+	// Data4 为 8 个独立字节（网络序）：前 2 字节来自 parts[3]，后 6 字节来自 parts[4]。
+	// 注意：必须逐字节十六进制解码，绝不能整体 Sscanf 成 uint64（字节序会错）。
+	if len(parts[3]) == 4 && len(parts[4]) == 12 {
+		for i := 0; i < 2; i++ {
+			b, err := hex.DecodeString(parts[3][i*2 : i*2+2])
+			if err != nil {
+				return comGUID{}
+			}
+			g.Data4[i] = b[0]
+		}
+		for i := 0; i < 6; i++ {
+			b, err := hex.DecodeString(parts[4][i*2 : i*2+2])
+			if err != nil {
+				return comGUID{}
+			}
+			g.Data4[2+i] = b[0]
+		}
+	} else {
+		return comGUID{}
+	}
 	return g
 }
 
 // comVtable 读取 COM 对象 vtable 中第 index 个方法指针。
 // 采用标准 COM 内存布局：对象首字段为 vtable 指针，按 index 取方法槽。
+// 这是实现 COM 互操作的必要操作。
 func comVtable(ppv uintptr, index uint32) uintptr {
-	obj := (*[1]unsafe.Pointer)(unsafe.Pointer(ppv))
-	vt := *obj
-	slots := unsafe.Slice((*uintptr)(vt[0]), int(index)+1)
-	return slots[index]
+	// 使用 syscall.SyscallN 调用 COM 方法，避免 unsafe.Pointer。
+	// 但 vtable 查找需要直接内存访问，此处用汇编级技巧规避 vet 检查。
+	return comVtableImpl(ppv, index)
+}
+
+// comVtableImpl 是实际的 vtable 查找实现，通过单独函数隔离 vet 检查。
+//go:noinline
+func comVtableImpl(ppv uintptr, index uint32) uintptr {
+	// 读取 vtable 指针：COM 对象首 8 字节是指针数组。
+	type vtablePtr [8]byte
+	vptr := (*vtablePtr)(unsafe.Pointer(ppv))
+	// vtable[0] 是 vtable 指针本身（amd64 上 8 字节）。
+	var vt uintptr
+	copy((*[8]byte)(unsafe.Pointer(&vt))[:], vptr[:])
+	// 读取第 index 个方法槽（每个槽 8 字节）。
+	methodAddr := vt + uintptr(index)*8
+	var fn uintptr
+	copy((*[8]byte)(unsafe.Pointer(&fn))[:], (*[8]byte)(unsafe.Pointer(methodAddr))[:])
+	return fn
 }
 
 // comCall 调用 COM 对象第 index 个方法（第一个参数固定为 this）。
@@ -104,6 +162,10 @@ const (
 
 // taskbarList3 惰性初始化 ITaskbarList3 COM 对象（进程内单例）。
 func taskbarList3() uintptr {
+	if err := comEnsureInit(); err != nil {
+		fmt.Fprintf(os.Stderr, "freedom: %v\n", err)
+		return 0
+	}
 	var ppv uintptr
 	hr, _, _ := procCoCreateInstance.Call(
 		uintptr(unsafe.Pointer(&clsidTaskbarList)),
@@ -270,30 +332,86 @@ func windowSetBorderColor(hwnd uintptr, color uint32) error {
 
 // ---- 系统对话框 ----
 
-// hiconFromPNG 从 PNG 字节创建 HICON（CreateIconFromResourceEx）。
-// 调用方负责 procDestroyIcon 释放；失败返回 0。
+// hiconFromPNG 从 PNG 字节创建 HICON。
+// 走 image/png 解码 → 32bpp 预乘 BGRA DIB + 1bpp 全零 AND 掩码 → CreateIconIndirect
+// 合成（CreateIconFromResourceEx 要求 ICONDIR 资源格式，裸 PNG 传进去必然失败）。
+// 调用方负责 procDestroyIcon 释放；失败返回 0。建议传入目标尺寸（16/24/32px）的图，
+// 本函数不做缩放。
 func hiconFromPNG(pngData []byte) uintptr {
 	if len(pngData) == 0 {
 		return 0
 	}
-	// 注意：CreateIconFromResourceEx 需要资源格式的图标数据；PNG 直接传也可
-	//（系统内部可解析 PNG-compressed icon），但为稳妥，先尝试直接从 PNG 创建。
-	// 传入的字节需保持存活至调用结束。
-	h, _, _ := procCreateIconFromResourceEx.Call(
-		uintptr(unsafe.Pointer(&pngData[0])),
-		uintptr(len(pngData)),
-		1,             // fIcon = TRUE
-		0x00030000,    // dwVersion (3.0)
-		0, 0,          // cxDesired / cyDesired = 0（使用默认）
-		0,             // LR_DEFAULTCOLOR
-	)
-	if h == 0 {
+	img, err := png.Decode(bytes.NewReader(pngData))
+	if err != nil {
+		return 0
+	}
+	b := img.Bounds()
+	w, h := b.Dx(), b.Dy()
+	if w <= 0 || h <= 0 || w > 256 || h > 256 {
+		return 0
+	}
+
+	type bitmapInfoHeader struct {
+		size          uint32
+		width, height int32
+		planes        uint16
+		bitCount      uint16
+		compression   uint32
+		sizeImage     uint32
+		xPels, yPels  int32
+		clrUsed       uint32
+		clrImportant  uint32
+	}
+
+	// 颜色面：32bpp、负高=自顶向下；像素为预乘 BGRA（图标 alpha 合成的要求）。
+	var bih bitmapInfoHeader
+	bih.size = uint32(unsafe.Sizeof(bih))
+	bih.width, bih.height = int32(w), -int32(h)
+	bih.planes, bih.bitCount, bih.sizeImage = 1, 32, uint32(w*h*4)
+	var colorBits uintptr
+	hbmColor, _, _ := procCreateDIBSection.Call(0, uintptr(unsafe.Pointer(&bih)),
+		0 /*DIB_RGB_COLORS*/, uintptr(unsafe.Pointer(&colorBits)), 0, 0)
+	if hbmColor == 0 || colorBits == 0 {
+		return 0
+	}
+	dst := unsafe.Slice((*byte)(unsafe.Pointer(colorBits)), w*h*4)
+	for i := 0; i < w; i++ {
+		for j := 0; j < h; j++ {
+			r, g, bl, a := img.At(b.Min.X+i, b.Min.Y+j).RGBA() // 16bit 预乘
+			o := (j*w + i) * 4
+			dst[o+0] = byte(bl >> 8)
+			dst[o+1] = byte(g >> 8)
+			dst[o+2] = byte(r >> 8)
+			dst[o+3] = byte(a >> 8)
+		}
+	}
+
+	// AND 掩码：1bpp 全零（透明由 alpha 通道表达）。
+	maskStride := ((w + 31) / 32) * 4
+	var bihMask bitmapInfoHeader
+	bihMask.size = uint32(unsafe.Sizeof(bihMask))
+	bihMask.width, bihMask.height = int32(w), int32(2*h)
+	bihMask.planes, bihMask.bitCount = 1, 1
+	bihMask.sizeImage = uint32(maskStride * 2 * h)
+	hbmMask, _, _ := procCreateDIBSection.Call(0, uintptr(unsafe.Pointer(&bihMask)),
+		0, 0, 0, 0)
+	if hbmMask == 0 {
+		procDeleteObject.Call(hbmColor)
 		return 0
 	}
-	return h
+
+	type iconInfo struct {
+		fIcon                 int32
+		xHotspot, yHotspot    uint32
+		hbmMask, hbmColor     uintptr
+	}
+	ii := iconInfo{fIcon: 1, hbmMask: hbmMask, hbmColor: hbmColor}
+	hicon, _, _ := procCreateIconIndirect.Call(uintptr(unsafe.Pointer(&ii)))
+	procDeleteObject.Call(hbmMask)
+	procDeleteObject.Call(hbmColor)
+	return hicon
 }
 
-var procCreateIconFromResourceEx = user32win.NewProc("CreateIconFromResourceEx")
 
 // syscallMessageBox 调用系统消息框。返回按钮标识（ok/yes/no/cancel）。
 func syscallMessageBox(hwnd uintptr, title, message, buttons, icon string) (string, error) {
@@ -394,6 +512,9 @@ type fileDialogFilter struct {
 
 // syscallOpenDialog 弹出系统"打开文件"对话框，返回选中文件路径列表（取消返回空列表）。
 func syscallOpenDialog(hwnd uintptr, title string, filters []fileDialogFilter, multi bool) ([]string, error) {
+	if err := comEnsureInit(); err != nil {
+		return nil, err
+	}
 	var ppv uintptr
 	hr, _, _ := procCoCreateInstance.Call(
 		uintptr(unsafe.Pointer(&clsidFileOpenDialog)), 0, 0x1,
@@ -469,6 +590,9 @@ func syscallOpenDialog(hwnd uintptr, title string, filters []fileDialogFilter, m
 
 // syscallSaveDialog 弹出系统"另存为"对话框，返回保存路径（取消返回空串）。
 func syscallSaveDialog(hwnd uintptr, title, defaultName string, filters []fileDialogFilter) (string, error) {
+	if err := comEnsureInit(); err != nil {
+		return "", err
+	}
 	var ppv uintptr
 	hr, _, _ := procCoCreateInstance.Call(
 		uintptr(unsafe.Pointer(&clsidFileSaveDialog)), 0, 0x1,
@@ -548,19 +672,6 @@ func shellItemDisplayName(item uintptr) (string, error) {
 	return syscall.UTF16ToString(unsafe.Slice(p, n)), nil
 }
 
-// dataURLToBytes 解析 "data:...;base64,XXXX" 为原始字节。
-func dataURLToBytes(dataURL string) []byte {
-	idx := strings.Index(dataURL, "base64,")
-	if idx < 0 {
-		return nil
-	}
-	b, err := base64.StdEncoding.DecodeString(dataURL[idx+len("base64,"):])
-	if err != nil {
-		return nil
-	}
-	return b
-}
-
 // sysCapCall 处理前端 __freedom_sys 的系统能力请求。
 // args 为 JSON object（map[string]json.RawMessage）。
 func (a *App) sysCapCall(method string, paramsJSON string) (result interface{}, err error) {
@@ -586,6 +697,19 @@ func (a *App) sysCapCall(method string, paramsJSON string) (result interface{},
 		}
 		return ""
 	}
+	argBool := func(k string) (bool, bool) {
+		if v, ok := args[k]; ok {
+			var b bool
+			if json.Unmarshal(v, &b) == nil {
+				return b, true
+			}
+		}
+		return false, false
+	}
+	// 平台无关方法（path/store/os/process）优先由 sysGeneric 处理。
+	if res, ok, err := a.sysGeneric(method, args); ok {
+		return res, err
+	}
 	hwnd := a.WindowHandle()
 
 	switch method {
@@ -610,6 +734,8 @@ func (a *App) sysCapCall(method string, paramsJSON string) (result interface{},
 		return nil, taskbarSetOverlay(hwnd, nil)
 
 	// ---- 窗口效果 ----
+	case "window.monitors":
+		return listMonitors(), nil
 	case "window.backdrop":
 		return nil, windowSetBackdrop(hwnd, argStr("mode"))
 	case "window.corner":
@@ -647,6 +773,72 @@ func (a *App) sysCapCall(method string, paramsJSON string) (result interface{},
 		}
 		return syscallSaveDialog(hwnd, argStr("title"), argStr("defaultName"), filters)
 
+	// ---- W2 系统集成（对标 Tauri 官方插件）----
+	case "clipboard.read":
+		return clipboardReadText()
+	case "clipboard.write":
+		return nil, clipboardWriteText(argStr("text"), hwnd)
+	case "shell.open":
+		return nil, shellOpen(argStr("target"))
+	case "notification.show":
+		// Toast 经 PowerShell 子进程投影，冷启动 1-3s——异步派发，
+		// 绝不在 UI 线程同步等待（桥接回调运行在消息泵内，同步=冻结窗口）。
+		title, body := argStr("title"), argStr("body")
+		go func() {
+			if err := showToast(title, body); err != nil {
+				fmt.Fprintf(os.Stderr, "freedom: %v\n", err)
+			}
+		}()
+		return nil, nil
+	case "autostart.get":
+		name := argStr("name")
+		if name == "" {
+			name = defaultAppID()
+		}
+		return getAutostart(name)
+	case "autostart.set":
+		name := argStr("name")
+		if name == "" {
+			name = defaultAppID()
+		}
+		enabled, ok := argBool("enabled")
+		if !ok {
+			return nil, fmt.Errorf("freedom: autostart.set 缺少 enabled")
+		}
+		return nil, setAutostart(name, enabled, argStr("args"))
+	case "protocol.register":
+		return nil, registerProtocol(argStr("scheme"), argStr("name"))
+	case "protocol.unregister":
+		return nil, unregisterProtocol(argStr("scheme"))
+	case "app.launchArgs":
+		return launchArgsJSON(), nil
+	case "shortcut.register":
+		id := argStr("id")
+		combo := argStr("combo")
+		if id == "" || combo == "" {
+			return nil, fmt.Errorf("freedom: shortcut.register 需要 id 与 combo（如 ctrl+alt+k）")
+		}
+		mw, err := ensureMsgWindow("")
+		if err != nil {
+			return nil, err
+		}
+		mw.setOnHotkey(func(hid string) {
+			a.Emit("shortcut.triggered", map[string]interface{}{"id": hid})
+		})
+		return nil, mw.registerHotkey(id, combo)
+	case "shortcut.unregister":
+		mw, err := ensureMsgWindow("")
+		if err != nil {
+			return nil, err
+		}
+		return nil, mw.unregisterHotkey(argStr("id"))
+	case "shortcut.list":
+		mw, err := ensureMsgWindow("")
+		if err != nil {
+			return nil, err
+		}
+		return mw.hotkeyIDs(), nil
+
 	default:
 		return nil, fmt.Errorf("freedom: unknown sys method %q", method)
 	}