MouseKeyShow v1.2.9 (Windows Release)

MouseKeyShow v1.2.9 Release Notes
This is a major update focused on ultimate hardware compatibility and geek-level visual feedback. We have completely overhauled the underlying input capture mechanism to bypass third-party software interference, and introduced a highly requested 360-degree cursor posture indicator.

✨ New Features
Total Raw Input Overhaul: Replaced the vulnerable WH_MOUSE_LL hook and GetAsyncKeyState with a hidden Raw Input (WM_INPUT) message window. MouseKeyShow now directly communicates with the hardware driver. This completely resolves conflicts with third-party remapping tools like AltSnap and AutoHotkey. Even if you remap your side buttons to "Minimize" or "Topmost", MouseKeyShow will flawlessly capture and display your physical clicks.

360-Degree Cursor Posture Indicator: The Cursor Halo now features a stunning 15-degree arc radar system to show real-time hardware status directly on your cursor:

135° / 45°: Left and Right clicks.

90°: Middle click and Vertical wheel scrolling.

180°: Horizontal thumb wheel scrolling.

150° / 210°: Forward (Upper) and Back (Lower) side buttons.

Strobe Effect: Scrolling the wheel triggers a smooth, speed-dependent black-and-white strobe animation with natural deceleration.

🚀 Enhancements
Dynamic Minimalist UI for Advanced Mice: The MX Master 3 (and similar advanced mice) UI has been completely redesigned. To keep the screen clean, the horizontal wheel and side buttons are hidden by default. They will instantly appear only when triggered, and smoothly fade out after 0.4 seconds of inactivity.

Contextual Linked Rendering: When a side button is pressed, the UI intelligently displays both side buttons together (one highlighted, one dimmed) to provide clear spatial reference for the audience.

Smart Hardware Capability Detection: Removed the hardcoded vendor ID (VID) checks. The system now uses a "Raw Input physical scan + Event-driven lazy initialization" strategy. It natively supports multi-mouse environments and accurately adapts to mice with or without horizontal wheels (e.g., correctly distinguishing between MX Master 3 and M720).

🐛 Bug Fixes
Fixed an issue where the side buttons failed to light up when intercepted by AltSnap or other low-level keyboard/mouse managers.

Fixed C++ compilation syntax errors related to hook instances and missing braces in the moc-generation phase.

MouseKeyShow v1.2.9 更新日志
这是一个重量级更新，专注于极致的硬件兼容性与极客级的视觉反馈。我们彻底重构了底层输入捕获机制以无视任何第三方软件的干扰，并引入了呼声极高的 360 度光标姿态指示器。

✨ 新特性
底层 Raw Input 彻底重构： 移除了易被拦截的 WH_MOUSE_LL 低级钩子与 GetAsyncKeyState，引入了隐藏的 Raw Input (WM_INPUT) 消息窗口直接向硬件驱动层索取数据。彻底解决了与 AltSnap、AutoHotkey 等第三方改键软件的冲突。 现在，即使您将鼠标侧键映射为“最小化窗口”或“窗口置顶”，MouseKeyShow 依然能完美捕捉并渲染您的物理按压动作。

360 度光标姿态指示器 (雷达盘)： 鼠标光环新增了极具科技感的 15 度角弧线姿态反馈：

135° / 45°：左键与右键。

90°：中键按压与垂直滚轮。

180°：左侧拇指滚轮。

150° / 210°：上方侧键（前进）与下方侧键（后退）。

频闪动画：滚动滚轮时，指示器会根据真实滚动速度产生黑白交替的频闪动画，并在松手时带有平滑的减速驻留残影。

🚀 体验提升
高级鼠标的极简动态 UI： 针对 MX Master 3 等多按键鼠标的渲染逻辑进行了大幅优化。为保持画面极简，左侧的拇指滚轮和侧键在平时会自动隐藏，仅在被使用时瞬间浮现，并在停止操作 0.4 秒后平滑消散。

上下文联动渲染： 当按下任意侧键时，UI 会成对浮现上下两个侧键（一明一暗），为观众提供极佳的空间参照系，直观展示按下的是哪一个键。

智能硬件能力探测： 移除了死板的设备 VID 厂商白名单拦截，采用“Raw Input 物理扫描 + 运行时事件动作补偿”的策略。完美支持多鼠标混合环境，准确区分包含物理侧边滚轮与纯主滚轮倾斜的设备（如精准区分 MX Master 3 与 M720）。

