ZoneDeck 热键与鼠标手势完全指南:全局热键、鼠标按键、屏幕四角与空闲自动隐藏

原创2026-10-13 13:39:481,924 阅读
文章标签:桌面应用

ZoneDeck 热键与鼠标手势完全指南:全局热键、鼠标按键、屏幕四角与空闲自动隐藏

本篇技术指南围绕 ZoneDeck(桌面工作区管理工具)中“隐藏 / 恢复窗口”的四类触发方式展开:键盘全局热键、鼠标按键连击、屏幕四角快速移动、空闲自动隐藏。文章以官方指南 hotkeys.md 为骨架,结合核心源码(热键解析、低级键盘钩子、低级鼠标钩子、空闲判定)与配置文件结构,讲解每一项开关的实际作用、默认值、适用场景及其底层实现原理,帮助你把“老板键”式的窗口隐藏能力调教到最适合自己的工作习惯。

ZoneDeck 热键与鼠标设置页

一、四类触发方式与“编辑时自动暂停监听”

ZoneDeck 的所有触发方式都在设置界面的 热键与鼠标 标签页中配置,按触发介质可分为四类:

触发方式 设置介质 典型用途
键盘全局热键 键盘 最通用、最快捷
鼠标连击 / 侧键 鼠标 手在鼠标上时更顺手
屏幕四角 鼠标移动 无需记忆按键,甩一下即可
空闲自动隐藏 无操作计时 临时离开、忘记手动隐藏时的兜底

一个容易被忽略的细节:当鼠标指针进入“热键与鼠标”设置区域时,核心会临时暂停热键与鼠标监控,避免你在录制或调试时误触发隐藏;离开该区域或窗口失焦后自动恢复。监控状态显示在窗口右下角。

这一机制在源码中有完整的闭环实现:配置程序通过 IPC 发送 SetHotkeys { enabled } 命令,核心在 commands.rs 中把 monitoring 置为 false 并调用 sync_monitoring 注销全部热键、卸下钩子;同时启动 SUSPEND_GUARD_TIMER_ID 看门狗定时器,若配置程序长时间未续期(超时由 zonedeck_common::ipc::SUSPEND_TIMEOUT_MS 定义),核心会自动恢复热键与鼠标监控并写入日志(agent/mod.rs)。托盘状态角标还支持绑定 monitor_paused 状态源,用于直观显示“监控已暂停”(见 tray_badge.rs)。

二、键盘全局热键

2.1 五个可自定义的热键

功能 默认值 说明
隐藏 / 显示窗口 Ctrl + Q 已隐藏时恢复,未隐藏时隐藏
仅隐藏窗口 已关闭 只隐藏,不恢复
仅显示窗口 已关闭 只恢复,不隐藏
隐藏前台窗口 已关闭 只隐藏当前活动的那一个窗口
关闭核心 Win + Esc 退出核心(退出前会恢复所有窗口)

点击 录制 按钮后按下想要的组合键,程序会自动识别并填入:按住的每一个键都会实时显示,松开后停在录到的组合上。点击 清除 可置空该热键——置空后该项显示为“已关闭”,核心不再注册它,对应功能无法通过键盘触发;五个热键相互独立,可单独置空。

热键的解析与格式化在 hotkey.rs 中实现:parse_hotkey 会把 "Ctrl+Q" 拆成修饰键位掩码(MOD_CONTROL = 0x0002)与主键虚拟键码(Q = 0x51),主键会按虚拟键码升序去重归一,因此 "Q+W" 与 "W+Q" 被识别为同一条热键;修饰键支持 Ctrl、Alt、Shift、Win(兼容 control、cmd、super、meta 等别名),单条热键最多携带 MAX_KEYS = 4 个主键,超限报 TooManyKeys 错误。默认值 Ctrl+Q / Win+Esc 在 config.rs 中定义为常量 DEFAULT_HIDE_HOTKEY 与 DEFAULT_CLOSE_HOTKEY。

