鼠标硬件微动与接触抖动检测
鼠标的核心部件是其机械微动开关。随着使用时间的推移，微动开关内部的金属弹片会发生物理磨损或氧化，导致接触不良。这种物理磨损会引发“接触抖动”（Chattering）现象，即在用户仅进行一次物理按压时，金属弹片在极短时间内发生多次快速接触与分离。
在硬件层面，这种抖动表现为电信号的快速起伏。虽然鼠标固件通常带有防抖（Debounce）算法来过滤这些异常信号，但当微动开关老化程度超出算法补偿范围时，系统就会将其识别为多次独立的点击，从而产生令人困扰的自动双击（异常连击）或漏按问题。
通过在测试区域内进行连续的单次点击，本工具能够精确记录每次按键的按下与释放时间。如果两次连续按下的时间间隔极短，则极有可能是微动开关物理磨损导致的接触抖动，而非人工操作。
浏览器事件捕获与按键拦截机制
当您在网页上操作鼠标时，浏览器会捕获并传播一系列底层的指针事件。然而，不同操作系统和浏览器对硬件事件的处理和拦截机制存在差异：
- 右键菜单拦截：在默认情况下，右击会触发浏览器的上下文菜单。为了能够正常统计右击事件，本工具在测试区域内禁用了右键菜单。
- 侧键快捷键：鼠标的侧键（如前进键和后退键）通常被浏览器默认绑定为历史记录导航快捷键。本工具会尝试在测试区域内阻止这些默认行为，以便准确记录按键。但在某些系统环境（例如 Linux 平台上的 Firefox 浏览器）中，操作系统或浏览器会在事件到达网页之前将其完全拦截，导致页面无法接收到任何输入信号。
- 系统级按键映射：在 macOS 系统中，按住 Control 键并点击鼠标左键在系统底层被设计为触发右击事件。因此，该操作在本工具中会直接注册为右键。
跨平台的指针事件 API 与输入设备差异
现代 Web 标准使用统一的指针事件（Pointer Events）API 来处理各种类型的输入。本工具可以识别并区分以下三种不同的指针类型：
- mouse：物理鼠标或笔记本触控板。
- pen：电磁手写笔或数位板。
- touch：触摸屏等触控设备。
虽然触摸屏上的单指轻触会触发点击事件，但由于触摸屏缺乏物理按键和机械滚轮的硬件结构，因此无法用于测试鼠标的物理微动开关和滚轮步数。完整的按键与滚轮检测仍需依赖真实的物理鼠标或触控板。
滚轮物理学与滚动增量单位
鼠标滚轮的滚动在系统和浏览器层面被转化为滚动增量（Scroll Delta）。由于不同操作系统（如 Windows、macOS、Linux）以及不同浏览器对滚动行为的渲染机制不同，滚轮事件报告的数值单位也存在本质差异。
滚动增量主要有以下三种单位模式：
- pixels（像素）：以绝对像素值为单位，常见于现代浏览器和高精度触控板滚动。
- lines（行）：以文本行数为单位，是传统鼠标滚轮在多数浏览器中的默认报告方式。
- pages（页）：以整个页面高度为单位，通常在系统设置了“一次滚动一个屏幕”时触发。
由于这些单位之间的换算关系因系统滚动设置而异，因此在不同浏览器中测试同一只鼠标时，用户应当对比滚轮滚动的方向和步数，而不是直接对比原始的 delta 数值。
鼠标按键测试工具使用指南
本工具提供了一个直观的测试环境，帮助您全面检测鼠标的各项功能。
输入与控制
- 测试区域：在标有“测试区域”的面板内移动指针、点击按键或滚动滚轮。
- 标记时间间隔：您可以自定义双击（异常连击）的判定阈值（默认设置为 40 ms）。如果同一按键两次按下的时间间隔小于此值，系统将判定为异常连击。
- 清除日志：点击“清除日志”按钮可随时清空当前积累的所有事件记录。
状态与统计指标
页面会实时显示以下统计数据与状态：
- 状态指示：未操作时显示“在测试区域内点击或滚动以开始”，开始操作后显示“正在监听鼠标输入”。
- 视觉图例：通过“按住”、“已测试”和“双击（异常连击）”三种状态颜色直观展示按键状态。
- 统计面板：实时统计“已测试按键数”、“总按压次数”、“双击（异常连击）次数”以及“滚轮步数”。
- 双击（异常连击）检测表：展示每个“按键”的累计“按下次数”以及两次按下之间的“最小间隔”。
事件日志详情
事件日志表会详细记录每一次交互，包含以下字段：
- 时间：事件发生的精确时间。
- 事件：包括“按下”、“释放”、“双击”或“滚轮滚动”。
- 按键：识别为“左键”、“右键”、“中键”、“后退键”、“前进键”、“滚轮”或未知按键（显示为“按键
{number}”）。 - 详情：展示“按键”代码、当前“按住的按键”（无按住时显示“None”）、指针“位置”坐标、滚轮滚动方向（“向上”、“向下”、“向左”、“向右”）、两次事件的“时间间隔”、“按住时长”以及“指针类型”（
mouse、pen或touch）。 - 异常标记：对于触发双击（异常连击）的事件，会额外标注“双击（异常连击）”徽章。
隐私与数据处理说明
本工具完全在您的浏览器本地运行。鼠标输入仅由本页面读取，用于显示事件详情和页面日志。任何内容都不会被存储或上传。清除日志或离开页面将立即抹除数据。
常见问题
我的鼠标按一下却触发了双击 —— 这个工具能确认吗？
是的。请以单次、缓慢且刻意的方式按下有疑问的按键：每次按下应该只记录一个“按下”和一个“释放”事件。如果额外的一次按键落在了标记窗口内（默认 40 ms），则会被标记为双击（异常连击）并进行计数 —— 如果接连出现这种模式，通常意味着微动开关已磨损，而非软件问题。正常健康的按键几乎不可能通过手动点击触发如此快速的两次连击，因此除非您刻意进行极速点击，否则无需调宽该时间窗口。
为什么在测试区域内无法打开右键菜单？
该区域禁用了右键上下文菜单，以便像其他按键一样统计右击次数；在测试区域外，右键菜单仍可正常工作。有两个页面无法覆盖的特例：在 Firefox 中，Shift + 右击始终会打开菜单且无法被统计；在 Mac 上，按住 Ctrl 并点击在设计上即被注册为右击。
为什么我的侧键没有反应？
许多浏览器会将后退和前进键用于历史记录导航，有些浏览器甚至在页面捕获到按键之前就将其拦截 —— 在浏览器允许的情况下，此测试区域会禁用该默认行为，但并非所有环境都支持。在 Linux 上的 Firefox 中，可能完全无法报告侧键。如果侧键在此处无响应但在其他应用中正常，说明已被浏览器拦截，这并不代表鼠标已损坏。
为什么相同的滚动操作在另一个浏览器中显示的 delta 数值不同？
滚动数值会根据浏览器和平台的不同，以 pixels、lines 或 pages 为单位进行报告，且读取结果会标明每次事件所使用的单位。对于相同的滚动刻度，以 pixel 为单位的数值通常远大于以 line 为单位的数值。请在不同浏览器之间对比滚动方向和滚动步数，而不是对比原始的 delta 数值。