Listen1 安装与使用说明3个步骤把7个国内音乐平台聚合进一个浏览器扩展【免费下载链接】listen1_chrome_extensionone for all free music in china (chrome extension, also works for firefox)项目地址: https://gitcode.com/gh_mirrors/li/listen1_chrome_extensionListen1 是一个开源免费的浏览器音乐扩展它聚合网易云音乐、QQ 音乐、酷狗、酷我、bilibili、咪咕等国内平台的播放资源让你用一个搜索框完成搜歌和播放。本文面向新手讲解 Listen1 的安装步骤与常用功能。一、 能力速览Listen1 运行在浏览器标签页里不需要单独装客户端播放数据全部来自各音乐平台的官方接口扩展本身是一个轻量的聚合层省掉你在七个网站之间来回切换的麻烦。日常使用中它能替你做的事情有四点一次搜索输入一个关键词所选各平台的搜索结果会合并展示在一起歌单聚合把不同平台的歌曲收进同一个歌单也支持通过分享链接导入别人的歌单音源兜底当前播放源无法播放时自动去其他平台寻找可播放的版本歌单备份歌单可以同步到 GitHub Gist换设备或重装系统后不会丢失二、 安装与首次运行Listen1 安装步骤推荐路径是官方扩展商店一共三步打开你浏览器对应的扩展商店Chrome 网上应用店、Edge 加载项或 Firefox 附加组件在商店中搜索 Listen 1点击添加到浏览器安装完成后把 Listen1 图标固定到工具栏点击即可打开首次运行不需要登录默认页面就是搜索框勾选你常用的平台即可开始听歌。备选路径是手动加载适合无法访问商店的情况。第一步是下载项目代码git clone https://gitcode.com/gh_mirrors/li/listen1_chrome_extensionChrome在扩展管理页打开开发者模式选择加载已解压的扩展程序指向克隆下来的目录Firefox先用根目录的 manifest_firefox.json 替换 manifest.json再在该目录执行zip -r ../listen1.xpi *打包出 xpi 文件最后在 Firefox 中加载安装三、 核心功能拆解搜索、歌单与音源切换搜索与播放顶部搜索框是主入口搜索逻辑位于 js/controller/instant_search.js。输入歌名或歌手所选平台的结果会合并显示双击某条结果即可直接播放播放条支持播放暂停、上一曲下一曲和进度拖动搜索与播放时的加载动画歌单管理我的歌单面板统一管理你创建的和导入的歌单对应控制器是 js/controller/my_playlist.js。把当前歌曲加入新歌单默认封面就是下图的黑胶唱片粘贴歌单分享链接可以整单导入支持两个歌单合并也可以拖动调整顺序黑胶唱片图是新歌单的默认封面音源切换当一首歌因版权或接口失效无法播放时会自动到其他平台搜索同一首歌Beta 功能。设置里可以配置参与自动切源的平台正在播放页会显示当前歌曲的来源平台和码率各平台接口实现都放在 js/provider/ 目录四、⚙️ 进阶设置快捷键、平台偏好与歌单备份熟悉之后有三条建议可以照做。第一条按键盘上的 ? 调出快捷键列表把播放暂停等操作绑定到按键上就不用每次控制都打开页面了。第二条根据自己的会员情况调整默认平台顺序QQ 音乐有会员时把它排在前面最高能拿到 320kbps 码率。第三条歌单数量变多之后登录 GitHub 账号定期做一次 Gist 备份这是搬运歌单时最稳妥的办法。五、❓ 常见问题新手用 Listen1 容易卡住的点加载已解压扩展后浏览器重启提示此扩展程序不会更新是不是出错了不是错误属正常现象。开发者模式加载的扩展不走商店的更新机制所以不会自动更新拉取新代码后需要在扩展管理页手动点一下重新加载。安装后在工具栏找不到 Listen1 图标扩展其实已经装好了只是图标被收起来了。点击工具栏上的拼图图标展开扩展列表把 Listen1 固定出来即可。较新的 Chrome 版本默认收起所有扩展图标容易被误认为安装失败。某些平台搜索没结果或报错多数是平台接口变更或该平台搜索功能临时失效这类问题在没有自建后端的开源项目里比较常见维护者通常会在版本更新中修复例如 2025 年 6 月的 2.33.0 版本就修复了咪咕和酷我的播放问题。着急的话可以换其他平台搜索。歌单在换电脑或重装系统后会丢吗歌单默认存在浏览器本地存储里不会自动同步。需要跨设备携带时登录 GitHub 账号使用 Gist 备份功能到新环境里恢复即可。Firefox 手动安装需要改文件吗商店安装的版本不需要任何改动。只有开发者模式打包 xpi 时才需要用 manifest_firefox.json 替换根目录的 manifest.json如果误改了文件用重新下载的代码包恢复即可。Listen1 的功能边界受各平台接口可用性的限制维护节奏虽然快但并非一劳永逸保持更新的习惯比任何调校都重要。下一步建议装好后先导入一个你现有平台的歌单试试流程再做一次 Gist 备份整套迁移方案就算跑通了。【免费下载链接】listen1_chrome_extensionone for all free music in china (chrome extension, also works for firefox)项目地址: https://gitcode.com/gh_mirrors/li/listen1_chrome_extension创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考