jiujiu-personal-player

项目概述

99新自用唱机是一个专门播放手机本地音频的 Android 播放器，主工程用 Vite + React + TypeScript，安装包由 Capacitor 封装。它针对「本地歌库」场景做了大歌库导入与 APE 按需解码，界面干净、权限克制，适合在主流平台上找不到想听的歌、习惯自己存文件的用户。

干净好看的本地唱机：几千首歌也能顺畅导入，APE 不转码直接听。

主要功能

• 本地播放：选择单首、多首音频文件，或递归导入整个文件夹
• 自动读取本地：走 MediaStore 查询读取媒体库，适合几千首歌的大歌库
• 多歌单管理：歌曲分组放入不同歌单，切换查看与播放范围
• APE 按需播放：首次播放时解码 .ape，不批量转码、不修改源文件
• 基础播放控制：播放、暂停、上下曲、进度、音量、顺序与随机播放
• 后台播放：接入 Android 原生播放、媒体通知与前台播放服务
• 桌面网页端：浏览器打开即可调试与补充使用

适用人群

• 手机里有本地歌曲库的用户
• 收藏 APE 无损的老歌党
• 反感广告与多余权限的用户
• 几千首歌规模的重度听歌者

快速上手

1. 从 GitHub Release 下载最新 APK 安装
2. 点歌单卡片上的加号添加歌曲，可选单首、多首或整个文件夹
3. 歌曲特别多时改用「自动读取本地」歌单读取媒体库
4. 点歌曲左侧播放按钮开始，在「当前播放」选择参与连续播放的歌单范围

核心优势

• 干净克制：无广告、权限精简，只做本地播放
• 大歌库友好：MediaStore 查询避免系统选择器卡顿黑屏
• 源文件无损：APE 按需解码，导入不改动原文件

系统要求

项目	要求
操作系统	Android（安装 APK 使用）
网页端	现代浏览器，主要用于调试
技术栈	Vite + React + TypeScript + Capacitor

注意事项

• 手动多选超过保护上限时会提示改用「自动读取本地」
• 递归导入的文件夹不会自动拆分成新歌单
• 项目为自用定位，以测试包形式分发