add GeneralUpdate.Drivelution

Author: JusterZhu

src/c#/GeneralUpdate.Drivelution/Abstractions/Configuration/DriverUpdateOptions.cs

@@ -0,0 +1,98 @@
+namespace GeneralUpdate.Drivelution.Abstractions.Configuration;
+
+/// <summary>
+/// 驱动更新配置选项
+/// Driver update configuration options
+/// </summary>
+public class DriverUpdateOptions
+{
+    /// <summary>
+    /// 默认备份路径
+    /// Default backup path
+    /// </summary>
+    public string DefaultBackupPath { get; set; } = "./DriverBackups";
+
+    /// <summary>
+    /// 日志级别（Debug/Info/Warn/Error/Fatal）
+    /// Log level (Debug/Info/Warn/Error/Fatal)
+    /// </summary>
+    public string LogLevel { get; set; } = "Info";
+
+    /// <summary>
+    /// 日志文件路径
+    /// Log file path
+    /// </summary>
+    public string LogFilePath { get; set; } = "./Logs/driver-update-.log";
+
+    /// <summary>
+    /// 是否启用控制台日志
+    /// Enable console logging
+    /// </summary>
+    public bool EnableConsoleLogging { get; set; } = true;
+
+    /// <summary>
+    /// 是否启用文件日志
+    /// Enable file logging
+    /// </summary>
+    public bool EnableFileLogging { get; set; } = true;
+
+    /// <summary>
+    /// 默认重试次数
+    /// Default retry count
+    /// </summary>
+    public int DefaultRetryCount { get; set; } = 3;
+
+    /// <summary>
+    /// 默认重试间隔（秒）
+    /// Default retry interval (seconds)
+    /// </summary>
+    public int DefaultRetryIntervalSeconds { get; set; } = 5;
+
+    /// <summary>
+    /// 默认超时时间（秒）
+    /// Default timeout (seconds)
+    /// </summary>
+    public int DefaultTimeoutSeconds { get; set; } = 300;
+
+    /// <summary>
+    /// 是否在调试模式下跳过签名验证
+    /// Skip signature validation in debug mode
+    /// </summary>
+    public bool DebugModeSkipSignature { get; set; } = false;
+
+    /// <summary>
+    /// 是否在调试模式下跳过哈希验证
+    /// Skip hash validation in debug mode
+    /// </summary>
+    public bool DebugModeSkipHash { get; set; } = false;
+
+    /// <summary>
+    /// 权限校验失败时是否强制终止
+    /// Force terminate on permission check failure
+    /// </summary>
+    public bool ForceTerminateOnPermissionFailure { get; set; } = true;
+
+    /// <summary>
+    /// 是否自动清理旧备份（保留最近N个）
+    /// Auto cleanup old backups (keep recent N)
+    /// </summary>
+    public bool AutoCleanupBackups { get; set; } = true;
+
+    /// <summary>
+    /// 保留的备份数量
+    /// Number of backups to keep
+    /// </summary>
+    public int BackupsToKeep { get; set; } = 5;
+
+    /// <summary>
+    /// 信任的证书指纹列表（用于签名验证）
+    /// Trusted certificate thumbprints (for signature validation)
+    /// </summary>
+    public List<string> TrustedCertificateThumbprints { get; set; } = new();
+
+    /// <summary>
+    /// 信任的GPG公钥列表（Linux用）
+    /// Trusted GPG public keys (for Linux)
+    /// </summary>
+    public List<string> TrustedGpgKeys { get; set; } = new();
+}

src/c#/GeneralUpdate.Drivelution/Abstractions/Exceptions/DriverUpdateExceptions.cs

