留一点时间，唱给自己听。
本地曲库 · 歌词跟唱 · 全屏氛围 · 音准练习 · 录音回听
An offline-first karaoke & singing practice app for Windows.
声屿由 晴辰云 QingChen Cloud 开源维护，适合想在家跟着歌词唱、反复练习难句、录下声音听进步的人。不需要账号，不依赖云端录音分析，歌曲、歌词、收藏与录音留在本机。
软件免费开源，不附商业歌曲曲库。 内置三首自制合成音色练习。自行导入可使用的原唱、伴奏和歌词；软件许可证不授予歌曲或歌词的使用权。
| 想做什么 | 声屿怎么帮你 |
|---|---|
| 直观地跟着唱 | 当前句 / 下一句、大字歌词、进句倒计时、行级扫色 |
| 找到 KTV 的感觉 | 全屏舞台、森林 / 暖光 / 深海主题、音乐律动、亮度调节 |
| 听原唱，再自己唱 | 切换已导入的同版本原唱与伴奏，不把静音当作去人声 |
| 练熟一句难唱的歌 | 点歌词定位、A/B 循环、唱后逐句反馈和重练 |
| 观察音高变化 | 实时音高轨道、参考音符、偏高 / 偏低提示、音准练习分 |
| 留下练习过程 | 本地麦克风干声录音、回听、文件导出 |
| 整理自己的曲库 | 单曲 / 文件夹导入、资源配对、收藏、搜索、待唱队列 |
| 换电脑或保留副本 | .shengyu 整库备份，含音频、歌词、参考与可选录音 |
| 获取新版本 | 公司 GitHub Releases，检查更新、安装版下载校验与确认安装 |
- 普通 LRC 只有行起点，扫色是行级估算，不是逐字精确时间。
- 跟唱完成度表示可靠音高样本的区间覆盖，不判断歌词、音准或唱功。
- 音准练习分需要可靠参考。自动参考是实验性周期音高分析，须试听确认；它不做人声分离，不保证从混音中识别主唱。
- 混音可能因置信度不足而不生成参考；静音、过载或样本不足保留「—」，不虚构分数。
- 麦克风、延迟、采样调度、音箱串音都会影响结果。这不是专业声乐考试或官方 KTV 评分。
完整算法及限制见 评分说明。
前往 GitHub Releases：
| 文件 | 使用方式 |
|---|---|
Shengyu-Setup-<版本>-x64.exe |
推荐：安装向导、桌面快捷方式、应用内下载并确认安装更新 |
Shengyu-Portable-<版本>-x64.exe |
免安装直接运行；检查新版后下载，退出旧版再替换 EXE |
SHA256SUMS.txt |
核对下载文件完整性 |
无需另装 Node.js 或手动启动服务。当前提供 Windows x64；其他平台尚未发布桌面包。发行包暂未签名，Windows 可能提示未知发布者，请使用公司 Releases 并核对散列，保持系统防护开启。
数据位于 %APPDATA%\ShengyuStudio。免安装版的曲库也保存在此目录，并不跟随 EXE 移动。换电脑前先备份；桌面与浏览器版数据独立。
- 带上自己的歌：导入音频，按需补充同版本伴奏和 LRC；也可先用内置练习。
- 戴上耳机，开始跟唱：点击「开始跟唱」，主动允许麦克风，看倒计时、歌词和声音反馈。
- 唱完再练一句：结束后查看结果、点薄弱句重练；需要保存声音时单独开启录音。
批量导入建议命名：
歌手 - 歌名.mp3
歌手 - 歌名_伴奏.wav
歌手 - 歌名.lrc
歌手 - 歌名.reference.json # 可选人工参考
歌曲宝网页适配是实验性可选入口，不是官方曲库 API 或稳定服务承诺。页面改版、验证、限频与素材可用性可能影响在线功能；已导入的本地曲目不依赖该网站继续播放。
左下角 「关于与更新」→「检查更新」，固定对接本仓库正式 Releases。
- 默认不后台下载，不在退出时自动安装。
- 安装版支持下载、SHA-512 校验、用户确认后打开安装向导。
- 免安装 / 解包版提供新版检查和官方下载入口，不改写运行中的 EXE。
- 播放、跟唱、未保存录音、导入或恢复时锁定安装，先保存当前工作。
- v0.5 及更早版本没有更新入口，需要手动升级一次到 v0.6.1 或更新版本；v0.6.0 安装版也需手动升级一次。
Node.js 22 或更高版本、npm，使用仓库锁文件：
git clone https://github.com/qingchencloud/shengyu-ktv.git
cd shengyu-ktv
npm ci
npm run build
node scripts/serve.mjs浏览器访问 http://127.0.0.1:5173/。开发模式用 npm run dev；Windows 也可使用仓库的 启动声屿.ps1 和 停止声屿.ps1。
npm test # 前端、音频、存储与跟唱逻辑
npm run test:server # 本地服务与曲源边界
npm run test:desktop # 桌面安全与更新状态机
npm run desktop:dev # 开发桌面版
npm run desktop:dist # 生成 Windows x64 安装/免安装包，不发布技术栈：React 19 · TypeScript · Vite · Electron · Web Audio API · IndexedDB。本地单声部周期性音高估计，无云端模型依赖；合成音频测试验证数据链路，不代替真人歌唱质量认证。
Shengyu is an open-source, local-first home karaoke and singing practice app by QingChen Cloud. Import your music, accompaniment and LRC lyrics; enjoy fullscreen ambient themes, line-synced sing-along guidance, A/B practice, live pitch feedback, local recording and library backup.
Windows x64 installers and portable builds are available in Releases. In-app updates use this repository. Pitch scores require a reliable melody reference; extraction from mixed music is experimental. Participation coverage is not pitch accuracy. No commercial song library, account or cloud audio upload is included.
贡献指南 · 安全反馈 · 隐私说明。请不要在公开 Issue 上传私人曲库备份、未授权音乐、凭据或含隐私的日志。
代码采用 MIT License。第三方组件遵循各自许可证，见 第三方声明。