refactor: 切换至 winhttp 代理并重构 ABI/d3d9 架构 - 代理目标从 version.dll 切换为 winhttp.dll，利用 chusanApp.exe 对 winhttp 的静态导入实现自然加载；改用入口点劫持（EntryHijack）驱动初始化时机；抽出 chu-abi crate 承载共享 ABI 类型；删除独立 d3d9-proxy crate 合并进 loader/src/d3d9；升级 CHUMOD_API_VERSION 3 到 4 新增 d3d9 服务 API；新增 console/crash_ui/crash_zip/hash 模块增强崩溃报告；删除英文文档中文文档转为默认

Author: Applesaber

Cargo.toml

@@ -1,5 +1,5 @@
 [workspace]
-members = ["loader", "d3d9-proxy"]
+members = ["chu-abi", "loader"]
 resolver = "2"
 
 [profile.release]

README.en.md

@@ -1,47 +1,166 @@
 # ChuModLoader
 
-[English](README.en.md) | 简体中文
+<p align="center">
+  <strong>CHUNITHM Mod 加载框架</strong>
+</p>
 
-CHUNITHM Mod 加载框架。通过代理 `version.dll`，在游戏启动时自动从 `mods/` 目录加载 mod DLL。
+<p align="center">
+  <a href="#许可证"><img src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" alt="License"></a>
+  <img src="https://img.shields.io/badge/platform-Windows%20x86-lightgrey.svg" alt="Platform">
+  <img src="https://img.shields.io/badge/rust-nightly-orange.svg" alt="Rust">
+  <img src="https://img.shields.io/badge/ABI-v4-green.svg" alt="ABI Version">
+</p>
 
-## 功能
+通过代理 `winhttp.dll`，在游戏启动时自动从 `mods/` 目录加载 Mod DLL。框架使用 Rust 编写，Mod 可用 Rust 或 C/C++ 开发
 
