录屏时鼠标总是看不清？MouseHighlight 给 Mac 加上高亮与点击波纹

MouseHighlight 是一个轻量的原生 macOS 鼠标高亮工具：跟随光圈、左右键点击波纹、全局快捷键、三种录制预设和可视化调节面板都装在一个 Swift 单文件应用里。适合录教程、软件演示和 OBS 工作流，源码开放、无需 Electron，也不上传任何内容。

录屏时有一个很常见的问题：讲解者知道鼠标在哪里，观众却不知道。

尤其是录软件教程、产品演示和在线课程时，系统自带指针在复杂界面里很容易被按钮、表格和深色背景吞掉。后期再给光标加效果当然可以，但那意味着多一道剪辑工序，而且点击位置仍然需要手动对齐。

MouseHighlight 的思路更直接：在录制时就给鼠标加上一圈实时跟随的高亮，并在点击时显示波纹反馈。

它是什么

MouseHighlight 是一个原生 macOS 菜单栏工具，使用 Swift、AppKit、Core Graphics 和 Carbon HotKey API 编写。项目没有引入 Electron，也没有后台服务；运行后只负责监听鼠标与快捷键，并在指针位置绘制透明悬浮层。

最新版加入了重新设计的控制面板，主要功能包括：

• 柔和的鼠标跟随光圈；
• 左键黄色波纹、右键蓝色波纹反馈；
• ⌥⌘H 全局快捷键，一键开启或暂停；
• 教程、科技演示、极简三种录制预设；
• 光圈大小、透明度、点击波纹和平滑跟随实时调节；
• 可选鼠标移动轨迹；
• 设置自动保存，重启后继续使用上次参数；
• 菜单栏状态与控制面板同步；
• 自动适配 macOS 深色与浅色外观。

三种预设怎么选

教程模式

这是最均衡的一档。光圈大小适中、透明度略微收敛，既能让观众跟上鼠标，也不会长期遮挡界面内容。录操作教程、课程和常规软件演示，直接用这一档即可。

科技演示

光圈更大、点击波纹更明显，适合高分辨率显示器、信息密集的控制台，或者观众距离屏幕较远的直播场景。代价是视觉存在感更强，不适合需要保持画面极简的内容。

极简模式

缩小光圈并降低透明度，只留下轻微提示。它更适合产品宣传、设计展示以及不希望鼠标效果抢镜的录制。

安装与运行

项目结构很简单，不需要创建 Xcode 工程。克隆仓库后，用系统自带的 Swift 编译器即可：

git clone https://github.com/zy22601/MouseHighlight.git
cd MouseHighlight
swiftc MouseHighlight.swift \
  -o MouseHighlight \
  -framework Cocoa \
  -framework Carbon
./MouseHighlight

完成第一次编译后，也可以执行仓库里的 run.sh 启动生成的程序。

第一次运行时，macOS 会要求授予辅助功能权限。路径是：

系统设置 → 隐私与安全性 → 辅助功能

这项权限用于监听全局鼠标事件和快捷键；项目本身不需要联网，也不会上传屏幕、鼠标或键盘数据。

快捷键

录屏过程中不必切回控制面板，直接用快捷键调整即可。

实际使用时要注意什么

MouseHighlight 更像一个专用的小工具，而不是完整录屏软件。它不负责录制、剪辑、自动缩放或字幕，最好与 OBS、QuickTime Player、Screen Studio 等工具搭配。

如果使用 OBS，建议保持 60 fps，并先录一小段检查光圈大小。录制 2K 或 4K 桌面时可以选择「科技演示」；窗口较小或画面本身很简洁时，使用「教程」或「极简」会更自然。移动轨迹在快速演示时有帮助，但长时间开启容易让画面显得杂乱。

另外，它目前主要面向 macOS 与 Apple Silicon。项目采用原生框架，资源占用很低，但跨平台不是它的目标。

适合谁

MouseHighlight 适合经常录制软件教程、AI 工具演示、产品 walkthrough、在线课程和 OBS 直播的人。它解决的不是复杂问题，却能明显降低观众跟丢操作位置的概率。

对于开发者，这个项目也很适合作为 AppKit 入门样例：单文件代码展示了透明悬浮窗口、全局事件监听、Carbon 快捷键、Core Graphics 绘制、菜单栏应用和 UserDefaults 持久化如何组合在一起。