docs: README.md 改为中文，英文移至 README.en.md

Applesaber · Applesaber · commit d6bbfb53cbfe · 2026-05-16T15:54:22.000+08:00
diff --git a/README.en.md b/README.en.md
@@ -0,0 +1,168 @@
+# ChuModLoader
+
+Mod loading framework for CHUNITHM. Proxies `version.dll` to load mod DLLs from `mods/` at runtime.
+
+> **[中文说明](README_cn.md)**
+
+> **v2.0.0** — Loader rewritten from C++ to Rust. Mod C ABI unchanged; existing mod DLLs work without modification. C++ mods remain fully supported via `chumod.h` — the header is maintained alongside the Rust codebase and will continue to receive updates. Legacy C++ loader code at tag [`v1.0.0-cpp`](https://github.com/Applesaber/ChuModLoader/tree/v1.0.0-cpp).
+
+## Features
+
+- `version.dll` proxy, forwards all 17 exports to the real system DLL
+- Auto-scans `mods/*.dll` on startup, no config needed
+- Optional Mod API (`chumod_init`) with memory read/write, AOB scan, inline hook, inter-mod IPC; plain DLLs work too
+- `mods.ini` to disable individual mods
+- Inline hooking via [retour](https://crates.io/crates/retour)
+- Written in Rust, mods can be written in Rust, C/C++, or any language that produces a Win32 DLL
+
+## Installation
+
+1. Build or download `version.dll`
+2. Place it in the game directory (next to `chusanApp.exe`)
+3. Drop mod DLLs into `mods/`
+4. Launch the game normally
+
+`mods/` directory and `mods.ini` are created automatically on first run.
+
+## Configuration
+
+`mods.ini` is auto-generated in the game directory. To disable a mod:
+
+```ini
+[mods]
+mod_name.dll=0
+```
+
+Mods not listed (or set to `1`) are loaded by default.
+
+### Per-Mod Configuration (v2)
+
+Each mod gets its own config file at `mods/config/<mod_name>.ini`, created automatically on first access. Mods read/write settings via the Config API:
+
+```c
+// read with defaults (file created automatically if missing)
+int fov = api->config_get_int("fov", 75);
+float bloom = api->config_get_float("bloom_intensity", 1.0f);
+int unlock = api->config_get_bool("unlock_fps", 0);
+
+// write (persisted to INI immediately)
+api->config_set_int("fov", 90);
+api->config_set_bool("unlock_fps", 1);
+```
+
+```ini
+; mods/config/my_mod.ini
+[config]
+fov=90
+bloom_intensity=1.0
+unlock_fps=true
+```
+
+## For Mod Developers
+
+See [Mod Development Guide](docs/mod-development.md) and [API Reference](docs/api-reference.md).
+
+### Quick Start (Rust)
+
+```rust
+use std::ffi::{c_char, c_void};
+
+#[repr(C)]
+pub struct ChuModInfo {
+    pub api_version: u32,
+    pub loader_version: *const c_char,
+    pub game_module: *const c_char,
+    pub game_base: usize,
+    pub game_size: u32,
+    pub text_base: usize,
+    pub text_size: u32,
+}
+
+#[repr(C)]
+pub struct ChuModAPI {
+    pub struct_size: u32,
+    pub log: Option<unsafe extern "C" fn(*const c_char, ...)>,
+    // ... other fields
+}
+
+#[no_mangle]
+pub extern "C" fn chumod_name() -> *const c_char {
+    b"My Rust Mod\0".as_ptr() as *const c_char
+}
+
+#[no_mangle]
+pub unsafe extern "C" fn chumod_init(
+    info: *const ChuModInfo,
+    _api: *const ChuModAPI,
+) -> i32 {
+    // your init code
+    0
+}
+
+#[no_mangle]
+pub extern "C" fn chumod_shutdown() {}
+```
+
+### Quick Start (C/C++)
+
+```c
+#include "chumod.h"
+
+CHUMOD_API const char* chumod_name() { return "My Mod"; }
+
+CHUMOD_API int chumod_init(const ChuModInfo* info, const ChuModAPI* api) {
+    api->log("game base = 0x%08X, .text = 0x%08X +0x%X",
+             info->game_base, info->text_base, info->text_size);
+    return 0;
+}
+
+CHUMOD_API void chumod_shutdown() { }
+```
+
+All exports are optional. Plain DLL with `DllMain` only also works.
+
+## Building
+
+Requires Rust toolchain with `i686-pc-windows-msvc` target:
+
+```bash
+rustup toolchain install nightly --target i686-pc-windows-msvc
+cargo +nightly build --release
+```
+
+Output: `target/i686-pc-windows-msvc/release/version.dll`
+
+> **C++ build**: The loader was previously built with CMake 3.15+ and MSVC (`cmake -B build -A Win32 && cmake --build build --config Release`).
+
+## How It Works
+
+Exploits Windows DLL search order (application directory before System32):
+
+1. Loads the real `version.dll` from System32, forwards exports via naked JMP
+2. Background thread waits 2s, scans `mods/*.dll`, calls `LoadLibrary` on each
+3. Parses PE headers for `.text` section info, calls `chumod_init` on API-exporting mods
+4. On exit, calls `chumod_shutdown` in reverse order, then `FreeLibrary`
+
+## Logging
+
+Output to `chusan_loader.log` and console if available. Format: `[HH:MM:SS.mmm] [loader] message`
+
+## Project Structure
+
+```
+ChuModLoader/
+├── include/chumod.h        # Mod API header (for C/C++ mods)
+├── src/
+│   ├── lib.rs               # version.dll proxy entry (DllMain + forward_dll)
+│   ├── loader.rs            # mod scanning & loading
+│   └── api_impl.rs          # API implementation (retour hooks, memory, IPC)
+├── docs/
+│   ├── mod-development.md
+│   └── api-reference.md
+├── Cargo.toml
+└── build.rs
+```
+
+## License
+
+MIT
diff --git a/README.md b/README.md
@@ -1,51 +1,51 @@
 # ChuModLoader
 
-Mod loading framework for CHUNITHM. Proxies `version.dll` to load mod DLLs from `mods/` at runtime.
+CHUNITHM 的 mod 加载框架。通过代理 `version.dll`，在游戏启动时自动从 `mods/` 目录加载 mod DLL。
 
-> **[中文说明](README_cn.md)**
+> **[English](README.md)**
 
-> **v2.0.0** — Loader rewritten from C++ to Rust. Mod C ABI unchanged; existing mod DLLs work without modification. C++ mods remain fully supported via `chumod.h` — the header is maintained alongside the Rust codebase and will continue to receive updates. Legacy C++ loader code at tag [`v1.0.0-cpp`](https://github.com/Applesaber/ChuModLoader/tree/v1.0.0-cpp).
+> **v2.0.0** — Loader 从 C++ 迁移到 Rust 重写。Mod 的 C ABI 接口不变，已有 mod DLL 无需修改。C++ mod 开发仍然完整支持 — `chumod.h` 头文件随 Rust 代码同步维护，持续更新。旧版 C++ 代码保留在 tag [`v1.0.0-cpp`](https://github.com/Applesaber/ChuModLoader/tree/v1.0.0-cpp)。
 
-## Features
+## 功能
 
-- `version.dll` proxy, forwards all 17 exports to the real system DLL
-- Auto-scans `mods/*.dll` on startup, no config needed
-- Optional Mod API (`chumod_init`) with memory read/write, AOB scan, inline hook, inter-mod IPC; plain DLLs work too
-- `mods.ini` to disable individual mods
-- Inline hooking via [retour](https://crates.io/crates/retour)
-- Written in Rust, mods can be written in Rust, C/C++, or any language that produces a Win32 DLL
+- `version.dll` 代理劫持，转发全部 17 个导出函数
+- 启动时自动扫描 `mods/*.dll`，无需配置
+- 可选的 Mod API（`chumod_init`），提供内存读写、AOB 扫描、inline hook、mod 间通信；不实现也能加载
+- `mods.ini` 按 mod 禁用
+- 基于 [retour](https://crates.io/crates/retour) 的 inline hook
+- Rust 编写，mod 可用 Rust、C/C++ 或任何能编译 Win32 DLL 的语言
 
-## Installation
+## 安装
 
-1. Build or download `version.dll`
-2. Place it in the game directory (next to `chusanApp.exe`)
-3. Drop mod DLLs into `mods/`
-4. Launch the game normally
+1. 构建或下载 `version.dll`
+2. 放到游戏目录（和 `chusanApp.exe` 同级）
+3. 把 mod DLL 丢进 `mods/`
+4. 正常启动游戏
 
-`mods/` directory and `mods.ini` are created automatically on first run.
+`mods/` 目录和 `mods.ini` 首次运行时自动创建。
 
-## Configuration
+## 配置
 
-`mods.ini` is auto-generated in the game directory. To disable a mod:
+`mods.ini` 自动生成在游戏目录，禁用 mod 时编辑：
 
 ```ini
 [mods]
 mod_name.dll=0
 ```
 
-Mods not listed (or set to `1`) are loaded by default.
+未列出（或设为 `1`）的 mod 默认加载。
 
-### Per-Mod Configuration (v2)
+### Mod 独立配置 (v2)
 
-Each mod gets its own config file at `mods/config/<mod_name>.ini`, created automatically on first access. Mods read/write settings via the Config API:
+每个 mod 在 `mods/config/<mod名>.ini` 有独立配置文件，首次访问时自动创建。通过 Config API 读写：
 
 ```c
-// read with defaults (file created automatically if missing)
+// 读取，不存在时返回默认值（文件自动创建）
 int fov = api->config_get_int("fov", 75);
 float bloom = api->config_get_float("bloom_intensity", 1.0f);
 int unlock = api->config_get_bool("unlock_fps", 0);
 
-// write (persisted to INI immediately)
+// 写入（立即持久化到 INI）
 api->config_set_int("fov", 90);
 api->config_set_bool("unlock_fps", 1);
 ```
@@ -58,11 +58,11 @@ bloom_intensity=1.0
 unlock_fps=true
 ```
 
-## For Mod Developers
+## Mod 开发
 
-See [Mod Development Guide](docs/mod-development.md) and [API Reference](docs/api-reference.md).
+详见 [Mod 开发指南](docs/mod-development_cn.md) 和 [API 参考](docs/api-reference_cn.md)。
 
-### Quick Start (Rust)
+### 快速上手（Rust）
 
 ```rust
 use std::ffi::{c_char, c_void};
@@ -82,7 +82,7 @@ pub struct ChuModInfo {
 pub struct ChuModAPI {
     pub struct_size: u32,
     pub log: Option<unsafe extern "C" fn(*const c_char, ...)>,
-    // ... other fields
+    // ... 其他字段
 }
 
 #[no_mangle]
@@ -95,15 +95,15 @@ pub unsafe extern "C" fn chumod_init(
     info: *const ChuModInfo,
     _api: *const ChuModAPI,
 ) -> i32 {
-    // your init code
+    // 初始化代码
     0
 }
 
 #[no_mangle]
 pub extern "C" fn chumod_shutdown() {}
 ```
 
-### Quick Start (C/C++)
+### 快速上手（C/C++）
 
 ```c
 #include "chumod.h"
@@ -119,46 +119,46 @@ CHUMOD_API int chumod_init(const ChuModInfo* info, const ChuModAPI* api) {
 CHUMOD_API void chumod_shutdown() { }
 ```
 
-All exports are optional. Plain DLL with `DllMain` only also works.
+所有导出函数可选。只用 `DllMain` 的普通 DLL 也能加载。
 
-## Building
+## 构建
 
-Requires Rust toolchain with `i686-pc-windows-msvc` target:
+需要 Rust 工具链和 `i686-pc-windows-msvc` target：
 
 ```bash
 rustup toolchain install nightly --target i686-pc-windows-msvc
 cargo +nightly build --release
 ```
 
-Output: `target/i686-pc-windows-msvc/release/version.dll`
+输出：`target/i686-pc-windows-msvc/release/version.dll`
 
-> **C++ build**: The loader was previously built with CMake 3.15+ and MSVC (`cmake -B build -A Win32 && cmake --build build --config Release`).
+> **C++ 构建**：之前使用 CMake 3.15+ 和 MSVC 构建（`cmake -B build -A Win32 && cmake --build build --config Release`）。
 
-## How It Works
+## 工作原理
 
-Exploits Windows DLL search order (application directory before System32):
+利用 Windows DLL 搜索顺序（程序目录优先于 System32）实现劫持：
 
-1. Loads the real `version.dll` from System32, forwards exports via naked JMP
-2. Background thread waits 2s, scans `mods/*.dll`, calls `LoadLibrary` on each
-3. Parses PE headers for `.text` section info, calls `chumod_init` on API-exporting mods
-4. On exit, calls `chumod_shutdown` in reverse order, then `FreeLibrary`
+1. 加载 System32 的真 `version.dll`，naked JMP 转发导出函数
+2. 后台线程等 2 秒，扫描 `mods/*.dll`，逐个 `LoadLibrary`
+3. 解析 PE 头拿 `.text` 段信息，对导出了 ChuMod API 的 mod 调用 `chumod_init`
+4. 退出时逆序调用 `chumod_shutdown`，再 `FreeLibrary`
 
-## Logging
+## 日志
 
-Output to `chusan_loader.log` and console if available. Format: `[HH:MM:SS.mmm] [loader] message`
+输出到 `chusan_loader.log`，有控制台时同步输出。格式：`[HH:MM:SS.mmm] [loader] message`
 
-## Project Structure
+## 项目结构
 
 ```
 ChuModLoader/
-├── include/chumod.h        # Mod API header (for C/C++ mods)
+├── include/chumod.h           # Mod API 头文件（C/C++ mod 使用）
 ├── src/
-│   ├── lib.rs               # version.dll proxy entry (DllMain + forward_dll)
-│   ├── loader.rs            # mod scanning & loading
-│   └── api_impl.rs          # API implementation (retour hooks, memory, IPC)
+│   ├── lib.rs                  # version.dll 代理入口（DllMain + forward_dll）
+│   ├── loader.rs               # mod 扫描加载
+│   └── api_impl.rs             # API 实现（retour hook、内存、IPC）
 ├── docs/
-│   ├── mod-development.md
-│   └── api-reference.md
+│   ├── mod-development_cn.md   # 开发指南
+│   └── api-reference_cn.md     # API 参考
 ├── Cargo.toml
 └── build.rs
 ```
diff --git a/README_cn.md b/README_cn.md
