Actions Ring
在指针位置打开并配置八位置启动器。按方向瞄准、按住选择、选择大小,并支持完整的按应用布局与可选触觉反馈。
操作环(Actions Ring)是一个在指针位置展开的八位置启动器。 从设备详情页的操作环(Actions Ring)标签打开它。
带按键的指针设备、带触觉面板的设备,以及显示按键(Keys)标签的键盘,都有此标签。 显示按键(Keys)标签的键盘可将一个键绑定为显示操作环(Show Actions Ring)。 MX Master 4 的触觉感应面板(Haptic Sense Panel)也是受支持的控件。在新设备上,该面板默认绑定为显示操作环。
打开操作环
按下绑定为显示操作环(Show Actions Ring)的控件,即可在指针位置打开操作环。 再次触发该操作可关闭操作环。

瞄准位置
把指针朝某个位置的方向移动,即可选中它。每个位置占据其方向两侧共 45° 的扇区,因此指针不必到达位置本身。指针移过头时,仍会选中该位置。
指针停在中心附近时,不会选中任何位置。朝空位置瞄准也不会选中任何位置。
选中的位置会放大,并有一道光束从中心指向它。它的标签以气泡形式显示在旁边。过长的标签会换一行,然后以省略号结尾。其他位置显示为半透明圆片,后面没有底板。
选择位置
操作环提供两种选择方式:
- 点击。 短按会打开操作环并保持打开。瞄准后点击,即可运行选中的位置。
- 按住后松开。 按住触发控件 250 毫秒或更久,瞄准后松开。在某个位置上松开会运行它。没有选中位置时松开会关闭操作环。
只有触发控件的按下本身打开操作环时,按住后松开才有效。由手势或长按打开的操作环在松开后仍保持打开。
在中心附近点击(包括点击中心的 ×)会关闭操作环。朝空位置点击也会关闭它。在 macOS 上,点击操作环外部也可关闭它。操作环会在 15 秒后关闭。
配置操作环
选择设备
选择设备,然后在设备详情页打开操作环(Actions Ring)。
选择布局
使用配置文件(Profile)选择默认(Default)或一个应用。
编辑位置
选择一个位置,然后选择它的操作、图标和可选标签。
绑定触发操作
将显示操作环(Show Actions Ring)分配给受支持的鼠标控件或键盘键。
编辑器下方,Show ring on button press 可为此设备打开或关闭操作环。操作环大小(Ring size)设置其大小。设备支持触觉时,还会显示触觉反馈(Haptic feedback)。

操作环大小
操作环大小(Ring size)提供小(Small)、中(Medium)和大(Large)。默认为中。大小属于设备,适用于该设备的所有布局。
小是更紧凑的操作环,适合几乎不移动鼠标的手。大是更宽的操作环,位置也更大。中心区域(不会选中任何位置的范围)随操作环一起变大。
| 大小 | 位置到中心的距离 | 位置大小 | 中心区域半径 |
|---|---|---|---|
| 小 | 62 pt | 36 pt | 20 pt |
| 中 | 76 pt | 44 pt | 24 pt |
| 大 | 96 pt | 54 pt | 28 pt |

位置
每个非空位置保存一个操作、一个可选自定义图标和一个可选文字标签。 选择清除位置(Clear slot)会删除整个条目。省略条目即为空位置。
编辑器禁止在位置中使用显示操作环(Show Actions Ring)和 None。
前者会递归打开操作环。后者不表示空位置。
| 位置 | 默认操作 |
|---|---|
Top | Cut |
TopRight | Copy |
Right | Paste |
BottomRight | BrowserForward |
Bottom | PlayPause |
BottomLeft | BrowserBack |
Left | Undo |
TopLeft | Redo |
使用图标(Icon)中的使用操作图标(Use action icon)可保留操作自带图标, 也可以选择自定义图标。悬停位置时,自定义标签会按原文显示。
额外的通用图标包括:
- 文件夹(Folder)、文件(File)、地球(Globe)和终端(Terminal)
- 星标(Star)、心形(Heart)、日历(Calendar)和铃铛(Bell)
- 用户(User)、调色板(Palette)和书籍(Book)
只有设备上报触觉支持时,才会显示触觉反馈(Haptic feedback)开关。 启用后,悬停或激活非空位置时,OpenLogi 会请求触觉反馈。
编辑器还提供以下高级功能(Power User)操作:
- 输入文本(Type Text)
- 仅 macOS 提供的运行 AppleScript(Run AppleScript)
- 运行 Shell 命令(Run Shell Command)
操作环编辑器不提供工作流(Workflow)。工作流仍可在键盘编辑器中使用。
按应用布局
使用配置文件(Profile)编辑默认(Default)布局或应用布局。 未保存布局的应用会显示默认布局。首次编辑位置时,OpenLogi 会将默认布局复制为该应用的布局。
运行时由前台应用选择布局。在编辑器中选择应用不会改变前台应用。删除应用的操作环布局不会删除该应用的按键覆盖。
应用布局会替换默认布局。应用需要的每个位置都必须列出;未列出的位置为空。
在配置中
操作环设置位于 config.toml 的
[devices.<key>.action_ring] 下。action_ring.per_app 与按键配置文件使用相同的
应用选择器,包括 Windows 的 exe:<name>.exe 和 app:<alias> 键。选择器行为见
按应用配置,完整参考见配置。
schema_version = 11
[devices."unit:6be9d300".action_ring]
enabled = true
haptics = true
size = "medium" # "small"、"medium" 或 "large"
[devices."unit:6be9d300".action_ring.default.slots]
Top = { action = "Copy" }
Right = { action = "Paste", icon = "Keyboard", label = "Paste plain text" }
# 此布局会替换默认布局。未列出的位置为空。
[devices."unit:6be9d300".action_ring.per_app."com.google.Chrome".slots]
Top = { action = "Paste" }平台行为
OpenLogi 会在包含指针的显示器上打开操作环。在 Wayland 上,OpenLogi 会为每个显示器创建一个覆盖全屏的窗口,并在指针位置绘制操作环。Windows 可在混合 DPI 显示器上正确定位操作环。
**状态:**macOS、Linux 和 Windows 均可用。触觉反馈需要设备提供
0x19b0 hapticFeedback。仅 macOS 支持点击外部关闭。