guitar_tap

Guitar Tap 是一款面向制琴师和吉他制作人的桌面应用，可将对乐器、音木板或音梁的简单敲击转化为可测量的声学数据。它捕捉敲击后的短暂余响，运行高分辨率 FFT，并显示在规划音梁、质量分布和板厚时至关重要的共振峰与材料特性。 其测量方法遵循 Trevor Gore 与 Gerard Gilet 所著《Contemporary Acoustic Guitar Design and Build》中描述的敲击音方法，既定目标是提高吉他制作的可重复性。该项目免费且开源，使用 Python 3 与 PySide6 编写，可在 Windows、macOS 和 Linux 上运行。releases 页面提供 macOS 和 Windows 的预构建安装程序；macOS 安装程序要求系统高于 Big Sur（11.0）。面向 iPhone、iPad 和 Mac 的原生版本据称即将在 App Store 推出。 应用提供三种测量模式。Guitar 模式可识别关键琴体共振，如 Air/Helmholtz、Top、Back 等，每项均标注频率、音高和 Q 值，以及敲击音比。Plate 模式测量音木坯料，报告顺纹和横纹方向的杨氏模量、声速、比模量、辐射比、质量等级和 Gore 目标厚度。Brace 模式则是对音梁条刚度、声速、比模量和质量的快速单次敲击测量。 其他功能包括：检测到敲击时会自动冻结的实时频谱、多次敲击平均、已保存测量的并排比较、保存测量并导出频谱、图像和 PDF 报告，以及对测量麦克风的麦克风校准支持。 从源码运行需要 Python 3.14 或更高版本、Git 以及平台依赖：macOS 上通过 Homebrew 安装 PortAudio，Debian/Ubuntu 上安装 portaudio19-dev 和 libxcb-cursor-dev，Windows 上无需额外系统包。依赖项在 pyproject.toml 中声明，并分为仅运行、开发者（pytest、mypy、ruff、weasyprint）和打包（PyInstaller）附加项。应用通过 python -m guitar_tap 启动。安装程序构建使用各平台脚本：Linux 上使用 AppImage 工具，Windows 上使用 Inno Setup，macOS 上使用 Apple Developer ID 进行代码签名/公证。 一个 soak 脚本（Tooling/soak.sh）会反复运行快速 pytest 测试套件，以暴露非确定性的拆卸或垃圾回收竞态；README 指出，soak 全绿是信心而非证明。启动时，应用会检查仓库的公开 releases 是否有更新版本，并显示可关闭的横幅；该请求不发送任何个人数据、音频或测量数据，每天最多运行一次，并可在 Settings 中禁用。完整用户文档托管在项目网站上，而设计和路线图文档则位于单独的项目中心仓库中。该软件采用 GPL-3.0 许可，版权归 Dolce Sfogato（David Smith）所有。