2.2 单向热键与隐藏前台窗口

后三个热键默认置空,需要时自行录制:

  • 仅隐藏窗口:按规则隐藏,但绝不恢复。适合把隐藏与恢复拆成两个键,避免误按同一个键把刚藏好的窗口又放出来。
  • 仅显示窗口:只恢复已隐藏的窗口,绝不触发隐藏。
  • 隐藏前台窗口:不套用 窗口 / 进程规则,只隐藏当前活动的那一个窗口;可连续按下,每按一次多藏一个窗口。

隐藏是累加的:无论用哪种方式隐藏,被隐藏的窗口都会记在同一份清单里,恢复时一并放出。因此上述三个热键隐藏的窗口,只能通过 仅显示窗口、隐藏 / 显示窗口(此时它执行恢复),或托盘菜单、鼠标手势等其他恢复方式放出来。

实现上,apply_hide_foreground(agent/mod.rs)并不走规则匹配,而是取当前前台窗口直接隐藏:先从窗口枚举中定位 foreground_target,找不到可隐藏的前台窗口就只写日志、不做事。“隐藏前台窗口”隐藏的是当前获得焦点的可见顶层窗口(悬浮小部件、工具窗口也算在内);当焦点落在附属窗口(对话框、下拉面板)上时,该次触发不做任何事,并在日志中留下记录。桌面与任务栏属于资源管理器进程,被预置的 白名单 条目挡住——全新安装时 config.rs 会播种一条 explorer.exe 的白名单规则,ignore_hide 为 true,因此不会被隐藏。

2.3 低级键盘钩子与“不传递”

展开任意一个热键,可以看到两个相互独立的开关(默认都关闭):

  • 低级键盘钩子:改用底层键盘钩子(WH_KEYBOARD_LL)触发该热键,不再向系统注册。因此不受组合键被其他程序占用的影响,也才能录制下面说的更丰富的组合。
  • 不传递:触发该热键时,按键的按下与抬起都不会传给前台程序,避免游戏、聊天输入框等误收按键。这件事只有钩子做得到,须先开启上一项。

五个热键的开关各自独立。旧版本只有一个“不传递”开关,它同时代表这两件事;升级后会自动拆成两个都开启的状态,行为不变。这条迁移逻辑在 Hotkey::normalize()(config.rs)中实现:intercept 蕴含 hook,把旧的 *_intercept 语义归一为“走钩子且吞键”两个开关都为真,且幂等可重复执行。

关于全局热键(RegisterHotKey 与冲突处理)

默认情况下,ZoneDeck 通过系统的 RegisterHotKey 注册全局热键(见 agent/mod.rs 的 register_hotkeys)。若某个组合已被其他程序占用,注册会失败(错误码为 ERROR_HOTKEY_ALREADY_REGISTERED / 1409),该热键本次不生效:

  • 录制时,对话框会当场标出被占用的组合——这是通过 is_taken(hotkey.rs)做的一次“试注册再撤销”探测:以 PROBE_ID = 0x5A44 试注册该组合,只有返回 1409 才判定为被占用;纯修饰键与多主键组合走钩子承载,一律报空闲。
  • 对已经保存的热键,核心在发现冲突时弹通知提醒(每个组合只提醒一次,直到冲突消失,由 hotkey_conflicts.refresh 去重)。

两种情形的出路一样:退出占用它的程序、换一个组合键,或给该热键开启低级键盘钩子绕开占用。

若键盘钩子安装失败,RegisterHotKey 表达得了的组合会回退为普通注册(见 arm_hook_hotkeys,agent/mod.rs):仍可触发功能,只是无法阻止按键传递;纯修饰键与多主键组合没有回退路径,本次不生效,日志中会有记录。另外,少数直接读取 Raw Input 的程序不经过键盘钩子,仍可能观察到按键——这是 Windows 输入体系的结构性限制。

