Skip to content

PasteFerry (隔空贴): clipboard and file sync across macOS, Windows and Linux. Direct-first, end-to-end encrypted. Optional official access: no server to host. Independent self-hosting remains available.

feat(ui): add native quick paste shells for macOS, Windows and Linux

baiyuzeba13d1f4b24c
diff --git a/ui/linux/CMakeLists.txt b/ui/linux/CMakeLists.txt
index b2f6ed0..6d537c2 100644
--- a/ui/linux/CMakeLists.txt
+++ b/ui/linux/CMakeLists.txt
@@ -54,6 +54,7 @@ add_subdirectory(${FLUTTER_MANAGED_DIR})
# System-level dependencies.
find_package(PkgConfig REQUIRED)
pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0)
+pkg_check_modules(X11 REQUIRED IMPORTED_TARGET x11 xtst)
# Application build; see runner/CMakeLists.txt.
add_subdirectory("runner")
diff --git a/ui/linux/runner/CMakeLists.txt b/ui/linux/runner/CMakeLists.txt
index e97dabc..b5f0870 100644
--- a/ui/linux/runner/CMakeLists.txt
+++ b/ui/linux/runner/CMakeLists.txt
@@ -9,6 +9,7 @@ project(runner LANGUAGES CXX)
add_executable(${BINARY_NAME}
"main.cc"
"my_application.cc"
+ "picker_application.cc"
"${FLUTTER_MANAGED_DIR}/generated_plugin_registrant.cc"
)
@@ -22,5 +23,7 @@ add_definitions(-DAPPLICATION_ID="${APPLICATION_ID}")
# Add dependency libraries. Add any application-specific dependencies here.
target_link_libraries(${BINARY_NAME} PRIVATE flutter)
target_link_libraries(${BINARY_NAME} PRIVATE PkgConfig::GTK)
+# 快捷粘贴窗口在 X11 上抓全局快捷键、模拟粘贴键(XTest),见 picker_application.cc
+target_link_libraries(${BINARY_NAME} PRIVATE PkgConfig::X11)
target_include_directories(${BINARY_NAME} PRIVATE "${CMAKE_SOURCE_DIR}")
diff --git a/ui/linux/runner/main.cc b/ui/linux/runner/main.cc
index e7c5c54..cd81aa4 100644
--- a/ui/linux/runner/main.cc
+++ b/ui/linux/runner/main.cc
@@ -1,6 +1,16 @@
+#include <string.h>
+
#include "my_application.h"
+#include "picker_application.h"
int main(int argc, char** argv) {
+ // pasteferry --picker:快捷粘贴窗口,与主界面是两个应用 ID,互不激活。见 picker_application.h
+ for (int i = 1; i < argc; i++) {
+ if (strcmp(argv[i], "--picker") == 0) {
+ g_autoptr(PickerApplication) picker = picker_application_new();
+ return g_application_run(G_APPLICATION(picker), argc, argv);
+ }
+ }
g_autoptr(MyApplication) app = my_application_new();
return g_application_run(G_APPLICATION(app), argc, argv);
}
diff --git a/ui/linux/runner/picker_application.cc b/ui/linux/runner/picker_application.cc
new file mode 100644
index 0000000..254001b
--- /dev/null
+++ b/ui/linux/runner/picker_application.cc
@@ -0,0 +1,764 @@
+#include "picker_application.h"
+
+#include <flutter_linux/flutter_linux.h>
+#include <string.h>
+
+#ifdef GDK_WINDOWING_X11
+#include <X11/XKBlib.h>
+#include <X11/Xatom.h>
+#include <X11/Xutil.h>
+#include <X11/extensions/XTest.h>
+#include <gdk/gdkx.h>
+#endif
+#ifdef GDK_WINDOWING_WAYLAND
+#include <gdk/gdkwayland.h>
+#endif
+
+// 快捷粘贴窗口的原生外壳(Linux)。列表与按键都在 Dart 里(lib/picker/),这里只做:
+// - 全局快捷键:X11 上在根窗口 XGrabKey;Wayland 上经 xdg-desktop-portal 的 GlobalShortcuts,
+// 桌面不支持时由用户在系统设置里添加一条运行 `pasteferry --picker --toggle` 的自定义快捷键
+// - 窗口:无边框、不进任务栏、置顶,失去焦点就收起
+// - 粘贴:X11 上把焦点交还原来的窗口,再用 XTest 发 Ctrl+V(终端发 Ctrl+Shift+V);
+// Wayland 不允许程序模拟按键,只放进剪贴板,由用户按 Ctrl+V
+// 与 Mac、Windows 的外壳用同一个通道 pasteferry/picker,方法见 lib/picker/picker_host.dart。
+
+static const int kWidth = 560;
+static const int kHeight = 460;
+
+struct _PickerApplication {
+ GtkApplication parent_instance;
+ char** dart_entrypoint_arguments;
+ gboolean toggle_on_ready; // 本进程就是被 --toggle 拉起的:Dart 准备好后显示
+
+ GtkWindow* window;
+ FlView* view;
+ FlMethodChannel* channel;
+ gboolean dart_ready;
+ gboolean pending_show;
+ gboolean suspended;
+
+ // 快捷键
+ gchar* hotkey; // 设置里的写法,如 "alt+v"
+ gboolean portal;
+ gchar* portal_session;
+ gchar* portal_trigger; // 门户里实际生效的组合,显示给用户看
+ guint portal_activated_sub;
+ guint portal_changed_sub;
+#ifdef GDK_WINDOWING_X11
+ unsigned int grab_keycode;
+ unsigned int grab_modifiers;
+ gboolean grabbed;
+ Window previous; // 呼出时的前台窗口
+ guint32 last_time;
+#endif
+};
+
+G_DEFINE_TYPE(PickerApplication, picker_application, GTK_TYPE_APPLICATION)
+
+static gboolean is_x11() {
+#ifdef GDK_WINDOWING_X11
+ return GDK_IS_X11_DISPLAY(gdk_display_get_default());
+#else
+ return FALSE;
+#endif
+}
+
+static gboolean is_wayland() {
+#ifdef GDK_WINDOWING_WAYLAND
+ return GDK_IS_WAYLAND_DISPLAY(gdk_display_get_default());
+#else
+ return FALSE;
+#endif
+}
+
+static void invoke(PickerApplication* self, const gchar* method) {
+ if (self->channel != nullptr) {
+ fl_method_channel_invoke_method(self->channel, method, nullptr, nullptr, nullptr, nullptr);
+ }
+}
+
+// ─────────────────────────── X11:前台窗口、粘贴、快捷键 ───────────────────────────
+
+#ifdef GDK_WINDOWING_X11
+static Display* xdisplay() { return GDK_DISPLAY_XDISPLAY(gdk_display_get_default()); }
+
+static Window active_window() {
+ Display* d = xdisplay();
+ Atom prop = XInternAtom(d, "_NET_ACTIVE_WINDOW", False);
+ Atom type;
+ int format;
+ unsigned long n, after;
+ unsigned char* data = nullptr;
+ Window w = 0;
+ if (XGetWindowProperty(d, DefaultRootWindow(d), prop, 0, 1, False, XA_WINDOW, &type, &format, &n, &after,
+ &data) == Success &&
+ data != nullptr && n > 0) {
+ w = *reinterpret_cast<Window*>(data);
+ }
+ if (data != nullptr) XFree(data);
+ return w;
+}
+
+static void activate_window(Window w, guint32 time) {
+ Display* d = xdisplay();
+ XEvent e = {};
+ e.xclient.type = ClientMessage;
+ e.xclient.window = w;
+ e.xclient.message_type = XInternAtom(d, "_NET_ACTIVE_WINDOW", False);
+ e.xclient.format = 32;
+ e.xclient.data.l[0] = 2; // 来源:工具(pager),窗口管理器照办,不当成抢焦点
+ e.xclient.data.l[1] = time;
+ XSendEvent(d, DefaultRootWindow(d), False, SubstructureRedirectMask | SubstructureNotifyMask, &e);
+ XFlush(d);
+}
+
+// 终端里粘贴是 Ctrl+Shift+V。按窗口的 WM_CLASS 认常见的终端。
+static gboolean is_terminal(Window w) {
+ static const char* kTerminals[] = {"gnome-terminal", "org.gnome.terminal", "org.gnome.console", "kgx",
+ "konsole", "xfce4-terminal", "tilix", "kitty", "alacritty", "wezterm",
+ "terminator", "xterm", "urxvt", "st-256color", "foot", "ptyxis",
+ "mate-terminal", "lxterminal", "qterminal", "terminology", "guake",
+ "tilda", "blackbox", nullptr};
+ XClassHint hint = {};
+ if (w == 0 || !XGetClassHint(xdisplay(), w, &hint)) return FALSE;
+ gboolean found = FALSE;
+ for (const char* const* t = kTerminals; *t != nullptr && !found; t++) {
+ found = (hint.res_class != nullptr && g_ascii_strcasecmp(hint.res_class, *t) == 0) ||
+ (hint.res_name != nullptr && g_ascii_strcasecmp(hint.res_name, *t) == 0);
+ }
+ if (hint.res_class != nullptr) XFree(hint.res_class);
+ if (hint.res_name != nullptr) XFree(hint.res_name);
+ return found;
+}
+
+static void fake_key(KeySym sym, Bool down) {
+ Display* d = xdisplay();
+ KeyCode code = XKeysymToKeycode(d, sym);
+ if (code != 0) XTestFakeKeyEvent(d, code, down, CurrentTime);
+}
+
+// 发 Ctrl+V(终端 Ctrl+Shift+V)。用户还按着 Alt、Super(用 Alt+数字选的)时先松开,免得变成别的组合。
+static void send_paste(gboolean terminal) {
+ Display* d = xdisplay();
+ char keys[32];
+ XQueryKeymap(d, keys);
+ const KeySym held[] = {XK_Alt_L, XK_Alt_R, XK_Super_L, XK_Super_R, XK_Meta_L, XK_Meta_R, XK_Shift_L, XK_Shift_R};
+ for (KeySym s : held) {
+ KeyCode c = XKeysymToKeycode(d, s);
+ if (c != 0 && (keys[c / 8] & (1 << (c % 8)))) XTestFakeKeyEvent(d, c, False, CurrentTime);
+ }
+ fake_key(XK_Control_L, True);
+ if (terminal) fake_key(XK_Shift_L, True);
+ fake_key(XK_v, True);
+ fake_key(XK_v, False);
+ if (terminal) fake_key(XK_Shift_L, False);
+ fake_key(XK_Control_L, False);
+ XFlush(d);
+}
+
+// 设置里的写法 → X11 的键码与修饰键。
+static gboolean parse_hotkey(const gchar* name, unsigned int* keycode, unsigned int* modifiers) {
+ g_auto(GStrv) parts = g_strsplit(name, "+", -1);
+ guint n = g_strv_length(parts);
+ if (n == 0) return FALSE;
+ unsigned int mods = 0;
+ for (guint i = 0; i + 1 < n; i++) {
+ if (g_strcmp0(parts[i], "ctrl") == 0) mods |= ControlMask;
+ else if (g_strcmp0(parts[i], "alt") == 0) mods |= Mod1Mask;
+ else if (g_strcmp0(parts[i], "shift") == 0) mods |= ShiftMask;
+ else if (g_strcmp0(parts[i], "meta") == 0) mods |= Mod4Mask;
+ else return FALSE;
+ }
+ static const struct { const char* name; const char* sym; } kNames[] = {
+ {"enter", "Return"}, {"backspace", "BackSpace"}, {"delete", "Delete"}, {"insert", "Insert"},
+ {"home", "Home"}, {"end", "End"}, {"pageup", "Prior"}, {"pagedown", "Next"}, {"up", "Up"},
+ {"down", "Down"}, {"left", "Left"}, {"right", "Right"}, {"tab", "Tab"}, {"quote", "apostrophe"},
+ {"backquote", "grave"}, {nullptr, nullptr}};
+ const gchar* key = parts[n - 1];
+ g_autofree gchar* upper = nullptr;
+ const char* sym = key;
+ for (int i = 0; kNames[i].name != nullptr; i++) {
+ if (g_strcmp0(key, kNames[i].name) == 0) sym = kNames[i].sym;
+ }
+ if (key[0] == 'f' && g_ascii_isdigit(key[1])) {
+ upper = g_ascii_strup(key, -1); // f9 → F9
+ sym = upper;
+ }
+ KeySym ks = XStringToKeysym(sym);
+ if (ks == NoSymbol) return FALSE;
+ KeyCode code = XKeysymToKeycode(xdisplay(), ks);
+ if (code == 0) return FALSE;
+ *keycode = code;
+ *modifiers = mods;
+ return TRUE;
+}
+
+// 数字锁定、大写锁定开着时,按下的修饰键里会多出它们,要一起抓
+static const unsigned int kLockVariants[] = {0, LockMask, Mod2Mask, LockMask | Mod2Mask};
+
+static void ungrab(PickerApplication* self) {
+ if (!self->grabbed) return;
+ Display* d = xdisplay();
+ for (unsigned int extra : kLockVariants) {
+ XUngrabKey(d, self->grab_keycode, self->grab_modifiers | extra, DefaultRootWindow(d));
+ }
+ XFlush(d);
+ self->grabbed = FALSE;
+}
+
+// 返回 0 表示成功;被别的程序抓了是 BadAccess
+static int grab(PickerApplication* self) {
+ ungrab(self);
+ if (self->suspended || self->grab_keycode == 0) return 0;
+ GdkDisplay* gd = gdk_display_get_default();
+ Display* d = xdisplay();
+ gdk_x11_display_error_trap_push(gd);
+ for (unsigned int extra : kLockVariants) {
+ XGrabKey(d, self->grab_keycode, self->grab_modifiers | extra, DefaultRootWindow(d), False, GrabModeAsync,
+ GrabModeAsync);
+ }
+ XSync(d, False);
+ int error = gdk_x11_display_error_trap_pop(gd);
+ if (error == 0) {
+ self->grabbed = TRUE;
+ } else {
+ for (unsigned int extra : kLockVariants) {
+ XUngrabKey(d, self->grab_keycode, self->grab_modifiers | extra, DefaultRootWindow(d));
+ }
+ }
+ return error;
+}
+
+static void toggle(PickerApplication* self, guint32 time);
+
+static GdkFilterReturn key_filter(GdkXEvent* xevent, GdkEvent* event, gpointer data) {
+ auto* self = PICKER_APPLICATION(data);
+ XEvent* e = static_cast<XEvent*>(xevent);
+ if (e->type == KeyPress && self->grabbed && e->xkey.keycode == self->grab_keycode &&
+ (e->xkey.state & ~(LockMask | Mod2Mask)) == self->grab_modifiers) {
+ toggle(self, e->xkey.time);
+ return GDK_FILTER_REMOVE;
+ }
+ return GDK_FILTER_CONTINUE;
+}
+#endif
+
+// ─────────────────────────── Wayland:全局快捷键门户 ───────────────────────────
+
+static const gchar* kPortalBus = "org.freedesktop.portal.Desktop";
+static const gchar* kPortalPath = "/org/freedesktop/portal/desktop";
+static const gchar* kShortcutsIface = "org.freedesktop.portal.GlobalShortcuts";
+
+// 设置里的写法 → 门户的写法(XDG shortcuts 规范):CTRL+ALT+v、LOGO+v
+static gchar* portal_trigger(const gchar* name) {
+ g_auto(GStrv) parts = g_strsplit(name, "+", -1);
+ GString* out = g_string_new(nullptr);
+ guint n = g_strv_length(parts);
+ for (guint i = 0; i < n; i++) {
+ if (out->len > 0) g_string_append_c(out, '+');
+ const gchar* p = parts[i];
+ if (i + 1 < n) {
+ g_string_append(out, g_strcmp0(p, "meta") == 0 ? "LOGO" : g_strcmp0(p, "ctrl") == 0 ? "CTRL"
+ : g_strcmp0(p, "alt") == 0 ? "ALT"
+ : "SHIFT");
+ } else if (p[0] == 'f' && g_ascii_isdigit(p[1])) {
+ g_autofree gchar* up = g_ascii_strup(p, -1);
+ g_string_append(out, up);
+ } else {
+ g_string_append(out, p);
+ }
+ }
+ return g_string_free(out, FALSE);
+}
+
+static gchar* request_path(GDBusConnection* bus, const gchar* token) {
+ g_autofree gchar* sender = g_strdup(g_dbus_connection_get_unique_name(bus) + 1);
+ for (gchar* c = sender; *c != '\0'; c++) {
+ if (*c == '.') *c = '_';
+ }
+ return g_strdup_printf("/org/freedesktop/portal/desktop/request/%s/%s", sender, token);
+}
+
+typedef void (*PortalResponse)(PickerApplication* self, guint32 code, GVariant* results);
+
+struct PortalRequest {
+ PickerApplication* self;
+ PortalResponse done;
+ guint sub;
+};
+
+static void portal_response(GDBusConnection* bus, const gchar*, const gchar*, const gchar*, const gchar*,
+ GVariant* params, gpointer data) {
+ auto* req = static_cast<PortalRequest*>(data);
+ guint32 code = 0;
+ g_autoptr(GVariant) results = nullptr;
+ g_variant_get(params, "(u@a{sv})", &code, &results);
+ g_dbus_connection_signal_unsubscribe(bus, req->sub);
+ req->done(req->self, code, results);
+ g_free(req);
+}
+
+// 门户的调用都是异步的:先订阅 Request 对象的 Response 信号,再发起调用
+static void portal_call(PickerApplication* self, const gchar* method, GVariant* params, const gchar* token,
+ PortalResponse done) {
+ GDBusConnection* bus = g_application_get_dbus_connection(G_APPLICATION(self));
+ g_autofree gchar* path = request_path(bus, token);
+ auto* req = g_new0(PortalRequest, 1);
+ req->self = self;
+ req->done = done;
+ req->sub = g_dbus_connection_signal_subscribe(bus, kPortalBus, "org.freedesktop.portal.Request", "Response", path,
+ nullptr, G_DBUS_SIGNAL_FLAGS_NO_MATCH_RULE, portal_response, req,
+ nullptr);
+ g_dbus_connection_call(bus, kPortalBus, kPortalPath, kShortcutsIface, method, params, nullptr,
+ G_DBUS_CALL_FLAGS_NONE, -1, nullptr, nullptr, nullptr);
+}
+
+static void report_portal_hotkey(PickerApplication* self, GVariant* shortcuts) {
+ GVariantIter iter;
+ const gchar* id = nullptr;
+ GVariant* props = nullptr;
+ g_variant_iter_init(&iter, shortcuts);
+ while (g_variant_iter_next(&iter, "(&s@a{sv})", &id, &props)) {
+ const gchar* trigger = nullptr;
+ if (g_variant_lookup(props, "trigger_description", "&s", &trigger)) {
+ g_free(self->portal_trigger);
+ self->portal_trigger = g_strdup(trigger);
+ }
+ g_variant_unref(props);
+ }
+ if (self->channel != nullptr && self->portal_trigger != nullptr) {
+ g_autoptr(FlValue) args = fl_value_new_map();
+ fl_value_set_string_take(args, "hotkey", fl_value_new_string(self->portal_trigger));
+ fl_method_channel_invoke_method(self->channel, "onHotkeyChanged", args, nullptr, nullptr, nullptr);
+ }
+}
+
+static void toggle_from_portal(PickerApplication* self, const gchar* token);
+
+static void portal_activated(GDBusConnection*, const gchar*, const gchar*, const gchar*, const gchar*,
+ GVariant* params, gpointer data) {
+ auto* self = PICKER_APPLICATION(data);
+ const gchar* session = nullptr;
+ const gchar* id = nullptr;
+ guint64 timestamp = 0;
+ g_autoptr(GVariant) options = nullptr;
+ g_variant_get(params, "(&o&st@a{sv})", &session, &id, &timestamp, &options);
+ if (g_strcmp0(session, self->portal_session) != 0) return;
+ const gchar* token = nullptr;
+ g_variant_lookup(options, "activation_token", "&s", &token);
+ toggle_from_portal(self, token);
+}
+
+static void portal_shortcuts_changed(GDBusConnection*, const gchar*, const gchar*, const gchar*, const gchar*,
+ GVariant* params, gpointer data) {
+ auto* self = PICKER_APPLICATION(data);
+ const gchar* session = nullptr;
+ g_autoptr(GVariant) shortcuts = nullptr;
+ g_variant_get(params, "(&o@a(sa{sv}))", &session, &shortcuts);
+ if (g_strcmp0(session, self->portal_session) == 0) report_portal_hotkey(self, shortcuts);
+}
+
+static void portal_bound(PickerApplication* self, guint32 code, GVariant* results) {
+ if (code != 0) {
+ g_warning("全局快捷键门户:用户没有同意绑定快捷键(%u)", code);
+ return;
+ }
+ g_autoptr(GVariant) shortcuts = g_variant_lookup_value(results, "shortcuts", G_VARIANT_TYPE("a(sa{sv})"));
+ if (shortcuts != nullptr) report_portal_hotkey(self, shortcuts);
+}
+
+static void portal_session_created(PickerApplication* self, guint32 code, GVariant* results) {
+ const gchar* handle = nullptr;
+ if (code != 0 || !g_variant_lookup(results, "session_handle", "&s", &handle)) {
+ g_warning("全局快捷键门户:建立会话失败(%u)", code);
+ return;
+ }
+ self->portal_session = g_strdup(handle);
+ GDBusConnection* bus = g_application_get_dbus_connection(G_APPLICATION(self));
+ self->portal_activated_sub = g_dbus_connection_signal_subscribe(
+ bus, kPortalBus, kShortcutsIface, "Activated", kPortalPath, nullptr, G_DBUS_SIGNAL_FLAGS_NONE,
+ portal_activated, self, nullptr);
+ self->portal_changed_sub = g_dbus_connection_signal_subscribe(
+ bus, kPortalBus, kShortcutsIface, "ShortcutsChanged", kPortalPath, nullptr, G_DBUS_SIGNAL_FLAGS_NONE,
+ portal_shortcuts_changed, self, nullptr);
+
+ g_autofree gchar* trigger = portal_trigger(self->hotkey != nullptr ? self->hotkey : "alt+v");
+ GVariantBuilder props;
+ g_variant_builder_init(&props, G_VARIANT_TYPE("a{sv}"));
+ g_variant_builder_add(&props, "{sv}", "description", g_variant_new_string("PasteFerry quick paste"));
+ g_variant_builder_add(&props, "{sv}", "preferred_trigger", g_variant_new_string(trigger));
+ GVariantBuilder shortcuts;
+ g_variant_builder_init(&shortcuts, G_VARIANT_TYPE("a(sa{sv})"));
+ g_variant_builder_add(&shortcuts, "(sa{sv})", "toggle", &props);
+ GVariantBuilder options;
+ g_variant_builder_init(&options, G_VARIANT_TYPE("a{sv}"));
+ g_variant_builder_add(&options, "{sv}", "handle_token", g_variant_new_string("pasteferry_bind"));
+ portal_call(self, "BindShortcuts",
+ g_variant_new("(oa(sa{sv})sa{sv})", self->portal_session, &shortcuts, "", &options),
+ "pasteferry_bind", portal_bound);
+}
+
+// 桌面支持全局快捷键门户吗(GNOME 48 起、KDE Plasma 5.27 起)?Ubuntu 24.04 的 GNOME 46 不支持。
+static gboolean portal_available(PickerApplication* self) {
+ GDBusConnection* bus = g_application_get_dbus_connection(G_APPLICATION(self));
+ if (bus == nullptr) return FALSE;
+ g_autoptr(GError) error = nullptr;
+ g_autoptr(GVariant) v = g_dbus_connection_call_sync(
+ bus, kPortalBus, kPortalPath, "org.freedesktop.DBus.Properties", "Get",
+ g_variant_new("(ss)", kShortcutsIface, "version"), G_VARIANT_TYPE("(v)"), G_DBUS_CALL_FLAGS_NONE, 2000,
+ nullptr, &error);
+ return v != nullptr;
+}
+
+static void portal_start(PickerApplication* self) {
+ GVariantBuilder options;
+ g_variant_builder_init(&options, G_VARIANT_TYPE("a{sv}"));
+ g_variant_builder_add(&options, "{sv}", "handle_token", g_variant_new_string("pasteferry_session"));
+ g_variant_builder_add(&options, "{sv}", "session_handle_token", g_variant_new_string("pasteferry"));
+ portal_call(self, "CreateSession", g_variant_new("(a{sv})", &options), "pasteferry_session",
+ portal_session_created);
+}
+
+// ─────────────────────────── 窗口 ───────────────────────────
+
+static void place(PickerApplication* self) {
+ if (!is_x11()) return; // Wayland 上窗口位置由系统决定
+ GdkDisplay* display = gdk_display_get_default();
+ GdkSeat* seat = gdk_display_get_default_seat(display);
+ int x = 0, y = 0;
+ gdk_device_get_position(gdk_seat_get_pointer(seat), nullptr, &x, &y);
+ GdkMonitor* monitor = gdk_display_get_monitor_at_point(display, x, y);
+ GdkRectangle area;
+ gdk_monitor_get_workarea(monitor, &area);
+ gtk_window_move(self->window, area.x + (area.width - kWidth) / 2, area.y + area.height * 22 / 100);
+}
+
+static void show(PickerApplication* self, guint32 time) {
+ if (!self->dart_ready) {
+ self->pending_show = TRUE;
+ return;
+ }
+#ifdef GDK_WINDOWING_X11
+ if (is_x11()) {
+ Window w = active_window();
+ GdkWindow* mine = gtk_widget_get_window(GTK_WIDGET(self->window));
+ if (w != 0 && (mine == nullptr || w != GDK_WINDOW_XID(mine))) self->previous = w;
+ self->last_time = time;
+ }
+#endif
+ place(self);
+ invoke(self, "onShow");
+ gtk_widget_show(GTK_WIDGET(self->window));
+ if (time != GDK_CURRENT_TIME) {
+ gtk_window_present_with_time(self->window, time);
+ } else {
+ gtk_window_present(self->window);
+ }
+ gtk_widget_grab_focus(GTK_WIDGET(self->view));
+}
+
+static void hide(PickerApplication* self, gboolean notify) {
+ if (!gtk_widget_get_visible(GTK_WIDGET(self->window))) return;
+ gtk_widget_hide(GTK_WIDGET(self->window));
+ if (notify) invoke(self, "onHide");
+}
+
+static void toggle(PickerApplication* self, guint32 time) {
+ if (gtk_widget_get_visible(GTK_WIDGET(self->window))) {
+ hide(self, TRUE);
+ } else {
+ show(self, time);
+ }
+}
+
+static void toggle_from_portal(PickerApplication* self, const gchar* token) {
+ // 门户给了激活令牌时交给 GTK,Wayland 下窗口才能拿到焦点(否则 GNOME 只显示「已就绪」通知)
+ if (token != nullptr) gtk_window_set_startup_id(self->window, token);
+ toggle(self, GDK_CURRENT_TIME);
+}
+
+static gboolean on_focus_out(GtkWidget*, GdkEvent*, gpointer data) {
+ // 点了窗口外面、切到别的程序:收起,什么都不粘贴
+ hide(PICKER_APPLICATION(data), TRUE);
+ return FALSE;
+}
+
+static gboolean on_delete(GtkWidget*, GdkEvent*, gpointer data) {
+ hide(PICKER_APPLICATION(data), TRUE);
+ return TRUE; // 只收起,进程留着等下一次快捷键
+}
+
+// ─────────────────────────── Dart → 原生 ───────────────────────────
+
+static FlValue* hotkey_reply(gboolean ok, const gchar* error, const gchar* source, const gchar* hotkey) {
+ FlValue* r = fl_value_new_map();
+ fl_value_set_string_take(r, "ok", fl_value_new_bool(ok));
+ fl_value_set_string_take(r, "error", fl_value_new_string(error));
+ fl_value_set_string_take(r, "source", fl_value_new_string(source));
+ fl_value_set_string_take(r, "hotkey", fl_value_new_string(hotkey != nullptr ? hotkey : ""));
+ return r;
+}
+
+static FlValue* set_hotkey(PickerApplication* self, const gchar* name, gboolean enabled) {
+ g_free(self->hotkey);
+ self->hotkey = enabled ? g_strdup(name) : nullptr;
+#ifdef GDK_WINDOWING_X11
+ if (is_x11()) {
+ if (!enabled) {
+ self->grab_keycode = 0;
+ ungrab(self);
+ return hotkey_reply(TRUE, "", "native", "");
+ }
+ unsigned int code = 0, mods = 0;
+ if (!parse_hotkey(name, &code, &mods)) return hotkey_reply(FALSE, "invalid", "native", name);
+ self->grab_keycode = code;
+ self->grab_modifiers = mods;
+ int error = grab(self);
+ if (error == 0) return hotkey_reply(TRUE, "", "native", name);
+ return hotkey_reply(FALSE, error == BadAccess ? "in_use" : "grab failed", "native", name);
+ }
+#endif
+ // Wayland:门户只绑一次,之后改键要去系统设置里改
+ if (self->portal) {
+ return hotkey_reply(TRUE, "", "portal", self->portal_trigger != nullptr ? self->portal_trigger : "");
+ }
+ if (enabled && portal_available(self)) {
+ self->portal = TRUE;
+ portal_start(self);
+ return hotkey_reply(TRUE, "", "portal", "");
+ }
+ return hotkey_reply(TRUE, "", "system_shortcut", enabled ? name : "");
+}
+
+struct Commit {
+ PickerApplication* self;
+ FlMethodCall* call;
+ int waited;
+};
+
+#ifdef GDK_WINDOWING_X11
+// 等原来的窗口确实回到前台(最多 300 毫秒),再发粘贴键
+static gboolean commit_tick(gpointer data) {
+ auto* c = static_cast<Commit*>(data);
+ PickerApplication* self = c->self;
+ if (self->previous != 0 && active_window() != self->previous && c->waited < 300) {
+ c->waited += 20;
+ return G_SOURCE_CONTINUE;
+ }
+ send_paste(is_terminal(self->previous));
+ g_autoptr(FlValue) r = fl_value_new_map();
+ fl_value_set_string_take(r, "pasted", fl_value_new_bool(TRUE));
+ fl_value_set_string_take(r, "reason", fl_value_new_string(""));
+ fl_method_call_respond_success(c->call, r, nullptr);
+ g_object_unref(c->call);
+ g_free(c);
+ return G_SOURCE_REMOVE;
+}
+#endif
+
+static void commit(PickerApplication* self, FlMethodCall* call, gboolean paste) {
+ hide(self, FALSE);
+ const gchar* reason = "";
+ if (paste && is_wayland()) reason = "wayland";
+#ifdef GDK_WINDOWING_X11
+ if (is_x11() && self->previous != 0) activate_window(self->previous, self->last_time);
+ if (paste && is_x11()) {
+ auto* c = g_new0(Commit, 1);
+ c->self = self;
+ c->call = FL_METHOD_CALL(g_object_ref(call));
+ g_timeout_add(20, commit_tick, c);
+ return;
+ }
+#endif
+ g_autoptr(FlValue) r = fl_value_new_map();
+ fl_value_set_string_take(r, "pasted", fl_value_new_bool(FALSE));
+ fl_value_set_string_take(r, "reason", fl_value_new_string(reason));
+ fl_method_call_respond_success(call, r, nullptr);
+}
+
+static gboolean lookup_bool(FlValue* args, const gchar* key) {
+ FlValue* v = args != nullptr && fl_value_get_type(args) == FL_VALUE_TYPE_MAP ? fl_value_lookup_string(args, key)
+ : nullptr;
+ return v != nullptr && fl_value_get_type(v) == FL_VALUE_TYPE_BOOL && fl_value_get_bool(v);
+}
+
+static const gchar* lookup_string(FlValue* args, const gchar* key) {
+ FlValue* v = args != nullptr && fl_value_get_type(args) == FL_VALUE_TYPE_MAP ? fl_value_lookup_string(args, key)
+ : nullptr;
+ return v != nullptr && fl_value_get_type(v) == FL_VALUE_TYPE_STRING ? fl_value_get_string(v) : "";
+}
+
+static void respond(FlMethodCall* call, FlValue* value) {
+ fl_method_call_respond_success(call, value, nullptr);
+ if (value != nullptr) fl_value_unref(value);
+}
+
+static void method_call_cb(FlMethodChannel*, FlMethodCall* call, gpointer data) {
+ auto* self = PICKER_APPLICATION(data);
+ const gchar* m = fl_method_call_get_name(call);
+ FlValue* args = fl_method_call_get_args(call);
+ if (g_strcmp0(m, "setHotkey") == 0) {
+ respond(call, set_hotkey(self, lookup_string(args, "hotkey"), lookup_bool(args, "enabled")));
+ } else if (g_strcmp0(m, "setSuspended") == 0) {
+ self->suspended = lookup_bool(args, "suspended");
+#ifdef GDK_WINDOWING_X11
+ if (is_x11()) grab(self);
+#endif
+ respond(call, nullptr);
+ } else if (g_strcmp0(m, "pasteStatus") == 0) {
+ FlValue* r = fl_value_new_map();
+ fl_value_set_string_take(r, "available", fl_value_new_bool(is_x11()));
+ fl_value_set_string_take(r, "reason", fl_value_new_string(is_x11() ? "" : "wayland"));
+ respond(call, r);
+ } else if (g_strcmp0(m, "requestPermission") == 0) {
+ respond(call, nullptr);
+ } else if (g_strcmp0(m, "show") == 0) {
+ show(self, GDK_CURRENT_TIME);
+ respond(call, nullptr);
+ } else if (g_strcmp0(m, "hide") == 0) {
+ hide(self, FALSE);
+#ifdef GDK_WINDOWING_X11
+ if (is_x11() && self->previous != 0) activate_window(self->previous, self->last_time);
+#endif
+ respond(call, nullptr);
+ } else if (g_strcmp0(m, "commit") == 0) {
+ commit(self, call, lookup_bool(args, "paste"));
+ } else if (g_strcmp0(m, "ready") == 0) {
+ self->dart_ready = TRUE;
+ if (self->pending_show || self->toggle_on_ready) {
+ self->pending_show = FALSE;
+ self->toggle_on_ready = FALSE;
+ show(self, GDK_CURRENT_TIME);
+ }
+ respond(call, nullptr);
+ } else if (g_strcmp0(m, "quit") == 0) {
+ respond(call, nullptr);
+ g_application_quit(G_APPLICATION(self));
+ } else {
+ fl_method_call_respond_not_implemented(call, nullptr);
+ }
+}
+
+// ─────────────────────────── GApplication ───────────────────────────
+
+static void create_window(PickerApplication* self) {
+ GtkWindow* window = GTK_WINDOW(gtk_application_window_new(GTK_APPLICATION(self)));
+ self->window = window;
+ gtk_window_set_title(window, "PasteFerry");
+ gtk_window_set_decorated(window, FALSE);
+ gtk_window_set_resizable(window, FALSE);
+ gtk_window_set_skip_taskbar_hint(window, TRUE);
+ gtk_window_set_skip_pager_hint(window, TRUE);
+ gtk_window_set_keep_above(window, TRUE);
+ gtk_window_set_type_hint(window, GDK_WINDOW_TYPE_HINT_DIALOG);
+ gtk_window_set_default_size(window, kWidth, kHeight);
+ gtk_window_set_position(window, GTK_WIN_POS_CENTER);
+ g_signal_connect(window, "focus-out-event", G_CALLBACK(on_focus_out), self);
+ g_signal_connect(window, "delete-event", G_CALLBACK(on_delete), self);
+
+ g_autoptr(FlDartProject) project = fl_dart_project_new();
+ fl_dart_project_set_dart_entrypoint_arguments(project, self->dart_entrypoint_arguments);
+ FlView* view = fl_view_new(project);
+ self->view = view;
+ gtk_widget_set_size_request(GTK_WIDGET(view), kWidth, kHeight);
+ gtk_widget_show(GTK_WIDGET(view));
+ gtk_container_add(GTK_CONTAINER(window), GTK_WIDGET(view));
+ // 平时隐藏:先实现出来让 Flutter 开始渲染,等按快捷键时再显示
+ gtk_widget_realize(GTK_WIDGET(view));
+
+ g_autoptr(FlStandardMethodCodec) codec = fl_standard_method_codec_new();
+ self->channel = fl_method_channel_new(fl_engine_get_binary_messenger(fl_view_get_engine(view)),
+ "pasteferry/picker", FL_METHOD_CODEC(codec));
+ fl_method_channel_set_method_call_handler(self->channel, method_call_cb, self, nullptr);
+
+#ifdef GDK_WINDOWING_X11
+ if (is_x11()) gdk_window_add_filter(nullptr, key_filter, self);
+#endif
+}
+
+static void toggle_action(GSimpleAction*, GVariant*, gpointer data) {
+ auto* self = PICKER_APPLICATION(data);
+ if (self->window == nullptr) {
+ self->toggle_on_ready = TRUE;
+ return;
+ }
+ toggle(self, GDK_CURRENT_TIME);
+}
+
+static void picker_application_activate(GApplication* application) {
+ auto* self = PICKER_APPLICATION(application);
+ if (self->window == nullptr) create_window(self);
+}
+
+static void picker_application_startup(GApplication* application) {
+ G_APPLICATION_CLASS(picker_application_parent_class)->startup(application);
+ // 再次运行 --toggle 时交给已经在运行的这个,见 local_command_line
+ GSimpleAction* action = g_simple_action_new("toggle", nullptr);
+ g_signal_connect(action, "activate", G_CALLBACK(toggle_action), application);
+ g_action_map_add_action(G_ACTION_MAP(application), G_ACTION(action));
+ g_object_unref(action);
+ // 窗口全部隐藏时进程也要留着
+ g_application_hold(application);
+}
+
+static gboolean picker_application_local_command_line(GApplication* application, gchar*** arguments,
+ int* exit_status) {
+ auto* self = PICKER_APPLICATION(application);
+ self->dart_entrypoint_arguments = g_strdupv(*arguments + 1);
+ gboolean toggle_requested = g_strv_contains(const_cast<const gchar* const*>(*arguments), "--toggle");
+
+ g_autoptr(GError) error = nullptr;
+ if (!g_application_register(application, nullptr, &error)) {
+ g_warning("Failed to register: %s", error->message);
+ *exit_status = 1;
+ return TRUE;
+ }
+ if (g_application_get_is_remote(application)) {
+ // 已经有快捷窗口在运行(后台服务拉起的):让它显示或收起,本进程退出
+ if (toggle_requested) g_action_group_activate_action(G_ACTION_GROUP(application), "toggle", nullptr);
+ *exit_status = 0;
+ return TRUE;
+ }
+ self->toggle_on_ready = toggle_requested;
+ g_application_activate(application);
+ *exit_status = 0;
+ // 命令行已经处理完;g_application_run 随后在应用被 hold 期间一直跑主循环(见 startup)
+ return TRUE;
+}
+
+static void picker_application_dispose(GObject* object) {
+ auto* self = PICKER_APPLICATION(object);
+#ifdef GDK_WINDOWING_X11
+ if (is_x11()) {
+ ungrab(self);
+ gdk_window_remove_filter(nullptr, key_filter, self);
+ }
+#endif
+ GDBusConnection* bus = g_application_get_dbus_connection(G_APPLICATION(self));
+ if (bus != nullptr) {
+ if (self->portal_activated_sub != 0) g_dbus_connection_signal_unsubscribe(bus, self->portal_activated_sub);
+ if (self->portal_changed_sub != 0) g_dbus_connection_signal_unsubscribe(bus, self->portal_changed_sub);
+ }
+ self->portal_activated_sub = 0;
+ self->portal_changed_sub = 0;
+ g_clear_object(&self->channel);
+ g_clear_pointer(&self->dart_entrypoint_arguments, g_strfreev);
+ g_clear_pointer(&self->hotkey, g_free);
+ g_clear_pointer(&self->portal_session, g_free);
+ g_clear_pointer(&self->portal_trigger, g_free);
+ G_OBJECT_CLASS(picker_application_parent_class)->dispose(object);
+}
+
+static void picker_application_class_init(PickerApplicationClass* klass) {
+ G_APPLICATION_CLASS(klass)->activate = picker_application_activate;
+ G_APPLICATION_CLASS(klass)->startup = picker_application_startup;
+ G_APPLICATION_CLASS(klass)->local_command_line = picker_application_local_command_line;
+ G_OBJECT_CLASS(klass)->dispose = picker_application_dispose;
+}
+
+static void picker_application_init(PickerApplication* self) {}
+
+PickerApplication* picker_application_new() {
+ return PICKER_APPLICATION(g_object_new(picker_application_get_type(), "application-id", "com.pasteferry.picker",
+ "flags", static_cast<GApplicationFlags>(0), nullptr));
+}
diff --git a/ui/linux/runner/picker_application.h b/ui/linux/runner/picker_application.h
new file mode 100644
index 0000000..5433d00
--- /dev/null
+++ b/ui/linux/runner/picker_application.h
@@ -0,0 +1,14 @@
+#ifndef FLUTTER_PICKER_APPLICATION_H_
+#define FLUTTER_PICKER_APPLICATION_H_
+
+#include <gtk/gtk.h>
+
+// 快捷粘贴窗口:pasteferry --picker 时运行,由后台服务拉起,平时隐藏,按快捷键时出现。
+// 应用 ID 与主界面分开(com.pasteferry.picker),两者互不激活。
+// 再次运行 pasteferry --picker --toggle(Wayland 上系统自定义快捷键用的命令)会交给已经在运行的那个,
+// 由它显示或收起窗口。见 design/quick-paste-and-favorites.md 第 7.3、7.4 节。
+G_DECLARE_FINAL_TYPE(PickerApplication, picker_application, PICKER, APPLICATION, GtkApplication)
+
+PickerApplication* picker_application_new();
+
+#endif // FLUTTER_PICKER_APPLICATION_H_
diff --git a/ui/macos/Picker/main.swift b/ui/macos/Picker/main.swift
new file mode 100644
index 0000000..84d97fd
--- /dev/null
+++ b/ui/macos/Picker/main.swift
@@ -0,0 +1,378 @@
+// PasteFerryPicker:快捷粘贴窗口在 Mac 上的原生外壳。
+//
+// 它是 PasteFerry.app/Contents/Helpers/ 下单独的辅助程序(LSUIElement,不在程序坞出现),
+// 由界面登记的 LaunchAgent(com.pasteferry.picker)拉起。界面代码与主 App 是同一份:
+// Flutter 引擎与编译好的 Dart 代码直接用主 App 的 Contents/Frameworks/,Dart 收到 --picker 参数
+// 就运行快捷窗口。这里只做 Dart 做不了的事:
+// - 全局快捷键(Carbon 的 RegisterEventHotKey,不需要任何权限)
+// - 不抢焦点的窗口(NSPanel + nonactivatingPanel:能接收键盘,原来的 App 一直在前台)
+// - 模拟 ⌘V(CGEvent,需要「辅助功能」权限)
+// 见 design/quick-paste-and-favorites.md 第 6.1、7.1 节。由 scripts/build.sh 用 swiftc 编译。
+
+import ApplicationServices
+import Carbon.HIToolbox
+import Cocoa
+import FlutterMacOS
+
+// ─────────────────────────── 快捷键 ───────────────────────────
+
+/// 把设置里的写法(如 "alt+v",见 ui/lib/hotkey.dart)换成 Carbon 的键码与修饰键。
+enum HotkeySpec {
+ static func parse(_ s: String) -> (key: UInt32, modifiers: UInt32)? {
+ var parts = s.lowercased().split(separator: "+").map(String.init)
+ guard let key = parts.popLast(), let code = keyCode(key) else { return nil }
+ var mods: UInt32 = 0
+ for p in parts {
+ switch p {
+ case "ctrl": mods |= UInt32(controlKey)
+ case "alt": mods |= UInt32(optionKey)
+ case "shift": mods |= UInt32(shiftKey)
+ case "meta": mods |= UInt32(cmdKey)
+ default: return nil
+ }
+ }
+ return (code, mods)
+ }
+
+ static let named: [String: Int] = [
+ "space": kVK_Space, "tab": kVK_Tab, "enter": kVK_Return, "backspace": kVK_Delete,
+ "delete": kVK_ForwardDelete, "home": kVK_Home, "end": kVK_End, "pageup": kVK_PageUp,
+ "pagedown": kVK_PageDown, "up": kVK_UpArrow, "down": kVK_DownArrow, "left": kVK_LeftArrow,
+ "right": kVK_RightArrow,
+ "f1": kVK_F1, "f2": kVK_F2, "f3": kVK_F3, "f4": kVK_F4, "f5": kVK_F5, "f6": kVK_F6,
+ "f7": kVK_F7, "f8": kVK_F8, "f9": kVK_F9, "f10": kVK_F10, "f11": kVK_F11, "f12": kVK_F12,
+ "f13": kVK_F13, "f14": kVK_F14, "f15": kVK_F15, "f16": kVK_F16, "f17": kVK_F17,
+ "f18": kVK_F18, "f19": kVK_F19, "f20": kVK_F20,
+ ]
+
+ static let punctuation: [String: String] = [
+ "comma": ",", "period": ".", "slash": "/", "semicolon": ";", "quote": "'",
+ "bracketleft": "[", "bracketright": "]", "backslash": "\\", "minus": "-", "equal": "=",
+ "backquote": "`",
+ ]
+
+ static func keyCode(_ key: String) -> UInt32? {
+ if let n = named[key] { return UInt32(n) }
+ let ch = punctuation[key] ?? key
+ guard ch.count == 1 else { return nil }
+ return layoutKeyCode(for: ch)
+ }
+
+ /// 按当前键盘布局找到打出 ch 的那个键:Dvorak 等布局下字母的位置与 QWERTY 不同。
+ /// 中文输入法打开时,这里拿到的是它底下的键盘布局(如 ABC)。
+ static func layoutKeyCode(for ch: String) -> UInt32? {
+ guard let source = TISCopyCurrentKeyboardLayoutInputSource()?.takeRetainedValue(),
+ let raw = TISGetInputSourceProperty(source, kTISPropertyUnicodeKeyLayoutData)
+ else { return ansi[ch] }
+ let data = Unmanaged<CFData>.fromOpaque(raw).takeUnretainedValue() as Data
+ let found: UInt32? = data.withUnsafeBytes { buf in
+ guard let layout = buf.bindMemory(to: UCKeyboardLayout.self).baseAddress else { return nil }
+ for code in 0..<128 {
+ var dead: UInt32 = 0
+ var length = 0
+ var chars = [UniChar](repeating: 0, count: 4)
+ let status = UCKeyTranslate(layout, UInt16(code), UInt16(kUCKeyActionDisplay), 0,
+ UInt32(LMGetKbdType()), OptionBits(kUCKeyTranslateNoDeadKeysBit),
+ &dead, chars.count, &length, &chars)
+ if status == noErr, length > 0,
+ String(utf16CodeUnits: chars, count: length).lowercased() == ch {
+ return UInt32(code)
+ }
+ }
+ return nil
+ }
+ return found ?? ansi[ch]
+ }
+
+ static let ansi: [String: UInt32] = {
+ let pairs: [(String, Int)] = [
+ ("a", kVK_ANSI_A), ("b", kVK_ANSI_B), ("c", kVK_ANSI_C), ("d", kVK_ANSI_D), ("e", kVK_ANSI_E),
+ ("f", kVK_ANSI_F), ("g", kVK_ANSI_G), ("h", kVK_ANSI_H), ("i", kVK_ANSI_I), ("j", kVK_ANSI_J),
+ ("k", kVK_ANSI_K), ("l", kVK_ANSI_L), ("m", kVK_ANSI_M), ("n", kVK_ANSI_N), ("o", kVK_ANSI_O),
+ ("p", kVK_ANSI_P), ("q", kVK_ANSI_Q), ("r", kVK_ANSI_R), ("s", kVK_ANSI_S), ("t", kVK_ANSI_T),
+ ("u", kVK_ANSI_U), ("v", kVK_ANSI_V), ("w", kVK_ANSI_W), ("x", kVK_ANSI_X), ("y", kVK_ANSI_Y),
+ ("z", kVK_ANSI_Z), ("0", kVK_ANSI_0), ("1", kVK_ANSI_1), ("2", kVK_ANSI_2), ("3", kVK_ANSI_3),
+ ("4", kVK_ANSI_4), ("5", kVK_ANSI_5), ("6", kVK_ANSI_6), ("7", kVK_ANSI_7), ("8", kVK_ANSI_8),
+ ("9", kVK_ANSI_9), (",", kVK_ANSI_Comma), (".", kVK_ANSI_Period), ("/", kVK_ANSI_Slash),
+ (";", kVK_ANSI_Semicolon), ("'", kVK_ANSI_Quote), ("[", kVK_ANSI_LeftBracket),
+ ("]", kVK_ANSI_RightBracket), ("\\", kVK_ANSI_Backslash), ("-", kVK_ANSI_Minus),
+ ("=", kVK_ANSI_Equal), ("`", kVK_ANSI_Grave),
+ ]
+ return Dictionary(uniqueKeysWithValues: pairs.map { ($0.0, UInt32($0.1)) })
+ }()
+}
+
+/// 一个全局快捷键。Carbon 的回调是 C 函数,按下时转到 onPress。
+final class GlobalHotkey {
+ static let shared = GlobalHotkey()
+ var onPress: (() -> Void)?
+ private var ref: EventHotKeyRef?
+ private var installed = false
+
+ func register(key: UInt32, modifiers: UInt32) -> OSStatus {
+ unregister()
+ if !installed {
+ var spec = EventTypeSpec(eventClass: OSType(kEventClassKeyboard), eventKind: UInt32(kEventHotKeyPressed))
+ let status = InstallEventHandler(GetApplicationEventTarget(), { _, _, _ in
+ DispatchQueue.main.async { GlobalHotkey.shared.onPress?() }
+ return noErr
+ }, 1, &spec, nil, nil)
+ if status != noErr { NSLog("安装快捷键回调失败:%d", status) }
+ installed = true
+ }
+ let id = EventHotKeyID(signature: OSType(0x5046_5153), id: 1) // 'PFQS'
+ return RegisterEventHotKey(key, modifiers, id, GetApplicationEventTarget(), 0, &ref)
+ }
+
+ func unregister() {
+ if let ref { UnregisterEventHotKey(ref) }
+ ref = nil
+ }
+}
+
+// ─────────────────────────── 窗口 ───────────────────────────
+
+/// 无边框、不抢焦点的面板:能成为接收键盘的窗口,但不会把隔空贴激活到前台。
+final class PickerPanel: NSPanel {
+ override var canBecomeKey: Bool { true }
+ override var canBecomeMain: Bool { false }
+}
+
+final class PickerController: NSObject, NSWindowDelegate {
+ static let size = NSSize(width: 560, height: 460)
+
+ let engine: FlutterEngine
+ let flutter: FlutterViewController
+ let panel: PickerPanel
+ let channel: FlutterMethodChannel
+
+ private var dartReady = false
+ private var pendingShow = false
+ private var suspended = false
+ private var hotkey: (key: UInt32, modifiers: UInt32)?
+ private var hotkeyName = ""
+ /// 呼出时在前台的 App:粘贴时确认焦点回到了它
+ private var previousApp: NSRunningApplication?
+
+ init(project: FlutterDartProject) {
+ engine = FlutterEngine(name: "picker", project: project)
+ engine.run(withEntrypoint: nil)
+ flutter = FlutterViewController(engine: engine, nibName: nil, bundle: nil)
+ flutter.backgroundColor = .clear
+ flutter.mouseTrackingMode = .always
+ panel = PickerPanel(contentRect: NSRect(origin: .zero, size: Self.size),
+ styleMask: [.borderless, .nonactivatingPanel], backing: .buffered, defer: false)
+ channel = FlutterMethodChannel(name: "pasteferry/picker", binaryMessenger: engine.binaryMessenger)
+ super.init()
+
+ panel.contentViewController = flutter
+ panel.setContentSize(Self.size)
+ panel.isOpaque = false
+ panel.backgroundColor = .clear
+ panel.hasShadow = true
+ panel.level = .floating
+ panel.hidesOnDeactivate = false
+ panel.isMovableByWindowBackground = false
+ // 每个桌面空间里都能呼出,全屏 App 上面也能出现
+ panel.collectionBehavior = [.canJoinAllSpaces, .fullScreenAuxiliary, .transient, .ignoresCycle]
+ panel.delegate = self
+
+ channel.setMethodCallHandler { [weak self] call, result in self?.handle(call, result) }
+ GlobalHotkey.shared.onPress = { [weak self] in self?.toggle() }
+ }
+
+ // ── Dart → 原生 ──
+
+ private func handle(_ call: FlutterMethodCall, _ result: @escaping FlutterResult) {
+ let args = call.arguments as? [String: Any] ?? [:]
+ switch call.method {
+ case "setHotkey":
+ result(setHotkey(args["hotkey"] as? String ?? "", enabled: args["enabled"] as? Bool ?? false))
+ case "setSuspended":
+ suspended = args["suspended"] as? Bool ?? false
+ applyHotkey()
+ result(nil)
+ case "pasteStatus":
+ let trusted = AXIsProcessTrusted()
+ result(["available": trusted, "reason": trusted ? "" : "not_trusted"])
+ case "requestPermission":
+ requestAccessibility()
+ result(nil)
+ case "show":
+ show()
+ result(nil)
+ case "hide":
+ hide(notify: false)
+ result(nil)
+ case "commit":
+ commit(paste: args["paste"] as? Bool ?? false, result)
+ case "ready":
+ dartReady = true
+ NSLog("快捷粘贴窗口已就绪")
+ if pendingShow { pendingShow = false; show() }
+ result(nil)
+ case "quit":
+ GlobalHotkey.shared.unregister()
+ result(nil)
+ DispatchQueue.main.async { exit(0) }
+ default:
+ result(FlutterMethodNotImplemented)
+ }
+ }
+
+ private func setHotkey(_ name: String, enabled: Bool) -> [String: Any] {
+ guard enabled else {
+ hotkey = nil
+ hotkeyName = ""
+ GlobalHotkey.shared.unregister()
+ return ["ok": true, "error": "", "source": "native", "hotkey": ""]
+ }
+ guard let spec = HotkeySpec.parse(name) else {
+ return ["ok": false, "error": "invalid", "source": "native", "hotkey": name]
+ }
+ hotkey = spec
+ hotkeyName = name
+ let status = applyHotkey()
+ if status == noErr {
+ NSLog("快捷键 %@ 已注册", name)
+ return ["ok": true, "error": "", "source": "native", "hotkey": name]
+ }
+ let error = status == OSStatus(eventHotKeyExistsErr) ? "in_use" : "\(status)"
+ return ["ok": false, "error": error, "source": "native", "hotkey": name]
+ }
+
+ @discardableResult
+ private func applyHotkey() -> OSStatus {
+ guard let hotkey, !suspended else {
+ GlobalHotkey.shared.unregister()
+ return noErr
+ }
+ let status = GlobalHotkey.shared.register(key: hotkey.key, modifiers: hotkey.modifiers)
+ if status != noErr { NSLog("注册快捷键 %@ 失败:%d", hotkeyName, status) }
+ return status
+ }
+
+ /// 第一次请求时系统弹窗并把快捷窗口加进「辅助功能」列表;之后再请求只能打开系统设置让用户自己开。
+ private func requestAccessibility() {
+ let key = "accessibilityPrompted"
+ if !UserDefaults.standard.bool(forKey: key) {
+ UserDefaults.standard.set(true, forKey: key)
+ let options = [kAXTrustedCheckOptionPrompt.takeUnretainedValue() as String: true] as CFDictionary
+ _ = AXIsProcessTrustedWithOptions(options)
+ return
+ }
+ if let url = URL(string: "x-apple.systempreferences:com.apple.preference.security?Privacy_Accessibility") {
+ NSWorkspace.shared.open(url)
+ }
+ }
+
+ // ── 显示与隐藏 ──
+
+ private func toggle() {
+ if panel.isVisible { hide(notify: true) } else { show() }
+ }
+
+ private func show() {
+ guard dartReady else { pendingShow = true; return }
+ let front = NSWorkspace.shared.frontmostApplication
+ if front?.processIdentifier != ProcessInfo.processInfo.processIdentifier { previousApp = front }
+ place()
+ channel.invokeMethod("onShow", arguments: nil)
+ panel.makeKeyAndOrderFront(nil)
+ panel.makeFirstResponder(flutter.view)
+ panel.invalidateShadow()
+ NSLog("呼出快捷窗口,原来在前台的是 %@,窗口 key=%d", previousApp?.localizedName ?? "-", panel.isKeyWindow ? 1 : 0)
+ }
+
+ /// 鼠标所在屏幕的中上方,与聚焦搜索的位置一样。
+ private func place() {
+ let mouse = NSEvent.mouseLocation
+ let screen = NSScreen.screens.first { NSMouseInRect(mouse, $0.frame, false) } ?? NSScreen.main
+ guard let area = screen?.visibleFrame else { return }
+ let x = area.midX - Self.size.width / 2
+ let y = area.maxY - area.height * 0.22 - Self.size.height
+ panel.setFrameOrigin(NSPoint(x: x.rounded(), y: max(area.minY, y).rounded()))
+ }
+
+ private func hide(notify: Bool) {
+ guard panel.isVisible else { return }
+ panel.orderOut(nil)
+ if notify { channel.invokeMethod("onHide", arguments: nil) }
+ }
+
+ /// 点了窗口外面、切到别的 App:收起,什么都不粘贴。
+ func windowDidResignKey(_ notification: Notification) {
+ if panel.isVisible { NSLog("快捷窗口失去焦点,收起") }
+ hide(notify: true)
+ }
+
+ // ── 粘贴 ──
+
+ /// 收起窗口,焦点回到原来的 App(面板不抢焦点,原来的 App 本来就还在前台),再模拟 ⌘V。
+ private func commit(paste: Bool, _ result: @escaping FlutterResult) {
+ let target = previousApp
+ hide(notify: false)
+ guard paste else { result(["pasted": false, "reason": ""]); return }
+ guard AXIsProcessTrusted() else { result(["pasted": false, "reason": "not_trusted"]); return }
+ if let target, NSWorkspace.shared.frontmostApplication != target {
+ target.activate()
+ }
+ waitFor(target, deadline: Date().addingTimeInterval(0.3)) {
+ Self.postPaste()
+ result(["pasted": true, "reason": ""])
+ }
+ }
+
+ /// 等目标 App 确实回到前台,最多等到 deadline;面板收起后键盘焦点要一小会儿才交回去。
+ private func waitFor(_ app: NSRunningApplication?, deadline: Date, then: @escaping () -> Void) {
+ let ready = app == nil || NSWorkspace.shared.frontmostApplication == app
+ if ready || Date() > deadline {
+ DispatchQueue.main.asyncAfter(deadline: .now() + 0.05, execute: then)
+ return
+ }
+ DispatchQueue.main.asyncAfter(deadline: .now() + 0.02) { self.waitFor(app, deadline: deadline, then: then) }
+ }
+
+ /// 发一次 ⌘V。标志位只设 ⌘:用户还按着 ⌥ 时也不带进去。键码按当前键盘布局找「v」。
+ static func postPaste() {
+ let v = CGKeyCode(HotkeySpec.layoutKeyCode(for: "v") ?? UInt32(kVK_ANSI_V))
+ let source = CGEventSource(stateID: .combinedSessionState)
+ for down in [true, false] {
+ guard let e = CGEvent(keyboardEventSource: source, virtualKey: v, keyDown: down) else { continue }
+ e.flags = .maskCommand
+ e.post(tap: .cghidEventTap)
+ }
+ }
+}
+
+// ─────────────────────────── 启动 ───────────────────────────
+
+final class PickerApp: NSObject, NSApplicationDelegate {
+ var controller: PickerController?
+
+ func applicationDidFinishLaunching(_ notification: Notification) {
+ // 只运行一个:LaunchAgent 之外又被拉起一次时,让先启动的那个继续
+ let me = ProcessInfo.processInfo.processIdentifier
+ let others = NSRunningApplication.runningApplications(withBundleIdentifier: Bundle.main.bundleIdentifier ?? "")
+ if others.contains(where: { $0.processIdentifier != me }) {
+ NSLog("已有快捷粘贴窗口在运行,本进程退出")
+ exit(0)
+ }
+ // …/PasteFerry.app/Contents/Helpers/PasteFerryPicker.app → …/PasteFerry.app
+ let mainApp = Bundle.main.bundleURL.deletingLastPathComponent().deletingLastPathComponent().deletingLastPathComponent()
+ let appFramework = mainApp.appendingPathComponent("Contents/Frameworks/App.framework")
+ guard let dart = Bundle(url: appFramework) else {
+ NSLog("找不到 %@,快捷粘贴窗口要放在 PasteFerry.app 里面运行", appFramework.path)
+ exit(1)
+ }
+ let project = FlutterDartProject(precompiledDartBundle: dart)
+ project.dartEntrypointArguments = ["--picker"]
+ controller = PickerController(project: project)
+ }
+}
+
+let app = NSApplication.shared
+app.setActivationPolicy(.accessory)
+let delegate = PickerApp()
+app.delegate = delegate
+app.run()
diff --git a/ui/windows/runner/CMakeLists.txt b/ui/windows/runner/CMakeLists.txt
index 394917c..efb159c 100644
--- a/ui/windows/runner/CMakeLists.txt
+++ b/ui/windows/runner/CMakeLists.txt
@@ -8,6 +8,7 @@ project(runner LANGUAGES CXX)
# Any new source files that you add to the application should be added here.
add_executable(${BINARY_NAME} WIN32
"flutter_window.cpp"
+ "picker_window.cpp"
"main.cpp"
"utils.cpp"
"win32_window.cpp"
diff --git a/ui/windows/runner/main.cpp b/ui/windows/runner/main.cpp
index e577a45..1d9e80a 100644
--- a/ui/windows/runner/main.cpp
+++ b/ui/windows/runner/main.cpp
@@ -6,10 +6,50 @@
#include <algorithm>
#include "flutter_window.h"
+#include "picker_window.h"
#include "utils.h"
+namespace {
+
+// PasteFerry.exe --picker:快捷粘贴窗口,由后台服务拉起,平时隐藏,按快捷键时出现。
+// 与主界面是同一个程序、同一份 Dart 代码(Dart 看到 --picker 就运行快捷窗口),
+// 但单实例互斥量与窗口类各用各的,互不影响。见 picker_window.h
+int RunPicker(const std::vector<std::string>& args) {
+ HANDLE single_instance = ::CreateMutexW(nullptr, TRUE, L"Local\\PasteFerry.Picker");
+ if (::GetLastError() == ERROR_ALREADY_EXISTS) {
+ return EXIT_SUCCESS;
+ }
+ ::CoInitializeEx(nullptr, COINIT_APARTMENTTHREADED);
+ flutter::DartProject project(L"data");
+ project.set_dart_entrypoint_arguments(args);
+ int code = EXIT_FAILURE;
+ {
+ PickerWindow window(project);
+ if (window.Create()) {
+ ::MSG msg;
+ while (::GetMessage(&msg, nullptr, 0, 0)) {
+ ::TranslateMessage(&msg);
+ ::DispatchMessage(&msg);
+ }
+ code = EXIT_SUCCESS;
+ }
+ }
+ ::CoUninitialize();
+ ::CloseHandle(single_instance);
+ return code;
+}
+
+} // namespace
+
int APIENTRY wWinMain(_In_ HINSTANCE instance, _In_opt_ HINSTANCE prev,
_In_ wchar_t *command_line, _In_ int show_command) {
+ {
+ std::vector<std::string> args = GetCommandLineArguments();
+ if (std::find(args.begin(), args.end(), "--picker") != args.end()) {
+ return RunPicker(args);
+ }
+ }
+
// 只开一个窗口:再次打开时把已有的窗口提到前面,与 Mac 上点 Dock 图标一致
HANDLE single_instance = ::CreateMutexW(nullptr, TRUE, L"Local\\PasteFerry.UI");
if (::GetLastError() == ERROR_ALREADY_EXISTS) {
diff --git a/ui/windows/runner/picker_window.cpp b/ui/windows/runner/picker_window.cpp
new file mode 100644
index 0000000..805615d
--- /dev/null
+++ b/ui/windows/runner/picker_window.cpp
@@ -0,0 +1,407 @@
+#include "picker_window.h"
+
+#include <dwmapi.h>
+#include <flutter/standard_method_codec.h>
+#include <flutter_windows.h>
+
+#include <algorithm>
+#include <cctype>
+#include <map>
+#include <vector>
+
+namespace {
+
+constexpr wchar_t kWindowClass[] = L"PASTEFERRY_PICKER_WINDOW";
+// 不能叫「PasteFerry」:主程序再次打开时按这个标题找已有的主窗口(见 main.cpp)
+constexpr wchar_t kWindowTitle[] = L"PasteFerry Quick Paste";
+constexpr int kWidth = 560;
+constexpr int kHeight = 460;
+constexpr int kHotkeyId = 1;
+
+#ifndef DWMWA_WINDOW_CORNER_PREFERENCE
+#define DWMWA_WINDOW_CORNER_PREFERENCE 33
+#endif
+constexpr int kDwmRound = 2; // DWMWCP_ROUND
+
+using flutter::EncodableMap;
+using flutter::EncodableValue;
+
+EncodableValue Str(const char* s) { return EncodableValue(std::string(s)); }
+
+const EncodableValue* Arg(const flutter::MethodCall<EncodableValue>& call, const char* key) {
+ const auto* map = std::get_if<EncodableMap>(call.arguments());
+ if (!map) return nullptr;
+ auto it = map->find(Str(key));
+ return it == map->end() ? nullptr : &it->second;
+}
+
+bool BoolArg(const flutter::MethodCall<EncodableValue>& call, const char* key) {
+ const auto* v = Arg(call, key);
+ const auto* b = v ? std::get_if<bool>(v) : nullptr;
+ return b && *b;
+}
+
+std::string StringArg(const flutter::MethodCall<EncodableValue>& call, const char* key) {
+ const auto* v = Arg(call, key);
+ const auto* s = v ? std::get_if<std::string>(v) : nullptr;
+ return s ? *s : std::string();
+}
+
+// 设置里的写法(如 "alt+v",见 lib/hotkey.dart)→ RegisterHotKey 的修饰键与虚拟键码。
+bool ParseHotkey(const std::string& name, UINT* modifiers, UINT* vk) {
+ std::vector<std::string> parts;
+ size_t start = 0;
+ while (true) {
+ size_t plus = name.find('+', start);
+ parts.push_back(name.substr(start, plus == std::string::npos ? std::string::npos : plus - start));
+ if (plus == std::string::npos) break;
+ start = plus + 1;
+ }
+ if (parts.empty()) return false;
+ const std::string key = parts.back();
+ parts.pop_back();
+ UINT mods = MOD_NOREPEAT;
+ for (const auto& p : parts) {
+ if (p == "ctrl") mods |= MOD_CONTROL;
+ else if (p == "alt") mods |= MOD_ALT;
+ else if (p == "shift") mods |= MOD_SHIFT;
+ else if (p == "meta") mods |= MOD_WIN;
+ else return false;
+ }
+ static const std::map<std::string, UINT> named = {
+ {"space", VK_SPACE}, {"tab", VK_TAB}, {"enter", VK_RETURN}, {"backspace", VK_BACK},
+ {"delete", VK_DELETE}, {"insert", VK_INSERT}, {"home", VK_HOME}, {"end", VK_END},
+ {"pageup", VK_PRIOR}, {"pagedown", VK_NEXT}, {"up", VK_UP}, {"down", VK_DOWN},
+ {"left", VK_LEFT}, {"right", VK_RIGHT},
+ };
+ static const std::map<std::string, wchar_t> punctuation = {
+ {"comma", L','}, {"period", L'.'}, {"slash", L'/'}, {"semicolon", L';'}, {"quote", L'\''},
+ {"bracketleft", L'['}, {"bracketright", L']'}, {"backslash", L'\\'}, {"minus", L'-'},
+ {"equal", L'='}, {"backquote", L'`'},
+ };
+ UINT code = 0;
+ if (key.size() == 1 && key[0] >= 'a' && key[0] <= 'z') {
+ code = 'A' + (key[0] - 'a');
+ } else if (key.size() == 1 && key[0] >= '0' && key[0] <= '9') {
+ code = key[0];
+ } else if (key.size() >= 2 && key.size() <= 3 && key[0] == 'f' &&
+ std::all_of(key.begin() + 1, key.end(), [](char c) { return std::isdigit(static_cast<unsigned char>(c)) != 0; })) {
+ int n = std::stoi(key.substr(1));
+ if (n < 1 || n > 24) return false;
+ code = VK_F1 + n - 1;
+ } else if (auto it = named.find(key); it != named.end()) {
+ code = it->second;
+ } else if (auto pit = punctuation.find(key); pit != punctuation.end()) {
+ // 标点在不同键盘布局上的位置不同,按当前布局查
+ SHORT scan = ::VkKeyScanW(pit->second);
+ if (scan == -1) return false;
+ code = LOBYTE(scan);
+ } else {
+ return false;
+ }
+ *modifiers = mods;
+ *vk = code;
+ return true;
+}
+
+// 目标窗口所在的进程是否以管理员身份运行。普通权限的程序发不了按键给它(UIPI),而且 SendInput 不报错。
+bool IsElevatedWindow(HWND hwnd) {
+ DWORD pid = 0;
+ ::GetWindowThreadProcessId(hwnd, &pid);
+ if (!pid) return false;
+ HANDLE process = ::OpenProcess(PROCESS_QUERY_LIMITED_INFORMATION, FALSE, pid);
+ if (!process) return ::GetLastError() == ERROR_ACCESS_DENIED;
+ bool elevated = false;
+ HANDLE token = nullptr;
+ if (::OpenProcessToken(process, TOKEN_QUERY, &token)) {
+ TOKEN_ELEVATION info{};
+ DWORD size = 0;
+ if (::GetTokenInformation(token, TokenElevation, &info, sizeof(info), &size)) {
+ elevated = info.TokenIsElevated != 0;
+ }
+ ::CloseHandle(token);
+ } else {
+ elevated = ::GetLastError() == ERROR_ACCESS_DENIED;
+ }
+ ::CloseHandle(process);
+ return elevated;
+}
+
+bool SelfElevated() {
+ HANDLE token = nullptr;
+ if (!::OpenProcessToken(::GetCurrentProcess(), TOKEN_QUERY, &token)) return false;
+ TOKEN_ELEVATION info{};
+ DWORD size = 0;
+ bool elevated = ::GetTokenInformation(token, TokenElevation, &info, sizeof(info), &size) &&
+ info.TokenIsElevated != 0;
+ ::CloseHandle(token);
+ return elevated;
+}
+
+INPUT Key(WORD vk, bool up) {
+ INPUT in{};
+ in.type = INPUT_KEYBOARD;
+ in.ki.wVk = vk;
+ in.ki.dwFlags = up ? KEYEVENTF_KEYUP : 0;
+ return in;
+}
+
+// 发一次 Ctrl+V。用户还按着修饰键(比如用 Alt+数字 选的)时先松开:
+// 单独松开 Alt 或 Win 会让目标程序打开菜单或开始菜单,所以先插一个没有作用的按键(AutoHotkey 的做法)。
+void SendPaste() {
+ std::vector<INPUT> inputs;
+ const bool alt = ::GetAsyncKeyState(VK_MENU) & 0x8000;
+ const bool win = (::GetAsyncKeyState(VK_LWIN) & 0x8000) || (::GetAsyncKeyState(VK_RWIN) & 0x8000);
+ if (alt || win) {
+ constexpr WORD kMask = 0xE8; // 未分配的虚拟键码
+ inputs.push_back(Key(kMask, false));
+ inputs.push_back(Key(kMask, true));
+ }
+ if (alt) inputs.push_back(Key(VK_MENU, true));
+ if (::GetAsyncKeyState(VK_LWIN) & 0x8000) inputs.push_back(Key(VK_LWIN, true));
+ if (::GetAsyncKeyState(VK_RWIN) & 0x8000) inputs.push_back(Key(VK_RWIN, true));
+ if (::GetAsyncKeyState(VK_SHIFT) & 0x8000) inputs.push_back(Key(VK_SHIFT, true));
+ inputs.push_back(Key(VK_CONTROL, false));
+ inputs.push_back(Key('V', false));
+ inputs.push_back(Key('V', true));
+ inputs.push_back(Key(VK_CONTROL, true));
+ ::SendInput(static_cast<UINT>(inputs.size()), inputs.data(), sizeof(INPUT));
+}
+
+// 把窗口切到前台。刚收到快捷键的进程本来就有这个权限;从命令(设置页的按钮)呼出时没有,
+// 借前台窗口的输入队列一用。
+void BringToFront(HWND hwnd) {
+ if (::SetForegroundWindow(hwnd)) return;
+ HWND fg = ::GetForegroundWindow();
+ DWORD fg_thread = fg ? ::GetWindowThreadProcessId(fg, nullptr) : 0;
+ DWORD me = ::GetCurrentThreadId();
+ if (fg_thread && fg_thread != me) ::AttachThreadInput(me, fg_thread, TRUE);
+ ::BringWindowToTop(hwnd);
+ ::SetForegroundWindow(hwnd);
+ if (fg_thread && fg_thread != me) ::AttachThreadInput(me, fg_thread, FALSE);
+}
+
+} // namespace
+
+PickerWindow::PickerWindow(const flutter::DartProject& project) : project_(project) {}
+
+PickerWindow::~PickerWindow() {
+ if (registered_) ::UnregisterHotKey(hwnd_, kHotkeyId);
+ channel_ = nullptr;
+ controller_ = nullptr;
+ if (hwnd_) ::DestroyWindow(hwnd_);
+}
+
+bool PickerWindow::Create() {
+ WNDCLASSEXW wc{sizeof(wc)};
+ wc.lpfnWndProc = WndProc;
+ wc.hInstance = ::GetModuleHandleW(nullptr);
+ wc.hCursor = ::LoadCursor(nullptr, IDC_ARROW);
+ wc.hIcon = ::LoadIcon(wc.hInstance, MAKEINTRESOURCE(101));
+ wc.lpszClassName = kWindowClass;
+ ::RegisterClassExW(&wc);
+
+ const double scale = FlutterDesktopGetDpiForMonitor(::MonitorFromPoint({0, 0}, MONITOR_DEFAULTTOPRIMARY)) / 96.0;
+ const int w = static_cast<int>(kWidth * scale);
+ const int h = static_cast<int>(kHeight * scale);
+ hwnd_ = ::CreateWindowExW(WS_EX_TOOLWINDOW | WS_EX_TOPMOST, kWindowClass, kWindowTitle,
+ WS_POPUP | WS_CLIPCHILDREN, 0, 0, w, h, nullptr, nullptr, wc.hInstance, this);
+ if (!hwnd_) return false;
+ // Windows 11 上让系统画圆角;Windows 10 上没有这个属性,保持直角
+ int corner = kDwmRound;
+ ::DwmSetWindowAttribute(hwnd_, DWMWA_WINDOW_CORNER_PREFERENCE, &corner, sizeof(corner));
+
+ controller_ = std::make_unique<flutter::FlutterViewController>(w, h, project_);
+ if (!controller_->engine() || !controller_->view()) return false;
+ HWND view = controller_->view()->GetNativeWindow();
+ ::SetParent(view, hwnd_);
+ ResizeChild();
+
+ channel_ = std::make_unique<flutter::MethodChannel<EncodableValue>>(
+ controller_->engine()->messenger(), "pasteferry/picker", &flutter::StandardMethodCodec::GetInstance());
+ channel_->SetMethodCallHandler(
+ [this](const auto& call, auto result) { HandleMethodCall(call, std::move(result)); });
+ return true;
+}
+
+LRESULT CALLBACK PickerWindow::WndProc(HWND hwnd, UINT message, WPARAM wparam, LPARAM lparam) {
+ if (message == WM_NCCREATE) {
+ auto* cs = reinterpret_cast<CREATESTRUCT*>(lparam);
+ ::SetWindowLongPtr(hwnd, GWLP_USERDATA, reinterpret_cast<LONG_PTR>(cs->lpCreateParams));
+ }
+ auto* self = reinterpret_cast<PickerWindow*>(::GetWindowLongPtr(hwnd, GWLP_USERDATA));
+ if (self) return self->HandleMessage(hwnd, message, wparam, lparam);
+ return ::DefWindowProc(hwnd, message, wparam, lparam);
+}
+
+LRESULT PickerWindow::HandleMessage(HWND hwnd, UINT message, WPARAM wparam, LPARAM lparam) {
+ if (controller_) {
+ if (auto handled = controller_->HandleTopLevelWindowProc(hwnd, message, wparam, lparam)) return *handled;
+ }
+ switch (message) {
+ case WM_HOTKEY:
+ if (wparam == kHotkeyId) Toggle();
+ return 0;
+ case WM_ACTIVATE:
+ // 点了窗口外面、切到别的程序:收起,什么都不粘贴
+ if (LOWORD(wparam) == WA_INACTIVE && ::IsWindowVisible(hwnd)) Hide(true, false);
+ return 0;
+ case WM_SIZE:
+ ResizeChild();
+ return 0;
+ case WM_DPICHANGED: {
+ auto* r = reinterpret_cast<RECT*>(lparam);
+ ::SetWindowPos(hwnd, nullptr, r->left, r->top, r->right - r->left, r->bottom - r->top,
+ SWP_NOZORDER | SWP_NOACTIVATE);
+ return 0;
+ }
+ case WM_FONTCHANGE:
+ if (controller_) controller_->engine()->ReloadSystemFonts();
+ break;
+ case WM_CLOSE:
+ // Alt+F4 只是收起,进程留着等下一次快捷键
+ Hide(true, true);
+ return 0;
+ case WM_DESTROY:
+ hwnd_ = nullptr;
+ ::PostQuitMessage(0);
+ return 0;
+ }
+ return ::DefWindowProc(hwnd, message, wparam, lparam);
+}
+
+void PickerWindow::ResizeChild() {
+ if (!controller_ || !hwnd_) return;
+ RECT r;
+ ::GetClientRect(hwnd_, &r);
+ ::MoveWindow(controller_->view()->GetNativeWindow(), 0, 0, r.right - r.left, r.bottom - r.top, TRUE);
+}
+
+void PickerWindow::HandleMethodCall(const flutter::MethodCall<EncodableValue>& call, Result result) {
+ const auto& m = call.method_name();
+ if (m == "setHotkey") {
+ result->Success(EncodableValue(SetHotkey(StringArg(call, "hotkey"), BoolArg(call, "enabled"))));
+ } else if (m == "setSuspended") {
+ suspended_ = BoolArg(call, "suspended");
+ ApplyHotkey();
+ result->Success();
+ } else if (m == "pasteStatus") {
+ result->Success(EncodableValue(EncodableMap{{Str("available"), EncodableValue(true)}, {Str("reason"), Str("")}}));
+ } else if (m == "requestPermission") {
+ result->Success(); // Windows 不需要授权
+ } else if (m == "show") {
+ Show();
+ result->Success();
+ } else if (m == "hide") {
+ Hide(false, true);
+ result->Success();
+ } else if (m == "commit") {
+ Commit(BoolArg(call, "paste"), std::move(result));
+ } else if (m == "ready") {
+ dart_ready_ = true;
+ if (pending_show_) {
+ pending_show_ = false;
+ Show();
+ }
+ result->Success();
+ } else if (m == "quit") {
+ // 关掉了快捷粘贴:结束消息循环,进程正常退出,后台服务不再拉起它
+ result->Success();
+ ::PostQuitMessage(0);
+ } else {
+ result->NotImplemented();
+ }
+}
+
+EncodableMap PickerWindow::SetHotkey(const std::string& name, bool enabled) {
+ auto reply = [&](bool ok, const std::string& error) {
+ return EncodableMap{{Str("ok"), EncodableValue(ok)},
+ {Str("error"), EncodableValue(error)},
+ {Str("source"), Str("native")},
+ {Str("hotkey"), EncodableValue(enabled ? name : std::string())}};
+ };
+ if (!enabled) {
+ has_hotkey_ = false;
+ ApplyHotkey();
+ return reply(true, "");
+ }
+ UINT mods = 0, vk = 0;
+ if (!ParseHotkey(name, &mods, &vk)) return reply(false, "invalid");
+ has_hotkey_ = true;
+ modifiers_ = mods;
+ vk_ = vk;
+ if (ApplyHotkey()) return reply(true, "");
+ return reply(false, hotkey_error_ == ERROR_HOTKEY_ALREADY_REGISTERED ? "in_use" : std::to_string(hotkey_error_));
+}
+
+bool PickerWindow::ApplyHotkey() {
+ if (registered_) {
+ ::UnregisterHotKey(hwnd_, kHotkeyId);
+ registered_ = false;
+ }
+ hotkey_error_ = 0;
+ if (!has_hotkey_ || suspended_) return true;
+ registered_ = ::RegisterHotKey(hwnd_, kHotkeyId, modifiers_, vk_) != 0;
+ if (!registered_) hotkey_error_ = ::GetLastError();
+ return registered_;
+}
+
+void PickerWindow::Toggle() {
+ if (::IsWindowVisible(hwnd_)) {
+ Hide(true, true);
+ } else {
+ Show();
+ }
+}
+
+void PickerWindow::Show() {
+ if (!dart_ready_) {
+ pending_show_ = true;
+ return;
+ }
+ HWND fg = ::GetForegroundWindow();
+ if (fg && fg != hwnd_) previous_ = fg;
+ Place();
+ channel_->InvokeMethod("onShow", nullptr);
+ ::ShowWindow(hwnd_, SW_SHOW);
+ BringToFront(hwnd_);
+ ::SetFocus(controller_->view()->GetNativeWindow());
+}
+
+// 鼠标所在屏幕的中上方。
+void PickerWindow::Place() {
+ POINT cursor;
+ ::GetCursorPos(&cursor);
+ HMONITOR monitor = ::MonitorFromPoint(cursor, MONITOR_DEFAULTTONEAREST);
+ MONITORINFO info{sizeof(info)};
+ ::GetMonitorInfo(monitor, &info);
+ const double scale = FlutterDesktopGetDpiForMonitor(monitor) / 96.0;
+ const int w = static_cast<int>(kWidth * scale);
+ const int h = static_cast<int>(kHeight * scale);
+ const RECT& work = info.rcWork;
+ const int x = work.left + (work.right - work.left - w) / 2;
+ const int y = work.top + static_cast<int>((work.bottom - work.top) * 0.22);
+ ::SetWindowPos(hwnd_, HWND_TOPMOST, x, std::min<int>(y, work.bottom - h), w, h, SWP_NOACTIVATE);
+}
+
+void PickerWindow::Hide(bool notify, bool restore) {
+ if (!::IsWindowVisible(hwnd_)) return;
+ ::ShowWindow(hwnd_, SW_HIDE);
+ if (restore && previous_ && ::IsWindow(previous_)) ::SetForegroundWindow(previous_);
+ if (notify) channel_->InvokeMethod("onHide", nullptr);
+}
+
+void PickerWindow::Commit(bool paste, Result result) {
+ HWND target = previous_;
+ Hide(false, true);
+ auto reply = [&](bool pasted, const char* reason) {
+ result->Success(EncodableValue(EncodableMap{{Str("pasted"), EncodableValue(pasted)}, {Str("reason"), Str(reason)}}));
+ };
+ if (!paste) return reply(false, "");
+ if (target && IsElevatedWindow(target) && !SelfElevated()) return reply(false, "elevated");
+ // 等目标窗口确实回到前台,最多 300 毫秒
+ for (int i = 0; i < 20 && target && ::GetForegroundWindow() != target; i++) ::Sleep(15);
+ ::Sleep(30);
+ SendPaste();
+ reply(true, "");
+}
diff --git a/ui/windows/runner/picker_window.h b/ui/windows/runner/picker_window.h
new file mode 100644
index 0000000..61c0525
--- /dev/null
+++ b/ui/windows/runner/picker_window.h
@@ -0,0 +1,63 @@
+#ifndef RUNNER_PICKER_WINDOW_H_
+#define RUNNER_PICKER_WINDOW_H_
+
+#include <flutter/dart_project.h>
+#include <flutter/encodable_value.h>
+#include <flutter/flutter_view_controller.h>
+#include <flutter/method_channel.h>
+#include <windows.h>
+
+#include <memory>
+#include <string>
+
+// 快捷粘贴窗口:PasteFerry.exe --picker 时运行的那个窗口,由后台服务拉起并照看。
+//
+// 无边框弹出窗口,不进任务栏也不进 Alt+Tab,平时隐藏。全局快捷键(RegisterHotKey)按下时
+// 记下当前的前台窗口再显示出来;选中一条后隐藏、把焦点还给原来的窗口,再用 SendInput 发 Ctrl+V。
+// 列表与按键都在 Dart 里(lib/picker/),这里只做 Dart 做不了的事。
+// 与 Mac、Linux 的外壳用同一个通道 pasteferry/picker,方法见 lib/picker/picker_host.dart。
+class PickerWindow {
+ public:
+ explicit PickerWindow(const flutter::DartProject& project);
+ ~PickerWindow();
+
+ PickerWindow(const PickerWindow&) = delete;
+ PickerWindow& operator=(const PickerWindow&) = delete;
+
+ bool Create();
+
+ private:
+ using Result = std::unique_ptr<flutter::MethodResult<flutter::EncodableValue>>;
+
+ static LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wparam, LPARAM lparam);
+ LRESULT HandleMessage(HWND hwnd, UINT message, WPARAM wparam, LPARAM lparam);
+ void HandleMethodCall(const flutter::MethodCall<flutter::EncodableValue>& call, Result result);
+
+ void Show();
+ // restore 为 true 时把焦点还给呼出前的窗口;点了窗口外面而收起时不还,用户已经选了别的窗口
+ void Hide(bool notify, bool restore);
+ void Toggle();
+ void Place();
+ void ResizeChild();
+
+ flutter::EncodableMap SetHotkey(const std::string& name, bool enabled);
+ bool ApplyHotkey();
+ void Commit(bool paste, Result result);
+
+ flutter::DartProject project_;
+ std::unique_ptr<flutter::FlutterViewController> controller_;
+ std::unique_ptr<flutter::MethodChannel<flutter::EncodableValue>> channel_;
+ HWND hwnd_ = nullptr;
+ HWND previous_ = nullptr;
+
+ bool dart_ready_ = false;
+ bool pending_show_ = false;
+ bool suspended_ = false;
+ bool has_hotkey_ = false;
+ bool registered_ = false;
+ UINT modifiers_ = 0;
+ UINT vk_ = 0;
+ DWORD hotkey_error_ = 0;
+};
+
+#endif // RUNNER_PICKER_WINDOW_H_