功能地图与 GUI 位置
这页专门给两类场景准备：
- 你想快速知道某个功能在界面的哪里。
- 你想让 AI 读取文档后，能准确定位 Folia 当前实现里的入口、开关和面板。
本文以主仓库 folia-major 当前 GUI 实现为准，优先描述“用户在屏幕上实际能看到和点到的东西”。
怎么看这页
主页 > 左上角 > 设置按钮表示从主页左上区域进入。播放页 > 右侧面板 > 控制表示先打开播放页右侧面板，再切到控制标签。设置 > 帮助与设置 > 选项指的是设置弹窗顶部的两个一级标签。桌面版专属表示 Web 版通常不会出现，或意义明显弱很多。
全局 GUI 总览
| 区域 | 你会看到什么 | 主要作用 |
|---|---|---|
| 主页顶部左侧 | Folia 标题、设置/帮助按钮、扫描进度环 | 打开帮助与设置、查看本地曲库扫描状态 |
| 主页顶部中间 | 标签切换条 | 在 歌单 / 电台 / 专辑 / 本地 / Navidrome / 舞台 之间切换 |
| 主页顶部右侧 | 搜索框 | 按当前标签搜索网易云、本地曲库或 Navidrome |
| 主内容区 | 海报墙、专辑墙、本地列表、Navidrome 视图 | 浏览和进入具体内容 |
| 播放页中央 | 歌词动画、封面、歌曲信息 | Folia 的核心沉浸式播放体验 |
| Lattice 队列拼贴 | 整条播放队列铺成的海报墙 | 与播放页并列的第二个播放视图，Ctrl/Cmd + B 开关 |
| 播放页底部 | 播放控制栏 | 播放、暂停、进度、音量 |
| 播放页右侧 | 右侧面板 | 主题、歌词、队列、账号、本地/服务器专属信息 |
| 设置弹窗 | 帮助 / 选项 双页 | 帮助、快捷键、设置中心、实验功能 |
| 命令面板 | 任意界面按 Ctrl/Cmd + K；空闲区域也可按 S | 用命令直达页面、面板、设置和动作。在 Lattice 里它是主要操作方式 |
| 遥控窗 | Folia Remote 小窗，桌面版专属 | 不切回主窗口也能控制播放、录制和透明模式 |
主页
顶部栏
| GUI 位置 | 功能 | 说明 |
|---|---|---|
| 主页 > 左上角 > 设置图标 | 打开设置弹窗 | 默认先进入 帮助 页；有更新时按钮会带红点 |
| 主页 > 左上角 > 扫描进度环 | 查看本地扫描进度 | 仅在导入本地文件夹、后台提取元数据和封面时出现 |
| 主页 > 顶部中间 > 标签条 | 切换主页内容 | 固定包含 歌单 / 电台 / 专辑 / 本地；启用 Navidrome 后会出现 Navidrome；启用舞台入口后会出现 舞台 |
| 主页 > 右上角 > 搜索框 | 搜索当前来源 | 会随当前标签自动切换搜索对象 |
各主页标签
| GUI 位置 | 功能 | 说明 |
|---|---|---|
主页 > 歌单 | 浏览网易云歌单 | 未登录时会显示登录引导 |
主页 > 电台 | 进入私人 FM 与推荐歌单 | 属于网易云入口的一部分 |
主页 > 专辑 | 浏览喜欢的专辑 | 首次进入时会加载收藏专辑 |
主页 > 本地 | 进入本地音乐视图 | 管理文件夹、专辑、艺人、本地歌单 |
主页 > Navidrome | 进入 Navidrome 视图 | 需要先在 设置 > 选项 > 连接与集成 启用并配置；走 Subsonic / OpenSubsonic API |
主页 > 舞台 | 打开 Stage / Now Playing 播放页 | 只在相关能力启用后出现 |
主页里能做的事
| GUI 位置 | 功能 | 说明 |
|---|---|---|
| 海报墙或列表聚焦时直接键入 | 即时搜索 | 用户指引里也专门说明了这个行为 |
| 主页 > 左上角帮助按钮 | 打开帮助、快捷键、用户指引 | 也是 Need help? 按钮所在入口 |
| 主页 > 本地扫描进度卡片 | 看当前文件夹扫描状态 | 显示文件夹名、完成数和进度条 |
播放页
主界面
| GUI 位置 | 功能 | 说明 |
|---|---|---|
| 播放页中央 | 歌词动画显示 | 所有 visualizer 都在这里渲染 |
| 播放页中央/上方 | 当前歌曲标题、艺人、专辑 | 是用户识别当前歌曲的主信息区 |
| 播放页底部 | 播放控制栏 | 播放/暂停、上一首、下一首、进度、音量 |
| 播放页右缘 | 右侧面板开关 | 打开后可切换多个标签页 |
播放页快捷动作
| GUI 位置或方式 | 功能 | 说明 |
|---|---|---|
Space | 播放 / 暂停 | 帮助页和用户指引都有写 |
Ctrl + ←/→ 或 macOS Cmd + ←/→ | 上一首 / 下一首 | 桌面端歌曲切换快捷键 |
←/→ | 快退 / 快进 5 秒 | 直接作用在当前播放 |
P | 打开 / 关闭右侧面板 | 即使隐藏了右侧按钮，也还能这样打开 |
H | 隐藏播放页控件 | 用户指引中列为播放器快捷键 |
F11 | 浏览器全屏 | Web 和桌面版都可作为显示层使用 |
Ctrl/Cmd + K | 打开命令面板 | 全局入口，在任意界面可用 |
Ctrl/Cmd + P | 打开队列界面 | 私人 FM 期间停用 |
Ctrl/Cmd + B | 打开 / 退出 Lattice 队列拼贴 | 全局，私人 FM 期间停用 |
: | 执行模式 | 再按一个字母立即执行命令 |
S | 打开命令面板 | 焦点不在输入框时可用；首页网格默认优先把字符交给筛选 |
播放页右侧面板
固定标签
| GUI 位置 | 功能 | 说明 |
|---|---|---|
播放页 > 右侧面板 > 封面 | 歌曲信息页 | 点击歌手或专辑可跳转详情；点击标题可复制歌曲信息；如果是已匹配的网易云歌曲，Ctrl+点击标题 还能打开对应网易云歌曲页 |
播放页 > 右侧面板 > 控制 | 主题、循环、音量、动画模式 | 是播放页内最常用的视觉控制区 |
播放页 > 右侧面板 > 队列 | 当前播放队列 | 支持点击任意歌曲跳转播放、打乱队列、把当前队列保存为本地歌单 |
播放页 > 右侧面板 > 账号 | 网易云账号与同步 | 显示头像、昵称、会员状态、音质切换、同步数据、退出登录 |
按歌曲来源追加的标签
| GUI 位置 | 何时出现 | 功能 |
|---|---|---|
播放页 > 右侧面板 > 本地 | 当前歌曲来自本地音乐 | 查看文件名、大小、比特率、歌词来源、ReplayGain；上传歌词文件；在线匹配歌词；切换 本地 / 内嵌 / 在线 歌词来源；调节歌词时间偏移 |
播放页 > 右侧面板 > Navidrome | 当前歌曲来自 Navidrome | 查看服务器歌曲 ID；在线匹配歌词；查看当前使用的是 服务器歌词 还是在线匹配结果；调节歌词时间偏移 |
播放页 > 右侧面板 > 歌词 | 当前歌曲来自网易云在线播放 | 导入歌词文件；重新在线匹配；在 在线来源 与 导入文件 之间切换；调节歌词时间偏移 |
控制 标签里能做的事
| GUI 位置 | 功能 | 说明 |
|---|---|---|
右侧面板 > 控制 > 第一排按钮 | 循环、收藏、生成 AI 主题 | 分别对应循环模式切换、喜欢歌曲、为当前歌曲生成 AI 主题 |
右侧面板 > 控制 > 音量 | 调整当前播放器音量 | 包括静音切换 |
右侧面板 > 控制 > 音量行 > 效果器按钮 | 打开音频效果器 | 十段均衡器加后处理效果链，也可从命令面板打开 |
右侧面板 > 控制 > 动画模式 | 切换 visualizer | 可直接在这里切到 流光 / 心象 / 云阶 / 浮名 / 莫奈 / 群唱 / 倾诉 / 回环 / 镜台 / 时计 / 商籁 |
右侧面板 > 控制 > 动画强度 | 切换 calm / normal / chaotic | 是播放页内的快速强度开关，不等于完整调参 |
右侧面板 > 控制 > 背景 | 切换默认主题 / AI 主题 / 自定义主题 | 也可在这里快速切换明暗模式和封面主色参与背景 |
设置弹窗
设置弹窗顶部有两个一级标签：帮助 和 选项。
帮助页
| GUI 位置 | 功能 | 说明 |
|---|---|---|
设置 > 帮助 | 查看键盘快捷键 | 包含主页导航、播放控制等基础快捷键 |
设置 > 帮助 > Show User Guide | 打开用户指引 | 是一个多页引导，包含即时搜索、播放器快捷键、命令面板、主题说明 |
设置 > 帮助 > Need help? | 打开 AI 求助提示词弹窗 | 会生成一段附带文档站和 GitHub 仓库链接的提示词，方便复制到外部 AI 工具中求助 |
设置 > 帮助 > 底部版本行 | 复制版本信息 | 便于反馈问题时带上版本、分支和提交哈希 |
选项页总览
| GUI 位置 | 功能 | 说明 |
|---|---|---|
设置 > 选项 > 视觉设置 | 主题、歌词动画、首页布局、网格卡片、队列拼贴 | 影响 Folia 的主要观感 |
设置 > 选项 > 界面设置 | 语言、顶部胶囊入口、播放后进入的视图、底部界面、快捷命令 | 控制显示语言、首页入口和播放落点 |
设置 > 选项 > 播放控制 | 队列、听歌打卡、智能过渡、音频增益、歌词与歌词过滤、播放设备 | 影响播放行为而不是视觉样式 |
设置 > 选项 > 交互控制 | 海报墙手势与 S 键、自定义快捷键 | 设置一个 Alt + 字母 全局快捷键 |
设置 > 选项 > 连接与集成 | Discord、OBS、歌词接口、Stage、Now Playing、Navidrome | 所有对外连接入口都在这里 |
设置 > 选项 > 存储与同步 | 缓存分类、媒体缓存、本地文件夹监视、同步服务 | 适合清理空间和配置多端同步 |
设置 > 选项 > 桌面端设置 | 托盘、壁纸模式、更新、AI 提供商 | 仅桌面版出现 |
设置 > 选项 > 实验室 | 性能、隐藏 UI、模组系统 | 放置高影响、偏实验性质的开关 |
设置 > 选项 > 开发者 | 调试相关 | 一般用户用不到 |
设置页左侧导航默认展开，并把每个页面下的小节一并列出。命令面板里有一批命令可以直接跳到具体小节。
视觉设置
| GUI 位置 | 功能 | 说明 |
|---|---|---|
设置 > 选项 > 视觉设置 > 主题与配色 | 默认主题、AI 主题、自定义主题 | 也可进入 Theme Park 做完整主题编辑 |
设置 > 选项 > 视觉设置 > 打开 Theme Park | 进入主题编辑器 | 编辑明暗双主题颜色 |
设置 > 选项 > 视觉设置 > 自动应用歌曲已缓存的 AI 主题 | 切歌时自动恢复缓存主题 | 和“优先使用自定义主题”是不同策略 |
设置 > 选项 > 视觉设置 > 自动调用 AI 并应用主题 | 歌曲没有缓存主题时自动生成 | 会消耗实际模型 token |
设置 > 选项 > 视觉设置 > 播放页透明背景 | 透明播放页窗口 | 适合抠像、叠加和透明桌面玩法 |
设置 > 选项 > 视觉设置 > 自动隐藏控制栏 | 自动隐藏进度条和右侧按钮 | 适合更纯净的展示画面 |
设置 > 选项 > 视觉设置 > 歌词动画实验台 | 打开可视化实验台 | 对各 visualizer 做完整调参 |
设置 > 选项 > 视觉设置 > 首页布局样式 | 经典(旧版) / 万象(新版) | 万象 才会继续出现歌单卡片样式 |
设置 > 选项 > 视觉设置 > 歌单卡片样式 | 纯图片封面 / 拍立得卡片 | 只在新版首页布局生效 |
设置 > 选项 > 视觉设置 > 网格卡片 | 全画幅封面、正方形卡片、卡片最小尺寸与最小透明度 | 命令面板搜索网格卡片外观可直接开滑块面板 |
设置 > 选项 > 视觉设置 > 队列拼贴设置 | 边缘暗角、海报聚焦叠色（颜色与强度） | Lattice 的外观开关 |
设置 > 选项 > 视觉设置 > 歌曲信息卡片 | 限时 / 常驻 / 不显示、显示时长、是否在首页显示 | 播放器与队列左下角的“正在播放”卡片 |
设置 > 选项 > 视觉设置 > 备份与导入 | 导入 / 导出主题与动画配置 | 支持标准 JSON 和 folia-theme:// 文本码 |
播放控制
| GUI 位置 | 功能 | 说明 |
|---|---|---|
设置 > 选项 > 播放控制 > 加入队列的默认位置 | 追加到末尾 / 追加到下一首 | 决定“加入队列”按钮的默认行为 |
设置 > 选项 > 播放控制 > ReplayGain 模式 | 按单曲或专辑做响度平衡 | 只在歌曲带增益数据时生效 |
设置 > 选项 > 播放控制 > 自动使用最佳歌词 | 自动检索网易云、AMLLDB、QQ、酷狗歌词 | 存在完美匹配的逐字歌词时自动采用 |
设置 > 选项 > 播放控制 > 本地歌曲歌词优先级 | 本地歌词 / 在线优先 | 手动指定的歌词来源不受影响 |
设置 > 选项 > 播放控制 > 歌词匹配优先级 | 在 netease / amll / qq / kugou 之间设定偏好 | 多个来源都满足匹配度时决定用谁 |
设置 > 选项 > 播放控制 > 全局时间偏移 | 为本设备所有歌曲平移歌词时间轴 | 点开后有实时预览，适合补偿蓝牙延迟 |
设置 > 选项 > 播放控制 > 歌词过滤 | 逐行正则过滤 + 开头制作人员信息处理 | v0.7.2 起从实验室移到这里 |
设置 > 选项 > 播放控制 > 听歌打卡 | 上报播放记录（仅网易云） | 需登录网易云；默认关闭 |
设置 > 选项 > 播放控制 > Folia 智能过渡 | 过渡开关、模式、最长时长、表现模式、分析模型、过渡动画 | 详见智能过渡 |
设置 > 选项 > 播放控制 > 自动转换无法播放的音频 | Chromium 解不了的格式用 FFmpeg 转码后播放 | 仅桌面端；不改原文件 |
设置 > 选项 > 播放控制 > 当前播放声卡 | 切换音频输出设备 | 桌面版优先支持；浏览器依赖 setSinkId |
存储与同步
| GUI 位置 | 功能 | 说明 |
|---|---|---|
设置 > 选项 > 存储与同步 > 缓存分类 | 查看歌单、歌词、封面、媒体缓存占用 | 每项都可单独清理 |
设置 > 选项 > 存储与同步 > 清空所有 | 一次清掉所有缓存 | 适合严重异常排查 |
设置 > 选项 > 存储与同步 > 缓存歌曲 | 启用媒体缓存 | 播放后缓存音频，方便重复播放 |
设置 > 选项 > 存储与同步 > 缓存目录 | 选择桌面版媒体缓存目录 | 仅桌面版出现 |
设置 > 选项 > 存储与同步 > 已缓存歌曲 | 查看媒体缓存规模 | 用于判断缓存是否在增长 |
设置 > 选项 > 存储与同步 > 本地文件夹监视 | 自动增量扫描已导入的本地文件夹 | 默认关闭，可逐个文件夹查看监视状态并重新检查 |
设置 > 选项 > 存储与同步 > 启用同步服务 | 配置 Sync Server 地址与 Token | 同步视觉设置与 AI 主题，支持测试、导入导出 zip |
连接与集成
| GUI 位置 | 功能 | 说明 |
|---|---|---|
设置 > 选项 > 连接与集成 > Discord 播放状态 | Discord Rich Presence | 桌面版显示当前播放状态到 Discord |
设置 > 选项 > 连接与集成 > OBS 浏览器源 | 打开或关闭 OBS Browser Source | 开启后会显示本机 URL、连接数、复制地址、重置 Token |
设置 > 选项 > 连接与集成 > 启用 Stage API | 启动本地 Stage HTTP 服务 | 可切换 Stage API 或 Now Playing 作为来源 |
设置 > 选项 > 连接与集成 > Stage 地址 | 复制本地地址 | 默认是本机 127.0.0.1 地址 |
设置 > 选项 > 连接与集成 > Bearer Token | 复制或重置 Token | 用于外部程序鉴权 |
设置 > 选项 > 连接与集成 > 启用 Now Playing | Web 端或轻量集成入口 | 用 ws://localhost:9863/api/ws/lyric 接本机服务 |
设置 > 选项 > 连接与集成 > 启用歌词接口 | 在 127.0.0.1:32109 提供只读歌词接口 | 无需鉴权，页面会显示地址和运行状态 |
设置 > 选项 > 连接与集成 > Nexus PlayerCap 地址 | 接入 PlayerCap 歌词源 | 可选播放器、时间轴基准和是否忽略清除事件 |
设置 > 选项 > 连接与集成 > Navidrome 设置 | 配置服务器地址、用户名、密码 | 走 Subsonic / OpenSubsonic API，支持连接测试、查看服务器能力摘要、清除配置 |
桌面端设置
| GUI 位置 | 功能 | 说明 |
|---|---|---|
设置 > 选项 > 桌面端设置 > 最小化到托盘 | 点击最小化时隐藏到托盘 | 不直接退出程序 |
设置 > 选项 > 桌面端设置 > 启动后直接进入播放页 | 启动即进大屏歌词界面 | 适合长期展示场景 |
设置 > 选项 > 桌面端设置 > 隐藏任务栏图标 | 主窗口仍开着但不出现在任务栏 | 建议与托盘能力一起用 |
设置 > 选项 > 桌面端设置 > 隐藏 Remote Control 任务栏图标 | 遥控窗不单独占任务栏图标 | 只影响遥控窗 |
设置 > 选项 > 桌面端设置 > 壁纸模式 | 把窗口沉到桌面图标下方作为歌词壁纸 | Windows / macOS 均支持；该模式下键盘不可用。macOS 需授权“输入监控”，并可选自动隐藏 Dock |
设置 > 选项 > 桌面端设置 > 启用更新检查 | 启动时检查 GitHub Releases | 更新按钮也会显示状态 |
设置 > 选项 > 桌面端设置 > 更新通道 | Realeco / Limo / Cielo | 自行构建的版本显示为内部构建且不支持自动更新 |
设置 > 选项 > 桌面端设置 > 启用自动更新 | 发现新版本后自动下载 | Windows 支持自动更新；macOS 与 Linux 只检查并提示，需手动覆盖或用包管理器 |
设置 > 选项 > 桌面端设置 > 温度 | OpenAI 兼容接口的温度 | 范围 0–2，留空按 0.7 处理 |
设置 > 选项 > 桌面端设置 > AI 供应商 | Google Gemini / OpenAI Compatible | 决定 AI 主题生成用哪类接口 |
设置 > 选项 > 桌面端设置 > OpenAI 接口链接 / 模型 / 密钥 | 配 OpenAI 兼容接口 | 适用于 ChatGPT、DeepSeek 等兼容服务 |
设置 > 选项 > 桌面端设置 > 为 AI 使用系统代理 | 仅 AI 请求走系统代理 | 不影响普通播放请求 |
实验室
| GUI 位置 | 功能 | 说明 |
|---|---|---|
设置 > 选项 > 实验室 > Static Mode | 关闭几何背景 | 保留歌词文字动画 |
设置 > 选项 > 实验室 > 关闭主页动态背景 | 降低主页 GPU 占用 | 适合低性能设备 |
设置 > 选项 > 实验室 > 动画帧率限制 | 限制 visualizer 帧率 | 用于排查性能和兼容问题 |
设置 > 选项 > 实验室 > 修复 Linux 歌词动画卡死 | 改变部分歌词动画的发光绘制方式 | Linux 下默认开启，详见 Chromium FD 耗尽问题 |
设置 > 选项 > 实验室 > 隐藏播放页 UI | 分别隐藏底部控制条、底部字幕层、右侧按钮 | 隐藏右侧按钮后仍可按 P 开关面板 |
设置 > 选项 > 实验室 > 显示信息卡片关闭按钮 | 卡片打开后保留浮动关闭按钮 | 方便纯展示界面收起面板 |
设置 > 选项 > 实验室 > 始终显示切歌按钮 | 进度条两侧箭头常驻 | 不再需要悬停才浮出 |
设置 > 选项 > 实验室 > 始终显示播放页左上角返回按钮 | 返回按钮常驻 | 适合触屏和投屏 |
设置 > 选项 > 实验室 > 始终显示标题栏控制按钮 | 最小化 / 最大化 / 关闭常驻 | 不显示整条标题栏 |
设置 > 选项 > 实验室 > 播放时阻止休眠 | 播放期间保持显示器唤醒 | 仅桌面端 |
设置 > 选项 > 实验室 > 语音输入时暂停播放 | 检测到麦克风被占用时自动暂停 | 仅 Windows 桌面端 |
设置 > 选项 > 实验室 > 开启播放页原生毛玻璃背景 | 使用系统原生毛玻璃 | 仅桌面端，开启后各种背景不再显示 |
设置 > 选项 > 实验室 > 模组系统 | 打开桌面端模组加载器 | 仅桌面端；模组以应用完整权限运行，详见模组系统 |
设置 > 选项 > 实验室 > 进入应用后自动播放 | 启动后自动续播上次歌曲 | 普通浏览器标签页可能仍需点击一次 |
歌词过滤已经从实验室移到 播放控制 > 歌词。
命令面板
命令面板是 Folia 的全局操作中枢。推荐在任意界面按 Ctrl/Cmd + K 打开；完整用法见命令面板用户指南。
命令类型
| 命令类型 | 典型命令 |
|---|---|
| 搜索 | 搜当前音乐来源 / 本地 / Navidrome / 网易云、筛选当前视图 |
| 设置 | 打开帮助、打开选项、直达任意设置小节、语言切换、睡眠定时、立即同步 |
| 导航 | 回主页、回播放页、打开 Lattice、Lattice 聚焦当前歌曲、切到具体主页标签、浏览器全屏 |
| 面板 | 打开 封面 / 控制 / 队列 / 账号 / 本地 / Navidrome / 歌词 标签 |
| 播放 | 播放、暂停、上一首、下一首、循环、收藏、添加到歌单、静音、音量、打乱队列、清空队列、队列界面、匹配最佳歌词、私人 FM 模式 |
| 音频 | 音频效果器、均衡器预设、ReplayGain 模式、智能过渡与过渡模式 |
| 视觉 | 切换 visualizer、每首歌随机模式、切换背景模式（common / nomand / latent / sora / url / monet）、生成 AI 主题、主题快速编辑器、主题来源、歌词分词调整、透明背景、明暗切换 |
| 网格 | 排序、切换合集面板与曲目列表、重新导入文件夹、整理歌曲信息、导出歌单、实体编辑、编辑模式 |
| 桌面 | 切换歌词接口、遥控窗、主窗口置顶、壁纸模式、播放时阻止休眠、语音输入时暂停、模组 |
它还提供队列 @artist / @album 筛选和 --remove / --next / --end 批量操作、网格筛选的 --play / --add、: 执行模式、睡眠定时参数、歌词分词调整，以及最多三个固定命令。具体语法和快捷键以命令面板用户指南为准。
Lattice（队列拼贴）
| GUI 位置或方式 | 功能 | 说明 |
|---|---|---|
任意界面 Ctrl/Cmd + B | 打开 / 退出 Lattice | 私人 FM 期间不可用 |
命令面板 > Lattice 打开 | 同上 | 执行模式 : 然后 w |
进度条右侧按钮设为歌曲墙 | 点按进入 | 在界面设置 > 底部界面 > 进度条按钮槽位配置 |
设置 > 选项 > 界面设置 > 播放后进入的视图 | 点击播放后直接进 Lattice | 首次使用时会主动询问一次 |
| Lattice 内 拖动 / 方向键 | 平移与移动选中 | |
Lattice 内 Enter | 展开选中海报；已展开时播放 | 当前歌曲则切换播放 / 暂停 |
Lattice 内 Esc | 收起展开与选中，再按一次退出 | |
| Lattice 右下角齿轮按钮 | Lattice 工具面板 | 聚焦当前歌曲、切歌自动聚焦、打开队列命令、开灯 / 关灯、操作提示 |
| Lattice 右下角按钮向左滑 | 打开命令面板 | 和首页海报墙同一套手势 |
完整说明见 Lattice（队列拼贴）。
桌面版专属能力
遥控窗 Folia Remote
| GUI 位置 | 功能 | 说明 |
|---|---|---|
桌面版 > 打开 Folia Remote | 独立小窗控制主播放器 | 适合主窗口全屏时切歌和录屏 |
| 遥控窗 > 顶部悬停控制区 | 切换遥控窗背景模式 | 在 默认背景 / 封面色彩 / 透明背景 之间轮换 |
| 遥控窗 > 顶部悬停控制区 | 固定遥控窗在最前 / 关闭遥控窗 | 只影响这个小窗自身 |
| 遥控窗 > 中间主区域 | 进度、上一首、播放/暂停、下一首、收藏 | 是最常用的遥控动作 |
| 遥控窗 > 不操作片刻后 | 歌词浮层 | 控件会暂时让位给歌词显示 |
遥控窗里的透明控制
| GUI 位置 | 功能 | 说明 |
|---|---|---|
遥控窗 > 镜面/透明控制 图标 | 打开透明控制面板 | 专门控制主窗口的透明玩法 |
遥控窗 > 透明控制 > 常规 / 透明 | 切换主窗口透明模式 | 与设置里的“播放页透明背景”是同一能力的遥控入口 |
遥控窗 > 透明控制 > 隐藏 UI / 显示 UI | 隐藏或恢复主窗口播放页控件 | 适合录屏和直播 |
遥控窗 > 透明控制 > 显示边框 / 隐藏边框 | 切换主窗口边框 | 方便做无边框展示 |
遥控窗 > 透明控制 > 穿透 | 切换点击穿透 | 只有透明模式下才有意义 |
遥控窗 > 透明控制 > 置顶 | 主窗口始终在最前 | 影响主播放窗口，而不是遥控窗自身 |
遥控窗里的视频录制
| GUI 位置 | 功能 | 说明 |
|---|---|---|
遥控窗 > 视频 图标 | 打开录制面板 | 录制主窗口歌词画面 |
遥控窗 > 录制面板 > 整首歌 / 从此 | 选择从歌曲开头还是当前进度开始 | 适合导出整首或片段 |
| 遥控窗 > 录制面板 > 预设尺寸按钮 | 切换分辨率与横竖屏 | 支持常见横屏、竖屏、方屏预设 |
| 遥控窗 > 录制面板 > 自定义宽高 | 手动改预设尺寸 | 会自动做安全范围和偶数尺寸限制 |
遥控窗 > 录制面板 > 开始录制 / 停止并保存 / 取消 | 控制录制流程 | 录制状态会显示 Preparing / Countdown / Recording / Saving / Saved |
AI、帮助与排障入口
| GUI 位置 | 功能 | 说明 |
|---|---|---|
设置 > 帮助 > Show User Guide | 新手引导 | 解释即时搜索、快捷键、命令面板、主题 |
设置 > 帮助 > Need help? | AI 求助提示词 | 自动带上文档站和源码仓库链接 |
设置 > 选项 > 桌面端设置 > AI 供应商 | 配置 AI 主题接口 | 如果这一步没配好，生成 AI 主题会失败或回退 |
播放页 > 右侧面板 > 控制 > 生成 AI 主题 | 为当前歌曲直接生成 AI 主题 | 是最快的使用入口 |
命令面板 > Generate AI theme | 键盘触发 AI 主题生成 | 适合不想用鼠标时快速调用 |
给 AI 检索时最有用的关键词
Lattice 队列拼贴 海报墙 聚焦当前歌曲 播放后进入的视图命令面板 执行模式 快捷命令 自定义快捷键 网格命令智能过渡 Automix 分析模型 表现模式 过渡动画壁纸模式 模组系统 听歌打卡 自动转换音频 本地文件夹监视主页 标签 搜索 设置 帮助 扫描进度播放页 右侧面板 封面 控制 队列 账号本地歌词 Navidrome歌词 在线歌词 时间轴偏移视觉设置 Theme Park 歌词动画实验台Stage API Now Playing OBS Browser Source最小化到托盘 隐藏任务栏图标 自动更新Folia Remote 透明控制 点击穿透 视频录制Need help User Guide 命令面板
建议继续搭配阅读：