Windows键盘鼠标统计工具开发与优化实践-代码聚汇网

Windows键盘鼠标统计工具开发与优化实践

Windows钩子Raw Input APISQLite

|难度：普通|阅读约 13 分钟

1. 项目概述：键盘鼠标使用统计工具

这个开源小工具的核心功能是记录用户每天的键盘敲击和鼠标点击次数，并将数据存储到SQLite数据库中。作为一名长期与键盘为伴的程序员，我最初开发这个工具是为了量化自己的工作强度——想知道每天到底敲了多少次键盘，点击了多少次鼠标。没想到这个小工具后来在开发者社区获得了不少关注，很多同行用它来评估工作效率、分析操作习惯，甚至有人用来做键盘手托的人体工学研究。

工具采用轻量级架构设计，后台服务仅占用约5MB内存，通过底层钩子(hook)技术捕获输入事件。数据存储使用SQLite数据库，无需额外配置服务，生成的数据库文件可以直接用DB Browser for SQLite等工具查看。目前支持Windows 7及以上系统，统计维度包括：

键盘：总击键数、各键位使用频率
鼠标：点击总数、左右键分布、滚轮使用
时间维度：按小时/天/周统计图表

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 技术实现解析

2.1 输入事件捕获机制

Windows平台下实现按键统计主要依赖两种技术方案：

全局钩子(WH_KEYBOARD_LL/WH_MOUSE_LL)

cpp复制HHOOK g_keyboardHook = SetWindowsHookEx(WH_KEYBOARD_LL, KeyboardProc, NULL, 0);
LRESULT CALLBACK KeyboardProc(int nCode, WPARAM wParam, LPARAM lParam) {
    if (nCode == HC_ACTION) {
        KBDLLHOOKSTRUCT* pKey = (KBDLLHOOKSTRUCT*)lParam;
        // 记录键位码pKey->vkCode
    }
    return CallNextHookEx(g_keyboardHook, nCode, wParam, lParam);
}

这种方案的优点是兼容性好，但需要处理消息循环。我在实际开发中发现，如果主线程阻塞会导致事件丢失，因此单独创建了消息泵线程。

Raw Input API方案

cpp复制RAWINPUTDEVICE rid[2];
rid[0].usUsagePage = 0x01; 
rid[0].usUsage = 0x06; // 键盘
rid[1].usUsagePage = 0x01;
rid[1].usUsage = 0x02; // 鼠标
RegisterRawInputDevices(rid, 2, sizeof(rid[0]));

相比钩子方案，Raw Input能获取更详细的设备信息，但对鼠标移动事件的捕获需要特殊处理。实测在游戏全屏模式下表现更好。

提示：两种方案都需要管理员权限，建议在安装时通过manifest文件声明requireAdministrator。

2.2 数据存储设计

采用SQLite作为存储引擎，数据库schema设计如下：

sql复制CREATE TABLE key_events (
    id INTEGER PRIMARY KEY,
    key_code INTEGER NOT NULL,
    key_state INTEGER CHECK(key_state IN (0,1)), -- 0=按下 1=释放
    timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
    device_id TEXT -- 区分多键盘
);

CREATE TABLE mouse_events (
    id INTEGER PRIMARY KEY,
    button INTEGER CHECK(button IN (1,2,3,4,5)), -- 左/右/中/侧键
    action INTEGER CHECK(action IN ('click','wheel','move')),
    x INTEGER, y INTEGER,
    timestamp DATETIME DEFAULT CURRENT_TIMESTAMP
);

为提高写入性能，我做了以下优化：

采用WAL日志模式：PRAGMA journal_mode=WAL;
批量提交事务：每1000次事件提交一次
内存缓存：最近事件先存入内存队列

实测在i5-8250U笔记本上，这种设计可以处理超过8000次/秒的按键事件而不丢数据。

3. 使用场景与数据分析

3.1 典型应用场景

