MechvibesDX：低延迟机械键盘音效模拟器 #

MechvibesDX 是什么？ #

MechvibesDX 是一款多复音、低延迟的机械键盘与鼠标声音模拟器，是经典工具 Mechvibes 的全面升级版本，使用 Rust 语言配合 Dioxus 框架从零重写。

它能在你敲击任意按键、点击鼠标时实时播放对应的机械键盘音效，无论是办公码字、游戏对战还是直播录音，都能为薄膜键盘或笔记本自带键盘补上"嗒嗒"的敲击手感。相比原版 Mechvibes，MechvibesDX 引入了加载期重采样（resample-on-load）、独立音频引擎线程、32 声道声音池与一键校验更新机制，在音质、延迟和稳定性上都有明显提升。软件采用 MIT 许可证开源发布，Windows、macOS 与 Linux 用户均可免费获取完整功能。

MechvibesDX 有哪些亮点特色？ #

• 多复音低延迟音频：按键到发声的延迟约为 15ms，声音在加载时完成重采样而非实时处理，兼顾高音质与低开销；内置 32 声道声音池并采用软驱逐策略，快速连打时不会出现爆音或削波。
• 窗口失焦依然有效：Windows 平台通过独立的 Raw Input 工作进程捕获输入，Linux 与 macOS 使用进程内监听，无论 MechvibesDX 窗口是否处于前台，键盘与鼠标的响音都保持一致的触发效果。
• 声音包自由导入与创建：支持拖拽文件夹导入自定义声音包，兼容 OGG、WAV、MP3、FLAC 四种音频格式；内置经典 Mechvibes、Cherry MX Black 等精选声音包，导入旧版 V1 声音包时会自动转换为 V2 格式。
• 运行时切换输出设备：在设置中即可把音效切换到耳机、音箱或虚拟声卡，无需重启应用；长时播放的氛围音（如雨声、咖啡馆环境音）也会跟随所选输出设备一起迁移。
• Windows 按设备过滤输入：可在设置中单独禁用某个键盘或鼠标，修改立即生效，方便同时连接多套外设的用户避免重复触发。
• 一键校验更新（Windows）：检测到新版本后可直接下载安装，并通过 SHA-256 校验文件完整性；选择"稍后"也不会丢失已下载的验证文件，随时可继续安装。
• 主题与个性化定制：内置浅色/深色主题，支持自定义 Logo 与背景图片；托盘图标会直观显示当前静音状态，Ctrl+Alt+M 全局热键可随时静音/取消静音。
• 配置稳定持久化与调试支持：设置保存在系统标准用户目录中，跨重启、重装与升级都不丢失；设置内的调试区块提供实时日志查看器与导出按钮，可选开启逐键时序详细模式以诊断延迟问题。

MechvibesDX 免费下载 #

以下为官方提供的各平台安装包（当前版本 0.8.4），点击链接即可下载。

官方 GitHub Releases 页面同时提供 Debian/Ubuntu 的 .deb 安装包，并为每个版本附带覆盖全部资产的 SHA256SUMS.txt 校验文件，便于验证下载完整性。

MechvibesDX 如何使用？ #

1. 启动与选择声音包：首次打开应用后进入 Settings > Soundpacks，在随附的精选中挑选一个键盘声音包（如 Cherry MX Black），并把鼠标音效设置为独立的声音包。
2. 调节音量与输出设备：在设置中调整播放音量，并从下拉列表选择当前使用的音频输出设备（耳机、音箱或虚拟声卡），切换后立即生效，无需重启。
3. 开启全局静音热键：使用 Ctrl+Alt+M 可随时静音或取消静音，托盘图标会同步显示静音状态；需要临时安静时无需打开主窗口。
4. 导入自制声音包：把自己的声音包文件夹直接拖入应用窗口，或点击 Settings > Soundpacks > Import Soundpack 选择文件夹。声音包需要包含 config.json 与音频文件，icon.png 为可选的显示图标。
5. 编写 config.json（V2 格式）：配置文件包含 id、name、author、config_version、definition_method（single 或 multi）、audio_file、definitions、options 与 soundpack_type 等字段。按键通过 timing 数组指定音频片段区间，例如 "KeyA": { "timing": [[0, 50]] } 表示触发音频文件第 0–50 毫秒的片段；single 模式下所有按键共享同一音频文件，multi 模式下每个按键可指向不同文件。
6. 排查问题：若出现延迟或无声，进入设置中的调试区块查看实时日志，必要时开启详细模式获得逐键时序数据，并可通过导出按钮提交问题报告。

