鼠标手势动作小工具 V2.4

鼠标手势动作小工具 V2.4 版本说明

版本信息

项目	内容
版本	V2.4
更新日期	2026-09-26
支持系统	Windows 10 / Windows 11
发布形式	Windows 单文件 EXE，无需安装 Python
重点变更	新增“❓ 帮助说明”帮助中心浏览窗口
发布范围	本地验收构建

新增功能

左侧功能导航在“功能首页 / 鼠标按键测试”下方新增“❓ 帮助说明”入口，单击打开统一的帮助中心窗口：

• 三级浏览结构：帮助中心首页（功能模块列表）→ 模块页（说明条目列表）→ 说明页（正文）。
• 覆盖五个模块：右键组合手势、自定义键盘映射、鼠标按键测试、界面工具、窗口与权限。
• 窗口底部提供“🏠 首页 / ⬆ 返回上级 / ◀ 上一页 / 下一页 ▶”四个导航按钮：
  • 首页：从任意页一键回到模块总览；
  • 返回上级：说明页 → 模块条目列表 → 首页；
  • 上一页 / 下一页：按模块顺序逐页翻阅，可跨模块，第一张和最后一张自动禁用；
• 窗口顶部显示“首页 / 模块 / 条目”面包屑，随时知道当前位置。
• 同一主窗口只保留一个帮助窗口，再次单击入口直接跳到首页并置顶，不会弹出多个窗口。
• 全部帮助文案均取自程序实际功能（手势判定规则、输入优先级、增强粘贴限制、侧键重新确认步骤、设置文件位置、关闭保护、权限限制等）。

功能兼容性

• 仅新增帮助入口与帮助窗口，不改变任何手势识别、键盘映射、鼠标测试和设置逻辑。
• 帮助窗口为非模态窗口，打开期间主程序的全局鼠标监听继续正常运行。
• 保留主窗口关闭确认、侧键截图、鼠标按键测试等其余全部功能。
• 本地 dist 继续自动保留版本号最高的两个 EXE。

验证范围

• 验证帮助中心首页、五个模块页、各说明页均能正常打开且文案完整。
• 验证首页 / 返回上级 / 上一页 / 下一页四个按钮的跳转与边界禁用状态。
• 验证跨模块翻页顺序正确，面包屑随页面更新。
• 验证重复单击帮助入口复用同一窗口，关闭后可重新打开。
• 验证 V2.4 Windows 文件版本信息。
• 项目完整自动化测试 84 项全部通过（含新增帮助浏览窗口测试 11 项）。
• 启动正式 EXE 验证标题栏版本为 V2.4、帮助窗口可正常弹出。

本地验收构建与校验

文件名：鼠标手势动作小工具_V2.4.exe
路径：D:\temp\批量重命名文件夹\mouse-gesture-actions\dist\鼠标手势动作小工具_V2.4.exe
大小：11,636,636 字节
SHA-256：A97A0864E1B42FB726979B0C1921B655E6C8EAF818455420BB3FE25EEC1A404B
文件版本：2.4.0.0

可在 PowerShell 中复核：

Get-FileHash .\dist\鼠标手势动作小工具_V2.4.exe -Algorithm SHA256

Full Changelog: V2.3...V2.4

鼠标手势动作小工具 V2.3

鼠标手势动作小工具 V2.3 版本说明

版本信息

项目	内容
版本	V2.3
更新日期	2026-09-21
支持系统	Windows 10 / Windows 11
发布形式	Windows 单文件 EXE，无需安装 Python
重点变更	映射 2 的“增强粘贴”升级为醒目的整行大按钮
发布范围	本地验收构建

界面变更

“自定义键盘映射键”栏目中，映射 2 的“增强粘贴”由原来的小号复选框改为整行大按钮：

• 字号由 8 号加大到 11 号加粗，按钮高度约为原复选框的两倍，并占满映射卡片整行宽度。
• 开启时按钮显示“增强粘贴：已开启”，使用绿色填充和白色文字。
• 关闭时按钮显示“增强粘贴：已关闭”，使用灰色填充和深色文字。
• 鼠标悬停时为手型指针，按下有加深的按压颜色反馈。
• 映射 1 的“增强粘贴”复选框保持原样，不做改动。

功能兼容性

• 本次仅调整界面，不改变任何功能逻辑。
• 大按钮仍绑定原有的增强粘贴开关变量，点击后立即保存配置并同步到鼠标监听。
• 保留“勾选增强粘贴不清空已选修饰键和主键、取消后恢复原快捷键”的规则。
• 保留同一侧键最多启动一组映射、后启动者生效并自动停用另一组的规则。
• 配置回滚、外部配置加载等场景下，大按钮颜色和文字会随开关状态自动刷新。
• 保留主窗口关闭确认、侧键截图、鼠标按键测试等其余全部功能。
• 本地 dist 继续自动保留版本号最高的两个 EXE。

