impl #1245

This reverts commit d4bd610fe2.

src/Snap.Hutao/.editorconfig

@@ -110,7 +110,6 @@ dotnet_diagnostic.SA1642.severity = none
 
 dotnet_diagnostic.IDE0005.severity = warning
 dotnet_diagnostic.IDE0060.severity = none
-dotnet_diagnostic.IDE0290.severity = none
 
 # SA1208: System using directives should be placed before other using directives
 dotnet_diagnostic.SA1208.severity = none
@@ -321,7 +320,8 @@ dotnet_diagnostic.CA2227.severity = suggestion
 
 # CA2251: 使用 “string.Equals”
 dotnet_diagnostic.CA2251.severity = suggestion
-csharp_style_prefer_primary_constructors = true:suggestion
+
+csharp_style_prefer_primary_constructors = false:none
 
 [*.vb]
 #### 命名样式 ####

src/Snap.Hutao/Snap.Hutao.Test/PlatformExtensions/DependencyInjectionTest.cs

@@ -1,4 +1,5 @@
 using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Logging;
 using System;
 
 namespace Snap.Hutao.Test.PlatformExtensions;
@@ -11,6 +12,7 @@ public sealed class DependencyInjectionTest
         .AddSingleton<IService, ServiceB>()
         .AddScoped<IScopedService, ServiceA>()
         .AddTransient(typeof(IGenericService<>), typeof(GenericService<>))
+        .AddLogging(builder => builder.AddConsole())
         .BuildServiceProvider();
 
     [TestMethod]
@@ -41,6 +43,13 @@ public sealed class DependencyInjectionTest
         }
     }
 
+    [TestMethod]
+    public void LoggerWithInterfaceTypeCanBeResolved()
+    {
+        Assert.IsNotNull(services.GetService<ILogger<IScopedService>>());
+        Assert.IsNotNull(services.GetRequiredService<ILoggerFactory>().CreateLogger(nameof(IScopedService)));
+    }
+
     private interface IService
     {
         Guid Id { get; }

src/Snap.Hutao/Snap.Hutao.Test/Snap.Hutao.Test.csproj

@@ -12,9 +12,10 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="8.0.0" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="8.0.0" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.9.0" />
-    <PackageReference Include="MSTest.TestAdapter" Version="3.2.2" />
-    <PackageReference Include="MSTest.TestFramework" Version="3.2.2" />
+    <PackageReference Include="MSTest.TestAdapter" Version="3.3.1" />
+    <PackageReference Include="MSTest.TestFramework" Version="3.3.1" />
     <PackageReference Include="coverlet.collector" Version="6.0.2">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>

src/Snap.Hutao/Snap.Hutao/App.xaml.cs

@@ -10,8 +10,6 @@ using Snap.Hutao.Core.LifeCycle.InterProcess;
 using Snap.Hutao.Core.Logging;
 using Snap.Hutao.Core.Shell;
 using System.Diagnostics;
-using System.Text;
-using static Snap.Hutao.Core.Logging.ConsoleVirtualTerminalSequences;
 
 namespace Snap.Hutao;
 

src/Snap.Hutao/Snap.Hutao/Control/Extension/FrameworkElementExtension.cs

@@ -28,4 +28,21 @@ internal static class FrameworkElementExtension
         frameworkElement.IsRightTapEnabled = false;
         frameworkElement.IsTabStop = false;
     }
+
+    public static void InitializeDataContext<TDataContext>(this FrameworkElement frameworkElement, IServiceProvider? serviceProvider = default)
+        where TDataContext : class
+    {
+        IServiceProvider service = serviceProvider ?? Ioc.Default;
+        try
+        {
+            frameworkElement.DataContext = service.GetRequiredService<TDataContext>();
+        }
+        catch (Exception ex)
+        {
+
+            ILogger? logger = service.GetRequiredService(typeof(ILogger<>).MakeGenericType([frameworkElement.GetType()])) as ILogger;
+            logger?.LogError(ex, "Failed to initialize DataContext");
+            throw;
+        }
+    }
 }

src/Snap.Hutao/Snap.Hutao/Control/Image/CachedImage.cs

@@ -35,7 +35,7 @@ internal sealed class CachedImage : Implementation.ImageEx
 
         try
         {
-            HutaoException.ThrowIf(string.IsNullOrEmpty(imageUri.Host), HutaoExceptionKind.ImageCacheInvalidUri, SH.ControlImageCachedImageInvalidResourceUri);
+            HutaoException.ThrowIf(string.IsNullOrEmpty(imageUri.Host), SH.ControlImageCachedImageInvalidResourceUri);
             string file = await imageCache.GetFileFromCacheAsync(imageUri).ConfigureAwait(true); // BitmapImage need to be created by main thread.
             token.ThrowIfCancellationRequested(); // check token state to determine whether the operation should be canceled.
             return new BitmapImage(file.ToUri()); // BitmapImage initialize with a uri will increase image quality and loading speed.

src/Snap.Hutao/Snap.Hutao/Control/Layout/UniformStaggeredLayout.cs

@@ -4,7 +4,6 @@
 using Microsoft.UI.Xaml;
 using Microsoft.UI.Xaml.Controls;
 using System.Collections.Specialized;
-using System.Runtime.CompilerServices;
 using System.Runtime.InteropServices;
 using Windows.Foundation;
 

src/Snap.Hutao/Snap.Hutao/Control/Panel/HorizontalEqualPanel.cs

@@ -2,6 +2,7 @@
 // Licensed under the MIT license.
 
 using Microsoft.UI.Xaml;
+using System.Runtime.InteropServices;
 using Windows.Foundation;
 
 namespace Snap.Hutao.Control.Panel;
@@ -18,13 +19,14 @@ internal partial class HorizontalEqualPanel : Microsoft.UI.Xaml.Controls.Panel
 
     protected override Size MeasureOverride(Size availableSize)
     {
-        foreach (UIElement child in Children)
+        List<UIElement> visibleChildren = Children.Where(child => child.Visibility is Visibility.Visible).ToList();
+        foreach (ref readonly UIElement visibleChild in CollectionsMarshal.AsSpan(visibleChildren))
         {
             // ScrollViewer will always return an Infinity Size, we should use ActualWidth for this situation.
             double availableWidth = double.IsInfinity(availableSize.Width) ? ActualWidth : availableSize.Width;
-            double childAvailableWidth = (availableWidth + Spacing) / Children.Count;
+            double childAvailableWidth = (availableWidth + Spacing) / visibleChildren.Count;
             double childMaxAvailableWidth = Math.Max(MinItemWidth, childAvailableWidth);
-            child.Measure(new(childMaxAvailableWidth - Spacing, ActualHeight));
+            visibleChild.Measure(new(childMaxAvailableWidth - Spacing, ActualHeight));
         }
 
         return base.MeasureOverride(availableSize);
@@ -32,14 +34,14 @@ internal partial class HorizontalEqualPanel : Microsoft.UI.Xaml.Controls.Panel
 
     protected override Size ArrangeOverride(Size finalSize)
     {
-        int itemCount = Children.Count;
-        double availableItemWidth = (finalSize.Width - (Spacing * (itemCount - 1))) / itemCount;
+        List<UIElement> visibleChildren = Children.Where(child => child.Visibility is Visibility.Visible).ToList();
+        double availableItemWidth = (finalSize.Width - (Spacing * (visibleChildren.Count - 1))) / visibleChildren.Count;
         double actualItemWidth = Math.Max(MinItemWidth, availableItemWidth);
 
         double offset = 0;
-        foreach (UIElement child in Children)
+        foreach (ref readonly UIElement visibleChild in CollectionsMarshal.AsSpan(visibleChildren))
         {
-            child.Arrange(new Rect(offset, 0, actualItemWidth, finalSize.Height));
+            visibleChild.Arrange(new Rect(offset, 0, actualItemWidth, finalSize.Height));
             offset += actualItemWidth + Spacing;
         }
 
@@ -49,7 +51,8 @@ internal partial class HorizontalEqualPanel : Microsoft.UI.Xaml.Controls.Panel
     private static void OnLoaded(object sender, RoutedEventArgs e)
     {
         HorizontalEqualPanel panel = (HorizontalEqualPanel)sender;
-        panel.MinWidth = (panel.MinItemWidth * panel.Children.Count) + (panel.Spacing * (panel.Children.Count - 1));
+        int vivibleChildrenCount = panel.Children.Count(child => child.Visibility is Visibility.Visible);
+        panel.MinWidth = (panel.MinItemWidth * vivibleChildrenCount) + (panel.Spacing * (vivibleChildrenCount - 1));
     }
 
     private static void OnSizeChanged(object sender, SizeChangedEventArgs e)

src/Snap.Hutao/Snap.Hutao/Control/Panel/UniformPanel.cs

@@ -2,8 +2,6 @@
 // Licensed under the MIT license.
 
 using Microsoft.UI.Xaml;
-using Microsoft.UI.Xaml.Controls;
-using Microsoft.UI.Xaml.Controls.Primitives;
 using Windows.Foundation;
 
 namespace Snap.Hutao.Control.Panel;

src/Snap.Hutao/Snap.Hutao/Control/ScopedPage.cs

@@ -15,7 +15,7 @@ internal class ScopedPage : Page
 {
     private readonly RoutedEventHandler unloadEventHandler;
     private readonly CancellationTokenSource viewCancellationTokenSource = new();
-    private readonly IServiceScope currentScope;
+    private readonly IServiceScope pageScope;
 
     private bool inFrame = true;
 
@@ -23,7 +23,7 @@ internal class ScopedPage : Page
     {
         unloadEventHandler = OnUnloaded;
         Unloaded += unloadEventHandler;
-        currentScope = Ioc.Default.GetRequiredService<IScopedPageScopeReferenceTracker>().CreateScope();
+        pageScope = Ioc.Default.GetRequiredService<IScopedPageScopeReferenceTracker>().CreateScope();
     }
 
     public async ValueTask NotifyRecipientAsync(INavigationData extra)
@@ -44,9 +44,17 @@ internal class ScopedPage : Page
     protected void InitializeWith<TViewModel>()
         where TViewModel : class, IViewModel
     {
-        IViewModel viewModel = currentScope.ServiceProvider.GetRequiredService<TViewModel>();
-        viewModel.CancellationToken = viewCancellationTokenSource.Token;
-        DataContext = viewModel;
+        try
+        {
+            IViewModel viewModel = pageScope.ServiceProvider.GetRequiredService<TViewModel>();
+            viewModel.CancellationToken = viewCancellationTokenSource.Token;
+            DataContext = viewModel;
+        }
+        catch (Exception ex)
+        {
+            pageScope.ServiceProvider.GetRequiredService<ILogger<ScopedPage>>().LogError(ex, "Failed to initialize view model.");
+            throw;
+        }
     }
 
     /// <inheritdoc/>
@@ -95,7 +103,7 @@ internal class ScopedPage : Page
                 viewModel.IsViewDisposed = true;
 
                 // Dispose the scope
-                currentScope.Dispose();
+                pageScope.Dispose();
             }
         }
     }

src/Snap.Hutao/Snap.Hutao/Core/Caching/ImageCache.cs

@@ -5,6 +5,9 @@ using Snap.Hutao.Core.DependencyInjection.Annotation.HttpClient;
 using Snap.Hutao.Core.IO;
 using Snap.Hutao.Core.IO.Hashing;
 using Snap.Hutao.Core.Logging;
+using Snap.Hutao.ViewModel.Guide;
+using Snap.Hutao.Web.Request.Builder;
+using Snap.Hutao.Web.Request.Builder.Abstraction;
 using System.Collections.Concurrent;
 using System.Collections.Frozen;
 using System.IO;
@@ -36,6 +39,7 @@ internal sealed partial class ImageCache : IImageCache, IImageCacheFilePathOpera
     private readonly ConcurrentDictionary<string, Task> concurrentTasks = new();
 
     private readonly IHttpClientFactory httpClientFactory;
+    private readonly IHttpRequestMessageBuilderFactory httpRequestMessageBuilderFactory;
     private readonly IServiceProvider serviceProvider;
     private readonly ILogger<ImageCache> logger;
 
@@ -169,38 +173,49 @@ internal sealed partial class ImageCache : IImageCache, IImageCacheFilePathOpera
         HttpClient httpClient = httpClientFactory.CreateClient(nameof(ImageCache));
         while (retryCount < 3)
         {
-            using (HttpResponseMessage message = await httpClient.GetAsync(uri, HttpCompletionOption.ResponseHeadersRead).ConfigureAwait(false))
-            {
-                if (message.RequestMessage is { RequestUri: { } target } && target != uri)
-                {
-                    logger.LogDebug("The Request '{Source}' has been redirected to '{Target}'", uri, target);
-                }
+            HttpRequestMessageBuilder requestMessageBuilder = httpRequestMessageBuilderFactory
+                .Create()
+                .SetRequestUri(uri)
 
-                if (message.IsSuccessStatusCode)
+                // These headers are only available for our own api
+                .SetStaticResourceControlHeadersIf(uri.Host.Contains("api.snapgenshin.com", StringComparison.OrdinalIgnoreCase))
+                .Get();
+
+            using (HttpRequestMessage requestMessage = requestMessageBuilder.HttpRequestMessage)
+            {
+                using (HttpResponseMessage responseMessage = await httpClient.SendAsync(requestMessage, HttpCompletionOption.ResponseHeadersRead).ConfigureAwait(false))
                 {
-                    using (Stream httpStream = await message.Content.ReadAsStreamAsync().ConfigureAwait(false))
+                    if (responseMessage.RequestMessage is { RequestUri: { } target } && target != uri)
                     {
-                        using (FileStream fileStream = File.Create(baseFile))
+                        logger.LogDebug("The Request '{Source}' has been redirected to '{Target}'", uri, target);
+                    }
+
+                    if (responseMessage.IsSuccessStatusCode)
+                    {
+                        using (Stream httpStream = await responseMessage.Content.ReadAsStreamAsync().ConfigureAwait(false))
                         {
-                            await httpStream.CopyToAsync(fileStream).ConfigureAwait(false);
-                            return;
+                            using (FileStream fileStream = File.Create(baseFile))
+                            {
+                                await httpStream.CopyToAsync(fileStream).ConfigureAwait(false);
+                                return;
+                            }
                         }
                     }
-                }
 
-                switch (message.StatusCode)
-                {
-                    case HttpStatusCode.TooManyRequests:
-                        {
-                            retryCount++;
-                            TimeSpan delay = message.Headers.RetryAfter?.Delta ?? retryCountToDelay[retryCount];
-                            logger.LogInformation("Retry download '{Uri}' after {Delay}.", uri, delay);
-                            await Task.Delay(delay).ConfigureAwait(false);
-                            break;
-                        }
+                    switch (responseMessage.StatusCode)
+                    {
+                        case HttpStatusCode.TooManyRequests:
+                            {
+                                retryCount++;
+                                TimeSpan delay = responseMessage.Headers.RetryAfter?.Delta ?? retryCountToDelay[retryCount];
+                                logger.LogInformation("Retry download '{Uri}' after {Delay}.", uri, delay);
+                                await Task.Delay(delay).ConfigureAwait(false);
+                                break;
+                            }
 
-                    default:
-                        return;
+                        default:
+                            return;
+                    }
                 }
             }
         }

src/Snap.Hutao/Snap.Hutao/Core/Collection/TwoEnumerbleEnumerator.cs

@@ -0,0 +1,32 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Core.Collection;
+
+internal sealed class TwoEnumerbleEnumerator<TFirst, TSecond> : IDisposable
+{
+    private readonly IEnumerator<TFirst> firstEnumerator;
+    private readonly IEnumerator<TSecond> secondEnumerator;
+
+    public TwoEnumerbleEnumerator(IEnumerable<TFirst> firstEnumerable, IEnumerable<TSecond> secondEnumerable)
+    {
+        firstEnumerator = firstEnumerable.GetEnumerator();
+        secondEnumerator = secondEnumerable.GetEnumerator();
+    }
+
+    public (TFirst First, TSecond Second) Current { get => (firstEnumerator.Current, secondEnumerator.Current); }
+
+    public bool MoveNext(ref bool moveFirst, ref bool moveSecond)
+    {
+        moveFirst = moveFirst && firstEnumerator.MoveNext();
+        moveSecond = moveSecond && secondEnumerator.MoveNext();
+
+        return moveFirst || moveSecond;
+    }
+
+    public void Dispose()
+    {
+        firstEnumerator.Dispose();
+        secondEnumerator.Dispose();
+    }
+}

src/Snap.Hutao/Snap.Hutao/Core/Database/DbSetExtension.cs

@@ -13,13 +13,6 @@ namespace Snap.Hutao.Core.Database;
 [HighQuality]
 internal static class DbSetExtension
 {
-    /// <summary>
-    /// 添加并保存
-    /// </summary>
-    /// <typeparam name="TEntity">实体类型</typeparam>
-    /// <param name="dbSet">数据库集</param>
-    /// <param name="entity">实体</param>
-    /// <returns>影响条数</returns>
     public static int AddAndSave<TEntity>(this DbSet<TEntity> dbSet, TEntity entity)
         where TEntity : class
     {
@@ -27,27 +20,13 @@ internal static class DbSetExtension
         return dbSet.SaveChangesAndClearChangeTracker();
     }
 
-    /// <summary>
-    /// 异步添加并保存
-    /// </summary>
-    /// <typeparam name="TEntity">实体类型</typeparam>
-    /// <param name="dbSet">数据库集</param>
-    /// <param name="entity">实体</param>
-    /// <returns>影响条数</returns>
-    public static ValueTask<int> AddAndSaveAsync<TEntity>(this DbSet<TEntity> dbSet, TEntity entity)
+    public static ValueTask<int> AddAndSaveAsync<TEntity>(this DbSet<TEntity> dbSet, TEntity entity, CancellationToken token = default)
         where TEntity : class
     {
         dbSet.Add(entity);
-        return dbSet.SaveChangesAndClearChangeTrackerAsync();
+        return dbSet.SaveChangesAndClearChangeTrackerAsync(token);
     }
 
-    /// <summary>
-    /// 添加列表并保存
-    /// </summary>
-    /// <typeparam name="TEntity">实体类型</typeparam>
-    /// <param name="dbSet">数据库集</param>
-    /// <param name="entities">实体</param>
-    /// <returns>影响条数</returns>
     public static int AddRangeAndSave<TEntity>(this DbSet<TEntity> dbSet, IEnumerable<TEntity> entities)
         where TEntity : class
     {
@@ -55,27 +34,13 @@ internal static class DbSetExtension
         return dbSet.SaveChangesAndClearChangeTracker();
     }
 
-    /// <summary>
-    /// 异步添加列表并保存
-    /// </summary>
-    /// <typeparam name="TEntity">实体类型</typeparam>
-    /// <param name="dbSet">数据库集</param>
-    /// <param name="entities">实体</param>
-    /// <returns>影响条数</returns>
-    public static ValueTask<int> AddRangeAndSaveAsync<TEntity>(this DbSet<TEntity> dbSet, IEnumerable<TEntity> entities)
+    public static ValueTask<int> AddRangeAndSaveAsync<TEntity>(this DbSet<TEntity> dbSet, IEnumerable<TEntity> entities, CancellationToken token = default)
         where TEntity : class
     {
         dbSet.AddRange(entities);
-        return dbSet.SaveChangesAndClearChangeTrackerAsync();
+        return dbSet.SaveChangesAndClearChangeTrackerAsync(token);
     }
 
-    /// <summary>
-    /// 移除并保存
-    /// </summary>
-    /// <typeparam name="TEntity">实体类型</typeparam>
-    /// <param name="dbSet">数据库集</param>
-    /// <param name="entity">实体</param>
-    /// <returns>影响条数</returns>
     public static int RemoveAndSave<TEntity>(this DbSet<TEntity> dbSet, TEntity entity)
         where TEntity : class
     {
@@ -83,27 +48,13 @@ internal static class DbSetExtension
         return dbSet.SaveChangesAndClearChangeTracker();
     }
 
-    /// <summary>
-    /// 异步移除并保存
-    /// </summary>
-    /// <typeparam name="TEntity">实体类型</typeparam>
-    /// <param name="dbSet">数据库集</param>
-    /// <param name="entity">实体</param>
-    /// <returns>影响条数</returns>
-    public static ValueTask<int> RemoveAndSaveAsync<TEntity>(this DbSet<TEntity> dbSet, TEntity entity)
+    public static ValueTask<int> RemoveAndSaveAsync<TEntity>(this DbSet<TEntity> dbSet, TEntity entity, CancellationToken token = default)
         where TEntity : class
     {
         dbSet.Remove(entity);
-        return dbSet.SaveChangesAndClearChangeTrackerAsync();
+        return dbSet.SaveChangesAndClearChangeTrackerAsync(token);
     }
 
-    /// <summary>
-    /// 更新并保存
-    /// </summary>
-    /// <typeparam name="TEntity">实体类型</typeparam>
-    /// <param name="dbSet">数据库集</param>
-    /// <param name="entity">实体</param>
-    /// <returns>影响条数</returns>
     public static int UpdateAndSave<TEntity>(this DbSet<TEntity> dbSet, TEntity entity)
         where TEntity : class
     {
@@ -111,18 +62,11 @@ internal static class DbSetExtension
         return dbSet.SaveChangesAndClearChangeTracker();
     }
 
-    /// <summary>
-    /// 异步更新并保存
-    /// </summary>
-    /// <typeparam name="TEntity">实体类型</typeparam>
-    /// <param name="dbSet">数据库集</param>
-    /// <param name="entity">实体</param>
-    /// <returns>影响条数</returns>
-    public static ValueTask<int> UpdateAndSaveAsync<TEntity>(this DbSet<TEntity> dbSet, TEntity entity)
+    public static ValueTask<int> UpdateAndSaveAsync<TEntity>(this DbSet<TEntity> dbSet, TEntity entity, CancellationToken token = default)
         where TEntity : class
     {
         dbSet.Update(entity);
-        return dbSet.SaveChangesAndClearChangeTrackerAsync();
+        return dbSet.SaveChangesAndClearChangeTrackerAsync(token);
     }
 
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
@@ -136,11 +80,11 @@ internal static class DbSetExtension
     }
 
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    private static async ValueTask<int> SaveChangesAndClearChangeTrackerAsync<TEntity>(this DbSet<TEntity> dbSet)
+    private static async ValueTask<int> SaveChangesAndClearChangeTrackerAsync<TEntity>(this DbSet<TEntity> dbSet, CancellationToken token = default)
         where TEntity : class
     {
         DbContext dbContext = dbSet.Context();
-        int count = await dbContext.SaveChangesAsync().ConfigureAwait(false);
+        int count = await dbContext.SaveChangesAsync(token).ConfigureAwait(false);
         dbContext.ChangeTracker.Clear();
         return count;
     }

src/Snap.Hutao/Snap.Hutao/Core/Database/ScopedDbCurrent.cs

@@ -38,7 +38,7 @@ internal sealed partial class ScopedDbCurrent<TEntity, TMessage>
                 return;
             }
 
-            if (serviceProvider.IsDisposedSlow())
+            if (serviceProvider.IsDisposed())
             {
                 return;
             }
@@ -96,7 +96,7 @@ internal sealed partial class ScopedDbCurrent<TEntityOnly, TEntity, TMessage>
                 return;
             }
 
-            if (serviceProvider.IsDisposedSlow())
+            if (serviceProvider.IsDisposed())
             {
                 return;
             }

src/Snap.Hutao/Snap.Hutao/Core/DependencyInjection/IocConfiguration.cs

@@ -33,17 +33,17 @@ internal static class IocConfiguration
         return services
             .AddTransient(typeof(Database.ScopedDbCurrent<,>))
             .AddTransient(typeof(Database.ScopedDbCurrent<,,>))
-            .AddDbContext<AppDbContext>(AddDbContextCore);
+            .AddDbContextPool<AppDbContext>(AddDbContextCore);
     }
 
-    private static void AddDbContextCore(IServiceProvider provider, DbContextOptionsBuilder builder)
+    private static void AddDbContextCore(IServiceProvider serviceProvider, DbContextOptionsBuilder builder)
     {
-        RuntimeOptions runtimeOptions = provider.GetRequiredService<RuntimeOptions>();
+        RuntimeOptions runtimeOptions = serviceProvider.GetRequiredService<RuntimeOptions>();
         string dbFile = System.IO.Path.Combine(runtimeOptions.DataFolder, "Userdata.db");
         string sqlConnectionString = $"Data Source={dbFile}";
 
         // Temporarily create a context
-        using (AppDbContext context = AppDbContext.Create(sqlConnectionString))
+        using (AppDbContext context = AppDbContext.Create(serviceProvider, sqlConnectionString))
         {
             if (context.Database.GetPendingMigrations().Any())
             {

src/Snap.Hutao/Snap.Hutao/Core/DependencyInjection/ServiceProviderExtension.cs

@@ -18,13 +18,22 @@ internal static class ServiceProviderExtension
     }
 
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public static bool IsDisposedSlow(this IServiceProvider? serviceProvider)
+    public static bool IsDisposed(this IServiceProvider? serviceProvider)
     {
         if (serviceProvider is null)
         {
             return true;
         }
 
+        if (serviceProvider is ServiceProvider serviceProviderImpl)
+        {
+            return GetPrivateDisposed(serviceProviderImpl);
+        }
+
         return serviceProvider.GetType().GetField("_disposed")?.GetValue(serviceProvider) is true;
     }
+
+    // private bool _disposed;
+    [UnsafeAccessor(UnsafeAccessorKind.Field, Name = "_disposed")]
+    private static extern ref bool GetPrivateDisposed(ServiceProvider serviceProvider);
 }

src/Snap.Hutao/Snap.Hutao/Core/Diagnostics/MeasureExecutionToken.cs

@@ -1,5 +1,7 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
+using Snap.Hutao.Core.Logging;
+
 namespace Snap.Hutao.Core.Diagnostics;
 
 internal readonly struct MeasureExecutionToken : IDisposable
@@ -17,6 +19,6 @@ internal readonly struct MeasureExecutionToken : IDisposable
 
     public void Dispose()
     {
-        logger.LogDebug("{Caller} toke {Time} ms", callerName, stopwatch.GetElapsedTime().TotalMilliseconds);
+        logger.LogColorizedDebug(("{Caller} toke {Time} ms", ConsoleColor.Gray), (callerName, ConsoleColor.Yellow), (stopwatch.GetElapsedTime().TotalMilliseconds, ConsoleColor.DarkGreen));
     }
 }

src/Snap.Hutao/Snap.Hutao/Core/ExceptionService/HutaoException.cs

@@ -5,46 +5,43 @@ namespace Snap.Hutao.Core.ExceptionService;
 
 internal sealed class HutaoException : Exception
 {
-    public HutaoException(HutaoExceptionKind kind, string message, Exception? innerException)
-        : this(message, innerException)
-    {
-        Kind = kind;
-    }
-
-    private HutaoException(string message, Exception? innerException)
+    public HutaoException(string message, Exception? innerException)
         : base($"{message}\n{innerException?.Message}", innerException)
     {
     }
 
-    public HutaoExceptionKind Kind { get; private set; }
-
     [DoesNotReturn]
-    public static HutaoException Throw(HutaoExceptionKind kind, string message, Exception? innerException = default)
+    public static HutaoException Throw(string message, Exception? innerException = default)
     {
-        throw new HutaoException(kind, message, innerException);
+        throw new HutaoException(message, innerException);
     }
 
-    public static void ThrowIf(bool condition, HutaoExceptionKind kind, string message, Exception? innerException = default)
+    public static void ThrowIf(bool condition, string message, Exception? innerException = default)
     {
         if (condition)
         {
-            throw new HutaoException(kind, message, innerException);
+            throw new HutaoException(message, innerException);
         }
     }
 
-    public static void ThrowIfNot(bool condition, HutaoExceptionKind kind, string message, Exception? innerException = default)
+    public static void ThrowIfNot(bool condition, string message, Exception? innerException = default)
     {
         if (!condition)
         {
-            throw new HutaoException(kind, message, innerException);
+            throw new HutaoException(message, innerException);
         }
     }
 
     [DoesNotReturn]
     public static HutaoException GachaStatisticsInvalidItemId(uint id, Exception? innerException = default)
     {
-        string message = SH.FormatServiceGachaStatisticsFactoryItemIdInvalid(id);
-        throw new HutaoException(HutaoExceptionKind.GachaStatisticsInvalidItemId, message, innerException);
+        throw new HutaoException(SH.FormatServiceGachaStatisticsFactoryItemIdInvalid(id), innerException);
+    }
+
+    [DoesNotReturn]
+    public static HutaoException UserdataCorrupted(string message, Exception? innerException = default)
+    {
+        throw new HutaoException(message, innerException);
     }
 
     [DoesNotReturn]
@@ -54,6 +51,12 @@ internal sealed class HutaoException : Exception
         throw new InvalidCastException(message, innerException);
     }
 
+    [DoesNotReturn]
+    public static NotSupportedException NotSupported(string? message = default, Exception? innerException = default)
+    {
+        throw new NotSupportedException(message, innerException);
+    }
+
     [DoesNotReturn]
     public static OperationCanceledException OperationCanceled(string message, Exception? innerException = default)
     {

src/Snap.Hutao/Snap.Hutao/Core/ExceptionService/HutaoExceptionKind.cs

@@ -9,6 +9,8 @@ internal enum HutaoExceptionKind
 
     // Foundation
     ImageCacheInvalidUri,
+    DatabaseCorrupted,
+    UserdataCorrupted,
 
     // IO
     FileSystemCreateFileInsufficientPermissions,
@@ -17,4 +19,5 @@ internal enum HutaoExceptionKind
     // Service
     GachaStatisticsInvalidItemId,
     GameFpsUnlockingFailed,
+    GameConfigInvalidChannelOptions,
 }

src/Snap.Hutao/Snap.Hutao/Core/IO/FileOperation.cs

@@ -1,7 +1,13 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
+using Snap.Hutao.Win32.Foundation;
+using Snap.Hutao.Win32.System.Com;
+using Snap.Hutao.Win32.UI.Shell;
 using System.IO;
+using static Snap.Hutao.Win32.Macros;
+using static Snap.Hutao.Win32.Ole32;
+using static Snap.Hutao.Win32.Shell32;
 
 namespace Snap.Hutao.Core.IO;
 
@@ -39,4 +45,57 @@ internal static class FileOperation
         File.Move(sourceFileName, destFileName, false);
         return true;
     }
