使用帮助

1. 快速开始

首次使用时，请点击「开始」按钮授权麦克风权限。授权后，APP 将实时采集麦克风音频并检测音高。请确保在安静的环境中使用，以获得最佳检测效果。如果浏览器提示权限请求，请选择「允许」。

2. 实时检测

当你对着麦克风吹奏口琴时，APP 会自动识别当前音高，并在可视化口琴界面上高亮对应的孔位。不同技巧用不同颜色区分：蓝色 = 吹音，红色 = 吸音，橙色 = 压音（吸气/吹气压音），紫色 = 超吹/超吸。

等待检测时，顶部会显示音频波形动画。检测到音高后，波形替换为绿色音名徽标和音准偏差指示器。

音准指示器圆点颜色表示音准状态（见 App 内演示）。

3. 口琴可视化

口琴界面完整呈现所有孔位和技巧。上方为吹音区（蓝色）、吹气压音和超吹；下方为吸音区（红色）、吸气压音和超吸。中间圆形显示孔号（1–10）。

点击任意音符格子可试听该音。长按可持续发声。

音符显示支持三种模式（见 App 内演示）。

4. 口琴设置

选调：支持全部 21 个调（从 Low C 到 High G），选择你手中口琴的调号。
把位：选择 1st–12th 把位，APP 会自动计算对应的调式根音。

五度圈：12 个音名按五度排列成圆环，当前把位的根音高亮显示（青色），中心显示把位序号。点击任意音名即可切换到该把位，例如 C 琴点击 G 切到 2nd 把位、点击 D 切到 3rd 把位。切换调号时圆环会旋转动画，始终保持当前调号在正上方。选择把位后自动切换到简谱显示模式。

5. 调音系统

调音下拉分三组：全音阶、半音阶、自定义。全音阶包含 14 种预设（Richter、Country、Paddy Richter、自然小调、和声小调、Melody Maker、Power Draw、Power Bender、Wilde、Ed Harmonica、MajorCross、Newbie、12孔 Solo、12孔 C6）。半音阶包含 Solo（8/10/12/14/16 孔）、C6（8/10/12/14/16 孔）和 Richter 10 孔，通过推键获得半音，口琴视图会显示推杆动画。点击下拉底部的「+ 添加调音」可为全音阶口琴创建自定义调音：选择预设为基础，逐孔用 ▲/▼ 调整吹/吸音高，系统自动推算压音、超吹和超吸。自定义调音保存在本地，可随时载入或删除。

6. MIDI 播放

从下拉菜单选择内置 MIDI 文件，或点击「本地文件」加载自己的 MIDI。播放控制包括：播放/暂停/停止、速度调节（0.25x–2x）、循环开关。播放模式可选「原声」（三角波音色）或「口琴」（口琴合成音色）。播放时口琴界面会实时高亮当前音符对应的孔位。

工具栏右侧的图标可切换面板显示（见 App 内演示）。

MIDI 文件兼容性

为获得最佳体验，推荐使用单音旋律、单轨的 MIDI 文件。APP 会自动提取旋律音符，但对于同时发声的多音/和弦段落，可能无法完美拆分为单音旋律。

多声部、多轨文件也可以加载，但需要手动选择合适的音轨和旋律提取模式。

多音轨文件加载后，在练习面板的「当前曲目」模式下会出现音轨选择器。下拉菜单列出所有音轨名称和音符数，选择包含主旋律的音轨即可。

工具栏中的旋律提取按钮可在三种模式间循环切换，帮助处理多声部/和弦内容：
· 自动（A）：智能提取旋律——当检测到同时多音时自动过滤低音和伴奏声部，单音段落则保留所有音符
· 仅旋律：始终强制提取最高音旋律线，忽略所有伴奏
· 全部音符：不做任何过滤，显示原始的所有音符

7. 节拍器

独立节拍器支持 BPM（每分钟拍数）和拍号调节。节拍指示灯实时显示当前拍位。

MIDI 同步

播放 MIDI 文件时，节拍器自动同步到 MIDI 的节拍和速度，无需手动设置。

8. 动态谱

动态谱在 MIDI 播放时以可视化乐谱展示音符，支持三种视图模式：走马灯（Piano-roll）、简谱和五线谱。

左上角的视图切换按钮可在三种视图之间循环切换。所有视图均支持播放头跟踪、当前小节高亮和拍线/小节线显示。

走马灯（Piano-roll）视图

走马灯（Piano-roll）视图以水平滚动条形式展示音符。Y 轴对应音高，X 轴对应时间。播放头（青色竖线）指示当前位置。虚线为拍线，实线为小节线，当前拍用半透明色带高亮。音符块用动作配色（蓝=吹、红=吸、橙=压音、紫=超吹/超吸），激活态音符发光显示。

