docs(logger): 为 Logger 项目添加双语文档注释

为 LogHelper 及其部分类、LogHandler、LogOptions 和 InternalTempLogger
添加标准的双语文档注释（中文 + 英文），遵循项目文档规范：
- summary 使用中文描述
- remarks 包含英文翻译
- param/returns/typeparam 使用双语格式

Author: AlianBlank

GameFrameX.Foundation.Logger/Internal/InternalTempLogger.cs

@@ -38,23 +38,44 @@
 
 namespace GameFrameX.Foundation.Logger.Internal;
 
+/// <summary>
+/// 内部临时日志记录器，用于在日志系统初始化前临时存储日志事件。
+/// </summary>
+/// <remarks>
+/// This class provides a temporary logger that buffers log events before the main logging system is initialized.
+/// It allows log messages to be captured early in the application lifecycle and then flushed to the main logger once available.
+/// </remarks>
 internal sealed class InternalTempLogger : IDisposable
 {
     private readonly ILogger _logger;
     private readonly LoggerMemorySink _buffer;
     private bool _isFlushed;
     private bool _isDisposed;
 
+    /// <summary>
+    /// 获取日志记录器实例。 / Gets the logger instance.
+    /// </summary>
+    /// <value>The ILogger instance.</value>
     public ILogger Logger
     {
         get { return _logger; }
     }
 
+    /// <summary>
+    /// 获取日志内存缓冲区。 / Gets the log memory buffer.
+    /// </summary>
+    /// <value>The LoggerMemorySink instance.</value>
     public LoggerMemorySink Buffer
     {
         get { return _buffer; }
     }
 
+    /// <summary>
+    /// 初始化内部临时日志记录器的新实例。
+    /// </summary>
+    /// <remarks>
+    /// Creates a new internal temporary logger with a memory sink that captures all log events at verbose level.
+    /// </remarks>
     public InternalTempLogger()
     {
         _buffer = new LoggerMemorySink(OnLogEvent);
@@ -64,11 +85,23 @@ public InternalTempLogger()
                   .CreateLogger();
     }
 
+    /// <summary>
+    /// 处理日志事件的回调方法。 / Callback method for handling log events.
+    /// </summary>
+    /// <param name="evt">日志事件 / The log event</param>
     private void OnLogEvent(LogEvent evt)
     {
         Console.WriteLine(evt.RenderMessage());
     }
 
+    /// <summary>
+    /// 将缓冲的日志事件刷新到目标日志记录器。
+    /// </summary>
+    /// <param name="targetLogger">目标日志记录器实例 / The target logger instance</param>
+    /// <remarks>
+    /// Writes all buffered log events to the target logger. This method can only be called once;
+    /// subsequent calls will be ignored. Also ignores calls if the logger has been disposed.
+    /// </remarks>
     public void FlushTo(ILogger targetLogger)
     {
         if (_isFlushed || _isDisposed)
@@ -84,6 +117,13 @@ public void FlushTo(ILogger targetLogger)
         _isFlushed = true;
     }
 
+    /// <summary>
+    /// 释放临时日志记录器使用的资源。
+    /// </summary>
+    /// <remarks>
+    /// Disposes the internal logger if it implements IDisposable. This method can only be called once;
+    /// subsequent calls will be ignored.
+    /// </remarks>
     public void Dispose()
     {
         if (_isDisposed)
@@ -98,4 +138,4 @@ public void Dispose()
 
         _isDisposed = true;
     }
-}
+}

GameFrameX.Foundation.Logger/LogHandler.cs

@@ -43,13 +43,19 @@ namespace GameFrameX.Foundation.Logger;
 /// <summary>
 /// 日志处理器类，提供日志系统的初始化和配置功能
 /// </summary>