+
+    public static unsafe bool UnsafeMove(string sourceFileName, string destFileName)
+    {
+        bool result = false;
+
+        if (SUCCEEDED(CoCreateInstance(in Win32.UI.Shell.FileOperation.CLSID, default, CLSCTX.CLSCTX_INPROC_SERVER, in IFileOperation.IID, out IFileOperation* pFileOperation)))
+        {
+            if (SUCCEEDED(SHCreateItemFromParsingName(sourceFileName, default, in IShellItem.IID, out IShellItem* pSourceShellItem)))
+            {
+                if (SUCCEEDED(SHCreateItemFromParsingName(destFileName, default, in IShellItem.IID, out IShellItem* pDestShellItem)))
+                {
+                    pFileOperation->MoveItem(pSourceShellItem, pDestShellItem, default, default);
+
+                    if (SUCCEEDED(pFileOperation->PerformOperations()))
+                    {
+                        result = true;
+                    }
+
+                    pDestShellItem->Release();
+                }
+
+                pSourceShellItem->Release();
+            }
+
+            pFileOperation->Release();
+        }
+
+        return result;
+    }
+
+    public static unsafe bool UnsafeDelete(string path)
+    {
+        bool result = false;
+
+        if (SUCCEEDED(CoCreateInstance(in Win32.UI.Shell.FileOperation.CLSID, default, CLSCTX.CLSCTX_INPROC_SERVER, in IFileOperation.IID, out IFileOperation* pFileOperation)))
+        {
+            if (SUCCEEDED(SHCreateItemFromParsingName(path, default, in IShellItem.IID, out IShellItem* pShellItem)))
+            {
+                pFileOperation->DeleteItem(pShellItem, default);
+
+                if (SUCCEEDED(pFileOperation->PerformOperations()))
+                {
+                    result = true;
+                }
+
+                pShellItem->Release();
+            }
+
+            pFileOperation->Release();
+        }
+
+        return result;
+    }
 }

src/Snap.Hutao/Snap.Hutao/Core/IO/Hashing/Hash.cs

@@ -10,7 +10,7 @@ internal static class Hash
 {
     public static string SHA1HexString(string input)
     {
-        return HashCore(BitConverter.ToString, SHA1.HashData, Encoding.UTF8.GetBytes, input);
+        return HashCore(System.Convert.ToHexString, SHA1.HashData, Encoding.UTF8.GetBytes, input);
     }
 
     private static TResult HashCore<TInput, TResult>(Func<byte[], TResult> resultConverter, Func<byte[], byte[]> hashMethod, Func<TInput, byte[]> bytesConverter, TInput input)

src/Snap.Hutao/Snap.Hutao/Core/IO/Http/Sharding/HttpShardCopyWorker.cs

@@ -3,6 +3,7 @@
 
 using Microsoft.Win32.SafeHandles;
 using Snap.Hutao.Core.Diagnostics;
+using System.Buffers;
 using System.IO;
 using System.Net.Http;
 
@@ -77,34 +78,36 @@ internal sealed class HttpShardCopyWorker<TStatus> : IDisposable
                 using (HttpResponseMessage response = await httpClient.SendAsync(request, HttpCompletionOption.ResponseHeadersRead, token).ConfigureAwait(false))
                 {
                     response.EnsureSuccessStatusCode();
-
-                    Memory<byte> buffer = new byte[bufferSize];
-                    using (Stream stream = await response.Content.ReadAsStreamAsync(token).ConfigureAwait(false))
+                    using (IMemoryOwner<byte> memoryOwner = MemoryPool<byte>.Shared.Rent())
                     {
-                        int totalBytesRead = 0;
-                        int bytesReadAfterPreviousReport = 0;
-                        do
+                        Memory<byte> buffer = memoryOwner.Memory;
+                        using (Stream stream = await response.Content.ReadAsStreamAsync(token).ConfigureAwait(false))
                         {
-                            int bytesRead = await stream.ReadAsync(buffer, token).ConfigureAwait(false);
-                            if (bytesRead <= 0)
+                            int totalBytesRead = 0;
+                            int bytesReadAfterPreviousReport = 0;
+                            do
                             {
-                                progress.Report(new(bytesReadAfterPreviousReport));
-                                bytesReadAfterPreviousReport = 0;
-                                break;
-                            }
+                                int bytesRead = await stream.ReadAsync(buffer, token).ConfigureAwait(false);
+                                if (bytesRead <= 0)
+                                {
+                                    progress.Report(new(bytesReadAfterPreviousReport));
+                                    bytesReadAfterPreviousReport = 0;
+                                    break;
+                                }
 
-                            await RandomAccess.WriteAsync(destFileHandle, buffer[..bytesRead], shard.StartOffset + totalBytesRead, token).ConfigureAwait(false);
+                                await RandomAccess.WriteAsync(destFileHandle, buffer[..bytesRead], shard.StartOffset + totalBytesRead, token).ConfigureAwait(false);
 
-                            totalBytesRead += bytesRead;
-                            bytesReadAfterPreviousReport += bytesRead;
-                            if (stopwatch.GetElapsedTime().TotalMilliseconds > 500)
-                            {
-                                progress.Report(new(bytesReadAfterPreviousReport));
-                                bytesReadAfterPreviousReport = 0;
-                                stopwatch = ValueStopwatch.StartNew();
+                                totalBytesRead += bytesRead;
+                                bytesReadAfterPreviousReport += bytesRead;
+                                if (stopwatch.GetElapsedTime().TotalMilliseconds > 500)
+                                {
+                                    progress.Report(new(bytesReadAfterPreviousReport));
+                                    bytesReadAfterPreviousReport = 0;
+                                    stopwatch = ValueStopwatch.StartNew();
+                                }
                             }
+                            while (true);
                         }
-                        while (true);
                     }
                 }
             }

src/Snap.Hutao/Snap.Hutao/Core/IO/StreamCopyWorker.cs

@@ -2,6 +2,7 @@
 // Licensed under the MIT license.
 
 using Snap.Hutao.Core.Diagnostics;
+using System.Buffers;
 using System.IO;
 
 namespace Snap.Hutao.Core.IO;
@@ -51,26 +52,30 @@ internal class StreamCopyWorker<TStatus>
 
         long totalBytesRead = 0;
         int bytesRead;
-        Memory<byte> buffer = new byte[bufferSize];
 
-        do
+        using (IMemoryOwner<byte> memoryOwner = MemoryPool<byte>.Shared.Rent(bufferSize))
         {
-            bytesRead = await source.ReadAsync(buffer).ConfigureAwait(false);
-            if (bytesRead == 0)
-            {
-                progress.Report(statusFactory(totalBytesRead));
-                break;
-            }
+            Memory<byte> buffer = memoryOwner.Memory;
 
-            await destination.WriteAsync(buffer[..bytesRead]).ConfigureAwait(false);
-
-            totalBytesRead += bytesRead;
-            if (stopwatch.GetElapsedTime().TotalMilliseconds > 1000)
+            do
             {
-                progress.Report(statusFactory(totalBytesRead));
-                stopwatch = ValueStopwatch.StartNew();
+                bytesRead = await source.ReadAsync(buffer).ConfigureAwait(false);
+                if (bytesRead is 0)
+                {
+                    progress.Report(statusFactory(totalBytesRead));
+                    break;
+                }
+
+                await destination.WriteAsync(buffer[..bytesRead]).ConfigureAwait(false);
+
+                totalBytesRead += bytesRead;
+                if (stopwatch.GetElapsedTime().TotalMilliseconds > 1000)
+                {
+                    progress.Report(statusFactory(totalBytesRead));
+                    stopwatch = ValueStopwatch.StartNew();
+                }
             }
+            while (bytesRead > 0);
         }
-        while (bytesRead > 0);
     }
 }

src/Snap.Hutao/Snap.Hutao/Core/IO/StreamReaderWriter.cs

@@ -0,0 +1,40 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using System.IO;
+
+namespace Snap.Hutao.Core.IO;
+
+internal sealed class StreamReaderWriter : IDisposable
+{
+    private readonly StreamReader reader;
+    private readonly StreamWriter writer;
+
+    public StreamReaderWriter(StreamReader reader, StreamWriter writer)
+    {
+        this.reader = reader;
+        this.writer = writer;
+    }
+
+    public StreamReader Reader { get => reader; }
+
+    public StreamWriter Writer { get => writer; }
+
+    /// <inheritdoc cref="StreamReader.ReadLineAsync(CancellationToken)"/>
+    public ValueTask<string?> ReadLineAsync(CancellationToken token)
+    {
+        return reader.ReadLineAsync(token);
+    }
+
+    /// <inheritdoc cref="StreamWriter.WriteAsync(string?)"/>
+    public Task WriteAsync(string value)
+    {
+        return writer.WriteAsync(value);
+    }
+
+    public void Dispose()
+    {
+        writer.Dispose();
+        reader.Dispose();
+    }
+}

src/Snap.Hutao/Snap.Hutao/Core/IO/TempFile.cs

@@ -29,7 +29,7 @@ internal readonly struct TempFile : IDisposable
         }
         catch (UnauthorizedAccessException ex)
         {
-            HutaoException.Throw(HutaoExceptionKind.FileSystemCreateFileInsufficientPermissions, SH.CoreIOTempFileCreateFail, ex);
+            HutaoException.Throw(SH.CoreIOTempFileCreateFail, ex);
         }
 
         if (delete)

src/Snap.Hutao/Snap.Hutao/Core/LifeCycle/Activation.cs

@@ -116,15 +116,15 @@ internal sealed partial class Activation : IActivation
 
         // If it's the first time launch, we show the guide window anyway.
         // Otherwise, we check if there's any unfulfilled resource category present.
-        if (UnsafeLocalSetting.Get(SettingKeys.Major1Minor7Revision0GuideState, GuideState.Language) >= GuideState.StaticResourceBegin)
+        if (UnsafeLocalSetting.Get(SettingKeys.Major1Minor10Revision0GuideState, GuideState.Language) >= GuideState.StaticResourceBegin)
         {
             if (StaticResource.IsAnyUnfulfilledCategoryPresent())
             {
-                UnsafeLocalSetting.Set(SettingKeys.Major1Minor7Revision0GuideState, GuideState.StaticResourceBegin);
+                UnsafeLocalSetting.Set(SettingKeys.Major1Minor10Revision0GuideState, GuideState.StaticResourceBegin);
             }
         }
 
-        if (UnsafeLocalSetting.Get(SettingKeys.Major1Minor7Revision0GuideState, GuideState.Language) < GuideState.Completed)
+        if (UnsafeLocalSetting.Get(SettingKeys.Major1Minor10Revision0GuideState, GuideState.Language) < GuideState.Completed)
         {
             await taskContext.SwitchToMainThreadAsync();
             serviceProvider.GetRequiredService<GuideWindow>();

src/Snap.Hutao/Snap.Hutao/Core/LifeCycle/InterProcess/PrivateNamedPipeServer.cs

@@ -49,7 +49,7 @@ internal sealed partial class PrivateNamedPipeServer : IDisposable
     {
         byte[] content = new byte[header->ContentLength];
         serverStream.ReadAtLeast(content, header->ContentLength, false);
-        HutaoException.ThrowIf(XxHash64.HashToUInt64(content) != header->Checksum, HutaoExceptionKind.PrivateNamedPipeContentHashIncorrect, "PipePacket Content Hash incorrect");
+        HutaoException.ThrowIf(XxHash64.HashToUInt64(content) != header->Checksum, "PipePacket Content Hash incorrect");
         return content;
     }
 

src/Snap.Hutao/Snap.Hutao/Core/Logging/LogArgument.cs

@@ -21,6 +21,11 @@ internal readonly struct LogArgument
         return new(argument);
     }
 
