feat: 增加控制台输出开关

在默认配置和 manifest 中加入 EnableConsole，默认保持创建控制台的现有行为。

关闭开关时跳过 AllocConsole、标题和代码页设置，直接复用原进程的标准输出句柄。根据句柄类型分别使用 WriteConsoleW 和 WriteFile，兼容控制台、文件及管道重定向，并统一 AppleChu 控制台标识。

Author: clansty

manifest.toml

@@ -11,7 +11,7 @@ game_versions = ["2.45"]
 
 [ui]
 groups = [
-    { id = "common", label = { zh = "常用", en = "Common" }, sections = ["General", "SkipStartup", "FreePlay", "DisableTimer", "SkipMapAnimation"] },
+    { id = "common", label = { zh = "常用", en = "Common" }, sections = ["System", "General", "SkipStartup", "FreePlay", "DisableTimer", "SkipMapAnimation"] },
     { id = "gameplay", label = { zh = "游戏", en = "Gameplay" }, sections = ["UnlockTracks", "CustomTimers", "AllTimers999", "Autoplay"] },
     { id = "display", label = { zh = "显示", en = "Display" }, sections = ["Unlock120fps", "Bypass1080p", "Bypass120hz", "DpiAware", "FpsDisplay", "FrameLock"] },
     { id = "audio", label = { zh = "音频", en = "Audio" }, sections = ["ForceSharedAudio", "Force2chAudio"] },
@@ -21,6 +21,17 @@ groups = [
     { id = "ux", label = { zh = "体验", en = "UX" }, sections = ["ExitConfirm", "DeviceLostFix"] },
 ]
 
+[[config.sections]]
+id = "System"
+always_enabled = true
+label = { zh = "系统设置", en = "System" }
+    [[config.sections.entries]]
+    key = "EnableConsole"
+    type = "bool"
+    default = true
+    label = { zh = "开启控制台", en = "Enable console" }
+    description = { zh = "关闭后沿用启动进程的标准输出流", en = "Reuse the launcher's standard output stream when disabled" }
+
 [[config.sections]]
 id = "General"
 always_enabled = true

src/config.rs

@@ -29,6 +29,11 @@ Version = "1"
 ## =============================================================================
 
 [System]
+## 是否创建新的控制台窗口
+## true  = 创建控制台窗口（默认）
+## false = 不创建窗口，沿用启动进程的标准输出流
+EnableConsole = true
+
 ## 店内联机基准机/从机
 ## false = 基准机（单机，或局域网中的标准机，默认）
 ## true  = 从机（局域网中有 2-4 台主机时，非标准机的那些设为 true）

src/proxy/loader/console.rs

@@ -6,7 +6,7 @@ use windows_sys_loader::Win32::System::Console::{
 };
 
 use super::log::{write_banner_line, ANSI_CYAN};
-use super::state::LoaderState;
+use super::state::{LoaderState, OutputSink};
 use super::{hash, pe};
 
 const CP_UTF8: u32 = 65001;
@@ -15,30 +15,50 @@ const ANSI_GRAY: &str = "\x1b[37m";
 // TODO: 控制台图标（SetConsoleIcon / 嵌入 RT_ICON 资源）
 // TODO: 控制台字体大小/窗口尺寸调整
 
-pub unsafe fn init(state: &mut LoaderState) {
-    AllocConsole();
+pub unsafe fn init(state: &mut LoaderState, console_enabled: bool) {
+    if console_enabled {
+        AllocConsole();
+    }
 
     let handle = GetStdHandle(STD_OUTPUT_HANDLE);
     if handle.is_null() || handle == INVALID_HANDLE_VALUE {
         return;
     }
 
-    SetConsoleOutputCP(CP_UTF8);
-    SetConsoleTitleA(b"ChuModLoader\0".as_ptr());
+    if console_enabled {
+        SetConsoleOutputCP(CP_UTF8);
+        SetConsoleTitleA(b"AppleChu\0".as_ptr());
+    }
 
-    enable_ansi(handle);
-    state.console = handle;
+    state.output = match console_ansi_enabled(handle, console_enabled) {
+        Some(ansi_enabled) => OutputSink::Console {
+            handle,
+            ansi_enabled,
+        },
+        None => OutputSink::Stream(handle),
+    };
 
     print_banner(state);
 }
 
-unsafe fn enable_ansi(handle: windows_sys_loader::Win32::Foundation::HANDLE) {
+unsafe fn console_ansi_enabled(
+    handle: windows_sys_loader::Win32::Foundation::HANDLE,
+    configure: bool,
+) -> Option<bool> {
     let mut mode: u32 = 0;
-    if GetConsoleMode(handle, &mut mode) != 0 {
-        SetConsoleMode(
-            handle,
-            mode | ENABLE_PROCESSED_OUTPUT | ENABLE_VIRTUAL_TERMINAL_PROCESSING,
-        );
+    if GetConsoleMode(handle, &mut mode) == 0 {
+        return None;
+    }
+
+    if configure {
+        Some(
+            SetConsoleMode(
+                handle,
+                mode | ENABLE_PROCESSED_OUTPUT | ENABLE_VIRTUAL_TERMINAL_PROCESSING,
+            ) != 0,
+        )
+    } else {
+        Some(mode & ENABLE_VIRTUAL_TERMINAL_PROCESSING != 0)
     }
 }
 
@@ -57,7 +77,7 @@ fn print_banner(state: &mut LoaderState) {
     };
 
     write_banner_line(state, ANSI_CYAN, sep);
-    write_banner_line(state, ANSI_CYAN, &format!("ChuModLoader v{version} Nya~ "));
+    write_banner_line(state, ANSI_CYAN, &format!("AppleChu v{version} Nya~ "));
     write_banner_line(state, ANSI_GRAY, &format!("OS: {}", os_version()));
     write_banner_line(state, ANSI_GRAY, &format!("Hash Code: {hash_code}"));
     write_banner_line(state, ANSI_CYAN, sep);

src/proxy/loader/log.rs

@@ -1,10 +1,10 @@
 use std::ffi::{c_char, c_void};
 use std::io::Write;
 
-use windows_sys_loader::Win32::Foundation::INVALID_HANDLE_VALUE;
-use windows_sys_loader::Win32::System::Console::WriteConsoleA;
+use windows_sys_loader::Win32::Storage::FileSystem::WriteFile;
+use windows_sys_loader::Win32::System::Console::WriteConsoleW;
 
-use super::state::{LoaderState, STATE};
+use super::state::{LoaderState, OutputSink, STATE};
 
 extern "system" {
     fn GetLocalTime(st: *mut SYSTEMTIME);
@@ -76,17 +76,8 @@ pub fn write_banner_line(state: &mut LoaderState, ansi: &str, msg: &str) {
             let _ = f.flush();
         }
 
-        if state.console != INVALID_HANDLE_VALUE && !state.console.is_null() {
-            let colored = format!("{ANSI_TIME}[{time}]{ANSI_RESET} {ansi}{msg}{ANSI_RESET}\n");
-            let mut written = 0u32;
-            WriteConsoleA(
-                state.console,
-                colored.as_ptr(),
-                colored.len() as u32,
-                &mut written,
-                std::ptr::null(),
-            );
-        }
+        let colored = format!("{ANSI_TIME}[{time}]{ANSI_RESET} {ansi}{msg}{ANSI_RESET}\n");
+        write_output(state.output, &plain, &colored);
     }
 }
 
@@ -115,20 +106,50 @@ pub fn write_log_inner_level(state: &mut LoaderState, level: LogLevel, msg: &str
             let _ = f.flush();
         }
 
-        if state.console != INVALID_HANDLE_VALUE && !state.console.is_null() {
-            let colored = format!(
-                "{ANSI_TIME}[{time}]{ANSI_RESET} {ANSI_TAG}[loader]{ANSI_RESET} {body}[{label}] {msg}{ANSI_RESET}\n",
-                body = level.body_ansi(),
-                label = level.label(),
-            );
+        let colored = format!(
+            "{ANSI_TIME}[{time}]{ANSI_RESET} {ANSI_TAG}[loader]{ANSI_RESET} {body}[{label}] {msg}{ANSI_RESET}\n",
+            body = level.body_ansi(),
+            label = level.label(),
+        );
+        write_output(state.output, &plain, &colored);
+    }
+}
+
+fn write_output(output: OutputSink, plain: &str, colored: &str) {
+    match output {
+        OutputSink::None => {}
+        OutputSink::Console {
+            handle,
+            ansi_enabled,
+        } => {
+            let text = if ansi_enabled { colored } else { plain };
+            let utf16: Vec<u16> = text.encode_utf16().collect();
+            let length = u32::try_from(utf16.len()).unwrap_or(u32::MAX);
+            let mut written = 0u32;
+            // SAFETY: 初始化输出时已排除无效句柄，UTF-16 缓冲区在同步调用期间保持有效。
+            unsafe {
+                WriteConsoleW(
+                    handle,
+                    utf16.as_ptr(),
+                    length,
+                    &mut written,
+                    std::ptr::null(),
+                );
+            }
+        }
+        OutputSink::Stream(handle) => {
+            let length = u32::try_from(plain.len()).unwrap_or(u32::MAX);
             let mut written = 0u32;
-            WriteConsoleA(
-                state.console,
-                colored.as_ptr(),
-                colored.len() as u32,
-                &mut written,
-                std::ptr::null(),
-            );
+            // SAFETY: 初始化输出时已排除无效句柄，字符串缓冲区在同步调用期间保持有效。
+            unsafe {
+                WriteFile(
+                    handle,
+                    plain.as_ptr(),
+                    length,
+                    &mut written,
+                    std::ptr::null_mut(),
+                );
+            }
         }
     }
 }

src/proxy/loader/mod.rs

@@ -21,6 +21,7 @@ use windows_sys_loader::Win32::System::LibraryLoader::GetModuleHandleA;
 
 use chu_abi::{ChuModInfo, CHUMOD_API_VERSION};
 
+use crate::config::Config;
 use crate::proxy::api_impl;
 
 use self::log::{log_info, write_log_inner};
@@ -39,12 +40,16 @@ pub unsafe fn load_mods() {
     }
     state.loaded = true;
 
-    console::init(&mut state);
-
     let base_dir = match get_self_base_dir() {
         Some(d) => d,
         None => return,
     };
+    let config = Config::load(&base_dir);
+    console::init(
+        &mut state,
+        config.get_bool("System", "EnableConsole", true),
+    );
+
     state.base_dir = base_dir.clone();
     state.log_file = File::create(format!("{}\\chumod_loader.log", base_dir)).ok();
     write_log_inner(&mut state, &format!("loader start: base={}", base_dir));

src/proxy/loader/state.rs

@@ -2,12 +2,22 @@ use std::ffi::c_void;
 use std::fs::File;
 use std::sync::Mutex;
 
-use windows_sys_loader::Win32::Foundation::{HANDLE, INVALID_HANDLE_VALUE};
+use windows_sys_loader::Win32::Foundation::HANDLE;
 
 use chu_abi::{ChuModFrameFunc, ChuModReadyFunc, ChuModShutdownFunc};
 
 pub type HMODULE = *mut c_void;
 
+#[derive(Clone, Copy)]
+pub enum OutputSink {
+    None,
+    Console {
+        handle: HANDLE,
+        ansi_enabled: bool,
+    },
+    Stream(HANDLE),
+}
+
 pub struct LoadedMod {
     pub handle: HMODULE,
     pub on_ready: Option<ChuModReadyFunc>,
@@ -28,7 +38,7 @@ pub struct LoaderState {
     pub manifest_paths: Vec<String>,
     pub log_file: Option<File>,
     pub current_mod_log_file: Option<File>,
-    pub console: HANDLE,
+    pub output: OutputSink,
 }
 
 unsafe impl Send for LoaderState {}
@@ -43,7 +53,7 @@ impl Default for LoaderState {
             manifest_paths: Vec::new(),
             log_file: None,
             current_mod_log_file: None,
-            console: INVALID_HANDLE_VALUE,
+            output: OutputSink::None,
         }
     }
 }