Skip to content

README.zh-CN.md

Latest commit

 

History

History
255 lines (180 loc) · 11.9 KB

README.zh-CN.md

File metadata and controls

255 lines (180 loc) · 11.9 KB
Raw

NSMusicS 工作区

语言版本：English | 中文

NSMusicS 是一个面向本地音乐库、私有云音乐和自建流媒体生态的跨平台音乐客户端项目。
与之配套的服务端 NineSong 提供云原生后端能力，当前以音乐场景为核心，后续也会逐步扩展到视频、相册、笔记、文档等更完整的个人数字中心场景。

Ask DeepWiki

当前发布与路线图

截至 2026 年 4 月 9 日：

  • 当前上架微软商城的 Windows 版本，是 NSMusicS-Flutter 的闭源付费商业版。
  • 微软商城网页链接：https://apps.microsoft.com/detail/9N0RWS2TJXG1
  • Windows 商店深链：ms-windows-store://pdp/?productid=9N0RWS2TJXG1
  • Windows 版本当前支持 15 天免费试用。
  • 当前这个仓库发布到 GitHub Releases 的，仍然是开源的 Electron 过渡版本交付线。
  • 当前 Electron 与 Web 交付线属于过渡版本，用来承接下一代客户端矩阵正式落地前的这一段真空期。
  • 下一轮重构后的客户端版本，当前目标时间为 2026 年 5 月中旬左右。
  • 下一轮版本计划包含 React、React Native、Vue、Angular 四条客户端线。
  • 其中对应的 Electron / Web 客户端会分别遵循各自技术栈官方与社区推荐的最佳实现范式，而不是强行维持单一统一风格。
  • macOS / iOS 的 App Store 版本，以及 Android 的 Google Play 版本，是下一阶段的发布重点。
  • 产品方向仍然围绕本地音乐库、私有云音乐、主流自建音乐服务器兼容，以及与 NineSong 的更深度整合持续推进。

如果你想获取 Windows 商业正式版，优先从微软商城开始。
如果你想获取当前开源版本、查看源码、理解架构和路线图，就看这个仓库以及它的 GitHub Releases。

开源版与微软商城版

当前对外交付实际上分成了两条产品线。它们有关联，但不是同一个构建物，也不是同一个源码发布对象。

版本 当前定位 分发渠道 源码可见性 收费方式 说明
开源版 当前仓库对外公开的开源交付线，目前主要对应 Electron / Web 过渡版本 GitHub Releases、Docker 镜像、仓库源码 当前仓库公开可见 免费，受仓库许可证及相关项目条款约束 如果你要看代码、获取开源构建、跟进过渡版本和路线图，就看这一条
微软商城版 当前 NSMusicS-Flutter 的 Windows 商业发行线 微软商城 闭源私有代码，不在当前仓库公开 付费，Windows 当前带 15 天试用策略 这是面向普通用户的商城包，发布节奏与当前开源仓库分离

为什么是 NSMusicS

NSMusicS 面向的，不是只有一个文件夹的简单曲库，而是已经分散到多个来源的音乐资产。

  • 支持本地音乐库和私有云音乐场景。
  • 兼容 Navidrome、Jellyfin、Emby 等主流自建音乐服务器。
  • 目标不是做单一来源播放器，而是做统一音乐入口。
  • 更重视大规模曲库下的搜索、管理、标签、评分、播放列表和歌词体验。
  • 不只停留在基础播放，还覆盖无损格式、歌词精度、音效处理、沉浸式播放和主题个性化。

截至 2026 年 3 月 22 日，NSMusicS 主开源仓库已经达到 2265 GitHub Star。
整条产品线先通过开源版本建立口碑，再逐步推进现在的重构路线。

产品规划

当前规划重点包括：

  • 当前 Electron / Web 版本继续作为过渡版本，承接正式重构版上线前的发布需求。
  • 重构后的 NSMusicS 客户端矩阵，当前目标时间为 2026 年 5 月中旬左右。
  • 并行推进 React、React Native、Vue、Angular 四条客户端实现线。
  • 重构后的 Electron / Web 客户端会按照各自技术栈及其社区推荐实践分别实现。
  • 持续推进与 NineSong 深度联动的客户端与云端体验。
  • 持续扩展 Windows、macOS、iOS、Android、Linux，以及更后续的 HarmonyOS 方向。
  • 继续强化本地曲库、私有云音乐和更广泛的自建媒体工作流支持。

生态组件

NSMusicS Electron

当前桌面端方向覆盖：

  • Windows
  • macOS
  • Linux
  • Docker 相关桌面与 Web 邻接场景

当前状态：

  • 这是当前仓库真正对外发布的开源版本线。
  • 这是当前对外发布的过渡客户端线。
  • 在 React、React Native、Vue、Angular 新客户端矩阵正式发布前，它仍然承担现阶段交付任务。
  • 当前过渡期内，Web 镜像与 Docker 交付仍然是重要组成部分。