程序员效率分析
通过统计IDE快捷键使用频率，我发现自己过度依赖鼠标操作。调整习惯后，VS Code的Ctrl+P文件搜索使用率提升了47%，平均每天减少200+次鼠标切换。

游戏热键优化
一位《魔兽世界》玩家通过分析发现，他70%的技能都集中在数字键1-5。通过重新分配技能栏，将常用技能调整到更易按的键位。

键盘布局研究
收集了100多位用户的键位数据后，发现：

退格键使用频率是Delete键的15倍
右手小指主要承担Enter、Backspace等高压力键位
数字键区使用率普遍低于主键盘数字键

3.2 数据可视化方案

工具内置Python分析脚本，使用matplotlib生成三种图表：

热力图生成代码示例

python复制def plot_key_heatmap(db_path):
    conn = sqlite3.connect(db_path)
    df = pd.read_sql("SELECT key_code,COUNT(*) as count FROM key_events GROUP BY key_code", conn)
    
    # 构建键盘矩阵布局
    keymap = np.zeros((5,15)) 
    for _, row in df.iterrows():
        x,y = get_key_position(row['key_code']) # 键位映射函数
        keymap[y,x] = row['count']
    
    plt.imshow(keymap, cmap='hot', interpolation='nearest')
    plt.colorbar()
    plt.savefig('heatmap.png')

4. 常见问题与优化技巧

4.1 性能问题排查

症状：高负载下事件丢失

检查是否启用WAL模式
调整批量提交阈值：建议500-2000之间
禁用防病毒软件实时扫描数据库文件

症状：CPU占用过高

避免在钩子回调中执行复杂逻辑
使用线程池处理耗时操作
对鼠标移动事件进行采样（如每10像素记录一次）

4.2 数据准确性验证

我设计了一套自动化测试方案：

使用PyAutoGUI模拟输入
对比实际发送事件数与数据库记录数
验证时间戳连续性

测试发现的主要问题：

某些键盘的Fn键不会触发事件
鼠标双击可能被误记为两次单击
游戏全屏模式下的Alt+Tab组合丢失

5. 扩展开发建议

5.1 多平台支持

Linux版本可以通过libevdev实现：

c复制struct libevdev *dev;
int fd = open("/dev/input/event0", O_RDONLY);
libevdev_new_from_fd(fd, &dev);

while (1) {
    struct input_event ev;
    read(fd, &ev, sizeof(ev));
    if (ev.type == EV_KEY) {
        // 处理按键事件
    }
}

5.2 高级功能扩展

压力敏感统计
部分机械键盘支持模拟压力检测，可通过Raw Input获取：

cpp复制case WM_INPUT: {
    UINT size = sizeof(RAWINPUT);
    GetRawInputData((HRAWINPUT)lParam, RID_INPUT, NULL, &size, sizeof(RAWINPUTHEADER));
    
    RAWINPUT* raw = (RAWINPUT*)malloc(size);
    GetRawInputData((HRAWINPUT)lParam, RID_INPUT, raw, &size, sizeof(RAWINPUTHEADER));
    
    if (raw->header.dwType == RIM_TYPEKEYBOARD) {
        RAWKEYBOARD kb = raw->data.keyboard;
        // kb.ExtraInformation包含压力值
    }
}

蓝牙设备识别
通过设备接口详情区分多个输入设备：

cpp复制DEV_BROADCAST_DEVICEINTERFACE filter;
filter.dbcc_size = sizeof(DEV_BROADCAST_DEVICEINTERFACE);
filter.dbcc_devicetype = DBT_DEVTYP_DEVICEINTERFACE;

HDEVNOTIFY hDevNotify = RegisterDeviceNotification(
    hWnd, &filter, DEVICE_NOTIFY_WINDOW_HANDLE);

这个项目给我最大的启示是：看似简单的数据收集，经过长期积累也能产生有价值的洞察。我自己的键位数据持续记录了三年，发现每年退格键的使用率都会下降2-3%，某种程度上反映了编码准确度的提升。