验证范围

• 验证映射 2 大按钮在开启、关闭两种状态下的文字与颜色正确。
• 验证点击大按钮可正常切换开关并立即持久化配置。
• 验证映射 1 仍为原“增强粘贴”复选框，样式与行为不变。
• 验证 V2.3 Windows 文件版本信息。
• 验证本地构建保留 V2.2、V2.3，清理更旧版本。
• 项目完整自动化测试 72 项全部通过。
• 启动正式 EXE 验证进程可正常运行（本机设置为启动时最小化）。

本地验收构建与校验

文件名：鼠标手势动作小工具_V2.3.exe
路径：D:\temp\批量重命名文件夹\mouse-gesture-actions\dist\鼠标手势动作小工具_V2.3.exe
大小：11,625,413 字节
SHA-256：BEAA7973764C16548CFFA4C0F69F5BAE2DF23844E651DBED0146517ED86A3A64
文件版本：2.3.0.0

可在 PowerShell 中复核：

Get-FileHash .\dist\鼠标手势动作小工具_V2.3.exe -Algorithm SHA256

Full Changelog: V2.2...V2.3

鼠标手势动作小工具 V2.2

鼠标手势动作小工具 V2.2 版本说明

版本信息

项目	内容
版本	V2.2
更新日期	2026-08-09
支持系统	Windows 10 / Windows 11
发布形式	Windows 单文件 EXE，无需安装 Python
重点变更	左侧栏目新增 GitHub 项目名称和链接
发布范围	GitHub Release

GitHub 项目信息

左侧栏目最下方新增固定的 GitHub 开源项目信息：

• 项目名称：鼠标手势动作小工具
• 项目地址：https://github.com/szboboxing/mouse-gesture-actions
• 单击链接后使用 Windows 默认浏览器打开项目主页。
• 链接提供下划线、手型鼠标指针和悬停变色反馈。
• 默认浏览器无法启动时显示明确的错误提示。

GitHub 信息固定在侧栏底部，不受功能首页和鼠标按键测试页面切换影响。

兼容性

• 保留 V2.1 的主窗口关闭确认、最小化和取消逻辑。
• 保留右键组合、侧键截图、自定义键盘映射及鼠标测试功能。
• 本地 dist 继续自动保留版本号最高的两个 EXE。
• 后续如需改变版本保留数量或规则，必须先征得用户确认。

验证范围

• 验证项目名称和 GitHub URL 与公开仓库一致。
• 验证点击链接使用完整项目地址。
• 验证链接打开失败时显示错误提示。
• 验证 V2.2 Windows 文件版本信息。
• 验证本地构建保留 V2.1、V2.2，清理更旧版本。
• 项目完整自动化测试 72 项全部通过。
• 启动正式 EXE 检查侧栏底部布局和链接交互。

本地验收构建与校验

文件名：鼠标手势动作小工具_V2.2.exe
路径：D:\temp\批量重命名文件夹\mouse-gesture-actions\dist\鼠标手势动作小工具_V2.2.exe
大小：11,624,828 字节
SHA-256：719118CF10A48715384D4C8B55F1AFB20C686836A0CA4EE03A6ECA0DECC40C92
文件版本：2.2.0.0

可在 PowerShell 中复核：

Get-FileHash .\dist\鼠标手势动作小工具_V2.2.exe -Algorithm SHA256

GitHub Release 由自动化工作流根据 V2.2 标签重新构建。正式下载附件的
SHA-256 以 Release 中同步上传的 SHA256.txt 为准；自动化构建产物的哈希
可能与上述本地验收产物不同。

发布说明

本版本同步到 GitHub main 分支，并通过 V2.2 标签触发自动化测试、
Windows 单文件构建和 GitHub Release 发布。

Full Changelog: V2.1...V2.2

鼠标手势动作小工具 V2.1

鼠标手势动作小工具 V2.1 版本说明

版本信息

项目	内容
版本	V2.1
更新日期	2026-08-09
支持系统	Windows 10 / Windows 11
发布形式	Windows 单文件 EXE，无需安装 Python
重点变更	主窗口关闭确认与最小化选择
发布范围	GitHub Release

关闭确认窗口

点击主窗口右上角关闭按钮后，软件不再直接退出，而是弹出三个按钮：

• 确认关闭：执行完整退出流程，解除系统钩子并结束程序。
• 最小化：关闭确认窗并最小化主窗口，全局监听继续运行。
• 取消：关闭确认窗，保持主窗口和程序状态不变。