钩子线程与吞键判定

低级钩子由 input_hooks.rs 创建的专职线程承载(线程名 zonedeck-input-hooks,优先级 THREAD_PRIORITY_ABOVE_NORMAL,刻意不升到 TIME_CRITICAL 以免抢走前台程序的调度权)。钩子回调只做判定与 PostMessageW,命中后以 WM_KEY_TRIGGER 消息转发给代理窗口,重活都在代理窗口的消息处理里完成。

吞键判定是状态机式的(keyboard_hook.rs):每条钩子承载的热键维护 held(当前按住的成员键位图)、eaten(已被吞掉的键位图)、fired(本轮是否已触发)等运行态,最终输出 Pass / Swallow / Fire 三种处置。值得注意的是,注入的按键(LLKHF_INJECTED 标志)不参与热键判定,以避免反馈回路;长按产生的重复按下会被吞掉但不会重复触发;Alt 组合走 WM_SYSKEYDOWN / WM_SYSKEYUP 同样被识别。

2.4 更丰富的组合

RegisterHotKey 只收“修饰键 + 一个主键”。开启 低级键盘钩子 后,还可以录制两类组合:

  • 多个主键同时按:例如 Q + W,最多四个主键(MAX_KEYS),全部按住才触发。开启“不传递”时,组合里的每个主键在修饰键吻合期间都会被吞掉,即使最后没按齐——对应 HookHotkey::step_keys 中 matched || fired 才吞键的规则。
  • 纯修饰键:例如 Ctrl + Shift。为了不干扰 Ctrl+Shift+S 这类正常快捷键,它在全部修饰键松开、且期间没有按过其他键时才触发(step_modifiers_only 中的 armed / poisoned 机制:期间敲了主键或多按了修饰键都会使本轮作废)。修饰键在触发前早已传给前台程序,因此“不传递”对这类组合不生效,界面上会置灰。

录到这两类组合时,保存会自动为该热键打开 低级键盘钩子——它们只有这一条承载路径。这在解析层有直接对应:ParsedHotkey::requires_hook()(hotkey.rs)在“主键数量不等于 1”时返回 true,register_hotkeys 因此强制把这些组合送进钩子列表。

小键盘、标点符号键(分号、等号、逗号、减号、句点、斜杠、反引号、方括号、反斜杠、引号)、音量与播放控制键在两种模式下都能用,不必开启钩子。标点键的字面含义随键盘布局变化,因此配置文件里存的是按键位置(OEM_1、OEM_PLUS、OEM_102 等),界面上显示的则是你当前布局下的实际字符。key_to_vk 与 vk_to_key(hotkey.rs)维护了这套双向映射,其测试用例 every_supported_vk_round_trips_through_parse_hotkey 断言所有 118 个受支持按键都能录制后原样解析回来。前端录制状态机见 recorder.js:它把录制期间的一串按键快照归约为待保存组合,处理了“多主键要等按齐”“纯修饰键要等全松开”“长按重复按下不算新输入”等边界。

三、鼠标按键隐藏

除了键盘,还可以用鼠标按键触发隐藏。支持五颗鼠标键:左键、中键、右键、侧键 1(前进)、侧键 2(后退)。

默认开启 鼠标中键双击隐藏,并允许“再按一次恢复”。每颗启用的按键都可独立配置:

  • 连击次数:单击、双击或三连击才触发(上限 MAX_CLICKS = 3)。
  • 修饰键:可要求同时按住 Ctrl / Shift / Alt / Win 组合,例如“按住 Ctrl 时中键双击”才隐藏。留空表示不需要修饰键。点 录制 后按住想要的组合,松开即定稿;与热键录制一样,此期间键盘由 ZoneDeck 独占,录 Win 不会弹出开始菜单。

