115 lines
3.3 KiB
Markdown
115 lines
3.3 KiB
Markdown
# NcmMiao :tada:
|
||
[](https://github.com/Lkhsss/NcmMiao/actions/workflows/build.yml)
|
||
|
||
一个使用Rust语言编写的ncm文件解密工具（第一！😆）。
|
||
|
||
### 功能及特点
|
||
- 支持单一文件，多文件夹递归批量解密。
|
||
- 完善的日志功能
|
||
- Colorful
|
||
- 编译文件小，解密快
|
||
- [New!]支持自动添加封面！
|
||
|
||
## 编译
|
||
```
|
||
cargo build -r
|
||
```
|
||
|
||
## 使用
|
||
支持单一文件，多文件夹递归批量解密。
|
||
```
|
||
ncmmiao [OPTIONS]
|
||
Options:
|
||
-w, --workers <WORKERS> 最大线程数 约束逻辑在主函数
|
||
-i, --input <输入文件/文件夹> 需要解密的文件夹或文件
|
||
-o, --output <输出文件夹> [默认: NcmmiaoOutput]
|
||
```
|
||
|
||
~~输出文件夹在output。等我想写了再写命令行解析（bushi。~~ 写了写了
|
||
|
||
---
|
||
|
||
# TODO :construction:
|
||
- [x] 多线程支持
|
||
- [x] 自动添加封面
|
||
- [ ] 解密进度条
|
||
- [x] 命令行解析
|
||
- [x] 自定义输出文件夹
|
||
- [x] 计时功能
|
||
- [ ] 自动覆盖开关
|
||
|
||
---
|
||
|
||
# CHANGELOG
|
||
## [1.0.0] - 2024-1-27
|
||
### Features :sparkles:
|
||
- 初步完成解密函数。主程序成型
|
||
|
||
## [1.1.1] - 2024-2-1
|
||
### Features :sparkles:
|
||
- 完成批量解密
|
||
### Fixed :bug:
|
||
- 修正了提取音乐信息会有数据类型错误导致panic的问题
|
||
|
||
## [1.1.2] - 2024-2-5
|
||
### Fixed :bug:
|
||
- 修正了提取音乐信息时，部分歌曲信息提取失败的问题
|
||
- 修正了音乐数据解密失败的问题
|
||
## [1.1.3] - 2024-2-6
|
||
### Fixed :bug:
|
||
- 修正了部分音乐名称中含有不合法字符时创建文件失败的问题
|
||
## [1.1.4] - 2024-7-14
|
||
### Features :sparkles:
|
||
- 增加多线程支持！
|
||
> ~~目前固定4线程，还没写命令行参数。可以源代码修改线程数~~ 已于2.1.4版本修复~
|
||
### Fixed
|
||
- 优化代码结构
|
||
|
||
## [2.2.4] - 2024-11-17
|
||
### Features :sparkles:
|
||
- :ambulance:完整的多线程支持！可自定线程数！
|
||
- :ambulance:自动添加封面，解密文件不再需要musictag!
|
||
- :sparkles: 完整的命令行参数支持！
|
||
- :sparkles: 计时功能！
|
||
### Fixed
|
||
- :arrow_up: 升级依赖
|
||
- 优化保存文件逻辑，保存时间缩短到毫秒
|
||
### Refactoring
|
||
- :hammer: 重构代码！
|
||
---
|
||
|
||
# 附 - ncm文件结构
|
||
|信息|大小|作用|
|
||
|:-:|:-:|:-:|
|
||
|Magic Header|8 bytes|文件头|
|
||
|Gap|2 bytes||
|
||
|Key Length|4 bytes|RC4密钥长度，字节是按小端排序。|
|
||
|Key Data|Key Length|RC4密钥|
|
||
|Music Info Length|4 bytes|用AES128加密后的音乐相关信息的长度，小端排序。|
|
||
|Music Info Data|Music Info Length|Json格式音乐信息数据。|
|
||
|Gap|5 bytes||
|
||
|CRC校验码|4 bytes|图片的CRC32校验码，小端排序。|
|
||
|Image Size|4 bytes|图片的大小|
|
||
|Image Data|Image Size|图片数据|
|
||
|Music Data||音乐数据|
|
||
---
|
||
### Magic Header
|
||
### Key Data
|
||
用AES128加密后的RC4密钥。
|
||
1. 先按字节对0x64进行异或。
|
||
2. AES解密,去除填充部分。
|
||
3. 去除最前面'neteasecloudmusic'17个字节，得到RC4密钥。
|
||
### Music Info Data
|
||
Json格式音乐信息数据。
|
||
1. 按字节对0x63进行异或。
|
||
2. 去除最前面22个字节。
|
||
3. Base64进行解码。
|
||
4. AES解密。
|
||
6. 去除前面6个字节，后面数量为最后一个字节的字节数的垃圾数据，得到Json数据。
|
||
|
||
### Music Data
|
||
1. RC4-KSA生成S盒。
|
||
2. 用S盒解密(自定义的解密方法)，不是RC4-PRGA解密。
|
||
|
||
|