Keel v0.5.1 English GitHub

native

系统能力模块集合。每个子目录是一个独立模块,可以只用其中一个,也可以完全不用 ui 界面。

模块 能力 依赖
permission 检查、申请系统权限 native、native/internal/sys
screen 显示器列表、截图 同上
input 合成鼠标、键盘事件 同上
hotkey 全局快捷键 同上
clipboard 异步读取剪贴板文本、编码图片和文件引用(macOS / Windows / Linux Wayland、X11) 同上
notification 系统通知权限、投递与撤回(macOS .app / Linux D-Bus) 同上
tray 托盘图标与原生菜单(macOS / Windows / Linux SNI) native、native/internal/sys
process 终端前台进程组、进程工作目录(macOS / Linux) native、native/internal/sys

模块之间互不引用,也不引用 ui 和 Gio,这一点由 internal/deps 里的测试保证。

两个共享部分不是独立模块:

  • native(本目录的 native.go):所有模块共用的错误值 native.Err*。
  • native/internal/sys:平台绑定,macOS 通过 purego 调 Objective-C 运行时和系统框架(不用 cgo)、Windows 的 Win32 调用、Linux 的 X11 协议和 D-Bus 都在这里。外部不能引用。
  • native/internal/wlclip:读取 Linux Wayland 剪贴板,运行时通过 purego 加载 libwayland-client(不用 cgo)。只有 clipboard 引用,所以别的模块不会加载 libwayland。

支持 macOS 14+、Windows 和 Linux,其他平台返回 native.ErrUnsupported。Linux 上截图和合成输入走 X11(Wayland 会话里通过 XWayland),通知走 D-Bus,剪贴板 Wayland 和 X11 都支持。各能力在各平台的细节见原生能力。

文档:原生能力 · 新增原生能力

移动端 iOS 和 Android 暂无 native/* 后端,各能力返回 native.ErrUnsupported。界面打包与运行见 Mobile 支持。