🚀 快速上手：界面视觉密码与极客手势地图

欢迎使用 ZZ音乐 (ZZ Music)！这是一款专为极客与音乐发烧友打造的赛博朋克风格本地与私有云音乐播放器。

本文档将为你揭秘 App 中最核心的视觉指示器暗语、隐藏手势与高效操作，让你在 3 分钟内成为资深玩家。

🔍 一、读懂 App 的“视觉呼吸”：状态指示器暗语

ZZ音乐的界面元素融入了大量动态状态感知，无需繁琐的弹窗，界面自身就会“说话”：

界面元素	状态表现	隐藏含义 / 背后逻辑
顶部设置齿轮 ⚙️	霓虹粉 + 匀速旋转	App 冷启动或手动刷新音乐库时，说明后台有异步任务正在运行（全盘扫描音频、网盘同步比对、音频标签写入等）；赛博青且静止则代表空闲就绪。
工具箱图标 🧰	霓虹粉 vs 赛博青	跟随语音助手状态：语音助手已开启（后台监听中）为霓虹粉，未开启为赛博青。注意这与 EQ、睡眠定时器无关。
播放界面 · 歌曲信息按钮	霓虹粉 vs 赛博青	同上，同样跟随语音助手的开启状态，与主界面工具箱图标联动。
黑胶唱片中心数字	数字值 + 数字颜色	数字就是用户的声能成长等级（`0` ~ `7`），随听歌量动态晋升：`0 初启航` → `1 漫游者` → `2 调频师` → `3 引航员` → `4 声能家` → `5 聚变大师` → `6 赛博宗师` → `7 巅峰共鸣`。完整进度与活力值见工具箱「用户等级与活力值」。这个数字的颜色指示有无歌词：赛博青＝当前歌曲有歌词（内嵌或独立 `.lrc` 文件均可滚动），霓虹粉＝无歌词。注意区分：数字外圈那圈轴心圆环固定为赛博青，不随歌词状态变化，变色的是数字本身。
歌词界面 · 当前歌词行颜色	赛博青 vs 霓虹粉	赛博青：歌词来自音频文件内嵌；霓虹粉：歌词来自独立 `.lrc` 文件。一眼看出歌词来源，便于判断该改文件还是该换源。
标题动态流光	霓虹粉占比 + 流动速度	顶部 `ZZBond Music` 标题中霓虹粉所占的比例实时映射你近 3 天的听歌活力值 (Vitality)，速度同步反映活跃变化。

⚡ 二、隐藏极客手势：无需寻找按钮的盲操体验

为了追求极简沉浸的听歌体验，许多高频操作均可通过直觉手势直接触发：

1. 唱盘与全屏歌词瞬间切换

双指双击任意空白区域：在播放详情页，使用双指同时双击屏幕，可在「动感黑胶唱盘」与「高发光全屏沉浸歌词」之间瞬间切换。
从左往右滑动：在歌词界面，从屏幕左侧向右轻滑，即可平滑返回黑胶唱片主封面。
点击顶部大标题：单击顶部 ZZBond Music 标题，亦可快速切换唱盘与歌词。

2. 歌词时间轴精准定位

双击任意歌词行：在滚动歌词界面中，双击任意一句歌词，播放进度将毫秒级精准 Seek 跳转至该句歌词的起始时间点。

3. 大标题双击快捷通道（左右各管一件事）

顶部 ZZBond Music 标题按左右两半区分为两个独立快捷入口：

双击左半区「ZZBond」：强制唤醒语音助手，App 立即进入聆听与录音状态 —— 无论语音助手开关是否已打开都能唤醒。
双击右半区「Music」：开启或关闭语音助手的后台监听开关（切换常驻唤醒状态）。

🎵 三、智能歌词打分与排序引擎

ZZ音乐聚合了各大音乐平台的在线歌词库，并首创了多维加权智能匹配打分引擎：

智能评分算法 (满分 100 分)：
- 歌名契合度 (45分)：自动过滤 (Live)、[伴奏]、(Remix) 等修饰词噪声；
- 歌手契合度 (30分)：智能识别多歌手合唱与中英文别名；
- 时长精准加权 (25分)：与本地音频时长误差 <1s 给予满分，误差大则降权。
彩色匹配 Badge 徽章：
- 在歌词候选列表中，系统会按匹配度从高到低自动排序，并在条目右侧展示 98% 匹配 等彩色徽章及歌曲时长对比。
手动换源：
- 若自动匹配的歌词有偏差，长按播放页或在歌曲操作菜单中点击「重新匹配歌词」，即可自由挑选最契合的平台版本。

🎛️ 四、专业赛博 EQ 均衡器与防音爆保护

在工具箱中点击「音效与均衡器」可呼出专业音频调节面板：

流派自适应预设：内置流行、摇滚、爵士、古典、重低音、人声增强等多种专业预设，并支持根据歌曲流派自动匹配切换。
回放增益 (ReplayGain)：全曲库统一标准响度基准（-3.0dB），彻底解决切歌时“忽大忽小”的听觉痛点。
Smart Peak Guard 防破音：即使在低频重度增益下，内置的动态限幅器也会实时压制音频削顶失真，保护耳机与音响。

🔍 五、曲库分类与实时过滤搜索

多级精准分类：支持按全部歌曲、歌手、专辑、流派、文件夹快速浏览。
即时过滤搜索框：在分类列表底部内置常驻搜索栏，输入关键词即时过滤；匹配范围是歌曲名、歌手名与文件名（大小写不敏感的子串匹配）。
默认扫描目录：首次安装后自动扫描本地存储的 Music 与 Download/ZZBondCache（歌曲缓存目录）；其他目录需在设置 ->「曲库扫描与目录」中手动添加。
曲目批量操作：在各歌手、专辑行点击加号 (+)，可一键将该分类下的所有歌曲批量加入当前播放队列或指定歌单。

🧰 六、工具箱与系统设置速查

1. 工具箱六大入口

点击主界面右上角的工具箱图标 🧰（40dp 尺寸，颜色参见上文语音助手状态）展开：

入口	用途
用户等级与活力值	查看声能成长等级、近 3 天活力值、累计听歌量与成长进度
接收歌曲分享	输入 6 位提取码，接收他人通过 P2P 分享的歌曲
目录同步	管理网盘与本地目录之间的单向 / 双向增量同步任务
音效与均衡器	EQ 预设、ReplayGain 增益、Smart Peak Guard 防破音
歌曲排序	切换排序字段与升 / 降序
语音助手	语音助手总开关与唤醒灵敏度设置

2. 系统设置里值得知道的几项

本地存储：默认扫描 Music 与 Download/ZZBondCache（歌曲缓存目录），其余目录需手动添加。
网盘挂载：支持 WebDAV、Samba (SMB/CIFS)、阿里云盘；支持把网盘歌曲缓存到本地设备，也支持网盘与本地文件夹的单向或双向同步。
AI 配置：填入大模型 API 密钥后，可用于语音助手的语音识别、指令解析，以及 AI 歌曲标签补全。