🐛 缺陷修复
修复了在使用 AltSnap 等工具接管侧键后，MouseKeyShow 无法读取侧键按压状态导致 UI 不亮的问题。

修复了底层消息回调函数中因括号闭合缺失引发的 C++ (Moc) 连环编译错误

MouseKeyShow v1.2.8 (Windows Release)

MouseKeyShow v1.2.8 Release Notes

New Features & Enhancements

Intelligent Hardware Detection: Introduced a dynamic physical hardware detection module. The software now accurately maps advanced mice (such as the Logitech MX Master 3) using raw input data and system metrics.

Context-Aware Dynamic UI: The thumb wheel and side buttons now feature a "hide-by-default" minimalist design. These advanced controls remain invisible to keep the interface clean and instantly appear only when actively scrolled or clicked.

Spatial Feedback for Side Buttons: When either the Forward or Backward side button is triggered, both buttons are rendered simultaneously as a pair (one highlighted, one dimmed) to provide an intuitive spatial reference.

360-Degree Halo Indicators: Upgraded the Cursor Halo Overlay with a real-time, 15-degree arc status indicator system built directly into the tracking ring:

Clicks: Left (135°), Right (45°), Middle (90°), Forward Side (150°), and Backward Side (210°) buttons display a solid black arc with a white border when pressed.

Scrolling Animation: The vertical scroll wheel (90°) and horizontal thumb wheel (180°) feature a dynamic black-and-white strobe animation. The blinking frequency responds in real-time to your actual scrolling speed, complete with a smooth deceleration effect when you stop.

MouseKeyShow v1.2.8 更新说明

新特性与功能优化

智能硬件探测： 引入底层物理鼠标硬件探测模块，精准识别包括罗技 MX Master 3 在内的高端多按键鼠标真实硬件能力。

极简动态 UI（按需渲染）： 重新设计了鼠标的屏幕渲染逻辑。左侧拇指滚轮与侧键在默认状态下完全隐藏，保持基础界面的极致简洁，仅在用户实际触发（滚动或按压）时瞬间浮现。

侧键上下文联动显示： 优化了侧边按键的视觉交互。当按下任意侧键时，前进与后退键将成对浮现（当前按键高亮，另一按键暗淡），为观众提供清晰直观的空间参照系。

360 度光环姿态指示器： 鼠标跟随光环（Halo）全新升级，在光环外围集成 15 度圆弧的实时硬件状态指示器：

按键反馈： 左键（135°）、右键（45°）、中键（90°）、上侧键（150°）与下侧键（210°）在按下时，对应方位的圆弧将以高对比度的黑底白边实体显示。

滚轮动态测速： 垂直滚轮（90°）与水平拇指滚轮（180°）在被拨动时，圆弧会呈现黑白交替闪动的动画效果。闪烁频率与实际滚动速度实时同步，并在停止滚动时附带平滑的缓动驻留效果。

MouseKeyShow v1.2.6 (Windows Release)

Release v1.2.6: Smart Cursor Halo & Anti-blocking UI

✨ New Features

