简介这是一份面向编程爱好者与游戏开发初学者的开源趣味工具包基于Bongocat-osu项目二次开发的「超萌猫咪代打全键盘版」将键盘敲击实时映射为猫咪爪子动画兼顾打字练习、节奏训练与代码学习三重目标。资源共352个文件含283张PNG猫咪动作帧图、28个JSON配置与动画参数文件、21个FLAC高品质音效、13个核心DLL运行库如SFML图形音频组件、OpenAL音频引擎、WPF Material Design主题库等以及2个可执行程序整体14.46MB开箱即用且结构清晰便于理解动画驱动逻辑与多媒体集成方式。已有1863人学习下载适合想通过趣味项目掌握事件监听、资源加载、跨平台多媒体开发SFML及WPF界面设计的实践者。1. “超萌猫咪代打全键盘版”不是拟人化彩蛋而是面向自动化交互场景的轻量级键盘事件模拟框架解决UI测试、批量录入、无障碍辅助中「非浏览器环境纯键位驱动」的刚性需求你有没有遇到过这种场景某内部管理系统只提供Windows桌面客户端没有API也没有Web端测试团队每天要人工点击200次“确认提交”重复敲击AltS→Tab×3→Enter或者视障用户需要把语音指令映射成精确的CtrlShift数字键组合来切换窗口标签——这时候“用Python调用selenium”行不通“写个AutoHotkey脚本但部署到无管理员权限的工位机上被杀软拦截”也翻车了。所谓“超萌猫咪代打全键盘版”本质是一个去图形依赖、零外部运行时、仅通过Windows原生INPUT结构体注入键码的极简键盘自动化方案。它不截图、不OCR、不依赖焦点窗口标题匹配只认物理键位状态和扫描码名字里的“超萌猫咪”是项目内部代号源于早期开发者用猫爪图标替代传统机器人图标实际交付物是一组可嵌入Python/C项目的头文件与静态库核心逻辑不足300行C代码。适合三类人嵌入式UI测试工程师需绕过GUI框架限制、政务系统运维人员批量处理老旧C/S架构软件、无障碍技术支援者为特殊输入设备定制键位映射。它不解决鼠标轨迹模拟也不做宏录制专治“必须按这个顺序敲这串键、且不能有毫秒级延迟偏差”的硬核场景。2. 从WinAPI INPUT结构体切入为什么不用SendInput就等于在键盘上裸奔2.1 键盘事件模拟的三种层级从“伪按键”到“真硬件信号”很多开发者第一次接触键盘自动化会本能地选择pyautogui.keyDown(a)或ctypes.windll.user32.keybd_event()。但这两者存在根本性缺陷pyautogui底层仍走SendInput但默认启用KEYEVENTF_SCANCODE标志位缺失导致无法触发某些依赖扫描码的国产输入法热键而keybd_event在Windows 10 1809后已被标记为deprecated且对Modifier键Ctrl/Shift/Alt的按下/释放时序控制极脆弱——比如想模拟CtrlC若Ctrl键释放早于C键10ms系统就收不到组合键。真正的解法是直击Windows消息循环底层构造INPUT结构体显式设置dwFlags字段中的KEYEVENTF_SCANCODE | KEYEVENTF_KEYUP组合并传入硬件扫描码而非虚拟键码VK_A。扫描码是键盘物理电路输出的唯一标识不受当前键盘布局、输入法状态影响。例如无论你用美式键盘还是五笔输入法按右下角那个键扫描码永远是0x56对应VK_OEM_102而虚拟键码VK_A在不同布局下可能指向不同物理键。这就是“全键盘版”的根基放弃语义层锚定硬件层。2.2 构造合法INPUT结构体47字节内存块的生死时速Windows要求SendInput接收的INPUT数组必须严格对齐且每个INPUT结构体大小固定为28字节x64或47字节x86。我们以x64平台为例手动构造一个“按下A键”的结构体#include windows.h void pressKeyA() { INPUT input {0}; input.type INPUT_KEYBOARD; input.ki.wScan 0x1E; // A键扫描码PS/2标准 input.ki.dwFlags KEYEVENTF_SCANCODE; // 关键必须设此标志 input.ki.time 0; // 系统自动填入时间戳 input.ki.dwExtraInfo 0; SendInput(1, input, sizeof(INPUT)); // 必须立即跟一个KEYUP事件否则系统认为键被长按 input.ki.dwFlags KEYEVENTF_SCANCODE | KEYEVENTF_KEYUP; SendInput(1, input, sizeof(INPUT)); }提示扫描码表不能硬编码不同键盘协议USB HID/PS/2/Bluetooth的扫描码不同。项目内置scancode_map.h根据GetKeyboardType(0)返回值动态加载对应映射表。例如USB键盘的A键扫描码是0x04PS/2是0x1E——若直接写死0x1E在USB键盘上会触发其他键。2.3 全键盘版的核心能力边界它能做什么又坚决不碰什么能力项实现方式限制说明Modifier键精准组合同时构造多个INPUT结构体按“Ctrl按下→A按下→A抬起→Ctrl抬起”时序调用SendInput必须保证两次SendInput调用间隔5ms否则系统判定为两个独立事件功能键F1-F12支持使用MapVirtualKey(VK_F1, MAPVK_VK_TO_VSC)获取扫描码MAPVK_VK_TO_VSC在部分远程桌面会失效需fallback到预置表数字小键盘独立识别小键盘0-9与主键盘0-9扫描码不同如小键盘00x52主键盘00x0B若目标程序区分小键盘输入如CAD软件必须用对应扫描码不支持的功能—不模拟鼠标移动/点击需另起模块、不读取当前键位状态无法判断CapsLock是否开启、不劫持键盘钩子不监听输入只发送3. Python封装层设计让“猫咪代打”变成一行代码就能调用的生产力工具3.1 ctypes绑定的关键陷阱结构体对齐与指针传递Python调用C函数最易翻车的点在于ctypes的内存对齐。若C头文件中INPUT结构体未显式声明__declspec(align(8))Python侧用Structure定义时若未指定_pack_ 1会导致sizeof(INPUT)计算错误SendInput直接返回0。正确做法如下from ctypes import Structure, c_ulong, c_ushort, c_short, c_byte, byref, sizeof from ctypes.wintypes import DWORD, WORD, SHORT, BYTE class KEYBDINPUT(Structure): _fields_ [ (wVk, WORD), (wScan, WORD), (dwFlags, DWORD), (time, DWORD), (dwExtraInfo, POINTER(c_ulong)) ] class INPUT(Structure): _pack_ 1 # 强制1字节对齐避免ctypes自动填充 _fields_ [ (type, DWORD), (ki, KEYBDINPUT), ] # 验证print(sizeof(INPUT)) 必须输出28x64 assert sizeof(INPUT) 28, fINPUT size mismatch: {sizeof(INPUT)}3.2 键序列执行器用状态机管理Modifier键生命周期“全键盘版”的灵魂在于Modifier键Ctrl/Shift/Alt的智能管理。用户调用press_keys([ctrl, a])时不能简单地发四个事件ctrl_down→a_down→a_up→ctrl_up因为若用户紧接着调用press_keys([v])应复用已按下的Ctrl键只发v_down→v_up。我们用一个全局状态机跟踪class KeyboardController: def __init__(self): self._modifier_state { ctrl: False, shift: False, alt: False, win: False } self._scancode_map load_scancode_map() # 根据键盘类型加载 def press_keys(self, keys: List[str]): # 步骤1解析keys分离Modifier和普通键 modifiers [k for k in keys if k in self._modifier_state] normal_keys [k for k in keys if k not in self._modifier_state] # 步骤2按需按下Modifier只对当前未按下的 for mod in modifiers: if not self._modifier_state[mod]: self._send_key_down(mod) self._modifier_state[mod] True # 步骤3按下所有普通键 for key in normal_keys: scancode self._scancode_map.get(key, 0) if scancode: self._send_key_down(key, scancode) # 步骤4抬起普通键Modifier保持按下 for key in normal_keys: scancode self._scancode_map.get(key, 0) if scancode: self._send_key_up(key, scancode) def _send_key_down(self, key_name: str, scancode: int): # 构造INPUT结构体并调用SendInput... pass注意_send_key_down内部必须使用KEYEVENTF_SCANCODE且wScan字段填入scancodewVk填0。这是绕过输入法干扰的唯一方式。3.3 预置键位模板把“打开任务管理器”变成一个字符串常量为降低使用门槛项目内置preset_keys.py将高频操作固化为字符串模板PRESET_KEYS { taskmgr: [ctrl, shift, esc], # CtrlShiftEsc lock_pc: [win, l], # WinL switch_app: [alt, tab], # AltTab注意此处Tab是扫描码0x0F paste_plain: [ctrl, alt, v], # 某国产办公软件的纯文本粘贴 } # 使用方式 controller KeyboardController() controller.press_keys(PRESET_KEYS[taskmgr]) # 一行代码打开任务管理器这些模板经过实测在Windows 11 22H2 中文输入法 多显示器环境下taskmgr模板100%触发而用pyautogui.hotkey(ctrl,shift,esc)失败率高达37%因pyautogui未正确处理Shift的扫描码时序。4. 避坑指南那些让“猫咪代打”在客户现场集体静音的5个血泪经验4.1 现象SendInput返回0但目标窗口毫无反应原因进程未获得uiaccess权限且运行在高DPI缩放125%/150%的Windows上。Windows为防UI Spoofing攻击对非uiaccess进程的SendInput调用施加DPI感知限制——若你的exe manifest中未声明dpiAwaretrue/pm/dpiAwareSendInput在高DPI下静默失败。解决在项目根目录创建app.manifest内容包含assembly xmlnsurn:schemas-microsoft-com:asm.v1 manifestVersion1.0 application xmlnsurn:schemas-microsoft-com:asm.v1 windowsSettings dpiAware xmlnshttp://schemas.microsoft.com/SMI/2005/WindowsSettingstrue/pm/dpiAware /windowsSettings /application /assembly编译时用link /manifest:app.manifest yourapp.obj链接。4.2 现象按出CtrlC却粘贴不出内容或粘贴出乱码原因目标程序如某银行内网系统使用自研剪贴板监控只响应WM_PASTE消息而SendInput触发的是底层键事件剪贴板数据未被其Hook捕获。解决改用OpenClipboardSetClipboardData先写入剪贴板再用SendInput发CtrlV。项目提供safe_paste(text: str)方法内部自动完成两步。4.3 现象在远程桌面RDP会话中SendInput完全失效原因RDP默认禁用SendInput因其可能被用于恶意自动化。需在RDP服务端组策略中启用“允许远程桌面服务发送输入”。解决在服务器上运行gpedit.msc→ 计算机配置 → 管理模板 → Windows组件 → 远程桌面服务 → 远程桌面会话主机 → 安全 → 启用“允许远程桌面服务发送输入”。4.4 现象按F5刷新网页时Chrome没反应Edge却正常原因Chrome 110启用了“键盘事件隔离”对非用户主动触发的SendInput事件降权处理。F5事件被忽略但CtrlR仍有效。解决弃用F5扫描码改用[ctrl, r]组合。项目preset_keys中已将refresh重定向至此。4.5 现象连续调用press_keys([a,b,c])目标窗口只收到ac原因SendInput调用过于密集Windows消息队列溢出。实测发现两次SendInput间隔低于8ms时中间事件丢失。解决在press_keys内部插入time.sleep(0.012)12ms或更优解——用单次SendInput传入多个INPUT结构体批量模式。项目默认启用批量模式press_keys([a,b,c])生成3个INPUT结构体一次性提交。5. 进阶技巧用“猫咪代打”实现跨应用状态同步——一个真实产线案例5.1 场景还原某制造企业MES系统与PLC调试软件的键位桥接某工厂产线有两套系统MES制造执行系统用Java Web部署在IE11中负责下发工单PLC调试软件某德国品牌是纯Win32桌面程序需人工将MES生成的“工单ID”复制到其“Load Program”对话框。过去靠工人手动抄写错误率12%。改造方案用“猫咪代打”监听MES页面DOM变化通过IE COM接口当检测到新工单ID出现自动将其复制到剪贴板再切换到PLC软件窗口模拟AltTab→CtrlV→Enter。关键难点在于窗口切换的可靠性。SetForegroundWindow在Windows 10常被系统拒绝安全策略而AppActivate在多实例时易选错窗口。我们的解法是用EnumWindows遍历所有窗口通过GetWindowText匹配PLC软件标题含版本号再用IsIconic判断是否最小化最后用ShowWindow(hwnd, SW_RESTORE)确保可见def switch_to_plc(): target_title PLC Debugger v3.2.1 def enum_proc(hwnd, lParam): length GetWindowTextLengthW(hwnd) if length 0: buffer create_unicode_buffer(length 1) GetWindowTextW(hwnd, buffer, length 1) if target_title in buffer.value and IsWindowVisible(hwnd): # 确保窗口在前台且非最小化 if IsIconic(hwnd): ShowWindow(hwnd, SW_RESTORE) SetForegroundWindow(hwnd) return False # 停止枚举 return True EnumWindows(EnumWindowsProc(enum_proc), 0)5.2 键位序列的原子性保障如何让“CtrlV→Enter”不被中断上述流程中若用户在PLC软件弹出对话框瞬间按下键盘会导致SendInput事件被截断。解决方案是在发送键序列前用BlockInput(True)临时禁用物理键盘输入需管理员权限序列发送完毕再BlockInput(False)。但BlockInput风险高我们采用更柔和的“输入抑制”# 在press_keys方法开头插入 def press_keys(self, keys: List[str]): # 抑制物理输入设置低级键盘钩子过滤掉所有非本进程的键盘事件 self._hook_id SetWindowsHookExW( WH_KEYBOARD_LL, self._low_level_keyboard_proc, GetModuleHandleW(None), 0 ) try: # 执行SendInput... self._execute_input_sequence(keys) finally: # 恢复输入 UnhookWindowsHookEx(self._hook_id)其中_low_level_keyboard_proc回调函数只放行dwExtraInfo等于本进程ID的事件其他一律return 1表示已处理不传递给下游。5.3 效果验证从“人工12%错误率”到“自动0错误单次耗时1.8秒”上线后该产线日均处理工单数从80单提升至320单错误率归零。性能瓶颈实测在EnumWindows遍历平均耗时420ms优化后引入窗口句柄缓存首次找到PLC窗口后将其hwnd存入本地SQLite后续调用直接IsWindow验证有效性耗时降至17ms。整个键位桥接流程检测→复制→切换→粘贴→确认稳定在1.73±0.09秒。我带过的三个项目都踩过“以为SendInput万能结果在客户现场跪着调DPI”的坑。现在我的习惯是新项目第一件事不是写业务逻辑而是跑通press_keys([ctrl,shift,esc])并用录屏验证——如果任务管理器没弹出来后面所有自动化都是空中楼阁。希望帮到你。本文还有配套的精品资源点击获取
