prefix+q — 显示并选中 region

语言 · 中文 · English · 日本語

← 返回设置页帮助

prefix+q 是所有「区域操作」（prefix+f / z / g / c / x / d）的前置步骤：先把 region 编号画到屏上。之后你可以只选中某区（输区号 + Enter/停手），或在一个 chord 内选区即执行——区号和操作键的先后都行：区号在前（q→数字→操作键，推荐）或操作键在前（q→操作键→数字，旧顺序保留）。

默认 chord：q · 配置项：show_regions · 在「设置 → 快捷键 → 区域操作」改

区域（region）是什么

当前布局的每个 region = 某块屏的某个槽位（左上 / 右半 / 中部条等）。OSD 弹出时会在每个 region 中央用大数字打出编号，编号从 0 开始。

如果当前还没触发任何布局，prefix+q 会静默丢弃，因为没东西可选。

四种用法

用法 1：选中某区（区号在前，仅选中）

按  prefix
按  q              ← 屏上每个 region 显示编号 0 1 2 3 …
按  3              ← 输入区号（多位可连打，如 1 2 = 12）
按  Enter          ← 锁定选中（或停手约 1 秒、等输入超时自动锁定）

要点：

  • 和旧版的区别：按下区号数字不再立即生效。要按 Enter，或停手等输入超时（input_timeout_ms，默认 3000 ms）才锁定。这样数字后面才能接操作键（见用法 2）。
  • 多位区号直接连打，不用再按第二个 q；每按一位都会重置输入超时。
  • 锁定后记入「当前绑定的 selected_region」，被以下动作直接使用：
    • prefix+f 在该 region 里轮换 app 多窗口
    • prefix+z 该 region 临时全屏
    • prefix+g 把焦点跳到该 region 的窗口
    • prefix+c 在该 region 上加一个新应用（split）
    • prefix+x 关闭该 region 的当前窗口
    • prefix+d 回收该 region（最小化其窗口，不关闭）
  • 缓冲为空时 Enter/超时 = 取消（没选任何区）。

用法 2：选区即执行 · 区号在前（推荐）

不想「先选区、之后再操作」两步走的话，先输区号、再按操作键，一个 chord 内选中该区并立刻执行：

按  prefix
按  q              ← 屏上每个 region 显示编号
按  3              ← 输入区号（多位可连打）
按  z              ← 操作键，立即对 region 3 执行该操作（这里 z = 全屏）
  • 操作键同时是区号输入的结束符——按下操作键就提交，不用先按 Enter。
  • 可作为操作键的就是六个区域动作的 chord（用各自当前的绑定键，改绑后同步）： g 聚焦 · f 轮换窗口 · z 全屏 · d 回收 · c split · x 关闭。
  • 执行后该区保持选中，后续裸 prefix+f / z / g / c / x / d 继续对它生效。
  • 多位区号同理：q → 1 → 2 → z 对 region 12 执行全屏。

用法 3：选区即执行 · 操作键在前（保留旧顺序）

也可以沿用旧顺序：先按操作键、再按数字。

按  prefix
按  q              ← 屏上每个 region 显示编号
按  z              ← 先选定要执行的操作（这里 z = 全屏）
按  3              ← 再按数字，选中 region 3 并立即全屏
  • 操作键在前时，一位数直接触发（无需 Enter）。
  • 编号 ≥ 10：按操作键后再按一个 q 进多位累加器，输入数字后 Enter 或停手超时提交——prefix → q → z → q → 1 2 → Enter。
  • Esc 取消。若按的操作键被禁用（在设置里清空了该动作的快捷键），它不算操作键，按下即取消并透传。

用法 4：取消

prefix+q 之后取消的方式：

  • 按 Esc：取消，OSD 关闭。
  • 按既不是数字、不是操作键、不是 q、不是 Enter、不是 Esc 的键：取消，OSD 关闭，该按键透传给焦点窗口。
  • 等待超时——分两种：
    • 还没输入任何区号（刚按完 prefix+q，或操作键在前还没按数字）：用输入超时（input_timeout_ms，默认 3000 ms），超时即取消。
    • 已经输入了区号：用输入超时（input_timeout_ms，默认 3000 ms），此时超时 = 把已输区号当成选中提交（见用法 1），不是取消。
  • 切换前台窗口、显示器热插拔、配置重载：自动取消。

选中状态会被记多久

  • 跨 chord 持久：选中后哪怕过了几小时，再按 prefix+f / z / g / c / x / d 仍然对那个 region 生效。
  • 绑定级：每个绑定有自己独立的 selected_region。切到别的绑定再切回来，原选中保留。
  • 被这些事件清除：
    • 配置重载（reload）后所有选中清空。
    • 该 region 的窗口被关闭后，引擎自动 forget 该 region 的选中（重新轮询时就回到 region 0）。
    • prefix+r（restore）会清掉当前绑定的选中。

没选中过任何 region 怎么办

prefix+f / z / g / c / x / d 在没有 selected_region 时自动用 region 0作为目标。所以最常见的场景是：

  • 单 region 布局或全屏布局：直接 prefix+f 轮换、prefix+z 全屏，从来不需要按 prefix+q。
  • 多 region 布局：第一次用 prefix+q 选好某区（输区号后按 Enter/停手锁定）后，后续操作就连按 prefix+f / prefix+z 即可，不用每次都重选。

选了无效编号会怎样

按了一个超过当前布局 region 数的数字，或者编号对应的位置不是叶子（live 布局可能动态合并）：

  • OSD 关闭。
  • 不修改 selected_region 状态（保持上一次的选中）。
  • 后续区域操作仍按原选中工作。

时序参数

参数 默认 设置位置
输入区号前的超时 3000 ms 快捷键 → 高级 → 命令键后输入超时（input_timeout_ms）
区号输入超时（每按一位重置；停手即按此超时锁定选中） 3000 ms 快捷键 → 高级 → 命令键后输入超时（input_timeout_ms）
OSD 内部清理 tick 1000 ms 快捷键 → 高级 → REGION OSD 清理间隔