桌面应用【免费下载链接】BongoCat BongoCat — A cross-platform interactive desktop pet that brings fun to your desktop!项目地址https://gitcode.com/gh_mirrors/bong/BongoCat点击查看免费下载导读BongoCat 的快捷键应用命令与模型行为此前由输入管线内的ShortcutMatcher被动匹配注册过的组合键仍会继续透传给前台应用且快捷键随输入服务生命周期一起失效。ADR-0044docs/adr/0044-global-hotkey-registration-backend.md决定引入 tauri-apps 维护的global-hotkeycrate把快捷键改为由操作系统注册并消费的全局热键。读完本文你将掌握BongoCat 快捷键系统的完整分层解析、映射、注册、分发、生命周期、WindowsRegisterHotKey与 macOS CarbonRegisterEventHotKey双后端线程模型、50ms 轮询增量注册的设计动机以及三个模型输入门禁快捷键的实现路径。一、Context为什么放弃输入管线内匹配在 ADR-0044 落地之前BongoCat 的快捷键由输入管线内匹配实现Windows Raw Input / macOS CGEventTap 把按键边沿映射为 HID usage 后喂给ShortcutMatcher再由ShortcutDispatcher在进程内解析目标并分发。这一方案存在两个结构性缺陷原文 Context 部分匹配是被动的注册过的组合键仍会继续传递给前台应用。用户按下组合键时系统里同时存在两个消费者——BongoCat 和当前聚焦的前台程序语义不可控。强依赖输入服务生命周期输入服务因权限问题或恢复失败退出时快捷键一并失效。产品需要对齐历史 Tauri 版本的全局快捷键语义组合键由操作系统注册并消费应用失焦或处于后台时必须可靠触发。经评审团队选择了 tauri-apps 维护的global-hotkeycratecrates.io 最新稳定版 0.8.0Apache-2.0 OR MIT 双许可活跃维护Windows 走RegisterHotKeymacOS 走 CarbonRegisterEventHotKey与历史实现的注册模型一致。从当前仓库的依赖声明可以印证这一点crates/bongocat-platform/Cargo.toml 中global-hotkey.workspace true且它仅作为bongocat-platform的 macOS/Windows 目标依赖引入配置侧不感知平台实现。二、Decision三层架构与职责边界ADR-0044 的决策可以概括为一张分层图各层只回答一个问题层位置职责不关心什么组合键解析bongocat-config的ShortcutChord把配置字符串解析为规范化 chord冲突检测平台键码、注册细节平台映射与注册管理bongocat-platform/src/shortcut.rschord →keyboard_types::Code映射、增量 register/unregister目标语义分发精简后的ShortcutDispatcher::executeruntime 触发 application sink配置字符串、平台键码这种分离在源码里被明确写在注释中crates/bongocat-platform/src/shortcut/mod.rsdispatcher 是操作系统适配器在匹配到 chord 后调用的对象它不知道配置字符串或键码global service 持有全部注册它不知道一个已匹配 chord 意味着什么。ShortcutDispatcher的实现是一个Arcdyn Fn(ShortcutTarget) - ResultShortcutDispatch, ShortcutDispatchError Send Sync回调包装execute只是转发。ShortcutDispatch的四个结果枚举Triggered/ApplicationQueued/IgnoredApplicationCommand/IgnoredInactiveModel与三个错误枚举ApplicationQueueFull/RuntimeQueueFull/RuntimeStopped共同定义了分发结果的可观测面——下文会看到它们如何驱动诊断计数器。2.1 组合键解析层ShortcutChord 的闭集词表ShortcutChord::parsecrates/bongocat-config/src/shortcuts/chord.rs把用户输入的字符串拆解为修饰符位掩码 规范化键 token修饰符别名会被归一control/ctrl→ CONTROLalt/option→ ALTshift→ SHIFTmeta/command/cmd/win/windows→ META重复修饰符报DuplicateModifier多个键报MultipleKeys缺键报MissingKey。键 token 是闭集词表而非自由解析单字母、数字加上NAMED_SHORTCUT_KEYS中列出的命名键Enter、Escape/Esc、Backspace、Tab、Space、F1–F12、方向键、标点键等均带 HID usage。词表查不到的名字直接拒绝而不是猜测。这段设计哲学在注释中反复出现一个静默解析成错误键的 chord会在用户按别的键时误触发这比一个明确不可用并如实报告的绑定更糟。canonical()则输出稳定的ControlAltShiftMetaKey排序形式用于冲突检测与后续平台注册。2.2 平台映射层shortcut_hotkey 的表格化映射shortcut_hotkeycrates/bongocat-platform/src/shortcut/global/hotkey.rs把ShortcutChord的修饰符位逐一映射到global-hotkey的ModifiersCONTROL/ALT/SHIFT/META键 token 则按规则转成keyboard_types::Code单字符大写字母 →KeyX单字符数字 →DigitX-→Minus→Equal其余名称直接parse::Code()解析失败返回ShortcutHotkeyErrorthe key has no global hotkey mapping。注意这里存在一条可被诊断捕获的边界平台无 scancode 的键如 macOS 的 ScrollLock/Pause 没有 Carbon scancode无法注册但这不会拖垮其他绑定——见下文失败容忍一节。2.3 注册镜像层先算 plan再动操作系统mirror_registrations与plan_registrationscrates/bongocat-platform/src/shortcut/global/registration.rs实现了计划—执行分离。每次表内容变化先对比当前 OS 已注册集合与期望集合得出三类增量removed表中已删除的 chord → unregister 并遗忘added新进入的 chord → register 并记录retargetedchord 仍在但目标模型/命令变了 → 只更新本地registered里的 target不重新注册重新注册会被 OS 拒绝或造成重复注册。这里有一个精妙的注册身份判定注册身份是 hotkey id即 chord 本身而非整个绑定。原因源码注释与测试a_model_switch_hands_the_shared_chords_to_the_incoming_model双重印证两个模型可能合法绑定同一 chord——每个模型都从主修饰符的第一个数字开始计数自己的默认行为快捷键同一时刻只有一个模型存活。模型切换时大部分 chord 保持注册、只是背后的 target 换到新模型。如果镜像层把这种 chord 误判为已注册而跳过platform 就会继续指向旧模型分发时被作为 inactive model 丢弃——新模型的默认行为快捷键将静默失效。mirror_registrations通过泛型 traitHotkeyRegistrar抽象 OS 注册面生产环境用GlobalHotKeyManager测试用 FakeRegistrar从而在不抢占测试机真实全局热键的前提下演练整棵对账逻辑。另外还有一个细节被卸载的绑定永远不会上报 release所以每次对账先用pressed.retain(bound)丢弃已离开表的 held id避免同一 chord 重新绑定后的第一次按下被吞掉。2.4 owner 线程主循环50ms 轮询 事件消费run_shortcut_ownercrates/bongocat-platform/src/shortcut/global/owner.rs是服务的核心循环每次迭代做三件事table.load()读取共享表与上次快照比较变化则执行desired_registrationsmirror_registrations增量对账用GlobalHotKeyEvent::receiver().try_recv()排空热键事件队列命中注册则dispatcher.execute(registration.target)wait_and_pump(TABLE_POLL_INTERVAL)等待下一轮。轮询而非通知通道的动机ShortcutTable::replace的全部发布点set_shortcuts、录制 suspend/resume、行为快捷键开关、恢复默认都被 50ms 轮询自然覆盖无需新增任何通知机制。crates/bongocat-platform/src/shortcut/global/service.rs 中TABLE_POLL_INTERVAL Duration::from_millis(50)并配以 2 秒的STARTUP_TIMEOUT。2.5 按键边沿去重PressEdgesPressEdges解决了两个后端共有的一个坑操作系统会对持续按住的 chord 重复上报PressedWindows 的每个WM_HOTKEY、Carbon handler 的每次 auto-repeat 都会被转发。如果直接按Pressed分发一次物理按下会变成一串触发。PressEdges用BTreeSetu32记录 held idPressed且 id 未在集合中 → 是按下边沿分发一次插入集合Released→ 移除重新武装表变更卸载的 id 通过retain清出集合。测试a_table_change_re_arms_bindings_it_unregistered验证了chord 离开表时从未收到 release回来后必须重新武装这一边界。2.6 GlobalShortcutService 生命周期与诊断GlobalShortcutServiceservice.rs是应用持有的句柄start(table, dispatcher)在命名线程bongocat-global-shortcuts上创建 manager 并等待 2 秒启动确认stop()置停止标志并 join 线程过程中注销全部注册Drop兜底剩余路径。它还通过GlobalShortcutCounters暴露三个原子诊断计数registration_failures平台拒绝的注册/注销次数queue_overflows应用或 runtime 队列满导致的分发丢弃runtime_stopped_eventsruntime 已停止时的触发次数。分发错误到计数器的映射在 owner 循环中可见ApplicationQueueFull/RuntimeQueueFull计入queue_overflowsRuntimeStopped计入runtime_stopped_events。同时registration_failures()返回字符串列表如 Control1: ...供诊断消费。三、平台线程模型Windows 消息泵与 macOS CarbonADR-0044 明确了两端截然不同的线程要求WindowsWM_HOTKEY被投递到创建 manager 隐藏窗口的线程队列因此 owner 线程不能 sleep必须跑消息泵。crates/bongocat-platform/src/shortcut/global/owner.rs 中平台门控的wait_and_pump用MsgWaitForMultipleObjectsExQS_ALLINPUTMWMO_INPUTAVAILABLE等待 50ms 轮询间隔内到达的输入再用PeekMessageWTranslateMessageDispatchMessageW排空队列保证 manager 窗口的 window procedure 能收到热键消息。macOS热键事件经 Carbon handler 在主事件循环投递应用 runloop 泵送在 owner 后台线程上创建/注册/注销RegisterEventHotKey已通过本机反向控制实验验证可行因此 macOS 的wait_and_pump只需std::thread::sleep(interval)。这一差异直接解释了为什么wait_and_pump会有两份平台门控定义也说明GlobalShortcutService::start的设计前提——manager 在 owner 线程上创建调用方无需处于平台主线程——在两端都成立。四、生命周期启动与关停顺序快捷键服务在产品 run 启动阶段创建crates/bongocat-app/src/main.rs 中GlobalShortcutService::start(application.shortcut_table(), application_shortcut_dispatcher(...))位于 overlay 与 settings service 之前启动失败会把错误记入ProductRunError直接终止运行。关停顺序是 ADR-0044 的硬性要求begin_product_shutdown中先于overlay.stop_input()停止并注销全部注册。见 crates/bongocat-app/src/product_shutdown.rs// Registered hotkeys must stop consuming keys before any service that // would re-trigger them is torn down. if let Some(shortcut_service) coordinator.shortcut_service.take() let Err(error) shortcut_service.stop() { ... } if let Err(error) overlay.stop_input() { ... }注释点明动机已注册的热键必须先停止消费按键再拆除可能被它们重新触发的服务否则关停窗口内会出现服务已半死、热键仍触发的竞态。ADR 同时要求移除输入管线中的全部快捷键喂点apply/reset/reconcile、WindowsInputService/MacInputService的_and_shortcuts启动入口、OverlayInteractionSinks的shortcut_dispatcher字段——快捷键从此与输入服务生命周期完全解耦。五、配置对接ShortcutTable 与默认配置配置 schema 不变快捷键配置在 shared/config/fixtures/default.json 中形如shortcuts: { commands_enabled: true, command_bindings: [], model_behavior_bindings: [], model_behaviors_enabled: false }CompiledShortcuts::compilecrates/bongocat-config/src/shortcuts/compiled.rs把command_bindingsShortcutBinding { command, shortcut }与model_behavior_bindingsModelBehaviorBinding { model, behavior_id, shortcut }编译为统一的CompiledShortcut { chord, target }集合并用BTreeSet以canonical()为键做跨两类绑定的全局冲突检测冲突直接返回ConfigError::InvalidValue(shortcuts.conflict)。行为动作通过behavior_id持久化为motion:group:index或expression:name两种形式canonical 化与默认赋值走同一路径保证生成的绑定与用户录制的绑定拼写一致crates/bongocat-config/src/shortcuts/command.rs。ShortcutTable本身是一个ArcRwLockCompiledShortcuts包装对外只暴露load()clone 快照与replace()整体替换。发布者永远替换完整表、读者永远读快照因此配置提交发布的新表对 owner 线程可见且读者不会观察到半解析的绑定或持有配置写锁——这是无通知通道轮询能成立的前提。六、三个新命令模型输入门禁快捷键ADR-0044 在原有ShortcutCommand集合toggle_overlay、open_settings之外新增三个 application target命令字符串枚举变体作用toggle_ignore_mouse_inputToggleIgnoreMouseInput切换鼠标输入门禁toggle_ignore_keyboard_inputToggleIgnoreKeyboardInput切换键盘输入门禁toggle_ignore_gamepad_inputToggleIgnoreGamepadInput切换手柄输入门禁三个 target 都经同一个 settings-service typed handoffcrates/bongocat-app/src/settings/projection.rs 中映射到SettingsApplicationShortcut::ToggleIgnore*并由set_shortcuts提交见 crates/bongocat-app/src/application/settings_commands.rs切换并持久化对应的模型输入门禁——对应 default.json 中model.ignore_pointer/model.ignore_keyboard/model.ignore_gamepad三个字段——不直接修改 runtime 或平台输入状态。这保证了键盘/鼠标/手柄的可靠采集与 pressed-state 恢复Issue #47 的校正路径不受门禁切换影响。这三个快捷键与普通应用快捷键共享同一录制、冲突检测与commands_enabled门禁设置端测试crates/bongocat-app/src/settings/tests/shortcuts.rs与模型投影测试crates/bongocat-app/src/settings/tests/models.rs分别覆盖了它们的提交路径与投影语义。七、注册失败容忍与诊断边界ADR-0044 的一个显式决策是注册失败不阻塞其他绑定。某个组合键被其他应用占用或平台无 scancodemacOS 的 ScrollLock/Pause 没有 Carbon scancode时该 chord 记入registration_failures诊断列表格式chord: error其余绑定照常注册。desired_registrations在编译阶段就区分可注册与不可注册两类不可注册项以字符串形式进 failuresmirror_registrations对运行时 register/unregister 错误同样只计数并记录不中断对账循环。源码注释给了一个生动的例子一个唯一不可注册 chord 是 ScrollLock 的模型它的其他十二个快捷键仍然应该全部工作。八、Consequences可预期的行为变化与边界ADR-0044 记录的行为变化需要使用者知晓组合键被操作系统消费注册过的快捷键不再同时传递给前台应用——这是与历史 Tauri 版本一致、属于预期语义的变化。macOS 权限边界快捷键注册本身不要求辅助功能权限Carbon 注册但猫爪动画的全键盘监听仍依赖 CGEventTapTCC 授权要求不变。生命周期解耦快捷键不再随输入服务失败而失效输入服务的恢复/重置路径与快捷键状态完全解耦Issue #47 的 pressed-state 校正只服务动画输入。改绑延迟服务按 50ms 轮询感知改绑录制 suspend/resume 的生效延迟 ≤ 100ms。测试方面crates/bongocat-platform/src/shortcut/global/tests/registration.rs 用 FakeRegistrar 覆盖了三个关键场景表变更后重新武装已卸载的绑定、模型切换时共享 chord 移交到新模型且不重复注册、离开表又回归的 chord 能被重新注册crates/bongocat-platform/src/shortcut/global/tests/owner.rs 等其余测试覆盖服务与热键层。这些测试与 ADR 中的决策一一对应是理解本 ADR 落地质量的最佳入口。九、小结ADR-0044 的核心价值是把 BongoCat 的快捷键从输入管线内的被动匹配迁移为操作系统级的主动注册从而同时获得三件事应用失焦/后台时的可靠触发、与输入服务生命周期的解耦、以及对历史 Tauri 语义的对齐。实现上bongocat-config的闭集词表解析、bongocat-platform的表格化键码映射与增量对账、50ms 轮询的无通知发布订阅、双平台的线程模型适配、以及注册失败的诊断化容忍构成了一个可独立测试、可增量演进、失败不扩散的完整子系统。对开发者而言理解这条链路的关键在于记住每一层只回答一个问题的职责边界——这也是整个实现最值得借鉴的架构取舍。赞分享桌面应用【免费下载链接】BongoCat BongoCat — A cross-platform interactive desktop pet that brings fun to your desktop!项目地址https://gitcode.com/gh_mirrors/bong/BongoCat点击查看免费下载相关推荐Tuta 桌面端本地快捷键注册机制深入解析 electron-localshortcut 的移植与改造Tuta 桌面端本地快捷键注册机制深入解析 electron localshortcut 的移植与改造 导读 本文围绕 TutaTutanota桌面端移植协同办公密码学如何用 OpenCV 消除水下图像散射与偏色颜色校正完整实战指南如何用 OpenCV 消除水下图像散射与偏色颜色校正完整实战指南 ! 水下图像处理流程示意图直方图均衡化前后效果对比 https://raw.gitcode计算机视觉图像处理深度学习机器学习Druid全局快捷键注册跨窗口事件响应实现Druid全局快捷键注册跨窗口事件响应实现 你是否在开发多窗口应用时遇到快捷键冲突是否需要让某些操作在任何窗口都能响应Druid框架的全局快捷键系统能帮你跨平台桌面应用UI组件上一篇如何在3分钟内通过手机号找回QQ账号终极快速解决方案下一篇PEFT 中的 GLoRA 详解可配置路径的广义低秩适配Generalized Low-Rank Adaptation创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
BongoCat 全局快捷键注册制后端改造解析：ADR-0044 的架构、实现与移植实践
桌面应用【免费下载链接】BongoCat BongoCat — A cross-platform interactive desktop pet that brings fun to your desktop!项目地址https://gitcode.com/gh_mirrors/bong/BongoCat点击查看免费下载导读BongoCat 的快捷键应用命令与模型行为此前由输入管线内的ShortcutMatcher被动匹配注册过的组合键仍会继续透传给前台应用且快捷键随输入服务生命周期一起失效。ADR-0044docs/adr/0044-global-hotkey-registration-backend.md决定引入 tauri-apps 维护的global-hotkeycrate把快捷键改为由操作系统注册并消费的全局热键。读完本文你将掌握BongoCat 快捷键系统的完整分层解析、映射、注册、分发、生命周期、WindowsRegisterHotKey与 macOS CarbonRegisterEventHotKey双后端线程模型、50ms 轮询增量注册的设计动机以及三个模型输入门禁快捷键的实现路径。一、Context为什么放弃输入管线内匹配在 ADR-0044 落地之前BongoCat 的快捷键由输入管线内匹配实现Windows Raw Input / macOS CGEventTap 把按键边沿映射为 HID usage 后喂给ShortcutMatcher再由ShortcutDispatcher在进程内解析目标并分发。这一方案存在两个结构性缺陷原文 Context 部分匹配是被动的注册过的组合键仍会继续传递给前台应用。用户按下组合键时系统里同时存在两个消费者——BongoCat 和当前聚焦的前台程序语义不可控。强依赖输入服务生命周期输入服务因权限问题或恢复失败退出时快捷键一并失效。产品需要对齐历史 Tauri 版本的全局快捷键语义组合键由操作系统注册并消费应用失焦或处于后台时必须可靠触发。经评审团队选择了 tauri-apps 维护的global-hotkeycratecrates.io 最新稳定版 0.8.0Apache-2.0 OR MIT 双许可活跃维护Windows 走RegisterHotKeymacOS 走 CarbonRegisterEventHotKey与历史实现的注册模型一致。从当前仓库的依赖声明可以印证这一点crates/bongocat-platform/Cargo.toml 中global-hotkey.workspace true且它仅作为bongocat-platform的 macOS/Windows 目标依赖引入配置侧不感知平台实现。二、Decision三层架构与职责边界ADR-0044 的决策可以概括为一张分层图各层只回答一个问题层位置职责不关心什么组合键解析bongocat-config的ShortcutChord把配置字符串解析为规范化 chord冲突检测平台键码、注册细节平台映射与注册管理bongocat-platform/src/shortcut.rschord →keyboard_types::Code映射、增量 register/unregister目标语义分发精简后的ShortcutDispatcher::executeruntime 触发 application sink配置字符串、平台键码这种分离在源码里被明确写在注释中crates/bongocat-platform/src/shortcut/mod.rsdispatcher 是操作系统适配器在匹配到 chord 后调用的对象它不知道配置字符串或键码global service 持有全部注册它不知道一个已匹配 chord 意味着什么。ShortcutDispatcher的实现是一个Arcdyn Fn(ShortcutTarget) - ResultShortcutDispatch, ShortcutDispatchError Send Sync回调包装execute只是转发。ShortcutDispatch的四个结果枚举Triggered/ApplicationQueued/IgnoredApplicationCommand/IgnoredInactiveModel与三个错误枚举ApplicationQueueFull/RuntimeQueueFull/RuntimeStopped共同定义了分发结果的可观测面——下文会看到它们如何驱动诊断计数器。2.1 组合键解析层ShortcutChord 的闭集词表ShortcutChord::parsecrates/bongocat-config/src/shortcuts/chord.rs把用户输入的字符串拆解为修饰符位掩码 规范化键 token修饰符别名会被归一control/ctrl→ CONTROLalt/option→ ALTshift→ SHIFTmeta/command/cmd/win/windows→ META重复修饰符报DuplicateModifier多个键报MultipleKeys缺键报MissingKey。键 token 是闭集词表而非自由解析单字母、数字加上NAMED_SHORTCUT_KEYS中列出的命名键Enter、Escape/Esc、Backspace、Tab、Space、F1–F12、方向键、标点键等均带 HID usage。词表查不到的名字直接拒绝而不是猜测。这段设计哲学在注释中反复出现一个静默解析成错误键的 chord会在用户按别的键时误触发这比一个明确不可用并如实报告的绑定更糟。canonical()则输出稳定的ControlAltShiftMetaKey排序形式用于冲突检测与后续平台注册。2.2 平台映射层shortcut_hotkey 的表格化映射shortcut_hotkeycrates/bongocat-platform/src/shortcut/global/hotkey.rs把ShortcutChord的修饰符位逐一映射到global-hotkey的ModifiersCONTROL/ALT/SHIFT/META键 token 则按规则转成keyboard_types::Code单字符大写字母 →KeyX单字符数字 →DigitX-→Minus→Equal其余名称直接parse::Code()解析失败返回ShortcutHotkeyErrorthe key has no global hotkey mapping。注意这里存在一条可被诊断捕获的边界平台无 scancode 的键如 macOS 的 ScrollLock/Pause 没有 Carbon scancode无法注册但这不会拖垮其他绑定——见下文失败容忍一节。2.3 注册镜像层先算 plan再动操作系统mirror_registrations与plan_registrationscrates/bongocat-platform/src/shortcut/global/registration.rs实现了计划—执行分离。每次表内容变化先对比当前 OS 已注册集合与期望集合得出三类增量removed表中已删除的 chord → unregister 并遗忘added新进入的 chord → register 并记录retargetedchord 仍在但目标模型/命令变了 → 只更新本地registered里的 target不重新注册重新注册会被 OS 拒绝或造成重复注册。这里有一个精妙的注册身份判定注册身份是 hotkey id即 chord 本身而非整个绑定。原因源码注释与测试a_model_switch_hands_the_shared_chords_to_the_incoming_model双重印证两个模型可能合法绑定同一 chord——每个模型都从主修饰符的第一个数字开始计数自己的默认行为快捷键同一时刻只有一个模型存活。模型切换时大部分 chord 保持注册、只是背后的 target 换到新模型。如果镜像层把这种 chord 误判为已注册而跳过platform 就会继续指向旧模型分发时被作为 inactive model 丢弃——新模型的默认行为快捷键将静默失效。mirror_registrations通过泛型 traitHotkeyRegistrar抽象 OS 注册面生产环境用GlobalHotKeyManager测试用 FakeRegistrar从而在不抢占测试机真实全局热键的前提下演练整棵对账逻辑。另外还有一个细节被卸载的绑定永远不会上报 release所以每次对账先用pressed.retain(bound)丢弃已离开表的 held id避免同一 chord 重新绑定后的第一次按下被吞掉。2.4 owner 线程主循环50ms 轮询 事件消费run_shortcut_ownercrates/bongocat-platform/src/shortcut/global/owner.rs是服务的核心循环每次迭代做三件事table.load()读取共享表与上次快照比较变化则执行desired_registrationsmirror_registrations增量对账用GlobalHotKeyEvent::receiver().try_recv()排空热键事件队列命中注册则dispatcher.execute(registration.target)wait_and_pump(TABLE_POLL_INTERVAL)等待下一轮。轮询而非通知通道的动机ShortcutTable::replace的全部发布点set_shortcuts、录制 suspend/resume、行为快捷键开关、恢复默认都被 50ms 轮询自然覆盖无需新增任何通知机制。crates/bongocat-platform/src/shortcut/global/service.rs 中TABLE_POLL_INTERVAL Duration::from_millis(50)并配以 2 秒的STARTUP_TIMEOUT。2.5 按键边沿去重PressEdgesPressEdges解决了两个后端共有的一个坑操作系统会对持续按住的 chord 重复上报PressedWindows 的每个WM_HOTKEY、Carbon handler 的每次 auto-repeat 都会被转发。如果直接按Pressed分发一次物理按下会变成一串触发。PressEdges用BTreeSetu32记录 held idPressed且 id 未在集合中 → 是按下边沿分发一次插入集合Released→ 移除重新武装表变更卸载的 id 通过retain清出集合。测试a_table_change_re_arms_bindings_it_unregistered验证了chord 离开表时从未收到 release回来后必须重新武装这一边界。2.6 GlobalShortcutService 生命周期与诊断GlobalShortcutServiceservice.rs是应用持有的句柄start(table, dispatcher)在命名线程bongocat-global-shortcuts上创建 manager 并等待 2 秒启动确认stop()置停止标志并 join 线程过程中注销全部注册Drop兜底剩余路径。它还通过GlobalShortcutCounters暴露三个原子诊断计数registration_failures平台拒绝的注册/注销次数queue_overflows应用或 runtime 队列满导致的分发丢弃runtime_stopped_eventsruntime 已停止时的触发次数。分发错误到计数器的映射在 owner 循环中可见ApplicationQueueFull/RuntimeQueueFull计入queue_overflowsRuntimeStopped计入runtime_stopped_events。同时registration_failures()返回字符串列表如 Control1: ...供诊断消费。三、平台线程模型Windows 消息泵与 macOS CarbonADR-0044 明确了两端截然不同的线程要求WindowsWM_HOTKEY被投递到创建 manager 隐藏窗口的线程队列因此 owner 线程不能 sleep必须跑消息泵。crates/bongocat-platform/src/shortcut/global/owner.rs 中平台门控的wait_and_pump用MsgWaitForMultipleObjectsExQS_ALLINPUTMWMO_INPUTAVAILABLE等待 50ms 轮询间隔内到达的输入再用PeekMessageWTranslateMessageDispatchMessageW排空队列保证 manager 窗口的 window procedure 能收到热键消息。macOS热键事件经 Carbon handler 在主事件循环投递应用 runloop 泵送在 owner 后台线程上创建/注册/注销RegisterEventHotKey已通过本机反向控制实验验证可行因此 macOS 的wait_and_pump只需std::thread::sleep(interval)。这一差异直接解释了为什么wait_and_pump会有两份平台门控定义也说明GlobalShortcutService::start的设计前提——manager 在 owner 线程上创建调用方无需处于平台主线程——在两端都成立。四、生命周期启动与关停顺序快捷键服务在产品 run 启动阶段创建crates/bongocat-app/src/main.rs 中GlobalShortcutService::start(application.shortcut_table(), application_shortcut_dispatcher(...))位于 overlay 与 settings service 之前启动失败会把错误记入ProductRunError直接终止运行。关停顺序是 ADR-0044 的硬性要求begin_product_shutdown中先于overlay.stop_input()停止并注销全部注册。见 crates/bongocat-app/src/product_shutdown.rs// Registered hotkeys must stop consuming keys before any service that // would re-trigger them is torn down. if let Some(shortcut_service) coordinator.shortcut_service.take() let Err(error) shortcut_service.stop() { ... } if let Err(error) overlay.stop_input() { ... }注释点明动机已注册的热键必须先停止消费按键再拆除可能被它们重新触发的服务否则关停窗口内会出现服务已半死、热键仍触发的竞态。ADR 同时要求移除输入管线中的全部快捷键喂点apply/reset/reconcile、WindowsInputService/MacInputService的_and_shortcuts启动入口、OverlayInteractionSinks的shortcut_dispatcher字段——快捷键从此与输入服务生命周期完全解耦。五、配置对接ShortcutTable 与默认配置配置 schema 不变快捷键配置在 shared/config/fixtures/default.json 中形如shortcuts: { commands_enabled: true, command_bindings: [], model_behavior_bindings: [], model_behaviors_enabled: false }CompiledShortcuts::compilecrates/bongocat-config/src/shortcuts/compiled.rs把command_bindingsShortcutBinding { command, shortcut }与model_behavior_bindingsModelBehaviorBinding { model, behavior_id, shortcut }编译为统一的CompiledShortcut { chord, target }集合并用BTreeSet以canonical()为键做跨两类绑定的全局冲突检测冲突直接返回ConfigError::InvalidValue(shortcuts.conflict)。行为动作通过behavior_id持久化为motion:group:index或expression:name两种形式canonical 化与默认赋值走同一路径保证生成的绑定与用户录制的绑定拼写一致crates/bongocat-config/src/shortcuts/command.rs。ShortcutTable本身是一个ArcRwLockCompiledShortcuts包装对外只暴露load()clone 快照与replace()整体替换。发布者永远替换完整表、读者永远读快照因此配置提交发布的新表对 owner 线程可见且读者不会观察到半解析的绑定或持有配置写锁——这是无通知通道轮询能成立的前提。六、三个新命令模型输入门禁快捷键ADR-0044 在原有ShortcutCommand集合toggle_overlay、open_settings之外新增三个 application target命令字符串枚举变体作用toggle_ignore_mouse_inputToggleIgnoreMouseInput切换鼠标输入门禁toggle_ignore_keyboard_inputToggleIgnoreKeyboardInput切换键盘输入门禁toggle_ignore_gamepad_inputToggleIgnoreGamepadInput切换手柄输入门禁三个 target 都经同一个 settings-service typed handoffcrates/bongocat-app/src/settings/projection.rs 中映射到SettingsApplicationShortcut::ToggleIgnore*并由set_shortcuts提交见 crates/bongocat-app/src/application/settings_commands.rs切换并持久化对应的模型输入门禁——对应 default.json 中model.ignore_pointer/model.ignore_keyboard/model.ignore_gamepad三个字段——不直接修改 runtime 或平台输入状态。这保证了键盘/鼠标/手柄的可靠采集与 pressed-state 恢复Issue #47 的校正路径不受门禁切换影响。这三个快捷键与普通应用快捷键共享同一录制、冲突检测与commands_enabled门禁设置端测试crates/bongocat-app/src/settings/tests/shortcuts.rs与模型投影测试crates/bongocat-app/src/settings/tests/models.rs分别覆盖了它们的提交路径与投影语义。七、注册失败容忍与诊断边界ADR-0044 的一个显式决策是注册失败不阻塞其他绑定。某个组合键被其他应用占用或平台无 scancodemacOS 的 ScrollLock/Pause 没有 Carbon scancode时该 chord 记入registration_failures诊断列表格式chord: error其余绑定照常注册。desired_registrations在编译阶段就区分可注册与不可注册两类不可注册项以字符串形式进 failuresmirror_registrations对运行时 register/unregister 错误同样只计数并记录不中断对账循环。源码注释给了一个生动的例子一个唯一不可注册 chord 是 ScrollLock 的模型它的其他十二个快捷键仍然应该全部工作。八、Consequences可预期的行为变化与边界ADR-0044 记录的行为变化需要使用者知晓组合键被操作系统消费注册过的快捷键不再同时传递给前台应用——这是与历史 Tauri 版本一致、属于预期语义的变化。macOS 权限边界快捷键注册本身不要求辅助功能权限Carbon 注册但猫爪动画的全键盘监听仍依赖 CGEventTapTCC 授权要求不变。生命周期解耦快捷键不再随输入服务失败而失效输入服务的恢复/重置路径与快捷键状态完全解耦Issue #47 的 pressed-state 校正只服务动画输入。改绑延迟服务按 50ms 轮询感知改绑录制 suspend/resume 的生效延迟 ≤ 100ms。测试方面crates/bongocat-platform/src/shortcut/global/tests/registration.rs 用 FakeRegistrar 覆盖了三个关键场景表变更后重新武装已卸载的绑定、模型切换时共享 chord 移交到新模型且不重复注册、离开表又回归的 chord 能被重新注册crates/bongocat-platform/src/shortcut/global/tests/owner.rs 等其余测试覆盖服务与热键层。这些测试与 ADR 中的决策一一对应是理解本 ADR 落地质量的最佳入口。九、小结ADR-0044 的核心价值是把 BongoCat 的快捷键从输入管线内的被动匹配迁移为操作系统级的主动注册从而同时获得三件事应用失焦/后台时的可靠触发、与输入服务生命周期的解耦、以及对历史 Tauri 语义的对齐。实现上bongocat-config的闭集词表解析、bongocat-platform的表格化键码映射与增量对账、50ms 轮询的无通知发布订阅、双平台的线程模型适配、以及注册失败的诊断化容忍构成了一个可独立测试、可增量演进、失败不扩散的完整子系统。对开发者而言理解这条链路的关键在于记住每一层只回答一个问题的职责边界——这也是整个实现最值得借鉴的架构取舍。赞分享桌面应用【免费下载链接】BongoCat BongoCat — A cross-platform interactive desktop pet that brings fun to your desktop!项目地址https://gitcode.com/gh_mirrors/bong/BongoCat点击查看免费下载相关推荐Tuta 桌面端本地快捷键注册机制深入解析 electron-localshortcut 的移植与改造Tuta 桌面端本地快捷键注册机制深入解析 electron localshortcut 的移植与改造 导读 本文围绕 TutaTutanota桌面端移植协同办公密码学如何用 OpenCV 消除水下图像散射与偏色颜色校正完整实战指南如何用 OpenCV 消除水下图像散射与偏色颜色校正完整实战指南 ! 水下图像处理流程示意图直方图均衡化前后效果对比 https://raw.gitcode计算机视觉图像处理深度学习机器学习Druid全局快捷键注册跨窗口事件响应实现Druid全局快捷键注册跨窗口事件响应实现 你是否在开发多窗口应用时遇到快捷键冲突是否需要让某些操作在任何窗口都能响应Druid框架的全局快捷键系统能帮你跨平台桌面应用UI组件上一篇如何在3分钟内通过手机号找回QQ账号终极快速解决方案下一篇PEFT 中的 GLoRA 详解可配置路径的广义低秩适配Generalized Low-Rank Adaptation创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
