快速上手
五步即可开始使用 MelodyFlow，从安装到进入沉浸播放页，整个流程不超过一分钟。
入口
首次安装并打开 App 时自动触发新手教程；如需复习，可在「设置」中重新触发完整的 11 步动态定位教程。
- 安装并打开 App，等待首屏加载完成。
- 在首页看到问候语与旋转唱片，28 根频谱条随节拍跳动。
- 点底部「搜索」Tab，输入一首想听的歌名。
- 在搜索结果中点目标歌曲，开始播放。
- 点中间的黑胶唱片，进入沉浸式播放页。
首页与导航
底部三 Tab 贯穿全局，首页以问候语与唱片为锚点，向下展开所有功能入口卡片。
底部三 Tab
首页 · 搜索 · 库，分别承载内容发现、精准检索与个人收藏管理。
首页布局（自上而下）
问候语（早 / 午 / 晚按系统时间自动切换） → 黑胶唱片 + 28 根频谱条 → 个性电台入口 → 最近播放 → 排行榜 → 心情电台 / 一起听歌 / 时光机等功能卡片入口。
沉浸式播放页
银河粒子动态壁纸、圆形黑胶唱片旋转、歌词颜色跟随封面渐变，共同构成 MelodyFlow 的视觉核心。
入口
任意歌曲开始播放后，点底部 mini 播放器，或直接点首页中间的黑胶唱片。
- 双击空白处唤起播放队列。
- 点黑胶唱片切换暂停 / 播放。
- 左右滑动切歌（横屏禁用滑动）。
歌词与卡片
全屏歌词以渐变文字呈现已唱部分；歌词卡片可将当前歌词生成为精美图片便于分享。
入口
在播放页上滑，或直接点歌词区域进入全屏歌词；长按歌词行可唤起歌词卡片生成。
搜索与发现
歌曲 / 歌手 / 专辑三 Tab 分类，未输入时展示热搜榜帮助发现新内容。
入口
底部「搜索」Tab。
- 切换顶部三 Tab 选择搜索类型：歌曲 / 歌手 / 专辑。
- 未输入关键词时显示热搜榜。
- 输入关键词后展示对应 Tab 下的搜索结果。
音乐库管理
收藏、历史、本地歌曲统一在「库」Tab 管理；播放历史按歌曲去重，本地歌曲自动扫描。
入口
底部「库」Tab。
- 收藏：点歌曲旁的心形图标加入收藏，再次点击取消。
- 历史：自动记录播放历史，按歌曲去重。
- 本地歌曲：自动扫描设备本地音乐，支持在设置中自定义扫描目录。
一起听歌
支持局域网与异地同步聆听：局域网下手机做主机、平板做客人（NanoWSD 内嵌服务器），异地通过 Supabase Realtime 同步。
入口
首页「一起听歌」卡片。
- 房主：进入卡片后选择「创建房间」，选择局域网或异地模式，生成房间码并分享给朋友。
- 客人：在卡片中选择「加入房间」，输入房主分享的房间码即可同步聆听。
听歌统计
汇总听歌时长、最爱歌手与流派分布，帮助了解自己的听歌偏好。
入口
首页相关统计卡片，或「设置」中的统计入口。
音乐占星
根据听歌偏好生成专属音乐星座画像，结合 MBTI 16 型与星座符号呈现。
入口
首页「音乐占星」卡片。
心情电台与时光机
心情电台按当下心境挑选电台；时光机按年代（80s / 90s / 00s / 10s / 20s）回溯华语音乐。
入口
首页「心情电台」与「时光机」卡片。
定时关闭与均衡器
定时关闭使用 AlarmManager 精准定时，Doze 模式不影响触发；均衡器支持自定义频段调节。
入口
播放页右上角「更多」菜单。
- 定时关闭：在更多菜单中选择「定时关闭」，可选取预设时长或自定义时间。
- 均衡器：在更多菜单中选择「均衡器」，调节各频段增益并保存预设。
设置与登录
登录支持网易云（手机 / Cookie / QR / 游客）与 QQ 音乐；缓存管理位于外部目录 /sdcard/MelodyFlow/cache/。
入口
首页右上角设置图标，或「库」Tab 顶部入口。
- 网易云登录：选择手机号 / Cookie / 扫码 / 游客四种方式之一。
- QQ 音乐登录：按引导完成授权。
- 缓存管理：在设置中查看与清理在线歌曲缓存，外部目录为 /sdcard/MelodyFlow/cache/。
跨源匹配
同一首歌在不同平台间自动匹配，确保搜索结果可正常播放。
入口
歌曲详情页中的跨源匹配入口。
赞赏支持
如果 MelodyFlow 给你带来了愉快的听歌体验，欢迎通过赞赏支持作者持续维护。
入口
设置 → 关于 → 赞赏支持。
联系与支持
扫码加入官方 QQ 群反馈问题与交流使用心得；源代码与开源协议见 GitHub。