此外有两个全局选项(对五颗键共同生效):

  • 按键恢复(allow_click_restore,默认开):开启后,再按一次同样的键即可恢复已隐藏的窗口。
  • 连击判定窗口(multi_click_ms,默认 350 毫秒):多次点击间隔不超过该时长(毫秒)才算作连击。配置加载时会夹到合法范围 150..=1000 毫秒(常量 MIN_MULTI_CLICK_MS / MAX_MULTI_CLICK_MS)。

警告:配置 左键 / 右键 触发时请务必搭配连击或修饰键,否则会干扰正常点击操作。

源码层面,mouse_hook.rs 的 register_click 实现了连击计数:窗口内累加、超时重置,数满 clicks 即触发并清零;要求修饰键时用 current_modifiers() 与配置位掩码做完全吻合比对,多按或少按一个修饰键都不触发。button_index 把 WM_LBUTTONDOWN / WM_MBUTTONDOWN / WM_RBUTTONDOWN / WM_XBUTTONDOWN 消息映射到五颗键(侧键通过 mouseData 高 16 位区分 1 / 2)。鼠标触发与四角触发共用一个 WM_MOUSE_TRIGGER 消息投递给代理窗口,由 agent/mod.rs 统一处理:隐藏一律生效,恢复取决于各自开关——按键恢复看 allow_click_restore,角落恢复看 allow_move_restore。

四、移动到屏幕四角隐藏

启用后,把鼠标快速移动到屏幕的某个角落即可触发隐藏 / 恢复。四个角(左上、右上、左下、右下)可以分别开启。

ZoneDeck 鼠标按键与四角设置

配套选项:

  • 仅快速移动触发(corner_fast_only,默认开启):只有快速把鼠标移到角落才触发,避免正常操作误触;关闭后只要移动到角落就触发。
  • 角落恢复(allow_move_restore,默认关闭):开启后,允许通过移动鼠标到角落来恢复已隐藏的窗口(默认只能通过此方式隐藏而不支持恢复)。

四角隐藏依赖底层鼠标钩子(WH_MOUSE_LL),仅在你启用了鼠标按键或四角功能时才会安装;如果你完全不使用鼠标触发,核心不会安装该钩子。这个判断就是 MouseHook::wants_hook()(mouse_hook.rs):mouse.any_enabled() 或四个角任一开启才返回 true;测试用例还特意验证了“只开‘仅快速移动’而没选角落、也没开按键,不该装钩子”。

判定细节(从源码可见):

  • 角区域是屏幕边界向内 10 像素的窄带(CORNER_THRESHOLD),屏幕中心不触发。
  • 触发有 1000 毫秒冷却(CORNER_COOLDOWN_MS),防止指针在角落停留时反复触发。
  • “快速”的速度门槛约为 1.5 像素/毫秒(约 1500 px/s)(FAST_SPEED_PX_PER_MS),且两次移动采样间隔超过 120 毫秒(SPEED_SAMPLE_MAX_MS)就不算同一次甩动。
  • 多显示器下按光标所在的那块显示器判定:钩子给出的是虚拟屏幕坐标,主屏左侧的副屏 x 恒为负。若拿主屏宽高硬套,会把副屏整条上下边缘都当成“角”。因此 corner_hit 先确认光标落在该显示器矩形内,再相对它自己的边界算角(mouse_hook.rs),配套测试覆盖了左副屏、右副屏、不同分辨率、缝隙点等场景。

五、空闲自动隐藏

开启 启用自动隐藏(auto_hide_enabled)后,当键盘和鼠标在设定时长内无任何操作时,ZoneDeck 会自动隐藏已绑定的窗口——适合临时离开工位的场景。

  • 空闲时长(auto_hide_time,默认 5 分钟):无操作达到该时长(分钟)后触发。
  • 托盘菜单快速切换:右键托盘图标,点击 自动隐藏 菜单项即可暂停 / 启用自动隐藏,无需打开设置界面;勾选标记表示当前已启用,切换结果与设置界面保持同步。托盘图标还可叠加角标显示该状态(状态源 auto_hide,见 托盘图标状态)。