当前重点能力包括：

  • 音乐库管理
  • 兼容 NineSong、Navidrome、Jellyfin、Emby
  • 本地音乐库播放
  • 专业化播放体验
  • 国际化
  • 后台与托盘播放

NineSong 服务端

NineSong 是与 NSMusicS 配套的服务端基础。
相较于常规音乐服务器，它的方向更强调：

  • 更完整的音乐库管理
  • 更深入的元数据与标签工作流
  • 更贴近音乐场景的搜索体验
  • CUE 等更专业的播放与文件组织能力
  • 基于用户数据和元数据的推荐能力
  • 面向更完整个人数字中心的长期架构

公开 README 参考文档：

状态说明：

  • 按你提供的 NineSong 开源 README 快照，公开的 NineSong 后端仓库应更适合理解为“冻结的公开快照”，而不是持续更新的开源后端主仓库。

如果你想查看服务端的详细能力、部署包和后续路线，请直接参考 NineSong 仓库：

NSMusicS Flutter

Flutter 产品线代表下一阶段的重要跨平台客户端方向，主要面向：

  • Android
  • iOS
  • Windows
  • macOS

当前分发说明：

  • 目前微软商城里已经上架的 Windows 版本，属于这条 Flutter 产品线。
  • 但那个商城包是闭源付费商业版，不是当前仓库发布的开源构建物。
  • 它的代码线、打包方式、发布节奏和商店策略，都与这里的开源 Electron / Web 过渡版本分开管理。

当前路线图预计约两个月后推出重构版，移动端商店发布则会跟随 Windows 已上线节奏继续推进。

下载入口

截图

  • NSMusicS Electron 当前仍在持续开发中。
  • 当前预览如下：

版本矩阵

项目 状态 技术栈 平台 许可证
NSMusicS Desktop and Docker 过渡版本 Electron、Node.js、Vue、TypeScript、SQLite、Docker Windows、Linux、Docker、macOS AGPL-3.0，商业使用限制以项目说明为准
NineSong 公开快照（冻结） Go、MongoDB、Gin、JWT、SQLite、Docker Docker AGPL-3.0，商业使用限制以项目说明为准
NineSongAI 持续更新 Java、MongoDB、Spring Boot、MySQL、Docker Docker AGPL-3.0，商业使用限制以项目说明为准
NineSongPro 持续更新 Java、MongoDB、Spring Cloud Alibaba、MySQL、Docker Docker AGPL-3.0，商业使用限制以项目说明为准
NSMusicS For Flutter（微软商城商业版） Windows 商业版已上架，其它平台形态持续推进 Flutter、Dart 当前已上架 Windows；产品线目标覆盖 Android、iOS、macOS 专有闭源付费版
NSMusicS For HarmonyOS 规划中 ArkTS、ArkUI HarmonyOS AGPL-3.0，商业使用限制以项目说明为准
NSMusicS For Audio 规划中 PyTorch、Python、Jupyter、MATLAB Docker AGPL-3.0，商业使用限制以项目说明为准
NSMusicS For Knowledge Graph 规划中 NebulaGraph 或 Neo4j Docker AGPL-3.0，商业使用限制以项目说明为准
NSMusicS WPF 待重构 .NET、C#、SQLite Windows AGPL-3.0，商业使用限制以项目说明为准

社区

  • QQ 群 1：已满
  • QQ 群 2：610551734

赞助

开发说明

运行 NSMusicS Electron

详细开发文档：

cd NSMusicS\NSMusicS-Electron
# node -v 20.15.0
# npm -v 10.4.0
npm install
# 或者：
cnpm install

本地桌面播放场景需要额外安装 MPV：

  • MPV 安装地址：https://mpv.io/installation/
  • Windows 解压路径：NSMusicS\NSMusicS-Electron\resources\mpv-x86_64-20241124
  • macOS 解压路径：NSMusicS\NSMusicS-Electron\resources\mpv-x86_64-20241124

如果 better-sqlite3 需要手动重建支持：

cd NSMusicS/NSMusicS-Electron/node_modules/better-sqlite3
npm install electron-rebuild -D

如果你需要旧版 README 中那套完整的手动二进制替换方案，也请直接查看上面的开发文档。

运行应用：

cd NSMusicS\NSMusicS-Electron
npm run dev

构建应用：

cd NSMusicS\NSMusicS-Electron
npm run build

相关项目与依赖

说明

图片资源署名仍然保留在仓库与项目资源中。
如需查看当前图片引用和历史依赖致谢，请直接参考：

愿景

NSMusicS 目前仍然由作者独立开发，并持续进行重构。
长期目标，是让更多用户都能使用到免费、开源、易用，同时具备更强架构能力、更好互通性和更完整生态基础的音乐产品。

NSMusicS 的名称来自 “Nine Song Music Super”，灵感来源于《楚辞》与屈原。