默认安全操作

• 确认窗弹出后，键盘焦点默认位于“取消”按钮。
• 系统鼠标指针自动移动到“取消”按钮中央。
• 按 Enter 执行取消。
• 按 Esc 执行取消。
• 点击确认窗右上角关闭按钮同样执行取消。
• 重复点击主窗口关闭按钮时只保留一个确认窗。

本地版本保留

• 本地 dist 默认保留版本号最高的两个 EXE。
• 后续如需改变保留数量或规则，必须先征得用户确认。

退出兼容性

“确认关闭”继续调用原有退出流程：

解除系统钩子
→ 发送 WM_QUIT
→ 等待钩子与动作线程
→ 销毁 Tk 窗口
→ 释放 Mutex
→ 结束 GUI 子进程

原有 6 秒退出看门狗和进程残留保护保持不变。

验证范围

• 69 项自动化测试通过。
• 验证确认关闭、最小化、取消三种分支。
• 验证重复关闭请求不会创建多个确认窗。
• 验证取消按钮获得默认焦点并接收鼠标指针。
• 验证确认窗销毁后才执行所选操作。
• 验证原有退出清理、幂等和看门狗逻辑。
• 验证本地构建默认保留最近两个版本。
• 桌面实测 Enter 执行取消后主窗口和监听进程保持运行。
• 桌面实测选择最小化后主窗口收起，监听进程保持运行。
• 桌面实测确认关闭后父子进程在 2 秒内全部退出。
• 正式 EXE 启动和关闭后无残留进程。

GitHub 下载

• Release 页面：https://github.com/szboboxing/mouse-gesture-actions/releases/tag/V2.1
• EXE：https://github.com/szboboxing/mouse-gesture-actions/releases/download/V2.1/mouse-gesture-actions-V2.1.exe
• SHA-256：https://github.com/szboboxing/mouse-gesture-actions/releases/download/V2.1/SHA256.txt

GitHub Actions 会重新构建发布附件，下载后请以 Release 附带的 SHA256.txt 为准。

本地构建与校验

文件名：鼠标手势动作小工具_V2.1.exe
路径：D:\temp\批量重命名文件夹\mouse-gesture-actions\dist\鼠标手势动作小工具_V2.1.exe
大小：11,624,074 字节
SHA-256：7B383465FDD1F8A40DB673A6450D6665DDCF248ECF17CBBD6DEACFC5E62E960C
文件版本：2.1.0.0

可在 PowerShell 中复核：

Get-FileHash .\dist\鼠标手势动作小工具_V2.1.exe -Algorithm SHA256

发布说明

本版本同步到 GitHub main 分支，并通过 V2.1 标签触发自动化测试、Windows 单文件构建和 GitHub Release 发布。

Full Changelog: V1.8...V2.1

鼠标手势动作小工具 V1.8

鼠标手势动作小工具 V1.8 版本说明

版本信息

项目	内容
版本	V1.8
更新日期	2026-08-08
支持系统	Windows 10 / Windows 11
发布形式	Windows 单文件 EXE，无需安装 Python
重点变更	校正 X1/X2 侧键显示名称
发布范围	GitHub Release

显示名称校正

V1.8 只调整显示层，不修改鼠标事件值和实际功能：

内部 xbutton1 → 显示为 X2 / 下一页
内部 xbutton2 → 显示为 X1 / 上一页

以下位置已统一校正：

• 鼠标按键测试页的图示、检测结果及侧键状态。
• 首页侧键截图图标。
• 自定义键盘映射的下拉选项、预览、启动日志和触发记录。

默认键盘映射显示为：

映射 1：X2 / 下一页 → Ctrl+C（初始关闭）
映射 2：X1 / 上一页 → Ctrl+V（初始关闭）

原有 xbutton1、xbutton2 配置值保持不变，因此 V1.7 及更早版本的用户设置可以直接继续使用。右键保持截图、普通侧键映射、测试页透传和浏览器原生前进后退行为均未改变。

验证范围

• 59 项自动化测试通过。
• 新增显示名称回归测试，验证 UI 名称已交换但内部事件值未交换。
• 正式单文件 EXE 可启动并正常关闭。
• 关闭后 GUI 子进程和 PyInstaller 父进程均正常退出。

GitHub 下载

• Release 页面：https://github.com/szboboxing/mouse-gesture-actions/releases/tag/V1.8
• EXE：https://github.com/szboboxing/mouse-gesture-actions/releases/download/V1.8/mouse-gesture-actions-V1.8.exe
• SHA-256：https://github.com/szboboxing/mouse-gesture-actions/releases/download/V1.8/SHA256.txt

