Lofi Radio Player是一款基于 Electron 开发的桌面小部件音乐播放器，专为热爱 Lofi 音乐、需要专注工作学习的用户打造。无需本地音源、无需配置、即开即用，摆脱直播间束缚，让 LofiGirl 电台成为陪伴你身边的专注伙伴。
产品初心
Lofi 音乐被证实是最适合专注工作学习的音乐类型，LofiGirl 电台风靡全球，但国内用户仅能通过 B 站直播间收听，受弹幕、动画等干扰，且无法便捷控制。
这款播放器的核心目标：让专注不受干扰，让陪伴触手可及
- 不做「听歌工具」，只做「专注助手」
- 弥补电脑端「灵动岛」+「专注计时」的市场空缺
- 无需翻墙、无需配置，一键启动，安静陪伴
核心功能
1. 7×24 小时无限播放
- 同步 LofiGirl 电台内容，无间断播放适合专注的安静 Lofi 音乐
- 无循环歌单、不重复曲目，告别听腻的烦恼（区别于 QQ 音乐/网易云的有限歌单）
- 无需本地音源，联网即可使用，不占用本地存储
2. 双形态自由切换
| 形态 | 特点 | 适用场景 |
|---|---|---|
| 普通模式 | 旋转发光黑胶唱片质感，毛玻璃精美 UI | 桌面展示，追求视觉沉浸感 |
| Mini 模式 | 仿手机灵动岛设计，小巧胶囊形态 | 专注工作，避免视觉干扰，节省桌面空间 |
3. 全局快捷键控制
无需切换窗口，专注不中断，一键控制播放/暂停：
- Windows 系统：
ALT + Q - macOS 系统：
Option + Q
4. 桌面陪伴 + 专注计时
- 支持窗口置顶，可拖拽放置在屏幕任意位置，安静陪伴不打扰
- 内置专注计时器（类似 Forest/番茄 To Do），听歌+计时一站式完成
- 无动画、无弹幕、无任何多余干扰，只保留核心音乐和计时功能
5. 跨平台兼容
支持 Windows、macOS 系统，后续将适配 Linux 系统。
下载与使用
前置说明
- 无需安装额外依赖，下载对应系统安装包即可使用
- 无广告、无后台进程，不占用过多系统资源
安装步骤
- 前往 Releases 页面，下载对应系统的安装包：
- Windows：
.exe安装程序 - macOS：
.dmg镜像文件
- Windows：
- 安装并启动应用：
- macOS 用户提示：首次打开可能需要右键点击应用 → 选择「打开」，或在「系统设置 – 隐私与安全性」中允许运行未签名应用
- Windows 用户提示：直接双击安装包，按照向导完成安装即可
- 启动后自动开始播放音乐，无需额外配置，即开即用
基本操作
- 拖拽窗口：任意形态下，拖拽窗口边缘/标题栏即可移动位置
- 形态切换：点击窗口右下角「Mini」/「Normal」按钮切换双形态
- 播放/暂停：使用全局快捷键
ALT/Option + Q，或点击窗口内播放按钮 - 专注计时：在窗口内设置计时时长，点击「开始」即可启动专注计时
快捷键大全
| 快捷键 | 功能 | 支持系统 |
|---|---|---|
ALT + Q / Option + Q | 暂停/恢复播放音乐 | 所有系统 |
ESC | 退出 Mini 模式（返回普通模式） | 所有系统 |
Ctrl + W / Command + W | 关闭应用 | 所有系统 |
技术实现
核心技术栈
- 框架：Electron（跨平台桌面应用开发）
- UI 渲染：HTML + CSS + JavaScript（毛玻璃效果、黑胶旋转动画）
- 音频播放：Electron
webContents+ 网络音频流解析 - 全局快捷键：Electron
globalShortcutAPI - 数据存储：本地轻量存储（记录计时历史、窗口位置等）
项目结构（简要）
lofi-radio-player/
├── src/
│ ├── main/ # Electron 主进程（窗口管理、快捷键、音频控制）
│ ├── renderer/ # 渲染进程（UI 界面、双形态切换、计时功能）
│ ├── assets/ # 静态资源（黑胶图片、图标等）
│ └── utils/ # 工具函数（音频流解析、本地存储等）
├── package.json # 项目依赖与脚本配置
└── README.md # 项目说明文档
开发与构建
# 1. 克隆仓库
git clone https://github.com/your-username/lofi-radio-player.git
cd lofi-radio-player
# 2. 安装依赖
npm install
# 3. 启动开发环境
npm run dev
# 4. 构建生产安装包
npm run build
常见问题
- 启动后无声音怎么办？
- 检查电脑网络是否正常（需联网获取音频流）
- 检查电脑音量是否开启，应用内音量是否调至合适大小
- 重启应用尝试解决
- 全局快捷键无法使用？
- 确认快捷键是否与其他应用冲突（可在应用设置中自定义快捷键，后续版本支持）
- macOS 用户：确认应用已获得「辅助功能」权限（系统设置 – 隐私与安全性 – 辅助功能）
- 窗口无法置顶？
- 右键点击应用托盘图标，选择「窗口置顶」即可开启
产品思考与设计权衡
- 为什么不做本地音源和歌单选择？
- 核心目标是「专注」，而非「听歌」，过多操作会干扰用户专注状态
- 避免用户陷入「选歌纠结」，实现真正的「即开即用」
- 为什么采用毛玻璃 UI + 黑胶动画，又提供 Mini 模式？
- 满足不同用户的需求：部分用户需要视觉沉浸感，部分用户需要无干扰专注
- 双形态切换实现「颜值」与「实用」的平衡
- 为什么不加入弹幕、动画等内容？
- LofiGirl 直播间的动画和弹幕虽有氛围感，但会分散用户注意力
- 本产品的核心是「辅助专注」，而非「消费内容」，剔除所有非核心干扰项
- 为什么要加入专注计时功能？
- 听 Lofi 音乐的用户本质需求是「专注完成任务」，计时功能是天然的补充
- 弥补「音乐 APP」与「学习 APP」的割裂，实现一站式专注解决方案
未来规划
- 支持自定义音频流（添加更多 Lofi 电台选择）
- 支持快捷键自定义配置
- 增加专注计时历史统计与复盘功能
- 适配 Linux 系统
- 优化毛玻璃效果在不同系统下的兼容性
- 支持窗口透明度调节
评论