这页跟着真实卡住的顺序写，不按功能模块罗列。先解决「装完是空的」，再到自建服务器、本地音乐、插件、播放与歌词、下载与备份。每一节都有自己的著录号，可以直接分享链接到具体某一步。
Haiku 装完，发现、搜索、我的都是空的——这不是故障。播放器与内容在这里是彻底分开的两件事：软件只负责编排与播放，内容来自你自己添加的来源。
来源一共三种：自建的音乐库服务器（Subsonic 协议，见 CAT. 902）、本机的音乐目录（见 CAT. 903）、你自己导入的插件包（见 CAT. 904）。三条路任选其一，添加成功后发现、搜索、我的会立刻有内容。
同一份插件可以用不同账号或地址装两次，就是两个彼此独立的来源——凭据、下载、缓存全部分开记账。这是「来源」和「插件」的区别：插件是代码，来源是你添加的一份实体，一份插件可以派生出多个来源。
删除来源时，喜欢、歌单、播放历史这些用户数据保留在本机；用同一账号或同一服务器地址重新添加同一份插件，会自动接回原来的数据，不会重新计一遍。
Subsonic 是一套通用协议，Navidrome、Airsonic、Gonic、Logitech Media Server（LMS）等自建音乐服务器都实现了它。Haiku 内置的「音乐库」插件说的就是这套协议本身，不需要为具体是哪一家服务端软件另外选择。
在来源管理里选择「音乐库」类型的插件——它就是 Subsonic 协议本身，不区分具体是 Navidrome、Airsonic、Gonic 还是 Logitech Media Server。
服务器地址、用户名、密码。一次性提交，不轮询、不用扫码；填错会直接在表单下方写清原因，不必反复重试等待。
提交成功后来源立即出现在列表里，随即可以浏览与播放。同一份「音乐库」插件换一个地址再装一次，就是另一台服务器。
密码不落盘。Haiku 用协议自带的 token 机制登录一次，之后只保存服务器地址、用户名与派生出的 token；原始密码在登录成功后即被丢弃。
局域网 http 地址是常态。自建服务器多数在内网，首次连接时系统可能弹出「本地网络」权限询问，请选择允许；地址迟迟连不上时先检查这一步（见 CAT. 909）。
一台服务器一个来源。把「音乐库」插件指向不同地址各装一次，家里和公司两台服务器可以同时存在、互不影响，各自的凭据、下载、缓存分开记账。删除来源只清空本机这份凭据，服务器上的数据不受影响，重新填同一地址同一账号即可接回原来的喜欢与歌单缓存。
在设置里指定一个或多个扫描目录后，Haiku 会读取其中的音频文件与标签，按歌曲、歌手、专辑三个维度归类，顶部搜索框可以就地过滤。
支持的格式：MP3、FLAC、M4A / AAC、OGG（仅 Vorbis 编码，Opus 不支持）。不在此列的文件不会出现在列表里——列出一个点下去放不了的文件，不如不列。已知完全播不了的格式：Opus / WebM、WMA、APE、WavPack、DSD、WAV / AIFF、ALAC。
长按（桌面右键）一首曲目可以手动编辑标题、艺术家、专辑、年份、音轨号、封面等字段；也可以对信息缺失的曲目发起「刮削」，让 Haiku 按标题与时长自动匹配候选并回填。自动刮削需要有效的会员订阅；手动编辑与本机已缓存的信息不需要。
手动编辑与自动刮削的结果都会被记住，重新扫描目录不会覆盖你已经确认过的信息。
Haiku 区分两类插件：内置的「音乐库」插件（即 Subsonic，见 CAT. 902）随应用自带；其余的内容来源插件由用户自行导入——本站不托管、也不分发任何内容型插件。
导入方式是一个本地 zip 包，或一个 https 地址。导入前会有一次性提示，说明这是第三方 JS 代码，可以发起网络请求并读取你输入的账号信息，请只导入来源可信的插件包。
同一份插件包可以用不同账号各装一次，形成互相独立的来源，凭据、下载、缓存各自记账、互不影响——这与「音乐库」类插件可以派生多台服务器是同一套机制。删除来源即卸载这一份实例（清空登录凭据），插件本体不受影响，仍可再次用来添加来源。
歌词来源分两层：优先问当前来源自带的歌词接口（比如自建服务器内嵌的 LRC）；找不到时，Haiku 会依次问多个独立的歌词提供方并挑一条最合适的结果。
播放页可以手动挑选歌词版本——每条候选按标题、艺术家、时长打分给出星级，是否含逐字时间轴、是否含翻译都会标出来，选中后可以实时预览再确认应用。应用后的选择会被记住，下次播放这首歌直接沿用，也可以随时「恢复自动匹配」。
设置里可以整体关闭译文这一行的显示，不影响歌词本身与已经获取到的翻译，只是不展示。
桌面歌词（独立置顶浮窗，可锁定、拖动、换排版与配色）与菜单栏歌词（常驻菜单栏的单行歌词）目前只有 macOS 已经实现，Windows / Linux 暂未提供。
联网获取歌词（自动搜索、插件自带）需要有效的会员订阅；已经缓存在本机的歌词与手动选定的版本不受此限制。
单曲、整张歌单、批量下载都会存成本机正经的音频文件（写好标签、封面、歌词），支持断点续传，重启应用后未完成的任务会继续。
下载音质、目录结构（按艺人、专辑、歌单、来源分类，或者不分类平铺）、文件命名模板、封面与歌词的写入方式（内嵌、同名文件、或两者都要），都可以在设置里调整。
已下载的曲目播放时优先使用本地文件，其次才是网络流——断网也能听已下载的内容。「自动下载」可以为某个歌单（含「喜欢」）开启，歌单变化时会自动补齐差异；移动端默认只在 Wi-Fi 下进行，也可以为单条任务选择「仍然下载」。
换下载目录时，可以选择把已下载文件一起搬过去，或者保留在原位置。
「备份」把设置、歌单、喜欢、来源列表与已安装插件（含登录凭据）一次性导出成一个文件，换设备或重装后原样导入即可继续使用——导入完成即时生效，不需要重启应用。
导入是整体覆盖：本机当前的来源列表会被备份文件里的内容替换；导入前应用会自动先给当前数据做一份安全副本。
备份文件明文包含各来源的登录凭据，请像对待密码一样保管，不要随意分享。
设置按用途分区：外观（主题、界面字体）、播放（音质、音量均衡、音效、睡眠定时）、存储（媒体缓存与下载）、来源（本地 / 音乐库 / 插件三档管理）、备份、日志与关于。
「媒体缓存」与「下载」是两回事：缓存是播放过顺带留下的可丢弃临时文件，会按空间上限自动清理；下载是你主动要的正式文件，只有你自己能删。缓存上限、下载数量与并发都可以在存储设置里调整。
先看看系统有没有弹出「本地网络」权限请求，务必允许；再确认地址带对了协议前缀（http / https）与端口。苹果系统可以在系统设置的隐私选项里重新打开这项权限，与代理设置无关。
见 CAT. 903 的格式列表。Opus / WebM、WMA、APE、DSD 等格式暂不支持解码，需要先在源头转成受支持的格式，再放进扫描目录。
联网获取的歌词（插件自带与自动搜索）需要有效的会员订阅；本机已缓存过的歌词与手动选定的版本不受影响，照常显示。
仅当本机没有任何登录凭据时，移动端会先要求完成一次账号登录；这与添加来源是两回事——登录只关系账号与会员权限，添加来源、播放本地文件都不需要它。桌面端不强制登录。
不会。删除只清掉这台设备上的登录凭据与本地实例；用同一账号或同一服务器地址重新添加，喜欢、歌单、下载记录会自动接回，不会重新计一遍。
会弹窗让你选择：把已下载文件一起搬过去，或者保留在原位置——两种都不会丢文件，只是二选一。
不建议。备份文件明文包含各来源的登录凭据，请像对待密码一样保管，不要随意分享或上传到公共位置。
macOS、Windows、Linux、iOS、Android、HarmonyOS 六个平台，见首页「取安装包」；安装包尚在准备中。