KeyForge

KeyForge 是一个 macOS 菜单栏应用，用于全局监听键盘按键并播放机械键盘风格音效。

功能

• 全局监听 keyDown 事件（CGEventTap）
• 每次按键播放点击音效
• 随机化音效参数，增强真实感
  • 音量随机浮动
  • pitch（cents）随机浮动
  • 立体声 pan 轻微偏移
• 对 Space / Enter / Backspace / Delete 使用更重的音色配置

运行环境

• macOS
• Xcode 26+

权限要求

应用首次运行时需要在系统设置中授予“辅助功能”权限，否则无法捕获全局按键事件。

资源

当前默认音效资源位于：

• KeyForge/Assets.xcassets/click.dataset/click.mp3

可选扩展资源（存在时会自动使用）：

• click_heavy（重击样本）

构建

xcodebuild -project KeyForge.xcodeproj -scheme KeyForge -sdk macosx -configuration Debug build

结构

• KeyForge/GlobalKeyMonitor.swift: 全局键盘监听与音效播放核心逻辑
• KeyForge/KeyForgeApp.swift: 菜单栏应用入口
• KeyForge/DashboardView.swift: 菜单栏面板