按应用配置
按应用切换按键操作和 Actions Ring 布局,并按指针或焦点选择鼠标配置的目标应用。
按应用配置文件会随应用自动切换设备操作。你可以在 按键(Buttons)或 Actions Ring 标签页中编辑配置文件。
配置文件可以覆盖按键操作,也可以选择 Actions Ring 布局。OpenLogi 会按平台标识符匹配目标应用。
配置文件改变的内容
按键配置文件是设备默认配置文件(Default profile)上的稀疏覆盖。Actions Ring 配置文件是前台应用的完整布局。
- 按键 —— 每个列出的按键都会替换默认操作。未列出的按键继承默认配置文件。手势始终保留在默认配置文件中。
- Actions Ring —— 匹配的前台应用使用完整的已保存布局。它不会与默认布局合并。
按键覆盖可以用单一操作替换支持手势的按键。清除覆盖后,按键会恢复默认手势图。
添加和管理配置文件
选中设备,打开 按键 或 Actions Ring,然后使用配置文件(Profile)选择器。两个编辑器会为同一应用保存独立的配置文件。

- 选择添加应用(Add app)。
- 从最近使用的应用(Recent applications)或所有应用(All applications)中选择应用。
- 修改按键或 Actions Ring 格位以保存配置文件。
最近使用的应用列出代理已观察到的前台应用。应该优先选择它,因为这里的标识符就是运行时标识符。
所有应用是已安装应用目录。它选用的平台标识符可能不同于应用的运行时标识符。
选择应用只会创建编辑器草稿,不会在 config.toml 中写入空条目。在编辑器中切换配置文件不会强制运行时使用该配置文件。
使用配置文件选项(Profile options)管理已选配置文件:
- 重置为默认设置…(Reset to default…)会删除当前编辑器中的自定义设置。编辑器仍会打开该应用。它不会改变另一个编辑器或其他应用。
- 删除配置文件…(Remove profile…)会删除当前编辑器的配置文件,并让该编辑器返回默认(Default)。它不会改变另一个编辑器或其他应用。
- 删除此应用的全部配置…(Delete all app settings…)会删除当前设备上该应用的按键绑定和 Actions Ring 布局。其他应用、设备和默认设置不受影响。
选择鼠标目标应用
在设置窗口中,将鼠标按键配置文件(Mouse button profiles)设为鼠标指针(Mouse pointer)或焦点应用程序(Focused application)。此设置也会保存到 config.toml。
schema_version = 9
[app_settings]
mouse_profile_target = "pointer" # 或者 "focused"。- 鼠标指针是默认值。鼠标配置文件会跟随指针下可识别的窗口。桌面使用全局绑定。
- 焦点应用程序让鼠标配置文件跟随键盘焦点。键盘配置文件始终跟随键盘焦点。
指针定位适用于 macOS、Windows 和 X11。对于不支持的会话,OpenLogi 会使用焦点应用程序。
如果 OpenLogi 无法识别指针下的表面,也会使用焦点应用程序。例如,指针位于系统浮层,或查询失败。没有焦点应用程序时,OpenLogi 会使用全局绑定。
OpenLogi 不会为了发送输入而让后台窗口获得焦点。在指针模式下,如果焦点应用程序对该按键的绑定相同,产生按键输入或运行工作流的绑定会在焦点应用程序中执行。因此,全局快捷键在桌面和未获得焦点的窗口上也能使用。
如果悬停的应用程序通过任一侧的按应用配置文件对该按键做了不同的绑定,未获得焦点的悬停窗口会跳过它。跳过的绑定不会在焦点应用程序中执行。切换桌面等全局操作可以在不改变焦点时运行。
Actions Ring 始终按前台应用选择布局。它不使用指针目标。
标识符和 Linux 后端
配置文件键必须与上报的标识符完全匹配。OpenLogi 不支持通配符或模式匹配。
| 平台 | 上报的标识符 | 示例 |
|---|---|---|
| macOS | Bundle 标识符,或没有 Bundle 标识符时的可执行文件路径 | com.microsoft.VSCode |
| Linux(X11 / XWayland、GNOME Shell) | WM_CLASS 类名 | Code |
| Linux(兼容 wlroots 的合成器,包括 Sway 或 Hyprland) | xdg-shell app_id | code |
| Windows | 小写的可执行文件路径,或 exe:<filename>.exe | exe:sharex.exe |
在 Windows 上,精确的可执行文件路径优先于 exe:<filename>.exe。如果商店应用或自更新应用的路径会改变,应该使用 exe: 形式。
Linux 的 WM_CLASS 与 xdg-shell app_id 是不同的命名空间。wlroots 配置文件不会在 GNOME 或 X11 中匹配,反之亦然。
GNOME Wayland 的原生窗口需要安装并启用 OpenLogi GNOME Shell 扩展。没有扩展时,X11 后端只能匹配 XWayland 窗口。
KDE KWin 不提供 wlroots 协议。v0.8.15 没有原生 KDE Wayland 窗口的专用前台应用后端。
跨平台共享配置文件
如果一个配置文件必须匹配 macOS、Linux 和 Windows 中的同一应用,请使用 [apps] 别名。使用 app:<alias> 配置文件键引用别名。
schema_version = 9
[apps.chrome]
name = "Google Chrome"
macos = "com.google.Chrome"
linux = ["google-chrome", "Google-chrome"]
windows = "exe:chrome.exe"
[devices."unit:6be9d300".per_app_bindings."app:chrome"]
Back = "PrevTab"每个 macos、linux 或 windows 字段可以包含一个标识符或一个数组。如果别名没有当前平台的标识符,它会保留在文件中,但不会在当前平台生效。
同一选择器可用于 per_app_bindings 和 action_ring.per_app。OpenLogi 按以下优先级匹配:
- 精确标识符。
- Windows
exe:<filename>.exe选择器。 - 列出精确标识符的别名。
- 列出
exe:<filename>.exe选择器的别名。
因此,平台专用配置文件优先于别名配置文件。如果 app: 配置文件引用未定义的别名,配置无法加载。
标识符为空、以 app: 开头、同一平台重复,或 Windows 标识符含有大写字母时,配置也无法加载。
GUI 会显示别名配置文件,但不能创建别名。GUI 会依次使用已配置的 name、代理上报的名称或别名名称。GUI 使用当前平台第一个标识符的图标。请编辑 config.toml 以创建或修改别名。
状态: 按键配置文件和 Actions Ring 布局适用于 macOS、Linux 和 Windows。指针定位适用于 macOS、Windows 和 X11。应用识别使用操作系统 API,而不是 HID++。