Wox 快捷键完全指南主热键、快捷键查询、托盘查询与全屏策略详解【免费下载链接】WoxA cross-platform launcher that simply works项目地址: https://gitcode.com/gh_mirrors/wo/WoxWox 的快捷键体系远不止一个启动热键通过「快捷键查询」可以把任意一段查询如webview x、ai translate {wox:selected_text}绑定到一键触发再配合「托盘查询」和「全屏时忽略快捷键」策略能构建出完整的个人效率入口。本文以官方用户指南 www/docs/zh/guide/usage/hotkeys.md 为主线结合 wox.core/hotkey 与 wox.core/setting/wox_setting.go 的源码实现系统讲解 Wox 全部热键的默认值、配置位置、实战用法与底层注册机制。主热键与选中热键Wox 有一个主启动热键也可以为准备好的查询单独绑定快捷键。所有这些热键都在设置 - 常规中修改不同平台各自维护独立的默认值由 wox.core/setting/wox_setting.go 中的PlatformValue声明热键WindowsmacOSLinux主热键MainHotkeyAlt SpaceCommand SpaceCtrl Space选中热键SelectionHotkeyWin Alt SpaceCommand Option SpaceCtrl Shift J其中选中热键会针对当前选中的文本或文件直接打开 Wox方便选区、网页搜索和 AI 命令这类插件继续处理——例如先选中一段英文按下选中热键Wox 出现并携带{wox:selected_text}变量随后交给翻译或搜索流程。平台权限与 Wayland 注意点macOS录制热键时若提示权限需要在系统设置中授予 Wox「辅助功能」权限。Linux WaylandCtrl Space这类普通组合键走桌面门户org.freedesktop.portal.GlobalShortcuts而双修饰键如ctrlctrl和 CapsLock 组合键如capslocka需要额外输入权限具体配置见 Wayland 常见问题前者只需加入input组读取/dev/input/event*后者推荐再配置uinput组与 udev 规则以便触发后恢复 CapsLock 状态。值得注意的是Wayland 会话下选中热键会被运行时禁用见 wox.core/hotkey/service.go 的EffectiveSelectionHotkeyForRuntime仅在IsLinuxWaylandSession()时返回空字符串。全屏应用忽略快捷键开关开启设置 - 常规 - 全屏时忽略快捷键对应源码字段IgnoreHotkeysOnFullscreen默认在三个平台均为false见 wox.core/setting/wox_setting.go后前台窗口处于全屏状态时Wox 不会响应主热键、选中热键和查询快捷键。此选项默认关闭普通的最大化窗口不受影响听写热键独立于此启动器设置不受该开关管辖。平台支持范围Windows支持。macOS支持但需要辅助功能权限源码注释说明 macOS 原生全屏也覆盖日常工作场景因此该开关在 macOS 上不展示见 wox.core/ui/launcher/settings.go。Linux X11支持要求系统安装了xprop。Hyprland支持要求安装了hyprctl。其他 Wayland 桌面不支持此时开关不可用设置界面通过FullscreenDetectionSupported置灰该项。检测失败或不可用时快捷键保持可用——该选项只阻止 Wox 执行动作并不会注销快捷键因此不保证前台应用能收到这些按键。这一点与设置界面的英文提示一致见 wox.core/resource/lang/en_US.json「Fullscreen detection is unavailable. Linux requires xprop on X11 or hyprctl on Hyprland; other Wayland desktops are not supported.」。快捷键查询把一个快捷键绑定到一段查询快捷键查询的核心思想是不用先打开 Wox 再输入webview x或window group Work直接按一下绑定的键即可执行。在设置 - 常规 - 快捷键查询中新增一行并从四种预设中选择起点预设用途普通查询显示启动器并执行查询预览查询隐藏查询框和工具栏适合 WebView 面板和文件预览静默执行只有一个明确动作时不显示启动器直接执行自定义保留预设默认值再覆盖位置、宽度、结果数或界面元素设置之后仍可以覆盖窗口位置、宽度、结果数以及查询框和工具栏是否显示。配置字段与取值范围每一条快捷键查询在源码中对应setting.QueryHotkey结构体见 wox.core/setting/wox_setting.go字段含义说明Name显示名称为空时回退显示Query本身DisplayName()逻辑Hotkey触发组合键支持hold:前缀声明按住触发Query要执行的查询支持plugin.QueryVariable例如{wox:selected_text}IsSilentExecution静默执行为 true 时不把查询显示在输入框、直接执行动作HideQueryBox隐藏查询框配合「预览查询」预设HideToolbar隐藏工具栏同上Width窗口宽度覆盖默认启动器宽度MaxResultCount最大结果数覆盖全局「最大结果」设置Position窗口位置见下方位置枚举Disabled禁用该条禁用或热键为空的条目在注册时被跳过窗口位置QueryHotkeyPosition支持以下取值见 wox.core/setting/wox_setting.gosystem_default系统默认、top_left、top_center、top_right、middle_left、center、middle_right、bottom_left、bottom_center、bottom_right共九宫格加默认共十种位置。示例查询快捷键会做什么app launchpad打开应用网格webview x打开紧凑的 X 面板window group Work恢复已保存的工作区ai translate {wox:selected_text}翻译当前选中文本静默翻译是同一套做法的典型场景先创建一个 AI 命令再用静默执行预设绑定快捷键按下后不弹出启动器直接完成翻译。AI 命令的创建流程见 AI 命令。查询测试按钮设置页还提供查询测试按钮不用离开页面就能试热键、快捷方式和托盘查询。该功能由 wox.core/ui/launcher/form_table.go 的runFormTableQueryTest实现它会用当前编辑好的查询值直接打开启动器执行便于即时验证{wox:selected_text}等变量和界面参数是否符合预期。托盘查询快捷键查询的鼠标版本托盘查询是快捷键查询的鼠标版本在设置 - 常规 - 托盘查询中添加图标和查询。点击托盘或菜单栏图标后Wox 会在托盘附近打开并执行该查询适合仪表盘、WebView 站点、剪贴板历史cb或笔记note这类需要高频快速唤起的面板。从实现上看setting.TrayQuery见 wox.core/setting/wox_setting.go与快捷键查询高度相似同样支持Icon、Query、Width、MaxResultCount、HideQueryBox、HideToolbar、Disabled等字段其中Width留空时默认使用应用宽度的一半MaxResultCount留空时沿用全局最大结果设置见 wox.core/resource/lang/en_US.json 中的 tooltip 说明。其他内置热键Wox 在启动器之外还内置了一批与热键相关的能力分散在结果操作、操作面板和各插件设置中功能位置在 WebView 中打开网页搜索结果操作CtrlEntermacOS 上为CmdEnter查询框保持可见Escape 把焦点交回查询框关闭当前 WebView 网页操作面板CtrlWmacOS 上为CmdW销毁页面以释放内存隐藏后台 WebView 网页操作面板CtrlHmacOS 上为CmdH仅在启用了后台运行的快捷键全预览窗口中出现听写单击 / 双击 / 按住设置 - 插件 - 听写截图设置 - 插件 - 截图或查询screenshot热键总览查询hotkeys查看已注册快捷键其中「热键总览」由系统快捷键插件提供见 wox.core/plugin/system/hotkey_overview.go 对应的文档 www/docs/zh/guide/plugins/system/hotkey-overview.md它会列出 Wox 已注册的主热键、选中热键、快捷键查询和插件热键支持按名称过滤是排查「哪个键被谁占用」的最直接入口。应用内快捷键如CtrlEnter、CtrlW统一基于平台主修饰键生成macOS 为cmd其余平台为ctrl见 wox.core/util/primary_hotkey.go 的PrimaryModifier。底层实现热键如何从设置走到系统注册理解 Wox 热键的底层实现有助于预判不同平台的行为差异。热键注册链路集中在 wox.core/hotkey/service.go 与 wox.core/hotkey/collector.go收集collectWoxConfig从设置快照WoxConfigFromSetting读取主热键、选中热键和全部查询快捷键写入 collector。collected 条目按来源EntrySource划分main、selection、query、dictation见 wox.core/hotkey/collector.go。解析buildHotkeySpecs对每个组合键调用utilhotkey.ParseBinding。绑定字符串支持hold:前缀声明「按住触发」模式且按住模式要求是纯修饰键组合如left_alt同时必须提供OnRelease释放回调普通模式则默认按「按下触发」见 wox.core/util/hotkey/hotkey_binding.go 及对应单元测试 wox.core/util/hotkey/hotkey_binding_test.go。听写热键单击/双击/按住正是通过该机制区分触发语义。注册registerSpecsLocked一次性把全部规格注册到平台Group若注册失败且此前已有热键会尝试用上一次的规格回滚恢复避免配置保存失败导致热键集体失效。路由注册成功后按下事件通过CallbacksOnMain、OnSelection、OnQuery、OnDictationHoldPress等见 wox.core/hotkey/service.go回传给对应子系统执行查询或动作。对用户而言理解这条链路的意义在于所有热键——无论是主热键、选中热键、快捷键查询还是托盘查询对应的鼠标点击——最终都收敛到同一套「设置 - 收集 - 注册 - 回调」管线任何一条绑定失败如非法组合键或 Wayland 权限不足都可以通过查询hotkeys或查看 core 日志来定位是哪一环出了问题。小结Wox 的快捷键体系可以概括为三层主热键/选中热键负责「打开启动器」本身「快捷键查询」把任意查询压缩成一次按键「托盘查询」则把同样的能力延伸到鼠标。三者共享同一套注册与回调机制wox.core/hotkey/service.go并受「全屏时忽略快捷键」这一平台策略的统一约束。掌握了预设的四种模式普通查询、预览查询、静默执行、自定义以及位置、宽度、结果数、界面元素的覆盖方式你就能把 Wox 从「一个启动器」升级为「一组可编程的全局动作入口」。【免费下载链接】WoxA cross-platform launcher that simply works项目地址: https://gitcode.com/gh_mirrors/wo/Wox创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考