浏览器里的「听歌识曲」雷达 —— 识别浏览器里正在播放的任何歌曲，自动给出歌名、歌手、封面，并可跳转平台在线播放。类似网页版 Shazam。

Paiway-AHA（AHA Music 音乐识别）Chrome 插件使用教程

一句话定位：浏览器里的「听歌识曲」雷达 —— 识别浏览器里正在播放的任何歌曲，自动给出歌名、歌手、封面，并可跳转平台在线播放。类似网页版 Shazam。

• 插件名称：AHA Music - Song Finder for Browser
• 版本：v2.0.4（MV3，最低 Chrome 88+）
• 官方网站：https://www.aha-music.com
• 识别引擎：ACRCloud（https://www.acrcloud.com）
• 开发者：qiuxuewen（个人开发者，支持 BuyMeACoffee 打赏）
• 打包来源：派为资料整理（网址导航 http://nav.paiwayinfo.com/）

1. 安装方法（Chrome 加载已解压的扩展）

1. 打开 Chrome，地址栏输入 chrome://extensions 回车；
2. 打开右上角 「开发者模式」 开关；
3. 点击左上角 「加载已解压的扩展程序」；
4. 选择插件文件夹：D:\TONGBU-NAS\网盘整理(新)\浏览器插件\paiway-aha；
5. 安装成功后工具栏出现 AHA Music 图标（被折叠就点拼图图标找到并「固定」）。

2. 快速上手（听歌识曲 3 步）

1. 打开正在播放音乐的标签页（任意网站都行：YouTube、B站、视频站、在线电台、MV 网页……只要是标签页里发出的声音）；
2. 点击工具栏的 AHA Music 图标 打开弹窗；
3. 点击 「识别」（Identify）按钮，等 3~8 秒，就能看到识别结果：

• 歌曲名、歌手、专辑、封面图；
• 可点击跳转到 YouTube / Spotify 等平台直接播放或收藏。

💡 浏览器首次识别会弹「是否允许捕获标签页音频」的授权提示，点允许，否则识别不了声音。

3. 功能详解

3.1 识别范围（不是只听视频网站）

AHA Music 捕获的是当前标签页输出的全部音频，所以适用场景很广：

• 视频网站的 BGM（YouTube、B站、抖音网页版、MV 等）；
• 在线电台 / 音乐流媒体里不认识但喜欢的一首；
• 网页游戏、直播、在线课里的背景音乐；
• 甚至可以用它识别自己电脑里正在播放的声音（如果是从网页播的）。

3.2 识别历史（History）

• 每次成功识别都会自动记录：歌曲名、歌手、识别时间；
• 历史记录保存在本地（浏览器 storage），不占服务器资源；
• 翻历史时点开就能看到结果并可跳转播放。

3.3 平台联动跳转

识别结果卡片提供到主流平台的直达链接（YouTube、Spotify 等），点一下就能在原平台听完整版。

3.4 Google 账号登录（可选）

• 插件支持用 Google 账号登录（manifest 已配置 OAuth）；
• 登录与否都不影响核心识别功能，属于可选增强（用于保存偏好/历史等）。

3.5 识别接口说明

识别走的是插件后端 extension.doreso.com/v1/aha-music/identify + ACRCloud 指纹库，所以识别时必须联网，结果准确率取决于音频清晰度和歌曲库覆盖率。

4. 使用技巧

5. 常见问题（FAQ）

Q1：点识别没反应/一直转圈？
大概率没联网或网络被墙（识别服务在境外）。检查网络；国内网络访问识别接口不稳定时可尝试科学上网后重试。

Q2：提示需要授权捕获标签页音频？
浏览器安全机制，点「允许」即可。如果之前点过「拒绝」，到 chrome://extensions → 该插件 → 权限，重新授权。

Q3：识别结果错误 / 识别不出？
ACRCloud 库覆盖广但不是万能的：纯音乐、改编版、现场版、过于嘈杂的音频识别率会下降。可等歌曲高潮段重试。

Q4：支持哪些网站？
几乎所有网页。只要是标签页里播放的声音都能捕获，不限于视频网站。

Q5：识别历史存在哪？
本地浏览器存储（storage + unlimitedStorage），不上传服务器，重装插件或清浏览器数据会丢失。

Q6：需要注册/付费吗？
核心识别免费（走插件作者的后端额度）。作者接受 BuyMeACoffee 打赏支持；Google 登录可选。

6. 其他信息

• 权限说明：tabCapture（捕获标签页音频，核心权限）；identity / identity.email（Google 登录）；storage + unlimitedStorage（历史记录本地存储）；activeTab（读取当前页）。
• 技术特性：MV3 架构 + 沙箱 WASM 指纹模块（sandbox.html），识别计算在插件内部完成。
• 更新渠道：商店版走 update_url 自动更新；本地加载版更新需重新加载扩展目录。

教程基于插件 2.0.4 源码整理，2026-10-23。