NTmusic

NTmusic 是一个基于 Rust 引擎的独立音频播放器项目，源自 VCPChat 的设计启发进行的开发。利用纯Rust引擎和配套的自有音频解码协议获得极低的音频延迟,在音质上做到最接近原生采样的效果。

设计目标

• Rust-only 引擎：运行时不依赖 Python，提升稳定性与性能上限。
• 前后端解耦：统一 HTTP/WS 协议，UI 与引擎独立演进。
• 音质优先：重采样与 DSP 可持续补齐与升级（EQ/噪声整形等）。
• 多输入模式：本地文件为主，预留流媒体与系统捕获扩展。
• Windows 优先：先保障 Windows 体验，再推进跨平台。

项目概览

• apps/ntmusic-player：Electron UI（播放器界面与交互）。
• packages/audio-core/ntmusic_engine：Rust 音频引擎（crate 名为 ntmusic_engine，HTTP + WS）。
• packages/audio-core/bin：运行时依赖（如 ffmpeg.exe、soxr 等）。
• AppData：播放列表、封面、歌词等运行数据（不入库）。

下载与运行

• 便携版：到 GitHub Releases 下载 NTmusic-0.1.0-win.zip，解压后直接运行根目录 NTmusic.exe。
• 安装版：到 GitHub Releases 下载 NTmusic Setup 0.1.0.exe，安装后从开始菜单启动。
• 注意：仓库页面的 “Code → Download ZIP” 是源码包，不包含可执行程序。

新 UI 说明

• 默认启动为 React + Vite 新 UI（Spotify 风格布局 + 模块化结构）。
• 旧 UI 保留为 legacy fallback（仅当新 UI 构建产物缺失时自动回退，并显示 Legacy 标记）。
• 右侧面板为可切换标签：Lyrics / DSP / Analyzer。
• 引擎离线时新 UI 会显示告警并禁用播放与设备控制。
• Legacy UI 顶部会显示提示条，提醒迁移至新 UI。

音质与重采样说明

• 重采样质量档位：low / std / hq / uhq，用于控制引擎重采样质量与性能取舍。
• Auto 策略：当模式为 auto 时，low/std 优先 Rubato，hq/uhq 优先 SoXR（若可用）。
• 抖动处理：支持 TPDF 以及 TPDF NS1/NS2（噪声整形）档位，可在 Pro 模式中选择 16/24bit。

新 UI 构建与入口

• 构建命令：apps/ntmusic-player 下执行 npm run build:renderer 产出 renderer-dist/
• Electron 会优先加载 renderer-dist/index.html，无该目录时才回退 Legacy UI

开发定位

这个仓库是“播放器骨架 + 高性能引擎”的独立形态，不追求与旧版 100% 功能一致；优先保证结构清晰、可扩展和工程可维护。