GitHub Actions 会重新构建发布附件，下载后请以 Release 附带的 SHA256.txt 为准。

本地构建与校验

文件名：鼠标手势动作小工具_V1.8.exe
路径：D:\temp\批量重命名文件夹\mouse-gesture-actions\dist\鼠标手势动作小工具_V1.8.exe
大小：11,620,133 字节
SHA-256：B3468BDC013296F73BDD12FFAB87479EBB48C664B91C8F575B4F2C09C8C2D000
文件版本：1.8.0.0

可在 PowerShell 中复核：

Get-FileHash .\dist\鼠标手势动作小工具_V1.8.exe -Algorithm SHA256

发布说明

本版本同步到 GitHub main 分支，并通过 V1.8 标签触发自动化测试、Windows 单文件构建和 GitHub Release 发布。

Full Changelog: V1.6...V1.8

鼠标手势动作小工具 V1.6

鼠标手势动作小工具 V1.6 版本说明

版本信息

项目	内容
版本	V1.6
发布日期	2026-08-08
支持系统	Windows 10 / Windows 11
发布形式	Windows 单文件 EXE，无需安装 Python
重点修复	侧键测试、右键保持截图、侧键图示位置
功能提交	380f128d2e8e82b4b5fff8cb1ece2e205953237f

本次更新概览

V1.6 修复部分鼠标的上一页、下一页侧键无法测试，以及侧键已经识别但“右键按住 + 侧键”无法调用截图的问题。

修复已使用实际主力鼠标验证。两枚侧键均可在测试页高亮和计数，也可在功能首页调用 Windows 截图 Win+Shift+S。

侧键测试修复

部分鼠标驱动会把侧键消息标记为注入输入。旧版统一过滤注入输入，导致测试页收不到这类鼠标的 XButton1/XButton2。

V1.6 调整为：

• 允许 WM_XBUTTONDOWN / WM_XBUTTONUP 进入侧键测试与截图判定。
• 其他注入型鼠标消息继续过滤，避免程序自身发送的输入形成循环。
• 测试页仍完整透传侧键，不影响浏览器上一页、下一页功能。
• 支持检测、确认并保存一枚或两枚可用侧键。

侧键截图修复

旧版为了延迟原生右键菜单，会先吞掉右键按下消息。此时 Windows 的异步右键状态可能不会更新，旧版再次查询该状态时会误判为“右键未按住”，因此取消截图动作。

V1.6 改为直接根据低级鼠标钩子收到的真实右键 DOWN/UP 维护保持状态：

• 收到右键 DOWN 后进入右键保持状态。
• 保持期间按下已保存侧键，立即执行截图。
• 收到右键 UP、关闭监听、切换测试页或更新侧键配置时清除状态。
• 未按右键时，两枚侧键继续完整透传给 Windows。
• 每次右键保持最多执行一个组合动作。

测试页图示调整

鼠标图形中的侧键位置已对调：

上方：X2 / 下一页
下方：X1 / 上一页

事件名称、配置值和截图绑定保持不变，仅修正图形位置。

使用方法

1. 进入“鼠标按键测试”。
2. 单击“重新确认侧键”。
3. 依次按下上一页、下一页侧键，确认图形高亮且计数增加。
4. 单击“保存检测结果”。
5. 返回“功能首页”。
6. 按住右键，再按任意已保存侧键。
7. Windows 截图工具应立即弹出。

下载与校验

• V1.6 Release 页面
• 下载 V1.6 EXE
• 下载 SHA256.txt

文件名：mouse-gesture-actions-V1.6.exe
大小：15,275,606 字节
SHA-256：74C5E71B6DA39A520E1467F89DF22C90EBC9440EC643914F139484947C0543DB
文件版本：1.6.0.0

可在 PowerShell 中校验：

Get-FileHash .\mouse-gesture-actions-V1.6.exe -Algorithm SHA256

验证范围

• 39 项自动化测试通过。
• 驱动注入型 X1/X2 可进入测试页并完整透传。
• 驱动注入型 X1/X2 可触发已保存的截图组合。
• 右键消息被程序吞掉后，保持状态仍可正确判定。
• 未按右键时，侧键保持浏览器上一页、下一页行为。
• 普通左键和其他鼠标输入保持透传。
• 测试页两枚侧键图示坐标已校验。
• 实际鼠标的测试、高亮、保存和截图流程已完成验证。
• Windows CI 通过。
• Publish Release 通过。
• GitHub 发布版的 SHA256.txt 与独立下载后的实际哈希一致。
• GitHub 发布版文件版本为 1.6.0.0，已完成独立启动和响应验证。