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

为 GameFrameX.DataBase 模块的所有公共 API 添加标准的双语文档注释：
- 类和接口添加 remarks 英文翻译
- 参数和返回值使用中英双语格式
- 属性添加 value 标签说明

涉及文件：
- GameDB.cs: 游戏数据库静态工具类
- BaseCacheState.cs: 缓存数据对象基类
- IDatabaseService.cs: 数据库服务接口
- ICacheState.cs: 缓存数据对象接口
- DbOptions.cs: 数据库选项配置
- ISafeCreate.cs: 创建标记接口
- StateHash.cs: 状态哈希计算处理器

Author: AlianBlank

GameFrameX.DataBase/Abstractions/DbOptions.cs

@@ -33,27 +33,46 @@
 namespace GameFrameX.DataBase.Abstractions;
 
 /// <summary>
-/// 数据库选项
+/// 数据库选项。
 /// </summary>
+/// <remarks>
+/// Database configuration options.
+/// </remarks>
 public sealed record DbOptions
 {
     /// <summary>
-    /// 数据库类型
+    /// 数据库类型。
     /// </summary>
+    /// <remarks>
+    /// Database type.
+    /// </remarks>
+    /// <value>数据库类型 / Database type</value>
     public string Type { get; init; }
 
     /// <summary>
-    /// 连接字符串
+    /// 连接字符串。
     /// </summary>
+    /// <remarks>
+    /// Connection string.
+    /// </remarks>
+    /// <value>连接字符串 / Connection string</value>
     public string ConnectionString { get; init; }
 
     /// <summary>
-    /// 数据库名称
+    /// 数据库名称。
     /// </summary>
+    /// <remarks>
+    /// Database name.
+    /// </remarks>
+    /// <value>数据库名称 / Database name</value>
     public string Name { get; init; }
 
     /// <summary>
-    /// 是否使用时区时间记录
+    /// 是否使用时区时间记录。
     /// </summary>
+    /// <remarks>
+    /// Whether to use time zone for time recording.
+    /// </remarks>
+    /// <value>是否使用时区时间记录 / Whether to use time zone for time recording</value>
     public bool IsUseTimeZone { get; init; } = true;
 }

GameFrameX.DataBase/Abstractions/ICacheState.cs

@@ -34,34 +34,54 @@
 namespace GameFrameX.DataBase.Abstractions;
 
 /// <summary>
-/// 缓存数据对象接口
+/// 缓存数据对象接口。
 /// </summary>
+/// <remarks>
+/// Cache data object interface.
+/// </remarks>
 public interface ICacheState : ISafeDeletedFilter, ISafeCreatedFilter, ISafeUpdateFilter
 {
     /// <summary>
-    /// 唯一ID
+    /// 唯一ID。
     /// </summary>
+    /// <remarks>
+    /// Unique identifier.
+    /// </remarks>
+    /// <value>唯一ID / Unique ID</value>
     long Id { get; set; }
 
     /// <summary>
-    /// 是否修改
+    /// 是否修改。
     /// </summary>
+    /// <remarks>
+    /// Whether the object has been modified.
+    /// </remarks>
+    /// <returns>如果已修改则返回 <c>true</c>；否则返回 <c>false</c> / <c>true</c> if modified; otherwise <c>false</c></returns>
     bool IsModify();
 
     /// <summary>
     /// 用于在对象从数据库加载后进行一些特定的处理，如初始化数据或设置状态。
     /// </summary>
-    /// <param name="isNew">是否是新对象</param>
+    /// <remarks>
+    /// Used to perform specific processing after the object is loaded from the database, such as initializing data or setting state.
+    /// </remarks>
+    /// <param name="isNew">是否是新对象 / Whether it is a new object</param>
     void LoadFromDbPostHandler(bool isNew);
 
     /// <summary>
     /// 在对象保存到数据库后调用的方法，可以进行一些后续处理。
     /// </summary>
+    /// <remarks>
+    /// Method called after the object is saved to the database, can perform some post-processing.
+    /// </remarks>
     void SaveToDbPostHandler();
 
     /// <summary>
-    /// 将对象序列化转换为字节数组
+    /// 将对象序列化转换为字节数组。
     /// </summary>
-    /// <returns></returns>
+    /// <remarks>
+    /// Serialize the object to a byte array.
+    /// </remarks>
+    /// <returns>序列化后的字节数组 / Serialized byte array</returns>
     byte[] ToBytes();
 }