Repository navigation
Releases: RonaldDeng/Rhine-Music-Demo
Release list
Rhine Music V0.6.1｜版本更新
Rhine Music V0.6.1｜版本更新
- 全新的沉浸歌词视图：支持本地与在线歌词，随播放逐行高亮。
- 歌词字体、字号和高亮位置可独立设置，横屏专辑详情更清晰。
- 优化界面动画与页面衔接，清理开发调试入口，修复其他细节问题。
本版为 macOS 本地源码版，下载 Rhine-Music-Demo-v0.6.1-macOS.zip 后完整解压，双击 启动音乐播放器.command。需 Node.js ≥22.12.0；完整解码与无缝播放需本机 FFmpeg／ffprobe，原生 CoreAudio 输出另需 Apple Command Line Tools。首次运行会安装依赖并构建；不附带歌曲。
源码清理、构建、完整功能检查、横竖屏浏览器验证、ZIP 文件及权限往返检查、独立解压安装与构建均已完成。README 配图复用 V0.5.0 抽象演示封面重新拍摄；不包含私人曲库或第三方歌词。真实 APE 样本本轮未提供，相关可选检查已明确跳过。
Rhine Music Demo v0.5.0
V0.5.0 以当前本地 V0.4.1 为基线，整理音乐库与设置，加入歌手网格和自己的 AI 专辑介绍工作流，并更新开场、盒体、灯光与源码分发范围。
- 音乐库与设置：主屏音乐库用于浏览和搜索；设置分为音乐库设置／画面与声音，切页保留输入、导入预览和滚动位置。
- 专辑介绍（实验）：导出单份
agent.md交给自己的联网 AI；支持分批、JSON 预览、版本核对、来源与作者展示、明确替换和自动备份。播放器无需 AI API Key，批量不放宽引用与许可要求。 - 开场与总览：中央英文标语衔接全新逐列三维编排，全片 7 秒，连续接入常态缓动；新增完整歌手网格和全比例开关，完善投影名牌显隐、物理身份和挤压退场，总览专辑保持齐平。
- 视觉与操作：收窄 CD 盒并统一列距，采用本地 B 文字封面，调整边距和横屏详情阅读区；新增可隐藏的歌曲衔接快捷按钮。
- 晨雾／月影：主题更名并保留原配色，修正晨雾灯光、磨砂边条和详情遮罩；移动灯带增益默认 11×、可调 0–20×，支持只重播三维入场。
- 维护与分发：修复字体准备和介绍请求容量边界，更新两项有安全公告的依赖；移除原 PV 输入采样、研究材料和旧产物，使用显式清单核验并打包。
真实专辑列、浏览记忆、三档歌曲衔接、浏览器／CoreAudio 及多格式解码是 V0.4.1 已有能力，继续保留。
下载附件 Rhine-Music-Demo-v0.5.0-macOS.zip，完整解压后进入 V0.5.0/，双击 启动音乐播放器.command。这是 macOS 源码包，不是 .app，不附带歌曲、依赖或预构建文件。需要 Node.js ≥22.12.0；完整解码与无缝播放需要 FFmpeg／ffprobe，原生输出另需 Apple Command Line Tools。附 SHA256SUMS.txt 供校验。
升级前停止旧版服务，新目录与旧目录同级时可继续使用旁边的 music-data-v3。保留旧目录，不要同时运行两个写入同一数据目录的服务。
发布回归、生产构建、分发检查、6 组浏览器离线 PCM 对照通过，原生设备测试使用零音量，依赖审计报告 0 漏洞；缺少官方 APE 样本的测试明确跳过。源码包另经解压安装、构建与本机服务检查，并与 Git 文件逐项核对。此前视觉检查的具体范围、未验证项及音频限制见验证记录；本版没有新增 Windows、独占输出或 Native DSD／DoP 支持。
Rhine Music Demo v0.4.1
Rhine Music V0.4.1 更新专辑浏览、界面动效与音频播放，继续提供 macOS 主线版本。
V0.4.1 补充更新：右下角帧率与主题旁新增版本号；MusicBrainz 移入默认收起的高级设置，保留原有资料与偏好；屏蔽页面右键菜单及图片拖拽。当前标签与下载包已同步更新。网页交互限制不构成系统截图或资源提取保护。
- 总览与导航：新增缩略图总览，歌手标签可展开“进入”按钮；搜索定位采用缓起缓停，完善标签和控件的进退场。
- 真实专辑列：每列独立居中，浏览只移动当前列，列首尾限制导航；高级设置新增默认开启的浏览位置记忆。
- 音频播放：提供本机多格式解码与 CoreAudio 设备选择；歌曲衔接支持“淡出但不淡入 / 淡出淡入 / 无缝播放”。浏览器与 CoreAudio 均提前排程下一首，原生按预归一 PCM 的实际帧数连续接续。
- 视觉与修复：更新磨砂专辑盒，统一开场与主界面品牌，标语改为“一张一张，慢慢听”；修复播放控件跳位、歌名尾括号裁切及搜索后经过原歌手列时的快速回位。
- 社区规范：主线不接收 PR，通过 Issue 反馈问题或登记独立衍生项目。原 PR #1 和完整 Git 历史保留，Windows 与其他开发方向收录到社区目录。
下载附件 Rhine-Music-Demo-v0.4.1-macOS.zip，完整解压后进入 V0.4.1/，双击 启动音乐播放器.command。这是源码包，不是 .app，也不附带歌曲。需要 Node.js ≥22.12.0；完整解码及无缝播放需要 FFmpeg / ffprobe，原生输出另需 Apple Command Line Tools。
无缝播放受下一首准备进度、文件大小与输出格式影响；无法满足时会提示并退回普通切换。浏览器单首 PCM WAV 上限 128 MiB，保守预留预算 384 MiB。输出为共享模式，不承诺 bit-perfect、独占输出或 Native DSD / DoP。
完整发行检查累计 320 项通过、1 项因未提供 APE 样本跳过；另完成浏览器 6 组真实离线 PCM 对照与原生零音量设备接续检查。源码包已通过独立文件核对、完整解压构建与本机服务检查，附 SHA-256 校验文件。
Rhine Music Demo v0.3.0
V0.3.0 改进三维专辑架布局、歌曲定位与暖昼玻璃效果，并将 Esc 返回控件恢复到熟悉的左上位置。
主要变化
- Esc 返回按钮在横屏、竖屏和超宽屏均位于 Rhine Music 标识下方；去掉顶部中文曲库统计，保留底部英文专辑／曲目统计。
- 点击顶部播放歌名可定位当前歌曲。所属专辑已经打开时直接滚动，否则先返回专辑架再打开目标；搜索与播放标题共用两次淡入淡出高亮，不改变播放状态。
- 横屏主页的专辑名称向右移动，取景增加顶部空间，超宽屏平滑调整构图。
- 修正标题 g／y／p／j 下伸笔画裁剪，复用已解码封面以减少换片时的占位闪跳。
- 暖昼玻璃壳体增加轻磨砂与边框可见度；深夜保留原参数，主题材质继续平滑过渡。
- 统一历史版本目录与文档编号，更新 README、设计说明、当前界面截图和发布检查记录；修正 Node 自动检查的模块加载问题。
下载与使用
仅支持 macOS。下载附件 Rhine-Music-Demo-v0.3.0-macOS.zip，完整解压得到 V0.3.0/，双击其中的 启动音乐播放器.command。需要 Node.js 22.12 或更新的 LTS 版本；首次启动联网安装依赖并构建。这是源码包，不是 .app 安装包，不附带歌曲。
在“音乐库”中填写自己的音乐文件夹绝对路径，保存并扫描。升级前停止旧服务；新旧工程位于同一父目录时，可继续使用旁边的 music-data-v3，避免多个服务同时写入该目录。
验证与来源
锁定依赖安装、TypeScript／生产构建、内容与视口检查、完整 check:music 均通过。界面回归采用隔离示例库；截图中的曲目为占位数据，不是个人曲库。未试听真实歌曲或验证全部音频格式、设备与最低 Node.js 环境。保留既有共享渲染包体积提示。
保留 RonaldDeng 音乐适配署名、上游 LBEILC / RhineLabUI 署名、MIT 文本与 Git 历史；第三方模型、字体、视觉及原 PV 采样按各自来源和许可说明处理。源码包不含个人曲库、缓存、索引、本机配置、依赖或构建产物。
使用说明 · 更新记录 · 设计说明 · 发布检查 · 版权与来源
附件 SHA256SUMS.txt 提供源码 ZIP 的 SHA-256 校验值；可在下载目录运行 shasum -a 256 -c SHA256SUMS.txt。
Rhine Music Demo v0.2.0
用三维玻璃 CD 盒浏览和播放本机音乐。v0.2.0 汇总 v0.1.1b 的详情交互改进，并完成搜索定位、文字、主题和封面渲染修订。
主要变化
- 搜索歌曲后进入所属专辑，平滑滚到曲目并高亮一次，不自动播放；详情中的搜索先返回专辑架，再移动并重新打开。
- 详情保持俯视，抽取与镜头同步；上一张／下一张直接沿队列换片，返回主页恢复正常浏览速度。模型取景与正文位置共用横竖屏分界。
- 多行标题沿用逐字滚动，新增第二行一起进入，修复 g／j 笔画残留；优化布局与封面缓存，修正深夜主页淡入结束时的层级跳变。
- 壳体保留 v0.1.1b 的轻磨砂透射，封面随场景受光；修复换片结束的封面缩放跳变。
- 歌曲淡入淡出默认开启：先淡出当前歌曲，再淡入下一首，不叠播。已有保存的开关选择继续沿用。
- 重写 README、DESIGN 和 CHANGELOG，记录导航栏、辅助标记、文字与相机等细节，配有本版本的实际演示截图。
下载与使用
仅支持 macOS。下载附件 Rhine-Music-Demo-v0.2.0-macOS.zip，完整解压后双击 启动音乐播放器.command。需要 Node.js 22.12 或更新的 LTS 版本；首次启动联网安装依赖并构建。它是源码包，不是 .app 安装包，不附带歌曲。
在“音乐库”中填写音乐文件夹的绝对路径，保存并扫描。升级前停止旧服务；新旧工程放在同一父目录时，可以复用旁边的 music-data-v3。避免两个服务同时写入同一数据目录。
版权与验证
音乐适配及后续修改署名 RonaldDeng；保留上游 LBEILC / RhineLabUI 的署名、MIT 许可和 Git 历史。代码 MIT 不自动覆盖字体、模型、原作视觉或 PV 采样，第三方来源及许可单独列明。私人曲库、封面缓存、索引、本机配置、依赖与构建产物不进入下载包。
TypeScript、生产构建、当前文档链接及发布文件检查通过；提供独立演示数据的界面截图。未进行全套自动化功能测试、真实音乐解码或设备性能基准。保留既有共享渲染包体积提示。
使用说明 · 完整更新记录 · 设计说明 · 版权与来源 · 发布检查
附件 SHA256SUMS.txt 提供下载包校验值。解压前可在下载目录运行 shasum -a 256 -c SHA256SUMS.txt。
设计图文补充 · 2026-09-30
查看新版 DESIGN：导航、字符与专辑交互 GIF。这是发行后的文档补充，原 v0.2.0 标签与下载包保持原发布快照。
Rhine Music Demo v0.1.1
修复竖屏模式下画面右侧残留的渐变底色：切入竖屏时约 650ms 平滑淡出，切回横屏时恢复。保留上下边缘和下方文字区域的底色；开启“减少动态效果”时直接切换。
本版本仍仅支持 macOS。下载 Rhine-Music-Demo-v0.1.1-macOS.zip 并完整解压，双击 启动音乐播放器.command；需要 Node.js 22.12 或更新的 LTS 版本，首次启动安装依赖并构建。
更新前停止旧版音乐服务。新版与旧工程放在同一父目录时，可继续使用旁边的 music-data-v3，避免两个服务同时写入同一数据目录。源码包不包含依赖、构建产物或个人曲库。
验证：TypeScript 与生产构建、样式静态复核、文档链接及 ZIP 完整性检查通过；保留既有共享渲染包体积提示。本次未追加浏览器或自动功能测试，竖屏观感由用户体验确认。
附件 SHA256SUMS.txt 提供下载包的 SHA-256 校验值。
Rhine Music Demo v0.1.0
Rhine Music Demo v0.1.0 将 V3 音乐播放器整理为 macOS 发布版本。
- 更新玻璃专辑盒与打开、收纳镜头，提供可跳过的三维进场。
- 支持流派／歌手／专辑名排列、独立单曲卡片、扫描后自动刷新及底部滑尺导航；保留
?nav=previous旧导航入口。 - 更新暖昼／深夜切换、歌名滚动、播放状态动效和竖屏布局。
- 清理发布文件并重写运行说明，保留上游来源、许可及必要资源。
下载附件 Rhine-Music-Demo-v0.1.0-macOS.zip，完整解压后双击 启动音乐播放器.command。需要 Node.js 22.12 或更新的 LTS 版本；首次启动会联网安装依赖并构建。这是源码运行包，不是 .app，不包含 node_modules、dist、歌曲或个人曲库缓存。
默认数据目录继续使用工程旁的 music-data-v3。从 V3 升级时先停止旧服务，把新版工程放在同一父目录即可复用；较早的 music-data 可通过 MUSIC_DATA_DIR 指定。不要同时运行两个服务写入同一数据目录。
**验证：**锁定依赖安装、TypeScript 与生产构建、启动器及服务脚本语法、文件清单和文档链接检查全部通过；构建仍有既有的共享代码包体积提示。本次未重新进行浏览器、真实设备或全格式播放验收。播放取决于浏览器解码支持，DSF／DFF 暂不能播放；在线专辑介绍的匹配与覆盖率取决于来源及网络条件。
完整操作、升级和来源说明见 README。
附件 SHA256SUMS.txt 提供 ZIP 的 SHA-256 校验值。具体检查与清理边界见 发布检查。