+    public static implicit operator LogArgument(double argument)
+    {
+        return new(argument);
+    }
+
     public static implicit operator LogArgument((object? Argument, ConsoleColor Foreground) tuple)
     {
         return new(tuple.Argument, tuple.Foreground);

src/Snap.Hutao/Snap.Hutao/Core/Setting/SettingKeys.cs

@@ -20,7 +20,9 @@ internal static class SettingKeys
     #region Application
     public const string LaunchTimes = "LaunchTimes";
     public const string DataFolderPath = "DataFolderPath";
-    public const string Major1Minor7Revision0GuideState = "Major1Minor7Revision0GuideState";
+    public const string Major1Minor10Revision0GuideState = "Major1Minor10Revision0GuideState1";
+    public const string StaticResourceImageQuality = "StaticResourceImageQuality";
+    public const string StaticResourceImageArchive = "StaticResourceImageArchive";
     public const string HotKeyMouseClickRepeatForever = "HotKeyMouseClickRepeatForever";
     public const string IsAllocConsoleDebugModeEnabled = "IsAllocConsoleDebugModeEnabled2";
     #endregion
@@ -60,6 +62,10 @@ internal static class SettingKeys
     #endregion
 
     #region Obsolete
+
+    [Obsolete("重置新手引导状态")]
+    public const string Major1Minor7Revision0GuideState = "Major1Minor7Revision0GuideState";
+
     [Obsolete("重置调试控制台开关")]
     public const string IsAllocConsoleDebugModeEnabledLegacy1 = "IsAllocConsoleDebugModeEnabled";
     #endregion

src/Snap.Hutao/Snap.Hutao/Core/Shell/ShellLinkInterop.cs

@@ -21,22 +21,27 @@ internal sealed partial class ShellLinkInterop : IShellLinkInterop
     public async ValueTask<bool> TryCreateDesktopShoutcutForElevatedLaunchAsync()
     {
         string targetLogoPath = Path.Combine(runtimeOptions.DataFolder, "ShellLinkLogo.ico");
+        string elevatedLauncherPath = Path.Combine(runtimeOptions.DataFolder, "Snap.Hutao.Elevated.Launcher.exe");
 
         try
         {
             Uri sourceLogoUri = "ms-appx:///Assets/Logo.ico".ToUri();
             StorageFile iconFile = await StorageFile.GetFileFromApplicationUriAsync(sourceLogoUri);
             await iconFile.OverwriteCopyAsync(targetLogoPath).ConfigureAwait(false);
+
+            Uri elevatedLauncherUri = "ms-appx:///Snap.Hutao.Elevated.Launcher.exe".ToUri();
+            StorageFile launcherFile = await StorageFile.GetFileFromApplicationUriAsync(elevatedLauncherUri);
+            await launcherFile.OverwriteCopyAsync(elevatedLauncherPath).ConfigureAwait(false);
         }
         catch
         {
             return false;
         }
 
-        return UnsafeTryCreateDesktopShoutcutForElevatedLaunch(targetLogoPath);
+        return UnsafeTryCreateDesktopShoutcutForElevatedLaunch(targetLogoPath, elevatedLauncherPath);
     }
 
-    private unsafe bool UnsafeTryCreateDesktopShoutcutForElevatedLaunch(string targetLogoPath)
+    private unsafe bool UnsafeTryCreateDesktopShoutcutForElevatedLaunch(string targetLogoPath, string elevatedLauncherPath)
     {
         bool result = false;
 
@@ -44,17 +49,11 @@ internal sealed partial class ShellLinkInterop : IShellLinkInterop
         HRESULT hr = CoCreateInstance(in ShellLink.CLSID, default, CLSCTX.CLSCTX_INPROC_SERVER, in IShellLinkW.IID, out IShellLinkW* pShellLink);
         if (SUCCEEDED(hr))
         {
-            pShellLink->SetPath($"shell:AppsFolder\\{runtimeOptions.FamilyName}!App");
+            pShellLink->SetPath(elevatedLauncherPath);
+            pShellLink->SetArguments(runtimeOptions.FamilyName);
             pShellLink->SetShowCmd(SHOW_WINDOW_CMD.SW_NORMAL);
             pShellLink->SetIconLocation(targetLogoPath, 0);
 
-            if (SUCCEEDED(pShellLink->QueryInterface(in IShellLinkDataList.IID, out IShellLinkDataList* pShellLinkDataList)))
-            {
-                pShellLinkDataList->GetFlags(out uint flags);
-                pShellLinkDataList->SetFlags(flags | (uint)SHELL_LINK_DATA_FLAGS.SLDF_RUNAS_USER);
-                pShellLinkDataList->Release();
-            }
-
             if (SUCCEEDED(pShellLink->QueryInterface(in IPersistFile.IID, out IPersistFile* pPersistFile)))
             {
                 string desktop = Environment.GetFolderPath(Environment.SpecialFolder.Desktop);

src/Snap.Hutao/Snap.Hutao/Extension/EnumerableExtension.List.cs

@@ -118,14 +118,6 @@ internal static partial class EnumerableExtension
         collection.RemoveAt(collection.Count - 1);
     }
 
-    /// <summary>
-    /// 转换到新类型的列表
-    /// </summary>
-    /// <typeparam name="TSource">原始类型</typeparam>
-    /// <typeparam name="TResult">新类型</typeparam>
-    /// <param name="list">列表</param>
-    /// <param name="selector">选择器</param>
-    /// <returns>新类型的列表</returns>
     [Pure]
     public static List<TResult> SelectList<TSource, TResult>(this List<TSource> list, Func<TSource, TResult> selector)
     {

src/Snap.Hutao/Snap.Hutao/GuideWindow.xaml

@@ -8,7 +8,7 @@
     xmlns:shvg="using:Snap.Hutao.View.Guide"
     mc:Ignorable="d">
 
-    <Grid x:Name="RootGrid">
+    <Grid x:Name="RootGrid" Background="{ThemeResource SolidBackgroundFillColorBaseBrush}">
         <Grid.RowDefinitions>
             <RowDefinition Height="auto"/>
             <RowDefinition/>

src/Snap.Hutao/Snap.Hutao/GuideWindow.xaml.cs

@@ -14,10 +14,10 @@ namespace Snap.Hutao;
 internal sealed partial class GuideWindow : Window, IWindowOptionsSource, IMinMaxInfoHandler
 {
     private const int MinWidth = 1000;
-    private const int MinHeight = 600;
+    private const int MinHeight = 650;
 
     private const int MaxWidth = 1200;
-    private const int MaxHeight = 750;
+    private const int MaxHeight = 800;
 
     private readonly WindowOptions windowOptions;
 

src/Snap.Hutao/Snap.Hutao/IdentifyMonitorWindow.xaml.cs

@@ -27,4 +27,27 @@ internal sealed partial class IdentifyMonitorWindow : Window
     }
 
     public string Monitor { get; private set; }
+
+    public static async ValueTask IdentifyAllMonitorsAsync(int secondsDelay)
+    {
+        List<IdentifyMonitorWindow> windows = [];
+
+        IReadOnlyList<DisplayArea> displayAreas = DisplayArea.FindAll();
+        for (int i = 0; i < displayAreas.Count; i++)
+        {
+            windows.Add(new IdentifyMonitorWindow(displayAreas[i], i + 1));
+        }
+
+        foreach (IdentifyMonitorWindow window in windows)
+        {
+            window.Activate();
+        }
+
+        await Delay.FromSeconds(secondsDelay).ConfigureAwait(true);
+
+        foreach (IdentifyMonitorWindow window in windows)
+        {
+            window.Close();
+        }
+    }
 }

src/Snap.Hutao/Snap.Hutao/LaunchGameWindow.xaml.cs

@@ -2,6 +2,7 @@
 // Licensed under the MIT license.
 
 using Microsoft.UI.Xaml;
+using Snap.Hutao.Control.Extension;
 using Snap.Hutao.Core.Windowing;
 using Snap.Hutao.ViewModel.Game;
 using Snap.Hutao.Win32.UI.WindowsAndMessaging;
@@ -35,7 +36,7 @@ internal sealed partial class LaunchGameWindow : Window, IDisposable, IWindowOpt
         scope = serviceProvider.CreateScope();
         windowOptions = new(this, DragableGrid, new(MaxWidth, MaxHeight));
         this.InitializeController(serviceProvider);
-        RootGrid.DataContext = scope.ServiceProvider.GetRequiredService<LaunchGameViewModel>();
+        RootGrid.InitializeDataContext<LaunchGameViewModel>(scope.ServiceProvider);
     }
 
     /// <inheritdoc/>

src/Snap.Hutao/Snap.Hutao/Model/Entity/Abstraction/IAppDbEntity.cs

@@ -0,0 +1,9 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Model.Entity.Abstraction;
+
+internal interface IAppDbEntity
+{
+    Guid InnerId { get; }
+}

src/Snap.Hutao/Snap.Hutao/Model/Entity/Abstraction/IAppDbEntityHasArchive.cs

@@ -0,0 +1,9 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Model.Entity.Abstraction;
+
+internal interface IAppDbEntityHasArchive : IAppDbEntity
+{
+    Guid ArchiveId { get; }
+}

src/Snap.Hutao/Snap.Hutao/Model/Entity/Achievement.cs

@@ -16,8 +16,8 @@ namespace Snap.Hutao.Model.Entity;
 [HighQuality]
 [Table("achievements")]
 [SuppressMessage("", "SA1124")]
-internal sealed class Achievement
-    : IEquatable<Achievement>,
+internal sealed class Achievement : IAppDbEntityHasArchive,
+    IEquatable<Achievement>,
     IDbMappingForeignKeyFrom<Achievement, AchievementId>,
     IDbMappingForeignKeyFrom<Achievement, UIAFItem>
 {

src/Snap.Hutao/Snap.Hutao/Model/Entity/Database/AppDbContext.cs

@@ -2,6 +2,7 @@
 // Licensed under the MIT license.
 
 using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Infrastructure;
 using Snap.Hutao.Core.Logging;
 using Snap.Hutao.Model.Entity.Configuration;
 using System.Diagnostics;
@@ -24,18 +25,8 @@ internal sealed class AppDbContext : DbContext
     public AppDbContext(DbContextOptions<AppDbContext> options)
         : base(options)
     {
-    }
-
-    /// <summary>
-    /// 构造一个新的应用程序数据库上下文
-    /// </summary>
-    /// <param name="options">选项</param>
-    /// <param name="logger">日志器</param>
-    public AppDbContext(DbContextOptions<AppDbContext> options, ILogger<AppDbContext> logger)
-        : this(options)
-    {
-        this.logger = logger;
-        logger.LogColorizedInformation("{Name}[{Id}] {Action}", nameof(AppDbContext), (ContextId, ConsoleColor.DarkCyan), ("created", ConsoleColor.Green));
+        logger = this.GetService<ILogger<AppDbContext>>();
+        logger?.LogColorizedInformation("{Name}[{Id}] {Action}", nameof(AppDbContext), (ContextId, ConsoleColor.DarkCyan), ("created", ConsoleColor.Green));
     }
 
     public DbSet<SettingEntry> Settings { get; set; } = default!;
@@ -74,14 +65,14 @@ internal sealed class AppDbContext : DbContext
 
     public DbSet<SpiralAbyssEntry> SpiralAbysses { get; set; } = default!;
 
-    /// <summary>
-    /// 构造一个临时的应用程序数据库上下文
-    /// </summary>
-    /// <param name="sqlConnectionString">连接字符串</param>
-    /// <returns>应用程序数据库上下文</returns>
-    public static AppDbContext Create(string sqlConnectionString)
+    public static AppDbContext Create(IServiceProvider serviceProvider, string sqlConnectionString)
     {
-        return new(new DbContextOptionsBuilder<AppDbContext>().UseSqlite(sqlConnectionString).Options);
+        DbContextOptions<AppDbContext> options = new DbContextOptionsBuilder<AppDbContext>()
+            .UseApplicationServiceProvider(serviceProvider)
+            .UseSqlite(sqlConnectionString)
+            .Options;
+
+        return new(options);
     }
 
     /// <inheritdoc/>

src/Snap.Hutao/Snap.Hutao/Model/Entity/Database/AppDbContextDesignTimeFactory.cs

@@ -18,7 +18,7 @@ internal sealed class AppDbContextDesignTimeFactory : IDesignTimeDbContextFactor
 #if DEBUG
         // TODO: replace with your own database file path.
         string userdataDbName = @"D:\Hutao\Userdata.db";
-        return AppDbContext.Create($"Data Source={userdataDbName}");
+        return AppDbContext.Create(default!, $"Data Source={userdataDbName}");
 #else
         throw Must.NeverHappen();
 #endif

src/Snap.Hutao/Snap.Hutao/Model/Entity/SettingEntry.Constant.cs

@@ -19,6 +19,7 @@ internal sealed partial class SettingEntry
     public const string AnnouncementRegion = "AnnouncementRegion";
 
     public const string IsEmptyHistoryWishVisible = "IsEmptyHistoryWishVisible";
+    public const string IsUnobtainedWishItemVisible = "IsUnobtainedWishItemVisible";
 
     public const string GeetestCustomCompositeUrl = "GeetestCustomCompositeUrl";
 

src/Snap.Hutao/Snap.Hutao/Model/Intrinsic/QuestType.cs

@@ -0,0 +1,16 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Model.Intrinsic;
+
+internal enum QuestType
+{
+    AQ,
+    FQ,
+    LQ,
+    EQ,
+    DQ,
+    IQ,
+    VQ,
+    WQ,
+}

src/Snap.Hutao/Snap.Hutao/Model/Metadata/Converter/AvatarNameCardPicConverter.cs

@@ -11,11 +11,6 @@ namespace Snap.Hutao.Model.Metadata.Converter;
 [HighQuality]
 internal sealed class AvatarNameCardPicConverter : ValueConverter<Avatar.Avatar?, Uri>
 {
-    /// <summary>
-    /// 从角色转换到名片
-    /// </summary>
-    /// <param name="avatar">角色</param>
-    /// <returns>名片</returns>
     public static Uri AvatarToUri(Avatar.Avatar? avatar)
     {
         if (avatar is null)

src/Snap.Hutao/Snap.Hutao/Program.cs

@@ -2,6 +2,7 @@
 // Licensed under the MIT license.
 
 using Microsoft.UI.Xaml;
+using Snap.Hutao.Core;
 using System.Runtime.CompilerServices;
 using System.Runtime.InteropServices;
 using WinRT;

src/Snap.Hutao/Snap.Hutao/Resource/Localization/SH.en.resx

@@ -60,45 +60,45 @@
             : and then encoded with base64 encoding.
     -->
   <xsd:schema xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="root">
-    <xsd:import namespace="http://www.w3.org/XML/1998/namespace"/>
+    <xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
     <xsd:element name="root" msdata:IsDataSet="true">
       <xsd:complexType>
         <xsd:choice maxOccurs="unbounded">
           <xsd:element name="metadata">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" />
               </xsd:sequence>
-              <xsd:attribute name="name" use="required" type="xsd:string"/>
-              <xsd:attribute name="type" type="xsd:string"/>
-              <xsd:attribute name="mimetype" type="xsd:string"/>
-              <xsd:attribute ref="xml:space"/>
+              <xsd:attribute name="name" use="required" type="xsd:string" />
+              <xsd:attribute name="type" type="xsd:string" />
+              <xsd:attribute name="mimetype" type="xsd:string" />
+              <xsd:attribute ref="xml:space" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="assembly">
             <xsd:complexType>
-              <xsd:attribute name="alias" type="xsd:string"/>
-              <xsd:attribute name="name" type="xsd:string"/>
+              <xsd:attribute name="alias" type="xsd:string" />
+              <xsd:attribute name="name" type="xsd:string" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="data">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1"/>
-                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
               </xsd:sequence>
-              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1"/>
-              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3"/>
-              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4"/>
-              <xsd:attribute ref="xml:space"/>
+              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
+              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
+              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
+              <xsd:attribute ref="xml:space" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="resheader">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
               </xsd:sequence>
-              <xsd:attribute name="name" type="xsd:string" use="required"/>
+              <xsd:attribute name="name" type="xsd:string" use="required" />
             </xsd:complexType>
           </xsd:element>
         </xsd:choice>
@@ -653,7 +653,7 @@
   <data name="ServiceAchievementUIAFImportPickerTitile" xml:space="preserve">
     <value>Open UIAF Json File</value>
   </data>
-  <data name="ServiceAchievementUserdataCorruptedInnerIdNotUnique" xml:space="preserve">
+  <data name="ServiceAchievementUserdataCorruptedAchievementIdNotUnique" xml:space="preserve">
     <value>Multiple identical achievement IDs found in a single achievement archive</value>
   </data>
   <data name="ServiceAvatarInfoPropertyAtk" xml:space="preserve">
@@ -2922,13 +2922,19 @@
     <value>Weapon WIKI</value>
   </data>
   <data name="WebAnnouncementMatchPermanentActivityTime" xml:space="preserve">
-    <value>(?:〓Event Duration〓|〓Quest Start Time〓).*?\d\.\dthe Version update(?:after|)Permanently available</value>
+    <value>(?:〓Event Duration〓|〓Quest Start Time〓).*?Permanently.*?Version.*?(\d\.\d).*?update</value>
   </data>
   <data name="WebAnnouncementMatchPersistentActivityTime" xml:space="preserve">
-    <value>〓Event Duration〓.*?\d\.\d Available throughout the entirety of Version</value>
+    <value>〓Event Duration〓.*?Available throughout the entirety of Version (\d\.\d)</value>
   </data>
   <data name="WebAnnouncementMatchTransientActivityTime" xml:space="preserve">
-    <value>(?:〓Event Duration〓|Event Wish Duration|【Availability Duration】|〓Discount Period〓).*?(\d\.\dAfter the Version update).*?~.*?&amp;lt;t class="t_(?:gl|lc)".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+    <value>(?:〓Event Duration〓|Event Wish Duration|【Availability Duration】|〓Discount Period〓).*?After.*?(\d\.\d).*?&amp;lt;t class="t_(?:gl|lc)".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+  </data>
+  <data name="WebAnnouncementMatchVersionUpdatePreviewTime" xml:space="preserve">
+    <value>Dear.*?&amp;lt;t class=\"t_(?:gl|lc)\".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+  </data>
+  <data name="WebAnnouncementMatchVersionUpdatePreviewTitle" xml:space="preserve">
+    <value>Version \d\.\d Update Maintenance Preview</value>
   </data>
   <data name="WebAnnouncementMatchVersionUpdateTime" xml:space="preserve">
     <value>〓Update Maintenance Duration〓.+?&amp;lt;t class=\"t_(?:gl|lc)\".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>

src/Snap.Hutao/Snap.Hutao/Resource/Localization/SH.id.resx

@@ -60,45 +60,45 @@
             : and then encoded with base64 encoding.
     -->
   <xsd:schema xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="root">
-    <xsd:import namespace="http://www.w3.org/XML/1998/namespace"/>
+    <xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
     <xsd:element name="root" msdata:IsDataSet="true">
       <xsd:complexType>
         <xsd:choice maxOccurs="unbounded">
           <xsd:element name="metadata">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" />
               </xsd:sequence>
-              <xsd:attribute name="name" use="required" type="xsd:string"/>
-              <xsd:attribute name="type" type="xsd:string"/>
-              <xsd:attribute name="mimetype" type="xsd:string"/>
-              <xsd:attribute ref="xml:space"/>
+              <xsd:attribute name="name" use="required" type="xsd:string" />
+              <xsd:attribute name="type" type="xsd:string" />
+              <xsd:attribute name="mimetype" type="xsd:string" />
+              <xsd:attribute ref="xml:space" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="assembly">
             <xsd:complexType>
-              <xsd:attribute name="alias" type="xsd:string"/>
-              <xsd:attribute name="name" type="xsd:string"/>
+              <xsd:attribute name="alias" type="xsd:string" />
+              <xsd:attribute name="name" type="xsd:string" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="data">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1"/>
-                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
               </xsd:sequence>
-              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1"/>
-              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3"/>
-              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4"/>
-              <xsd:attribute ref="xml:space"/>
+              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
+              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
+              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
+              <xsd:attribute ref="xml:space" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="resheader">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
               </xsd:sequence>
-              <xsd:attribute name="name" type="xsd:string" use="required"/>
+              <xsd:attribute name="name" type="xsd:string" use="required" />
             </xsd:complexType>
           </xsd:element>
         </xsd:choice>
@@ -653,7 +653,7 @@
   <data name="ServiceAchievementUIAFImportPickerTitile" xml:space="preserve">
     <value>Buka berkas UIAF Json</value>
   </data>
-  <data name="ServiceAchievementUserdataCorruptedInnerIdNotUnique" xml:space="preserve">
+  <data name="ServiceAchievementUserdataCorruptedAchievementIdNotUnique" xml:space="preserve">
     <value>Terdapat beberapa ID pencapaian yang identik dalam satu arsip pencapaian</value>
   </data>
   <data name="ServiceAvatarInfoPropertyAtk" xml:space="preserve">
@@ -2922,13 +2922,19 @@
     <value>Senjata WIKI</value>
   </data>
   <data name="WebAnnouncementMatchPermanentActivityTime" xml:space="preserve">
-    <value>(?:〓Durasi Event〓|〓Waktu Mulai Misi〓).*?\d\.\dthe Version update(?:after|)Selamanya Tersedia</value>
+    <value>(?:〓Durasi Event〓|〓Waktu Mulai Misi〓).*?(\d\.\d)the Version update(?:after|)Selamanya Tersedia</value>
   </data>
   <data name="WebAnnouncementMatchPersistentActivityTime" xml:space="preserve">
-    <value>〓Durasi Event〓.*?\d\.\d Tersedia selama versi ini</value>
+    <value>〓Durasi Event〓.*?(\d\.\d) Tersedia selama versi ini</value>
   </data>
   <data name="WebAnnouncementMatchTransientActivityTime" xml:space="preserve">
-    <value>(?:〓Waktu Acara〓|Waktu Menginginkan|【Waktu Peluncuran】|〓Waktu Diskon〓).*?(\d\.\d Setelah Pembaruan Versi).*?~.*?&amp;lt;t class="t_(?:gl|lc)".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+    <value>(?:〓Waktu Acara〓|Waktu Menginginkan|【Waktu Peluncuran】|〓Waktu Diskon〓).*?(\d\.\d) Setelah Pembaruan Versi.*?~.*?&amp;lt;t class="t_(?:gl|lc)".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+  </data>
+  <data name="WebAnnouncementMatchVersionUpdatePreviewTime" xml:space="preserve">
+    <value>将于&amp;lt;t class=\"t_(?:gl|lc)\".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;进行版本更新维护</value>
+  </data>
+  <data name="WebAnnouncementMatchVersionUpdatePreviewTitle" xml:space="preserve">
+    <value>\d\.\d版本更新维护预告</value>
   </data>
   <data name="WebAnnouncementMatchVersionUpdateTime" xml:space="preserve">
     <value>〓Durasi Pemeliharaan Pembaruan.+?&amp;lt;t class=\"t_(?:gl|lc)\".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>

src/Snap.Hutao/Snap.Hutao/Resource/Localization/SH.ja.resx

@@ -60,45 +60,45 @@
             : and then encoded with base64 encoding.
     -->
   <xsd:schema xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="root">
-    <xsd:import namespace="http://www.w3.org/XML/1998/namespace"/>
+    <xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
     <xsd:element name="root" msdata:IsDataSet="true">
       <xsd:complexType>
         <xsd:choice maxOccurs="unbounded">
           <xsd:element name="metadata">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" />
               </xsd:sequence>
-              <xsd:attribute name="name" use="required" type="xsd:string"/>
-              <xsd:attribute name="type" type="xsd:string"/>
-              <xsd:attribute name="mimetype" type="xsd:string"/>
-              <xsd:attribute ref="xml:space"/>
+              <xsd:attribute name="name" use="required" type="xsd:string" />
+              <xsd:attribute name="type" type="xsd:string" />
+              <xsd:attribute name="mimetype" type="xsd:string" />
+              <xsd:attribute ref="xml:space" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="assembly">
             <xsd:complexType>
-              <xsd:attribute name="alias" type="xsd:string"/>
-              <xsd:attribute name="name" type="xsd:string"/>
+              <xsd:attribute name="alias" type="xsd:string" />
+              <xsd:attribute name="name" type="xsd:string" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="data">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1"/>
-                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
               </xsd:sequence>
-              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1"/>
-              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3"/>
-              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4"/>
-              <xsd:attribute ref="xml:space"/>
+              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
+              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
+              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
+              <xsd:attribute ref="xml:space" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="resheader">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
               </xsd:sequence>
-              <xsd:attribute name="name" type="xsd:string" use="required"/>
+              <xsd:attribute name="name" type="xsd:string" use="required" />
             </xsd:complexType>
           </xsd:element>
         </xsd:choice>
@@ -653,7 +653,7 @@
   <data name="ServiceAchievementUIAFImportPickerTitile" xml:space="preserve">
     <value>UIAF Json ファイルを開く</value>
   </data>
-  <data name="ServiceAchievementUserdataCorruptedInnerIdNotUnique" xml:space="preserve">
+  <data name="ServiceAchievementUserdataCorruptedAchievementIdNotUnique" xml:space="preserve">
     <value>複数の同一アチーブメント Idがアーカイブに混在しています</value>
   </data>
   <data name="ServiceAvatarInfoPropertyAtk" xml:space="preserve">
@@ -2922,19 +2922,25 @@
     <value>武器一覧</value>
   </data>
   <data name="WebAnnouncementMatchPermanentActivityTime" xml:space="preserve">
-    <value>(?:〓イベント期間〓|〓任務開始時間〓).*?\d\.\dバージョンアップ(?:完了|)後常設オープン</value>
+    <value>(?:〓イベント期間〓|〓任務開(?:始|放)時間〓).*?(\d\.\d).*?開放</value>
   </data>
   <data name="WebAnnouncementMatchPersistentActivityTime" xml:space="preserve">
-    <value>〓イベント期間〓.*?\d\.\d当バージョン期間オープン</value>
+    <value>〓イベント期間〓.*?(\d\.\d)バージョン</value>
   </data>
   <data name="WebAnnouncementMatchTransientActivityTime" xml:space="preserve">
-    <value>(?:〓イベント期間〓|祈願期間|【開始日時】).*?(\d\.\dバージョンアップ完了後).*?~.*?&amp;lt;t class="t_(?:gl|lc)".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+    <value>(?:〓イベント期間〓|祈願期間|【開始日時】).*?(\d\.\d)バージョンアップ.*?~.*?&amp;lt;t class="t_(?:gl|lc)".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+  </data>
+  <data name="WebAnnouncementMatchVersionUpdatePreviewTime" xml:space="preserve">
+    <value>親愛.*?&amp;lt;t class=\"t_(?:gl|lc)\".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+  </data>
+  <data name="WebAnnouncementMatchVersionUpdatePreviewTitle" xml:space="preserve">
+    <value>Ver\.\d\.\dバージョンアップのお知らせ</value>
   </data>
   <data name="WebAnnouncementMatchVersionUpdateTime" xml:space="preserve">
     <value>〓メンテナンス時間〓.+?&amp;lt;t class=\"t_(?:gl|lc)\".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
   </data>
   <data name="WebAnnouncementMatchVersionUpdateTitle" xml:space="preserve">
-    <value>Ver.\d\.\d.+正式リリース</value>
+    <value>Ver\.\d\.\d.*?正式リリース</value>
   </data>
   <data name="WebAnnouncementTimeDaysBeginFormat" xml:space="preserve">
     <value>{0} 日後に開始</value>

src/Snap.Hutao/Snap.Hutao/Resource/Localization/SH.ko.resx

@@ -60,45 +60,45 @@
             : and then encoded with base64 encoding.
     -->
   <xsd:schema xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="root">
-    <xsd:import namespace="http://www.w3.org/XML/1998/namespace"/>
+    <xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
     <xsd:element name="root" msdata:IsDataSet="true">
       <xsd:complexType>
         <xsd:choice maxOccurs="unbounded">
           <xsd:element name="metadata">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" />
               </xsd:sequence>
-              <xsd:attribute name="name" use="required" type="xsd:string"/>
-              <xsd:attribute name="type" type="xsd:string"/>
-              <xsd:attribute name="mimetype" type="xsd:string"/>
-              <xsd:attribute ref="xml:space"/>
+              <xsd:attribute name="name" use="required" type="xsd:string" />
+              <xsd:attribute name="type" type="xsd:string" />
+              <xsd:attribute name="mimetype" type="xsd:string" />
+              <xsd:attribute ref="xml:space" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="assembly">
             <xsd:complexType>
-              <xsd:attribute name="alias" type="xsd:string"/>
-              <xsd:attribute name="name" type="xsd:string"/>
+              <xsd:attribute name="alias" type="xsd:string" />
+              <xsd:attribute name="name" type="xsd:string" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="data">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1"/>
-                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
               </xsd:sequence>
-              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1"/>
-              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3"/>
-              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4"/>
-              <xsd:attribute ref="xml:space"/>
+              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
+              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
+              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
+              <xsd:attribute ref="xml:space" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="resheader">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
               </xsd:sequence>
-              <xsd:attribute name="name" type="xsd:string" use="required"/>
+              <xsd:attribute name="name" type="xsd:string" use="required" />
             </xsd:complexType>
           </xsd:element>
         </xsd:choice>
@@ -653,7 +653,7 @@
   <data name="ServiceAchievementUIAFImportPickerTitile" xml:space="preserve">
     <value>打开 UIAF Json 文件</value>
   </data>
-  <data name="ServiceAchievementUserdataCorruptedInnerIdNotUnique" xml:space="preserve">
+  <data name="ServiceAchievementUserdataCorruptedAchievementIdNotUnique" xml:space="preserve">
     <value>한 업적 아카이브에서 Id 동일한 업적 발견됨</value>
   </data>
   <data name="ServiceAvatarInfoPropertyAtk" xml:space="preserve">
@@ -2922,13 +2922,19 @@
     <value>무기 자료</value>
   </data>
   <data name="WebAnnouncementMatchPermanentActivityTime" xml:space="preserve">
-    <value>(?:〓活动时间〓|〓任务开放时间〓).*?\d\.\d版本更新(?:完成|)后永久开放</value>
+    <value>(?:〓活动时间〓|〓任务开放时间〓).*?(\d\.\d)版本更新(?:完成|)后永久开放</value>
   </data>
   <data name="WebAnnouncementMatchPersistentActivityTime" xml:space="preserve">
-    <value>〓活动时间〓.*?\d\.\d版本期间持续开放</value>
+    <value>〓活动时间〓.*?(\d\.\d)版本期间持续开放</value>
   </data>
   <data name="WebAnnouncementMatchTransientActivityTime" xml:space="preserve">
-    <value>(?:〓活动时间〓|祈愿时间|【上架时间】).*?(\d\.\d版本更新后).*?~.*?&amp;lt;t class="t_(?:gl|lc)".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+    <value>(?:〓活动时间〓|祈愿时间|【上架时间】|〓折扣时间〓).*?(\d\.\d)版本更新后.*?~.*?&amp;lt;t class="t_(?:gl|lc)".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+  </data>
+  <data name="WebAnnouncementMatchVersionUpdatePreviewTime" xml:space="preserve">
+    <value>将于&amp;lt;t class=\"t_(?:gl|lc)\".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;进行版本更新维护</value>
+  </data>
+  <data name="WebAnnouncementMatchVersionUpdatePreviewTitle" xml:space="preserve">
+    <value>\d\.\d版本更新维护预告</value>
   </data>
   <data name="WebAnnouncementMatchVersionUpdateTime" xml:space="preserve">
     <value>〓更新时间〓.+?&amp;lt;t class=\"t_(?:gl|lc)\".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>

src/Snap.Hutao/Snap.Hutao/Resource/Localization/SH.pt.resx

@@ -60,45 +60,45 @@
             : and then encoded with base64 encoding.
     -->
   <xsd:schema xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="root">
-    <xsd:import namespace="http://www.w3.org/XML/1998/namespace"/>
+    <xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
     <xsd:element name="root" msdata:IsDataSet="true">
       <xsd:complexType>
         <xsd:choice maxOccurs="unbounded">
           <xsd:element name="metadata">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" />
               </xsd:sequence>
-              <xsd:attribute name="name" use="required" type="xsd:string"/>
-              <xsd:attribute name="type" type="xsd:string"/>
-              <xsd:attribute name="mimetype" type="xsd:string"/>
-              <xsd:attribute ref="xml:space"/>
+              <xsd:attribute name="name" use="required" type="xsd:string" />
+              <xsd:attribute name="type" type="xsd:string" />
+              <xsd:attribute name="mimetype" type="xsd:string" />
+              <xsd:attribute ref="xml:space" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="assembly">
             <xsd:complexType>
-              <xsd:attribute name="alias" type="xsd:string"/>
-              <xsd:attribute name="name" type="xsd:string"/>
+              <xsd:attribute name="alias" type="xsd:string" />
+              <xsd:attribute name="name" type="xsd:string" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="data">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1"/>
-                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
               </xsd:sequence>
-              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1"/>
-              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3"/>
-              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4"/>
-              <xsd:attribute ref="xml:space"/>
+              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
+              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
+              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
+              <xsd:attribute ref="xml:space" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="resheader">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
               </xsd:sequence>
-              <xsd:attribute name="name" type="xsd:string" use="required"/>
+              <xsd:attribute name="name" type="xsd:string" use="required" />
             </xsd:complexType>
           </xsd:element>
         </xsd:choice>
@@ -653,7 +653,7 @@
   <data name="ServiceAchievementUIAFImportPickerTitile" xml:space="preserve">
     <value>Abrir arquivo Json UIAF</value>
   </data>
-  <data name="ServiceAchievementUserdataCorruptedInnerIdNotUnique" xml:space="preserve">
+  <data name="ServiceAchievementUserdataCorruptedAchievementIdNotUnique" xml:space="preserve">
     <value>Várias IDs de conquistas idênticas encontradas em um único arquivo de conquistas</value>
   </data>
   <data name="ServiceAvatarInfoPropertyAtk" xml:space="preserve">
@@ -2922,13 +2922,19 @@
     <value>Wiki de armas</value>
   </data>
   <data name="WebAnnouncementMatchPermanentActivityTime" xml:space="preserve">
-    <value>(?:〓Duração do evento〓|〓Hora de início da missão〓).*?\d\.\da atualização da versão(?:after|)Disponível permanentemente</value>
+    <value>(?:〓Duração do evento〓|〓Hora de início da missão〓).*?(\d\.\d)a atualização da versão(?:after|)Disponível permanentemente</value>
   </data>
   <data name="WebAnnouncementMatchPersistentActivityTime" xml:space="preserve">
-    <value>〓Duração do evento〓.*?\d\.\d Disponível em toda as versões</value>
+    <value>〓Duração do evento〓.*?(\d\.\d) Disponível em toda as versões</value>
   </data>
   <data name="WebAnnouncementMatchTransientActivityTime" xml:space="preserve">
-    <value>(?:〓Duração do evento〓|Duração da oração do evento|【Duração da disponibilidade】).*?(\d\.\dApós a atualização da versão).*?~.*?&amp;lt;t class="t_(?:gl|lc)".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+    <value>(?:〓Duração do evento〓|Duração da oração do evento|【Duração da disponibilidade】).*?(\d\.\d)Após a atualização da versão.*?~.*?&amp;lt;t class="t_(?:gl|lc)".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+  </data>
+  <data name="WebAnnouncementMatchVersionUpdatePreviewTime" xml:space="preserve">
+    <value>将于&amp;lt;t class=\"t_(?:gl|lc)\".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;进行版本更新维护</value>
+  </data>
+  <data name="WebAnnouncementMatchVersionUpdatePreviewTitle" xml:space="preserve">
+    <value>\d\.\d版本更新维护预告</value>
   </data>
   <data name="WebAnnouncementMatchVersionUpdateTime" xml:space="preserve">
     <value>〓Duração da manutenção da atualização.+?&amp;lt;t class=\"t_(?:gl|lc)\".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>

src/Snap.Hutao/Snap.Hutao/Resource/Localization/SH.resx

@@ -653,7 +653,7 @@
   <data name="ServiceAchievementUIAFImportPickerTitile" xml:space="preserve">
     <value>打开 UIAF Json 文件</value>
   </data>
-  <data name="ServiceAchievementUserdataCorruptedInnerIdNotUnique" xml:space="preserve">
+  <data name="ServiceAchievementUserdataCorruptedAchievementIdNotUnique" xml:space="preserve">
     <value>单个成就存档内发现多个相同的成就 Id</value>
   </data>
   <data name="ServiceAvatarInfoPropertyAtk" xml:space="preserve">
@@ -1334,6 +1334,12 @@
   <data name="ViewDialogLaunchGameAccountTitle" xml:space="preserve">
     <value>为账号命名</value>
   </data>
+  <data name="ViewDialogLaunchGameConfigurationFixDialogHint" xml:space="preserve">
+    <value>请选择当前游戏路径对应的游戏服务器</value>
+  </data>
+  <data name="ViewDialogLaunchGameConfigurationFixDialogTitle" xml:space="preserve">
+    <value>正在修复配置文件</value>
+  </data>
   <data name="ViewDialogLaunchGamePackageConvertHint" xml:space="preserve">
     <value>转换可能需要花费一段时间，请勿关闭胡桃</value>
   </data>
@@ -1355,6 +1361,9 @@
   <data name="ViewDialogSettingDeleteUserDataTitle" xml:space="preserve">
     <value>是否永久删除用户数据</value>
   </data>
+  <data name="ViewDialogUpdatePackageDownloadUpdatelogLinkContent" xml:space="preserve">
+    <value>查看更新日志</value>
+  </data>
   <data name="ViewDialogUserDocumentAction" xml:space="preserve">
     <value>立即前往</value>
   </data>
@@ -1376,6 +1385,9 @@
   <data name="ViewGachaLogHeader" xml:space="preserve">
     <value>祈愿记录</value>
   </data>
+  <data name="ViewGuideStaticResourceDownloadSize" xml:space="preserve">
+    <value>预计下载大小：{0}</value>
+  </data>
   <data name="ViewGuideStepAgreementIHaveReadText" xml:space="preserve">
     <value>我已阅读并同意</value>
   </data>
@@ -1391,6 +1403,12 @@
   <data name="ViewGuideStepAgreementTermOfService" xml:space="preserve">
     <value>用户使用协议与法律声明</value>
   </data>
+  <data name="ViewGuideStepCommonSetting" xml:space="preserve">
+    <value>基础设置</value>
+  </data>
+  <data name="ViewGuideStepCommonSettingHint" xml:space="preserve">
+    <value>稍后可以在设置中修改</value>
+  </data>
   <data name="ViewGuideStepDocument" xml:space="preserve">
     <value>文档</value>
   </data>
@@ -1401,7 +1419,7 @@
     <value>安装完成后重启胡桃以查看是否正常生效</value>
   </data>
   <data name="ViewGuideStepEnvironmentFontDescription1" xml:space="preserve">
-    <value>如果上方的图标中存在乱码，请前往</value>
+    <value>如果上方的图标中存在乱码或方块字，请前往</value>
   </data>
   <data name="ViewGuideStepEnvironmentFontDescription2" xml:space="preserve">
     <value>下载并自行安装图标字体</value>
@@ -1418,6 +1436,24 @@
   <data name="ViewGuideStepStaticResource" xml:space="preserve">
     <value>资源</value>
   </data>
+  <data name="ViewGuideStepStaticResourceSetting" xml:space="preserve">
+    <value>图像资源设置</value>
+  </data>
+  <data name="ViewGuideStepStaticResourceSettingHint" xml:space="preserve">
+    <value>* 除非你卸载并重新安装胡桃，否则你将无法更改这些设置</value>
+  </data>
+  <data name="ViewGuideStepStaticResourceSettingMinimumHeader" xml:space="preserve">
+    <value>图片资源包体</value>
+  </data>
+  <data name="ViewGuideStepStaticResourceSettingMinimumOff" xml:space="preserve">
+    <value>完整包体</value>
+  </data>
+  <data name="ViewGuideStepStaticResourceSettingMinimumOn" xml:space="preserve">
+    <value>精简包体</value>
+  </data>
+  <data name="ViewGuideStepStaticResourceSettingQualityHeader" xml:space="preserve">
+    <value>图片资源质量</value>
+  </data>
   <data name="ViewHutaoDatabaseHeader" xml:space="preserve">
     <value>深渊统计</value>
   </data>
@@ -1607,6 +1643,12 @@
   <data name="ViewModelGuideActionStaticResourceBegin" xml:space="preserve">
     <value>下载资源文件中，请稍候</value>
   </data>
+  <data name="ViewModelGuideStaticResourceQualityHigh" xml:space="preserve">
+    <value>高质量</value>
+  </data>
+  <data name="ViewModelGuideStaticResourceQualityRaw" xml:space="preserve">
+    <value>原图</value>
+  </data>
   <data name="ViewModelHutaoPassportEmailNotValidHint" xml:space="preserve">
     <value>请输入正确的邮箱</value>
   </data>
@@ -1625,6 +1667,12 @@
   <data name="ViewModelLaunchGameEnsureGameResourceFail" xml:space="preserve">
     <value>切换服务器失败</value>
   </data>
+  <data name="ViewModelLaunchGameFixConfigurationFileButtonText" xml:space="preserve">
+    <value>修复配置文件</value>
+  </data>
+  <data name="ViewModelLaunchGameFixConfigurationFileSuccess" xml:space="preserve">
+    <value>修复完成</value>
+  </data>
   <data name="ViewModelLaunchGameIdentifyMonitorsAction" xml:space="preserve">
     <value>识别显示器</value>
   </data>
@@ -1637,6 +1685,9 @@
   <data name="ViewModelLaunchGameSchemeNotSelected" xml:space="preserve">
     <value>尚未选择任何服务器</value>
   </data>
+  <data name="ViewModelLaunchGameSetGamePathButtonText" xml:space="preserve">
+    <value>设置游戏目录</value>
+  </data>
   <data name="ViewModelLaunchGameSwitchGameAccountFail" xml:space="preserve">
     <value>切换账号失败</value>
   </data>
@@ -1673,12 +1724,21 @@
   <data name="ViewModelSettingGeetestCustomUrlSucceed" xml:space="preserve">
     <value>无感验证复合 Url 配置成功</value>
   </data>
+  <data name="ViewModelSettingResetStaticResourceProgress" xml:space="preserve">
+    <value>正在重置图片资源</value>
+  </data>
   <data name="ViewModelSettingSetDataFolderSuccess" xml:space="preserve">
     <value>设置数据目录成功，重启以应用更改</value>
   </data>
   <data name="ViewModelSettingSetGamePathDatabaseFailedTitle" xml:space="preserve">
     <value>保存游戏路径失败</value>
   </data>
+  <data name="ViewModelSpiralAbyssUploadRecordHomaNotLoginContent" xml:space="preserve">
+    <value>当前未登录胡桃账号，上传深渊数据无法获赠胡桃云时长</value>
+  </data>
+  <data name="ViewModelSpiralAbyssUploadRecordHomaNotLoginTitle" xml:space="preserve">
+    <value>上传深渊数据</value>
+  </data>
   <data name="ViewModelUserAdded" xml:space="preserve">
     <value>用户 [{0}] 添加成功</value>
   </data>
@@ -2654,6 +2714,12 @@
   <data name="ViewPageSettingTranslateNavigate" xml:space="preserve">
     <value>贡献翻译</value>
   </data>
+  <data name="ViewPageSettingUnobtainedWishItemVisibleDescription" xml:space="preserve">
+    <value>在祈愿记录页面角色与武器页签显示未抽取到的祈愿物品</value>
+  </data>
+  <data name="ViewPageSettingUnobtainedWishItemVisibleHeader" xml:space="preserve">
+    <value>未抽取到的祈愿物品</value>
+  </data>
   <data name="ViewPageSettingUpdateCheckAction" xml:space="preserve">
     <value>前往商店</value>
   </data>
@@ -2835,7 +2901,7 @@
     <value>上传数据</value>
   </data>
   <data name="ViewTitileUpdatePackageDownloadContent" xml:space="preserve">
-    <value>是否立即下载</value>
+    <value>是否立即下载？</value>
   </data>
   <data name="ViewTitileUpdatePackageDownloadFailedMessage" xml:space="preserve">
     <value>下载更新失败</value>
@@ -2934,13 +3000,19 @@
     <value>武器资料</value>
   </data>
   <data name="WebAnnouncementMatchPermanentActivityTime" xml:space="preserve">
-    <value>(?:〓活动时间〓|〓任务开放时间〓).*?\d\.\d版本更新(?:完成|)后永久开放</value>
+    <value>(?:〓活动时间〓|〓任务开放时间〓).*?(\d\.\d)版本更新(?:完成|)后永久开放</value>
   </data>
   <data name="WebAnnouncementMatchPersistentActivityTime" xml:space="preserve">
-    <value>〓活动时间〓.*?\d\.\d版本期间持续开放</value>
+    <value>〓活动时间〓.*?(\d\.\d)版本期间持续开放</value>
   </data>
   <data name="WebAnnouncementMatchTransientActivityTime" xml:space="preserve">
-    <value>(?:〓活动时间〓|祈愿时间|【上架时间】|〓折扣时间〓).*?(\d\.\d版本更新后).*?~.*?&amp;lt;t class="t_(?:gl|lc)".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+    <value>(?:〓活动时间〓|祈愿时间|【上架时间】|〓折扣时间〓).*?(\d\.\d)版本更新后.*?~.*?&amp;lt;t class="t_(?:gl|lc)".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+  </data>
+  <data name="WebAnnouncementMatchVersionUpdatePreviewTime" xml:space="preserve">
+    <value>将于&amp;lt;t class=\"t_(?:gl|lc)\".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;进行版本更新维护</value>
+  </data>
+  <data name="WebAnnouncementMatchVersionUpdatePreviewTitle" xml:space="preserve">
+    <value>\d\.\d版本更新维护预告</value>
   </data>
   <data name="WebAnnouncementMatchVersionUpdateTime" xml:space="preserve">
     <value>〓更新时间〓.+?&amp;lt;t class=\"t_(?:gl|lc)\".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>

src/Snap.Hutao/Snap.Hutao/Resource/Localization/SH.ru.resx

@@ -60,45 +60,45 @@
             : and then encoded with base64 encoding.
     -->
   <xsd:schema xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="root">
-    <xsd:import namespace="http://www.w3.org/XML/1998/namespace"/>
+    <xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
     <xsd:element name="root" msdata:IsDataSet="true">
       <xsd:complexType>
         <xsd:choice maxOccurs="unbounded">
           <xsd:element name="metadata">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" />
               </xsd:sequence>
-              <xsd:attribute name="name" use="required" type="xsd:string"/>
-              <xsd:attribute name="type" type="xsd:string"/>
-              <xsd:attribute name="mimetype" type="xsd:string"/>
-              <xsd:attribute ref="xml:space"/>
+              <xsd:attribute name="name" use="required" type="xsd:string" />
+              <xsd:attribute name="type" type="xsd:string" />
+              <xsd:attribute name="mimetype" type="xsd:string" />
+              <xsd:attribute ref="xml:space" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="assembly">
             <xsd:complexType>
-              <xsd:attribute name="alias" type="xsd:string"/>
-              <xsd:attribute name="name" type="xsd:string"/>
+              <xsd:attribute name="alias" type="xsd:string" />
+              <xsd:attribute name="name" type="xsd:string" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="data">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1"/>
-                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
               </xsd:sequence>
-              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1"/>
-              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3"/>
-              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4"/>
-              <xsd:attribute ref="xml:space"/>
+              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
+              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
+              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
+              <xsd:attribute ref="xml:space" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="resheader">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
               </xsd:sequence>
-              <xsd:attribute name="name" type="xsd:string" use="required"/>
+              <xsd:attribute name="name" type="xsd:string" use="required" />
             </xsd:complexType>
           </xsd:element>
         </xsd:choice>
@@ -653,7 +653,7 @@
   <data name="ServiceAchievementUIAFImportPickerTitile" xml:space="preserve">
     <value>Открыть UIAF Json файл</value>
   </data>
-  <data name="ServiceAchievementUserdataCorruptedInnerIdNotUnique" xml:space="preserve">
+  <data name="ServiceAchievementUserdataCorruptedAchievementIdNotUnique" xml:space="preserve">
     <value>В одном архиве достижений обнаружено несколько одинаковых идентификаторов достижений</value>
   </data>
   <data name="ServiceAvatarInfoPropertyAtk" xml:space="preserve">
@@ -2922,13 +2922,19 @@
     <value>武器资料</value>
   </data>
   <data name="WebAnnouncementMatchPermanentActivityTime" xml:space="preserve">
-    <value>(?:〓活动时间〓|〓任务开放时间〓).*?\d\.\d版本更新(?:完成|)后永久开放</value>
+    <value>(?:〓活动时间〓|〓任务开放时间〓).*?(\d\.\d)版本更新(?:完成|)后永久开放</value>
   </data>
   <data name="WebAnnouncementMatchPersistentActivityTime" xml:space="preserve">
-    <value>〓活动时间〓.*?\d\.\d版本期间持续开放</value>
+    <value>〓活动时间〓.*?(\d\.\d)版本期间持续开放</value>
   </data>
   <data name="WebAnnouncementMatchTransientActivityTime" xml:space="preserve">
-    <value>(?:〓活动时间〓|祈愿时间|【上架时间】).*?(\d\.\d版本更新后).*?~.*?&amp;lt;t class="t_(?:gl|lc)".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+    <value>(?:〓活动时间〓|祈愿时间|【上架时间】|〓折扣时间〓).*?(\d\.\d)版本更新后.*?~.*?&amp;lt;t class="t_(?:gl|lc)".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+  </data>
+  <data name="WebAnnouncementMatchVersionUpdatePreviewTime" xml:space="preserve">
+    <value>将于&amp;lt;t class=\"t_(?:gl|lc)\".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;进行版本更新维护</value>
+  </data>
+  <data name="WebAnnouncementMatchVersionUpdatePreviewTitle" xml:space="preserve">
+    <value>\d\.\d版本更新维护预告</value>
   </data>
   <data name="WebAnnouncementMatchVersionUpdateTime" xml:space="preserve">
     <value>〓更新时间〓.+?&amp;lt;t class=\"t_(?:gl|lc)\".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>

src/Snap.Hutao/Snap.Hutao/Resource/Localization/SH.zh-Hant.resx

@@ -60,45 +60,45 @@
             : and then encoded with base64 encoding.
     -->
   <xsd:schema xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="root">
-    <xsd:import namespace="http://www.w3.org/XML/1998/namespace"/>
+    <xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
     <xsd:element name="root" msdata:IsDataSet="true">
       <xsd:complexType>
         <xsd:choice maxOccurs="unbounded">
           <xsd:element name="metadata">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" />
               </xsd:sequence>
-              <xsd:attribute name="name" use="required" type="xsd:string"/>
-              <xsd:attribute name="type" type="xsd:string"/>
-              <xsd:attribute name="mimetype" type="xsd:string"/>
-              <xsd:attribute ref="xml:space"/>
+              <xsd:attribute name="name" use="required" type="xsd:string" />
+              <xsd:attribute name="type" type="xsd:string" />
+              <xsd:attribute name="mimetype" type="xsd:string" />
+              <xsd:attribute ref="xml:space" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="assembly">
             <xsd:complexType>
-              <xsd:attribute name="alias" type="xsd:string"/>
-              <xsd:attribute name="name" type="xsd:string"/>
+              <xsd:attribute name="alias" type="xsd:string" />
+              <xsd:attribute name="name" type="xsd:string" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="data">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1"/>
-                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
               </xsd:sequence>
-              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1"/>
-              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3"/>
-              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4"/>
-              <xsd:attribute ref="xml:space"/>
+              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
+              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
+              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
+              <xsd:attribute ref="xml:space" />
             </xsd:complexType>
           </xsd:element>
           <xsd:element name="resheader">
             <xsd:complexType>
               <xsd:sequence>
-                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1"/>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
               </xsd:sequence>
-              <xsd:attribute name="name" type="xsd:string" use="required"/>
+              <xsd:attribute name="name" type="xsd:string" use="required" />
             </xsd:complexType>
           </xsd:element>
         </xsd:choice>
@@ -653,7 +653,7 @@
   <data name="ServiceAchievementUIAFImportPickerTitile" xml:space="preserve">
     <value>打開 UIAF Json 文件</value>
   </data>
-  <data name="ServiceAchievementUserdataCorruptedInnerIdNotUnique" xml:space="preserve">
+  <data name="ServiceAchievementUserdataCorruptedAchievementIdNotUnique" xml:space="preserve">
     <value>單個成就存檔內發現多個相同的成就 Id</value>
   </data>
   <data name="ServiceAvatarInfoPropertyAtk" xml:space="preserve">
@@ -2922,13 +2922,19 @@
     <value>武器資料</value>
   </data>
   <data name="WebAnnouncementMatchPermanentActivityTime" xml:space="preserve">
-    <value>(?:〓活動時間〓|〓任務開放時間〓).*?\d\.\d版本更新(?:完成|)後永久開放</value>
+    <value>(?:〓活動時間〓|〓任務開放時間〓).*?(\d\.\d)版本更新(?:完成|)後永久開放</value>
   </data>
   <data name="WebAnnouncementMatchPersistentActivityTime" xml:space="preserve">
-    <value>〓活動時間〓.*?\d\.\d版本期間持續開放</value>
+    <value>〓活動時間〓.*?(\d\.\d)版本期間持續開放</value>
   </data>
   <data name="WebAnnouncementMatchTransientActivityTime" xml:space="preserve">
-    <value>(?:〓活動時間〓|祈願時間|【上架時間】|〓折扣時間〓).*?(\d\.\d版本更新後).*?~.*?&amp;lt;t class="t_(?:gl|lc)".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+    <value>(?:〓活動時間〓|祈願時間|【上架時間】|〓折扣時間〓).*?(\d\.\d).*?版本更新後.*?&amp;lt;t class="t_(?:gl|lc)".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+  </data>
+  <data name="WebAnnouncementMatchVersionUpdatePreviewTime" xml:space="preserve">
+    <value>親愛.*?&amp;lt;t class=\"t_(?:gl|lc)\".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>
+  </data>
+  <data name="WebAnnouncementMatchVersionUpdatePreviewTitle" xml:space="preserve">
+    <value>\d\.\d版本更新維護預告</value>
   </data>
   <data name="WebAnnouncementMatchVersionUpdateTime" xml:space="preserve">
     <value>〓更新時間〓.+?&amp;lt;t class=\"t_(?:gl|lc)\".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;</value>

src/Snap.Hutao/Snap.Hutao/Service/Abstraction/AppDbServiceAppDbEntityExtension.cs

@@ -0,0 +1,35 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.EntityFrameworkCore;
+using Snap.Hutao.Core.Database;
+using Snap.Hutao.Model.Entity.Abstraction;
+
+namespace Snap.Hutao.Service.Abstraction;
+
+internal static class AppDbServiceAppDbEntityExtension
+{
+    public static int DeleteByInnerId<TEntity>(this IAppDbService<TEntity> service, TEntity entity)
+        where TEntity : class, IAppDbEntity
+    {
+        return service.Execute(dbset => dbset.ExecuteDeleteWhere(e => e.InnerId == entity.InnerId));
+    }
+
+    public static ValueTask<int> DeleteByInnerIdAsync<TEntity>(this IAppDbService<TEntity> service, TEntity entity, CancellationToken token = default)
+        where TEntity : class, IAppDbEntity
+    {
+        return service.ExecuteAsync((dbset, token) => dbset.ExecuteDeleteWhereAsync(e => e.InnerId == entity.InnerId, token), token);
+    }
+
+    public static List<TEntity> ListByArchiveId<TEntity>(this IAppDbService<TEntity> service, Guid archiveId)
+        where TEntity : class, IAppDbEntityHasArchive
+    {
+        return service.Query(query => query.Where(e => e.ArchiveId == archiveId).ToList());
+    }
+
+    public static ValueTask<List<TEntity>> ListByArchiveIdAsync<TEntity>(this IAppDbService<TEntity> service, Guid archiveId, CancellationToken token = default)
+        where TEntity : class, IAppDbEntityHasArchive
+    {
+        return service.QueryAsync((query, token) => query.Where(e => e.ArchiveId == archiveId).ToListAsync(token), token);
+    }
+}

src/Snap.Hutao/Snap.Hutao/Service/Abstraction/AppDbServiceCollectionExtension.cs

@@ -0,0 +1,47 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.EntityFrameworkCore;
+using System.Collections.ObjectModel;
+using System.Linq.Expressions;
+
+namespace Snap.Hutao.Service.Abstraction;
+
+internal static class AppDbServiceCollectionExtension
+{
+    public static List<TEntity> List<TEntity>(this IAppDbService<TEntity> service)
+        where TEntity : class
+    {
+        return service.Query(query => query.ToList());
+    }
+
+    public static List<TEntity> List<TEntity>(this IAppDbService<TEntity> service, Expression<Func<TEntity, bool>> predicate)
+        where TEntity : class
+    {
+        return service.Query(query => query.Where(predicate).ToList());
+    }
+
+    public static ValueTask<List<TEntity>> ListAsync<TEntity>(this IAppDbService<TEntity> service, CancellationToken token = default)
+        where TEntity : class
+    {
+        return service.QueryAsync((query, token) => query.ToListAsync(token), token);
+    }
+
+    public static ValueTask<List<TEntity>> ListAsync<TEntity>(this IAppDbService<TEntity> service, Expression<Func<TEntity, bool>> predicate, CancellationToken token = default)
+        where TEntity : class
+    {
+        return service.QueryAsync((query, token) => query.Where(predicate).ToListAsync(token), token);
+    }
+
+    public static ObservableCollection<TEntity> ObservableCollection<TEntity>(this IAppDbService<TEntity> service)
+        where TEntity : class
+    {
+        return service.Query(query => query.ToObservableCollection());
+    }
+
+    public static ObservableCollection<TEntity> ObservableCollection<TEntity>(this IAppDbService<TEntity> service, Expression<Func<TEntity, bool>> predicate)
+        where TEntity : class
+    {
+        return service.Query(query => query.Where(predicate).ToObservableCollection());
+    }
+}

src/Snap.Hutao/Snap.Hutao/Service/Abstraction/AppDbServiceExtension.cs

@@ -0,0 +1,152 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.EntityFrameworkCore;
+using Snap.Hutao.Core.Database;
+using Snap.Hutao.Model.Entity.Database;
+using System.Linq.Expressions;
+
+namespace Snap.Hutao.Service.Abstraction;
+
+internal static class AppDbServiceExtension
+{
+    public static TResult Execute<TEntity, TResult>(this IAppDbService<TEntity> service, Func<DbSet<TEntity>, TResult> func)
+        where TEntity : class
+    {
+        using (IServiceScope scope = service.ServiceProvider.CreateScope())
+        {
+            AppDbContext appDbContext = scope.GetAppDbContext();
+            return func(appDbContext.Set<TEntity>());
+        }
+    }
+
+    public static async ValueTask<TResult> ExecuteAsync<TEntity, TResult>(this IAppDbService<TEntity> service, Func<DbSet<TEntity>, ValueTask<TResult>> asyncFunc)
+        where TEntity : class
+    {
+        using (IServiceScope scope = service.ServiceProvider.CreateScope())
+        {
+            AppDbContext appDbContext = scope.GetAppDbContext();
+            return await asyncFunc(appDbContext.Set<TEntity>()).ConfigureAwait(false);
+        }
+    }
+
+    public static async ValueTask<TResult> ExecuteAsync<TEntity, TResult>(this IAppDbService<TEntity> service, Func<DbSet<TEntity>, CancellationToken, ValueTask<TResult>> asyncFunc, CancellationToken token)
+        where TEntity : class
+    {
+        using (IServiceScope scope = service.ServiceProvider.CreateScope())
+        {
+            AppDbContext appDbContext = scope.GetAppDbContext();
+            return await asyncFunc(appDbContext.Set<TEntity>(), token).ConfigureAwait(false);
+        }
+    }
+
+    public static async ValueTask<TResult> ExecuteAsync<TEntity, TResult>(this IAppDbService<TEntity> service, Func<DbSet<TEntity>, Task<TResult>> asyncFunc)
+        where TEntity : class
+    {
+        using (IServiceScope scope = service.ServiceProvider.CreateScope())
+        {
+            AppDbContext appDbContext = scope.GetAppDbContext();
+            return await asyncFunc(appDbContext.Set<TEntity>()).ConfigureAwait(false);
+        }
+    }
+
+    public static async ValueTask<TResult> ExecuteAsync<TEntity, TResult>(this IAppDbService<TEntity> service, Func<DbSet<TEntity>, CancellationToken, Task<TResult>> asyncFunc, CancellationToken token)
+        where TEntity : class
+    {
+        using (IServiceScope scope = service.ServiceProvider.CreateScope())
+        {
+            AppDbContext appDbContext = scope.GetAppDbContext();
+            return await asyncFunc(appDbContext.Set<TEntity>(), token).ConfigureAwait(false);
+        }
+    }
+
+    public static int Add<TEntity>(this IAppDbService<TEntity> service, TEntity entity)
+        where TEntity : class
+    {
+        return service.Execute(dbset => dbset.AddAndSave(entity));
+    }
+
+    public static ValueTask<int> AddAsync<TEntity>(this IAppDbService<TEntity> service, TEntity entity, CancellationToken token = default)
+        where TEntity : class
+    {
+        return service.ExecuteAsync((dbset, token) => dbset.AddAndSaveAsync(entity, token), token);
+    }
+
+    public static int AddRange<TEntity>(this IAppDbService<TEntity> service, IEnumerable<TEntity> entities)
+        where TEntity : class
+    {
+        return service.Execute(dbset => dbset.AddRangeAndSave(entities));
+    }
+
+    public static ValueTask<int> AddRangeAsync<TEntity>(this IAppDbService<TEntity> service, IEnumerable<TEntity> entities, CancellationToken token = default)
+        where TEntity : class
+    {
+        return service.ExecuteAsync((dbset, token) => dbset.AddRangeAndSaveAsync(entities, token), token);
+    }
+
+    public static TResult Query<TEntity, TResult>(this IAppDbService<TEntity> service, Func<IQueryable<TEntity>, TResult> func)
+        where TEntity : class
+    {
+        return service.Execute(dbset => func(dbset.AsNoTracking()));
+    }
+
+    public static ValueTask<TResult> QueryAsync<TEntity, TResult>(this IAppDbService<TEntity> service, Func<IQueryable<TEntity>, ValueTask<TResult>> func)
+        where TEntity : class
+    {
+        return service.ExecuteAsync(dbset => func(dbset.AsNoTracking()));
+    }
+
+    public static ValueTask<TResult> QueryAsync<TEntity, TResult>(this IAppDbService<TEntity> service, Func<IQueryable<TEntity>, CancellationToken, ValueTask<TResult>> func, CancellationToken token = default)
+        where TEntity : class
+    {
+        return service.ExecuteAsync((dbset, token) => func(dbset.AsNoTracking(), token), token);
+    }
+
+    public static ValueTask<TResult> QueryAsync<TEntity, TResult>(this IAppDbService<TEntity> service, Func<IQueryable<TEntity>, Task<TResult>> func)
+        where TEntity : class
+    {
+        return service.ExecuteAsync(dbset => func(dbset.AsNoTracking()));
+    }
+
+    public static ValueTask<TResult> QueryAsync<TEntity, TResult>(this IAppDbService<TEntity> service, Func<IQueryable<TEntity>, CancellationToken, Task<TResult>> func, CancellationToken token = default)
+        where TEntity : class
+    {
+        return service.ExecuteAsync((dbset, token) => func(dbset.AsNoTracking(), token), token);
+    }
+
+    public static TEntity Single<TEntity>(this IAppDbService<TEntity> service, Expression<Func<TEntity, bool>> predicate)
+        where TEntity : class
+    {
+        return service.Query(query => query.Single(predicate));
+    }
+
+    public static ValueTask<TEntity> SingleAsync<TEntity>(this IAppDbService<TEntity> service, Expression<Func<TEntity, bool>> predicate, CancellationToken token = default)
+        where TEntity : class
+    {
+        return service.QueryAsync((query, token) => query.SingleAsync(predicate, token), token);
+    }
+
+    public static int Update<TEntity>(this IAppDbService<TEntity> service, TEntity entity)
+        where TEntity : class
+    {
+        return service.Execute(dbset => dbset.UpdateAndSave(entity));
+    }
+
+    public static ValueTask<int> UpdateAsync<TEntity>(this IAppDbService<TEntity> service, TEntity entity, CancellationToken token = default)
+        where TEntity : class
+    {
+        return service.ExecuteAsync((dbset, token) => dbset.UpdateAndSaveAsync(entity, token), token);
+    }
+
+    public static int Delete<TEntity>(this IAppDbService<TEntity> service, TEntity entity)
+        where TEntity : class
+    {
+        return service.Execute(dbset => dbset.RemoveAndSave(entity));
+    }
+
+    public static ValueTask<int> DeleteAsync<TEntity>(this IAppDbService<TEntity> service, TEntity entity, CancellationToken token = default)
+        where TEntity : class
+    {
+        return service.ExecuteAsync((dbset, token) => dbset.RemoveAndSaveAsync(entity, token), token);
+    }
+}

src/Snap.Hutao/Snap.Hutao/Service/Abstraction/DbStoreOptions.cs

@@ -14,20 +14,10 @@ namespace Snap.Hutao.Service.Abstraction;
 /// 数据库存储选项的设置
 /// </summary>
 [ConstructorGenerated]
-internal abstract partial class DbStoreOptions : ObservableObject, IOptions<DbStoreOptions>
+internal abstract partial class DbStoreOptions : ObservableObject
 {
     private readonly IServiceProvider serviceProvider;
 
-    /// <inheritdoc/>
-    public DbStoreOptions Value { get => this; }
-
-    /// <summary>
-    /// 从数据库中获取字符串数据
-    /// </summary>
-    /// <param name="storage">存储字段</param>
-    /// <param name="key">键</param>
-    /// <param name="defaultValue">默认值</param>
-    /// <returns>值</returns>
     protected string GetOption(ref string? storage, string key, string defaultValue = "")
     {
         return GetOption(ref storage, key, () => defaultValue);
@@ -49,13 +39,6 @@ internal abstract partial class DbStoreOptions : ObservableObject, IOptions<DbSt
         return storage;
     }
 
-    /// <summary>
-    /// 从数据库中获取bool数据
-    /// </summary>
-    /// <param name="storage">存储字段</param>
-    /// <param name="key">键</param>
-    /// <param name="defaultValue">默认值</param>
-    /// <returns>值</returns>
     protected bool GetOption(ref bool? storage, string key, bool defaultValue = false)
     {
         return GetOption(ref storage, key, () => defaultValue);
@@ -78,13 +61,6 @@ internal abstract partial class DbStoreOptions : ObservableObject, IOptions<DbSt
         return storage.Value;
     }
 
-    /// <summary>
-    /// 从数据库中获取int数据
-    /// </summary>
-    /// <param name="storage">存储字段</param>
-    /// <param name="key">键</param>
-    /// <param name="defaultValue">默认值</param>
-    /// <returns>值</returns>
     protected int GetOption(ref int? storage, string key, int defaultValue = 0)
     {
         return GetOption(ref storage, key, () => defaultValue);
@@ -107,15 +83,6 @@ internal abstract partial class DbStoreOptions : ObservableObject, IOptions<DbSt
         return storage.Value;
     }
 
-    /// <summary>
-    /// 从数据库中获取任何类型的数据
-    /// </summary>
-    /// <typeparam name="T">数据的类型</typeparam>
-    /// <param name="storage">存储字段</param>
-    /// <param name="key">键</param>
-    /// <param name="deserializer">反序列化器</param>
-    /// <param name="defaultValue">默认值</param>
-    /// <returns>值</returns>
     [return: NotNull]
     protected T GetOption<T>(ref T? storage, string key, Func<string, T> deserializer, [DisallowNull] T defaultValue)
     {
@@ -160,13 +127,6 @@ internal abstract partial class DbStoreOptions : ObservableObject, IOptions<DbSt
         return storage;
     }
 
-    /// <summary>
-    /// 将值存入数据库
-    /// </summary>
-    /// <param name="storage">存储字段</param>
-    /// <param name="key">键</param>
-    /// <param name="value">值</param>
-    /// <param name="propertyName">属性名称</param>
     protected void SetOption(ref string? storage, string key, string? value, [CallerMemberName] string? propertyName = null)
     {
         if (!SetProperty(ref storage, value, propertyName))
@@ -182,14 +142,6 @@ internal abstract partial class DbStoreOptions : ObservableObject, IOptions<DbSt
         }
     }
 
-    /// <summary>
-    /// 将值存入数据库
-    /// </summary>
-    /// <param name="storage">存储字段</param>
-    /// <param name="key">键</param>
-    /// <param name="value">值</param>
-    /// <param name="propertyName">属性名称</param>
-    /// <returns>是否设置了值</returns>
     protected bool SetOption(ref bool? storage, string key, bool value, [CallerMemberName] string? propertyName = null)
     {
         bool set = SetProperty(ref storage, value, propertyName);
@@ -208,13 +160,6 @@ internal abstract partial class DbStoreOptions : ObservableObject, IOptions<DbSt
         return set;
     }
 
-    /// <summary>
-    /// 将值存入数据库
-    /// </summary>
-    /// <param name="storage">存储字段</param>
-    /// <param name="key">键</param>
-    /// <param name="value">值</param>
-    /// <param name="propertyName">属性名称</param>
     protected void SetOption(ref int? storage, string key, int value, [CallerMemberName] string? propertyName = null)
     {
         if (!SetProperty(ref storage, value, propertyName))
@@ -230,15 +175,6 @@ internal abstract partial class DbStoreOptions : ObservableObject, IOptions<DbSt
         }
     }
 
-    /// <summary>
-    /// 将值存入数据库
-    /// </summary>
-    /// <typeparam name="T">数据的类型</typeparam>
-    /// <param name="storage">存储字段</param>
-    /// <param name="key">键</param>
-    /// <param name="value">值</param>
-    /// <param name="serializer">序列化器</param>
-    /// <param name="propertyName">属性名称</param>
     protected void SetOption<T>(ref T? storage, string key, T value, Func<T, string> serializer, [CallerMemberName] string? propertyName = null)
     {
         if (!SetProperty(ref storage, value, propertyName))

src/Snap.Hutao/Snap.Hutao/Service/Abstraction/IAppDbService.cs

@@ -0,0 +1,9 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Service.Abstraction;
+
+internal interface IAppDbService<TEntity> : IAppInfrastructureService
+    where TEntity : class
+{
+}

src/Snap.Hutao/Snap.Hutao/Service/Abstraction/IAppInfrastructureService.cs

@@ -0,0 +1,9 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Service.Abstraction;
+
+internal interface IAppInfrastructureService
+{
+    IServiceProvider ServiceProvider { get; }
+}

src/Snap.Hutao/Snap.Hutao/Service/Abstraction/IAppService.cs

@@ -0,0 +1,6 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Service.Abstraction;
+
+internal interface IAppService;

src/Snap.Hutao/Snap.Hutao/Service/Abstraction/ServiceScopeExtension.cs

@@ -0,0 +1,27 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.EntityFrameworkCore;
+using Snap.Hutao.Model.Entity.Database;
+
+namespace Snap.Hutao.Service.Abstraction;
+
+internal static class ServiceScopeExtension
+{
+    public static TService GetRequiredService<TService>(this IServiceScope scope)
+        where TService : class
+    {
+        return scope.ServiceProvider.GetRequiredService<TService>();
+    }
+
+    public static TDbContext GetDbContext<TDbContext>(this IServiceScope scope)
+        where TDbContext : DbContext
+    {
+        return scope.GetRequiredService<TDbContext>();
+    }
+
+    public static AppDbContext GetAppDbContext(this IServiceScope scope)
+    {
+        return scope.GetDbContext<AppDbContext>();
+    }
+}

src/Snap.Hutao/Snap.Hutao/Service/Achievement/AchievementDbBulkOperation.cs

@@ -2,9 +2,11 @@
 // Licensed under the MIT license.
 
 using Microsoft.EntityFrameworkCore;
+using Snap.Hutao.Core.Collection;
 using Snap.Hutao.Core.Database;
 using Snap.Hutao.Model.Entity.Database;
 using Snap.Hutao.Model.InterChange.Achievement;
+using Snap.Hutao.Service.Abstraction;
 using EntityAchievement = Snap.Hutao.Model.Entity.Achievement;
 
 namespace Snap.Hutao.Service.Achievement;
@@ -21,197 +23,155 @@ internal sealed partial class AchievementDbBulkOperation
     private readonly IServiceProvider serviceProvider;
     private readonly ILogger<AchievementDbBulkOperation> logger;
 
-    /// <summary>
-    /// 合并
-    /// </summary>
-    /// <param name="archiveId">成就id</param>
-    /// <param name="items">待合并的项</param>
-    /// <param name="aggressive">是否贪婪</param>
-    /// <returns>导入结果</returns>
     public ImportResult Merge(Guid archiveId, IEnumerable<UIAFItem> items, bool aggressive)
     {
-        logger.LogInformation("Perform {Method} Operation for archive: {Id}, Aggressive: {Aggressive}", nameof(Merge), archiveId, aggressive);
+        logger.LogInformation("Perform merge operation for [Archive: {Id}], [Aggressive: {Aggressive}]", archiveId, aggressive);
         using (IServiceScope scope = serviceProvider.CreateScope())
         {
-            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
+            AppDbContext appDbContext = scope.GetAppDbContext();
 
             IOrderedQueryable<EntityAchievement> oldData = appDbContext.Achievements
                 .AsNoTracking()
                 .Where(a => a.ArchiveId == archiveId)
                 .OrderBy(a => a.Id);
 
-            int add = 0;
-            int update = 0;
+            (int add, int update) = (0, 0);
 
-            using (IEnumerator<EntityAchievement> entityEnumerator = oldData.GetEnumerator())
+            using (TwoEnumerbleEnumerator<EntityAchievement, UIAFItem> enumerator = new(oldData, items))
             {
-                using (IEnumerator<UIAFItem> uiafEnumerator = items.GetEnumerator())
+                (bool moveEntity, bool moveUIAF) = (true, true);
+
+                while (true)
                 {
-                    bool moveEntity = true;
-                    bool moveUIAF = true;
-
-                    while (true)
+                    if (!enumerator.MoveNext(ref moveEntity, ref moveUIAF))
                     {
-                        bool moveEntityResult = moveEntity && entityEnumerator.MoveNext();
-                        bool moveUIAFResult = moveUIAF && uiafEnumerator.MoveNext();
+                        break;
+                    }
 
-                        if (!(moveEntityResult || moveUIAFResult))
-                        {
-                            break;
-                        }
-                        else
-                        {
-                            EntityAchievement? entity = entityEnumerator.Current;
-                            UIAFItem? uiaf = uiafEnumerator.Current;
-
-                            if (entity is null && uiaf is not null)
-                            {
-                                appDbContext.Achievements.AddAndSave(EntityAchievement.From(archiveId, uiaf));
-                                add++;
-                                continue;
-                            }
-                            else if (entity is not null && uiaf is null)
-                            {
-                                // skip
-                                continue;
-                            }
+                    (EntityAchievement? entity, UIAFItem? uiaf) = enumerator.Current;
 
+                    switch (entity, uiaf)
+                    {
+                        case (null, not null):
+                            appDbContext.Achievements.AddAndSave(EntityAchievement.From(archiveId, uiaf));
+                            add++;
+                            continue;
+                        case (not null, null):
+                            continue; // Skipped
+                        default:
                             ArgumentNullException.ThrowIfNull(entity);
                             ArgumentNullException.ThrowIfNull(uiaf);
 
-                            if (entity.Id < uiaf.Id)
+                            switch (entity.Id.CompareTo(uiaf.Id))
                             {
-                                moveEntity = true;
-                                moveUIAF = false;
-                            }
-                            else if (entity.Id == uiaf.Id)
-                            {
-                                moveEntity = true;
-                                moveUIAF = true;
+                                case < 0:
+                                    (moveEntity, moveUIAF) = (true, false);
+                                    break;
+                                case 0:
+                                    (moveEntity, moveUIAF) = (true, true);
+
+                                    if (aggressive)
+                                    {
+                                        appDbContext.Achievements.RemoveAndSave(entity);
+                                        appDbContext.Achievements.AddAndSave(EntityAchievement.From(archiveId, uiaf));
+                                        update++;
+                                    }
+
+                                    break;
+                                case > 0:
+                                    (moveEntity, moveUIAF) = (false, true);
 
-                                if (aggressive)
-                                {
-                                    appDbContext.Achievements.RemoveAndSave(entity);
                                     appDbContext.Achievements.AddAndSave(EntityAchievement.From(archiveId, uiaf));
-                                    update++;
-                                }
+                                    add++;
+                                    break;
                             }
-                            else
-                            {
-                                // entity.Id > uiaf.Id
-                                moveEntity = false;
-                                moveUIAF = true;
 
-                                appDbContext.Achievements.AddAndSave(EntityAchievement.From(archiveId, uiaf));
-                                add++;
-                            }
-                        }
+                            break;
                     }
                 }
             }
 
-            logger.LogInformation("{Method} Operation Complete, Add: {Add}, Update: {Update}", nameof(Merge), add, update);
+            logger.LogInformation("Merge operation complete, [Add: {Add}], [Update: {Update}]", add, update);
             return new(add, update, 0);
         }
     }
 
-    /// <summary>
-    /// 覆盖
-    /// </summary>
-    /// <param name="archiveId">成就id</param>
-    /// <param name="items">待覆盖的项</param>
-    /// <returns>导入结果</returns>
     public ImportResult Overwrite(Guid archiveId, IEnumerable<EntityAchievement> items)
     {
-        logger.LogInformation("Perform {Method} Operation for archive: {Id}", nameof(Overwrite), archiveId);
+        logger.LogInformation("Perform Overwrite Operation for [Archive: {Id}]", archiveId);
         using (IServiceScope scope = serviceProvider.CreateScope())
         {
-            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
+            AppDbContext appDbContext = scope.GetAppDbContext();
 
             IOrderedQueryable<EntityAchievement> oldData = appDbContext.Achievements
                 .AsNoTracking()
                 .Where(a => a.ArchiveId == archiveId)
                 .OrderBy(a => a.Id);
 
-            int add = 0;
-            int update = 0;
-            int remove = 0;
+            (int add, int update, int remove) = (0, 0, 0);
 
-            using (IEnumerator<EntityAchievement> oldDataEnumerator = oldData.GetEnumerator())
+            using (TwoEnumerbleEnumerator<EntityAchievement, EntityAchievement> enumerator = new(oldData, items))
             {
-                using (IEnumerator<EntityAchievement> newDataEnumerator = items.GetEnumerator())
+                (bool moveOld, bool moveNew) = (true, true);
+
+                while (true)
                 {
-                    bool moveOld = true;
-                    bool moveNew = true;
-
-                    while (true)
+                    if (!enumerator.MoveNext(ref moveOld, ref moveNew))
                     {
-                        bool moveOldResult = moveOld && oldDataEnumerator.MoveNext();
-                        bool moveNewResult = moveNew && newDataEnumerator.MoveNext();
+                        break;
+                    }
 
-                        if (moveOldResult || moveNewResult)
-                        {
-                            EntityAchievement? oldEntity = oldDataEnumerator.Current;
-                            EntityAchievement? newEntity = newDataEnumerator.Current;
-
-                            if (oldEntity is null && newEntity is not null)
-                            {
-                                appDbContext.Achievements.AddAndSave(newEntity);
-                                add++;
-                                continue;
-                            }
-                            else if (oldEntity is not null && newEntity is null)
-                            {
-                                appDbContext.Achievements.RemoveAndSave(oldEntity);
-                                remove++;
-                                continue;
-                            }
+                    (EntityAchievement? oldEntity, EntityAchievement? newEntity) = enumerator.Current;
 
+                    switch (oldEntity, newEntity)
+                    {
+                        case (null, not null):
+                            appDbContext.Achievements.AddAndSave(newEntity);
+                            add++;
+                            continue;
+                        case (not null, null):
+                            appDbContext.Achievements.RemoveAndSave(oldEntity);
+                            remove++;
+                            continue;
+                        default:
                             ArgumentNullException.ThrowIfNull(oldEntity);
                             ArgumentNullException.ThrowIfNull(newEntity);
 
-                            if (oldEntity.Id < newEntity.Id)
+                            switch (oldEntity.Id.CompareTo(newEntity.Id))
                             {
-                                moveOld = true;
-                                moveNew = false;
-                                appDbContext.Achievements.RemoveAndSave(oldEntity);
-                                remove++;
-                            }
-                            else if (oldEntity.Id == newEntity.Id)
-                            {
-                                moveOld = true;
-                                moveNew = true;
+                                case < 0:
+                                    (moveOld, moveNew) = (true, false);
+                                    break;
+                                case 0:
+                                    (moveOld, moveNew) = (true, true);
+
+                                    if (oldEntity.Equals(newEntity))
+                                    {
+                                        // Skip same entry, reduce write operation.
+                                        continue;
+                                    }
+                                    else
+                                    {
+                                        appDbContext.Achievements.RemoveAndSave(oldEntity);
+                                        appDbContext.Achievements.AddAndSave(newEntity);
+                                        update++;
+                                    }
+
+                                    break;
+                                case > 0:
+                                    (moveOld, moveNew) = (false, true);
 
-                                if (oldEntity.Equals(newEntity))
-                                {
-                                    // skip same entry.
-                                    continue;
-                                }
-                                else
-                                {
-                                    appDbContext.Achievements.RemoveAndSave(oldEntity);
                                     appDbContext.Achievements.AddAndSave(newEntity);
-                                    update++;
-                                }
+                                    add++;
+                                    break;
                             }
-                            else
-                            {
-                                // entity.Id > uiaf.Id
-                                moveOld = false;
-                                moveNew = true;
-                                appDbContext.Achievements.AddAndSave(newEntity);
-                                add++;
-                            }
-                        }
-                        else
-                        {
+
                             break;
-                        }
                     }
                 }
             }
 
-            logger.LogInformation("{Method} Operation Complete, Add: {Add}, Update: {Update}, Remove: {Remove}", nameof(Overwrite), add, update, remove);
+            logger.LogInformation("Overwrite Operation Complete, Add: {Add}, Update: {Update}, Remove: {Remove}", add, update, remove);
             return new(add, update, remove);
         }
     }

src/Snap.Hutao/Snap.Hutao/Service/Achievement/AchievementDbService.cs

@@ -2,167 +2,106 @@
 // Licensed under the MIT license.
 
 using Microsoft.EntityFrameworkCore;
-using Snap.Hutao.Core.Database;
 using Snap.Hutao.Core.ExceptionService;
 using Snap.Hutao.Model.Entity;
-using Snap.Hutao.Model.Entity.Database;
 using Snap.Hutao.Model.Primitive;
+using Snap.Hutao.Service.Abstraction;
 using System.Collections.ObjectModel;
 using EntityAchievement = Snap.Hutao.Model.Entity.Achievement;
 
 namespace Snap.Hutao.Service.Achievement;
 
-/// <summary>
-/// 成就数据库服务
-/// </summary>
 [ConstructorGenerated]
 [Injection(InjectAs.Singleton, typeof(IAchievementDbService))]
 internal sealed partial class AchievementDbService : IAchievementDbService
 {
     private readonly IServiceProvider serviceProvider;
 
+    public IServiceProvider ServiceProvider { get => serviceProvider; }
+
     public Dictionary<AchievementId, EntityAchievement> GetAchievementMapByArchiveId(Guid archiveId)
     {
-        Dictionary<AchievementId, EntityAchievement> entities;
         try
         {
-            using (IServiceScope scope = serviceProvider.CreateScope())
-            {
-                AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
-                entities = appDbContext.Achievements
-                    .AsNoTracking()
-                    .Where(a => a.ArchiveId == archiveId)
-                    .ToDictionary(a => (AchievementId)a.Id);
-            }
+            return this.Query<EntityAchievement, Dictionary<AchievementId, EntityAchievement>>(query => query
+                .Where(a => a.ArchiveId == archiveId)
+                .ToDictionary(a => (AchievementId)a.Id));
         }
         catch (ArgumentException ex)
         {
-            throw ThrowHelper.DatabaseCorrupted(SH.ServiceAchievementUserdataCorruptedInnerIdNotUnique, ex);
+            throw HutaoException.UserdataCorrupted(SH.ServiceAchievementUserdataCorruptedAchievementIdNotUnique, ex);
         }
-
-        return entities;
     }
 
-    public async ValueTask<int> GetFinishedAchievementCountByArchiveIdAsync(Guid archiveId)
+    public ValueTask<int> GetFinishedAchievementCountByArchiveIdAsync(Guid archiveId, CancellationToken token = default)
     {
-        using (IServiceScope scope = serviceProvider.CreateScope())
-        {
-            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
-            return await appDbContext.Achievements
-                .AsNoTracking()
+        return this.QueryAsync<EntityAchievement, int>(
+            (query, token) => query
                 .Where(a => a.ArchiveId == archiveId)
                 .Where(a => a.Status >= Model.Intrinsic.AchievementStatus.STATUS_FINISHED)
-                .CountAsync()
-                .ConfigureAwait(false);
-        }
+                .CountAsync(token),
+            token);
     }
 
     [SuppressMessage("", "CA1305")]
-    public async ValueTask<List<EntityAchievement>> GetLatestFinishedAchievementListByArchiveIdAsync(Guid archiveId, int take)
+    public ValueTask<List<EntityAchievement>> GetLatestFinishedAchievementListByArchiveIdAsync(Guid archiveId, int take, CancellationToken token = default)
     {
-        using (IServiceScope scope = serviceProvider.CreateScope())
-        {
-            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
-            return await appDbContext.Achievements
-                .AsNoTracking()
+        return this.QueryAsync<EntityAchievement, List<EntityAchievement>>(
+            (query, token) => query
                 .Where(a => a.ArchiveId == archiveId)
                 .Where(a => a.Status >= Model.Intrinsic.AchievementStatus.STATUS_FINISHED)
                 .OrderByDescending(a => a.Time.ToString())
                 .Take(take)
-                .ToListAsync()
-                .ConfigureAwait(false);
-        }
+                .ToListAsync(token),
+            token);
     }
 
     public void OverwriteAchievement(EntityAchievement achievement)
     {
-        using (IServiceScope scope = serviceProvider.CreateScope())
+        this.DeleteByInnerId(achievement);
+        if (achievement.Status >= Model.Intrinsic.AchievementStatus.STATUS_FINISHED)
         {
-            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
-
-            // Delete exists one.
-            appDbContext.Achievements.ExecuteDeleteWhere(e => e.InnerId == achievement.InnerId);
-            if (achievement.Status >= Model.Intrinsic.AchievementStatus.STATUS_FINISHED)
-            {
-                appDbContext.Achievements.AddAndSave(achievement);
-            }
+            this.Add(achievement);
         }
     }
 
-    public async ValueTask OverwriteAchievementAsync(EntityAchievement achievement)
+    public async ValueTask OverwriteAchievementAsync(EntityAchievement achievement, CancellationToken token = default)
     {
-        using (IServiceScope scope = serviceProvider.CreateScope())
+        await this.DeleteByInnerIdAsync(achievement, token).ConfigureAwait(false);
+        if (achievement.Status >= Model.Intrinsic.AchievementStatus.STATUS_FINISHED)
         {
-            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
-
-            // Delete exists one.
-            await appDbContext.Achievements.ExecuteDeleteWhereAsync(e => e.InnerId == achievement.InnerId).ConfigureAwait(false);
-            if (achievement.Status >= Model.Intrinsic.AchievementStatus.STATUS_FINISHED)
-            {
-                await appDbContext.Achievements.AddAndSaveAsync(achievement).ConfigureAwait(false);
-            }
+            await this.AddAsync(achievement, token).ConfigureAwait(false);
         }
     }
 
     public ObservableCollection<AchievementArchive> GetAchievementArchiveCollection()
     {
-        using (IServiceScope scope = serviceProvider.CreateScope())
-        {
-            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
-            return appDbContext.AchievementArchives.AsNoTracking().ToObservableCollection();
-        }
+        return this.ObservableCollection<AchievementArchive>();
     }
 
-    public async ValueTask RemoveAchievementArchiveAsync(AchievementArchive archive)
+    public async ValueTask RemoveAchievementArchiveAsync(AchievementArchive archive, CancellationToken token = default)
     {
-        using (IServiceScope scope = serviceProvider.CreateScope())
-        {
-            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
-
-            // It will cascade deleted the achievements.
-            await appDbContext.AchievementArchives.RemoveAndSaveAsync(archive).ConfigureAwait(false);
-        }
+        // It will cascade deleted the achievements.
+        await this.DeleteAsync(archive, token).ConfigureAwait(false);
     }
 
     public List<EntityAchievement> GetAchievementListByArchiveId(Guid archiveId)
     {
-        using (IServiceScope scope = serviceProvider.CreateScope())
-        {
-            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
-            IQueryable<EntityAchievement> result = appDbContext.Achievements.AsNoTracking().Where(i => i.ArchiveId == archiveId);
-            return [.. result];
-        }
+        return this.ListByArchiveId<EntityAchievement>(archiveId);
     }
 
-    public async ValueTask<List<EntityAchievement>> GetAchievementListByArchiveIdAsync(Guid archiveId)
+    public ValueTask<List<EntityAchievement>> GetAchievementListByArchiveIdAsync(Guid archiveId, CancellationToken token = default)
     {
-        using (IServiceScope scope = serviceProvider.CreateScope())
-        {
-            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
-            return await appDbContext.Achievements
-                .AsNoTracking()
-                .Where(i => i.ArchiveId == archiveId)
-                .ToListAsync()
-                .ConfigureAwait(false);
-        }
+        return this.ListByArchiveIdAsync<EntityAchievement>(archiveId, token);
     }
 
     public List<AchievementArchive> GetAchievementArchiveList()
     {
-        using (IServiceScope scope = serviceProvider.CreateScope())
-        {
-            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
-            IQueryable<AchievementArchive> result = appDbContext.AchievementArchives.AsNoTracking();
-            return [.. result];
-        }
+        return this.List<AchievementArchive>();
     }
 
-    public async ValueTask<List<AchievementArchive>> GetAchievementArchiveListAsync()
+    public ValueTask<List<AchievementArchive>> GetAchievementArchiveListAsync(CancellationToken token = default)
     {
-        using (IServiceScope scope = serviceProvider.CreateScope())
-        {
-            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
-            return await appDbContext.AchievementArchives.AsNoTracking().ToListAsync().ConfigureAwait(false);
-        }
+        return this.ListAsync<AchievementArchive>(token);
     }
 }

src/Snap.Hutao/Snap.Hutao/Service/Achievement/AchievementService.Archive.cs

@@ -1,79 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Snap.Hutao.Core.Database;
-using Snap.Hutao.Model.Entity;
-using System.Collections.ObjectModel;
-
-namespace Snap.Hutao.Service.Achievement;
-
-/// <summary>
-/// 集合部分
-/// </summary>
-internal sealed partial class AchievementService
-{
-    private ObservableCollection<AchievementArchive>? archiveCollection;
-
-    /// <inheritdoc/>
-    public AchievementArchive? CurrentArchive
-    {
-        get => dbCurrent.Current;
-        set => dbCurrent.Current = value;
-    }
-
-    /// <inheritdoc/>
-    public ObservableCollection<AchievementArchive> ArchiveCollection
-    {
-        get
-        {
-            if (archiveCollection is null)
-            {
-                archiveCollection = achievementDbService.GetAchievementArchiveCollection();
-                CurrentArchive = archiveCollection.SelectedOrDefault();
-            }
-
-            return archiveCollection;
-        }
-    }
-
-    /// <inheritdoc/>
-    public async ValueTask<ArchiveAddResult> AddArchiveAsync(AchievementArchive newArchive)
-    {
-        if (string.IsNullOrWhiteSpace(newArchive.Name))
-        {
-            return ArchiveAddResult.InvalidName;
-        }
-
-        ArgumentNullException.ThrowIfNull(archiveCollection);
-
-        // 查找是否有相同的名称
-        if (archiveCollection.Any(a => a.Name == newArchive.Name))
-        {
-            return ArchiveAddResult.AlreadyExists;
-        }
-
-        // Sync cache
-        await taskContext.SwitchToMainThreadAsync();
-        archiveCollection.Add(newArchive);
-
-        // Sync database
-        await taskContext.SwitchToBackgroundAsync();
-        CurrentArchive = newArchive;
-
-        return ArchiveAddResult.Added;
-    }
-
-    /// <inheritdoc/>
-    public async ValueTask RemoveArchiveAsync(AchievementArchive archive)
-    {
-        ArgumentNullException.ThrowIfNull(archiveCollection);
-
-        // Sync cache
-        await taskContext.SwitchToMainThreadAsync();
-        archiveCollection.Remove(archive);
-
-        // Sync database
-        await taskContext.SwitchToBackgroundAsync();
-        await achievementDbService.RemoveAchievementArchiveAsync(archive).ConfigureAwait(false);
-    }
-}

src/Snap.Hutao/Snap.Hutao/Service/Achievement/AchievementService.Interchange.cs

@@ -1,64 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Snap.Hutao.Model.Entity;
-using Snap.Hutao.Model.InterChange.Achievement;
-using EntityAchievement = Snap.Hutao.Model.Entity.Achievement;
-
-namespace Snap.Hutao.Service.Achievement;
-
-/// <summary>
-/// 数据交换部分
-/// </summary>
-internal sealed partial class AchievementService
-{
-    /// <inheritdoc/>
-    public async ValueTask<ImportResult> ImportFromUIAFAsync(AchievementArchive archive, List<UIAFItem> list, ImportStrategy strategy)
-    {
-        await taskContext.SwitchToBackgroundAsync();
-
-        Guid archiveId = archive.InnerId;
-
-        switch (strategy)
-        {
-            case ImportStrategy.AggressiveMerge:
-                {
-                    IOrderedEnumerable<UIAFItem> orederedUIAF = list.OrderBy(a => a.Id);
-                    return achievementDbBulkOperation.Merge(archiveId, orederedUIAF, true);
-                }
-
-            case ImportStrategy.LazyMerge:
-                {
-                    IOrderedEnumerable<UIAFItem> orederedUIAF = list.OrderBy(a => a.Id);
-                    return achievementDbBulkOperation.Merge(archiveId, orederedUIAF, false);
-                }
-
-            case ImportStrategy.Overwrite:
-                {
-                    IEnumerable<EntityAchievement> orederedUIAF = list
-                        .Select(uiaf => EntityAchievement.From(archiveId, uiaf))
-                        .OrderBy(a => a.Id);
-                    return achievementDbBulkOperation.Overwrite(archiveId, orederedUIAF);
-                }
-
-            default:
-                throw Must.NeverHappen();
-        }
-    }
-
-    /// <inheritdoc/>
-    public async ValueTask<UIAF> ExportToUIAFAsync(AchievementArchive archive)
-    {
-        await taskContext.SwitchToBackgroundAsync();
-        List<EntityAchievement> entities = await achievementDbService
-            .GetAchievementListByArchiveIdAsync(archive.InnerId)
-            .ConfigureAwait(false);
-        List<UIAFItem> list = entities.SelectList(UIAFItem.From);
-
-        return new()
-        {
-            Info = UIAFInfo.From(runtimeOptions),
-            List = list,
-        };
-    }
-}

src/Snap.Hutao/Snap.Hutao/Service/Achievement/AchievementService.cs

@@ -3,17 +3,16 @@
 
 using Snap.Hutao.Core;
 using Snap.Hutao.Core.Database;
+using Snap.Hutao.Core.ExceptionService;
 using Snap.Hutao.Model.Entity;
+using Snap.Hutao.Model.InterChange.Achievement;
 using Snap.Hutao.Model.Primitive;
 using Snap.Hutao.ViewModel.Achievement;
+using System.Collections.ObjectModel;
 using EntityAchievement = Snap.Hutao.Model.Entity.Achievement;
-using MetadataAchievement = Snap.Hutao.Model.Metadata.Achievement.Achievement;
 
 namespace Snap.Hutao.Service.Achievement;
 
-/// <summary>
-/// 成就服务
-/// </summary>
 [HighQuality]
 [ConstructorGenerated]
 [Injection(InjectAs.Scoped, typeof(IAchievementService))]
@@ -25,21 +24,127 @@ internal sealed partial class AchievementService : IAchievementService
     private readonly RuntimeOptions runtimeOptions;
     private readonly ITaskContext taskContext;
 
-    /// <inheritdoc/>
-    public List<AchievementView> GetAchievementViewList(AchievementArchive archive, List<MetadataAchievement> metadata)
+    private ObservableCollection<AchievementArchive>? archiveCollection;
+
+    public AchievementArchive? CurrentArchive
+    {
+        get => dbCurrent.Current;
+        set => dbCurrent.Current = value;
+    }
+
+    public ObservableCollection<AchievementArchive> ArchiveCollection
+    {
+        get
+        {
+            if (archiveCollection is null)
+            {
+                archiveCollection = achievementDbService.GetAchievementArchiveCollection();
+                CurrentArchive = archiveCollection.SelectedOrDefault();
+            }
+
+            return archiveCollection;
+        }
+    }
+
+    public List<AchievementView> GetAchievementViewList(AchievementArchive archive, AchievementServiceMetadataContext context)
     {
         Dictionary<AchievementId, EntityAchievement> entities = achievementDbService.GetAchievementMapByArchiveId(archive.InnerId);
 
-        return metadata.SelectList(meta =>
+        return context.Achievements.SelectList(meta =>
         {
             EntityAchievement entity = entities.GetValueOrDefault(meta.Id) ?? EntityAchievement.From(archive.InnerId, meta.Id);
             return new AchievementView(entity, meta);
         });
     }
 
-    /// <inheritdoc/>
     public void SaveAchievement(AchievementView achievement)
     {
         achievementDbService.OverwriteAchievement(achievement.Entity);
     }
+
+    public async ValueTask<ArchiveAddResultKind> AddArchiveAsync(AchievementArchive newArchive)
+    {
+        if (string.IsNullOrWhiteSpace(newArchive.Name))
+        {
+            return ArchiveAddResultKind.InvalidName;
+        }
+
+        ArgumentNullException.ThrowIfNull(archiveCollection);
+
+        if (archiveCollection.Any(a => a.Name == newArchive.Name))
+        {
+            return ArchiveAddResultKind.AlreadyExists;
+        }
+
+        // Sync cache
+        await taskContext.SwitchToMainThreadAsync();
+        archiveCollection.Add(newArchive);
+
+        // Sync database
+        await taskContext.SwitchToBackgroundAsync();
+        CurrentArchive = newArchive;
+
+        return ArchiveAddResultKind.Added;
+    }
+
+    public async ValueTask RemoveArchiveAsync(AchievementArchive archive)
+    {
+        ArgumentNullException.ThrowIfNull(archiveCollection);
+
+        // Sync cache
+        await taskContext.SwitchToMainThreadAsync();
+        archiveCollection.Remove(archive);
+
+        // Sync database
+        await taskContext.SwitchToBackgroundAsync();
+        await achievementDbService.RemoveAchievementArchiveAsync(archive).ConfigureAwait(false);
+    }
+
+    public async ValueTask<ImportResult> ImportFromUIAFAsync(AchievementArchive archive, List<UIAFItem> list, ImportStrategyKind strategy)
+    {
+        await taskContext.SwitchToBackgroundAsync();
+
+        Guid archiveId = archive.InnerId;
+
+        switch (strategy)
+        {
+            case ImportStrategyKind.AggressiveMerge:
+                {
+                    IOrderedEnumerable<UIAFItem> orederedUIAF = list.OrderBy(a => a.Id);
+                    return achievementDbBulkOperation.Merge(archiveId, orederedUIAF, true);
+                }
+
+            case ImportStrategyKind.LazyMerge:
+                {
+                    IOrderedEnumerable<UIAFItem> orederedUIAF = list.OrderBy(a => a.Id);
+                    return achievementDbBulkOperation.Merge(archiveId, orederedUIAF, false);
+                }
+
+            case ImportStrategyKind.Overwrite:
+                {
+                    IEnumerable<EntityAchievement> orederedUIAF = list
+                        .SelectList(uiaf => EntityAchievement.From(archiveId, uiaf))
+                        .SortBy(a => a.Id);
+                    return achievementDbBulkOperation.Overwrite(archiveId, orederedUIAF);
+                }
+
+            default:
+                throw HutaoException.NotSupported();
+        }
+    }
+
+    public async ValueTask<UIAF> ExportToUIAFAsync(AchievementArchive archive)
+    {
+        await taskContext.SwitchToBackgroundAsync();
+        List<EntityAchievement> entities = await achievementDbService
+            .GetAchievementListByArchiveIdAsync(archive.InnerId)
+            .ConfigureAwait(false);
+        List<UIAFItem> list = entities.SelectList(UIAFItem.From);
+
+        return new()
+        {
+            Info = UIAFInfo.From(runtimeOptions),
+            List = list,
+        };
+    }
 }

src/Snap.Hutao/Snap.Hutao/Service/Achievement/AchievementServiceMetadataContext.cs

@@ -0,0 +1,17 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.Model.Primitive;
+using Snap.Hutao.Service.Metadata.ContextAbstraction;
+using MetadataAchievement = Snap.Hutao.Model.Metadata.Achievement.Achievement;
+
+namespace Snap.Hutao.Service.Achievement;
+
+internal sealed class AchievementServiceMetadataContext : IMetadataContext,
+    IMetadataListAchievementSource,
+    IMetadataDictionaryIdAchievementSource
+{
+    public List<MetadataAchievement> Achievements { get; set; } = default!;
+
+    public Dictionary<AchievementId, MetadataAchievement> IdAchievementMap { get; set; } = default!;
+}

src/Snap.Hutao/Snap.Hutao/Service/Achievement/AchievementStatisticsService.cs

@@ -13,32 +13,34 @@ namespace Snap.Hutao.Service.Achievement;
 [Injection(InjectAs.Scoped, typeof(IAchievementStatisticsService))]
 internal sealed partial class AchievementStatisticsService : IAchievementStatisticsService
 {
+    private const int AchievementCardTakeCount = 2;
+
     private readonly IAchievementDbService achievementDbService;
     private readonly ITaskContext taskContext;
 
     /// <inheritdoc/>
-    public async ValueTask<List<AchievementStatistics>> GetAchievementStatisticsAsync(Dictionary<AchievementId, MetadataAchievement> achievementMap)
+    public async ValueTask<List<AchievementStatistics>> GetAchievementStatisticsAsync(AchievementServiceMetadataContext context, CancellationToken token = default)
     {
         await taskContext.SwitchToBackgroundAsync();
 
         List<AchievementStatistics> results = [];
-        foreach (AchievementArchive archive in await achievementDbService.GetAchievementArchiveListAsync().ConfigureAwait(false))
+        foreach (AchievementArchive archive in await achievementDbService.GetAchievementArchiveListAsync(token).ConfigureAwait(false))
         {
             int finishedCount = await achievementDbService
-                .GetFinishedAchievementCountByArchiveIdAsync(archive.InnerId)
+                .GetFinishedAchievementCountByArchiveIdAsync(archive.InnerId, token)
                 .ConfigureAwait(false);
 
-            int totalCount = achievementMap.Count;
+            int totalCount = context.IdAchievementMap.Count;
 
             List<EntityAchievement> achievements = await achievementDbService
-                .GetLatestFinishedAchievementListByArchiveIdAsync(archive.InnerId, 2)
+                .GetLatestFinishedAchievementListByArchiveIdAsync(archive.InnerId, AchievementCardTakeCount, token)
                 .ConfigureAwait(false);
 
             results.Add(new()
             {
                 DisplayName = archive.Name,
                 FinishDescription = AchievementStatistics.Format(finishedCount, totalCount, out _),
-                Achievements = achievements.SelectList(entity => new AchievementView(entity, achievementMap[entity.Id])),
+                Achievements = achievements.SelectList(entity => new AchievementView(entity, context.IdAchievementMap[entity.Id])),
             });
         }
 

src/Snap.Hutao/Snap.Hutao/Service/Achievement/ArchiveAddResultKind.cs

@@ -7,7 +7,7 @@ namespace Snap.Hutao.Service.Achievement;
 /// 存档添加结果
 /// </summary>
 [HighQuality]
-internal enum ArchiveAddResult
+internal enum ArchiveAddResultKind
 {
     /// <summary>
     /// 添加成功

src/Snap.Hutao/Snap.Hutao/Service/Achievement/IAchievementDbService.cs

@@ -2,32 +2,33 @@
 // Licensed under the MIT license.
 
 using Snap.Hutao.Model.Primitive;
+using Snap.Hutao.Service.Abstraction;
 using System.Collections.ObjectModel;
 using EntityAchievement = Snap.Hutao.Model.Entity.Achievement;
 
 namespace Snap.Hutao.Service.Achievement;
 
-internal interface IAchievementDbService
+internal interface IAchievementDbService : IAppDbService<Model.Entity.AchievementArchive>, IAppDbService<EntityAchievement>
 {
-    ValueTask RemoveAchievementArchiveAsync(Model.Entity.AchievementArchive archive);
+    ValueTask RemoveAchievementArchiveAsync(Model.Entity.AchievementArchive archive, CancellationToken token = default);
 
     ObservableCollection<Model.Entity.AchievementArchive> GetAchievementArchiveCollection();
 
     List<Model.Entity.AchievementArchive> GetAchievementArchiveList();
 
-    ValueTask<List<Model.Entity.AchievementArchive>> GetAchievementArchiveListAsync();
+    ValueTask<List<Model.Entity.AchievementArchive>> GetAchievementArchiveListAsync(CancellationToken token = default);
 
     List<EntityAchievement> GetAchievementListByArchiveId(Guid archiveId);
 
-    ValueTask<List<EntityAchievement>> GetAchievementListByArchiveIdAsync(Guid archiveId);
+    ValueTask<List<EntityAchievement>> GetAchievementListByArchiveIdAsync(Guid archiveId, CancellationToken token = default);
 
     Dictionary<AchievementId, EntityAchievement> GetAchievementMapByArchiveId(Guid archiveId);
 
-    ValueTask<int> GetFinishedAchievementCountByArchiveIdAsync(Guid archiveId);
+    ValueTask<int> GetFinishedAchievementCountByArchiveIdAsync(Guid archiveId, CancellationToken token = default);
 
-    ValueTask<List<EntityAchievement>> GetLatestFinishedAchievementListByArchiveIdAsync(Guid archiveId, int take);
+    ValueTask<List<EntityAchievement>> GetLatestFinishedAchievementListByArchiveIdAsync(Guid archiveId, int take, CancellationToken token = default);
 
     void OverwriteAchievement(EntityAchievement achievement);
 
-    ValueTask OverwriteAchievementAsync(EntityAchievement achievement);
+    ValueTask OverwriteAchievementAsync(EntityAchievement achievement, CancellationToken token = default);
 }

src/Snap.Hutao/Snap.Hutao/Service/Achievement/IAchievementService.cs

@@ -32,13 +32,7 @@ internal interface IAchievementService
     /// <returns>UIAF</returns>
     ValueTask<UIAF> ExportToUIAFAsync(EntityArchive selectedArchive);
 
-    /// <summary>
-    /// 获取整合的成就
-    /// </summary>
-    /// <param name="archive">用户</param>
-    /// <param name="metadata">元数据</param>
-    /// <returns>整合的成就</returns>
-    List<AchievementView> GetAchievementViewList(EntityArchive archive, List<MetadataAchievement> metadata);
+    List<AchievementView> GetAchievementViewList(EntityArchive archive, AchievementServiceMetadataContext context);
 
     /// <summary>
     /// 异步导入UIAF数据
@@ -47,7 +41,7 @@ internal interface IAchievementService
     /// <param name="list">UIAF数据</param>
     /// <param name="strategy">选项</param>
     /// <returns>导入结果</returns>
-    ValueTask<ImportResult> ImportFromUIAFAsync(EntityArchive archive, List<UIAFItem> list, ImportStrategy strategy);
+    ValueTask<ImportResult> ImportFromUIAFAsync(EntityArchive archive, List<UIAFItem> list, ImportStrategyKind strategy);
 
     /// <summary>
     /// 异步移除存档
@@ -67,5 +61,5 @@ internal interface IAchievementService
     /// </summary>
     /// <param name="newArchive">新存档</param>
     /// <returns>存档添加结果</returns>
-    ValueTask<ArchiveAddResult> AddArchiveAsync(EntityArchive newArchive);
+    ValueTask<ArchiveAddResultKind> AddArchiveAsync(EntityArchive newArchive);
 }

src/Snap.Hutao/Snap.Hutao/Service/Achievement/IAchievementStatisticsService.cs

@@ -9,5 +9,5 @@ namespace Snap.Hutao.Service.Achievement;
 
 internal interface IAchievementStatisticsService
 {
-    ValueTask<List<AchievementStatistics>> GetAchievementStatisticsAsync(Dictionary<AchievementId, MetadataAchievement> achievementMap);
+    ValueTask<List<AchievementStatistics>> GetAchievementStatisticsAsync(AchievementServiceMetadataContext context, CancellationToken token = default);
 }

src/Snap.Hutao/Snap.Hutao/Service/Achievement/ImportStrategyKind.cs

@@ -7,7 +7,7 @@ namespace Snap.Hutao.Service.Achievement;
 /// 导入策略
 /// </summary>
 [HighQuality]
-internal enum ImportStrategy
+internal enum ImportStrategyKind
 {
     /// <summary>
     /// 贪婪合并

src/Snap.Hutao/Snap.Hutao/Service/Announcement/AnnouncementService.cs

@@ -0,0 +1,213 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.Extensions.Caching.Memory;
+using Snap.Hutao.Core;
+using Snap.Hutao.Service.Announcement;
+using Snap.Hutao.Web.Hoyolab;
+using Snap.Hutao.Web.Hoyolab.Hk4e.Common.Announcement;
+using Snap.Hutao.Web.Response;
+using System.Collections.Specialized;
+using System.Runtime.InteropServices;
+using System.Text;
+using System.Text.RegularExpressions;
+using WebAnnouncement = Snap.Hutao.Web.Hoyolab.Hk4e.Common.Announcement.Announcement;
+
+namespace Snap.Hutao.Service;
+
+/// <inheritdoc/>
+[HighQuality]
+[ConstructorGenerated]
+[Injection(InjectAs.Scoped, typeof(IAnnouncementService))]
+internal sealed partial class AnnouncementService : IAnnouncementService
+{
+    private static readonly string CacheKey = $"{nameof(AnnouncementService)}.Cache.{nameof(AnnouncementWrapper)}";
+
+    private readonly IServiceScopeFactory serviceScopeFactory;
+    private readonly ITaskContext taskContext;
+    private readonly IMemoryCache memoryCache;
+
+    public async ValueTask<AnnouncementWrapper> GetAnnouncementWrapperAsync(string languageCode, Region region, CancellationToken cancellationToken = default)
+    {
+        // 缓存中存在记录，直接返回
+        if (memoryCache.TryGetRequiredValue($"{CacheKey}.{languageCode}.{region}", out AnnouncementWrapper? cache))
+        {
+            return cache;
+        }
+
+        await taskContext.SwitchToBackgroundAsync();
+
+        List<AnnouncementContent>? contents;
+        AnnouncementWrapper wrapper;
+        using (IServiceScope scope = serviceScopeFactory.CreateScope())
+        {
+            AnnouncementClient announcementClient = scope.ServiceProvider.GetRequiredService<AnnouncementClient>();
+
+            Response<AnnouncementWrapper> announcementWrapperResponse = await announcementClient
+                .GetAnnouncementsAsync(languageCode, region, cancellationToken)
+                .ConfigureAwait(false);
+
+            if (!announcementWrapperResponse.IsOk())
+            {
+                return default!;
+            }
+
+            wrapper = announcementWrapperResponse.Data;
+
+            Response<ListWrapper<AnnouncementContent>> announcementContentResponse = await announcementClient
+                .GetAnnouncementContentsAsync(languageCode, region, cancellationToken)
+                .ConfigureAwait(false);
+
+            if (!announcementContentResponse.IsOk())
+            {
+                return default!;
+            }
+
+            contents = announcementContentResponse.Data.List;
+        }
+
+        Dictionary<int, string> contentMap = contents.ToDictionary(id => id.AnnId, content => content.Content);
+
+        // 将活动公告置于前方
+        wrapper.List.Reverse();
+
+        PreprocessAnnouncements(contentMap, wrapper.List, new(wrapper.TimeZone, 0, 0));
+
+        return memoryCache.Set(CacheKey, wrapper, TimeSpan.FromMinutes(30));
+    }
+
+    private static void PreprocessAnnouncements(Dictionary<int, string> contentMap, List<AnnouncementListWrapper> announcementListWrappers, in TimeSpan offset)
+    {
+        // 将公告内容联入公告列表
+        foreach (ref readonly AnnouncementListWrapper listWrapper in CollectionsMarshal.AsSpan(announcementListWrappers))
+        {
+            foreach (ref readonly WebAnnouncement item in CollectionsMarshal.AsSpan(listWrapper.List))
+            {
+                item.Content = contentMap.GetValueOrDefault(item.AnnId, string.Empty);
+            }
+        }
+
+        AdjustAnnouncementTime(announcementListWrappers, offset);
+
+        foreach (ref readonly AnnouncementListWrapper listWrapper in CollectionsMarshal.AsSpan(announcementListWrappers))
+        {
+            foreach (ref readonly WebAnnouncement item in CollectionsMarshal.AsSpan(listWrapper.List))
+            {
+                item.Subtitle = new StringBuilder(item.Subtitle)
+                    .Replace("\r<br>", string.Empty)
+                    .Replace("<br />", string.Empty)
+                    .ToString();
+                item.Content = AnnouncementRegex
+                    .XmlTimeTagRegex()
+                    .Replace(item.Content, x => x.Groups[1].Value);
+            }
+        }
+    }
+
+    private static void AdjustAnnouncementTime(List<AnnouncementListWrapper> announcementListWrappers, in TimeSpan offset)
+    {
+        // 活动公告
+        List<WebAnnouncement> activities = announcementListWrappers
+            .Single(wrapper => wrapper.TypeId == 1)
+            .List;
+
+        // 游戏公告
+        List<WebAnnouncement> announcements = announcementListWrappers
+            .Single(wrapper => wrapper.TypeId == 2)
+            .List;
+
+        Dictionary<string, DateTimeOffset> versionStartTimes = [];
+
+        // 更新公告
+        if (announcements.SingleOrDefault(ann => AnnouncementRegex.VersionUpdateTitleRegex.IsMatch(ann.Title)) is { } versionUpdate)
+        {
+            if (AnnouncementRegex.VersionUpdateTimeRegex.Match(versionUpdate.Content) is not { Success: true } versionUpdateMatch)
+            {
+                return;
+            }
+
+            DateTimeOffset versionUpdateTime = UnsafeDateTimeOffset.ParseDateTime(versionUpdateMatch.Groups[1].ValueSpan, offset);
+            versionStartTimes.TryAdd(VersionRegex().Match(versionUpdate.Title).Groups[1].Value, versionUpdateTime);
+        }
+
+        // 更新预告
+        if (announcements.SingleOrDefault(ann => AnnouncementRegex.VersionUpdatePreviewTitleRegex.IsMatch(ann.Title)) is { } versionUpdatePreview)
+        {
+            if (AnnouncementRegex.VersionUpdatePreviewTimeRegex.Match(versionUpdatePreview.Content) is not { Success: true } versionUpdatePreviewMatch)
+            {
+                return;
+            }
+
+            DateTimeOffset versionUpdatePreviewTime = UnsafeDateTimeOffset.ParseDateTime(versionUpdatePreviewMatch.Groups[1].ValueSpan, offset);
+            versionStartTimes.TryAdd(VersionRegex().Match(versionUpdatePreview.Title).Groups[1].Value, versionUpdatePreviewTime);
+        }
+
+        foreach (ref readonly WebAnnouncement announcement in CollectionsMarshal.AsSpan(activities))
+        {
+            DateTimeOffset versionStartTime;
+
+            if (AnnouncementRegex.PermanentActivityAfterUpdateTimeRegex.Match(announcement.Content) is { Success: true } permanent)
+            {
+                if (versionStartTimes.TryGetValue(permanent.Groups[1].Value, out versionStartTime))
+                {
+                    announcement.StartTime = versionStartTime;
+                    continue;
+                }
+            }
+
+            if (AnnouncementRegex.PersistentActivityAfterUpdateTimeRegex.Match(announcement.Content) is { Success: true } persistent)
+            {
+                if (versionStartTimes.TryGetValue(persistent.Groups[1].Value, out versionStartTime))
+                {
+                    announcement.StartTime = versionStartTime;
+                    announcement.EndTime = versionStartTime + TimeSpan.FromDays(42);
+                    continue;
+                }
+            }
+
+            if (AnnouncementRegex.TransientActivityAfterUpdateTimeRegex.Match(announcement.Content) is { Success: true } transient)
+            {
+                if (versionStartTimes.TryGetValue(transient.Groups[1].Value, out versionStartTime))
+                {
+                    announcement.StartTime = versionStartTime;
+                    announcement.EndTime = UnsafeDateTimeOffset.ParseDateTime(transient.Groups[2].ValueSpan, offset);
+                    continue;
+                }
+            }
+
+            MatchCollection matches = AnnouncementRegex.XmlTimeTagRegex().Matches(announcement.Content);
+            if (matches.Count < 2)
+            {
+                continue;
+            }
+
+            List<DateTimeOffset> dateTimes = [];
+            foreach (Match timeMatch in (IList<Match>)matches)
+            {
+                dateTimes.Add(UnsafeDateTimeOffset.ParseDateTime(timeMatch.Groups[1].ValueSpan, offset));
+            }
+
+            DateTimeOffset min = DateTimeOffset.MaxValue;
+            DateTimeOffset max = DateTimeOffset.MinValue;
+
+            foreach (DateTimeOffset time in dateTimes)
+            {
+                if (time < min)
+                {
+                    min = time;
+                }
+
+                if (time > max)
+                {
+                    max = time;
+                }
+            }
+
+            announcement.StartTime = min;
+            announcement.EndTime = max;
+        }
+    }
+
+    [GeneratedRegex("(\\d\\.\\d)")]
+    private static partial Regex VersionRegex();
+}

src/Snap.Hutao/Snap.Hutao/Service/Announcement/IAnnouncementService.cs

@@ -4,7 +4,7 @@
 using Snap.Hutao.Web.Hoyolab;
 using Snap.Hutao.Web.Hoyolab.Hk4e.Common.Announcement;
 
-namespace Snap.Hutao.Service.Abstraction;
+namespace Snap.Hutao.Service.Announcement;
 
 /// <summary>
 /// 公告服务

src/Snap.Hutao/Snap.Hutao/Service/AnnouncementService.cs

@@ -1,173 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Microsoft.Extensions.Caching.Memory;
-using Snap.Hutao.Core;
-using Snap.Hutao.Service.Abstraction;
-using Snap.Hutao.Web.Hoyolab;
-using Snap.Hutao.Web.Hoyolab.Hk4e.Common.Announcement;
-using Snap.Hutao.Web.Response;
-using System.Runtime.InteropServices;
-using System.Text;
-using System.Text.RegularExpressions;
-
-namespace Snap.Hutao.Service;
-
-/// <inheritdoc/>
-[HighQuality]
-[ConstructorGenerated]
-[Injection(InjectAs.Transient, typeof(IAnnouncementService))]
-internal sealed partial class AnnouncementService : IAnnouncementService
-{
-    private static readonly string CacheKey = $"{nameof(AnnouncementService)}.Cache.{nameof(AnnouncementWrapper)}";
-
-    private readonly AnnouncementClient announcementClient;
-    private readonly ITaskContext taskContext;
-    private readonly IMemoryCache memoryCache;
-
-    /// <inheritdoc/>
-    public async ValueTask<AnnouncementWrapper> GetAnnouncementWrapperAsync(string languageCode, Region region, CancellationToken cancellationToken = default)
-    {
-        // 缓存中存在记录，直接返回
-        if (memoryCache.TryGetRequiredValue($"{CacheKey}.{languageCode}.{region}", out AnnouncementWrapper? cache))
-        {
-            return cache;
-        }
-
-        await taskContext.SwitchToBackgroundAsync();
-        Response<AnnouncementWrapper> announcementWrapperResponse = await announcementClient
-            .GetAnnouncementsAsync(languageCode, region, cancellationToken)
-            .ConfigureAwait(false);
-
-        if (!announcementWrapperResponse.IsOk())
-        {
-            return default!;
-        }
-
-        AnnouncementWrapper wrapper = announcementWrapperResponse.Data;
-        Response<ListWrapper<AnnouncementContent>> announcementContentResponse = await announcementClient
-            .GetAnnouncementContentsAsync(languageCode, region, cancellationToken)
-            .ConfigureAwait(false);
-
-        if (!announcementContentResponse.IsOk())
-        {
-            return default!;
-        }
-
-        List<AnnouncementContent> contents = announcementContentResponse.Data.List;
-
-        Dictionary<int, string> contentMap = contents
-            .ToDictionary(id => id.AnnId, content => content.Content);
-
-        // 将活动公告置于前方
-        wrapper.List.Reverse();
-
-        PreprocessAnnouncements(contentMap, wrapper.List, new(wrapper.TimeZone, 0, 0));
-
-        return memoryCache.Set(CacheKey, wrapper, TimeSpan.FromMinutes(30));
-    }
-
-    private static void PreprocessAnnouncements(Dictionary<int, string> contentMap, List<AnnouncementListWrapper> announcementListWrappers, in TimeSpan offset)
-    {
-        // 将公告内容联入公告列表
-        foreach (ref readonly AnnouncementListWrapper listWrapper in CollectionsMarshal.AsSpan(announcementListWrappers))
-        {
-            foreach (ref readonly Announcement item in CollectionsMarshal.AsSpan(listWrapper.List))
-            {
-                contentMap.TryGetValue(item.AnnId, out string? rawContent);
-                item.Content = rawContent ?? string.Empty;
-            }
-        }
-
-        AdjustAnnouncementTime(announcementListWrappers, offset);
-
-        foreach (ref readonly AnnouncementListWrapper listWrapper in CollectionsMarshal.AsSpan(announcementListWrappers))
-        {
-            foreach (ref readonly Announcement item in CollectionsMarshal.AsSpan(listWrapper.List))
-            {
-                item.Subtitle = new StringBuilder(item.Subtitle)
-                    .Replace("\r<br>", string.Empty)
-                    .Replace("<br />", string.Empty)
-                    .ToString();
-                item.Content = AnnouncementRegex
-                    .XmlTimeTagRegex()
-                    .Replace(item.Content, x => x.Groups[1].Value);
-            }
-        }
-    }
-
-    private static void AdjustAnnouncementTime(List<AnnouncementListWrapper> announcementListWrappers, in TimeSpan offset)
-    {
-        // 活动公告
-        List<Announcement> activities = announcementListWrappers
-            .Single(wrapper => wrapper.TypeId == 1)
-            .List;
-
-        // 更新公告
-        Announcement versionUpdate = announcementListWrappers
-            .Single(wrapper => wrapper.TypeId == 2)
-            .List
-            .Single(ann => AnnouncementRegex.VersionUpdateTitleRegex.IsMatch(ann.Title));
-
-        if (AnnouncementRegex.VersionUpdateTimeRegex.Match(versionUpdate.Content) is not { Success: true } versionMatch)
-        {
-            return;
-        }
-
-        DateTimeOffset versionUpdateTime = UnsafeDateTimeOffset.ParseDateTime(versionMatch.Groups[1].ValueSpan, offset);
-
-        foreach (ref readonly Announcement announcement in CollectionsMarshal.AsSpan(activities))
-        {
-            if (AnnouncementRegex.PermanentActivityAfterUpdateTimeRegex.Match(announcement.Content) is { Success: true } permanent)
-            {
-                announcement.StartTime = versionUpdateTime;
-                continue;
-            }
-
-            if (AnnouncementRegex.PersistentActivityAfterUpdateTimeRegex.Match(announcement.Content) is { Success: true } persistent)
-            {
-                announcement.StartTime = versionUpdateTime;
-                announcement.EndTime = versionUpdateTime + TimeSpan.FromDays(42);
-                continue;
-            }
-
-            if (AnnouncementRegex.TransientActivityAfterUpdateTimeRegex.Match(announcement.Content) is { Success: true } transient)
-            {
-                announcement.StartTime = versionUpdateTime;
-                announcement.EndTime = UnsafeDateTimeOffset.ParseDateTime(transient.Groups[2].ValueSpan, offset);
-                continue;
-            }
-
-            MatchCollection matches = AnnouncementRegex.XmlTimeTagRegex().Matches(announcement.Content);
-            if (matches.Count < 2)
-            {
-                continue;
-            }
-
-            List<DateTimeOffset> dateTimes = [];
-            foreach (Match timeMatch in (IList<Match>)matches)
-            {
-                dateTimes.Add(UnsafeDateTimeOffset.ParseDateTime(timeMatch.Groups[1].ValueSpan, offset));
-            }
-
-            DateTimeOffset min = DateTimeOffset.MaxValue;
-            DateTimeOffset max = DateTimeOffset.MinValue;
-
-            foreach (DateTimeOffset time in dateTimes)
-            {
-                if (time < min)
-                {
-                    min = time;
-                }
-
-                if (time > max)
-                {
-                    max = time;
-                }
-            }
-
-            announcement.StartTime = min;
-            announcement.EndTime = max;
-        }
-    }
-}

src/Snap.Hutao/Snap.Hutao/Service/AppOptions.cs

@@ -16,6 +16,7 @@ namespace Snap.Hutao.Service;
 internal sealed partial class AppOptions : DbStoreOptions
 {
     private bool? isEmptyHistoryWishVisible;
+    private bool? isUnobtainedWishItemVisible;
     private BackdropType? backdropType;
     private ElementTheme? elementTheme;
     private BackgroundImageType? backgroundImageType;
@@ -24,10 +25,16 @@ internal sealed partial class AppOptions : DbStoreOptions
 
     public bool IsEmptyHistoryWishVisible
     {
-        get => GetOption(ref isEmptyHistoryWishVisible, SettingEntry.IsEmptyHistoryWishVisible);
+        get => GetOption(ref isEmptyHistoryWishVisible, SettingEntry.IsEmptyHistoryWishVisible, false);
         set => SetOption(ref isEmptyHistoryWishVisible, SettingEntry.IsEmptyHistoryWishVisible, value);
     }
 
+    public bool IsUnobtainedWishItemVisible
+    {
+        get => GetOption(ref isUnobtainedWishItemVisible, SettingEntry.IsUnobtainedWishItemVisible, false);
+        set => SetOption(ref isUnobtainedWishItemVisible, SettingEntry.IsUnobtainedWishItemVisible, value);
+    }
+
     public List<NameValue<BackdropType>> BackdropTypes { get; } = CollectionsNameValue.FromEnum<BackdropType>(type => type >= 0);
 
     public BackdropType BackdropType

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/AvatarInfoDbBulkOperation.cs

@@ -12,7 +12,9 @@ using Snap.Hutao.Web.Hoyolab.Takumi.Event.Calculate;
 using Snap.Hutao.Web.Hoyolab.Takumi.GameRecord;
 using Snap.Hutao.Web.Hoyolab.Takumi.GameRecord.Avatar;
 using Snap.Hutao.Web.Response;
+using System.Reflection.Emit;
 using System.Runtime.CompilerServices;
+using System.Runtime.InteropServices;
 using CalculateAvatar = Snap.Hutao.Web.Hoyolab.Takumi.Event.Calculate.Avatar;
 using EnkaAvatarInfo = Snap.Hutao.Web.Enka.Model.AvatarInfo;
 using EntityAvatarInfo = Snap.Hutao.Model.Entity.AvatarInfo;
@@ -21,9 +23,6 @@ using RecordPlayerInfo = Snap.Hutao.Web.Hoyolab.Takumi.GameRecord.PlayerInfo;
 
 namespace Snap.Hutao.Service.AvatarInfo;
 
-/// <summary>
-/// 角色信息数据库操作
-/// </summary>
 [HighQuality]
 [ConstructorGenerated]
 [Injection(InjectAs.Singleton)]
@@ -32,18 +31,10 @@ internal sealed partial class AvatarInfoDbBulkOperation
     private readonly IServiceProvider serviceProvider;
     private readonly IAvatarInfoDbService avatarInfoDbService;
 
-    /// <summary>
-    /// 更新数据库角色信息
-    /// </summary>
-    /// <param name="uid">uid</param>
-    /// <param name="webInfos">Enka信息</param>
-    /// <param name="token">取消令牌</param>
-    /// <returns>角色列表</returns>
-    public List<EntityAvatarInfo> UpdateDbAvatarInfosByShowcase(string uid, IEnumerable<EnkaAvatarInfo> webInfos, CancellationToken token)
+    public async ValueTask<List<EntityAvatarInfo>> UpdateDbAvatarInfosByShowcaseAsync(string uid, IEnumerable<EnkaAvatarInfo> webInfos, CancellationToken token)
     {
-        token.ThrowIfCancellationRequested();
-        List<EntityAvatarInfo> dbInfos = avatarInfoDbService.GetAvatarInfoListByUid(uid);
-        EnsureItemsAvatarIdDistinct(ref dbInfos, uid);
+        List<EntityAvatarInfo> dbInfos = await avatarInfoDbService.GetAvatarInfoListByUidAsync(uid).ConfigureAwait(false);
+        EnsureItemsAvatarIdUnique(ref dbInfos, uid, out Dictionary<AvatarId, EntityAvatarInfo> dbInfoMap);
 
         using (IServiceScope scope = serviceProvider.CreateScope())
         {
@@ -56,28 +47,19 @@ internal sealed partial class AvatarInfoDbBulkOperation
                     continue;
                 }
 
-                token.ThrowIfCancellationRequested();
-                EntityAvatarInfo? entity = dbInfos.SingleOrDefault(i => i.Info.AvatarId == webInfo.AvatarId);
+                EntityAvatarInfo? entity = dbInfoMap.GetValueOrDefault(webInfo.AvatarId);
                 AddOrUpdateAvatarInfo(entity, uid, appDbContext, webInfo);
             }
 
-            token.ThrowIfCancellationRequested();
-            return avatarInfoDbService.GetAvatarInfoListByUid(uid);
+            return await avatarInfoDbService.GetAvatarInfoListByUidAsync(uid).ConfigureAwait(false);
         }
     }
 
-    /// <summary>
-    /// 米游社我的角色方式 更新数据库角色信息
-    /// </summary>
-    /// <param name="userAndUid">用户与角色</param>
-    /// <param name="token">取消令牌</param>
-    /// <returns>角色列表</returns>
     public async ValueTask<List<EntityAvatarInfo>> UpdateDbAvatarInfosByGameRecordCharacterAsync(UserAndUid userAndUid, CancellationToken token)
     {
-        token.ThrowIfCancellationRequested();
         string uid = userAndUid.Uid.Value;
         List<EntityAvatarInfo> dbInfos = await avatarInfoDbService.GetAvatarInfoListByUidAsync(uid).ConfigureAwait(false);
-        EnsureItemsAvatarIdDistinct(ref dbInfos, uid);
+        EnsureItemsAvatarIdUnique(ref dbInfos, uid, out Dictionary<AvatarId, EntityAvatarInfo> dbInfoMap);
 
         using (IServiceScope scope = serviceProvider.CreateScope())
         {
@@ -90,51 +72,47 @@ internal sealed partial class AvatarInfoDbBulkOperation
                 .GetPlayerInfoAsync(userAndUid, token)
                 .ConfigureAwait(false);
 
-            if (playerInfoResponse.IsOk())
+            if (!playerInfoResponse.IsOk())
             {
-                Response<CharacterWrapper> charactersResponse = await gameRecordClient
-                    .GetCharactersAsync(userAndUid, playerInfoResponse.Data, token)
-                    .ConfigureAwait(false);
+                goto Return;
+            }
 
-                token.ThrowIfCancellationRequested();
+            Response<CharacterWrapper> charactersResponse = await gameRecordClient
+                .GetCharactersAsync(userAndUid, playerInfoResponse.Data, token)
+                .ConfigureAwait(false);
 
-                if (charactersResponse.IsOk())
+            if (!charactersResponse.IsOk())
+            {
+                goto Return;
+            }
+
+            List<RecordCharacter> characters = charactersResponse.Data.Avatars;
+
+            GameRecordCharacterAvatarInfoTransformer transformer = serviceProvider
+                .GetRequiredService<GameRecordCharacterAvatarInfoTransformer>();
+
+            foreach (RecordCharacter character in characters)
+            {
+                if (AvatarIds.IsPlayer(character.Id))
                 {
-                    List<RecordCharacter> characters = charactersResponse.Data.Avatars;
-
-                    GameRecordCharacterAvatarInfoTransformer transformer = serviceProvider
-                        .GetRequiredService<GameRecordCharacterAvatarInfoTransformer>();
-
-                    foreach (RecordCharacter character in characters)
-                    {
-                        if (AvatarIds.IsPlayer(character.Id))
-                        {
-                            continue;
-                        }
-
-                        token.ThrowIfCancellationRequested();
-                        EntityAvatarInfo? entity = dbInfos.SingleOrDefault(i => i.Info.AvatarId == character.Id);
-                        AddOrUpdateAvatarInfo(entity, character.Id, uid, appDbContext, transformer, character);
-                    }
+                    continue;
                 }
+
+                EntityAvatarInfo? entity = dbInfoMap.GetValueOrDefault(character.Id);
+                AddOrUpdateAvatarInfo(entity, character.Id, uid, appDbContext, transformer, character);
             }
         }
 
+    Return:
         return await avatarInfoDbService.GetAvatarInfoListByUidAsync(uid).ConfigureAwait(false);
     }
 
-    /// <summary>
-    /// 米游社养成计算方式 更新数据库角色信息
-    /// </summary>
-    /// <param name="userAndUid">用户与角色</param>
-    /// <param name="token">取消令牌</param>
-    /// <returns>角色列表</returns>
     public async ValueTask<List<EntityAvatarInfo>> UpdateDbAvatarInfosByCalculateAvatarDetailAsync(UserAndUid userAndUid, CancellationToken token)
     {
         token.ThrowIfCancellationRequested();
         string uid = userAndUid.Uid.Value;
         List<EntityAvatarInfo> dbInfos = await avatarInfoDbService.GetAvatarInfoListByUidAsync(uid).ConfigureAwait(false);
-        EnsureItemsAvatarIdDistinct(ref dbInfos, uid);
+        EnsureItemsAvatarIdUnique(ref dbInfos, uid, out Dictionary<AvatarId, EntityAvatarInfo> dbInfoMap);
 
         using (IServiceScope scope = serviceProvider.CreateScope())
         {
@@ -155,8 +133,6 @@ internal sealed partial class AvatarInfoDbBulkOperation
                     continue;
                 }
 
-                token.ThrowIfCancellationRequested();
-
                 Response<AvatarDetail> detailAvatarResponse = await calculateClient
                     .GetAvatarDetailAsync(userAndUid, avatar, token)
                     .ConfigureAwait(false);
@@ -166,8 +142,7 @@ internal sealed partial class AvatarInfoDbBulkOperation
                     continue;
                 }
 
-                token.ThrowIfCancellationRequested();
-                EntityAvatarInfo? entity = dbInfos.SingleOrDefault(i => i.Info.AvatarId == avatar.Id);
+                EntityAvatarInfo? entity = dbInfoMap.GetValueOrDefault(avatar.Id);
                 AddOrUpdateAvatarInfo(entity, avatar.Id, uid, appDbContext, transformer, detailAvatarResponse.Data);
             }
         }
@@ -181,15 +156,14 @@ internal sealed partial class AvatarInfoDbBulkOperation
         if (entity is null)
         {
             entity = EntityAvatarInfo.From(uid, webInfo);
-            entity.ShowcaseRefreshTime = DateTimeOffset.UtcNow;
-            appDbContext.AvatarInfos.AddAndSave(entity);
         }
         else
         {
             entity.Info = webInfo;
-            entity.ShowcaseRefreshTime = DateTimeOffset.UtcNow;
-            appDbContext.AvatarInfos.UpdateAndSave(entity);
         }
+
+        entity.ShowcaseRefreshTime = DateTimeOffset.UtcNow;
+        appDbContext.AvatarInfos.UpdateAndSave(entity);
     }
 
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
@@ -200,17 +174,16 @@ internal sealed partial class AvatarInfoDbBulkOperation
             EnkaAvatarInfo avatarInfo = new() { AvatarId = avatarId };
             transformer.Transform(ref avatarInfo, source);
             entity = EntityAvatarInfo.From(uid, avatarInfo);
-            entity.CalculatorRefreshTime = DateTimeOffset.UtcNow;
-            appDbContext.AvatarInfos.AddAndSave(entity);
         }
         else
         {
             EnkaAvatarInfo avatarInfo = entity.Info;
             transformer.Transform(ref avatarInfo, source);
             entity.Info = avatarInfo;
-            entity.CalculatorRefreshTime = DateTimeOffset.UtcNow;
-            appDbContext.AvatarInfos.UpdateAndSave(entity);
         }
+
+        entity.CalculatorRefreshTime = DateTimeOffset.UtcNow;
+        appDbContext.AvatarInfos.UpdateAndSave(entity);
     }
 
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
@@ -221,29 +194,29 @@ internal sealed partial class AvatarInfoDbBulkOperation
             EnkaAvatarInfo avatarInfo = new() { AvatarId = avatarId };
             transformer.Transform(ref avatarInfo, source);
             entity = EntityAvatarInfo.From(uid, avatarInfo);
-            entity.GameRecordRefreshTime = DateTimeOffset.UtcNow;
-            appDbContext.AvatarInfos.AddAndSave(entity);
         }
         else
         {
             EnkaAvatarInfo avatarInfo = entity.Info;
             transformer.Transform(ref avatarInfo, source);
             entity.Info = avatarInfo;
-            entity.GameRecordRefreshTime = DateTimeOffset.UtcNow;
-            appDbContext.AvatarInfos.UpdateAndSave(entity);
         }
+
+        entity.GameRecordRefreshTime = DateTimeOffset.UtcNow;
+        appDbContext.AvatarInfos.UpdateAndSave(entity);
     }
 
