prefix 键（默认 Ctrl+M）

语言 · 中文 · English · 日本語

← 返回设置页帮助

prefix 是 gmux 一切快捷键的总开关。所有内置动作和绑定触发都先按一次 prefix，再按第二键。

默认值与修改

  • 默认：Ctrl+M
  • 修改：设置 → 快捷键 → prefix 键 点编辑按钮，按下新组合键，再按确认。
  • 必须包含至少一个修饰键（Ctrl / Alt / Shift / Win）。单独的字母数字、Esc、F 键都会被拒绝。
  • 默认 Win 键不可用。需要把 Win 当修饰键时，先勾上「启用 Win 键作为修饰键」复选框，再去捕获新组合。
  • 修改即生效，不需要重启。

工作机制

按下 prefix 后进入等待 chord 状态：

  1. 引擎短暂屏蔽全局键盘，等下一键。
  2. 这个等待期默认 2000 ms（在「快捷键 → prefix 键 → PREFIX 超时」修改）。
  3. 等待期间收到的下一键决定下一步：
    • 是某个内置动作的 chord（默认 n/p/l/r/f/q/z/m/space/w/g/c/x/?）→ 触发动作。
    • 是某个绑定的 key（0-9、a-z、F1–F24、命名键或 OEM 标点）→ 触发该绑定。
    • 是 Esc → 静默取消。
    • 是其它任意键 → 取消等待并把这个键透传给当前焦点窗口（不会被吃掉）。
    • 超时未按任何键 → 静默取消。 - 等待期间单独按下修饰键（Ctrl / Shift / Alt / Win / 大小写锁定）不会取消等待，可以继续按 chord。

触发绑定（prefix + 绑定 key）

每个绑定的触发键在「布局」页左栏标识为 ⌃M·1、⌃M·a 这样的形式（前面一段就是当前 prefix）。

  • prefix <绑定键> → 触发该绑定。合法绑定键：数字 0-9、字母 a-z、功能键 F1–F24、命名键（Space、Enter、Tab、方向键、Home/End、PageUp/PageDown、Insert、Delete、Backspace）、OEM 标点（; / ` [ \ ] ' , . - =），共 85 个。

按下后：

  • 引擎按当前接入的物理屏，从该绑定的多个预案里挑出唯一匹配的预案执行。
  • 没有匹配的预案 → 静默丢弃，必要时弹静默提示（参见下文）。
  • 已经在跑的应用窗口被移动到目标槽位；没启动的应用按预案的启动方式启动。
  • 触发后该绑定成为「当前布局」（current layout）；prefix+r prefix+n/p/l prefix+w 等动作都是基于当前布局工作的。

prefix 被占用怎么办

如果别的应用（AutoHotkey 脚本、OneNote、企业微信、QQ 截图等）抢了相同组合：

  • 托盘图标会变成 红警告。
  • 右键托盘 → 重试 prefix：在你关掉占用者后再注册一次。
  • 或者去「设置 → 快捷键」换一个不冲突的组合。

高级：prefix 失活自愈

低级别键盘 hook 偶发会被 Windows 在系统繁忙时静默卸载。gmux 在连续 2 次 prefix 等待都没收到任何按键时，会自动重装 hook，下一次 prefix 即恢复。这套自愈对用户透明，无需操作。

静默提示

「快捷键 → 静默操作提示」开关打开后，按下 prefix + chord 但前置条件不满足（如：没有任何匹配当前屏的布局、split_region 时区域太小、focus_region 时没选区域等）的情况下，会在默认屏幕中央弹一行短提示。同一条提示 3 秒内只弹一次。

关闭这个开关后，所有「条件不满足」的情况都是完全静默的，只在日志里有记录。

与设置窗口的交互

  • 设置窗口聚焦时，按 F1 可直接打开「帮助」页（等价于 prefix+?）。
  • 设置窗口的 「关于」 和 「开源软件许可证」 页不响应 F1（避免阅读时被打断）。