MechvibesDX 的常见问题？ #

Q：为什么在 Linux 上完全没有声音或按键无响应？ A：Linux 版需要把当前用户加入 input 组才能读取键鼠输入，执行 sudo usermod -a -G input $USER 后必须重新登录（或重启）才会生效。使用 AppImage 时还需要先执行 chmod +x 赋予可执行权限。遗漏任一步骤都会导致捕获失败。

Q：macOS 提示应用来自未受信任的开发者，无法打开怎么办？ A：官方说明 macOS 版本目前为实验性且未签名，需要右键点击应用图标并选择"打开"来绕过 Gatekeeper 检查，之后即可正常启动。

Q：旧版 Mechvibes 的 V1 声音包还能用吗？ A：可以。应用在导入时会自动识别 V1 格式的声音包并转换为 V2 格式，无需手动改写 config.json。

Q：快速连打时会出现爆音或声音断断续续吗？ A：正常情况下不会。应用使用 32 声道声音池并配有软驱逐策略，声音在加载阶段完成重采样，官方标称触发延迟约 15ms。若仍有异常，建议在调试区块查看日志，并确认输出设备未被其他程序独占。

Q：更新或重装后之前的设置会丢失吗？ A：不会。可写状态分别保存在 %APPDATA%\Mechvibes（Windows）、~/.local/share/mechvibes（Linux）和 ~/Library/Application Support/Mechvibes（macOS），设置会在重启、重装与升级之间保持一致。

Q：能否只让某一把键盘发声，屏蔽另一把？ A：可以，但该功能目前仅在 Windows 平台提供。在设置中可禁用指定的键盘或鼠标设备，修改立即生效。

MechvibesDX 如何安装？ #

Windows #

1. 下载 MechvibesDX-0.8.4-Setup-x64.exe。
2. 双击运行安装程序，按向导完成安装（安装脚本基于 Inno Setup 构建）。
3. 启动应用；后续版本可在应用内一键下载更新，更新包会自动进行 SHA-256 校验。

macOS #

1. 下载 mechvibes-dx-0.8.4-macos-arm64.dmg（适用于 Apple Silicon 机型）。
2. 打开镜像，将应用拖入"应用程序"文件夹。
3. 首次启动时右键点击应用图标并选择"打开"，以绕过 Gatekeeper 限制。当前版本为实验性且未签名。

Linux（Debian/Ubuntu） #

1. 从官方 Releases 获取对应的 .deb 安装包。
2. 执行 sudo dpkg -i mechvibes-dx_*.deb 完成安装。
3. 执行 sudo usermod -a -G input $USER 并把用户加入 input 组，随后重新登录，否则无法捕获键盘输入。

Linux（任意发行版，AppImage） #

1. 下载 mechvibes-dx-0.8.4-x86_64.AppImage。
2. 执行 chmod +x mechvibes-dx-0.8.4-x86_64.AppImage 赋予可执行权限。
3. 直接运行该文件即可使用，无需安装；同样需要完成 input 用户组设置。

从源码构建的用户需先准备 Rust 工具链与 Node/pnpm 环境，仓库根目录提供 Cargo.toml、Dioxus.toml 与 pnpm-workspace.yaml 等构建配置，README 中的 Building from Source 章节给出了完整的 Prerequisites 与 Build 步骤。

MechvibesDX 如何卸载？ #

Windows #

1. 打开"设置 > 应用 > 已安装的应用"（或控制面板的"程序和功能"）。
2. 找到 MechvibesDX 并选择卸载，按向导完成移除。
3. 如需彻底清理，可手动删除配置目录 %APPDATA%\Mechvibes（其中包含设置与已导入的声音包）。

macOS #

1. 打开"应用程序"文件夹，将 MechvibesDX 拖入废纸篓并清空。
2. 如需清除残留配置，删除 ~/Library/Application Support/Mechvibes 目录。

Linux（AppImage） #

1. 直接删除 .AppImage 文件即可，程序本身不写入系统目录。
2. 清理配置可删除 ~/.local/share/mechvibes 目录。

Linux（Debian/Ubuntu） #

1. 执行 sudo dpkg -r mechvibes-dx 卸载软件包（如需连同配置一起移除可使用 sudo dpkg --purge mechvibes-dx）。
2. 手动删除 ~/.local/share/mechvibes 可清除用户级配置与声音包缓存。
3. 若不再需要，可用 sudo gpasswd -d $USER input 将用户从 input 组中移除。