-- `version.dll` 代理，转发全部 17 个系统导出
-- 自动扫描 `mods/*.dll` 加载
-- Mod API (C ABI)：内存读写、AOB 扫描、inline hook、RTTI vtable 查找、mod 间通信
-- TOML / INI 配置 API
-- 分级日志 (info/warn/error) + 控制台颜色 + per-mod 日志文件
-- 依赖拓扑排序
-- 崩溃保护 (catch_unwind)
-- 游戏版本检测 + min_loader_version 检查
-- 生命周期: init → on_ready → on_frame → shutdown
-- 热重载 (reload_mod API + reload.flag)
-- crash dump + 栈回溯
-- Rust 编写，mod 可用 Rust、C/C++ 或任何能编译 Win32 DLL 的语言
+---
+
+## 目录
+
+- [功能特性](#功能特性)
+- [工作原理](#工作原理)
+- [安装](#安装)
+- [目录结构](#目录结构)
+- [构建](#构建)
+- [Mod 开发](#mod-开发)
+- [文档](#文档)
+- [许可证](#许可证)
+
+## 功能特性
+
+| 分类 | 说明 |
+| --- | --- |
+| **DLL 代理** | 代理 `winhttp.dll`，转发系统 `winhttp.dll` 的全部导出，对游戏完全透明 |
+| **自动加载** | 启动时自动扫描并加载 `mods/*.dll` |
+| **内存操作** | 内存读写、填充、AOB 特征扫描 |
+| **Hook** | Inline hook（创建 / 启用 / 禁用 / 移除）、RTTI vtable 查找 |
+| **d3d9 服务** | 代理 Direct3D 9 设备，提供每帧回调、帧率锁定、设备 / 窗口句柄 |
+| **Mod 间通信** | 命名服务查找 + 基于 topic 的发布 / 订阅 |
+| **配置** | TOML / INI 单 Mod 配置读写 |
+| **日志** | 分级日志（info / warn / error）+ 控制台颜色 + per-mod 日志文件 |
+| **依赖管理** | 依赖声明 + 拓扑排序，确保加载顺序 |
+| **生命周期** | `init → on_ready → on_frame → shutdown` 完整生命周期 |
+| **热重载** | `reload_mod` API + `reload.flag` 文件触发 |
+| **崩溃保护** | `catch_unwind` 包裹回调 + SEH 过滤器 + crash dump + 栈回溯 |
+| **版本检测** | 游戏版本检测 + `min_loader_version` 兼容性检查 |
+
+## 工作原理
+
+`chusanApp.exe` 静态导入了系统 `winhttp.dll`。ChuModLoader 把自己编译成同名的 `winhttp.dll` 放在游戏目录，由于 DLL 搜索顺序优先于 `System32`，游戏启动时会自然加载它。框架再把所有导出转发给真正的系统 `winhttp.dll`，因此对游戏完全透明。
+
+加载后，框架并不会立刻初始化（此时游戏自身尚未运行）。它在 `DllMain` 中**劫持游戏 EXE 的入口点**：改写入口处的指令，使游戏真正开始执行时先跳转到框架的 bootstrap，完成 Mod 加载、crash dump 安装、d3d9 代理注入后，再恢复原始入口点继续运行游戏。
+
+```text
+chusanApp.exe 启动
+  └─ 加载游戏目录的 winhttp.dll（实为 ChuModLoader）
+       ├─ 转发系统导出 → System32\winhttp.dll
+       └─ DllMain：劫持游戏入口点
+            游戏入口点首次执行
+              └─ bootstrap
+                   ├─ 安装 crash dump / SEH
+                   ├─ 扫描 mods/*.dll，依赖拓扑排序
+                   ├─ 逐个驱动 Mod 生命周期
+                   │    init → on_ready → on_frame(循环) → shutdown
+                   ├─ 注入 d3d9 设备代理
+                   └─ 恢复原始入口点，游戏正常运行
+```
 
 ## 安装
 
-1. 构建或下载 `version.dll`
+1. 构建或下载 `winhttp.dll`
 2. 放到游戏目录（和 `chusanApp.exe` 同级）
-3. 把 mod DLL 放进 `mods/`
+3. 把 Mod DLL 放进 `mods/` 目录
 4. 正常启动游戏
 
+加载日志会写入 `chumod_loader.log`，单 Mod 日志位于 `mods/log/`，崩溃报告位于 `mods/crash/`。
+
+## 目录结构
+
+```text
+ChuModLoader/
+├─ Cargo.toml        # workspace（成员：chu-abi、loader）
+├─ rust-toolchain.toml
+├─ chu-abi/          # C ABI 定义（ChuModInfo / ChuModAPI 等共享类型）
+│  ├─ Cargo.toml
+│  └─ src/
+├─ loader/           # 加载器主体，编译产物为 winhttp.dll
+│  ├─ Cargo.toml
+│  ├─ build.rs       # 生成 winhttp 导出转发
+│  └─ src/
+│     ├─ lib.rs      # 入口、winhttp 代理、游戏入口点劫持
+│     ├─ loader/     # Mod 扫描、依赖排序、日志、生命周期、崩溃处理
+│     ├─ api_impl/   # ChuModAPI 函数表实现
+│     └─ d3d9/       # Direct3D 9 设备代理
+├─ include/
+│  └─ chumod.h       # C/C++ Mod 头文件
+└─ docs/             # 开发文档
+```
+
+游戏目录下框架运行时使用的布局：
+
+```text
+游戏目录/
+├─ chusanApp.exe
+├─ winhttp.dll                       # ChuModLoader
+├─ chumod_loader.log                 # 加载器日志
+└─ mods/
+   ├─ <mod>.dll                      # Mod 二进制
+   ├─ config/<mod_name>.toml         # 单 Mod 配置（或 .ini）
+   ├─ manifest/<mod_name>.toml       # 单 Mod manifest
+   ├─ log/<mod_name>.log             # 单 Mod 日志
+   ├─ crash/                         # 崩溃报告
+   └─ reload.flag                    # 创建即触发全部热重载
+```
+
 ## 构建
 
-需要 Rust nightly + `i686-pc-windows-msvc`：
+需要 Rust nightly 工具链 + `i686-pc-windows-msvc` target（仓库已通过 `rust-toolchain.toml` 固定）：
 
 ```bash
 cargo build --release
 ```
 
-输出: `target/i686-pc-windows-msvc/release/version.dll`
+输出文件：
+
+```text
+target/i686-pc-windows-msvc/release/winhttp.dll
+```
+
+> [!NOTE]
+> 游戏为 32 位程序，必须使用 `i686-pc-windows-msvc` target，不能用默认的 64 位 target。
 
 ## Mod 开发
 
-参见 [docs/mod-development.md](docs/mod-development.md) 和 [docs/api-reference.md](docs/api-reference.md)。
+最小的 C/C++ Mod 示例：
+
+```c
+#include "chumod.h"
+
+static const ChuModAPI* g_api = NULL;
+
+CHUMOD_API const char* chumod_name(void)    { return "Example Mod"; }
+CHUMOD_API const char* chumod_version(void) { return "1.0.0"; }
+
+CHUMOD_API int chumod_init(const ChuModInfo* info, const ChuModAPI* api) {
+    (void)info;
+    g_api = api;
+    g_api->log_info("Example Mod 已初始化");
+    return 0; // 返回 0 保留加载，非 0 跳过卸载
+}
+
+CHUMOD_API void chumod_shutdown(void) {
+    if (g_api) g_api->log_info("Example Mod 已卸载");
+}
+```
+
+将其编译为 32 位 Windows DLL 后放入 `mods/` 即可。完整的 Rust / C++ 示例、生命周期、配置、热重载等说明见开发文档。
+
+## 文档
 
-头文件: [include/chumod.h](include/chumod.h)
+- [Mod 开发指南](docs/mod-development.md) — 三种 Mod 编写方式、生命周期、配置、依赖、热重载、崩溃保护
+- [API 参考](docs/api-reference.md) — 完整 C ABI 函数表与导出说明
+- [C/C++ 头文件](include/chumod.h) — `chumod.h`
 
 ## 许可证
 
-Apache-2.0
+[Apache-2.0](LICENSE)

README.md

@@ -0,0 +1,8 @@
+[package]
+name = "chu-abi"
+version = "1.0.0"
+edition = "2021"
+license = "Apache-2.0"
+
+[lib]
+name = "chu_abi"

chu-abi/Cargo.toml

@@ -1,8 +1,26 @@
-use std::ffi::{c_char, c_void};
+//! ChuMod ABI
+//!
+//! ChuModLoader与 Mod 共同依赖此 crate
+//!
+//! ABI 安全约束 ：
+//! - 跨边界结构 `#[repr(C)]`，仅用定宽整型 / 裸指针；
+//! - 禁止跨边界使用 Rust `bool`/`Vec`/`String`/slice/trait object/无显式 repr 枚举；
+//! - chumod 回调表统一 `extern "C"`（i686 cdecl），不可改 stdcall，否则爆栈；
+//! - 仅 append-only 增长：永不重排字段、不缩类型、不改回调签名；
+//! - 新字段靠 `ChuModAPI::struct_size` 向后兼容
 
-pub const CHUMOD_API_VERSION: u32 = 3;
+#![no_std]
+#![allow(non_camel_case_types)]
+
+use core::ffi::{c_char, c_void};
+
+/// 当前 ABI 版本 v4：d3d9 服务
+pub const CHUMOD_API_VERSION: u32 = 4;
+
+/// Loader 版本
 pub const LOADER_VERSION: &str = "1.0.0";
 
+/// 传给 `chumod_init` 的运行时信息（append-only）
 #[repr(C)]
 pub struct ChuModInfo {
     pub api_version: u32,
@@ -14,22 +32,38 @@ pub struct ChuModInfo {
     pub text_size: u32,
     pub rdata_base: usize,
     pub rdata_size: u32,
-    pub game_version: *const c_char,
 }
 
+pub type ChuModInitFunc = unsafe extern "C" fn(*const ChuModInfo, *const ChuModAPI) -> i32;
+pub type ChuModReadyFunc = unsafe extern "C" fn();
+pub type ChuModFrameFunc = unsafe extern "C" fn();
+pub type ChuModShutdownFunc = unsafe extern "C" fn();
+pub type ChuModNameFunc = unsafe extern "C" fn() -> *const c_char;
+pub type ChuModDependsFunc = unsafe extern "C" fn() -> *const c_char;
+pub type ChuModStringFunc = unsafe extern "C" fn() -> *const c_char;
+
+/// 每次 Present 调用（FPS OSD 等） 参数为原生 `IDirect3DDevice9*`
+pub type ChuModPresentCallback = unsafe extern "C" fn(device: *mut c_void);
+/// 设备 Reset 事件 `phase`: 0 = Reset 前（释放 D3DPOOL_DEFAULT），1 = Reset 成功后（重建）
+pub type ChuModResetCallback = unsafe extern "C" fn(device: *mut c_void, phase: u32);
+
+/// Loader 提供给 mod 的 API 函数表（append-only；用 `struct_size` 判断可用字段）
 #[repr(C)]
 pub struct ChuModAPI {
     pub struct_size: u32,
+
     pub log: Option<unsafe extern "C" fn(*const c_char, ...)>,
+
     pub aob_scan: Option<unsafe extern "C" fn(usize, u32, *const u8, *const c_char) -> usize>,
     pub mem_read: Option<unsafe extern "C" fn(usize, *mut c_void, u32) -> i32>,
     pub mem_write: Option<unsafe extern "C" fn(usize, *const c_void, u32) -> i32>,
     pub mem_fill: Option<unsafe extern "C" fn(usize, u8, u32) -> i32>,
-    pub hook_create:
-        Option<unsafe extern "C" fn(*mut c_void, *mut c_void, *mut *mut c_void) -> i32>,
+
+    pub hook_create: Option<unsafe extern "C" fn(*mut c_void, *mut c_void, *mut *mut c_void) -> i32>,
     pub hook_enable: Option<unsafe extern "C" fn(*mut c_void) -> i32>,
     pub hook_disable: Option<unsafe extern "C" fn(*mut c_void) -> i32>,
     pub hook_remove: Option<unsafe extern "C" fn(*mut c_void) -> i32>,
+
     pub register_service: Option<unsafe extern "C" fn(*const c_char, *mut c_void) -> i32>,
     pub get_service: Option<unsafe extern "C" fn(*const c_char) -> *mut c_void>,
     pub publish: Option<unsafe extern "C" fn(*const c_char, *mut c_void, u32) -> i32>,
@@ -39,7 +73,9 @@ pub struct ChuModAPI {
             Option<unsafe extern "C" fn(*const c_char, *mut c_void, u32)>,
         ) -> i32,
     >,
+
     pub rtti_find_vtable: Option<unsafe extern "C" fn(*const c_char) -> usize>,
+
     pub config_get_int: Option<unsafe extern "C" fn(*const c_char, i32) -> i32>,
     pub config_get_float: Option<unsafe extern "C" fn(*const c_char, f32) -> f32>,
     pub config_get_bool: Option<unsafe extern "C" fn(*const c_char, i32) -> i32>,
@@ -49,25 +85,28 @@ pub struct ChuModAPI {
     pub config_set_float: Option<unsafe extern "C" fn(*const c_char, f32) -> i32>,
     pub config_set_bool: Option<unsafe extern "C" fn(*const c_char, i32) -> i32>,
     pub config_set_string: Option<unsafe extern "C" fn(*const c_char, *const c_char) -> i32>,
+
     pub log_info: Option<unsafe extern "C" fn(*const c_char)>,
     pub log_warn: Option<unsafe extern "C" fn(*const c_char)>,
     pub log_error: Option<unsafe extern "C" fn(*const c_char)>,
+
     pub log_path: *const c_char,
+
     pub toml_section_exists: Option<unsafe extern "C" fn(*const c_char) -> i32>,
     pub toml_get_bool: Option<unsafe extern "C" fn(*const c_char, *const c_char, i32) -> i32>,
     pub toml_get_int: Option<unsafe extern "C" fn(*const c_char, *const c_char, i32) -> i32>,
     pub toml_get_float: Option<unsafe extern "C" fn(*const c_char, *const c_char, f32) -> f32>,
     pub toml_get_string: Option<
         unsafe extern "C" fn(*const c_char, *const c_char, *mut c_char, u32, *const c_char) -> i32,
     >,
+
     pub get_manifest_path: Option<unsafe extern "C" fn() -> *const c_char>,
+
     pub reload_mod: Option<unsafe extern "C" fn(*const c_char) -> i32>,
-}
 
-pub type ChuModInitFunc = unsafe extern "C" fn(*const ChuModInfo, *const ChuModAPI) -> i32;
-pub type ChuModReadyFunc = unsafe extern "C" fn();
-pub type ChuModFrameFunc = unsafe extern "C" fn();
-pub type ChuModShutdownFunc = unsafe extern "C" fn();
-pub type ChuModNameFunc = unsafe extern "C" fn() -> *const c_char;
-pub type ChuModDependsFunc = unsafe extern "C" fn() -> *const c_char;
-pub type ChuModStringFunc = unsafe extern "C" fn() -> *const c_char;
+    pub register_present_callback: Option<unsafe extern "C" fn(Option<ChuModPresentCallback>) -> i32>,
+    pub register_reset_callback: Option<unsafe extern "C" fn(Option<ChuModResetCallback>) -> i32>,
+    pub set_frame_lock: Option<unsafe extern "C" fn(u32) -> i32>,
+    pub get_d3d9_device: Option<unsafe extern "C" fn() -> *mut c_void>,
+    pub get_game_hwnd: Option<unsafe extern "C" fn() -> usize>,
+}