标签模式（走马灯专属）：音符块内显示标签，左上角按钮切换三种模式：
· TAB（1+2）：口琴谱记号（数字=孔号）
· 简谱（123）：数字简谱（数字上方加点 = 高八度，下方加点 = 低八度）
· 音名（ABC）：固定音名，如 C♯、B♭、G

TAB 记号说明：吹音、吸音、吸气压音（撇号数=半音数）、吹气压音、超吹/超吸。

简谱视图

简谱视图以传统数字简谱格式显示乐谱，支持完整的标注体系：下划线（八分/十六分/三十二分音符）、附点、连音线、三连音、八度点、升降号、小节线、反复记号等。播放时当前小节高亮显示，播放头指示精确位置。简谱模式更适合习惯数字简谱的用户。

五线谱视图

五线谱视图以标准五线谱格式显示乐谱，包含音符头、符干、升降号和上下加线。播放时当前小节高亮，播放头指示精确位置。五线谱模式适合有乐理基础的用户。

通用功能

左上角的展开按钮可放大动态谱高度，方便查看密集音符。再次点击缩回原始大小。

左下角显示音符统计：绿色数字为总音符数。如果 MIDI 中有超出口琴音域的音符，会用红色数字显示超出数量（如 2/16 表示 16 个音符中有 2 个超出音域）。

9. 练习模式

练习模式包含模进练习、当前曲目跟练、即兴伴奏和节奏训练四种方式。

模进练习：选择音阶（13 种）、琶音（9 种）、音程（4 种）或模进序列（7 种），设定方向（上行/下行/双向）、节奏型（6 种）和重复次数，跟随播放吹奏。

当前曲目跟练：加载 MIDI 文件后，选择「跟练当前曲目」即可跟着当前曲目练习。支持设置小节范围（如第 3–8 小节）进行片段循环练习，也可以直接在动态谱上点击小节号来快速选择练习范围。

即兴伴奏

即兴伴奏提供三大类风格的和弦进行：

蓝调：标准 12 小节、快速换和弦、小调布鲁斯等经典进行。
爵士：Jazz Blues（含 ii-V 替代和弦）、ii-V-I（4小节）、ii-V-I-VI、爵士半音下行、小调 ii-V 等。
流行：I-V-vi-IV 万能进行、vi-IV-I-V 忧伤风、I-IV-V-IV 摇滚、I-vi-IV-V 50 年代经典、卡农进行（8小节）等。

伴奏模式可选合成（SoundFont 采样，钢琴+鼓真实音色）、合成1（纯 Web Audio 合成）或采样（蓝调专用录音）。APP 自动生成鼓、Bass、键盘三声部伴奏，和弦网格实时显示当前小节位置。每种进行有独立的默认 BPM，你可以自行调整并自动保存。

节奏训练

节奏训练专注于纯节奏练习，使用鼓声代替口琴音。分 10 个难度级别，由简到难循序渐进：

1-2 级：全音符、二分音符、四分音符（基础拍感）
3 级：八分音符对 + 四分/二分休止符
4 级：附点四分+八分、两四分组合
5 级：十六分音符组
6 级：切分节奏 + 八分休止组合
7 级：三连音
8 级：附点八分+十六分、混合细分
9 级：3/4 拍 + 附点二分
10 级：全部元素随机混合

每个级别包含当前级及所有低级别的节奏型，高级别元素出现概率最大，低级别作为基础穿插其中。点击骰子图标可随机生成新的节奏型。

节奏以标准打击乐谱显示（打击乐谱号、单线谱、标准音符头和休止符）。播放时绿色高亮跟踪当前拍位，强拍/弱拍有力度区分。

10. 其他设置

语言切换：支持简体中文、繁體中文、English、Español、Português、Italiano、Русский 七种语言。
暗黑模式：点击月亮/太阳图标切换亮色/暗色主题，还有自动模式（18:00–6:00 自动切换为暗色）。
横竖屏：点击 ⇅ 按钮手动切换布局；横屏模式下口琴居中，竖屏模式下功能面板在下方。
关于：点击 ⓘ 图标查看应用信息、帮助入口，以及去除广告和恢复购买。
隐私：练习记录、录音、设置仅保存在本地。为了优化产品和用户体验，应用会向服务器注册一个设备标识，并发送化名使用事件与崩溃报告 — 详见隐私政策。
A4 基准频率：位于控制栏，可在 438–445Hz 之间调节（默认 442Hz），影响检测和播放的音准标准。

11. 去除广告

HarpMaster 免费提供所有功能。如果你希望获得无广告的纯净体验，可以在「关于」页面进行一次性购买，永久移除所有广告。