-    private void EnsureItemsAvatarIdDistinct(ref List<EntityAvatarInfo> dbInfos, string uid)
+    private void EnsureItemsAvatarIdUnique(ref List<EntityAvatarInfo> dbInfos, string uid, out Dictionary<AvatarId, EntityAvatarInfo> dbInfoMap)
     {
-        int distinctCount = dbInfos.Select(info => info.Info.AvatarId).ToHashSet().Count;
-
-        // Avatars are actually less than the list told us.
-        // This means that there are duplicate items.
-        if (distinctCount < dbInfos.Count)
+        dbInfoMap = [];
+        foreach (ref readonly EntityAvatarInfo info in CollectionsMarshal.AsSpan(dbInfos))
         {
-            avatarInfoDbService.RemoveAvatarInfoRangeByUid(uid);
-            dbInfos = [];
+            if (!dbInfoMap.TryAdd(info.Info.AvatarId, info))
+            {
+                avatarInfoDbService.RemoveAvatarInfoRangeByUid(uid);
+                dbInfoMap.Clear();
+                dbInfos.Clear();
+            }
         }
     }
 }

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/AvatarInfoDbService.cs

@@ -4,6 +4,7 @@
 using Microsoft.EntityFrameworkCore;
 using Snap.Hutao.Core.Database;
 using Snap.Hutao.Model.Entity.Database;
