TIP
文档建设中，欢迎提交 Pull Request 来完善它！文档 GitHub 地址
用户指南
Folia 是一款以歌词为中心的播放器。它把在线音乐、本地音乐、Navidrome 曲库、舞台模式和 AI 主题整合到同一套播放体验里。
TIP
先前往 基本用法 查看最基本的操作说明
TIP
如果你遇到问题，可以先查看 常见问题
这份文档适合谁
- 普通用户：想快速上手播放、导入本地音乐、切换视觉模式。
- 桌面端用户：想使用遥控窗、视频录制、Stage Mode、Now Playing 接入。
- 进阶用户：想把 Navidrome、自建 API 或外部工具接入 Folia。
你可以在 Folia 里做什么
| 能力 | 说明 |
|---|---|
| 在线播放 | 在网易云、酷狗、QQ 音乐之间切换音源，搜索并直接播放、查看歌词和封面。 |
| 本地音乐库 | 导入文件夹，自动读取音频标签、封面、内嵌歌词和同目录歌词文件。 |
| Navidrome 接入 | 连接私有音乐库，浏览专辑、歌手、播放列表和随机歌曲。 |
| 多种歌词视觉模式 | 内置 流光、心象、云阶、浮名、莫奈、群唱、倾诉、回环、镜台、时计、商籁 共 11 种模式。 |
| AI 主题 | 根据歌词或纯音乐标题生成明暗双主题配色。 |
| 舞台模式 | 接收外部歌词或媒体输入，驱动 Folia 的沉浸式播放页。 |
| 桌面增强 | 提供独立遥控窗、视频录制、系统更新和平台级窗口控制。 |
| 音频效果器 | 十段均衡器加饱和、混响、压缩等后处理效果链，带多个预设。 |
| 本机集成接口 | 桌面端可开放只读的歌词接口和带鉴权的 Stage API，供外部程序对接。 |
| 多端同步 | 通过自建的同步服务同步视觉设置与 AI 主题。 |
推荐阅读顺序
如果你准备自己部署或二次接入，请继续看 开发者文档。