MacOS下如何读取小键盘输入并阻止其按键事件传递？

可行性说明 #

macOS的安全机制（隐私权限、沙箱限制）确实限制了普通全局钩子的事件拦截能力，但通过直接与HID（人机接口设备）底层交互，完全可以实现单独捕获指定小键盘输入并阻止系统分发其事件。核心思路是绕过系统的常规输入事件管道，直接与小键盘设备建立通信，同时抢占设备控制权，让系统不再将其识别为普通键盘。

实现方案 #

一、Python方案（基于hidapi库） #

1. 依赖安装

pip install hidapi

2. 核心代码

首先通过ioreg -p IOUSB -l -w 0命令查询你的小键盘的Vendor ID和Product ID（十六进制格式），替换到代码中：

import hid

# 替换为你的小键盘厂商ID和产品ID（十六进制转十进制）
VENDOR_ID = 0x1234
PRODUCT_ID = 0x5678

def handle_keyboard_input(report):
    # 此处根据小键盘的HID报告格式解析具体按键
    # 示例：打印原始报告，实际需根据设备协议调整解析逻辑
    print(f"捕获按键报告: {report}")

def main():
    try:
        device = hid.device()
        device.open(VENDOR_ID, PRODUCT_ID)
        print("小键盘已连接，开始监听输入...")
        
        while True:
            # 读取HID输入报告（长度需匹配设备规格）
            report = device.read(64)
            if report:
                handle_keyboard_input(report)
    except Exception as e:
        print(f"错误: {str(e)}")
    finally:
        device.close()

if __name__ == "__main__":
    main()

注意事项

• 需给Python进程赋予输入监控权限：系统偏好设置 > 安全性与隐私 > 隐私 > 输入监控，添加终端或Python应用
• 不同小键盘的HID报告格式不同，需通过抓包工具（如Wireshark）或设备文档解析按键对应的报告数据

二、Node.js方案（基于node-hid库） #

1. 依赖安装

npm install node-hid

2. 核心代码

同样需要先获取小键盘的Vendor ID和Product ID：

const HID = require('node-hid');

// 替换为你的小键盘厂商ID和产品ID（十六进制）
const VENDOR_ID = 0x1234;
const PRODUCT_ID = 0x5678;

// 查找目标设备
const targetDevices = HID.devices(VENDOR_ID, PRODUCT_ID);
if (targetDevices.length === 0) {
    console.error("未找到目标小键盘");
    process.exit(1);
}

// 打开设备并监听输入
const device = new HID.HID(targetDevices[0].path);
console.log("小键盘已连接，开始监听输入...");

device.on('data', (data) => {
    // 解析HID报告并处理按键事件
    console.log(`捕获按键报告: ${data.toString('hex')}`);
});

device.on('error', (err) => {
    console.error("设备错误:", err);
    device.close();
});

// 退出时清理设备连接
process.on('SIGINT', () => {
    device.close();
    process.exit(0);
});

注意事项

• 需给Node.js进程赋予输入监控权限
• 部分设备可能需要root权限才能打开，可通过sudo node your-script.js运行

三、原生Swift方案（基于IOKit框架） #

如果上述跨平台方案存在兼容性问题，可使用macOS原生框架实现更稳定的控制：

核心代码片段

import IOKit.hid

class KeyboardController {
    private var hidManager: IOHIDManager!
    
    init(vendorID: UInt32, productID: UInt32) {
        hidManager = IOHIDManagerCreate(kCFAllocatorDefault, kIOHIDOptionsTypeNone)
        
        // 设置设备匹配规则
        let matchDict = [
            kIOHIDVendorIDKey: vendorID,
            kIOHIDProductIDKey: productID
        ] as CFDictionary
        IOHIDManagerSetDeviceMatching(hidManager, matchDict)
        
        // 注册设备连接回调
        IOHIDManagerRegisterDeviceMatchingCallback(hidManager, { context, _, _, device in
            guard let monitor = unsafeBitCast(context, to: KeyboardController.self) else { return }
            monitor.setupDevice(device: device)
        }, Unmanaged.passUnretained(self).toOpaque())
        
        // 启动设备管理器
        IOHIDManagerOpen(hidManager, kIOHIDOptionsTypeNone)
    }
    
    private func setupDevice(device: IOHIDDevice) {
        // 抢占设备控制权，阻止系统处理其输入
        let status = IOHIDDeviceOpen(device, kIOHIDOptionsTypeSeizeDevice)
        guard status == kIOReturnSuccess else {
            print("无法抢占设备，错误码: \(status)")
            return
        }
        
        // 注册输入报告回调
        IOHIDDeviceRegisterInputReportCallback(device, nil, 0, { _, _, _, report, length in
            guard let reportData = report else { return }
            let data = Data(bytes: reportData, count: length)
            print("捕获按键报告: \(data.hexEncodedString())")
        }, Unmanaged.passUnretained(self).toOpaque())
    }
}

// 扩展Data用于十六进制打印
extension Data {
    func hexEncodedString() -> String {
        map { String(format: "%02hhx", $0) }.joined()
    }
}

// 使用示例
let controller = KeyboardController(vendorID: 0x1234, productID: 0x5678)
RunLoop.main.run()

注意事项

• 需要在Xcode中创建命令行工具或应用，添加IOKit框架依赖
• 应用需启用输入监控权限并完成代码签名才能正常运行

关键总结 #

1. 普通全局钩子库（如keyboard/pynput）无法实现事件拦截，必须通过HID底层交互
2. 必须通过Vendor ID和Product ID精准定位目标小键盘
3. 所有方案都需要给应用赋予输入监控系统权限
4. 通过kIOHIDOptionsTypeSeizeDevice（原生方案）或直接读取HID报告（跨平台方案），可阻止系统处理小键盘的输入事件

内容的提问来源于stack exchange，提问作者Seph Reed