Folia酷狗音源实战内置KugouMusicApi与账号登录全解析【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFoliafolia-major是一款专注于绚丽歌词动画效果的本地音乐播放器同时支持 Navidrome 与多平台在线音源。它的酷狗音源能力基于开源项目 KugouMusicApiElectron 桌面版在主进程中直接调用内置的 KugouMusicApi Node 模块无需再单独部署一个酷狗 HTTP 服务本文带你从零完成酷狗音源配置与账号登录并看懂登录背后的完整链路。酷狗音源是怎么接进 Folia 的Folia 的在线音乐层采用统一的 Omni 架构网易云、酷狗、QQ 三个音源都通过同一套合约接入酷狗的适配器实现在 kugouProvider.ts网络边界在 kugouTransport.ts。两种使用形态的关键区别形态酷狗 API 来源需要做什么Electron 桌面版内置 KugouMusicApi Node 模块主进程直接调用什么都不用部署直接登录即可Web 版需自行部署 KuGouMusicApi 实例在.env.local中配置VITE_KUGOU_API_BASEWeb 版没有默认公共实例配置方式很简单在环境变量中填入你部署好的 KuGouMusicApi 地址即可该变量无默认值留空则酷狗入口不可用。完整说明见 technical.md 的「部署与开发」章节。酷狗账号登录三步二维码流程酷狗账号登录是 Folia 中体验最完整的在线账号流程之一整个登录由三个接口串联完成接口文档见 ku-go-api-docs.md获取二维码 key—— 调用/login/qr/key拿到一次登录会话的 key生成二维码—— 调用/login/qr/create带qrimg: true返回二维码图片的 base64Folia 直接把它渲染成可扫的二维码轮询扫码状态—— 调用/login/qr/check状态码1等待扫码、2待确认、4登录成功并返回 token登录成功后token 的去向体现了桌面端的安全设计Electron 版把token、cookie、dfid加密保存在主进程的桥接层kugouApiBridge.cjs渲染进程只保留非敏感的账号提示信息敏感凭据不会写入 localStorage。这个边界在 kugouTransport.ts 中有明确注释。登录状态通过/user/detail接口刷新整个账号生命周期登录、刷新、退出由 useKugouLibrary.ts 驱动启动时自动检查登录状态token 过期则清空账号状态回到未登录界面退出登录时先清界面状态再调omni.logout(kugou)即使 IPC 失败也不会残留「假登录」的 UI桌面端还内置了脱敏日志%APPDATA%\Folia\logs\kugou-provider.log只记录请求阶段、状态码和字段名token、Cookie、userid、dfid 全部脱敏方便排查登录失败而不泄露凭据。登录解锁哪些酷狗能力扫码成功后酷狗账号的能力基本和官方客户端对齐完整对照表见 kugou-omni-capability-alignment.md能力对应接口搜索歌曲 / 歌单 / 歌手/searchtypesong等用户歌单与收藏专辑/user/playlist「我喜欢」收藏歌曲查找歌单后走/playlist/track/all云盘歌曲播放/user/cloud/url每日推荐 / 私人 FM/everyday/recommend、/personal/fm歌曲音源含云盘/song/url歌词LRC / 逐字 KRC/search/lyric/lyric歌单曲目增删、收藏管理/playlist/tracks/add、/playlist/tracks/del其中云盘支持是不少播放器的加分项Folia 会把云盘入口直接组装成一个可浏览的 collection登录状态下云盘歌曲和普通歌曲一样可以直接播放。逐字歌词KRC正是 Folia 绚丽歌词动画的燃料——登录后拿到fmtkrc格式的逐字歌词就能驱动逐字弹跳、渐变高亮等动画效果需要知道的限制酷狗接口目前没有「歌曲可用性与版权替代」能力版权原因导致的播放失败会直接提示无音源不会像网易云那样自动换一首替代歌曲。上手避坑清单不同平台 token 不通用KuGouMusicApi 区分完整版与概念版platformlite两边登录的 token 互不相通选错会导致搜索报错获取音源前要先拿 dfid/song/url依赖/register/dev接口返回的 dfidFolia 已在传输层自动处理自行调接口时要注意不要频繁调登录接口token 有效期内重复登录容易触发风控这也是 Folia 做账号快照缓存的原因搜索要带认证信息酷狗搜索接口要求携带 token/cookie未登录时搜索结果可能返回error_code: 152关键文件速查文件作用src/services/onlineMusic/kugouProvider.ts酷狗 provider 适配器能力对齐 Omni 合约src/services/onlineMusic/kugouTransport.ts酷狗请求边界Web 用 HTTP / Electron 走 IPCelectron/kugouApiBridge.cjs桌面端主进程加密持有 token 的桥接层src/hooks/useKugouLibrary.ts酷狗账号登录状态与退出逻辑docs/ku-go-api-docs.mdKuGouMusicApi 完整接口文档100 接口小结Folia 把酷狗音源做成了一个「装完就能扫」的体验桌面端内置 KugouMusicApi 模块免部署登录走标准的二维码三接口流程凭据加密存于主进程登录后搜索、歌单、云盘、每日推荐、私人 FM、逐字歌词动画全部可用。对于想要完整酷狗体验的用户Electron 桌面版 一次扫码就是最短路径。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Folia酷狗音源实战内置KugouMusicApi与账号登录全解析【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFoliafolia-major是一款专注于绚丽歌词动画效果的本地音乐播放器同时支持 Navidrome 与多平台在线音源。它的酷狗音源能力基于开源项目 KugouMusicApiElectron 桌面版在主进程中直接调用内置的 KugouMusicApi Node 模块无需再单独部署一个酷狗 HTTP 服务本文带你从零完成酷狗音源配置与账号登录并看懂登录背后的完整链路。酷狗音源是怎么接进 Folia 的Folia 的在线音乐层采用统一的 Omni 架构网易云、酷狗、QQ 三个音源都通过同一套合约接入酷狗的适配器实现在 kugouProvider.ts网络边界在 kugouTransport.ts。两种使用形态的关键区别形态酷狗 API 来源需要做什么Electron 桌面版内置 KugouMusicApi Node 模块主进程直接调用什么都不用部署直接登录即可Web 版需自行部署 KuGouMusicApi 实例在.env.local中配置VITE_KUGOU_API_BASEWeb 版没有默认公共实例配置方式很简单在环境变量中填入你部署好的 KuGouMusicApi 地址即可该变量无默认值留空则酷狗入口不可用。完整说明见 technical.md 的「部署与开发」章节。酷狗账号登录三步二维码流程酷狗账号登录是 Folia 中体验最完整的在线账号流程之一整个登录由三个接口串联完成接口文档见 ku-go-api-docs.md获取二维码 key—— 调用/login/qr/key拿到一次登录会话的 key生成二维码—— 调用/login/qr/create带qrimg: true返回二维码图片的 base64Folia 直接把它渲染成可扫的二维码轮询扫码状态—— 调用/login/qr/check状态码1等待扫码、2待确认、4登录成功并返回 token登录成功后token 的去向体现了桌面端的安全设计Electron 版把token、cookie、dfid加密保存在主进程的桥接层kugouApiBridge.cjs渲染进程只保留非敏感的账号提示信息敏感凭据不会写入 localStorage。这个边界在 kugouTransport.ts 中有明确注释。登录状态通过/user/detail接口刷新整个账号生命周期登录、刷新、退出由 useKugouLibrary.ts 驱动启动时自动检查登录状态token 过期则清空账号状态回到未登录界面退出登录时先清界面状态再调omni.logout(kugou)即使 IPC 失败也不会残留「假登录」的 UI桌面端还内置了脱敏日志%APPDATA%\Folia\logs\kugou-provider.log只记录请求阶段、状态码和字段名token、Cookie、userid、dfid 全部脱敏方便排查登录失败而不泄露凭据。登录解锁哪些酷狗能力扫码成功后酷狗账号的能力基本和官方客户端对齐完整对照表见 kugou-omni-capability-alignment.md能力对应接口搜索歌曲 / 歌单 / 歌手/searchtypesong等用户歌单与收藏专辑/user/playlist「我喜欢」收藏歌曲查找歌单后走/playlist/track/all云盘歌曲播放/user/cloud/url每日推荐 / 私人 FM/everyday/recommend、/personal/fm歌曲音源含云盘/song/url歌词LRC / 逐字 KRC/search/lyric/lyric歌单曲目增删、收藏管理/playlist/tracks/add、/playlist/tracks/del其中云盘支持是不少播放器的加分项Folia 会把云盘入口直接组装成一个可浏览的 collection登录状态下云盘歌曲和普通歌曲一样可以直接播放。逐字歌词KRC正是 Folia 绚丽歌词动画的燃料——登录后拿到fmtkrc格式的逐字歌词就能驱动逐字弹跳、渐变高亮等动画效果需要知道的限制酷狗接口目前没有「歌曲可用性与版权替代」能力版权原因导致的播放失败会直接提示无音源不会像网易云那样自动换一首替代歌曲。上手避坑清单不同平台 token 不通用KuGouMusicApi 区分完整版与概念版platformlite两边登录的 token 互不相通选错会导致搜索报错获取音源前要先拿 dfid/song/url依赖/register/dev接口返回的 dfidFolia 已在传输层自动处理自行调接口时要注意不要频繁调登录接口token 有效期内重复登录容易触发风控这也是 Folia 做账号快照缓存的原因搜索要带认证信息酷狗搜索接口要求携带 token/cookie未登录时搜索结果可能返回error_code: 152关键文件速查文件作用src/services/onlineMusic/kugouProvider.ts酷狗 provider 适配器能力对齐 Omni 合约src/services/onlineMusic/kugouTransport.ts酷狗请求边界Web 用 HTTP / Electron 走 IPCelectron/kugouApiBridge.cjs桌面端主进程加密持有 token 的桥接层src/hooks/useKugouLibrary.ts酷狗账号登录状态与退出逻辑docs/ku-go-api-docs.mdKuGouMusicApi 完整接口文档100 接口小结Folia 把酷狗音源做成了一个「装完就能扫」的体验桌面端内置 KugouMusicApi 模块免部署登录走标准的二维码三接口流程凭据加密存于主进程登录后搜索、歌单、云盘、每日推荐、私人 FM、逐字歌词动画全部可用。对于想要完整酷狗体验的用户Electron 桌面版 一次扫码就是最短路径。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
