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/Database/AppDataContext.cs

@@ -19,6 +19,10 @@ namespace Avalonia_EFCore.Database
         /// <summary>API refresh token 数据</summary>
         public DbSet<ApiRefreshTokenEntity> ApiRefreshTokens => Set<ApiRefreshTokenEntity>();
 
+        /// <summary>
+        /// 配置实体映射，包括主键、索引和属性约束。
+        /// </summary>
+        /// <param name="modelBuilder">模型构建器。</param>
         protected override void OnModelCreating(ModelBuilder modelBuilder)
         {
             base.OnModelCreating(modelBuilder);

Avalonia-EFCore/Database/AppDataContextFactory.cs

@@ -2,8 +2,16 @@ using Microsoft.EntityFrameworkCore.Design;
 
 namespace Avalonia_EFCore.Database
 {
+    /// <summary>
+    /// 设计时 DbContext 工厂，用于 EF Core 迁移工具生成迁移代码。
+    /// </summary>
     public class AppDataContextFactory : IDesignTimeDbContextFactory<AppDataContext>
     {
+        /// <summary>
+        /// 创建用于设计时的 AppDataContext 实例，默认使用 SQLite 提供程序。
+        /// </summary>
+        /// <param name="args">命令行参数。</param>
+        /// <returns>配置好的数据上下文实例。</returns>
         public AppDataContext CreateDbContext(string[] args)
         {
             DatabaseProviderRegistry.RegisterDefaults();

Avalonia-EFCore/Database/AppDbContext.cs

@@ -12,8 +12,15 @@ namespace Avalonia_EFCore.Database
     /// </summary>
     public abstract class AppDbContext(DatabaseConfiguration dbConfig) : DbContext
     {
+        /// <summary>
+        /// 数据库配置。
+        /// </summary>
         private readonly DatabaseConfiguration _dbConfig = dbConfig;
 
+        /// <summary>
+        /// 配置数据库提供程序和连接选项。
+        /// </summary>
+        /// <param name="optionsBuilder">选项构建器。</param>
         protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
         {
             if (optionsBuilder.IsConfigured) return;
@@ -65,12 +72,21 @@ namespace Avalonia_EFCore.Database
             return base.SaveChanges(acceptAllChangesOnSuccess);
         }
 
+        /// <summary>
+        /// 异步保存更改，自动设置时间戳。
+        /// </summary>
+        /// <param name="acceptAllChangesOnSuccess">是否在成功时接受所有更改。</param>
+        /// <param name="cancellationToken">取消令牌。</param>
+        /// <returns>受影响的行数。</returns>
         public override Task<int> SaveChangesAsync(bool acceptAllChangesOnSuccess, CancellationToken cancellationToken = default)
         {
             SetTimestamps();
             return base.SaveChangesAsync(acceptAllChangesOnSuccess, cancellationToken);
         }
 
+        /// <summary>
+        /// 自动设置新增或修改实体的 CreatedAt 和 UpdatedAt 时间戳。
+        /// </summary>
         private void SetTimestamps()
         {
             var entries = ChangeTracker.Entries()

Avalonia-EFCore/Database/DatabaseManager.cs

@@ -17,10 +17,25 @@ namespace Avalonia_EFCore.Database
     /// </summary>
     public class DatabaseManager<TContext> where TContext : AppDbContext
     {
+        /// <summary>
+        /// 数据库上下文实例。
+        /// </summary>
         private readonly TContext _context;
+        /// <summary>
+        /// 数据库配置。
+        /// </summary>
         private readonly DatabaseConfiguration _config;
+        /// <summary>
+        /// DI 服务提供程序（可选，用于种子数据中解析服务）。
+        /// </summary>
         private readonly IServiceProvider? _serviceProvider;
 
+        /// <summary>
+        /// 初始化数据库管理器。
+        /// </summary>
+        /// <param name="context">数据库上下文。</param>
+        /// <param name="config">数据库配置。</param>
+        /// <param name="serviceProvider">可选的 DI 容器。</param>
         public DatabaseManager(TContext context, DatabaseConfiguration config, IServiceProvider? serviceProvider = null)
         {
             _context = context;
@@ -128,6 +143,10 @@ namespace Avalonia_EFCore.Database
             }
         }
 
+        /// <summary>
+        /// 获取当前应用程序的版本号，优先读取 AssemblyInformationalVersion，回退到 AssemblyVersion。
+        /// </summary>
+        /// <returns>应用程序版本字符串。</returns>
         private static string GetApplicationVersion()
         {
             var assembly = Assembly.GetEntryAssembly() ?? typeof(TContext).Assembly;
@@ -181,10 +200,25 @@ namespace Avalonia_EFCore.Database
     /// </summary>
     public class DatabaseVersionInfo
     {
+        /// <summary>
+        /// 获取或设置数据库提供程序名称。
+        /// </summary>
         public string Provider { get; set; } = string.Empty;
+        /// <summary>
+        /// 获取或设置已应用的迁移列表。
+        /// </summary>
         public List<string> AppliedMigrations { get; set; } = new();
+        /// <summary>
+        /// 获取或设置待应用的迁移列表。
+        /// </summary>
         public List<string> PendingMigrations { get; set; } = new();
+        /// <summary>
+        /// 获取或设置是否为最新版本。
+        /// </summary>
         public bool IsLatest { get; set; }
+        /// <summary>
+        /// 获取或设置数据库是否可连接。
+        /// </summary>
         public bool CanConnect { get; set; }
     }
 }

Avalonia-EFCore/Database/DatabaseProviderRegistry.cs

@@ -15,6 +15,9 @@ namespace Avalonia_EFCore.Database
         /// </summary>
         public delegate void ProviderConfigurator(DbContextOptionsBuilder optionsBuilder, string connectionString, int timeout);
 
+        /// <summary>
+        /// 保存已注册的数据库提供程序及其配置委托。
+        /// </summary>
         private static readonly Dictionary<DatabaseProvider, ProviderConfigurator> _providers = new();
 
         /// <summary>

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;