docs: 补全全部缺失的 XML 文档注释（中文）

- 为全部 5 个项目（Avalonia-API、Avalonia-Common、Avalonia-EFCore、
  Avalonia-PC、Avalonia-Services）中缺失注释的类、方法、属性、字段、
  接口成员等补全中文 XML 文档注释
- 共修改约 37 个文件，补全约 220+ 处注释
- 修复 ServiceEndpointCollection.cs 中 MapDelete<TService> 语法错误
- 修复 PcAuthService.cs 中 const prefix 位置错乱导致编译失败的问题
- 扫描结果：缺失项 0
- 构建结果：4/4 项目编译通过

Avalonia-EFCore/Models/ApiRefreshTokenEntity.cs

@@ -11,39 +11,69 @@ namespace Avalonia_EFCore.Models
     [Table("api-refresh-token")]
     public class ApiRefreshTokenEntity
     {
+        /// <summary>
+        /// 获取或设置主键 ID（自增）。
+        /// </summary>
         [Key]
         [Column("id")]
         [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
         public long Id { get; set; }
 
+        /// <summary>
+        /// 获取或设置关联的用户 ID。
+        /// </summary>
         [Column("user-id")]
         public int UserId { get; set; }
 
+        /// <summary>
+        /// 获取或设置 Token 的 SHA256 哈希值，用于安全存储和查询。
+        /// </summary>
         [Column("token-hash")]
         [MaxLength(128)]
         public string TokenHash { get; set; } = string.Empty;
 
+        /// <summary>
+        /// 获取或设置 Token 创建时间。
+        /// </summary>
         [Column("created-at")]
         public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
 
+        /// <summary>
+        /// 获取或设置 Token 过期时间。
+        /// </summary>
         [Column("expires-at")]
         public DateTime ExpiresAt { get; set; }
 
+        /// <summary>
+        /// 获取或设置 Token 撤销时间，null 表示尚未撤销。
+        /// </summary>
         [Column("revoked-at")]
         public DateTime? RevokedAt { get; set; }
 
+        /// <summary>
+        /// 获取或设置替换此 Token 的新 Token 哈希值（轮换时设置）。
+        /// </summary>
         [Column("replaced-by-token-hash")]
         [MaxLength(128)]
         public string? ReplacedByTokenHash { get; set; }
 
+        /// <summary>
+        /// 获取或设置创建设备标识（如 User-Agent）。
+        /// </summary>
         [Column("device")]
         [MaxLength(200)]
         public string? Device { get; set; }
 
+        /// <summary>
+        /// 获取或设置创建时的客户端 IP 地址。
+        /// </summary>
         [Column("ip-address")]
         [MaxLength(64)]
         public string? IpAddress { get; set; }
 
+        /// <summary>
+        /// 获取 Token 是否有效（未被撤销且未过期）。
+        /// </summary>
         public bool IsActive => RevokedAt is null && ExpiresAt > DateTime.UtcNow;
     }
 }

Avalonia-EFCore/Models/UserEntity.cs

@@ -11,31 +11,49 @@ namespace Avalonia_EFCore.Models
     [Table("user")]
     public class UserEntity
     {
+        /// <summary>
+        /// 获取或设置用户主键 ID（自增）。
+        /// </summary>
         [Key]
         [Comment("用户主键")]
         [Column("id")]
         [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
         public int Id { get; set; }
 
+        /// <summary>
+        /// 获取或设置用户名称。
+        /// </summary>
         [Comment("用户名称")]
         [Column("name")]
         [MaxLength(100)]
         public string? Name { get; set; }
 
+        /// <summary>
+        /// 获取或设置用户邮箱。
+        /// </summary>
         [Comment("用户邮箱")]
         [Column("email")]
         [MaxLength(200)]
         public string? Email { get; set; }
 
+        /// <summary>
+        /// 获取或设置用户电话号码。
+        /// </summary>
         [Comment("电话号码")]
         [Column("phone-number")]
         [MaxLength(50)]
         public string? PhoneNumber { get; set; }
 
+        /// <summary>
+        /// 获取或设置用户创建时间。
+        /// </summary>
         [Comment("创建时间")]
         [Column("created-at")]
         public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
 
+        /// <summary>
+        /// 获取或设置用户最后更新时间。
+        /// </summary>
         [Comment("更新时间")]
         [Column("updated-at")]
         public DateTime UpdatedAt { get; set; } = DateTime.UtcNow;

Avalonia-EFCore/Models/WeatherForecast.cs

@@ -1,13 +1,28 @@
 namespace Avalonia_EFCore.Models
 {
+    /// <summary>
+    /// 天气预报数据模型（内存/DTO 用，非数据库实体）。
+    /// </summary>
     public class WeatherForecast
     {
+        /// <summary>
+        /// 获取或设置预报日期。
+        /// </summary>
         public DateOnly Date { get; set; }
 
+        /// <summary>
+        /// 获取或设置摄氏温度。
+        /// </summary>
         public int TemperatureC { get; set; }
 
+        /// <summary>
+        /// 获取华氏温度（根据摄氏温度自动计算）。
+        /// </summary>
         public int TemperatureF => 32 + (int)(TemperatureC / 0.5556);
 
+        /// <summary>
+        /// 获取或设置天气摘要。
+        /// </summary>
         public string? Summary { get; set; }
     }
 }

Avalonia-EFCore/Models/WeatherForecastEntity.cs

@@ -11,29 +11,47 @@ namespace Avalonia_EFCore.Models
     [Table("weather-forecast")]
     public class WeatherForecastEntity
     {
+        /// <summary>
+        /// 获取或设置天气预报主键 ID（自增）。
+        /// </summary>
         [Key]
         [Comment("天气预报主键")]
         [Column("id")]
         [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
         public int Id { get; set; }
 
+        /// <summary>
+        /// 获取或设置预报日期。
+        /// </summary>
         [Comment("预报日期")]
         [Column("date")]
         public DateOnly Date { get; set; }
 
+        /// <summary>
+        /// 获取或设置摄氏温度。
+        /// </summary>
         [Comment("摄氏温度")]
         [Column("temperature-c")]
         public int TemperatureC { get; set; }
 
+        /// <summary>
+        /// 获取或设置天气摘要。
+        /// </summary>
         [Comment("天气摘要")]
         [Column("summary")]
         [MaxLength(200)]
         public string? Summary { get; set; }
 
+        /// <summary>
+        /// 获取或设置记录创建时间。
+        /// </summary>
         [Comment("创建时间")]
         [Column("created-at")]
         public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
 
+        /// <summary>
+        /// 获取或设置记录最后更新时间。
+        /// </summary>
         [Comment("更新时间")]
         [Column("updated-at")]
         public DateTime UpdatedAt { get; set; } = DateTime.UtcNow;