和弦识别与推荐 · Chord Recognition & Recommendation

一个面向吉他手的本地优先 Midwest Emo 和弦探索工具。它适合这样的创作时刻：你偶然弹到一个很好听的指法，却不知道接下来还能去哪里。

程序可以从声卡录下吉他和弦，结合当前调弦与变调夹位置推测具体指法，再给出五个可以亲手尝试的下一和弦。所有音频分析都在浏览器本地完成，不会上传录音。

A local-first Midwest Emo guitar chord explorer for turning one interesting voicing into several playable directions.

功能

• 支持 Scarlett 等声卡输入，以及 Mac 内置麦克风
• 空格键开始／结束录音，本地复音识别
• 三个候选指法，支持按 1 / 2 / 3 确认
• “再弹一次”可以合并多次录音，提高判断稳定性
• 15 品虚拟指板，可在没有声卡或识别错误时手动输入
• 支持标准、Drop D、FACGCE、DAEAC♯E、DADF♯AE、DADF♯AD 调弦
• 支持变调夹 0–12 品
• 每次推荐 2 个稳妥方向和 3 个探索方向
• 针对开放弦、局部形状、add9、maj7、m7、sus 等 Midwest Emo voicing 加权
• Find more 可直接以任意推荐指法建立下一页
• 喜欢标记、输出选择与推荐刷新互不影响
• 按页面整理并导出和弦图 PNG

运行环境

• macOS
• Google Chrome
• Node.js 22.13 或更高版本
• 声卡并非必需；没有声卡时可以使用虚拟指板

快速开始

首次使用，双击：

setup.command

安装完成后双击：

start.command

程序会自动在 Chrome 打开 http://localhost:3000。

也可以从终端运行：

npm install
npm run dev

使用流程

1. 选择实际调弦与变调夹位置。
2. 连接音频输入，或打开虚拟指板。
3. 弹奏和弦并保持约 2–3 秒。
4. 从三个候选指法中确认一个。
5. 逐一尝试五个推荐，使用喜欢、加入输出或 Find more 继续探索。
6. 完成后将选择的和弦按页面导出为 PNG。

当前限制

• 自动识别仍会受到输入电平、扫弦方式、泛音和环境噪声影响。
• 当前推荐来自可解释的乐理与吉他指法规则，并非训练于受版权保护歌曲的生成模型。
• 第一版以 macOS 和 Chrome 为主要测试环境。
• 页面内容只保存在当前运行期间，关闭程序后不会自动恢复。

开发验证

npm run lint
npm test

项目内使用 Spotify Basic Pitch 进行本地复音转录；模型文件随项目提供。