Skip to content

Commit 8fc6482

Browse files
committed
docs: 更新 README
1 parent a1a2ef6 commit 8fc6482

1 file changed

Lines changed: 58 additions & 11 deletions

File tree

README.md

Lines changed: 58 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,76 @@
11
# ChuChartManager
22

3-
CHUNITHM 谱面管理与预览工具
3+
CHUNITHM 谱面与资源管理工具,基于 Web UI
44

55
## 功能
66

7-
- **谱面扫描** — 扫描数据目录,列出所有曲目及难度信息
8-
- **格式转换** — C2S ↔ UGC 谱面格式互转
9-
- **音频处理** — BGM 导出为 MP3,支持 HCA/ADX 等音频格式
10-
- **封面导出** — 批量导出曲目封面图
7+
### 谱面管理
8+
- 扫描游戏数据目录,列出所有曲目及难度信息
9+
- 谱面元数据编辑(曲名、曲师、流派、等级、谱面设计)
10+
- 谱面导入/导出(C2S / UGC / SUS 格式互转)
11+
- 封面导入/导出、BGM 导出 MP3
12+
- 批量操作(批量修改属性、批量删除、批量导出封面/音频)
13+
- 跨 Option 复制曲目
14+
15+
### 资源管理
16+
- 浏览与管理所有自定义资源(称号、名牌、角色、地图图标、衣装、系统语音、舞台背景)
17+
- 创建自定义称号(含图片称号)、名牌、地图图标、衣装、系统语音
18+
- 角色创建(三图系统:全身/半身/头像,支持多变体)
19+
- DDS 提取器(从 AFB/SVO 文件提取 DDS 纹理)
20+
- 资源 ID 冲突检测
21+
22+
### 活动与地图
23+
- 活动/地图浏览与编辑
24+
- 地图背景 DDS 预览与导入/替换
25+
- 活动广告图预览与导入/替换
26+
- 创建自定义活动与地图
27+
- A000 数据只读保护
28+
29+
### 段位认定与登录奖励
30+
- 段位认定课程编辑
31+
- 登录奖励编辑
32+
33+
### 其他
34+
- Option 目录管理(创建、导入、删除、自制谱标记)
35+
- 多语言支持(中文 / English / 日本語)
36+
- 主题色跟随 MuNET-UI
1137

1238
## 项目结构
1339

1440
| 目录 | 说明 |
1541
|------|------|
16-
| `ChuChartManager/` | WPF 桌面端主程序(.NET 9) |
42+
| `ChuChartManager/` | WPF 桌面端主程序 + ASP.NET Core 后端 |
43+
| `ChuChartManager/Front/` | Vue 3 + TypeScript 前端(Vite + UnoCSS + MuNET-UI) |
1744
| `ChuChartManager.CLI/` | 命令行工具 |
18-
| `SonicAudioTools/` | CRIWARE 音频处理库(子模块,[Clansty/SonicAudioTools](https://github.com/Clansty/SonicAudioTools)|
45+
| `DDSExtractor/` | DDS 提取库(VB.NET 子模块) |
46+
| `MuNET-UI/` | UI 组件库(子模块) |
47+
| `MuConvert/` | 谱面格式转换库(子模块) |
48+
| `SonicAudioTools/` | CRIWARE 音频处理库(子模块) |
49+
| `XV2-Tools/` | Xenoverse 2 工具库(子模块) |
1950

2051
## 构建
2152

2253
需要:
23-
- .NET 9 SDK
24-
- Visual Studio 2022+ 或 `dotnet` CLI
54+
- .NET 10 SDK
55+
- Node.js 18+、pnpm
2556
- .NET Framework 4.8.1 Targeting Pack(SonicAudioTools 需要)
2657

2758
```bash
28-
dotnet build ChuChartManager.sln
29-
```
59+
# 初始化子模块
60+
git submodule update --init --recursive
61+
62+
# 构建前端
63+
cd ChuChartManager/Front
64+
pnpm install
65+
pnpm build
66+
67+
# 构建后端
68+
cd ../..
69+
dotnet build ChuChartManager.slnx
70+
```
71+
72+
## 致谢
73+
74+
- [MaiChartManager](https://github.com/AoAIAoA/MaiChartManager) — 架构参考
75+
- [MuNET-UI](https://github.com/AoAIAoA/MuNET-UI) — UI 组件库
76+
- [Chuni-Eventer](https://github.com/Swan416ya/Chuni-Eventer) — 活动/地图数据结构参考

0 commit comments

Comments
 (0)