@@ -0,0 +1,131 @@
+namespace GeneralUpdate.Drivelution.Abstractions.Exceptions;
+
+/// <summary>
+/// 驱动更新基础异常
+/// Base exception for driver update
+/// </summary>
+public class DriverUpdateException : Exception
+{
+    public string ErrorCode { get; set; }
+    public bool CanRetry { get; set; }
+
+    public DriverUpdateException(string message, string errorCode = "DU_UNKNOWN", bool canRetry = false)
+        : base(message)
+    {
+        ErrorCode = errorCode;
+        CanRetry = canRetry;
+    }
+
+    public DriverUpdateException(string message, Exception innerException, string errorCode = "DU_UNKNOWN", bool canRetry = false)
+        : base(message, innerException)
+    {
+        ErrorCode = errorCode;
+        CanRetry = canRetry;
+    }
+}
+
+/// <summary>
+/// 权限异常
+/// Permission exception
+/// </summary>
+public class DriverPermissionException : DriverUpdateException
+{
+    public DriverPermissionException(string message)
+        : base(message, "DU_PERMISSION_DENIED", false)
+    {
+    }
+
+    public DriverPermissionException(string message, Exception innerException)
+        : base(message, innerException, "DU_PERMISSION_DENIED", false)
+    {
+    }
+}
+
+/// <summary>
+/// 校验失败异常
+/// Validation failed exception
+/// </summary>
+public class DriverValidationException : DriverUpdateException
+{
+    public string ValidationType { get; set; }
+
+    public DriverValidationException(string message, string validationType)
+        : base(message, "DU_VALIDATION_FAILED", false)
+    {
+        ValidationType = validationType;
+    }
+
+    public DriverValidationException(string message, string validationType, Exception innerException)
+        : base(message, innerException, "DU_VALIDATION_FAILED", false)
+    {
+        ValidationType = validationType;
+    }
+}
+
+/// <summary>
+/// 安装失败异常
+/// Installation failed exception
+/// </summary>
+public class DriverInstallationException : DriverUpdateException
+{
+    public DriverInstallationException(string message, bool canRetry = true)
+        : base(message, "DU_INSTALLATION_FAILED", canRetry)
+    {
+    }
+
+    public DriverInstallationException(string message, Exception innerException, bool canRetry = true)
+        : base(message, innerException, "DU_INSTALLATION_FAILED", canRetry)
+    {
+    }
+}
+
+/// <summary>
+/// 备份失败异常
+/// Backup failed exception
+/// </summary>
+public class DriverBackupException : DriverUpdateException
+{
+    public DriverBackupException(string message)
+        : base(message, "DU_BACKUP_FAILED", true)
+    {
+    }
+
+    public DriverBackupException(string message, Exception innerException)
+        : base(message, innerException, "DU_BACKUP_FAILED", true)
+    {
+    }
+}
+
+/// <summary>
+/// 回滚失败异常
+/// Rollback failed exception
+/// </summary>
+public class DriverRollbackException : DriverUpdateException
+{
+    public DriverRollbackException(string message)
+        : base(message, "DU_ROLLBACK_FAILED", false)
+    {
+    }
+
+    public DriverRollbackException(string message, Exception innerException)
+        : base(message, innerException, "DU_ROLLBACK_FAILED", false)
+    {
+    }
+}
+
+/// <summary>
+/// 兼容性异常
+/// Compatibility exception
+/// </summary>
+public class DriverCompatibilityException : DriverUpdateException
+{
+    public DriverCompatibilityException(string message)
+        : base(message, "DU_COMPATIBILITY_FAILED", false)
+    {
+    }
+
+    public DriverCompatibilityException(string message, Exception innerException)
+        : base(message, innerException, "DU_COMPATIBILITY_FAILED", false)
+    {
+    }
+}

src/c#/GeneralUpdate.Drivelution/Abstractions/IDriverBackup.cs

