WorkBuddy 遥控器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 的指南,将规范名为 @user_7571a6b4/workbuddy-remote 的技能安装到当前 AI 助手中。
技能介绍
解决移动场景下的交互摩擦
在使用 WorkBuddy 时,语音输入和频繁切换应用已成为常态。然而,每次都需要回到桌前操作鼠标和键盘,打断了在沙发或远离工位时的沉浸状态。这个技能把小米蓝牙遥控器 2 Pro 变成 macOS 上的实体遥控器,让你在远离屏幕时也能完成语音输入、应用切换和音量调节,消除来回走动的操作摩擦。
核心实现与按键注入
技能的核心是 KeyboardInjector,它负责将遥控器的物理按键转化为系统动作。为了确保稳定性,按键注入设计了三层兜底机制:
- 主路径:优先使用
CGEvent.post模拟原生键盘事件。 - 降级路径一:若主路径失效,降级到
NSAppleScript调用系统能力。 - 降级路径二:最后降级到
osascript子进程。
macOS 的系统状态对按键模拟有严格限制。例如,Command-Tab 切换器需要左 Cmd 物理键(keyCode 55)持续按住才能保持显示,而非简单的修饰符 flag;显示桌面功能(⌘F3)在 Sonoma 之后受限于签名,最终通过 osascript 子进程成功绕过权限限制。此外,12 个按键支持自定义映射,可指向返回、方向键、13 个应用启动或自定义快捷键。
适用范围与注意点
该技能基于 5378 行 Swift 编写,支持 macOS 13 到 15 系统。它依赖特定的硬件(小米蓝牙遥控器 2 Pro)以及 macOS 原生的 IOHIDManager 和 TCC Automation 权限。在映射应用切换时,需确保目标应用未拦截全局快捷键。此外,由于涉及系统级权限调用,首次运行时需在系统设置中授予辅助功能和自动化权限。
使用场景
- 窝在沙发上看视频时,不想起身碰键盘,直接用遥控器按键调节系统音量并切回桌面。
- 在进行客户演示或培训直播时,通过遥控器一键唤醒 WorkBuddy 并快速切到微信对话窗口。
- 双手保持敲击键盘的编程状态时,用遥控器快捷调整后台播放的音乐音量并查看 Slack。
- 躺在沙发上捕捉灵感时,按下遥控器按键立即唤醒语音输入,直接口述记录想法。
适合人员
- 独立开发者:习惯在沙发等远离显示器的位置进行语音编程,需要不碰鼠标的实体按键辅助。
- 技术培训师:在进行直播授课或屏幕共享演示时,需要不离开镜头范围就能控制演示软件和通讯工具。
- 远程办公者:在家中非传统工位处理工作,需要用遥控器替代键鼠完成切屏、调音量等快捷操作。