+/// <remarks>
+/// Provides initialization and configuration functionality for the logging system.
+/// </remarks>
 public static class LogHandler
 {
     private static bool _isInitSerilogDiagnosis;
 
     /// <summary>
     /// 启用 Serilog 的自动诊断
     /// </summary>
+    /// <remarks>
+    /// Enables Serilog's automatic diagnosis for debugging purposes.
+    /// </remarks>
     private static void SerilogDiagnosis()
     {
         if (_isInitSerilogDiagnosis)
@@ -64,12 +70,12 @@ private static void SerilogDiagnosis()
     /// <summary>
     /// 创建并返回一个基础的 Serilog 日志配置。
     /// </summary>
+    /// <returns>用于后续扩展的基础 LoggerConfiguration / The base LoggerConfiguration for subsequent extension</returns>
     /// <remarks>
-    /// - 启用上下文丰富（Enrich.FromLogContext），便于在日志中附带请求或业务上下文信息。
-    /// - 下调框架日志噪声：将 Microsoft 组件日志级别设为 Information，将 ASP.NET Core 设为 Warning，减少不必要的输出。
-    /// 该基础配置可在后续继续追加写入目标、丰富属性、最小日志级别等。
+    /// <para>- Enables context enrichment (Enrich.FromLogContext) to easily attach request or business context information to logs.</para>
+    /// <para>- Reduces framework log noise: sets Microsoft component log level to Information, ASP.NET Core to Warning, reducing unnecessary output.</para>
+    /// <para>This base configuration can be extended with additional write targets, enrichment properties, minimum log levels, etc.</para>
     /// </remarks>
-    /// <returns>用于后续扩展的基础 LoggerConfiguration。</returns>
     public static LoggerConfiguration CreateLoggerConfiguration()
     {
         return new LoggerConfiguration()
@@ -82,39 +88,40 @@ public static LoggerConfiguration CreateLoggerConfiguration()
     }
 
     /// <summary>
-    /// 控制台输出模板，用于格式化控制台日志输出。
+    /// 控制台输出模板，用于格式化控制台日志输出。 / Console output template for formatting console log output.
     /// </summary>
     private const string ConsoleOutputTemplate = "[{Timestamp:HH:mm:ss} {Level:u3}][{LogType}]{Message:lj}{NewLine}{Exception}";
 
     /// <summary>
-    /// 控制台输出模板，用于格式化控制台日志输出，包含标签名称。
+    /// 控制台输出模板，用于格式化控制台日志输出，包含标签名称。 / Console output template for formatting console log output with tag name.
     /// </summary>
     private const string ConsoleOutputTagNameTemplate = "[{Timestamp:HH:mm:ss} {Level:u3}][{LogType}-{TagName}]{Message:lj}{NewLine}{Exception}";
 
     /// <summary>
-    /// 文件输出模板，用于格式化文件日志输出。
+    /// 文件输出模板，用于格式化文件日志输出。 / File output template for formatting file log output.
     /// </summary>
     private const string FileOutputTemplate = "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}][{LogType}]{Message:lj}{NewLine}{Exception}";
 
     /// <summary>
-    /// 文件输出模板，用于格式化文件日志输出，包含标签名称。
+    /// 文件输出模板，用于格式化文件日志输出，包含标签名称。 / File output template for formatting file log output with tag name.
     /// </summary>
     private const string FileOutputTagNameTemplate = "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}][{LogType}-{TagName}]{Message:lj}{NewLine}{Exception}";
 
     /// <summary>
     /// 启动并配置日志系统。
     /// </summary>
-    /// <param name="logOptions">日志配置选项，包含日志级别、存储路径等配置信息。</param>
-    /// <param name="isDefault">是否设置为默认配置。</param>
-    /// <param name="configurationAction">自定义日志配置回调。</param>
-    /// <exception cref="ArgumentNullException">当 <paramref name="logOptions"/> 参数为 null 时抛出。</exception>
-    /// <exception cref="ArgumentException">当 <paramref name="logOptions.LogTagName"/> 为空或仅包含空白字符时抛出。</exception>
-    /// <exception cref="DirectoryNotFoundException">日志文件目录不存在且无法创建时抛出。</exception>
-    /// <exception cref="UnauthorizedAccessException">没有权限创建日志目录或写入日志文件时抛出。</exception>
-    /// <exception cref="Exception">初始化日志系统过程中发生的其他异常。</exception>
+    /// <param name="logOptions">日志配置选项，包含日志级别、存储路径等配置信息 / Log configuration options containing log level, storage path, and other configuration information</param>
+    /// <param name="isDefault">是否设置为默认配置 / Whether to set as default configuration</param>
+    /// <param name="configurationAction">自定义日志配置回调 / Custom log configuration callback</param>
+    /// <exception cref="ArgumentNullException">当 <paramref name="logOptions"/> 参数为 null 时抛出 / Thrown when <paramref name="logOptions"/> parameter is null</exception>
+    /// <exception cref="ArgumentException">当 <paramref name="logOptions.LogTagName"/> 为空或仅包含空白字符时抛出 / Thrown when <paramref name="logOptions.LogTagName"/> is empty or contains only whitespace</exception>
+    /// <exception cref="DirectoryNotFoundException">日志文件目录不存在且无法创建时抛出 / Thrown when log file directory does not exist and cannot be created</exception>
+    /// <exception cref="UnauthorizedAccessException">没有权限创建日志目录或写入日志文件时抛出 / Thrown when there is no permission to create log directory or write log files</exception>
+    /// <exception cref="Exception">初始化日志系统过程中发生的其他异常 / Other exceptions that occur during log system initialization</exception>
+    /// <returns>配置好的 ILogger 实例 / The configured ILogger instance</returns>
     /// <remarks>
-    /// <para>该方法会根据传入的 <paramref name="logOptions"/> 配置初始化日志系统，支持文件、控制台、MongoDB 及 Grafana Loki 等多种输出方式。</para>
-    /// <para>异常类型涵盖参数校验、目录创建、权限不足及日志系统初始化过程中的所有可能异常。</para>
+    /// <para>This method initializes the logging system based on the provided <paramref name="logOptions"/> configuration, supporting multiple output methods such as file, console, MongoDB, and Grafana Loki.</para>
+    /// <para>The exception types cover parameter validation, directory creation, insufficient permissions, and all possible exceptions during log system initialization.</para>
     /// </remarks>
     /// <example>
     /// <code>

GameFrameX.Foundation.Logger/LogHelper.Console.cs

@@ -37,23 +37,23 @@ namespace GameFrameX.Foundation.Logger;
 /// 日志帮助类的控制台显示部分
 /// </summary>
 /// <remarks>
-/// 提供了一系列静态方法用于在控制台中显示格式化的标题、配置信息和分隔线。
-/// 这是LogHelper类的部分类实现，专门处理控制台输出相关功能。
+/// Provides a series of static methods for displaying formatted titles, configuration information, and separators in the console.
+/// This is a partial class implementation of LogHelper, specifically handling console output related functionality.
 /// </remarks>
 public partial class LogHelper
 {
     /// <summary>
-    /// 控制台日志显示对象实例，用于处理所有控制台格式化输出
+    /// 控制台日志显示对象实例，用于处理所有控制台格式化输出 / Console log display object instance for handling all console formatted output
     /// </summary>
     private static readonly LogConsole LogConsoleObject = new();
 
     /// <summary>
     /// 设置控制台输出框架的宽度
     /// </summary>
-    /// <param name="length">框架宽度，必须大于0的整数值</param>
-    /// <exception cref="ArgumentOutOfRangeException">当length小于等于0时抛出</exception>
+    /// <param name="length">框架宽度，必须大于0的整数值 / The frame width, must be an integer greater than 0</param>
+    /// <exception cref="ArgumentOutOfRangeException">当 <paramref name="length"/> 小于等于0时抛出 / Thrown when <paramref name="length"/> is less than or equal to 0</exception>
     /// <remarks>
-    /// 此设置会影响所有后续的控制台输出格式，包括标题框、配置信息框和分隔线的宽度。
+    /// This setting affects the width of all subsequent console output formats, including title boxes, configuration information boxes, and separator lines.
     /// </remarks>
     public static void SetFrameLength(int length)
     {
@@ -64,13 +64,13 @@ public static void SetFrameLength(int length)
     /// <summary>
     /// 显示带边框的大标题，支持主标题和最多两个子标题
     /// </summary>
-    /// <param name="title">主标题文本，不能为null</param>
-    /// <param name="title2">第一个子标题文本，可选参数</param>
-    /// <param name="title3">第二个子标题文本，可选参数</param>
-    /// <exception cref="ArgumentNullException">当任何参数为null时抛出</exception>
+    /// <param name="title">主标题文本，不能为null / The main title text, cannot be null</param>
+    /// <param name="title2">第一个子标题文本，可选参数 / The first subtitle text, optional parameter</param>
+    /// <param name="title3">第二个子标题文本，可选参数 / The second subtitle text, optional parameter</param>
+    /// <exception cref="ArgumentNullException">当任何参数为null时抛出 / Thrown when any parameter is null</exception>
     /// <remarks>
-    /// 使用双线框字符（╔╗╚╝║）创建美观的标题显示效果。
-    /// 子标题只有在非空时才会显示，标题文本会自动居中对齐。
+    /// Uses double-line box characters (╔╗╚╝║) to create a beautiful title display effect.
+    /// Subtitles are only displayed when non-empty, and title text is automatically center-aligned.
     /// </remarks>
     public static void ShowMaxTitle(string title, string title2 = "", string title3 = "")
     {
@@ -83,12 +83,12 @@ public static void ShowMaxTitle(string title, string title2 = "", string title3
     /// <summary>
     /// 显示带标题的配置信息框
     /// </summary>
-    /// <param name="title">配置项标题，不能为null</param>
-    /// <param name="content">配置内容对象，将调用ToString()方法显示，不能为null</param>
-    /// <exception cref="ArgumentNullException">当任何参数为null时抛出</exception>
+    /// <param name="title">配置项标题，不能为null / The configuration item title, cannot be null</param>
+    /// <param name="content">配置内容对象，将调用ToString()方法显示，不能为null / The configuration content object, will call ToString() method to display, cannot be null</param>
+    /// <exception cref="ArgumentNullException">当任何参数为null时抛出 / Thrown when any parameter is null</exception>
     /// <remarks>
-    /// 创建一个带有标题栏的信息框，标题会嵌入到顶部边框中，内容显示在框内。
-    /// 适用于显示系统配置、参数设置等结构化信息。
+    /// Creates an information box with a title bar, where the title is embedded in the top border and the content is displayed inside the box.
+    /// Suitable for displaying system configuration, parameter settings, and other structured information.
     /// </remarks>
     public static void ShowOption(string title, object content)
     {
@@ -100,12 +100,12 @@ public static void ShowOption(string title, object content)
     /// <summary>
     /// 显示分隔线，可选择是否包含标题文本
     /// </summary>
-    /// <param name="title">分隔线中的标题文本，为空字符串时显示纯分隔线</param>
-    /// <exception cref="ArgumentNullException">当title为null时抛出</exception>
+    /// <param name="title">分隔线中的标题文本，为空字符串时显示纯分隔线 / The title text in the separator line, displays a pure separator line when empty</param>
+    /// <exception cref="ArgumentNullException">当 <paramref name="title"/> 为null时抛出 / Thrown when <paramref name="title"/> is null</exception>
     /// <remarks>
-    /// 当title为空时，显示纯分隔线；当title有内容时，标题会嵌入到分隔线中间。
-    /// 如果标题过长超出框架宽度，会使用简化的三等号包围格式。
-    /// 常用于分隔不同的信息区块或标记程序执行的不同阶段。
+    /// When title is empty, displays a pure separator line; when title has content, the title is embedded in the middle of the separator line.
+    /// If the title is too long and exceeds the frame width, a simplified triple-equals enclosing format is used.
+    /// Commonly used to separate different information blocks or mark different stages of program execution.
     /// </remarks>
     public static void ShowLineTitle(string title = "")
     {