+using Snap.Hutao.Service.Abstraction;
 using EntityAvatarInfo = Snap.Hutao.Model.Entity.AvatarInfo;
 
 namespace Snap.Hutao.Service.AvatarInfo;
@@ -14,44 +15,25 @@ internal sealed partial class AvatarInfoDbService : IAvatarInfoDbService
 {
     private readonly IServiceProvider serviceProvider;
 
+    public IServiceProvider ServiceProvider { get => serviceProvider; }
+
     public List<EntityAvatarInfo> GetAvatarInfoListByUid(string uid)
     {
-        using (IServiceScope scope = serviceProvider.CreateScope())
-        {
-            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
-            IQueryable<EntityAvatarInfo> result = appDbContext.AvatarInfos.AsNoTracking().Where(i => i.Uid == uid);
-            return [.. result];
-        }
+        return this.List(i => i.Uid == uid);
     }
 
-    public async ValueTask<List<EntityAvatarInfo>> GetAvatarInfoListByUidAsync(string uid)
+    public ValueTask<List<EntityAvatarInfo>> GetAvatarInfoListByUidAsync(string uid, CancellationToken token = default)
     {
-        using (IServiceScope scope = serviceProvider.CreateScope())
-        {
-            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
-            return await appDbContext.AvatarInfos
-                .AsNoTracking()
-                .Where(i => i.Uid == uid)
-                .ToListAsync()
-                .ConfigureAwait(false);
-        }
+        return this.ListAsync(i => i.Uid == uid, token);
     }
 
     public void RemoveAvatarInfoRangeByUid(string uid)
     {
-        using (IServiceScope scope = serviceProvider.CreateScope())
-        {
-            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
-            appDbContext.AvatarInfos.ExecuteDeleteWhere(i => i.Uid == uid);
-        }
+        this.Execute(dbset => dbset.Where(i => i.Uid == uid).ExecuteDelete());
     }
 
-    public async ValueTask RemoveAvatarInfoRangeByUidAsync(string uid)
+    public async ValueTask RemoveAvatarInfoRangeByUidAsync(string uid, CancellationToken token = default)
     {
-        using (IServiceScope scope = serviceProvider.CreateScope())
-        {
-            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
-            await appDbContext.AvatarInfos.ExecuteDeleteWhereAsync(i => i.Uid == uid).ConfigureAwait(false);
-        }
+        await this.ExecuteAsync((dbset, token) => dbset.Where(i => i.Uid == uid).ExecuteDeleteAsync(token), token).ConfigureAwait(false);
     }
 }

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/AvatarInfoService.cs

