{"repo": "chthollyphile/folia-site", "files": {"docs/guide/basic.md": {"d0992db25db288e67ea828842b9ecd0e2e6ace4f": {"t": 1785747222.4451554, "n": 3250, "h": "bd6014bd30777673", "c": "> [!TIP]\n> 本说明基于 v0.6.0 版本，后续版本界面可能有所变动\n\n## 快速上手\n\nFolia的首页非常简洁，顶部tab区域可以切换当前来源，包括：\n\n- 在线：网易云收藏歌单\n- 电台：网易云推荐歌单，私人FM，日推\n- 专辑：网易云收藏专辑\n- 本地：本地曲库\n- Navi：Navidrome服务器\n\n你需要登录网易云账户，才能使用网易云相关功能。部分歌曲需要账户拥有网易云VIP才可以播放。\n\n# Folia 首页\n\n\n\nFolia里所有的 歌曲集合/歌单/专辑 都作为卡片展示，点击卡片即可进入海报墙页面。\n\n点击顶部的 **全部** 按钮，可以快速查看当前视图下的全部卡片\n\n## 海报墙\n\n\n\n点击顶部可以展开左侧面板，查看当前歌单/专辑信息。\n\n点击右侧按钮，会打开歌曲列表，快速定位歌曲。\n\n整个歌曲列表海报墙可以使用鼠标/滚轮/触控拖动，点击歌曲可以聚焦到当前。\n\n在该页面按下任意按键，即可触发搜索过滤，过滤出来的结果可以快速添加到播放队列：\n\n\n\n# 播放页面\n\n基本播放控制：\n\n推荐使用键盘/系统媒体控件开控制播放。\n\n| 功能 | 快捷键 |\n|------|--------|\n| 播放 / 暂停 | Space |\n| 上一首 | Ctrl + ← |\n| 下一首 | Ctrl + → |\n| 倒退 5 秒 | ← |\n| 快进 5 秒 | → |\n| 切换右侧面板 | P |\n| 隐藏进度条和右下角按钮 | H |\n| 全屏 | F11 |\n\n注意: MacOS 上，切换上一曲/下一曲使用Cmd键而不是 Ctrl\n\n\n\n播放页面左上角悬浮鼠标，可以快速返回。\n\n右下角按钮可以展开控制面板：\n\n\n\n中间一排图标从左到右，分别是：\n\n## 歌曲信息\n\n展示当前播放歌曲标题，专辑，艺术家信息，点击对应条目可以跳转\n\n\n\n## 歌词信息\n\n当前播放歌曲的歌词信息，可以发起在线歌词匹配，本地歌词文件导入，歌词时间轴调整\n\n\n\n## 播放控制\n\n主要控制功能。\n\n第一行按钮的功能分别为：循环模式，添加到我喜欢的歌曲，进行AI主题生成\n\nAI主题生成按钮在当前歌曲已有主题的情况下，会显示为：\n\n\n\n没有的时候，显示为：\n\n\n\n下方可以调整当前播放页面的背景，主题以及相关的简单设置。点击齿轮按钮则可以打开完整的歌词样式设置\n\n\n\n如果生成过AI主题，点击主题名，即可打开快速主题编辑面板：\n\n\n\n关于如何使用ai主题功能，请跳到 [AI 主题功能快速上手](/guide/basic#ai-主题功能快速上手)。\n\n## 播放队列\n\n\n\n鼠标悬浮在播放队列的歌曲上，可以调整播放顺序：\n\n三个按钮分别是：移动到下一首，移动到末尾，移除播放列表\n\n## 账户信息\n\n当前登录的网易云账户信息，以及播放音质选择\n\n# S命令窗口\n\n按下 S键，或者滑动右侧按钮，可以打开命令窗口：\n\n\n\n绝大多数功能都可以在这里直接执行，可以输入中文，英文，拼音。具体命令可点击问号按钮查看\n\n# AI 主题功能快速上手\n\n简单来说，AI主题功能会使用当前播放歌曲的歌词内容，生成一个配色主题。该功能要求你必须自己提供一个AI服务的API Key，Folia本身不提供任何AI服务。\n\n当没有接入任何AI服务时，点击生成AI主题功能按钮，会回退到使用封面取色方案，产出一个主题。你可以在快速主题编辑器里修改这个主题。\n\n## 如何配置AI 服务\n\n首先你需要拥有任意一个大模型厂商的API Key，例如：Gemini，OpenAI，DeepSeek，Kimi等。查阅对应模型厂商的文档，获取API Key，以及调用该模型的接口地址和模型名。\n\n下面以 DeepSeek 为例说明一下\n\n你需要在 DeepSeek 的官网注册账号，然后找到其[开放文档](https://api-docs.deepseek.com/zh-cn/)，在其中找到 `OpenAI 兼容接口`的部分，记下来其中的 `接口地址`，`模型名`：\n\n\n\n这里的接口地址是 `https://api.deepseek.com`, 模型名是 `deepseek-v4-flash` 或 `deepseek-v4-pro` \n\n\n\n然后打开 https://platform.deepseek.com/api_keys ,点击创建 一个新的API Key：\n\n\n\n然后保存这个API Key，回到 Folia 的设置里，找到 AI 主题设置，填写对应的 API Key，接口地址和模型名。\n\n\n\n如果你使用的是其他厂商的服务，查阅对应厂商的文档，获取API Key，接口地址和模型名，然后在 Folia 的设置里填写。\n\n> [!TIP]\n> 如果你使用的是国外厂商的服务，可以打开 为AI使用系统代理，这会让 Folia 使用系统代理访问AI服务，避免网络问题导致的请求失败。\n\n配置完成之后，点击生成AI主题按钮，就可以使用AI服务生成主题了。详见这个[演示视频](https://www.bilibili.com/video/BV1zcTj6AEpu/)"}, "b45dd1d9509a2eae0081851c5f14d6336df316e7": {"t": 1785771461.2614827, "n": 3250, "h": "bd6014bd30777673", "c": "> [!TIP]\n> 本说明基于 v0.6.0 版本，后续版本界面可能有所变动\n\n## 快速上手\n\nFolia的首页非常简洁，顶部tab区域可以切换当前来源，包括：\n\n- 在线：网易云收藏歌单\n- 电台：网易云推荐歌单，私人FM，日推\n- 专辑：网易云收藏专辑\n- 本地：本地曲库\n- Navi：Navidrome服务器\n\n你需要登录网易云账户，才能使用网易云相关功能。部分歌曲需要账户拥有网易云VIP才可以播放。\n\n# Folia 首页\n\n\n\nFolia里所有的 歌曲集合/歌单/专辑 都作为卡片展示，点击卡片即可进入海报墙页面。\n\n点击顶部的 **全部** 按钮，可以快速查看当前视图下的全部卡片\n\n## 海报墙\n\n\n\n点击顶部可以展开左侧面板，查看当前歌单/专辑信息。\n\n点击右侧按钮，会打开歌曲列表，快速定位歌曲。\n\n整个歌曲列表海报墙可以使用鼠标/滚轮/触控拖动，点击歌曲可以聚焦到当前。\n\n在该页面按下任意按键，即可触发搜索过滤，过滤出来的结果可以快速添加到播放队列：\n\n\n\n# 播放页面\n\n基本播放控制：\n\n推荐使用键盘/系统媒体控件开控制播放。\n\n| 功能 | 快捷键 |\n|------|--------|\n| 播放 / 暂停 | Space |\n| 上一首 | Ctrl + ← |\n| 下一首 | Ctrl + → |\n| 倒退 5 秒 | ← |\n| 快进 5 秒 | → |\n| 切换右侧面板 | P |\n| 隐藏进度条和右下角按钮 | H |\n| 全屏 | F11 |\n\n注意: MacOS 上，切换上一曲/下一曲使用Cmd键而不是 Ctrl\n\n\n\n播放页面左上角悬浮鼠标，可以快速返回。\n\n右下角按钮可以展开控制面板：\n\n\n\n中间一排图标从左到右，分别是：\n\n## 歌曲信息\n\n展示当前播放歌曲标题，专辑，艺术家信息，点击对应条目可以跳转\n\n\n\n## 歌词信息\n\n当前播放歌曲的歌词信息，可以发起在线歌词匹配，本地歌词文件导入，歌词时间轴调整\n\n\n\n## 播放控制\n\n主要控制功能。\n\n第一行按钮的功能分别为：循环模式，添加到我喜欢的歌曲，进行AI主题生成\n\nAI主题生成按钮在当前歌曲已有主题的情况下，会显示为：\n\n\n\n没有的时候，显示为：\n\n\n\n下方可以调整当前播放页面的背景，主题以及相关的简单设置。点击齿轮按钮则可以打开完整的歌词样式设置\n\n\n\n如果生成过AI主题，点击主题名，即可打开快速主题编辑面板：\n\n\n\n关于如何使用ai主题功能，请跳到 [AI 主题功能快速上手](/guide/basic#ai-主题功能快速上手)。\n\n## 播放队列\n\n\n\n鼠标悬浮在播放队列的歌曲上，可以调整播放顺序：\n\n三个按钮分别是：移动到下一首，移动到末尾，移除播放列表\n\n## 账户信息\n\n当前登录的网易云账户信息，以及播放音质选择\n\n# S命令窗口\n\n按下 S键，或者滑动右侧按钮，可以打开命令窗口：\n\n\n\n绝大多数功能都可以在这里直接执行，可以输入中文，英文，拼音。具体命令可点击问号按钮查看\n\n# AI 主题功能快速上手\n\n简单来说，AI主题功能会使用当前播放歌曲的歌词内容，生成一个配色主题。该功能要求你必须自己提供一个AI服务的API Key，Folia本身不提供任何AI服务。\n\n当没有接入任何AI服务时，点击生成AI主题功能按钮，会回退到使用封面取色方案，产出一个主题。你可以在快速主题编辑器里修改这个主题。\n\n## 如何配置AI 服务\n\n首先你需要拥有任意一个大模型厂商的API Key，例如：Gemini，OpenAI，DeepSeek，Kimi等。查阅对应模型厂商的文档，获取API Key，以及调用该模型的接口地址和模型名。\n\n下面以 DeepSeek 为例说明一下\n\n你需要在 DeepSeek 的官网注册账号，然后找到其[开放文档](https://api-docs.deepseek.com/zh-cn/)，在其中找到 `OpenAI 兼容接口`的部分，记下来其中的 `接口地址`，`模型名`：\n\n\n\n这里的接口地址是 `https://api.deepseek.com`, 模型名是 `deepseek-v4-flash` 或 `deepseek-v4-pro` \n\n\n\n然后打开 https://platform.deepseek.com/api_keys ,点击创建 一个新的API Key：\n\n\n\n然后保存这个API Key，回到 Folia 的设置里，找到 AI 主题设置，填写对应的 API Key，接口地址和模型名。\n\n\n\n如果你使用的是其他厂商的服务，查阅对应厂商的文档，获取API Key，接口地址和模型名，然后在 Folia 的设置里填写。\n\n> [!TIP]\n> 如果你使用的是国外厂商的服务，可以打开 为AI使用系统代理，这会让 Folia 使用系统代理访问AI服务，避免网络问题导致的请求失败。\n\n配置完成之后，点击生成AI主题按钮，就可以使用AI服务生成主题了。详见这个[演示视频](https://www.bilibili.com/video/BV1zcTj6AEpu/)"}, "e889687077c702ce9160f1c90793b0172d35995f": {"t": 1785771462.8562298, "n": 2883, "h": "125cb4ee6b66a3ee", "c": "> [!TIP]\n> 本说明基于 v0.6.0 版本，后续版本界面可能有所变动\n\n## 快速上手\n\nFolia的首页非常简洁，顶部tab区域可以切换当前来源，包括：\n\n- 在线：网易云收藏歌单\n- 电台：网易云推荐歌单，私人FM，日推\n- 专辑：网易云收藏专辑\n- 本地：本地曲库\n- Navi：Navidrome服务器\n\n你需要登录网易云账户，才能使用网易云相关功能。部分歌曲需要账户拥有网易云VIP才可以播放。\n\n# Folia 首页\n\n\n\nFolia里所有的 歌曲集合/歌单/专辑 都作为卡片展示，点击卡片即可进入海报墙页面。\n\n点击顶部的 **全部** 按钮，可以快速查看当前视图下的全部卡片\n\n## 海报墙\n\n\n\n点击顶部可以展开左侧面板，查看当前歌单/专辑信息。\n\n点击右侧按钮，会打开歌曲列表，快速定位歌曲。\n\n整个歌曲列表海报墙可以使用鼠标/滚轮/触控拖动，点击歌曲可以聚焦到当前。\n\n在该页面按下任意按键，即可触发搜索过滤，过滤出来的结果可以快速添加到播放队列：\n\n\n\n# 播放页面\n\n\n\n播放页面左上角悬浮鼠标，可以快速返回。\n\n右下角按钮可以展开控制面板：\n\n\n\n中间一排图标从左到右，分别是：\n\n## 歌曲信息\n\n展示当前播放歌曲标题，专辑，艺术家信息，点击对应条目可以跳转\n\n\n\n## 歌词信息\n\n当前播放歌曲的歌词信息，可以发起在线歌词匹配，本地歌词文件导入，歌词时间轴调整\n\n\n\n## 播放控制\n\n主要控制功能。\n\n第一行按钮的功能分别为：循环模式，添加到我喜欢的歌曲，进行AI主题生成\n\nAI主题生成按钮在当前歌曲已有主题的情况下，会显示为：\n\n\n\n没有的时候，显示为：\n\n\n\n下方可以调整当前播放页面的背景，主题以及相关的简单设置。点击齿轮按钮则可以打开完整的歌词样式设置\n\n\n\n如果生成过AI主题，点击主题名，即可打开快速主题编辑面板：\n\n\n\n关于如何使用ai主题功能，请跳到 [AI 主题功能快速上手](/guide/basic#ai-主题功能快速上手)。\n\n## 播放队列\n\n\n\n鼠标悬浮在播放队列的歌曲上，可以调整播放顺序：\n\n三个按钮分别是：移动到下一首，移动到末尾，移除播放列表\n\n## 账户信息\n\n当前登录的网易云账户信息，以及播放音质选择\n\n# S命令窗口\n\n按下 S键，或者滑动右侧按钮，可以打开命令窗口：\n\n\n\n绝大多数功能都可以在这里直接执行，可以输入中文，英文，拼音。具体命令可点击问号按钮查看\n\n# AI 主题功能快速上手\n\n简单来说，AI主题功能会使用当前播放歌曲的歌词内容，生成一个配色主题。该功能要求你必须自己提供一个AI服务的API Key，Folia本身不提供任何AI服务。\n\n当没有接入任何AI服务时，点击生成AI主题功能按钮，会回退到使用封面取色方案，产出一个主题。你可以在快速主题编辑器里修改这个主题。\n\n## 如何配置AI 服务\n\n首先你需要拥有任意一个大模型厂商的API Key，例如：Gemini，OpenAI，DeepSeek，Kimi等。查阅对应模型厂商的文档，获取API Key，以及调用该模型的接口地址和模型名。\n\n下面以 DeepSeek 为例说明一下\n\n你需要在 DeepSeek 的官网注册账号，然后找到其[开放文档](https://api-docs.deepseek.com/zh-cn/)，在其中找到 `OpenAI 兼容接口`的部分，记下来其中的 `接口地址`，`模型名`：\n\n\n\n这里的接口地址是 `https://api.deepseek.com`, 模型名是 `deepseek-v4-flash` 或 `deepseek-v4-pro` \n\n\n\n然后打开 https://platform.deepseek.com/api_keys ,点击创建 一个新的API Key：\n\n\n\n然后保存这个API Key，回到 Folia 的设置里，找到 AI 主题设置，填写对应的 API Key，接口地址和模型名。\n\n\n\n如果你使用的是其他厂商的服务，查阅对应厂商的文档，获取API Key，接口地址和模型名，然后在 Folia 的设置里填写。\n\n> [!TIP]\n> 如果你使用的是国外厂商的服务，可以打开 为AI使用系统代理，这会让 Folia 使用系统代理访问AI服务，避免网络问题导致的请求失败。\n\n配置完成之后，点击生成AI主题按钮，就可以使用AI服务生成主题了。详见这个[演示视频](https://www.bilibili.com/video/BV1zcTj6AEpu/)"}, "ed1860c9eeec95f7e4baf9193858a4430245ab31": {"t": 1785771464.217901, "n": 2148, "h": "6e11eebf119368ce", "c": "> [!TIP]\n> 本说明基于 v0.6.0 版本，后续版本界面可能有所变动\n\n## 快速上手\n\nFolia的首页非常简洁，顶部tab区域可以切换当前来源，包括：\n\n- 在线：网易云收藏歌单\n- 电台：网易云推荐歌单，私人FM，日推\n- 专辑：网易云收藏专辑\n- 本地：本地曲库\n- Navi：Navidrome服务器\n\n你需要登录网易云账户，才能使用网易云相关功能。部分歌曲需要账户拥有网易云VIP才可以播放。\n\n# Folia 首页\n\n\n\nFolia里所有的 歌曲集合/歌单/专辑 都作为卡片展示，点击卡片即可进入海报墙页面。\n\n点击顶部的 **全部** 按钮，可以快速查看当前视图下的全部卡片\n\n## 海报墙\n\n\n\n点击顶部可以展开左侧面板，查看当前歌单/专辑信息。\n\n点击右侧按钮，会打开歌曲列表，快速定位歌曲。\n\n整个歌曲列表海报墙可以使用鼠标/滚轮/触控拖动，点击歌曲可以聚焦到当前。\n\n在该页面按下任意按键，即可触发搜索过滤，过滤出来的结果可以快速添加到播放队列：\n\n\n\n# 播放页面\n\n基本播放控制：\n\n推荐使用键盘/系统媒体控件开控制播放。\n\n| 功能 | 快捷键 |\n|------|--------|\n| 播放 / 暂停 | Space |\n| 上一首 | Ctrl + ← |\n| 下一首 | Ctrl + → |\n| 倒退 5 秒 | ← |\n| 快进 5 秒 | → |\n| 切换右侧面板 | P |\n| 隐藏进度条和右下角按钮 | H |\n| 全屏 | F11 |\n\n注意: MacOS 上，切换上一曲/下一曲使用Cmd键而不是 Ctrl\n\n\n\n播放页面左上角悬浮鼠标，可以快速返回。\n\n右下角按钮可以展开控制面板：\n\n\n\n中间一排图标从左到右，分别是：\n\n## 歌曲信息\n\n展示当前播放歌曲标题，专辑，艺术家信息，点击对应条目可以跳转\n\n\n\n## 歌词信息\n\n当前播放歌曲的歌词信息，可以发起在线歌词匹配，本地歌词文件导入，歌词时间轴调整\n\n\n\n## 播放控制\n\n主要控制功能。\n\n第一行按钮的功能分别为：循环模式，添加到我喜欢的歌曲，进行AI主题生成\n\nAI主题生成按钮在当前歌曲已有主题的情况下，会显示为：\n\n\n\n没有的时候，显示为：\n\n\n\n下方可以调整当前播放页面的背景，主题以及相关的简单设置。点击齿轮按钮则可以打开完整的歌词样式设置\n\n\n\n如果生成过AI主题，点击主题名，即可打开快速主题编辑面板：\n\n\n\n## 播放队列\n\n\n\n鼠标悬浮在播放队列的歌曲上，可以调整播放顺序：\n\n三个按钮分别是：移动到下一首，移动到末尾，移除播放列表\n\n## 账户信息\n\n当前登录的网易云账户信息，以及播放音质选择\n\n# S命令窗口\n\n按下 S键，或者滑动右侧按钮，可以打开命令窗口：\n\n\n\n绝大多数功能都可以在这里直接执行，可以输入中文，英文，拼音。具体命令可点击问号按钮查看\n"}, "4254721843685971d0874ebbf307114b63253106": {"t": 1785771465.7970657, "n": 1781, "h": "c8b8d1d93a7877ec", "c": "> [!TIP]\n> 本说明基于 v0.6.0 版本，后续版本界面可能有所变动\n\n## 快速上手\n\nFolia的首页非常简洁，顶部tab区域可以切换当前来源，包括：\n\n- 在线：网易云收藏歌单\n- 电台：网易云推荐歌单，私人FM，日推\n- 专辑：网易云收藏专辑\n- 本地：本地曲库\n- Navi：Navidrome服务器\n\n你需要登录网易云账户，才能使用网易云相关功能。部分歌曲需要账户拥有网易云VIP才可以播放。\n\n# Folia 首页\n\n\n\nFolia里所有的 歌曲集合/歌单/专辑 都作为卡片展示，点击卡片即可进入海报墙页面。\n\n点击顶部的 **全部** 按钮，可以快速查看当前视图下的全部卡片\n\n## 海报墙\n\n\n\n点击顶部可以展开左侧面板，查看当前歌单/专辑信息。\n\n点击右侧按钮，会打开歌曲列表，快速定位歌曲。\n\n整个歌曲列表海报墙可以使用鼠标/滚轮/触控拖动，点击歌曲可以聚焦到当前。\n\n在该页面按下任意按键，即可触发搜索过滤，过滤出来的结果可以快速添加到播放队列：\n\n\n\n# 播放页面\n\n\n\n播放页面左上角悬浮鼠标，可以快速返回。\n\n右下角按钮可以展开控制面板：\n\n\n\n中间一排图标从左到右，分别是：\n\n## 歌曲信息\n\n展示当前播放歌曲标题，专辑，艺术家信息，点击对应条目可以跳转\n\n\n\n## 歌词信息\n\n当前播放歌曲的歌词信息，可以发起在线歌词匹配，本地歌词文件导入，歌词时间轴调整\n\n\n\n## 播放控制\n\n主要控制功能。\n\n第一行按钮的功能分别为：循环模式，添加到我喜欢的歌曲，进行AI主题生成\n\nAI主题生成按钮在当前歌曲已有主题的情况下，会显示为：\n\n\n\n没有的时候，显示为：\n\n\n\n下方可以调整当前播放页面的背景，主题以及相关的简单设置。点击齿轮按钮则可以打开完整的歌词样式设置\n\n\n\n如果生成过AI主题，点击主题名，即可打开快速主题编辑面板：\n\n\n\n## 播放队列\n\n\n\n鼠标悬浮在播放队列的歌曲上，可以调整播放顺序：\n\n三个按钮分别是：移动到下一首，移动到末尾，移除播放列表\n\n## 账户信息\n\n当前登录的网易云账户信息，以及播放音质选择\n\n# S命令窗口\n\n按下 S键，或者滑动右侧按钮，可以打开命令窗口：\n\n\n\n绝大多数功能都可以在这里直接执行，可以输入中文，英文，拼音。具体命令可点击问号按钮查看\n"}}}}