refactor: 重构模块化配置系统

通过 linkme 在链接期收集各模块声明的强类型 section，移除中央手写模板和运行时字符串 key 查询。

中央配置层统一负责 TOML 加载、版本与值域校验、Disabled 语义、未知项诊断和规范化序列化；无效配置会阻止 TLS 前内存修改。

迁移所有内置模块配置，并将 DeviceLostFix 合并进 D3D9Ex；System 的模式与刷新率改为类型化值，刷新率使用 60/120 用户语义。

补充配置注册、写回、校验、D3D9 合并及 early patch 回归测试，并更新 README。

Author: clansty

Cargo.toml

@@ -10,6 +10,7 @@ crate-type = ["cdylib"]
 
 [dependencies]
 chu-abi = { path = "chu-abi" }
+linkme = "0.3.36"
 toml = "0.8"
 once_cell = "1"
 retour = "0.4.0-alpha.4"

README.md

@@ -32,7 +32,7 @@
 
 ## 配置
 
-所有功能通过游戏目录下的 `AppleChu.toml` 控制。取消注释对应的 `[Section]` 即可启用该功能，并填写其下的键值
+所有功能通过游戏目录下的 `AppleChu.toml` 控制。默认关闭的栏目取消注释即可启用；默认开启的栏目可用 `Disabled = true` 关闭。程序会根据各模块声明的 schema 校验并规范化配置文件。
 
 > [!NOTE]
 > 如需图形化编辑，可使用 [ChuChartManager](https://github.com/MuNET-OSS/ChuChartManager)

src/aime/mod.rs

@@ -24,9 +24,71 @@ static AIME_DEVICE: Mutex<Option<SgNfcDevice>> = Mutex::new(None);
 static AIME_FD: AtomicUsize = AtomicUsize::new(0);
 static EXTERNAL: Lazy<Mutex<Option<ExternalAimeIo>>> = Lazy::new(|| Mutex::new(None));
 
+crate::config_section! {
+    pub(crate) struct AimeSectionConfig => AIME_CONFIG_SECTION {
+        section: "Aime",
+        order: 300,
+        default_enabled: true,
+        always_enabled: false,
+        hidden: false,
+        comment: "Aime 读卡器模拟",
+        fields: {
+            pub cvt_port: u32 = 2,
+            key: "cvtPort",
+            comment: "CVT 模式串口号";
+            pub sp_port: u32 = 3,
+            key: "spPort",
+            comment: "SP 模式串口号";
+            pub high_baudrate: bool = false,
+            key: "highBaud",
+            comment: "使用高波特率";
+            pub aime_path: String = String::from("aime.txt"),
+            key: "aimePath",
+            comment: "Aime 卡号文件";
+            pub felica_path: String = String::from("felica.txt"),
+            key: "felicaPath",
+            comment: "FeliCa 卡号文件";
+            pub authdata_path: String = String::from("DEVICE\\authdata.bin"),
+            key: "authdataPath",
+            comment: "认证数据文件";
+            pub aime_gen: bool = true,
+            key: "aimeGen",
+            comment: "缺少 Aime 卡号时自动生成";
+            pub felica_gen: bool = false,
+            key: "felicaGen",
+            comment: "缺少 FeliCa 卡号时自动生成";
+            pub scan: i32 = 0x0D,
+            comment: "读卡按键的虚拟键码";
+            pub gen: u8 = 3,
+            comment: "读卡器代数";
+            pub proxy_flag: u8 = 2,
+            key: "proxyFlag",
+            comment: "读卡代理标志";
+        }
+    }
+}
+
+crate::config_section! {
+    pub(crate) struct AimeIoConfig => AIME_IO_CONFIG_SECTION {
+        section: "AimeIo",
+        order: 301,
+        default_enabled: true,
+        always_enabled: true,
+        hidden: false,
+        comment: "外部 Aime IO DLL",
+        fields: {
+            pub path: String = String::new(),
+            comment: "所有架构共用的 DLL 路径";
+            pub path32: String = String::new(),
+            comment: "32 位 DLL 路径";
+            pub path64: String = String::new(),
+            comment: "64 位 DLL 路径";
+        }
+    }
+}
+
 #[derive(Clone)]
 pub struct AimeConfig {
-    pub enable: bool,
     pub cvt_port: u32,
     pub sp_port: u32,
     pub high_baudrate: bool,
@@ -115,13 +177,19 @@ impl AimeReader {
     }
 }
 
-pub fn init(api: &Api, config: &Config, port: u32) {
-    let cfg = load_config(config, &config.base_dir);
-    if !cfg.enable {
+pub fn init(api: &Api, config: &Config, is_sp: bool) {
+    let Some(section) = config.section::<AimeSectionConfig>() else {
+        return;
+    };
+    if !section.enabled {
         return;
     }
+    let cfg = load_config(&section, config.base_dir());
+    let port = if is_sp { cfg.sp_port } else { cfg.cvt_port };
 
-    let path = dll_path(config, "AimeIo", "aimeio");
+    let path = config
+        .section::<AimeIoConfig>()
+        .map_or_else(String::new, |config| dll_path(&config));
     if !path.is_empty() {
         match unsafe { ExternalAimeIo::load(&path) } {
             Ok(external) => {
@@ -254,48 +322,19 @@ fn aime_port() -> u32 {
     AIME_PORT.lock().map_or(4, |p| *p)
 }
 
-pub fn load_config(config: &Config, base_dir: impl AsRef<Path>) -> AimeConfig {
-    let path = config.get_string_alias(&[("Aime", "aime_path"), ("aime", "aimePath")], "aime.txt");
-    let aime_path = if Path::new(&path).is_absolute() {
-        PathBuf::from(&path)
-    } else {
-        base_dir.as_ref().join(path)
-    };
-    let authdata_path = resolve_path(
-        base_dir.as_ref(),
-        &config.get_string_alias(
-            &[
-                ("Aime", "authdata_path"),
-                ("Aime", "authdataPath"),
-                ("aime", "authdataPath"),
-            ],
-            "DEVICE\\authdata.bin",
-        ),
-    );
-    let felica_path = config.get_string_alias(
-        &[("Aime", "felica_path"), ("aime", "felicaPath")],
-        "felica.txt",
-    );
-    let felica_path = if Path::new(&felica_path).is_absolute() {
-        PathBuf::from(&felica_path)
-    } else {
-        base_dir.as_ref().join(felica_path)
-    };
-
+fn load_config(config: &AimeSectionConfig, base_dir: impl AsRef<Path>) -> AimeConfig {
     AimeConfig {
-        enable: config.get_bool_alias(&[("Aime", "enable"), ("aime", "enable")], true),
-        cvt_port: config.get_int_alias(&[("Aime", "cvt_port"), ("aime", "cvtPort")], 4) as u32,
-        sp_port: config.get_int_alias(&[("Aime", "sp_port"), ("aime", "spPort")], 3) as u32,
-        high_baudrate: config
-            .get_bool_alias(&[("Aime", "high_baudrate"), ("aime", "highBaud")], false),
-        aime_path,
-        felica_path,
-        authdata_path,
-        aime_gen: config.get_bool_alias(&[("Aime", "aime_gen"), ("aime", "aimeGen")], true),
-        felica_gen: config.get_bool_alias(&[("Aime", "felica_gen"), ("aime", "felicaGen")], false),
-        scan_key: config.get_int_alias(&[("Aime", "scan"), ("aime", "scan")], 0x0D) as i32,
-        gen: config.get_int_alias(&[("Aime", "gen"), ("aime", "gen")], 3) as u8,
-        proxy_flag: config.get_int_alias(&[("Aime", "proxy_flag"), ("aime", "proxyFlag")], 2) as u8,
+        cvt_port: config.cvt_port,
+        sp_port: config.sp_port,
+        high_baudrate: config.high_baudrate,
+        aime_path: resolve_path(base_dir.as_ref(), &config.aime_path),
+        felica_path: resolve_path(base_dir.as_ref(), &config.felica_path),
+        authdata_path: resolve_path(base_dir.as_ref(), &config.authdata_path),
+        aime_gen: config.aime_gen,
+        felica_gen: config.felica_gen,
+        scan_key: config.scan,
+        gen: config.gen,
+        proxy_flag: config.proxy_flag,
     }
 }
 
@@ -307,16 +346,16 @@ where
     guard.as_ref().map(call)
 }
 
-fn dll_path(config: &Config, upper: &str, lower: &str) -> String {
+fn dll_path(config: &AimeIoConfig) -> String {
     let arch_path = if cfg!(target_pointer_width = "64") {
-        config.get_string_alias(&[(upper, "path64"), (lower, "path64")], "")
+        &config.path64
     } else {
-        config.get_string_alias(&[(upper, "path32"), (lower, "path32")], "")
+        &config.path32
     };
     if !arch_path.is_empty() {
-        return arch_path;
+        return arch_path.clone();
     }
-    config.get_string_alias(&[(upper, "path"), (lower, "path")], "")
+    config.path.clone()
 }
 
 fn resolve_path(base_dir: impl AsRef<Path>, path: &str) -> PathBuf {

src/autoplay/autoplay.rs

@@ -2,7 +2,6 @@ use std::ffi::c_void;
 use std::ptr;
 use std::sync::atomic::{AtomicBool, AtomicI32, Ordering};
 
-use crate::config::Config;
 use crate::util::api::Api;
 
 static ENABLED: AtomicBool = AtomicBool::new(false);
@@ -38,9 +37,9 @@ extern "system" {
 }
 const VK_HOME: i32 = 0x24;
 
-pub fn init(api: &Api, config: &Config) {
+pub fn init(api: &Api, hotkey: &str) {
     unsafe { API_HANDLE = Some(*api) };
-    let hotkey = parse_hotkey_config(config).unwrap_or(VK_HOME);
+    let hotkey = parse_hotkey(hotkey).unwrap_or(VK_HOME);
     HOTKEY.store(hotkey, Ordering::Relaxed);
     RUNNING.store(true, Ordering::Relaxed);
 
@@ -463,14 +462,6 @@ fn jump_target(text: &[u8], text_base: usize, target: usize) -> Option<usize> {
     Some((target + 5).wrapping_add(rel as usize))
 }
 
-fn parse_hotkey_config(config: &Config) -> Option<i32> {
-    match config.get_value("Autoplay", "hotkey")? {
-        toml::Value::Integer(value) => i32::try_from(*value).ok().filter(|value| *value > 0),
-        toml::Value::String(value) => parse_hotkey(value),
-        _ => None,
-    }
-}
-
 fn parse_hotkey(value: &str) -> Option<i32> {
     let key = value.trim();
     if key.is_empty() {

src/autoplay/mod.rs

@@ -5,13 +5,37 @@ pub use autoplay::{is_enabled, was_used};
 use crate::config::Config;
 use crate::util::api::Api;
 
+crate::config_section! {
+    pub(crate) struct AutoplayConfig => AUTOPLAY_CONFIG_SECTION {
+        section: "Autoplay",
+        order: 180,
+        default_enabled: false,
+        always_enabled: false,
+        hidden: false,
+        comment: "自动游玩",
+        fields: {
+            pub hotkey: String = String::from("Home"),
+            comment: "自动游玩切换按键";
+        }
+    }
+}
+
 pub fn init_all(api: &Api, config: &Config) {
-    if config.is_enabled("Autoplay") {
-        autoplay::init(api, config);
+    if let Some(config) = config
+        .section::<AutoplayConfig>()
+        .filter(|config| config.enabled)
+    {
+        autoplay::init(api, &config.hotkey);
         autoplay::init_upload_guard(api);
     }
 }
 
+pub fn is_config_enabled(config: &Config) -> bool {
+    config
+        .section::<AutoplayConfig>()
+        .is_some_and(|config| config.enabled)
+}
+
 pub fn shutdown_all() {
     autoplay::shutdown_upload_guard();
     autoplay::shutdown();