BetterNCM-Installer 插件管理器安装指南

BetterNCM-Installer 是一个专为网易云音乐 PC 客户端设计的插件管理器，能够一键安装 BetterNCM 插件系统，让你的网易云音乐获得更多强大功能。

项目概述

BetterNCM-Installer 采用 Rust 语言开发，提供了一个直观的图形界面，让用户可以轻松安装、更新和卸载 BetterNCM 插件系统。该项目支持 Windows 平台，兼容网易云音乐版本 2.10.2 及以上。

功能特性

• 一键安装：自动下载并安装最新版 BetterNCM
• 版本适配：智能检测网易云音乐版本并适配对应的 BetterNCM 版本
• 安装管理：支持安装、重装/更新、卸载操作
• 路径配置：可手动指定网易云音乐安装路径
• 数据管理：支持修改和重置插件数据存储路径
• 老版本兼容：提供老版本 BetterNCM 卸载功能

系统要求

• 操作系统：Windows 7 及以上
• 网易云音乐：版本 2.10.2 或更高
• 运行环境：需要安装 VC++ 2015-2022 运行时库

安装步骤

方法一：使用预编译版本

1. 从项目发布页面下载最新版本的 BetterNCM-Installer.exe
2. 运行安装程序，程序会自动检测网易云音乐安装路径
3. 点击"安装"按钮，等待安装完成
4. 重启网易云音乐即可使用

方法二：从源码编译

如果需要自定义功能或获取最新版本，可以从源码编译：

# 克隆代码仓库
git clone https://gitcode.com/gh_mirrors/be/BetterNCM-Installer
cd BetterNCM-Installer

# 安装 Rust nightly 工具链
rustup default nightly

# 编译项目
cargo +nightly build --release -Z build-std=core,alloc,std,panic_abort -Z build-std-features=panic_immediate_abort --target i686-pc-windows-msvc

编译完成后，可执行文件位于 target/i686-pc-windows-msvc/release/ 目录下。

使用说明

主界面功能

安装器主界面提供以下功能区域：

1. 版本信息：显示安装器版本和适配的 BetterNCM 版本
2. 网易云信息：显示检测到的网易云音乐版本和架构类型
3. 操作按钮：
   • 安装：首次安装 BetterNCM
   • 重装/更新：更新到新版本或重新安装
   • 卸载：移除已安装的 BetterNCM
   • 卸载老版本：移除旧版 BetterNCM
4. 路径设置：
   • 修改数据地址：更改插件数据存储路径
   • 重置数据地址：恢复默认数据存储路径
   • 手动指定网易云：手动选择网易云音乐安装目录

安装流程

1. 运行 BetterNCM-Installer
2. 程序会自动检测网易云音乐安装路径和版本
3. 检查显示的版本信息是否正确
4. 点击"安装"按钮开始安装
5. 等待下载和安装完成
6. 重启网易云音乐即可使用插件功能

技术架构

BetterNCM-Installer 基于以下技术栈构建：

• Rust：系统编程语言，提供高性能和内存安全
• Druid：跨平台 GUI 框架，提供现代化的用户界面
• WinAPI：Windows 系统接口，用于注册表操作和进程管理
• Tinyget：轻量级 HTTP 客户端，用于文件下载

项目结构

BetterNCM-Installer/
├── Cargo.toml          # 项目配置和依赖管理
├── src/
│   ├── main.rs         # 主程序入口和UI逻辑
│   ├── ncm_utils.rs    # 网易云音乐相关工具函数
│   └── localdata/      # 本地数据文件
├── scl-gui-widgets/    # 自定义GUI组件库
├── scl-gui-animation/  # 动画效果库
└── scl-macro/          # 宏定义库

常见问题

安装失败

如果安装过程中遇到问题，请检查：

1. 网易云音乐版本是否满足要求（≥2.10.2）
2. 是否有足够的磁盘空间和写入权限
3. 网络连接是否正常，能否访问下载服务器

插件不生效

安装完成后如果插件没有生效：

1. 确认网易云音乐已完全关闭并重新启动
2. 检查安装目录下的 msimg32.dll 文件是否存在
3. 查看系统安全软件是否阻止了插件加载

版本不兼容

如果提示版本不兼容：

1. 等待适配新版本的 BetterNCM 发布
2. 或手动下载兼容版本的 BetterNCMII.dll 文件

开发贡献

欢迎开发者参与项目贡献：

1. Fork 本项目
2. 创建特性分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request

许可证

本项目采用开源许可证，具体详见 LICENSE 文件。

支持与反馈

如果在使用过程中遇到问题或有改进建议，欢迎通过项目页面提交 Issue 或参与讨论。

享受你的增强版网易云音乐体验！