MFCMouseEffect 鼠标特效引擎

MFCMouseEffect 是什么

MFCMouseEffect 是一个跨平台的鼠标特效与输入可视化引擎。它把点击、拖尾、滚轮、长按、悬停等鼠标行为转化为可见的视觉反馈，同时提供键鼠指示器叠加层与手势到快捷键的自动化映射能力。

项目主语言为 C++，采用 MIT 协议，当前在 Windows 上最为稳定，macOS 是主开发线，Linux 处于跟随状态。

核心能力

五条独立效果通道

点击、拖尾、滚轮、长按、悬停并非同一套特效的换皮，而是各自独立的能力面，可分别配置与扩展。

键鼠指示器

把鼠标点击、滚轮方向、键盘组合键一起可视化，例如 Cmd+Tab、W+ x3、L x2 这类信息在录屏与演示中一目了然。

自动化映射

支持将鼠标动作、滚轮与手势映射到快捷键、延时、URL 和启动应用等动作，让输入反馈真正接入效率流程。更完整的脚本、Profile 与动作链能力仍在路线图中。

WASM 插件运行时

插件支持 effects 与 indicator 两类 surface，具备 manifest 加载/重载/导入/导出、预算控制、命令校验、错误码与阶段诊断。宿主控制渲染边界，插件只负责逻辑计算，并提供 spawn_text、spawn_image、spawn_pulse、spawn_polyline、spawn_ribbon_strip、spawn_glow_batch 等命令原语。

架构要点

• 宿主控制渲染边界：渲染执行、预算校验、回退与资源控制由宿主负责
• 模块分层清晰：Core / Platform / Server / WebUI / Tools / Docs 职责独立
• 渐进式扩展：内建效果可用，WASM 插件可叠加，原生回退可兜底
• 跨平台语义对齐：Windows 与 macOS 共用核心语义与设置面
• 可观测性内建：WebSettings、诊断、回归脚本与自检入口统一设计

快速上手（示意）

Windows 侧推荐用 Visual Studio 打开解决方案编译，也可使用封装命令：

.\mfx.cmd build
.\mfx.cmd package

macOS 侧提供统一的 make 与 mfx 入口：

make build
./mfx run

macOS 需要授予 Accessibility 与 Input Monitoring 权限才能捕获全局输入。

平台状态

适合谁

• 做录屏、教程、直播演示，希望观众看清操作细节的创作者
• 想在 C++ 宿主中引入 WASM 扩展机制的开发者
• 需要跨平台输入捕获与叠加层渲染参考的桌面应用作者