Skip to content

AGENTS.md

Latest commit

 

History

History
94 lines (71 loc) · 3.35 KB

AGENTS.md

File metadata and controls

94 lines (71 loc) · 3.35 KB

AGENTS.md — CHUNITHM Modding Ecosystem

简称

简称 全名 仓库 说明
CCM ChuChartManager MuNET-OSS/ChuChartManager 谱面与资源管理工具（本仓库）
AppleChu AppleChu MuNET-OSS/AppleChu CHUNITHM 游戏 Mod（子模块）
Loader ChuModLoader MuNET-OSS/ChuModLoader Rust Mod 加载器（子模块）

项目结构

ChuChartManager/              # CCM 主仓库（monorepo）
├── ChuChartManager/          # .NET 10 WinForms + ASP.NET Core 后端
│   ├── Front/                # Vue 3 + TypeScript 前端（Vite + UnoCSS + MuNET-UI）
│   ├── Controllers/          # REST API
│   └── Resources/AppleChu/   # AppleChu manifest.toml + default_config.toml（与子模块同步）
├── ChuChartManager.CLI/      # 命令行工具
├── AppleChu/                 # 子模块 → MuNET-OSS/AppleChu
├── ChuModLoader/             # 子模块 → MuNET-OSS/ChuModLoader
├── MuNET-UI/                 # 子模块 → UI 组件库
├── MuConvert/                # 子模块 → 谱面格式转换
├── SonicAudioTools/          # 子模块 → CRIWARE 音频处理
├── XV2-Tools/                # 子模块 → ACB/AWB 音频工具
├── DDSExtractor/             # 子模块 → DDS 纹理提取
├── FreeMote/                 # 子模块 → E-mote PSB 工具链
├── FreeMote-SDK/             # 子模块 → E-mote WebGL 驱动
└── Packaging/                # MSIX 打包脚本

技术栈

项目 语言 框架
CCM 后端 C# .NET 10 + ASP.NET Core + WinForms
CCM 前端 TypeScript Vue 3 + Vite + UnoCSS + SASS
AppleChu Rust (nightly, i686) ChuModLoader SDK
Loader Rust version.dll proxy

规则

Git

  • 不要自动 push — 只在用户明确说 push 时才推
  • 不要未经确认 commit — 改完等用户确认
  • commit 带签名：git -c gpg.format=ssh commit -S -m "..."，如果失败就不带签名
  • commit message 用中文，conventional commits 格式，统一 commit 风格

AppleChu

  • ExitConfirm 和 DeviceLostFix 是 always_enabled
  • 代码注释只用于：逆向工程 magic number、COM vtable 偏移、汇编字节

CCM

  • Resources/AppleChu/manifest.toml 和 default_config.toml 必须与 AppleChu 子模块保持同步
  • 保存配置时基于 default_config.toml 模板用户，和 Mod 生成的配置文件保持一致
  • 配置文件不存在时自动从 default_config.toml 生成

前端

  • SASS 缩进语法（不是 SCSS）
  • 组件库：@munet/ui（MuNET-UI 子模块）
  • 深色玻璃主题：backdrop-filter: blur、rgba 半透明、var(--text-color) 派生颜色
  • 不引入新 npm 依赖除非必要

已知阻塞

功能 原因
自定义分辨率 Segatools 先于 mod 创建 D3D9 设备
FPS 显示 OSD 同上，Present hook 不生效

构建

# CCM 前端
cd ChuChartManager/Front && pnpm install && pnpm build

# CCM 后端
dotnet build ChuChartManager.slnx

# AppleChu
cd AppleChu && cargo build --release
# 输出: target/i686-pc-windows-msvc/release/AppleChu.dll

# Loader
cd ChuModLoader && cargo build --release

# MSIX 打包
.\Packaging\Build.ps1 -Mode Canary    # PowerShell
./Packaging/build.sh Canary            # Bash