资讯动态

Lyrico搜索源插件使用指南:5分钟导入配置插件,批量补全歌词与封面

发布时间:2026/10/14 17:18:55 来源:尧图企业网站定制
【免费下载链接】Lyrico一个开源的 Android 音乐标签编辑器支持标签搜索与编辑并提供逐字歌词支持。灵感来源于 LDDC 和音乐标签。项目地址https://gitcode.com/gh_mirrors/lyr/Lyrico点击查看免费下载Lyrico 是一款开源的 Android 音乐标签编辑器它本身不提供在线搜索能力——搜索源插件正是它的外挂大脑导入一个 ZIP 插件填写 API Key 等配置并启用就能在线搜索歌曲信息、批量补全歌词与封面把缺失的元数据一次性写回本地音频文件。本指南面向新手按导入 → 配置 → 启用 → 批量匹配四步走5 分钟即可完成全部设置。 核心关键词Lyrico 插件、搜索源插件、批量匹配歌词、批量匹配封面、插件配置一、搜索源插件是什么为什么需要它Lyrico 采用插件化架构应用本体负责运行时、配置界面、结果处理和标签写入而在线搜索能力完全由插件提供。一个插件通常声明以下三种能力可以只支持其中一部分能力对应操作典型用途元数据源searchSongs单曲主搜索、批量标签匹配补全标题、艺术家、专辑、年份、作曲作词等歌词源getLyrics单曲歌词搜索、批量匹配歌词获取 LRC/逐字歌词、翻译、罗马音封面源searchCovers单曲封面搜索、批量匹配封面在线搜索并更换专辑封面插件用 JavaScript 编写运行在 Lyrico 内置的QuickJS 引擎中源码位于 plugin/runtime/。对使用者来说无需了解代码细节——插件以ZIP 压缩包分发导入即可使用。二、5分钟导入插件从ZIP到安装前提插件 ZIP 包通常从官方插件仓库获取可覆盖 QQ 音乐、网易云音乐、酷狗音乐、Apple Music 等平台。一个压缩包内可能同时包含多个插件导入时会自动识别。导入操作步骤进入设置→搜索设置→插件管理点击右上角添加按钮导入插件在系统文件选择器中选择插件的ZIP 文件在发现插件包弹窗中查看识别结果并勾选要安装的插件点击安装导入弹窗会按版本关系提示四种状态新安装未安装过该插件⬆️更新包内版本更高建议安装♻️覆盖版本相同⚠️降级版本更低通常不建议安装如果插件包不符合格式如缺少manifest.json、ID 不合法、超过大小限制应用会拒绝导入并给出具体原因。整个流程由 SourcePluginInstaller.kt 完成解压、校验与原子安装无需任何手动干预。三、配置插件API Key、地区与封面尺寸部分插件需要填写配置项才能正常工作常见的配置项包括API 地址 / 服务器地址text 类型Token、API Keypassword 类型输入内容会被遮挡地区、封面尺寸、歌词来源dropdown 下拉选项超时时间number 数字类型配置操作步骤在插件管理页点击插件条目中的配置进入配置页按提示填写各项配置配置界面由插件在manifest.json中声明自动生成点击保存 保存后配置会在下一次搜索、歌词获取或封面搜索时传递给插件。已显示的搜索结果不会自动刷新需要重新执行搜索。⚠️ 密码字段保存后会隐藏显示但执行时仍会传给插件请只在可信插件中填写敏感凭据。若某个插件没有配置入口说明它没有声明可配置项直接启用即可。四、启用插件与调整优先级顺序插件安装后默认处于停用状态不会参与搜索。在插件管理页打开对应开关才会生效。插件管理页按元数据源、歌词源、封面源三个 Tab 分类插件声明的来源类型显示在名称下方。几个实用细节✅分开控制关闭某一类型只停用该类型不会删除插件文件和配置也不影响其他类型✅拖动排序上下拖动插件条目调整优先级排在前面的插件优先参与搜索顺序会同时影响单曲搜索与批量匹配✅按需启用只需歌词能力的插件只打开歌词源开关即可五、批量补全歌词与封面插件的真正威力单个歌曲可以手动搜索但一次处理几十上百首歌曲时批量匹配才是插件的高光时刻。Lyrico 提供三个独立的批量任务入口标签匹配元数据、批量匹配歌词、批量匹配封面。以批量匹配歌词为例在歌曲列表中长按任意歌曲进入多选模式勾选需要处理的歌曲支持全选和滑动区间选择点击右下角展开按钮FAB选择批量匹配歌词在批量匹配配置页面确认并发数点击开始任务执行期间实时显示进度完成后可在设置→其他→任务历史中查看每首歌的成功/失败/跳过详情匹配前请确认四件事检查项说明插件已启用至少有一个对应类型的插件处于开启状态顺序符合预期排在前面的插件优先调用必填配置已保存Token、API Key、地区等写入规则已设置相关字段应为补充或覆盖不能是禁用并发数说明并发越高处理越快但更容易触发限流或网络失败。出现频繁请求失败时应降低并发数重试。此外在设置→搜索设置中开启优先使用文件名匹配批量匹配会忽略已有的标题/艺术家标签、改用文件名作为搜索依据非常适合标签混乱但文件名规范的音乐库。六、字段写入规则补充还是覆盖插件搜索到的歌曲信息只是候选元数据最终是否写入音频标签、以什么方式写入由 Lyrico 的字段写入规则决定可针对每个插件单独配置模式行为禁用不写入该字段补充仅当本地标签为空时才用插件数据填充覆盖始终用插件数据替换本地标签批量补全场景通常选择补充模式最安全只填空、不动已有标签。而插件返回的平台内部信息歌曲 ID、歌词 ID、hash、Token 等只会原样传回同一个插件用于后续请求不会作为可见标签写入文件。七、常见问题快速排查现象排查方向启用后没有搜索结果插件可能不支持该能力必填配置未填网络异常平台接口已变化需更新插件配置保存后没立即生效配置在下一次搜索时才传入需重新执行搜索批量匹配大量失败降低并发数重试检查应用日志想彻底移除插件点击卸载会删除插件文件和配置不可撤销临时排除只需关闭开关遇到疑难问题可查看设置→其他→应用日志筛选插件或网络类型定位原因。八、相关文档与源码路径内容路径插件使用指南使用者必读docs/plugins/using.md插件开发总览docs/plugins/index.md从零编写插件示例docs/plugins/examples.mdManifest 字段参考docs/plugins/manifest.md批量操作指南docs/guide/batch.md插件运行时QuickJS 封装lyrico-app/src/main/java/com/lonx/lyrico/plugin/runtime/QuickJsRuntime.kt搜索源对外接口SearchSource.kt导入插件 → 填好配置 → 打开开关 → 批量匹配四步走完你的本地音乐库就会焕然一新 赞分享【免费下载链接】Lyrico一个开源的 Android 音乐标签编辑器支持标签搜索与编辑并提供逐字歌词支持。灵感来源于 LDDC 和音乐标签。项目地址https://gitcode.com/gh_mirrors/lyr/Lyrico点击查看免费下载相关推荐NXCheats完全指南Switch游戏作弊码终极资源库让你轻松掌控游戏体验NXCheats完全指南Switch游戏作弊码终极资源库让你轻松掌控游戏体验 NXCheats是一个专注于Switch游戏作弊码的开源项目汇集了众多热门游LyricsX桌面歌词插件安装与配置指南LyricsX桌面歌词插件安装与配置指南 项目基础介绍 LyricsX是一个基于Swift语言开发的iTunes/VOX桌面歌词显示插件专为Mac用户设计。该桌面应用LyricsX桌面歌词插件安装与配置指南LyricsX桌面歌词插件安装与配置指南 项目基础介绍 LyricsX是一个基于Swift语言开发的iTunes/VOX桌面歌词显示插件专为Mac用户设计。该桌面应用创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