词幕Lyricon是什么？Android状态栏歌词工具完全入门指南
词幕Lyricon是什么？Android状态栏歌词工具完全入门指南
词幕Lyricon 是一款基于 Xposed / LSPosed 的 Android 状态栏歌词工具，能把正在播放的歌曲歌词实时显示在系统状态栏区域，支持逐字高亮、翻译歌词、AI 翻译和自定义样式。无论你是想"边听歌边看状态栏歌词"，还是想给不同播放器配置独立样式，这份指南都能帮你在 10 分钟内完成安装并跑通显示效果。
词幕Lyricon 能做什么？核心功能一览
一句话概括：词幕负责"显示"，插件负责"供歌词"。主体应用本身不直接显示状态栏歌词，只有 LSPosed 模块启用、作用域包含 System UI 并重启后，歌词才会出现在状态栏。
| 功能 | 说明 |
|---|---|
| 🎵 状态栏歌词 | 在系统状态栏区域显示当前播放歌词 |
| ✨ 逐字歌词 | 支持字词级进度和高亮（取决于歌词来源） |
| 🌏 翻译歌词 | 插件提供翻译，或接入 OpenAI 兼容接口生成 |
| 🧩 插件扩展 | 通过歌词提供服务（LyricProvider）适配不同播放器 |
| 🎨 视觉自定义 | 文字、图标、动画、封面取色均可独立配置 |
| 💾 备份恢复 | 一键导出、恢复全部配置 |
不同 ROM 的状态栏结构差异较大，位置参数没有通用最佳值，需要结合自己的设备微调。
词幕由哪三部分组成？
理解下面的结构，能帮你快速判断"歌词不显示"到底卡在哪一步：
| 组成 | 作用 | 对应源码/文档 |
|---|---|---|
| 词幕主体应用 | 管理配置、样式、歌词服务和备份恢复 | docs/zh-cn/app/index.md |
| LSPosed 模块 | 将歌词视图注入 System UI | xposed/ |
| 歌词提供服务 | 从播放器提供歌词、状态和翻译数据 | lyric/bridge/provider/ |
安装前准备：环境要求
先确认设备满足以下条件，再开始安装：
| 项目 | 要求 |
|---|---|
| Android 版本 | Android 10（API 29）及以上 |
| Root | 需要 Root 环境 |
| LSPosed 框架 | LSPosed 2.0 及更高版本（建议最新正式版） |
| 模块作用域 | 必须包含 系统界面（System UI） |
三步完成安装激活
- 安装主体应用：从项目 Releases 下载最新 APK 并安装，打开确认可进入首页。
- 启用 LSPosed 模块：打开 LSPosed 管理器，启用 词幕 模块，进入作用域设置勾选 系统界面（System UI）。
- 重启 System UI：保存后重启 System UI 或重启设备（词幕首页也提供"重启系统界面"入口，需要 Root 授权）。
- 安装歌词提供服务：根据你使用的播放器安装对应插件（如 LyricProvider），然后重新打开播放器播放一首有歌词的歌。
安装与激活的完整步骤可参考 docs/zh-cn/app/installation.md。
首次使用检查清单
歌词能正常显示后，再去做视觉微调。按顺序逐项确认：
- [ ] 词幕 APK 已安装
- [ ] LSPosed 中已启用词幕模块
- [ ] 模块作用域已勾选 系统界面（System UI）
- [ ] System UI 已重启或设备已重启
- [ ] 首页模块状态显示为 已激活
- [ ] 已安装当前播放器对应的歌词提供服务
- [ ] 播放器正在播放一首有歌词的歌
💡 首页顶部状态卡片是你的"诊断面板"：出现"待重启系统界面"说明需要重新注入；出现"系统界面异常，已禁用"说明触发了保护机制，需要回退最近修改的配置。
歌词来自哪里？认识歌词提供服务
词幕主体应用不保证所有播放器都能直接提供歌词，它依赖 歌词提供服务（LyricProvider）把播放器和词幕连接起来。进入词幕首页的 歌词提供服务 页面，可以按类别查看已安装的服务、作者、版本和能力标签（如 逐字歌词、翻译）。
- 想适配的播放器没有插件？优先检查插件是否支持当前播放器版本，而不是去调整样式。
- 插件安装后无歌词？确认插件 APK 已安装成功、词幕拥有读取应用列表权限，并重新打开播放器。
详细规则见 docs/zh-cn/app/providers.md。
状态栏歌词样式怎么调？常用设置速览
词幕把显示相关的设置分成两大类，新手建议按"先位置、后样式"的顺序调整：
| 页面 | 管什么 | 典型调整项 |
|---|---|---|
| 基本设置 | 歌词容器在状态栏中的位置与尺寸 | 锚点、插入顺序、宽度、边距、内边距 |
| 应用样式 | 歌词的文字、图标和动画 | 字号、颜色、字体、跑马灯、图标来源、切换动画 |
几个实用建议：
- 位置不对：先换锚点和插入顺序，再调宽度，最后用边距/内边距做像素级微调。
- 覆盖系统图标：优先减小宽度或更换锚点。
- 长歌词较多：开启跑马灯滚动比单纯加宽更稳定。
- 单播放器特殊需求：为它单独创建应用样式（单独样式 > 默认样式）。
完整说明见 docs/zh-cn/app/basic-settings.md 和 docs/zh-cn/app/app-style.md。
AI 翻译：让外语歌词自动变中文
除了插件直接提供的翻译，词幕还支持接入 OpenAI 兼容接口 生成翻译，并自动缓存结果，避免重复消耗额度。配置项包括目标语言、API 密钥、模型、基础地址和自定义提示词。
⚠️ 使用 AI 翻译时，歌词文本会发送到你配置的服务，请注意费用与隐私政策。修改提示词后想重新翻译，可使用"清空数据库"清除本地缓存。详见 docs/zh-cn/app/translation.md。
常见问题快速排查
| 现象 | 优先检查 |
|---|---|
| 歌词完全不显示 | LSPosed 模块是否启用 → 作用域是否含 System UI → 是否重启 → 是否安装歌词服务 |
| 模块未激活 | LSPosed 配置、作用域、System UI 是否重启 |
| 提示"待重启系统界面" | 点击首页重启入口或手动重启设备（需 Root 授权） |
| 歌词覆盖系统图标 | 减小宽度、更换锚点、调整插入顺序 |
| 没有逐字歌词 | 查看歌词服务是否有"逐字歌词"标签（依赖歌词来源） |
| 更新后显示异常 | 重启 System UI、检查作用域、重新调整锚点宽度 |
更多排查思路见 docs/zh-cn/app/troubleshooting.md。
换机或刷机前，记得备份配置
词幕支持一键导出/恢复配置（默认文件名 lyricon_backup.bin），包含基本设置、默认与单应用样式、文字/图标/动画、翻译配置等偏好（密钥等敏感信息不会被备份）。建议在新设备恢复后，重新检查锚点、宽度和视图规则是否仍适合当前 ROM。详见 docs/zh-cn/app/backup-restore.md。
写在最后
词幕Lyricon 的核心价值在于：用插件化解锁任意播放器的歌词，用 LSPosed 把歌词搬进系统状态栏，再用丰富的样式选项让它融入你的桌面。建议按"先跑通显示 → 再调位置 → 最后玩样式"的节奏上手，遇到问题优先看首页状态卡片。官方使用文档入口见 docs/zh-cn/app/index.md，祝你早日享受"抬眼即歌词"的体验 🎧