Smart Cursor Halo (CursorHaloOverlay): Added a dynamic translucent yellow halo overlay. It intelligently activates to highlight your cursor if a third-party application (e.g., Adobe Illustrator's canvas) forces a custom small cursor while you have a larger cursor size configured.

Auto-Dodging Display: The keystroke visualization card now features a smart anti-blocking mechanism. If your mouse pointer gets too close to the card, it automatically jumps to the mirrored side of the screen, ensuring your workspace is never obstructed.

Halo Configuration: Added dedicated UI controls in the Settings panel to easily enable/disable the translucent halo and adjust its radius dynamically.

🚀 Enhancements

Pixel-Perfect Hotspot Alignment: Upgraded the halo tracking algorithm to use high-precision floating-point coordinates (QPointF) and DPI-aware scaling. The center of the halo now strictly aligns with the cursor's physical click hotspot across all high-DPI screens and multi-monitor setups.

Clean Screenshots & Ignored Keys Integration: The halo overlay now automatically suspends (hides) when pressing keys in your Ignore Keys list (like screenshot hotkeys). It seamlessly restores its visibility immediately upon key release or mouse interaction, guaranteeing clean screenshots without permanent halo disappearance.

Settings UI Polish: Refined the "Cursor & Halo Settings" layout by combining nested horizontal layouts with grid elements, ensuring perfect right-edge visual alignment between the cursor slider and halo radius controls.

🐛 Bug Fixes

Eliminated Stuck Keys: Implemented a robust 60FPS physical hardware state polling mechanism (GetAsyncKeyState). Keys will no longer get stuck visually on your screen if the OS swallows KEYUP events due to lost focus, Alt+Tab, or UAC prompts.

Filtered False Modifier Presses: The low-level keyboard hook now reads the Windows LLKHF_INJECTED flag to perfectly filter out fake "Alt" or modifier key presses injected by IMEs or third-party background software.

Release v1.2.6: 智能光标光环与防遮挡机制

✨ 新功能

智能光标光环 (Cursor Halo)：新增半透明黄色辅助光环。当鼠标进入特定专业软件（如 Adobe Illustrator 画布区域）被强行替换为极小光标，且当前物理大小不满足您的目标设定时，光环会自动显现以辅助定位。

按键屏显智能避让：按键显示卡片新增智能躲避机制。当检测到鼠标指针靠近按键显示区域时，卡片会自动弹跳至屏幕的镜像对侧，彻底解决遮挡用户操作视野或点击区域的问题。

光环专属配置：在设置界面新增了光环开关与光环半径的独立滑动条配置项，支持实时预览。

🚀 优化与改进

像素级热点对齐：光标追踪算法重构，引入高精度浮点坐标 (QPointF) 并严格适配高分屏 DPI 换算。无论在多显示器还是各种高缩放比例环境下，光环的圆心都能 100% 绝对咬合鼠标指针的物理点击点（Hotspot）。

纯净截图与黑名单协同：当按下屏蔽名单中的按键（如截图快捷键）时，光环会自动挂起隐藏以保证截取画面的纯净；并在按键松开或鼠标操作（如拖拽框选完毕）时无缝恢复显示状态，解决了隐身卡死问题。

UI 布局精研：优化设置面板布局，通过嵌套原生水平布局，实现了“光标大小”与“光环半径”两行控件在右侧边缘的像素级精准对齐，界面视觉更加精致紧凑。

🐛 问题修复

彻底根除按键卡死残影：在动画渲染引擎中引入了 60FPS 的全局物理硬件状态兜底检测机制。完美解决因切换窗口、弹出管理员提权（UAC）等导致按键抬起事件丢失，从而使 Alt/Ctrl/Shift 或普通按键长留屏幕的 Bug。

拦截虚假 Alt 键触发：底层键盘钩子新增对 Windows 原生 LLKHF_INJECTED 注入标志的拦截，杜绝了输入法切换或第三方辅助软件触发的虚假按键在屏幕上显示，同时保证真实的物理按键不被误杀。

MouseKeyShow v1.2.5 (Windows Release)

New Features

Dynamic Cursor Halo for Custom Cursors: Added a new translucent yellow halo effect. If the system cursor is shrunk by third-party applications (e.g., entering the Adobe Illustrator canvas with a custom pen/crosshair tool), the halo will automatically appear to highlight the cursor's location.

Smart Auto-Dodging Panel: The keystroke visualization card now features a smart anti-blocking mechanism. If the mouse cursor approaches the card's display area, the card will automatically jump to the mirrored side of the screen to prevent obstructing the user's view or clicking area.

Halo Configuration: Added dedicated UI controls in the Settings panel to enable/disable the translucent halo and adjust its radius dynamically.

Enhancements

Pixel-Perfect Hotspot Alignment: Upgraded the cursor tracking algorithm to use high-precision floating-point coordinates (QPointF) and DPI-aware scaling. The center of the yellow halo now strictly aligns with the physical click hotspot of the cursor across all multi-monitor and high-DPI environments.

Screenshot Purity: Optimized the background capture logic for the "Screen Position" dragging feature. The halo overlay is now temporarily suspended during screen capture to prevent it from being permanently baked into the background image.

UI Layout Alignment: Refined the "Cursor & Halo Settings" layout using a mixed grid and compact horizontal layout to ensure perfect right-side alignment between the cursor size controls and the new halo radius controls.

Bug Fixes

False Alt/Modifier Key Detections: Fixed an issue where the "Alt" key would erroneously display on the screen without being physically pressed. The low-level keyboard hook now utilizes the Windows LLKHF_INJECTED flag to perfectly filter out fake keystrokes injected by third-party IMEs or system processes, while ensuring physical key presses are never missed.

Stuck Keys on Screen: Completely resolved the issue where keys (Alt, Ctrl, Shift, or normal keys) would remain stuck on the screen indefinitely. Implemented a universal 60FPS physical hardware state fallback mechanism (GetAsyncKeyState) that forces any stuck keys to release visually, even if the OS swallows the KEYUP events due to UAC prompts or Alt+Tab window switching.

MouseKeyShow 更新日志

新功能

自适应光标高亮光环：新增了光环辅助定位功能。当鼠标进入专业软件（如 Adobe Illustrator 画布）并被强行替换为极小的自定义光标时，光环会瞬间自动显现以辅助视觉定位；在桌面等成功应用系统大光标的场景下，光环会自动隐藏。

按键屏显智能防遮挡：按键显示卡片新增智能躲避机制。当检测到鼠标指针靠近按键显示区域时，卡片会自动弹跳到屏幕镜像的另一侧，彻底避免遮挡用户的操作视野。

光环专属配置项：在设置界面新增了光环开关与半径调节滑块，支持实时预览与动态生效。

优化与改进

光标热点像素级对齐：重构了光标追踪算法，引入 QPointF 高精度浮点坐标与底层 DPI 缩放换算。现在无论是在多显示器还是高分屏环境下，黄色光环的圆心都能 100% 绝对咬合鼠标指针的物理点击点（Hotspot），消除了视觉偏移。

纯净的背景截图：优化了“屏幕显示位置”定位卡片的背景抓取逻辑。在进行屏幕截图的瞬间，光环覆盖层会被自动挂起隐藏，防止其作为残影被截入桌面背景图中。

设置界面布局对齐：使用底层网格结合紧凑水平布局，重构了“鼠标指针与光环设置”区域。确保了第一行光标大小与第二行光环半径的滑动条和数值文本实现完美的右侧视觉对齐。

问题修复

修复虚假 Alt 键触发：修复了在未按 Alt 键时，屏幕上莫名其妙显示 Alt 键的问题。通过在底层键盘钩子中引入 Windows 原生 LLKHF_INJECTED 标志，精准拦截输入法或第三方辅助软件注入的虚假按键，同时杜绝了真实按键被误杀的情况。

彻底修复按键卡死残留：修复了 Alt、Ctrl、Shift 或普通按键偶尔长时间停留在屏幕上无法消失的 Bug。重构了按键归一化逻辑，并在动画渲染引擎中引入了 60FPS 的全局物理硬件状态兜底检测。无论是因为切换窗口、系统卡顿还是弹出管理员确认框导致按键抬起事件丢失，程序都能强制纠正并清理屏幕残影。

MouseKeyShow v1.2.2 (Windows Release)

English Release Notes
What's New & Improved:

Real-Time Cursor Preview: Instantly preview cursor size adjustments while dragging the slider without system lag.

Key Blacklist (Screenshot Friendly): Added an option to ignore specific keys (e.g., F1, F2). Pressing them instantly clears and hides the overlay.

Smooth Opacity & Scale Adjustments: Real-time preview while sliding with zero window flickering and centered scaling.

Language Switcher: Easily switch between Chinese and English directly from the system tray menu.

System Tray Tooltip Update: Updated and refined the tray icon tooltip message.

File Properties & Metadata Polish: Completed version and copyright details in MouseKeyShow.exe properties.

UI & Layout Polish: More compact layout without extra bottom space, larger cursor preview icons, and cleaner background map captures.

中文说明 (Chinese)
新功能与改进：

鼠标指针实时调节：拖动滑块时立即看到真实光标大小变化，松开后自动保存，不再有卡顿延迟。

按键黑名单（截图免打扰）：支持设置屏蔽按键（例如 F1, F2）。按下时不会显示，并会立即隐藏屏幕上残留的按键卡片。

平滑调节透明度与比例：边拖动滑块边实时预览效果，修复了窗口缩放时的闪烁和位置晃动。

中英文语言切换：托盘菜单新增语言选项，支持一键在中文和英文之间实时切换。

修改托盘提示信息：优化并更新了系统托盘图标的鼠标悬停提示文本。

完善程序属性信息：补充完善了 MouseKeyShow.exe 的版本信息与版权等属性详情。

界面细节优化：重新排版紧凑界面，去除底部多余留白；放大光标对比图标；优化定位地图底图截图。

MouseKeyShow v1.1.0 (Windows Release)

V1.1.0
关闭了Release版本的调试窗口
添加了鼠标中键按下状态显示
完善了托盘图标的显示

MouseKeyShow v1.0.0 (Windows Release)

v1.0.0
2026-08-26
首次发布正式版本。
基于底层钩子实现极速键鼠捕获。
支持系统光标物理大小全局无感调节。
集成多种深色高颜值开发主题。