Hammerspoon实现macOS粘滞键程序化控制的技术方案

背景介绍

macOS系统中的粘滞键(Sticky Keys)功能是一项辅助功能，允许用户通过顺序按键而非同时按键来执行组合键操作。但某些专业应用场景下，开发者可能需要通过编程方式控制此功能的开关状态。本文将详细介绍如何利用Hammerspoon工具实现这一需求。

技术实现方案

方案一：模拟按键事件（不推荐）

最初尝试通过Hammerspoon的hs.eventtap模块模拟五次Shift键按压：

for i=1,5 do
    hs.eventtap.event.newKeyEvent(hs.keycodes.map.shift, true):post()
    hs.timer.usleep(1000)
    hs.eventtap.event.newKeyEvent(hs.keycodes.map.shift, false):post()
    hs.timer.usleep(1000)
end

以及改进版的标志位变更事件：

for i=1,5 do
    local event = hs.eventtap.event.newEvent()
    event:setType(hs.eventtap.event.types.flagsChanged)
    event:setFlags{shift=true}:post()
    event = hs.eventtap.event.newEvent()
    event:setType(hs.eventtap.event.types.flagsChanged)
    event:setFlags{}:post()
end

但实际测试表明，系统不会响应这种程序化生成的按键事件来触发粘滞键切换。

方案二：系统偏好设置自动化（推荐）

更可靠的方案是通过Hammerspoon控制System Preferences应用界面元素：

1. 检测当前状态

local function stickyKeysAreOn()
    return (hs.execute[[defaults read com.apple.universalaccess stickyKey]]):match('(%d+)') == '1'
end

2. 自动化控制实现

local function setStickyKeys(enabled)
    if stickyKeysAreOn() == enabled then return end
    
    -- 打开系统偏好设置到指定页面
    hs.execute('osascript -e '..shellArg[[
        tell app id "com.apple.systempreferences"
            reveal anchor "Keyboard" of pane id "com.apple.preference.universalaccess"
        end
    ]])
    
    -- 查找并操作复选框
    hs.axuielement.applicationElement(hs.application.get 'com.apple.systempreferences')
        :elementSearch(function(msg, results)
            local cb = results[1]
            if (cb.AXValue == 1) ~= enabled then
                cb:doAXPress()
            end
        end, hs.axuielement.searchCriteriaFunction{
            attribute = "AXIdentifier",
            value = "UA_StickyKeys_Checkbox"
        }, {count = 1, depth = 4})
end

技术要点解析

1. 系统偏好设置自动化：

   • 使用AppleScript定位到指定设置页面
   • 通过辅助功能API(hs.axuielement)定位界面元素
   • 直接操作复选框控件(AXIdentifier为UA_StickyKeys_Checkbox)

2. 状态检测优化：

   • 通过读取系统默认值(com.apple.universalaccess.stickyKey)预先判断状态
   • 避免不必要的界面操作

3. 错误处理：

   • 包含状态判断逻辑，避免重复操作
   • 使用count和depth参数限制搜索范围

应用场景建议

1. 游戏应用：在游戏启动时自动禁用粘滞键
2. 专业软件：某些设计/开发软件可能需要临时禁用该功能
3. 无障碍辅助：根据用户场景自动切换辅助功能

注意事项

1. 需要授予Hammerspoon辅助功能权限
2. 首次执行时可能会看到系统偏好设置窗口弹出
3. 不同macOS版本可能需要调整界面元素标识符