群晖Audio Station歌词插件完整使用指南

Synology LrcPlugin是一款专为群晖Audio Station和DS Audio设计的智能歌词插件，通过精准的匹配算法为音乐播放体验增添沉浸式歌词功能。本指南将详细介绍如何从安装到高级使用全面掌握这款工具。

快速上手：零基础安装指南

下载插件文件

首先需要获取插件文件，项目提供了两种版本：

• netease_org.aum：原始语言版本，显示歌词原文
• netease_trans.aum：中文翻译版本，在外语歌曲中自动添加中文翻译

安装到Audio Station

1. 打开群晖Audio Station应用
2. 进入"设置"菜单，选择"歌词插件"
3. 点击"添加"按钮，选择下载的.aum文件
4. 启用插件，在插件名称前打勾确认

开始使用歌词功能

安装完成后，播放歌曲时插件会自动搜索并下载匹配的歌词。如需更换歌词版本，可在Audio Station中右键点击歌曲，选择"歌曲信息"→"歌词"→"从网络搜索"，从搜索结果中选择更合适的版本。

核心功能深度体验

智能匹配算法

插件采用三层匹配策略确保最佳结果：

1. 精确匹配歌曲标题
2. 从多位艺术家中识别最佳匹配
3. 使用similar_text()算法计算相似度并排序结果

双语歌词支持

当歌曲存在中文翻译时，插件会将翻译文本按时间标签匹配到原始歌词行末尾，实现双语同步显示。这种设计既保留了原文的韵味，又提供了理解便利。

搜索结果优化

插件不仅返回匹配结果，还会根据艺术家和标题的相似度进行智能排序，确保最相关的歌词出现在列表前列。

进阶玩法：高手必备技巧

优化歌词匹配效果

如果自动匹配结果不理想，可以尝试以下方法：

• 确保歌曲元数据准确，特别是艺术家和标题信息
• 使用手动搜索功能，从第二或第三条结果开始尝试
• 优先选择包含专辑信息的歌词版本

海外用户解决方案

由于网易云音乐对海外IP的限制，部分用户可能无法正常获取歌词。建议海外用户寻找基于QQ音乐API的替代方案。

自定义配置

通过修改netease.php文件中的常量，可以调整插件行为：

• 设置DEBUG为true启用调试模式
• 修改NEED_TRANSLATION控制是否显示中文翻译

技术原理浅析

匹配机制详解

插件通过以下步骤实现精准匹配：

1. 搜索歌曲标题，获取候选列表
2. 筛选精确匹配或部分匹配的标题
3. 从所有艺术家信息中找出最佳匹配
4. 综合计算相似度并排序结果

歌词处理流程

下载歌词后，插件会：

• 解析原始歌词的时间标签和文本内容
• 检查是否存在翻译版本
• 将翻译文本按时间轴匹配到对应位置
• 生成最终的双语歌词文件

API调用过程

插件使用网易云音乐API进行搜索和下载：

• 搜索API：http://music.163.com/api/search/get/web
• 歌词下载API：http://music.163.com/api/song/lyric
• 支持获取原始版本、翻译版本和卡拉OK版本

资源与支持

获取最新版本

项目源代码托管在GitCode平台，可以通过以下命令克隆仓库：

git clone https://gitcode.com/gh_mirrors/sy/Synology-LrcPlugin

构建自定义版本

在项目根目录下运行构建脚本，可以生成适用于Audio Station的.aum文件：

./build.sh

开发注意事项

• 不要在PHP脚本中使用echo()函数，否则Audio Station无法返回结果
• 歌词文件采用标准的LRC格式，包含时间标签和歌词文本
• 翻译文本以"【翻译内容】"的形式附加在原始歌词行后

社区资源

本插件受多个开源项目启发开发，包括Frank Lai的Synology Lyric项目、Moonlib的PHP API实现以及Raykuo的歌词插件教程。

提示：在使用过程中如遇到歌词不匹配的情况，建议优先检查歌曲的元数据信息，准确的艺术家和标题信息是获得理想匹配结果的关键。