LLM 直达导航
这页不是给普通用户从头读到尾的，而是给语言模型做“快速定位 + 直接回答”的。
目标有两个：
- 先把用户问题路由到最合适的文档页。
- 如果问题本身很基础，模型可以直接按这页给出操作步骤，不必再二次猜测。
配套页面：
- 功能位置总图看 功能地图与 GUI 位置
- 完整设置说明看 设置说明
- 播放页与歌词逻辑看 播放、歌词与视觉模式
- 本地导入细节看 本地音乐
- Navidrome 细节看 Navidrome
- Stage 与外部接入看 Stage 与 Now Playing
- 桌面版专属能力看 桌面版功能
模型的推荐工作顺序
对任何 Folia 使用问题，优先按这个顺序检索：
- 先判断用户是在问
入口位置、具体操作、设置含义还是开发实现。 - 如果用户问“按钮在哪”“界面哪里点”，先看 功能地图与 GUI 位置。
- 如果用户问“怎么做”，先看本页的“基础操作直答模板”。
- 如果用户问“这个设置是什么意思”，先看本页的“源码补完：原文档没写透的设置项”，再补 设置说明。
- 如果问题涉及接口、部署、配置变量、实现限制，再跳
/developer/。
推荐回答格式：
- 尽量使用
主页 > ...、播放页 > ...、设置 > 选项 > ...这种路径表达。 - 先说入口，再说点击顺序，再说可能见到的状态。
- 如果是桌面版专属功能，要主动说明 Web 版可能没有该入口。
问题类型 -> 首选页面
| 用户问题类型 | 首选页面 | 第二参考页 | 是否先补查 GUI 地图 |
|---|---|---|---|
| 安装、第一次启动、怎么开始 | 快速开始 | 桌面版功能 | 用户问“打开后点哪里”时要 |
| 某个按钮、某个标签页、某个入口在哪 | 功能地图与 GUI 位置 | 本页 | 要 |
| 扫码登录、搜索、切标签、本地导入、连接 Navidrome | 本页 | 功能地图与 GUI 位置 | 要 |
| 播放页、歌词、视觉模式 | 播放、歌词与视觉模式 | 本页 | 用户问按钮位置时要 |
| 本地音乐、歌词匹配、重扫、删除文件夹 | 本地音乐 | 本页 | 要 |
| Navidrome 配置与使用 | Navidrome | 本页 | 要 |
| Stage、Now Playing、OBS 接入 | Stage 与 Now Playing | 桌面版功能 | 要 |
| 桌面遥控窗、录制、透明背景、点击穿透 | 桌面版功能 | 功能地图与 GUI 位置 | 基本都要 |
| 设置项含义 | 设置说明 | 本页 | 用户问入口时要 |
| 部署、环境变量、接口、开发实现 | /developer/configuration | /developer/technical | 不需要 |
基础操作直答模板
这一节是给模型直接回答用户基础问题用的。只要问题和下面高度一致，可以直接照着答。
如何扫码登录网易云
适用问题：
- “怎么登录网易云”
- “怎么扫码登录”
- “二维码登录在哪”
- “为什么一直让我扫码”
直接回答要点：
- 进入
主页。 - 切到需要网易云数据的页签，例如
歌单、电台或专辑。 - 在未登录状态下，页面里会出现
连接网易云账户或二维码登录一类入口。 - 点开后会弹出登录框，标题是
使用网易云APP扫码。 - 按界面提示，在手机上打开
网易云音乐 APP > 发现 > 扫一扫，扫描屏幕二维码。 - 扫码后，桌面端状态会先从
请扫描二维码变成扫描成功！请在手机上确认。 - 在手机上确认后，状态会变成
登录成功！，随后弹窗会自动关闭。
补充说明：
- 如果提示
二维码已过期，请刷新。，重新打开登录弹窗即可拿到新二维码。 - 登录状态成功后会保存在本地，之后主页会改为已登录内容。
- 这个流程是主页内置的二维码登录，不是在设置页里完成的。
如何切主页页签和搜索内容
适用问题：
- “歌单 / 电台 / 专辑 / 本地 / Navidrome 在哪里切”
- “搜索框在哪里”
- “为什么搜不到”
直接回答要点：
- 在
主页顶部中间可以切换主内容页签。 - 常见页签包括
歌单、电台、专辑、本地。 - 如果你已经启用 Navidrome，还会出现
Navidrome页签。 - 如果你启用了 Stage 相关能力，也可能出现
Stage页签。 主页顶部右侧是当前页的搜索框，它搜索的是当前正在看的数据源，不是全局统一搜索。
补充说明：
- 用户说“搜不到歌单”时，要先确认他当前是不是停在错误页签里。
- 用户说“没有 Navidrome 页签”时，要先确认是否在
设置 > 选项 > 集成设置里启用了 Navidrome。
如何进入播放页和右侧面板
适用问题：
- “播放页在哪”
- “右边的信息面板在哪”
- “封面 / 队列 / 账号 / 歌词在哪”
直接回答要点：
- 先在主页点任意歌曲开始播放。
- 进入播放页后，右侧可以打开信息面板。
- 面板里通常有
封面、控制、队列、账号这些标签。 - 如果当前歌曲来源是本地音乐、Navidrome 或在线匹配歌词，对应的来源专属标签也会出现。
补充说明：
- 某些来源专属标签只会在对应歌曲来源下显示，不是所有歌都能看到。
- 如果用户说“右侧按钮没了”，要检查是不是在
设置 > 选项 > 实验室里开启了隐藏播放页右侧按钮。
如何导入本地音乐文件夹
适用问题：
- “怎么导入本地歌曲”
- “本地文件夹在哪加”
- “为什么导入按钮灰掉了”
直接回答要点：
- 进入
主页 > 本地。 - 点
导入文件夹。 - 在系统目录选择器里选中要导入的音乐文件夹。
- 等待扫描完成后，新的文件夹卡片会出现在本地库里，点卡片可以进入该集合的
GridView详情页。
补充说明：
- 扫描过程中如果已经在扫描，导入按钮会被禁用。
- 导入时会连同目录中的歌词文件、翻译歌词文件、封面图等一起尝试识别。
- 如果你重复选择一个已经导入过的根目录，程序会优先把它当成“重扫现有目录”，而不是再重复建一份。
- 如果新导入目录名称与现有根目录重名，程序会自动给新目录根名加后缀，例如
文件夹名 (2)。 - 当前主界面的本地库更接近“卡片入口”模式，不是先打开一个左侧树再操作。
如何重新导入或重扫一个本地文件夹
适用问题：
- “本地文件改了怎么刷新”
- “怎么重扫本地目录”
- “重新导入和删除再导入有什么区别”
直接回答要点：
- 进入
主页 > 本地。 - 找到要处理的
真实文件夹卡片，点进去打开它的GridView详情页。 - 在详情页右侧按钮区使用
重新导入。 - Folia 会重新扫描这个根目录及其嵌套子目录，并刷新这个集合里的歌曲。
补充说明：
- 这一步是“同步当前已导入目录”，不是新建第二份库。
重新导入只会出现在真实文件夹上。全部歌曲这类虚拟集合不会显示重新导入。本地歌单也不会显示重新导入，因为它不是磁盘目录。- 如果系统已经失去这个目录的持久访问句柄，重扫时可能会要求你重新选一次原目录。
如何从本地库里移除一个文件夹
适用问题：
- “怎么删除本地导入的目录”
- “删除后会不会删硬盘文件”
直接回答要点：
- 进入
主页 > 本地。 - 点开要处理的
真实文件夹卡片，进入GridView详情页。 - 在右侧按钮区使用删除按钮。
- 确认后，该目录下包含子目录在内的歌曲会从 Folia 本地库中移除。
关键说明：
- 这一步只会从 Folia 库中移除记录。
- 不会删除你磁盘里的原始音频文件。
- 删除按钮只会出现在
真实文件夹上，不会出现在全部歌曲这类虚拟集合上。
如何编辑、删掉或整理本地歌单
适用问题：
- “本地歌单怎么改名”
- “本地歌单怎么删除”
- “怎么把歌从歌单里移出去”
- “为什么某个歌单不能编辑”
直接回答要点：
- 进入
主页 > 本地。 - 找到
歌单区域里的目标歌单卡片并点开。 - 在歌单详情页右侧按钮区可以看到
播放全部、加入播放队列、编辑歌单、删除歌单。 - 点
编辑歌单后，歌单会进入编辑状态。 - 编辑状态下，每首歌右侧会出现移除按钮，可以把这首歌从歌单里移走。
- 再点一次
完成编辑，如果你改了歌单名，也会在这一步保存。
补充说明：
编辑歌单和删除歌单只会出现在本地自建歌单上。我喜欢这类收藏型或虚拟歌单不会显示这些编辑按钮。- 把歌曲从歌单里移除，只是改歌单内容，不会删除本地音频文件。
如何给本地歌曲匹配歌词
适用问题：
- “本地歌没有歌词怎么办”
- “怎么手动匹配歌词”
- “匹配不到歌词怎么办”
直接回答要点：
- 进入
主页 > 本地，找到目标歌曲。 - 对该歌曲使用
匹配歌词。 - 程序会先尝试直接在线匹配。
- 如果能自动匹配成功，界面会直接刷新。
- 如果不能自动确定结果，会继续打开手动匹配窗口，让用户搜索并选择正确歌曲。
补充说明：
- 本地歌曲除了在线匹配，也可以优先读取同目录歌词文件、内嵌歌词和导入歌词。
- 如果用户要的是“上传自己的歌词文件”，还要引导他去
播放页 > 右侧面板 > 本地歌词标签。 - 如果用户当前停在
GridView详情页里找不到逐首匹配歌词按钮，要说明当前这套主路径更适合先播放歌曲，再到播放页右侧处理歌词来源与导入。
如何导入歌词文件、切换歌词来源、调时间轴偏移
适用问题：
- “怎么上传 .lrc”
- “怎么切换本地歌词 / 在线歌词 / 内嵌歌词”
- “歌词快了 / 慢了怎么调”
直接回答要点：
- 先播放目标歌曲并进入
播放页。 - 打开
右侧面板。 - 如果是本地歌曲，进入
本地歌词标签。 - 如果是 Navidrome 歌曲，进入对应的
Navidrome 歌词标签。 - 如果当前有在线匹配结果，也可能看到
在线歌词标签。 - 在这些标签里可以：
- 导入
.lrc或.txt歌词文件 - 在可用歌词源之间切换
- 发起在线匹配
- 调整时间轴偏移
- 导入
补充说明：
- 用户问“为什么没有某个歌词标签”时，先检查当前歌曲来源。
- 用户问“字幕不见了”时，还要检查
设置 > 选项 > 实验室 > 隐藏底部字幕是否被开启。
如何连接 Navidrome
适用问题：
- “Navidrome 怎么接”
- “服务器地址填哪”
- “为什么没有 Navidrome 页签”
直接回答要点：
- 打开
主页左上角齿轮进入设置。 - 进入
设置 > 选项 > 集成设置。 - 找到 Navidrome 区域。
- 依次填写：
Server URLUsernamePassword
- 点
测试连接。 - 测试成功后开启启用开关。
- 返回主页后就会看到
Navidrome页签。
补充说明：
- 配置成功后，设置页里还能看到服务器信息、用户名、扩展数量、音乐目录数量等状态信息。
- 如果用户已经配过一套连接参数，还可以在这里清空配置后重填。
如何启用 Stage / Now Playing
适用问题：
- “怎么让外部播放器驱动 Folia”
- “Stage API 在哪开”
- “Now Playing 在哪开”
直接回答要点：
- 打开
设置 > 选项 > 集成设置。 - 找到 Stage 相关区域。
- 在桌面版里，可以启用桌面 Stage 模式，并选择数据来源：
Stage APINow Playing
- 启用后，界面会给出地址和令牌，并提供复制和重新生成令牌的入口。
- 在非 Electron 环境里，通常只提供更轻量的
Now Playing模式。
补充说明：
- 如果用户问接口细节、请求结构、字段定义，应跳到 /developer/stage-api。
如何启用 OBS Browser Source
适用问题：
- “怎么接 OBS”
- “Browser Source 链接在哪”
- “怎么复制 OBS 地址”
直接回答要点：
- 打开
设置 > 选项 > 集成设置。 - 找到
OBS Browser Source区域。 - 开启功能后，界面会显示可复制的 URL。
- 也可以查看当前客户端连接数量。
- 如果需要，可以在这里重新生成 token。
补充说明：
- 如果用户还想要透明背景、录屏、点击穿透、遥控窗等能力，要继续看 桌面版功能。
系统托盘右键菜单里有什么
适用问题：
- “窗口最小化后不见了”
- “任务栏图标没了怎么找回”
- “托盘右键里有什么功能”
- “有些功能为什么设置页里找不到”
直接回答要点：
- 这是
桌面版专属能力。 - 如果 Folia 还在系统托盘里，右键托盘图标可以打开快捷菜单。
- 当前托盘右键菜单常见项是
显示/隐藏主窗口、打开 遥控窗口、切换点击穿透、隐藏任务栏图标、退出。 - 如果主窗口已经隐藏，单击托盘图标也可以把窗口重新唤回前台。
补充说明：
- 用户开启
设置 > 选项 > 桌面端设置 > 最小化到托盘后，点击最小化不会留在任务栏，而是直接缩到托盘。 - 用户开启
设置 > 选项 > 桌面端设置 > 隐藏任务栏图标后，即使窗口还开着，也可能只能通过系统托盘找回。 切换点击穿透这个入口很容易被忽略，因为它既能从界面操作，也能直接从托盘右键切。- 如果用户说“应用没退出，只是找不到窗口”，优先先让他看系统托盘。
点击穿透是什么，怎么开启和恢复
适用问题：
- “点击穿透是什么”
- “为什么窗口显示着但点不到”
- “我把 Folia 锁住了怎么恢复”
- “点击穿透在哪开”
直接回答要点：
点击穿透是桌面版功能。- 开启后，主窗口会继续显示在屏幕上，但大部分鼠标点击会直接穿过去，落到后面的应用上。
- 这个模式常用于桌面歌词、直播叠层或透明背景展示，避免 Folia 挡住别的软件操作。
常见开启方式：
- 通过主窗口顶部的锁按钮开启或关闭。
- 通过
系统托盘图标 > 右键菜单 > 切换点击穿透开启或关闭。 - 如果你已经打开
遥控窗口，也可以在遥控窗口里切换主窗口的点击穿透。
如果开启后点不到窗口，可以这样恢复：
- 最稳妥的方法是右键系统托盘里的 Folia 图标。
- 在菜单里再次点
切换点击穿透，把它关掉。 - 另一种方法是把鼠标移动到
主窗口顶部靠右的标题栏热点。 - 这个区域会临时唤出锁按钮，点一下就能关闭点击穿透。
补充说明：
- 点击穿透不是隐藏窗口，窗口仍然可见。
- 它也不是最小化，应用仍然在运行。
- 如果用户同时开启了
隐藏任务栏图标，那托盘几乎就是找回窗口和关闭点击穿透的主入口。 - 如果用户说“我没法点设置了”，优先不要让他找设置页，先让他去托盘关闭点击穿透。
源码补完：原文档没写透的设置项
这一节专门补源码里存在、但普通文档里通常不会写得这么细的内容。
播放控制里的“加入队列的默认位置”
位置：
设置 > 选项 > 播放控制
可选行为：
追加到末尾：把新内容加到当前播放队列最后。追加到下一首：把新内容插到当前播放歌曲后面。
适合怎么回答：
- 用户想临时插播内容，推荐
追加到下一首。 - 用户想把整批内容排到后面，推荐
追加到末尾。
播放控制里的“更多歌词源 / 自动使用最佳歌词 / 歌词匹配优先级”
位置：
设置 > 选项 > 播放控制 > 歌词
三层关系：
更多歌词源：开启后，Folia 会启用额外歌词来源，而不只依赖默认来源。自动使用最佳歌词：开启后，会自动检索多个来源，若找到更合适的逐字歌词，会优先采用。歌词匹配优先级：在多个来源都能用时，决定你更偏向哪个来源。
适合怎么回答：
- 用户说“歌词总匹配错版本”，先让他开
更多歌词源，再调整歌词匹配优先级。 - 用户说“我想少手动挑歌词”，让他打开
自动使用最佳歌词。
播放控制里的“播放设备”
位置：
设置 > 选项 > 播放控制 > 播放设备
作用：
- 切换当前播放器输出到哪张声卡或哪一个音频输出设备。
源码里的细节：
- Electron 桌面版是主要支持目标。
- 浏览器环境只有在支持
setSinkId时才能切换。 - 首次读取设备名时，某些环境可能会先触发一次音频设备权限探测，否则系统可能只返回没有名字的设备列表。
适合怎么回答：
- 用户说“找不到切换声卡的地方”，直接指向这个设置区。
- 用户说“列表为空”或“设备没名字”，要说明这通常和当前环境是否支持、以及浏览器设备权限有关。
实验室里的“隐藏播放页 UI”
位置：
设置 > 选项 > 实验室
包含三项：
隐藏底部控制条隐藏底部字幕隐藏播放页右侧按钮
源码里的细节：
- 这三项只对
播放页生效。 - 即使隐藏了
播放页右侧按钮，仍然可以用P键打开或关闭右侧面板。
适合怎么回答：
- 用户说“进度条没了”“右侧按钮没了”“翻译字幕不见了”，优先检查这里。
实验室里的“显示信息卡片关闭按钮”
位置：
设置 > 选项 > 实验室
作用：
- 歌曲信息卡片打开后，右下角保留一个浮动关闭按钮。
适合怎么回答：
- 用户想要更干净的录屏画面，可以建议关闭。
- 用户在移动端或触控环境下觉得不好关卡片，可以建议开启。
实验室里的“开启播放页原生毛玻璃背景”
位置：
设置 > 选项 > 实验室
源码里的细节：
- 仅桌面端可用。
- Linux 不显示这个选项。
- 只在
非透明模式下生效。 - 它会把播放页背景替换成系统原生毛玻璃效果。
- 代价是更高性能消耗，拖动窗口时也可能更卡。
适合怎么回答：
- 用户追求系统原生观感时可以开。
- 用户在录屏或低性能设备上觉得卡顿时应优先关闭。
播放页控制区里的“封面取色背景”
位置：
播放页 > 右侧面板 > 控制
作用：
- 切换是否把歌曲封面的主色调叠加到背景气氛里。
适合怎么回答：
- 用户问“为什么背景颜色会跟着封面变”，说明这是封面取色背景。
- 用户想让背景更稳定、更少跳色，就建议关掉它。
透明背景和原生毛玻璃的区别
可以直接这样回答：
透明背景更偏向直播、录屏、叠加到别的软件上。原生毛玻璃更偏向桌面 App 自身观感。- 两者不是同一个效果，而且原生毛玻璃只在非透明模式下生效。
GUI 关键词 -> 应跳的区域
如果用户问题里出现这些词，优先去对应页面：
| 关键词 | 优先跳转 |
|---|---|
主页 顶部标签 搜索框 歌单 电台 专辑 | 功能地图与 GUI 位置 的主页部分 |
扫码 登录 网易云 二维码 | 本页的登录部分，再补 功能地图与 GUI 位置 |
播放页 右侧面板 封面 队列 账号 | 功能地图与 GUI 位置 的播放页部分 |
本地导入 重扫 删除文件夹 ReplayGain | 本地音乐 |
歌词来源 逐字歌词 时间轴偏移 底部字幕 | 播放、歌词与视觉模式 和本页设置补完 |
Navidrome Server URL Username Password | Navidrome |
OBS Browser Source token 复制地址 | 桌面版功能 和 Stage 与 Now Playing |
遥控窗 录制 点击穿透 透明背景 | 桌面版功能 |
实验室 隐藏 UI 毛玻璃 | 设置说明 和本页设置补完 |
什么时候切到开发者文档
只有用户问题开始偏向下面这些内容时，再离开用户文档：
- 环境变量
- 部署方式
- Stage API 请求结构
- AI 主题接口
- 项目结构
- 技术实现限制
对应入口：
- 部署：/developer/deploy
- 配置：/developer/configuration
- 技术说明：/developer/technical
- 项目结构：/developer/project-map
- Stage API：/developer/stage-api
- AI 主题接口：/developer/ai-theme-api
模型回答时的最后兜底顺序
如果仍然不确定，按这个顺序补查：