@@ -13,9 +13,6 @@ using EntityAvatarInfo = Snap.Hutao.Model.Entity.AvatarInfo;
 
 namespace Snap.Hutao.Service.AvatarInfo;
 
-/// <summary>
-/// 角色信息服务
-/// </summary>
 [HighQuality]
 [ConstructorGenerated]
 [Injection(InjectAs.Scoped, typeof(IAvatarInfoService))]
@@ -23,77 +20,76 @@ internal sealed partial class AvatarInfoService : IAvatarInfoService
 {
     private readonly AvatarInfoDbBulkOperation avatarInfoDbBulkOperation;
     private readonly IAvatarInfoDbService avatarInfoDbService;
+    private readonly IServiceScopeFactory serviceScopeFactory;
     private readonly ILogger<AvatarInfoService> logger;
     private readonly IMetadataService metadataService;
     private readonly ISummaryFactory summaryFactory;
-    private readonly EnkaClient enkaClient;
 
-    /// <inheritdoc/>
     public async ValueTask<ValueResult<RefreshResult, Summary?>> GetSummaryAsync(UserAndUid userAndUid, RefreshOption refreshOption, CancellationToken token = default)
     {
-        if (await metadataService.InitializeAsync().ConfigureAwait(false))
-        {
-            token.ThrowIfCancellationRequested();
-
-            switch (refreshOption)
-            {
-                case RefreshOption.RequestFromEnkaAPI:
-                    {
-                        EnkaResponse? resp = await GetEnkaResponseAsync(userAndUid.Uid, token).ConfigureAwait(false);
-                        token.ThrowIfCancellationRequested();
-                        if (resp is null)
-                        {
-                            return new(RefreshResult.APIUnavailable, default);
-                        }
-
-                        if (!string.IsNullOrEmpty(resp.Message))
-                        {
-                            return new(RefreshResult.StatusCodeNotSucceed, new Summary { Message = resp.Message });
-                        }
-
-                        if (!resp.IsValid)
-                        {
-                            return new(RefreshResult.ShowcaseNotOpen, default);
-                        }
-
-                        List<EntityAvatarInfo> list = avatarInfoDbBulkOperation.UpdateDbAvatarInfosByShowcase(userAndUid.Uid.Value, resp.AvatarInfoList, token);
-                        Summary summary = await GetSummaryCoreAsync(list, token).ConfigureAwait(false);
-                        return new(RefreshResult.Ok, summary);
-                    }
-
-                case RefreshOption.RequestFromHoyolabGameRecord:
-                    {
-                        List<EntityAvatarInfo> list = await avatarInfoDbBulkOperation.UpdateDbAvatarInfosByGameRecordCharacterAsync(userAndUid, token).ConfigureAwait(false);
-                        Summary summary = await GetSummaryCoreAsync(list, token).ConfigureAwait(false);
-                        return new(RefreshResult.Ok, summary);
-                    }
-
-                case RefreshOption.RequestFromHoyolabCalculate:
-                    {
-                        List<EntityAvatarInfo> list = await avatarInfoDbBulkOperation.UpdateDbAvatarInfosByCalculateAvatarDetailAsync(userAndUid, token).ConfigureAwait(false);
-                        Summary summary = await GetSummaryCoreAsync(list, token).ConfigureAwait(false);
-                        return new(RefreshResult.Ok, summary);
-                    }
-
-                default:
-                    {
-                        List<EntityAvatarInfo> list = await avatarInfoDbService.GetAvatarInfoListByUidAsync(userAndUid.Uid.Value).ConfigureAwait(false);
-                        Summary summary = await GetSummaryCoreAsync(list, token).ConfigureAwait(false);
-                        token.ThrowIfCancellationRequested();
-                        return new(RefreshResult.Ok, summary.Avatars.Count == 0 ? null : summary);
-                    }
-            }
-        }
-        else
+        if (!await metadataService.InitializeAsync().ConfigureAwait(false))
         {
             return new(RefreshResult.MetadataNotInitialized, null);
         }
+
+        switch (refreshOption)
+        {
+            case RefreshOption.RequestFromEnkaAPI:
+                {
+                    EnkaResponse? resp = await GetEnkaResponseAsync(userAndUid.Uid, token).ConfigureAwait(false);
+
+                    if (resp is null)
+                    {
+                        return new(RefreshResult.APIUnavailable, default);
+                    }
+
+                    if (!string.IsNullOrEmpty(resp.Message))
+                    {
+                        return new(RefreshResult.StatusCodeNotSucceed, new Summary { Message = resp.Message });
+                    }
+
+                    if (!resp.IsValid)
+                    {
+                        return new(RefreshResult.ShowcaseNotOpen, default);
+                    }
+
+                    List<EntityAvatarInfo> list = await avatarInfoDbBulkOperation.UpdateDbAvatarInfosByShowcaseAsync(userAndUid.Uid.Value, resp.AvatarInfoList, token).ConfigureAwait(false);
+                    Summary summary = await GetSummaryCoreAsync(list, token).ConfigureAwait(false);
+                    return new(RefreshResult.Ok, summary);
+                }
+
+            case RefreshOption.RequestFromHoyolabGameRecord:
+                {
+                    List<EntityAvatarInfo> list = await avatarInfoDbBulkOperation.UpdateDbAvatarInfosByGameRecordCharacterAsync(userAndUid, token).ConfigureAwait(false);
+                    Summary summary = await GetSummaryCoreAsync(list, token).ConfigureAwait(false);
+                    return new(RefreshResult.Ok, summary);
+                }
+
+            case RefreshOption.RequestFromHoyolabCalculate:
+                {
+                    List<EntityAvatarInfo> list = await avatarInfoDbBulkOperation.UpdateDbAvatarInfosByCalculateAvatarDetailAsync(userAndUid, token).ConfigureAwait(false);
+                    Summary summary = await GetSummaryCoreAsync(list, token).ConfigureAwait(false);
+                    return new(RefreshResult.Ok, summary);
+                }
+
+            default:
+                {
+                    List<EntityAvatarInfo> list = await avatarInfoDbService.GetAvatarInfoListByUidAsync(userAndUid.Uid.Value, token).ConfigureAwait(false);
+                    Summary summary = await GetSummaryCoreAsync(list, token).ConfigureAwait(false);
+                    return new(RefreshResult.Ok, summary.Avatars.Count == 0 ? null : summary);
+                }
+        }
     }
 
     private async ValueTask<EnkaResponse?> GetEnkaResponseAsync(PlayerUid uid, CancellationToken token = default)
     {
-        return await enkaClient.GetForwardDataAsync(uid, token).ConfigureAwait(false)
-            ?? await enkaClient.GetDataAsync(uid, token).ConfigureAwait(false);
+        using (IServiceScope scope = serviceScopeFactory.CreateScope())
+        {
+            EnkaClient enkaClient = scope.ServiceProvider.GetRequiredService<EnkaClient>();
+
+            return await enkaClient.GetForwardDataAsync(uid, token).ConfigureAwait(false)
+                ?? await enkaClient.GetDataAsync(uid, token).ConfigureAwait(false);
+        }
     }
 
     private async ValueTask<Summary> GetSummaryCoreAsync(IEnumerable<EntityAvatarInfo> avatarInfos, CancellationToken token)

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/Builder/AvatarViewBuilder.cs

@@ -0,0 +1,13 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.ViewModel.AvatarProperty;
+
+namespace Snap.Hutao.Service.AvatarInfo.Factory.Builder;
+
+internal sealed class AvatarViewBuilder : IAvatarViewBuilder
+{
+    public AvatarView View { get; } = new();
+
+    public float Score { get => View.Score; set => View.Score = value; }
+}

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/Builder/AvatarViewBuilderExtension.cs

@@ -0,0 +1,242 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.Core.Abstraction.Extension;
+using Snap.Hutao.Model.Intrinsic;
+using Snap.Hutao.Model.Metadata.Avatar;
+using Snap.Hutao.Model.Metadata.Converter;
+using Snap.Hutao.Model.Primitive;
+using Snap.Hutao.ViewModel.AvatarProperty;
+
+namespace Snap.Hutao.Service.AvatarInfo.Factory.Builder;
+
+internal static class AvatarViewBuilderExtension
+{
+    public static TBuilder SetCostumeIconOrDefault<TBuilder>(this TBuilder builder, Web.Enka.Model.AvatarInfo avatarInfo, Avatar avatar)
+        where TBuilder : IAvatarViewBuilder
+    {
+        if (avatarInfo.CostumeId.TryGetValue(out CostumeId id))
+        {
+            Costume costume = avatar.Costumes.Single(c => c.Id == id);
+
+            // Set to costume icon
+            builder.View.Icon = AvatarIconConverter.IconNameToUri(costume.FrontIcon);
+            builder.View.SideIcon = AvatarIconConverter.IconNameToUri(costume.SideIcon);
+        }
+        else
+        {
+            builder.View.Icon = AvatarIconConverter.IconNameToUri(avatar.Icon);
+            builder.View.SideIcon = AvatarIconConverter.IconNameToUri(avatar.SideIcon);
+        }
+
+        return builder;
+    }
+
+    public static TBuilder SetCalculatorRefreshTimeFormat<TBuilder>(this TBuilder builder, DateTimeOffset refreshTime, Func<object?, string> format, string defaultValue)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.SetCalculatorRefreshTimeFormat(refreshTime == DateTimeOffsetExtension.DatebaseDefaultTime ? defaultValue : format(refreshTime.ToLocalTime()));
+    }
+
+    public static TBuilder SetCalculatorRefreshTimeFormat<TBuilder>(this TBuilder builder, string calculatorRefreshTimeFormat)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.Configure(b => b.View.CalculatorRefreshTimeFormat = calculatorRefreshTimeFormat);
+    }
+
+    public static TBuilder SetConstellations<TBuilder>(this TBuilder builder, List<Skill> talents, List<SkillId>? talentIds)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.SetConstellations(CreateConstellations(talents, talentIds.EmptyIfNull()));
+
+        static List<ConstellationView> CreateConstellations(List<Skill> talents, List<SkillId> talentIds)
+        {
+            // TODO: use builder here
+            return talents.SelectList(talent => new ViewModel.AvatarProperty.ConstellationView()
+            {
+                Name = talent.Name,
+                Icon = SkillIconConverter.IconNameToUri(talent.Icon),
+                Description = talent.Description,
+                IsActivated = talentIds.Contains(talent.Id),
+            });
+        }
+    }
+
+    public static TBuilder SetConstellations<TBuilder>(this TBuilder builder, List<ConstellationView> constellations)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.Configure(b => b.View.Constellations = constellations);
+    }
+
+    public static TBuilder SetCritScore<TBuilder>(this TBuilder builder, Dictionary<FightProperty, float>? fightPropMap)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.SetCritScore(ScoreCrit(fightPropMap));
+
+        static float ScoreCrit(Dictionary<FightProperty, float>? fightPropMap)
+        {
+            if (fightPropMap.IsNullOrEmpty())
+            {
+                return 0F;
+            }
+
+            float cr = fightPropMap[FightProperty.FIGHT_PROP_CRITICAL];
+            float cd = fightPropMap[FightProperty.FIGHT_PROP_CRITICAL_HURT];
+
+            return 100 * ((cr * 2) + cd);
+        }
+    }
+
+    public static TBuilder SetCritScore<TBuilder>(this TBuilder builder, float critScore)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.Configure(b => b.View.CritScore = critScore);
+    }
+
+    public static TBuilder SetElement<TBuilder>(this TBuilder builder, ElementType element)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.Configure(b => b.View.Element = element);
+    }
+
+    public static TBuilder SetFetterLevel<TBuilder>(this TBuilder builder, FetterLevel? level)
+        where TBuilder : IAvatarViewBuilder
+    {
+        if (level.TryGetValue(out FetterLevel value))
+        {
+            return builder.Configure(b => b.View.FetterLevel = value);
+        }
+
+        return builder;
+    }
+
+    public static TBuilder SetFetterLevel<TBuilder>(this TBuilder builder, uint level)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.Configure(b => b.View.FetterLevel = level);
+    }
+
+    public static TBuilder SetGameRecordRefreshTimeFormat<TBuilder>(this TBuilder builder, DateTimeOffset refreshTime, Func<object?, string> format, string defaultValue)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.SetGameRecordRefreshTimeFormat(refreshTime == DateTimeOffsetExtension.DatebaseDefaultTime ? defaultValue : format(refreshTime.ToLocalTime()));
+    }
+
+    public static TBuilder SetGameRecordRefreshTimeFormat<TBuilder>(this TBuilder builder, string gameRecordRefreshTimeFormat)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.Configure(b => b.View.GameRecordRefreshTimeFormat = gameRecordRefreshTimeFormat);
+    }
+
+    public static TBuilder SetId<TBuilder>(this TBuilder builder, AvatarId id)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.Configure(b => b.View.Id = id);
+    }
+
+    public static TBuilder SetLevelNumber<TBuilder>(this TBuilder builder, uint? levelNumber)
+        where TBuilder : IAvatarViewBuilder
+    {
+        if (levelNumber.TryGetValue(out uint value))
+        {
+            return builder.Configure(b => b.View.LevelNumber = value);
+        }
+
+        return builder;
+    }
+
+    public static TBuilder SetName<TBuilder>(this TBuilder builder, string name)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.Configure(b => b.View.Name = name);
+    }
+
+    public static TBuilder SetNameCard<TBuilder>(this TBuilder builder, Uri nameCard)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.Configure(b => b.View.NameCard = nameCard);
+    }
+
+    public static TBuilder SetProperties<TBuilder>(this TBuilder builder, List<AvatarProperty> properties)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.Configure(b => b.View.Properties = properties);
+    }
+
+    public static TBuilder SetQuality<TBuilder>(this TBuilder builder, QualityType quality)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.Configure(b => b.View.Quality = quality);
+    }
+
+    public static TBuilder SetReliquaries<TBuilder>(this TBuilder builder, List<ReliquaryView> reliquaries)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.Configure(b => b.View.Reliquaries = reliquaries);
+    }
+
+    public static TBuilder SetShowcaseRefreshTimeFormat<TBuilder>(this TBuilder builder, DateTimeOffset refreshTime, Func<object?, string> format, string defaultValue)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.SetShowcaseRefreshTimeFormat(refreshTime == DateTimeOffsetExtension.DatebaseDefaultTime ? defaultValue : format(refreshTime.ToLocalTime()));
+    }
+
+    public static TBuilder SetShowcaseRefreshTimeFormat<TBuilder>(this TBuilder builder, string showcaseRefreshTimeFormat)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.Configure(b => b.View.ShowcaseRefreshTimeFormat = showcaseRefreshTimeFormat);
+    }
+
+    public static TBuilder SetSkills<TBuilder>(this TBuilder builder, Dictionary<SkillId, SkillLevel>? skillLevelMap, Dictionary<SkillGroupId, SkillLevel>? proudSkillExtraLevelMap, List<ProudableSkill> proudSkills)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.SetSkills(CreateSkills(skillLevelMap, proudSkillExtraLevelMap, proudSkills));
+
+        static List<SkillView> CreateSkills(Dictionary<SkillId, SkillLevel>? skillLevelMap, Dictionary<SkillGroupId, SkillLevel>? proudSkillExtraLevelMap, List<ProudableSkill> proudSkills)
+        {
+            if (skillLevelMap.IsNullOrEmpty())
+            {
+                return [];
+            }
+
+            Dictionary<SkillId, SkillLevel> skillExtraLeveledMap = new(skillLevelMap);
+
+            if (proudSkillExtraLevelMap is not null)
+            {
+                foreach ((SkillGroupId groupId, SkillLevel extraLevel) in proudSkillExtraLevelMap)
+                {
+                    skillExtraLeveledMap.IncreaseValue(proudSkills.Single(p => p.GroupId == groupId).Id, extraLevel);
+                }
+            }
+
+            return proudSkills.SelectList(proudableSkill =>
+            {
+                SkillId skillId = proudableSkill.Id;
+
+                // TODO: use builder here
+                return new SkillView()
+                {
+                    Name = proudableSkill.Name,
+                    Icon = SkillIconConverter.IconNameToUri(proudableSkill.Icon),
+                    Description = proudableSkill.Description,
+
+                    GroupId = proudableSkill.GroupId,
+                    LevelNumber = skillLevelMap[skillId],
+                    Info = DescriptionsParametersDescriptor.Convert(proudableSkill.Proud, skillExtraLeveledMap[skillId]),
+                };
+            });
+        }
+    }
+
+    public static TBuilder SetSkills<TBuilder>(this TBuilder builder, List<SkillView> skills)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.Configure(b => b.View.Skills = skills);
+    }
+
+    public static TBuilder SetWeapon<TBuilder>(this TBuilder builder, WeaponView? weapon)
+        where TBuilder : IAvatarViewBuilder
+    {
+        return builder.Configure(b => b.View.Weapon = weapon);
+    }
+}

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/Builder/EquipViewBuilderExtension.cs