实现上,idle.rs 通过 Win32 GetLastInputInfo 获取自上次键盘 / 鼠标输入以来的毫秒数,再用 should_auto_hide(idle_ms, threshold_minutes, has_records) 判定:达到阈值且当前没有已隐藏的窗口记录(has_records 指“控制器里还留着隐藏记录吗”,而不是“是否处于隐藏状态”)才触发,避免同一轮重复隐藏;阈值设为 0 则永不触发。核心在 WM_TIMER 的 AUTO_HIDE_TIMER_ID 分支里周期性地读取空闲时长并调用 apply_hide(Trigger::Idle)(agent/mod.rs)。

六、配置文件中的对应字段

所有热键与鼠标设置最终都落到配置文件 config.json(安装版位于 %APPDATA%\ZoneDeck\config.json,便携版位于 exe 同目录,定位逻辑见 paths.rs)。相关字段结构定义在 config.rs:

  • hotkey 一节:五个热键字符串(hide_hotkey、close_hotkey、hide_only_hotkey、show_only_hotkey、hide_foreground_hotkey),以及每个热键各自的 *_hook(低级键盘钩子)与 *_intercept(不传递)开关,共 15 个字段;空字符串表示该热键关闭(is_disabled)。
  • setting.mouse 一节:left / middle / right / side1 / side2 各含 enabled、clicks(1..=3)、modifiers(如 "Ctrl+Shift",空串表示不需要),另有全局的 multi_click_ms(150..=1000)与 allow_click_restore。
  • setting 顶层:auto_hide_enabled、auto_hide_time、top_left_hide / top_right_hide / bottom_left_hide / bottom_right_hide、allow_move_restore、corner_fast_only。

一份最小化的示例配置:

{
  "hotkey": {
    "hide_hotkey": "Ctrl+Q",
    "close_hotkey": "Win+Esc",
    "hide_only_hotkey": "",
    "show_only_hotkey": "",
    "hide_foreground_hotkey": "",
    "hide_hook": false,
    "hide_intercept": false,
    "close_hook": false,
    "close_intercept": false
  },
  "setting": {
    "mouse": {
      "left": { "enabled": false, "clicks": 1, "modifiers": "" },
      "middle": { "enabled": true, "clicks": 2, "modifiers": "" },
      "right": { "enabled": false, "clicks": 1, "modifiers": "" },
      "side1": { "enabled": false, "clicks": 1, "modifiers": "" },
      "side2": { "enabled": false, "clicks": 1, "modifiers": "" },
      "multi_click_ms": 350,
      "allow_click_restore": true
    },
    "auto_hide_enabled": false,
    "auto_hide_time": 5,
    "top_left_hide": false,
    "top_right_hide": false,
    "bottom_left_hide": false,
    "bottom_right_hide": false,
    "allow_move_restore": false,
    "corner_fast_only": true
  }
}

配置文件按 schema 版本管理:字段缺失时回落默认值,null 会被剥离,连击次数与连击窗口会被 normalize 夹到合法范围,旧版的扁平鼠标开关(middle_button_hide、side_button1_hide、side_button2_hide)与单一“不传递”开关也会在加载时自动迁移到新结构。

七、选择适合你的触发方式

触发方式 适用场景
键盘热键 最通用、最快捷
鼠标连击 / 侧键 手在鼠标上时更顺手
屏幕四角 无需记忆按键,甩一下即可
空闲自动隐藏 临时离开、忘记手动隐藏时的兜底

配好触发方式后,你可能还想调整隐藏时的附加行为(静音、暂停媒体、冻结进程等),请继续阅读 隐藏设置 与 进程冻结。这些附加行为与触发方式彼此正交:无论通过哪种方式隐藏,都会统一进入同一份隐藏清单,并按照统一的隐藏流程执行副作用。

登录后查看全文
ZoneDeck