docs(database/mongo): 添加双语文档注释

为 MongoDB 数据库模块的所有公共 API 添加标准双语文档注释：
- CacheState: 缓存状态基类
- MongoDbContext: 数据库上下文
- MongoDbService: 主服务类及各 partial 类
- MongoDbHealthCheck: 健康检查实现

注释规范：summary 使用中文，remarks 使用英文，param/returns 使用双语格式

Author: AlianBlank

GameFrameX.DataBase.Mongo/CacheState.cs

@@ -35,15 +35,21 @@
 namespace GameFrameX.DataBase.Mongo;
 
 /// <summary>
-/// 缓存数据对象
+/// 缓存数据对象。
 /// </summary>
+/// <remarks>
+/// Cache data object.
+/// </remarks>
 [BsonIgnoreExtraElements(true, Inherited = true)]
 public class CacheState : BaseCacheState
 {
     /// <summary>
-    /// 将对象序列化转换为字节数组
+    /// 将对象序列化转换为字节数组。
     /// </summary>
-    /// <returns></returns>
+    /// <remarks>
+    /// Serializes the object to a byte array.
+    /// </remarks>
+    /// <returns>序列化后的字节数组 / Serialized byte array</returns>
     public override byte[] ToBytes()
     {
         return this.ToBson();

GameFrameX.DataBase.Mongo/HealthChecks/MongoDbHealthCheck.cs

@@ -35,27 +35,36 @@
 namespace GameFrameX.DataBase.Mongo.HealthChecks;
 
 /// <summary>
-/// MongoDB 健康检查类
+/// MongoDB 健康检查类。
 /// </summary>
+/// <remarks>
+/// MongoDB health check class.
+/// </remarks>
 public sealed class MongoDbHealthCheck : IHealthCheck
 {
     private readonly IMongoClient _mongoClient;
 
     /// <summary>
-    /// 初始化 MongoDbHealthCheck 的新实例
+    /// 初始化 MongoDbHealthCheck 的新实例。
     /// </summary>
-    /// <param name="mongoClient">MongoDB 客户端</param>
+    /// <remarks>
+    /// Initializes a new instance of MongoDbHealthCheck.
+    /// </remarks>
+    /// <param name="mongoClient">MongoDB 客户端 / MongoDB client</param>
     public MongoDbHealthCheck(IMongoClient mongoClient)
     {
         _mongoClient = mongoClient;
     }
 
     /// <summary>
-    /// 执行健康检查
+    /// 执行健康检查。
     /// </summary>
-    /// <param name="context">健康检查上下文</param>
-    /// <param name="cancellationToken">取消令牌</param>
-    /// <returns>健康检查结果</returns>
+    /// <remarks>
+    /// Performs the health check.
+    /// </remarks>
+    /// <param name="context">健康检查上下文 / Health check context</param>
+    /// <param name="cancellationToken">取消令牌 / Cancellation token</param>
+    /// <returns>健康检查结果 / Health check result</returns>
     public async Task<HealthCheckResult> CheckHealthAsync(HealthCheckContext context, CancellationToken cancellationToken = default)
     {
         try

GameFrameX.DataBase.Mongo/MongoDbContext.cs

@@ -34,8 +34,21 @@
 
 namespace GameFrameX.DataBase.Mongo;
 
+/// <summary>
+/// MongoDB 数据库上下文。
+/// </summary>
+/// <remarks>
+/// MongoDB database context.
+/// </remarks>
 internal sealed class MongoDbContext : DB
 {
+    /// <summary>
+    /// 初始化 MongoDB 数据库上下文的新实例。
+    /// </summary>
+    /// <remarks>
+    /// Initializes a new instance of the MongoDB database context.
+    /// </remarks>
+    /// <param name="dbName">数据库名称 / Database name</param>
     public MongoDbContext(string dbName) : base(Instance(dbName))
     {
         SetGlobalFilterForBaseClass<BaseCacheState>(m => m.IsDeleted == null || m.IsDeleted == false);

GameFrameX.DataBase.Mongo/MongoDbService.Add.cs

@@ -44,6 +44,13 @@ namespace GameFrameX.DataBase.Mongo;
 /// </see>
 /// 接口。
 /// </summary>
+/// <remarks>
+/// MongoDB service connection class that implements the
+/// <see>
+///     <cref>IDatabaseService</cref>
+/// </see>
+/// interface.
+/// </remarks>
 public sealed partial class MongoDbService
 {
     /// <summary>
@@ -53,16 +60,26 @@ public sealed partial class MongoDbService
     /// </see>
     /// 属性为 false 可以并行执行写入操作。
     /// </summary>
+    /// <remarks>
+    /// Bulk write options for batch document writing. Setting the
+    /// <see>
+    ///     <cref>IsOrdered</cref>
+    /// </see>
+    /// property to false enables parallel write operations.
+    /// </remarks>
     public static readonly BulkWriteOptions BulkWriteOptions = new() { IsOrdered = false, };
 
     #region 插入
 
     /// <summary>
-    /// 增加一条数据
+    /// 增加一条数据。
     /// </summary>
-    /// <param name="state"></param>
-    /// <typeparam name="TState"></typeparam>
-    /// <returns>返回修改的条数</returns>
+    /// <remarks>
+    /// Adds a single data record.
+    /// </remarks>
+    /// <typeparam name="TState">数据类型，必须继承自 BaseCacheState / Data type, must inherit from BaseCacheState</typeparam>
+    /// <param name="state">要添加的数据对象 / Data object to add</param>
+    /// <returns>表示异步操作的任务 / A task representing the asynchronous operation</returns>
     public async Task AddAsync<TState>(TState state) where TState : BaseCacheState, new()
     {
         EnsureInitialized();
@@ -72,10 +89,14 @@ public sealed partial class MongoDbService
     }
 
     /// <summary>
-    /// 增加一个列表数据
+    /// 增加一个列表数据。
     /// </summary>
-    /// <param name="states"></param>
-    /// <typeparam name="TState"></typeparam>
+    /// <remarks>
+    /// Adds a list of data records.
+    /// </remarks>
+    /// <typeparam name="TState">数据类型，必须继承自 BaseCacheState / Data type, must inherit from BaseCacheState</typeparam>
+    /// <param name="states">要添加的数据列表 / List of data objects to add</param>
+    /// <returns>表示异步操作的任务 / A task representing the asynchronous operation</returns>
     public async Task AddListAsync<TState>(IEnumerable<TState> states) where TState : BaseCacheState, new()
     {
         EnsureInitialized();

GameFrameX.DataBase.Mongo/MongoDbService.Delete.cs

@@ -41,14 +41,24 @@ namespace GameFrameX.DataBase.Mongo;
 /// </see>
 /// 接口。
 /// </summary>
+/// <remarks>
+/// MongoDB service connection class that implements the
+/// <see>
+///     <cref>IDatabaseService</cref>
+/// </see>
+/// interface.
+/// </remarks>
 public sealed partial class MongoDbService
 {
     /// <summary>
-    /// 根据条件删除单条数据(软删除)
+    /// 根据条件删除单条数据（软删除）。
     /// </summary>
-    /// <param name="filter">查询条件表达式</param>
-    /// <typeparam name="TState">数据类型,必须继承自BaseCacheState</typeparam>
-    /// <returns>返回修改的记录数</returns>
+    /// <remarks>
+    /// Deletes a single data record by condition (soft delete).
+    /// </remarks>
+    /// <typeparam name="TState">数据类型，必须继承自 BaseCacheState / Data type, must inherit from BaseCacheState</typeparam>
+    /// <param name="filter">查询条件表达式 / Query condition expression</param>
+    /// <returns>返回修改的记录数 / The number of modified records</returns>
     public async Task<long> DeleteAsync<TState>(Expression<Func<TState, bool>> filter) where TState : BaseCacheState, new()
     {
         EnsureInitialized();
@@ -60,11 +70,14 @@ public sealed partial class MongoDbService
     }
 
     /// <summary>
-    /// 根据条件批量删除数据(软删除)
+    /// 根据条件批量删除数据（软删除）。
     /// </summary>
-    /// <param name="filter">查询条件表达式</param>
-    /// <typeparam name="TState">数据类型,必须继承自BaseCacheState</typeparam>
-    /// <returns>返回修改的记录数</returns>
+    /// <remarks>
+    /// Batch deletes data by condition (soft delete).
+    /// </remarks>
+    /// <typeparam name="TState">数据类型，必须继承自 BaseCacheState / Data type, must inherit from BaseCacheState</typeparam>
+    /// <param name="filter">查询条件表达式 / Query condition expression</param>
+    /// <returns>返回修改的记录数 / The number of modified records</returns>
     public async Task<long> DeleteListAsync<TState>(Expression<Func<TState, bool>> filter) where TState : BaseCacheState, new()
     {
         EnsureInitialized();
@@ -83,11 +96,14 @@ public sealed partial class MongoDbService
     }
 
     /// <summary>
-    /// 根据ID列表批量删除数据(软删除)
+    /// 根据ID列表批量删除数据（软删除）。
     /// </summary>
-    /// <param name="ids">要删除的ID列表</param>
-    /// <typeparam name="TState">数据类型,必须继承自BaseCacheState</typeparam>
-    /// <returns>返回修改的记录数</returns>
+    /// <remarks>
+    /// Batch deletes data by ID list (soft delete).
+    /// </remarks>
+    /// <typeparam name="TState">数据类型，必须继承自 BaseCacheState / Data type, must inherit from BaseCacheState</typeparam>
+    /// <param name="ids">要删除的ID列表 / List of IDs to delete</param>
+    /// <returns>返回修改的记录数 / The number of modified records</returns>
     public async Task<long> DeleteListIdAsync<TState>(IEnumerable<long> ids) where TState : BaseCacheState, new()
     {
         EnsureInitialized();
@@ -103,11 +119,14 @@ public sealed partial class MongoDbService
     }
 
     /// <summary>
-    /// 删除指定对象(软删除)
+    /// 删除指定对象（软删除）。
     /// </summary>
-    /// <param name="state">要删除的对象</param>
-    /// <typeparam name="TState">数据类型,必须继承自BaseCacheState</typeparam>
-    /// <returns>返回修改的记录数</returns>
+    /// <remarks>
+    /// Deletes the specified object (soft delete).
+    /// </remarks>
+    /// <typeparam name="TState">数据类型，必须继承自 BaseCacheState / Data type, must inherit from BaseCacheState</typeparam>
+    /// <param name="state">要删除的对象 / Object to delete</param>
+    /// <returns>返回修改的记录数 / The number of modified records</returns>
     public async Task<long> DeleteAsync<TState>(TState state) where TState : BaseCacheState, new()
     {
         EnsureInitialized();