@@ -0,0 +1,33 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.Core.Abstraction.Extension;
+using Snap.Hutao.Model;
+using Snap.Hutao.Model.Intrinsic;
+using Snap.Hutao.ViewModel.AvatarProperty;
+
+namespace Snap.Hutao.Service.AvatarInfo.Factory.Builder;
+
+internal static class EquipViewBuilderExtension
+{
+    public static TBuilder SetLevel<TBuilder, T>(this TBuilder builder, string level)
+        where TBuilder : IEquipViewBuilder<T>
+        where T : EquipView
+    {
+        return builder.Configure(b => b.View.Level = level);
+    }
+
+    public static TBuilder SetQuality<TBuilder, T>(this TBuilder builder, QualityType quality)
+        where TBuilder : IEquipViewBuilder<T>
+        where T : EquipView
+    {
+        return builder.Configure(b => b.View.Quality = quality);
+    }
+
+    public static TBuilder SetMainProperty<TBuilder, T>(this TBuilder builder, NameValue<string> mainProperty)
+        where TBuilder : IEquipViewBuilder<T>
+        where T : EquipView
+    {
+        return builder.Configure(b => b.View.MainProperty = mainProperty);
+    }
+}

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/Builder/IAvatarViewBuilder.cs

@@ -0,0 +1,12 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.Core.Abstraction;
+using Snap.Hutao.ViewModel.AvatarProperty;
+
+namespace Snap.Hutao.Service.AvatarInfo.Factory.Builder;
+
+internal interface IAvatarViewBuilder : IBuilder, IScoreAccess
+{
+    AvatarView View { get; }
+}

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/Builder/IEquipViewBuilder.cs

@@ -0,0 +1,11 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.ViewModel.AvatarProperty;
+
+namespace Snap.Hutao.Service.AvatarInfo.Factory.Builder;
+
+internal interface IEquipViewBuilder<T> : INameIconDescriptionBuilder<T>
+    where T : EquipView
+{
+}

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/Builder/INameIconDescriptionBuilder.cs

@@ -0,0 +1,13 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.Core.Abstraction;
+using Snap.Hutao.ViewModel.AvatarProperty;
+
+namespace Snap.Hutao.Service.AvatarInfo.Factory.Builder;
+
+internal interface INameIconDescriptionBuilder<T> : IBuilder
+    where T : NameIconDescription
+{
+    T View { get; }
+}

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/Builder/IReliquaryViewBuilder.cs

@@ -0,0 +1,10 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.ViewModel.AvatarProperty;
+
+namespace Snap.Hutao.Service.AvatarInfo.Factory.Builder;
+
+internal interface IReliquaryViewBuilder : IEquipViewBuilder<ReliquaryView>, IScoreAccess
+{
+}

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/Builder/IScoreAccess.cs

@@ -0,0 +1,9 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Service.AvatarInfo.Factory.Builder;
+
+internal interface IScoreAccess
+{
+    float Score { get; set; }
+}

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/Builder/IWeaponViewBuilder.cs

@@ -0,0 +1,10 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.ViewModel.AvatarProperty;
+
+namespace Snap.Hutao.Service.AvatarInfo.Factory.Builder;
+
+internal interface IWeaponViewBuilder : IEquipViewBuilder<WeaponView>
+{
+}

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/Builder/NameIconDescriptionBuilderExtension.cs

@@ -0,0 +1,33 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.Core.Abstraction.Extension;
+using Snap.Hutao.Model;
+using Snap.Hutao.Model.Intrinsic;
+using Snap.Hutao.ViewModel.AvatarProperty;
+
+namespace Snap.Hutao.Service.AvatarInfo.Factory.Builder;
+
+internal static class NameIconDescriptionBuilderExtension
+{
+    public static TBuilder SetDescription<TBuilder, T>(this TBuilder builder, string description)
+        where TBuilder : INameIconDescriptionBuilder<T>
+        where T : NameIconDescription
+    {
+        return builder.Configure(b => b.View.Description = description);
+    }
+
+    public static TBuilder SetIcon<TBuilder, T>(this TBuilder builder, Uri icon)
+        where TBuilder : INameIconDescriptionBuilder<T>
+        where T : NameIconDescription
+    {
+        return builder.Configure(b => b.View.Icon = icon);
+    }
+
+    public static TBuilder SetName<TBuilder, T>(this TBuilder builder, string name)
+        where TBuilder : INameIconDescriptionBuilder<T>
+        where T : NameIconDescription
+    {
+        return builder.Configure(b => b.View.Name = name);
+    }
+}

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/Builder/ReliquaryViewBuilder.cs

@@ -0,0 +1,13 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.ViewModel.AvatarProperty;
+
+namespace Snap.Hutao.Service.AvatarInfo.Factory.Builder;
+
+internal sealed class ReliquaryViewBuilder : IReliquaryViewBuilder
+{
+    public ReliquaryView View { get; } = new();
+
+    public float Score { get => View.Score; set => View.Score = value; }
+}

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/Builder/ReliquaryViewBuilderExtension.cs

@@ -0,0 +1,66 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.Core.Abstraction.Extension;
+using Snap.Hutao.Model;
+using Snap.Hutao.Model.Intrinsic;
+using Snap.Hutao.ViewModel.AvatarProperty;
+
+namespace Snap.Hutao.Service.AvatarInfo.Factory.Builder;
+
+internal static class ReliquaryViewBuilderExtension
+{
+    public static TBuilder SetComposedSubProperties<TBuilder>(this TBuilder builder, List<ReliquaryComposedSubProperty> composedSubProperties)
+        where TBuilder : IReliquaryViewBuilder
+    {
+        return builder.Configure(b => b.View.ComposedSubProperties = composedSubProperties);
+    }
+
+    public static TBuilder SetDescription<TBuilder>(this TBuilder builder, string description)
+        where TBuilder : IReliquaryViewBuilder
+    {
+        return builder.SetDescription<TBuilder, ReliquaryView>(description);
+    }
+
+    public static TBuilder SetIcon<TBuilder>(this TBuilder builder, Uri icon)
+        where TBuilder : IReliquaryViewBuilder
+    {
+        return builder.SetIcon<TBuilder, ReliquaryView>(icon);
+    }
+
+    public static TBuilder SetLevel<TBuilder>(this TBuilder builder, string level)
+        where TBuilder : IReliquaryViewBuilder
+    {
+        return builder.SetLevel<TBuilder, ReliquaryView>(level);
+    }
+
+    public static TBuilder SetMainProperty<TBuilder>(this TBuilder builder, NameValue<string> mainProperty)
+        where TBuilder : IReliquaryViewBuilder
+    {
+        return builder.SetMainProperty<TBuilder, ReliquaryView>(mainProperty);
+    }
+
+    public static TBuilder SetName<TBuilder>(this TBuilder builder, string name)
+        where TBuilder : IReliquaryViewBuilder
+    {
+        return builder.SetName<TBuilder, ReliquaryView>(name);
+    }
+
+    public static TBuilder SetPrimarySubProperties<TBuilder>(this TBuilder builder, List<ReliquarySubProperty> primarySubProperties)
+        where TBuilder : IReliquaryViewBuilder
+    {
+        return builder.Configure(b => b.View.PrimarySubProperties = primarySubProperties);
+    }
+
+    public static TBuilder SetQuality<TBuilder>(this TBuilder builder, QualityType quality)
+        where TBuilder : IReliquaryViewBuilder
+    {
+        return builder.SetQuality<TBuilder, ReliquaryView>(quality);
+    }
+
+    public static TBuilder SetSecondarySubProperties<TBuilder>(this TBuilder builder, List<ReliquarySubProperty> secondarySubProperties)
+        where TBuilder : IReliquaryViewBuilder
+    {
+        return builder.Configure(b => b.View.SecondarySubProperties = secondarySubProperties);
+    }
+}

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/Builder/ScoreAccessExtension.cs

@@ -0,0 +1,16 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.Core.Abstraction;
+using Snap.Hutao.Core.Abstraction.Extension;
+
+namespace Snap.Hutao.Service.AvatarInfo.Factory.Builder;
+
+internal static class ScoreAccessExtension
+{
+    public static TBuilder SetScore<TBuilder>(this TBuilder builder, float score)
+        where TBuilder : IBuilder, IScoreAccess
+    {
+        return builder.Configure(b => b.Score = score);
+    }
+}

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/Builder/WeaponViewBuilder.cs

@@ -0,0 +1,11 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.ViewModel.AvatarProperty;
+
+namespace Snap.Hutao.Service.AvatarInfo.Factory.Builder;
+
+internal sealed class WeaponViewBuilder : IWeaponViewBuilder
+{
+    public WeaponView View { get; } = new();
+}

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/Builder/WeaponViewBuilderExtension.cs

@@ -0,0 +1,99 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.Core.Abstraction.Extension;
+using Snap.Hutao.Model;
+using Snap.Hutao.Model.Intrinsic;
+using Snap.Hutao.Model.Metadata.Converter;
+using Snap.Hutao.Model.Primitive;
+using Snap.Hutao.ViewModel.AvatarProperty;
+using Snap.Hutao.Web.Enka.Model;
+
+namespace Snap.Hutao.Service.AvatarInfo.Factory.Builder;
+
+internal static class WeaponViewBuilderExtension
+{
+    public static TBuilder SetAffixLevelNumber<TBuilder>(this TBuilder builder, uint affixLevelNumber)
+        where TBuilder : IWeaponViewBuilder
+    {
+        return builder.Configure(b => b.View.AffixLevelNumber = affixLevelNumber);
+    }
+
+    public static TBuilder SetAffixDescription<TBuilder>(this TBuilder builder, string? affixDescription)
+        where TBuilder : IWeaponViewBuilder
+    {
+        return builder.Configure(b => b.View.AffixDescription = affixDescription ?? string.Empty);
+    }
+
+    public static TBuilder SetAffixName<TBuilder>(this TBuilder builder, string? affixName)
+        where TBuilder : IWeaponViewBuilder
+    {
+        return builder.Configure(b => b.View.AffixName = affixName ?? string.Empty);
+    }
+
+    public static TBuilder SetDescription<TBuilder>(this TBuilder builder, string description)
+        where TBuilder : IWeaponViewBuilder
+    {
+        return builder.SetDescription<TBuilder, WeaponView>(description);
+    }
+
+    public static TBuilder SetIcon<TBuilder>(this TBuilder builder, Uri icon)
+        where TBuilder : IWeaponViewBuilder
+    {
+        return builder.SetIcon<TBuilder, WeaponView>(icon);
+    }
+
+    public static TBuilder SetId<TBuilder>(this TBuilder builder, WeaponId id)
+        where TBuilder : IWeaponViewBuilder
+    {
+        return builder.Configure(b => b.View.Id = id);
+    }
+
+    public static TBuilder SetLevel<TBuilder>(this TBuilder builder, string level)
+        where TBuilder : IWeaponViewBuilder
+    {
+        return builder.SetLevel<TBuilder, WeaponView>(level);
+    }
+
+    public static TBuilder SetLevelNumber<TBuilder>(this TBuilder builder, uint levelNumber)
+        where TBuilder : IWeaponViewBuilder
+    {
+        return builder.Configure(b => b.View.LevelNumber = levelNumber);
+    }
+
+    public static TBuilder SetMainProperty<TBuilder>(this TBuilder builder, WeaponStat? mainStat)
+    where TBuilder : IWeaponViewBuilder
+    {
+        return builder.SetMainProperty(mainStat is not null ? FightPropertyFormat.ToNameValue(mainStat.AppendPropId, mainStat.StatValue) : NameValueDefaults.String);
+    }
+
+    public static TBuilder SetMainProperty<TBuilder>(this TBuilder builder, NameValue<string> mainProperty)
+        where TBuilder : IWeaponViewBuilder
+    {
+        return builder.SetMainProperty<TBuilder, WeaponView>(mainProperty);
+    }
+
+    public static TBuilder SetName<TBuilder>(this TBuilder builder, string name)
+        where TBuilder : IWeaponViewBuilder
+    {
+        return builder.SetName<TBuilder, WeaponView>(name);
+    }
+
+    public static TBuilder SetQuality<TBuilder>(this TBuilder builder, QualityType quality)
+        where TBuilder : IWeaponViewBuilder
+    {
+        return builder.SetQuality<TBuilder, WeaponView>(quality);
+    }
+
+    public static TBuilder SetSubProperty<TBuilder>(this TBuilder builder, NameDescription subProperty)
+        where TBuilder : IWeaponViewBuilder
+    {
+        return builder.Configure(b => b.View.SubProperty = subProperty);
+    }
+
+    public static TBuilder SetWeaponType<TBuilder>(this TBuilder builder, WeaponType weaponType)
+        where TBuilder : IWeaponViewBuilder
+    {
+        return builder.Configure(b => b.View.WeaponType = weaponType);
+    }
+}

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/ISummaryFactory.cs

