使用中遇到问题？
先来这里看看。

先找到你的系统。Windows 和 Linux 电脑按处理器选择 x64 或 ARM64；Mac 的 M 系列芯片选 Apple Silicon，Intel 芯片选 Intel。不确定时，可以在系统信息里查看处理器或芯片名称。

先确认是否使用了正式安装包。便携版、手动复制的程序和从源码运行的版本无法自动更新，需要下载新版手动替换。如果已经安装过，请检查是否移动了程序文件，或安装目录是否允许写入。

先检查是否移动过程序文件，以及安装目录是否允许写入。Program Files、Windows 等目录的权限可能影响更新。如果仍然失败，请把错误提示、安装路径和应用版本发到 GitHub Issues。

目前 macOS 安装包尚未签名。确认文件来自本项目的 GitHub Releases 后，可以按下载页的说明处理。如果 PKG 无法安装，也可下载对应芯片的 .app.zip，解压后放进“应用程序”；系统仍可能提示需要验证。

听本地歌曲不用登录。听在线歌曲需要先登录酷狗账号，可以用手机号验证码或扫码登录。

如果只有个别歌曲不能播放，先确认账号是否有对应权限，部分付费专辑需要单独购买。如果所有在线歌曲都播不了，可以先重新扫码登录，再检查网络和代理设置，或换个网络试试。反馈时请附上错误提示和歌曲名称。

可以在播放时切换音质、调节倍速，也可以开启智能过渡。10 段均衡器提供预设，每个频段也能在 ±15 dB 范围内手动调节。

不用一首首加。选择音乐文件夹后，KA Music 会连同子文件夹一起扫描，并读取文件里的歌曲信息。以后加了新歌，刷新文件夹就可以。你也能设置封面，为歌曲匹配歌词和歌手。

不会。KA Music 会读取音乐库信息，按专辑显示歌曲，播放时再从服务器读取音频。听歌时需要保持 Jellyfin 服务器可访问。

可以导入，导入时会在目标曲库中查找对应歌曲。部分歌曲可能找不到，或匹配到不同版本，需要你检查一下。一次导入数千首可能出错，大歌单建议分批处理。

支持 MP3、FLAC、WAV、OGG、M4A、AAC、WEBM、DSF、DFF 等格式。如果某个文件无法播放，可以先确认文件是否完整；反馈时请说明格式和出现问题的操作。

在播放页的主题选择入口可以切换。可选经典、摆钟（Pendolo）、浮名（Fume）和十四行诗（Sonnet），其中一些主题参考了 Folia 播放器的设计。

可以，但歌词需要带有每个字的时间信息。KA Music 支持 KRC、LRC、VTT、QRC 文件，也能匹配歌词。如果文件只有每行的时间，就会按行显示。

有，支持透明、置顶和鼠标穿透。不过，Hyprland、niri 等 Linux 桌面环境下的支持有限，无法获得与其他桌面环境完全相同的效果。

可以。在设置中把关闭窗口的行为选为“最小化到托盘”，关窗后音乐会继续播放。选“退出程序”则会停止播放并退出。想切歌或暂停时，也可以使用全局快捷键或系统媒体控件。

不是。KA Music 是一个第三方开源项目，使用 .NET 10 和 Avalonia 开发，支持 Windows、Linux 和 macOS。项目用于个人学习和技术研究，音乐资源和账号权限由原平台提供。

这是项目早期使用的名称。安装包保留旧名字，是为了让已安装的老版本能继续升级；应用和网站使用 KA Music 这个名字。

请告诉我们：你用的应用版本和系统、怎样安装的、做了哪些操作、哪里与预期不同。有错误提示或截图也请附上，并遮住验证码、账号令牌、Jellyfin 密钥等私密信息。问题反馈可以提交到 GitHub Issues，日常交流也欢迎加入 QQ 群。