Graphical UI
GUI：小屏图形产品界面
GUI 是 LoFiBox Zero 在 Linux framebuffer / X11 上的正式 presentation target。 它面向 320x170 这类小屏；界面优先保证当前状态、搜索、播放和队列可读。
主菜单
主菜单进入媒体库、搜索、Now Playing、Lyrics、EQ、Settings 等页面。
媒体库
媒体库来自 library index。GUI 显示 track / album / artist 等浏览入口，播放和排队动作最终映射到 runtime command。
搜索
搜索窗口是跨本地库和远程源的统一入口。输入关键字后，结果按来源分组；选择结果可以直接播放，也可以加入队列。
Now Playing
Now Playing 展示 runtime 投影中的当前曲目、播放状态、进度、频谱、来源和歌词摘要。 播放继续、暂停、下一首、上一首、seek 等动作由 runtime 控制。
Lyrics
歌词页面展示 runtime lyrics projection。同步歌词会突出当前行；纯文本歌词会作为普通歌词滚动展示。 无歌词时显示来源状态和后续 lookup / apply / writeback 的入口。
EQ / DSP
EQ 页面是 DSP domain 的图形投影。当前实现支持 10 段图形 EQ、启用/禁用、reset、preset 切换、实时热更新和内置 Remix 音效状态。
内置 EQ presets
| Preset | 适合场景 | 倾向 |
|---|---|---|
| Flat | 默认或校准检查 | 所有 band 归零，EQ disabled |
| Bass Boost | 耳机、低频不足的小音箱 | 提升 31/62/125Hz，轻微压高频 |
| Treble Boost | 暗声耳机、细节监听 | 提升 4k/8k/16kHz |
| Vocal | 人声、播客、访谈 | 提升 500Hz 到 2kHz 的可懂度 |
| Rock | 摇滚、现场感 | 增强低频和高频，中低频略收 |
| Pop | 流行音乐 | 低频和高频略提，保留中频清晰度 |
| Jazz | 爵士、人声、小编制 | 温和低频与空气感 |
| Classical | 古典、原声 | 轻微提升 1k 到 8kHz |
| Electronic | 电子、舞曲 | 低频和高频更强 |
| Podcast / Speech | 播客、语音内容 | 削低频噪声，提升语音频段 |
Remix 快捷键
按 R 在 OFF、Radio、Tape、Vinyl 之间循环。
这个快捷键会出现在应用内 F1 help 中，切换动作走 runtime command bus。
GUI 与 runtime 的边界
- GUI 不直接读取凭据，不显示明文 token / password。
- GUI 不直接控制 audio backend，而是提交播放、队列、EQ 等 runtime command。
- 关闭 GUI 不等于 stop；除非用户明确执行 stop，播放应该继续。
- 搜索、metadata、lyrics、artwork 等结果必须回到统一的产品对象。