@@ -5,17 +5,8 @@ using Snap.Hutao.ViewModel.AvatarProperty;
 
 namespace Snap.Hutao.Service.AvatarInfo.Factory;
 
-/// <summary>
-/// 简述工厂
-/// </summary>
 [HighQuality]
 internal interface ISummaryFactory
 {
-    /// <summary>
-    /// 异步创建简述对象
-    /// </summary>
-    /// <param name="avatarInfos">角色列表</param>
-    /// <param name="token">取消令牌</param>
-    /// <returns>简述对象</returns>
     ValueTask<Summary> CreateAsync(IEnumerable<Model.Entity.AvatarInfo> avatarInfos, CancellationToken token);
 }

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/SummaryAvatarFactory.cs

@@ -5,21 +5,17 @@ using Snap.Hutao.Model;
 using Snap.Hutao.Model.Intrinsic;
 using Snap.Hutao.Model.Intrinsic.Format;
 using Snap.Hutao.Model.Metadata.Converter;
-using Snap.Hutao.Model.Primitive;
+using Snap.Hutao.Service.AvatarInfo.Factory.Builder;
+using Snap.Hutao.ViewModel.AvatarProperty;
 using Snap.Hutao.Web.Enka.Model;
+using System.Runtime.InteropServices;
 using EntityAvatarInfo = Snap.Hutao.Model.Entity.AvatarInfo;
 using MetadataAvatar = Snap.Hutao.Model.Metadata.Avatar.Avatar;
 using MetadataWeapon = Snap.Hutao.Model.Metadata.Weapon.Weapon;
 using ModelAvatarInfo = Snap.Hutao.Web.Enka.Model.AvatarInfo;
-using PropertyAvatar = Snap.Hutao.ViewModel.AvatarProperty.AvatarView;
-using PropertyReliquary = Snap.Hutao.ViewModel.AvatarProperty.ReliquaryView;
-using PropertyWeapon = Snap.Hutao.ViewModel.AvatarProperty.WeaponView;
 
 namespace Snap.Hutao.Service.AvatarInfo.Factory;
 
-/// <summary>
-/// 单个角色工厂
-/// </summary>
 [HighQuality]
 internal sealed class SummaryAvatarFactory
 {
@@ -27,16 +23,11 @@ internal sealed class SummaryAvatarFactory
     private readonly DateTimeOffset showcaseRefreshTime;
     private readonly DateTimeOffset gameRecordRefreshTime;
     private readonly DateTimeOffset calculatorRefreshTime;
-    private readonly SummaryMetadataContext metadataContext;
+    private readonly SummaryFactoryMetadataContext context;
 
-    /// <summary>
-    /// 构造一个新的角色工厂
-    /// </summary>
-    /// <param name="metadataContext">元数据上下文</param>
-    /// <param name="avatarInfo">角色信息</param>
-    public SummaryAvatarFactory(SummaryMetadataContext metadataContext, EntityAvatarInfo avatarInfo)
+    public SummaryAvatarFactory(SummaryFactoryMetadataContext context, EntityAvatarInfo avatarInfo)
     {
-        this.metadataContext = metadataContext;
+        this.context = context;
         this.avatarInfo = avatarInfo.Info;
 
         showcaseRefreshTime = avatarInfo.ShowcaseRefreshTime;
@@ -44,84 +35,51 @@ internal sealed class SummaryAvatarFactory
         calculatorRefreshTime = avatarInfo.CalculatorRefreshTime;
     }
 
-    /// <summary>
-    /// 创建角色
-    /// </summary>
-    /// <returns>角色</returns>
-    public PropertyAvatar Create()
+    public static AvatarView Create(SummaryFactoryMetadataContext context, EntityAvatarInfo avatarInfo)
     {
-        ReliquaryAndWeapon reliquaryAndWeapon = ProcessEquip(avatarInfo.EquipList.EmptyIfNull());
-        MetadataAvatar avatar = metadataContext.IdAvatarMap[avatarInfo.AvatarId];
-
-        PropertyAvatar propertyAvatar = new()
-        {
-            // metadata part
-            Id = avatar.Id,
-            Name = avatar.Name,
-            Quality = avatar.Quality,
-            NameCard = AvatarNameCardPicConverter.AvatarToUri(avatar),
-            Element = ElementNameIconConverter.ElementNameToElementType(avatar.FetterInfo.VisionBefore),
-
-            // webinfo & metadata mixed part
-            Constellations = SummaryHelper.CreateConstellations(avatar.SkillDepot.Talents, avatarInfo.TalentIdList),
-            Skills = SummaryHelper.CreateSkills(avatarInfo.SkillLevelMap, avatarInfo.ProudSkillExtraLevelMap, avatar.SkillDepot.CompositeSkillsNoInherents()),
-
-            // webinfo part
-            FetterLevel = avatarInfo.FetterInfo?.ExpLevel ?? 0U,
-            Properties = SummaryAvatarProperties.Create(avatarInfo.FightPropMap),
-            CritScore = $"{SummaryHelper.ScoreCrit(avatarInfo.FightPropMap):F2}",
-            LevelNumber = avatarInfo.PropMap?[PlayerProperty.PROP_LEVEL].Value ?? 0U,
-
-            // processed webinfo part
-            Weapon = reliquaryAndWeapon.Weapon,
-            Reliquaries = reliquaryAndWeapon.Reliquaries,
-            Score = $"{reliquaryAndWeapon.Reliquaries.Sum(r => r.Score):F2}",
-
-            // times
-            ShowcaseRefreshTimeFormat = showcaseRefreshTime == DateTimeOffsetExtension.DatebaseDefaultTime
-                ? SH.ServiceAvatarInfoSummaryShowcaseNotRefreshed
-                : SH.FormatServiceAvatarInfoSummaryShowcaseRefreshTimeFormat(showcaseRefreshTime.ToLocalTime()),
-            GameRecordRefreshTimeFormat = gameRecordRefreshTime == DateTimeOffsetExtension.DatebaseDefaultTime
-                ? SH.ServiceAvatarInfoSummaryGameRecordNotRefreshed
-                : SH.FormatServiceAvatarInfoSummaryGameRecordRefreshTimeFormat(gameRecordRefreshTime.ToLocalTime()),
-            CalculatorRefreshTimeFormat = calculatorRefreshTime == DateTimeOffsetExtension.DatebaseDefaultTime
-                ? SH.ServiceAvatarInfoSummaryCalculatorNotRefreshed
-                : SH.FormatServiceAvatarInfoSummaryCalculatorRefreshTimeFormat(calculatorRefreshTime.ToLocalTime()),
-        };
-
-        ApplyCostumeIconOrDefault(ref propertyAvatar, avatar);
-        return propertyAvatar;
+        return new SummaryAvatarFactory(context, avatarInfo).Create();
     }
 
-    private void ApplyCostumeIconOrDefault(ref PropertyAvatar propertyAvatar, MetadataAvatar avatar)
+    public AvatarView Create()
     {
-        if (avatarInfo.CostumeId.TryGetValue(out CostumeId id))
-        {
-            Model.Metadata.Avatar.Costume costume = avatar.Costumes.Single(c => c.Id == id);
+        ReliquaryAndWeapon reliquaryAndWeapon = ProcessEquip(avatarInfo.EquipList.EmptyIfNull());
+        MetadataAvatar avatar = context.IdAvatarMap[avatarInfo.AvatarId];
 
-            // Set to costume icon
-            propertyAvatar.Icon = AvatarIconConverter.IconNameToUri(costume.FrontIcon);
-            propertyAvatar.SideIcon = AvatarIconConverter.IconNameToUri(costume.SideIcon);
-        }
-        else
-        {
-            propertyAvatar.Icon = AvatarIconConverter.IconNameToUri(avatar.Icon);
-            propertyAvatar.SideIcon = AvatarIconConverter.IconNameToUri(avatar.SideIcon);
-        }
+        AvatarView propertyAvatar = new AvatarViewBuilder()
+            .SetId(avatar.Id)
+            .SetName(avatar.Name)
+            .SetQuality(avatar.Quality)
+            .SetNameCard(AvatarNameCardPicConverter.AvatarToUri(avatar))
+            .SetElement(ElementNameIconConverter.ElementNameToElementType(avatar.FetterInfo.VisionBefore))
+            .SetConstellations(avatar.SkillDepot.Talents, avatarInfo.TalentIdList)
+            .SetSkills(avatarInfo.SkillLevelMap, avatarInfo.ProudSkillExtraLevelMap, avatar.SkillDepot.CompositeSkillsNoInherents())
+            .SetFetterLevel(avatarInfo.FetterInfo?.ExpLevel)
+            .SetProperties(SummaryAvatarProperties.Create(avatarInfo.FightPropMap))
+            .SetCritScore(avatarInfo.FightPropMap)
+            .SetLevelNumber(avatarInfo.PropMap?[PlayerProperty.PROP_LEVEL].Value)
+            .SetWeapon(reliquaryAndWeapon.Weapon)
+            .SetReliquaries(reliquaryAndWeapon.Reliquaries)
+            .SetScore(reliquaryAndWeapon.Reliquaries.Sum(r => r.Score))
+            .SetShowcaseRefreshTimeFormat(showcaseRefreshTime, SH.FormatServiceAvatarInfoSummaryShowcaseRefreshTimeFormat, SH.ServiceAvatarInfoSummaryShowcaseNotRefreshed)
+            .SetGameRecordRefreshTimeFormat(gameRecordRefreshTime, SH.FormatServiceAvatarInfoSummaryGameRecordRefreshTimeFormat, SH.ServiceAvatarInfoSummaryGameRecordNotRefreshed)
+            .SetCalculatorRefreshTimeFormat(calculatorRefreshTime, SH.FormatServiceAvatarInfoSummaryCalculatorRefreshTimeFormat, SH.ServiceAvatarInfoSummaryCalculatorNotRefreshed)
+            .SetCostumeIconOrDefault(avatarInfo, avatar)
+            .View;
+
+        return propertyAvatar;
     }
 
     private ReliquaryAndWeapon ProcessEquip(List<Equip> equipments)
     {
-        List<PropertyReliquary> reliquaryList = [];
-        PropertyWeapon? weapon = null;
+        List<ReliquaryView> reliquaryList = [];
+        WeaponView? weapon = null;
 
-        foreach (Equip equip in equipments)
+        foreach (ref readonly Equip equip in CollectionsMarshal.AsSpan(equipments))
         {
             switch (equip.Flat.ItemType)
             {
                 case ItemType.ITEM_RELIQUARY:
-                    SummaryReliquaryFactory summaryReliquaryFactory = new(metadataContext, avatarInfo, equip);
-                    reliquaryList.Add(summaryReliquaryFactory.CreateReliquary());
+                    reliquaryList.Add(SummaryReliquaryFactory.Create(context, avatarInfo, equip));
                     break;
                 case ItemType.ITEM_WEAPON:
                     weapon = CreateWeapon(equip);
@@ -132,9 +90,9 @@ internal sealed class SummaryAvatarFactory
         return new(reliquaryList, weapon);
     }
 
-    private PropertyWeapon CreateWeapon(Equip equip)
+    private WeaponView CreateWeapon(Equip equip)
     {
-        MetadataWeapon weapon = metadataContext.IdWeaponMap[equip.ItemId];
+        MetadataWeapon weapon = context.IdWeaponMap[equip.ItemId];
 
         // AffixMap can be null when it's a white weapon.
         ArgumentNullException.ThrowIfNull(equip.Weapon);
@@ -158,34 +116,29 @@ internal sealed class SummaryAvatarFactory
 
         ArgumentNullException.ThrowIfNull(equip.Weapon);
 
-        return new()
-        {
-            // NameIconDescription
-            Name = weapon.Name,
-            Icon = EquipIconConverter.IconNameToUri(weapon.Icon),
-            Description = weapon.Description,
-
-            // EquipBase
-            Level = $"Lv.{equip.Weapon.Level.Value}",
-            Quality = weapon.Quality,
-            MainProperty = mainStat is not null ? FightPropertyFormat.ToNameValue(mainStat.AppendPropId, mainStat.StatValue) : NameValueDefaults.String,
-
-            // Weapon
-            Id = weapon.Id,
-            LevelNumber = equip.Weapon.Level,
-            SubProperty = subProperty,
-            AffixLevelNumber = affixLevel + 1,
-            AffixName = weapon.Affix?.Name ?? string.Empty,
-            AffixDescription = weapon.Affix?.Descriptions.Single(a => a.Level == affixLevel).Description ?? string.Empty,
-        };
+        return new WeaponViewBuilder()
+            .SetName(weapon.Name)
+            .SetIcon(EquipIconConverter.IconNameToUri(weapon.Icon))
+            .SetDescription(weapon.Description)
+            .SetLevel($"Lv.{equip.Weapon.Level.Value}")
+            .SetQuality(weapon.Quality)
+            .SetMainProperty(mainStat)
+            .SetId(weapon.Id)
+            .SetLevelNumber(equip.Weapon.Level)
+            .SetSubProperty(subProperty)
+            .SetAffixLevelNumber(affixLevel + 1)
+            .SetAffixName(weapon.Affix?.Name)
+            .SetAffixDescription(weapon.Affix?.Descriptions.Single(a => a.Level == affixLevel).Description)
+            .SetWeaponType(weapon.WeaponType)
+            .View;
     }
 
     private readonly struct ReliquaryAndWeapon
     {
-        public readonly List<PropertyReliquary> Reliquaries;
-        public readonly PropertyWeapon? Weapon;
+        public readonly List<ReliquaryView> Reliquaries;
+        public readonly WeaponView? Weapon;
 
-        public ReliquaryAndWeapon(List<PropertyReliquary> reliquaries, PropertyWeapon? weapon)
+        public ReliquaryAndWeapon(List<ReliquaryView> reliquaries, WeaponView? weapon)
         {
             Reliquaries = reliquaries;
             Weapon = weapon;

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/SummaryAvatarProperties.cs

@@ -13,11 +13,6 @@ namespace Snap.Hutao.Service.AvatarInfo.Factory;
 [HighQuality]
 internal static class SummaryAvatarProperties
 {
-    /// <summary>
-    /// 创建角色属性
-    /// </summary>
-    /// <param name="fightPropMap">属性映射</param>
-    /// <returns>列表</returns>
     public static List<AvatarProperty> Create(Dictionary<FightProperty, float>? fightPropMap)
     {
         if (fightPropMap is null)
@@ -25,32 +20,27 @@ internal static class SummaryAvatarProperties
             return [];
         }
 
-        AvatarProperty hpProp = ToAvatarProperty(FightProperty.FIGHT_PROP_BASE_HP, fightPropMap);
-        AvatarProperty atkProp = ToAvatarProperty(FightProperty.FIGHT_PROP_BASE_ATTACK, fightPropMap);
-        AvatarProperty defProp = ToAvatarProperty(FightProperty.FIGHT_PROP_BASE_DEFENSE, fightPropMap);
-        AvatarProperty emProp = FightPropertyFormat.ToAvatarProperty(FightProperty.FIGHT_PROP_ELEMENT_MASTERY, fightPropMap);
-        AvatarProperty critRateProp = FightPropertyFormat.ToAvatarProperty(FightProperty.FIGHT_PROP_CRITICAL, fightPropMap);
-        AvatarProperty critDMGProp = FightPropertyFormat.ToAvatarProperty(FightProperty.FIGHT_PROP_CRITICAL_HURT, fightPropMap);
-        AvatarProperty chargeEffProp = FightPropertyFormat.ToAvatarProperty(FightProperty.FIGHT_PROP_CHARGE_EFFICIENCY, fightPropMap);
-
-        List<AvatarProperty> properties = new(9) { hpProp, atkProp, defProp, emProp, critRateProp, critDMGProp, chargeEffProp };
+        List<AvatarProperty> properties =
+        [
+            ToAvatarProperty(FightProperty.FIGHT_PROP_BASE_HP, fightPropMap),
+            ToAvatarProperty(FightProperty.FIGHT_PROP_BASE_ATTACK, fightPropMap),
+            ToAvatarProperty(FightProperty.FIGHT_PROP_BASE_DEFENSE, fightPropMap),
+            FightPropertyFormat.ToAvatarProperty(FightProperty.FIGHT_PROP_ELEMENT_MASTERY, fightPropMap),
+            FightPropertyFormat.ToAvatarProperty(FightProperty.FIGHT_PROP_CRITICAL, fightPropMap),
+            FightPropertyFormat.ToAvatarProperty(FightProperty.FIGHT_PROP_CRITICAL_HURT, fightPropMap),
+            FightPropertyFormat.ToAvatarProperty(FightProperty.FIGHT_PROP_CHARGE_EFFICIENCY, fightPropMap)
+        ];
 
         // 元素伤害
-        if (TryGetBonusFightProperty(fightPropMap, out FightProperty bonusProperty, out float value))
+        if (TryGetBonusFightProperty(fightPropMap, out FightProperty bonusProperty, out float value) && value > 0)
         {
-            if (value > 0)
-            {
-                properties.Add(FightPropertyFormat.ToAvatarProperty(bonusProperty, value));
-            }
+            properties.Add(FightPropertyFormat.ToAvatarProperty(bonusProperty, value));
         }
 
         // 物伤 可以和其他元素伤害并存，所以分别判断
-        if (fightPropMap.TryGetValue(FightProperty.FIGHT_PROP_PHYSICAL_ADD_HURT, out float addValue))
+        if (fightPropMap.TryGetValue(FightProperty.FIGHT_PROP_PHYSICAL_ADD_HURT, out float addValue) && addValue > 0)
         {
-            if (addValue > 0)
-            {
-                properties.Add(FightPropertyFormat.ToAvatarProperty(FightProperty.FIGHT_PROP_PHYSICAL_ADD_HURT, addValue));
-            }
+            properties.Add(FightPropertyFormat.ToAvatarProperty(FightProperty.FIGHT_PROP_PHYSICAL_ADD_HURT, addValue));
         }
 
         return properties;

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/SummaryFactory.cs

@@ -3,6 +3,7 @@
 
 using Snap.Hutao.Model.Metadata;
 using Snap.Hutao.Service.Metadata;
+using Snap.Hutao.Service.Metadata.ContextAbstraction;
 using Snap.Hutao.ViewModel.AvatarProperty;
 
 namespace Snap.Hutao.Service.AvatarInfo.Factory;
@@ -20,22 +21,18 @@ internal sealed partial class SummaryFactory : ISummaryFactory
     /// <inheritdoc/>
     public async ValueTask<Summary> CreateAsync(IEnumerable<Model.Entity.AvatarInfo> avatarInfos, CancellationToken token)
     {
-        SummaryMetadataContext metadataContext = new()
-        {
-            IdAvatarMap = await metadataService.GetIdToAvatarMapAsync(token).ConfigureAwait(false),
-            IdWeaponMap = await metadataService.GetIdToWeaponMapAsync(token).ConfigureAwait(false),
-            IdReliquaryAffixWeightMap = await metadataService.GetIdToReliquaryAffixWeightMapAsync(token).ConfigureAwait(false),
-            IdReliquaryMainAffixMap = await metadataService.GetIdToReliquaryMainPropertyMapAsync(token).ConfigureAwait(false),
-            IdReliquarySubAffixMap = await metadataService.GetIdToReliquarySubAffixMapAsync(token).ConfigureAwait(false),
-            ReliquaryLevels = await metadataService.GetReliquaryLevelListAsync(token).ConfigureAwait(false),
-            Reliquaries = await metadataService.GetReliquaryListAsync(token).ConfigureAwait(false),
-        };
+        SummaryFactoryMetadataContext context = await metadataService
+            .GetContextAsync<SummaryFactoryMetadataContext>(token)
+            .ConfigureAwait(false);
 
         IOrderedEnumerable<AvatarView> avatars = avatarInfos
             .Where(a => !AvatarIds.IsPlayer(a.Info.AvatarId))
-            .Select(a => new SummaryAvatarFactory(metadataContext, a).Create())
-            .OrderByDescending(a => a.LevelNumber)
-            .ThenBy(a => a.Name);
+            .Select(a => SummaryAvatarFactory.Create(context, a))
+            .OrderByDescending(a => a.Quality)
+            .ThenByDescending(a => a.LevelNumber)
+            .ThenBy(a => a.Element)
+            .ThenBy(a => a.Weapon?.WeaponType)
+            .ThenByDescending(a => a.FetterLevel);
 
         return new()
         {

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/SummaryFactoryMetadataContext.cs

@@ -4,51 +4,34 @@
 using Snap.Hutao.Model.Intrinsic;
 using Snap.Hutao.Model.Metadata.Reliquary;
 using Snap.Hutao.Model.Primitive;
+using Snap.Hutao.Service.Metadata.ContextAbstraction;
 using MetadataAvatar = Snap.Hutao.Model.Metadata.Avatar.Avatar;
 using MetadataReliquary = Snap.Hutao.Model.Metadata.Reliquary.Reliquary;
 using MetadataWeapon = Snap.Hutao.Model.Metadata.Weapon.Weapon;
 
 namespace Snap.Hutao.Service.AvatarInfo.Factory;
 
-/// <summary>
-/// 简述元数据上下文
-/// 包含了所有制造简述需要的元数据
-/// </summary>
 [HighQuality]
-internal sealed class SummaryMetadataContext
+internal sealed class SummaryFactoryMetadataContext : IMetadataContext,
+    IMetadataDictionaryIdAvatarSource,
+    IMetadataDictionaryIdWeaponSource,
+    IMetadataDictionaryIdReliquaryAffixWeightSource,
+    IMetadataDictionaryIdReliquaryMainPropertySource,
+    IMetadataDictionaryIdReliquarySubAffixSource,
+    IMetadataDictionaryIdReliquarySource,
+    IMetadataListReliquaryMainAffixLevelSource
 {
-    /// <summary>
-    /// 角色映射
-    /// </summary>
     public Dictionary<AvatarId, MetadataAvatar> IdAvatarMap { get; set; } = default!;
 
-    /// <summary>
-    /// 武器映射
-    /// </summary>
     public Dictionary<WeaponId, MetadataWeapon> IdWeaponMap { get; set; } = default!;
 
-    /// <summary>
-    /// 权重映射
-    /// </summary>
     public Dictionary<AvatarId, ReliquaryAffixWeight> IdReliquaryAffixWeightMap { get; set; } = default!;
 
-    /// <summary>
-    /// 圣遗物主属性映射
-    /// </summary>
-    public Dictionary<ReliquaryMainAffixId, FightProperty> IdReliquaryMainAffixMap { get; set; } = default!;
+    public Dictionary<ReliquaryMainAffixId, FightProperty> IdReliquaryMainPropertyMap { get; set; } = default!;
 
-    /// <summary>
-    /// 圣遗物副属性映射
-    /// </summary>
     public Dictionary<ReliquarySubAffixId, ReliquarySubAffix> IdReliquarySubAffixMap { get; set; } = default!;
 
-    /// <summary>
-    /// 圣遗物等级
-    /// </summary>
-    public List<ReliquaryMainAffixLevel> ReliquaryLevels { get; set; } = default!;
+    public List<ReliquaryMainAffixLevel> ReliquaryMainAffixLevels { get; set; } = default!;
 
-    /// <summary>
-    /// 圣遗物
-    /// </summary>
-    public List<MetadataReliquary> Reliquaries { get; set; } = default!;
+    public Dictionary<ReliquaryId, MetadataReliquary> IdReliquaryMap { get; set; } = default!;
 }

src/Snap.Hutao/Snap.Hutao/Service/AvatarInfo/Factory/SummaryHelper.cs

@@ -1,85 +1,14 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
-using Snap.Hutao.Model.Intrinsic;
-using Snap.Hutao.Model.Metadata.Avatar;
-using Snap.Hutao.Model.Metadata.Converter;
+using Snap.Hutao.Core.ExceptionService;
 using Snap.Hutao.Model.Primitive;
-using Snap.Hutao.ViewModel.AvatarProperty;
 
 namespace Snap.Hutao.Service.AvatarInfo.Factory;
 
-/// <summary>
-/// 简述帮助类
-/// </summary>
 [HighQuality]
 internal static class SummaryHelper
 {
-    /// <summary>
-    /// 创建命之座
-    /// </summary>
-    /// <param name="talents">全部命座</param>
-    /// <param name="talentIds">激活的命座列表</param>
-    /// <returns>命之座</returns>
-    public static List<ConstellationView> CreateConstellations(List<Skill> talents, List<SkillId>? talentIds)
-    {
-        talentIds ??= [];
-
-        return talents.SelectList(talent => new ConstellationView()
-        {
-            Name = talent.Name,
-            Icon = SkillIconConverter.IconNameToUri(talent.Icon),
-            Description = talent.Description,
-            IsActivated = talentIds.Contains(talent.Id),
-        });
-    }
-
-    /// <summary>
-    /// 创建技能组
-    /// </summary>
-    /// <param name="skillLevelMap">技能等级映射</param>
-    /// <param name="proudSkillExtraLevelMap">额外提升等级映射</param>
-    /// <param name="proudSkills">技能列表</param>
-    /// <returns>技能</returns>
-    public static List<SkillView> CreateSkills(Dictionary<SkillId, SkillLevel>? skillLevelMap, Dictionary<SkillGroupId, SkillLevel>? proudSkillExtraLevelMap, List<ProudableSkill> proudSkills)
-    {
-        if (skillLevelMap.IsNullOrEmpty())
-        {
-            return [];
-        }
-
-        Dictionary<SkillId, SkillLevel> skillExtraLeveledMap = new(skillLevelMap);
-
-        if (proudSkillExtraLevelMap is not null)
-        {
-            foreach ((SkillGroupId groupId, SkillLevel extraLevel) in proudSkillExtraLevelMap)
-            {
-                skillExtraLeveledMap.IncreaseValue(proudSkills.Single(p => p.GroupId == groupId).Id, extraLevel);
-            }
-        }
-
-        return proudSkills.SelectList(proudableSkill =>
-        {
-            SkillId skillId = proudableSkill.Id;
-
-            return new SkillView()
-            {
-                Name = proudableSkill.Name,
-                Icon = SkillIconConverter.IconNameToUri(proudableSkill.Icon),
-                Description = proudableSkill.Description,
-
-                GroupId = proudableSkill.GroupId,
-                LevelNumber = skillLevelMap[skillId],
-                Info = DescriptionsParametersDescriptor.Convert(proudableSkill.Proud, skillExtraLeveledMap[skillId]),
-            };
-        });
-    }
-
-    /// <summary>
-    /// 获取副属性对应的最大属性的Id
-    /// </summary>
-    /// <param name="appendId">属性Id</param>
-    /// <returns>最大属性Id</returns>
     public static ReliquarySubAffixId GetAffixMaxId(in ReliquarySubAffixId appendId)
     {
         // axxxxx -> a
@@ -91,18 +20,13 @@ internal static class SummaryHelper
             1 => 2,
             2 => 3,
             3 or 4 or 5 => 4,
-            _ => throw Must.NeverHappen(),
+            _ => throw HutaoException.Throw($"不支持的 ReliquarySubAffixId: {appendId}"),
         };
 
         // axxxxb -> axxxx -> axxxx0 -> axxxxm
         return ((appendId / 10) * 10) + max;
     }
 
-    /// <summary>
-    /// 获取百分比属性副词条分数
-    /// </summary>
-    /// <param name="appendId">id</param>
-    /// <returns>分数</returns>
     public static float GetPercentSubAffixScore(in ReliquarySubAffixId appendId)
     {
         // 圣遗物相同类型副词条强化档位一共为 4/3/2 档
@@ -129,25 +53,7 @@ internal static class SummaryHelper
             (1, 0) => 100F,
             (1, 1) => 80F,
 
-            _ => throw Must.NeverHappen($"Unexpected AppendId: {appendId.Value} Delta: {delta}"),
+            _ => throw HutaoException.Throw($"Unexpected AppendId: {appendId} Delta: {delta}"),
         };
     }
-
-    /// <summary>
-    /// 获取双爆评分
-    /// </summary>
-    /// <param name="fightPropMap">属性</param>
-    /// <returns>评分</returns>
-    public static float ScoreCrit(Dictionary<FightProperty, float>? fightPropMap)
-    {
-        if (fightPropMap.IsNullOrEmpty())
-        {
-            return 0F;
-        }
-
-        float cr = fightPropMap[FightProperty.FIGHT_PROP_CRITICAL];
-        float cd = fightPropMap[FightProperty.FIGHT_PROP_CRITICAL_HURT];
-
-        return 100 * ((cr * 2) + cd);
-    }
 }