刮削源
刮削源用于为本地歌曲补充歌名、歌手、专辑、封面和歌词。它以 JavaScript 文件的形式保存在设备上,由 Aduoer 在本机运行;你可以使用自己编写的脚本,也可以导入其他人分享的脚本
刮削源不会改变原始音频文件。自动刮削时,Aduoer 会先按列表顺序尝试已启用的刮削源,再使用 Apple Music、iTunes、MusicBrainz,最后使用 LRCLIB 补充歌词。手动搜索歌词时,已启用的歌词刮削源和 LRCLIB 会并发返回结果
安全提示
只添加你信任的脚本。脚本可能会访问它声明的网络地址并处理歌曲信息;添加网络来源前,请确认下载地址和脚本内容可靠
打开刮削源设置
打开 设置 → 刮削源。
刮削源列表会显示:
- 第一行:刮削源名称
- 第二行:脚本版本和最近更新时间
- 其他提示:脚本错误、文件尚未同步到本机等状态。
TIP
非 Pro 权益将无法使用自定义刮削源
内置刮削源仍可以正常使用
添加刮削源
点击页面右上角的 添加(+)按钮,然后选择一种方式
1. 从网络添加(推荐)
- 选择 网络。
- 输入可以直接下载 JavaScript 文件的完整
http://或https://地址 - 点击 添加,等待文件下载和检查完成
推荐刮削源
点击右上角添加 -> 选择 网络,每次输入一个地址
https://c.xiaosm.cn/link/qq-provider.js
https://c.xiaosm.cn/link/netease-provider.js
2. 从本地文件添加
- 选择 本地。
- 在系统文件选择器中选择一个 UTF-8 编码的
.js文件 - 导入完成后,脚本会出现在列表中
3. 创建空脚本
选择 创建空脚本 可以直接打开编辑器,从模板开始编写
编辑
- 每个源都可以单独启用/禁用、编辑、更新和删除
- 刮削源可以调整顺序。在自动刮削和扫描刮削任务中,Aduoer 会按列表顺序尝试已启用的源
iCloud 同步
iCloud 只会同步刮削源的记录,不会自动下载脚本文件,如果你是在新设备上首次使用 Aduoer,需要点击右上角同步按钮进行手动同步一次
常见问题
为什么浏览器可以打开网络地址,但 App 添加失败
添加网络来源要求 URL 能直接返回 JavaScript 文件,而不是网页预览或需要登录的页面。请确认:
- 地址以
http://或https://开头 - 下载结果是脚本文本,而不是 HTML 错误页
- 网络没有要求浏览器 Cookie、网页登录或额外的人机验证
可以先在浏览器下载文件,再通过 本地 方式导入,以区分下载问题和脚本本身的问题
为什么来源添加成功但不可用
请查看来源条目下方的错误信息。常见原因包括脚本文件尚未同步、语法错误、网络地址不在白名单、请求超时或脚本返回格式不正确。修复网络来源时使用 更新;修复本地脚本后重新编辑并保存
开发
想要编写自己的刮削源?请阅读 JS 刮削源开发文档
为什么免费版看得到来源但不能启用
自定义刮削源是 Pro 功能。免费用户可以提前添加和整理来源,升级 Pro 后即可启用;升级前不会在自动刮削或手动搜索中执行这些脚本