@@ -0,0 +1,37 @@
+namespace GeneralUpdate.Drivelution.Abstractions;
+
+/// <summary>
+/// 驱动备份接口
+/// Driver backup interface
+/// </summary>
+public interface IDriverBackup
+{
+    /// <summary>
+    /// 异步备份驱动
+    /// Backs up driver asynchronously
+    /// </summary>
+    /// <param name="sourcePath">源路径 / Source path</param>
+    /// <param name="backupPath">备份路径 / Backup path</param>
+    /// <param name="cancellationToken">取消令牌 / Cancellation token</param>
+    /// <returns>备份结果 / Backup result</returns>
+    Task<bool> BackupAsync(string sourcePath, string backupPath, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 异步恢复驱动
+    /// Restores driver asynchronously
+    /// </summary>
+    /// <param name="backupPath">备份路径 / Backup path</param>
+    /// <param name="targetPath">目标路径 / Target path</param>
+    /// <param name="cancellationToken">取消令牌 / Cancellation token</param>
+    /// <returns>恢复结果 / Restore result</returns>
+    Task<bool> RestoreAsync(string backupPath, string targetPath, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 异步删除备份
+    /// Deletes backup asynchronously
+    /// </summary>
+    /// <param name="backupPath">备份路径 / Backup path</param>
+    /// <param name="cancellationToken">取消令牌 / Cancellation token</param>
+    /// <returns>删除结果 / Delete result</returns>
+    Task<bool> DeleteBackupAsync(string backupPath, CancellationToken cancellationToken = default);
+}

src/c#/GeneralUpdate.Drivelution/Abstractions/IDriverValidator.cs

@@ -0,0 +1,47 @@
+using System.Diagnostics.CodeAnalysis;
+using GeneralUpdate.Drivelution.Abstractions.Models;
+
+namespace GeneralUpdate.Drivelution.Abstractions;
+
+/// <summary>
+/// 驱动验证器接口
+/// Driver validator interface
+/// </summary>
+public interface IDriverValidator
+{
+    /// <summary>
+    /// 异步验证驱动文件完整性（哈希校验）
+    /// Validates driver file integrity (hash validation) asynchronously
+    /// </summary>
+    /// <param name="filePath">文件路径 / File path</param>
+    /// <param name="expectedHash">期望的哈希值 / Expected hash</param>
+    /// <param name="hashAlgorithm">哈希算法 / Hash algorithm (SHA256, MD5)</param>
+    /// <param name="cancellationToken">取消令牌 / Cancellation token</param>
+    /// <returns>验证是否通过 / Validation result</returns>
+    Task<bool> ValidateIntegrityAsync(string filePath, string expectedHash, string hashAlgorithm = "SHA256", CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 异步验证驱动数字签名
+    /// Validates driver digital signature asynchronously
+    /// </summary>
+    /// <param name="filePath">文件路径 / File path</param>
+    /// <param name="trustedPublishers">信任的发布者列表 / Trusted publishers list</param>
+    /// <param name="cancellationToken">取消令牌 / Cancellation token</param>
+    /// <returns>验证是否通过 / Validation result</returns>
+    /// <remarks>
+    /// Note: On Windows, this may require reflection for X509Certificate validation.
+    /// Platform-specific implementations should add appropriate AOT compatibility attributes.
+    /// </remarks>
+    [RequiresUnreferencedCode("Signature validation may require runtime reflection on some platforms")]
+    [RequiresDynamicCode("Signature validation may require runtime code generation on some platforms")]
+    Task<bool> ValidateSignatureAsync(string filePath, IEnumerable<string> trustedPublishers, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 异步验证驱动兼容性
+    /// Validates driver compatibility asynchronously
+    /// </summary>
+    /// <param name="driverInfo">驱动信息 / Driver information</param>
+    /// <param name="cancellationToken">取消令牌 / Cancellation token</param>
+    /// <returns>验证是否通过 / Validation result</returns>
+    Task<bool> ValidateCompatibilityAsync(DriverInfo driverInfo, CancellationToken cancellationToken = default);
+}

src/c#/GeneralUpdate.Drivelution/Abstractions/IGeneralDrivelution.cs

@@ -0,0 +1,59 @@
+using System.Diagnostics.CodeAnalysis;
+using GeneralUpdate.Drivelution.Abstractions.Models;
+
+namespace GeneralUpdate.Drivelution.Abstractions;
+
+/// <summary>
+/// 驱动更新器核心接口
+/// Core interface for driver updater
+/// </summary>
+public interface IGeneralDrivelution
+{
+    /// <summary>
+    /// 异步更新驱动
+    /// Updates driver asynchronously
+    /// </summary>
+    /// <param name="driverInfo">驱动信息 / Driver information</param>
+    /// <param name="strategy">更新策略 / Update strategy</param>
+    /// <param name="cancellationToken">取消令牌 / Cancellation token</param>
+    /// <returns>更新结果 / Update result</returns>
+    /// <remarks>
+    /// Note: Update process may include signature validation that requires reflection on some platforms.
+    /// </remarks>
+    [RequiresUnreferencedCode("Update process may include signature validation that requires runtime reflection on some platforms")]
+    [RequiresDynamicCode("Update process may include signature validation that requires runtime code generation on some platforms")]
+    Task<UpdateResult> UpdateAsync(DriverInfo driverInfo, UpdateStrategy strategy, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 异步验证驱动
+    /// Validates driver asynchronously
+    /// </summary>
+    /// <param name="driverInfo">驱动信息 / Driver information</param>
+    /// <param name="cancellationToken">取消令牌 / Cancellation token</param>
+    /// <returns>验证是否通过 / Validation result</returns>
+    /// <remarks>
+    /// Note: Includes signature validation that may require reflection on some platforms.
+    /// </remarks>
+    [RequiresUnreferencedCode("Validation includes signature validation that may require runtime reflection on some platforms")]
+    [RequiresDynamicCode("Validation includes signature validation that may require runtime code generation on some platforms")]
+    Task<bool> ValidateAsync(DriverInfo driverInfo, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 异步备份驱动
+    /// Backs up driver asynchronously
+    /// </summary>
+    /// <param name="driverInfo">驱动信息 / Driver information</param>
+    /// <param name="backupPath">备份路径 / Backup path</param>
+    /// <param name="cancellationToken">取消令牌 / Cancellation token</param>
+    /// <returns>备份结果 / Backup result</returns>
+    Task<bool> BackupAsync(DriverInfo driverInfo, string backupPath, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// 异步回滚驱动
+    /// Rolls back driver asynchronously
+    /// </summary>
+    /// <param name="backupPath">备份路径 / Backup path</param>
+    /// <param name="cancellationToken">取消令牌 / Cancellation token</param>
+    /// <returns>回滚结果 / Rollback result</returns>
+    Task<bool> RollbackAsync(string backupPath, CancellationToken cancellationToken = default);
+}