MouseSide

项目介绍

项目名称： MouseSide 项目定位： Windows 轻量级鼠标侧键自定义工具 需求版本： V1.0 目标系统： Windows 11 x64 开发方向： 原生、轻量、低延迟、免安装、可扩展 项目状态： 需求规划阶段

一、项目背景 1.1 使用设备 电脑：

型号：Xiaomi Book Pro 14

处理器：Intel Core Ultra X7 358H

内存：32 GB

存储：1 TB SSD

系统：Windows 11

鼠标：

型号：小米无线鼠标 3 彩色版

颜色：米白色

日常连接：蓝牙

备用连接：2.4GHz 无线接收器

实体侧键：2 个

1.2 当前使用情况 目前使用 X-Mouse Button Control（XMBC）自定义鼠标侧键。

实际仅使用两项功能：

鼠标按键 当前功能 快捷键 鼠标第四按钮 [4] 粘贴 Ctrl + V 鼠标第五按钮 [5] 复制 Ctrl + C XMBC 的其他高级功能基本没有使用需求。

在不运行 XMBC 时，两个侧键默认承担浏览器前进、后退操作。

1.3 开发目的 开发一款功能更精简、资源占用更低、使用体验更直接的 Windows 工具，替代 XMBC 完成日常鼠标侧键映射。

具体目标：

专注于两个鼠标侧键的功能映射。

尽可能降低程序体积、内存和 CPU 占用。

降低按键映射所带来的额外延迟。

无需安装额外驱动或大型运行环境。

提供简单、现代化的配置界面。

支持后台安静运行，不干扰日常工作。

保留未来扩展组合键、应用专属映射及设备信息的空间。

设计原则：功能克制、实现简单、性能优先，不为了未来需求进行过度工程化。

二、V1.0 核心功能需求 2.1 鼠标侧键识别 优先级：P0（必须实现）

程序需要识别 Windows 标准扩展鼠标按钮：

XBUTTON1：通常对应鼠标第四按钮 [4]

XBUTTON2：通常对应鼠标第五按钮 [5]

要求：

正确识别两个侧键的按下与松开。

能够分别配置不同功能。

在执行自定义功能时，屏蔽原始前进、后退事件。

不影响鼠标左键、右键、中键、滚轮及移动操作。

蓝牙和 2.4GHz 模式下均能正常工作。

避免一次点击重复执行映射。

不需要专用鼠标驱动。

V1.0 基于标准 Windows 鼠标按键事件处理，不专门识别鼠标品牌、型号或无线连接方式。