impl #1355

Bumps the packages group in /src/Snap.Hutao with 2 updates: [MSTest.TestAdapter](https://github.com/microsoft/testfx) and [MSTest.TestFramework](https://github.com/microsoft/testfx).


Updates `MSTest.TestAdapter` from 3.2.2 to 3.3.1
- [Release notes](https://github.com/microsoft/testfx/releases)
- [Changelog](https://github.com/microsoft/testfx/blob/main/docs/Changelog.md)
- [Commits](https://github.com/microsoft/testfx/compare/v3.2.2...v3.3.1)

Updates `MSTest.TestFramework` from 3.2.2 to 3.3.1
- [Release notes](https://github.com/microsoft/testfx/releases)
- [Changelog](https://github.com/microsoft/testfx/blob/main/docs/Changelog.md)
- [Commits](https://github.com/microsoft/testfx/compare/v3.2.2...v3.3.1)

---
updated-dependencies:
- dependency-name: MSTest.TestAdapter
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: packages
- dependency-name: MSTest.TestFramework
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: packages
...

Signed-off-by: dependabot[bot] <support@github.com>

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/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/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/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/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/ExceptionService/HutaoException.cs

@@ -47,6 +47,12 @@ internal sealed class HutaoException : Exception
         throw new HutaoException(HutaoExceptionKind.GachaStatisticsInvalidItemId, message, innerException);
     }
 
+    [DoesNotReturn]
+    public static HutaoException UserdataCorrupted(string message, Exception? innerException = default)
+    {
+        throw new HutaoException(HutaoExceptionKind.UserdataCorrupted, message, innerException);
+    }
+
     [DoesNotReturn]
     public static InvalidCastException InvalidCast<TFrom, TTo>(string name, 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/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/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/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/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/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; set; }
+}

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 : IAppDbEntity,
+    IEquatable<Achievement>,
     IDbMappingForeignKeyFrom<Achievement, AchievementId>,
     IDbMappingForeignKeyFrom<Achievement, UIAFItem>
 {

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 IsNeverHeldStatisticsItemVisible = "IsNeverHeldStatisticsItemVisible";
 
     public const string GeetestCustomCompositeUrl = "GeetestCustomCompositeUrl";
 

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">

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">

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">

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">

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">

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>
@@ -1376,6 +1382,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 +1400,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 +1416,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 +1433,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 +1640,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 +1664,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 +1682,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>
@@ -2588,6 +2636,12 @@
   <data name="ViewPageSettingKeyShortcutHeader" xml:space="preserve">
     <value>快捷键</value>
   </data>
+  <data name="ViewPageSettingNeverHeldItemVisibleDescription" xml:space="preserve">
+    <value>在祈愿记录页面显示或隐藏未持有过的角色或武器</value>
+  </data>
+  <data name="ViewPageSettingNeverHeldItemVisibleHeader" xml:space="preserve">
+    <value>未持有过的角色或武器</value>
+  </data>
   <data name="ViewPageSettingOfficialSiteNavigate" xml:space="preserve">
     <value>前往官网</value>
   </data>

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">

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">

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

@@ -0,0 +1,22 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+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);
+    }
+}

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 TEntity Single<TEntity>(this IAppDbService<TEntity> service, Expression<Func<TEntity, bool>> predicate)
+        where TEntity : class
+    {
+        return service.Execute(dbset => dbset.AsNoTracking().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.ExecuteAsync((dbset, token) => dbset.AsNoTracking().SingleAsync(predicate, 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 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,11 +2,10 @@
 // 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;
 
@@ -21,148 +20,95 @@ 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.Query<AchievementArchive, ObservableCollection<AchievementArchive>>(query => query.ToObservableCollection());
     }
 
-    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.Query<EntityAchievement, List<EntityAchievement>>(query => [.. query.Where(a => a.ArchiveId == 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.QueryAsync<EntityAchievement, List<EntityAchievement>>(
+            (query, token) => query
+                .Where(a => a.ArchiveId == archiveId)
+                .ToListAsync(token),
+            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.Query<AchievementArchive, List<AchievementArchive>>(query => [.. query]);
     }
 
-    public async ValueTask<List<AchievementArchive>> GetAchievementArchiveListAsync()
+    public async 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 await this.QueryAsync<AchievementArchive, List<AchievementArchive>>(query => query.ToListAsync()).ConfigureAwait(false);
     }
 }

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/Announcement/AnnouncementService.cs

@@ -3,13 +3,14 @@
 
 using Microsoft.Extensions.Caching.Memory;
 using Snap.Hutao.Core;
-using Snap.Hutao.Service.Abstraction;
+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.Runtime.InteropServices;
 using System.Text;
 using System.Text.RegularExpressions;
+using WebAnnouncement = Snap.Hutao.Web.Hoyolab.Hk4e.Common.Announcement.Announcement;
 
 namespace Snap.Hutao.Service;
 
@@ -72,7 +73,7 @@ internal sealed partial class AnnouncementService : IAnnouncementService
         // 将公告内容联入公告列表
         foreach (ref readonly AnnouncementListWrapper listWrapper in CollectionsMarshal.AsSpan(announcementListWrappers))
         {
-            foreach (ref readonly Announcement item in CollectionsMarshal.AsSpan(listWrapper.List))
+            foreach (ref readonly WebAnnouncement item in CollectionsMarshal.AsSpan(listWrapper.List))
             {
                 contentMap.TryGetValue(item.AnnId, out string? rawContent);
                 item.Content = rawContent ?? string.Empty;
@@ -83,7 +84,7 @@ internal sealed partial class AnnouncementService : IAnnouncementService
 
         foreach (ref readonly AnnouncementListWrapper listWrapper in CollectionsMarshal.AsSpan(announcementListWrappers))
         {
-            foreach (ref readonly Announcement item in CollectionsMarshal.AsSpan(listWrapper.List))
+            foreach (ref readonly WebAnnouncement item in CollectionsMarshal.AsSpan(listWrapper.List))
             {
                 item.Subtitle = new StringBuilder(item.Subtitle)
                     .Replace("\r<br>", string.Empty)
@@ -99,12 +100,12 @@ internal sealed partial class AnnouncementService : IAnnouncementService
     private static void AdjustAnnouncementTime(List<AnnouncementListWrapper> announcementListWrappers, in TimeSpan offset)
     {
         // 活动公告
-        List<Announcement> activities = announcementListWrappers
+        List<WebAnnouncement> activities = announcementListWrappers
             .Single(wrapper => wrapper.TypeId == 1)
             .List;
 
         // 更新公告
-        Announcement versionUpdate = announcementListWrappers
+        WebAnnouncement versionUpdate = announcementListWrappers
             .Single(wrapper => wrapper.TypeId == 2)
             .List
             .Single(ann => AnnouncementRegex.VersionUpdateTitleRegex.IsMatch(ann.Title));
@@ -116,7 +117,7 @@ internal sealed partial class AnnouncementService : IAnnouncementService
 
         DateTimeOffset versionUpdateTime = UnsafeDateTimeOffset.ParseDateTime(versionMatch.Groups[1].ValueSpan, offset);
 
-        foreach (ref readonly Announcement announcement in CollectionsMarshal.AsSpan(activities))
+        foreach (ref readonly WebAnnouncement announcement in CollectionsMarshal.AsSpan(activities))
         {
             if (AnnouncementRegex.PermanentActivityAfterUpdateTimeRegex.Match(announcement.Content) is { Success: true } permanent)
             {

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/AppOptions.cs

@@ -15,6 +15,7 @@ namespace Snap.Hutao.Service;
 [Injection(InjectAs.Singleton)]
 internal sealed partial class AppOptions : DbStoreOptions
 {
+    private bool? isNeverHeldStatisticsItemVisible;
     private bool? isEmptyHistoryWishVisible;
     private BackdropType? backdropType;
     private ElementTheme? elementTheme;
@@ -28,6 +29,12 @@ internal sealed partial class AppOptions : DbStoreOptions
         set => SetOption(ref isEmptyHistoryWishVisible, SettingEntry.IsEmptyHistoryWishVisible, value);
     }
 
+    public bool IsNeverHeldStatisticsItemVisible
+    {
+        get => GetOption(ref isNeverHeldStatisticsItemVisible, SettingEntry.IsNeverHeldStatisticsItemVisible);
+        set => SetOption(ref isNeverHeldStatisticsItemVisible, SettingEntry.IsNeverHeldStatisticsItemVisible, value);
+    }
+
     public List<NameValue<BackdropType>> BackdropTypes { get; } = CollectionsNameValue.FromEnum<BackdropType>(type => type >= 0);
 
     public BackdropType BackdropType

src/Snap.Hutao/Snap.Hutao/Service/Discord/DiscordController.cs

@@ -4,6 +4,7 @@
 using Snap.Discord.GameSDK.ABI;
 using System.Runtime.CompilerServices;
 using System.Runtime.InteropServices;
+using System.Text;
 using System.Text.Unicode;
 
 namespace Snap.Hutao.Service.Discord;
@@ -158,7 +159,7 @@ internal static class DiscordController
         static unsafe void DebugWriteDiscordMessage(void* state, DiscordLogLevel logLevel, sbyte* ptr)
         {
             ReadOnlySpan<byte> utf8 = MemoryMarshal.CreateReadOnlySpanFromNullTerminated((byte*)ptr);
-            string message = System.Text.Encoding.UTF8.GetString(utf8);
+            string message = Encoding.UTF8.GetString(utf8);
             System.Diagnostics.Debug.WriteLine($"[Discord.GameSDK]:[{logLevel}]:{message}");
         }
     }
@@ -224,18 +225,18 @@ internal static class DiscordController
         }
     }
 
-    private static unsafe void SetString(sbyte* reference, int length, string source)
+    private static unsafe void SetString(sbyte* reference, int length, in ReadOnlySpan<char> source)
     {
-        Span<sbyte> sbytes = new(reference, length);
-        sbytes.Clear();
-        Utf8.FromUtf16(source.AsSpan(), MemoryMarshal.Cast<sbyte, byte>(sbytes), out _, out _);
+        Span<byte> bytes = new(reference, length);
+        bytes.Clear();
+        Utf8.FromUtf16(source, bytes, out _, out _);
     }
 
     private static unsafe void SetString(sbyte* reference, int length, in ReadOnlySpan<byte> source)
     {
-        Span<sbyte> sbytes = new(reference, length);
-        sbytes.Clear();
-        source.CopyTo(MemoryMarshal.Cast<sbyte, byte>(sbytes));
+        Span<byte> bytes = new(reference, length);
+        bytes.Clear();
+        source.CopyTo(bytes);
     }
 
     private struct DiscordAsyncAction

src/Snap.Hutao/Snap.Hutao/Service/GachaLog/Factory/GachaStatisticsFactory.cs

@@ -3,6 +3,7 @@
 
 using Snap.Hutao.Core.ExceptionService;
 using Snap.Hutao.Model.Intrinsic;
+using Snap.Hutao.Model.Metadata;
 using Snap.Hutao.Model.Metadata.Avatar;
 using Snap.Hutao.Model.Metadata.Weapon;
 using Snap.Hutao.Service.Metadata;
@@ -10,6 +11,7 @@ using Snap.Hutao.Service.Metadata.ContextAbstraction;
 using Snap.Hutao.ViewModel.GachaLog;
 using Snap.Hutao.Web.Hoyolab.Hk4e.Event.GachaInfo;
 using Snap.Hutao.Web.Hutao.GachaLog;
+using System.Collections.Frozen;
 using System.Runtime.InteropServices;
 
 namespace Snap.Hutao.Service.GachaLog.Factory;
@@ -22,6 +24,16 @@ namespace Snap.Hutao.Service.GachaLog.Factory;
 [Injection(InjectAs.Scoped, typeof(IGachaStatisticsFactory))]
 internal sealed partial class GachaStatisticsFactory : IGachaStatisticsFactory
 {
+    private static readonly FrozenSet<uint> BlueStandardWeaponIdsSet = FrozenSet.ToFrozenSet(
+    [
+        11301U, 11302U, 11306U, 12301U, 12302U, 12305U, 13303U, 14301U, 14302U, 14304U, 15301U, 15302U, 15304U
+    ]);
+
+    private static readonly FrozenSet<uint> PurpleStandardWeaponIdsSet = FrozenSet.ToFrozenSet(
+    [
+        11401U, 11402U, 11403U, 11405U, 12401U, 12402U, 12403U, 12405U, 13401U, 13407U, 14401U, 14402U, 14403U, 14409U, 15401U, 15402U, 15403U, 15405U
+    ]);
+
     private readonly IMetadataService metadataService;
     private readonly HomaGachaLogClient homaGachaLogClient;
     private readonly ITaskContext taskContext;
@@ -33,7 +45,7 @@ internal sealed partial class GachaStatisticsFactory : IGachaStatisticsFactory
         await taskContext.SwitchToBackgroundAsync();
 
         List<HistoryWishBuilder> historyWishBuilders = context.GachaEvents.SelectList(gachaEvent => new HistoryWishBuilder(gachaEvent, context));
-        return CreateCore(taskContext, homaGachaLogClient, items, historyWishBuilders, context, options.IsEmptyHistoryWishVisible);
+        return CreateCore(taskContext, homaGachaLogClient, items, historyWishBuilders, context, options.IsEmptyHistoryWishVisible, options.IsNeverHeldStatisticsItemVisible);
     }
 
     private static GachaStatistics CreateCore(
@@ -42,7 +54,8 @@ internal sealed partial class GachaStatisticsFactory : IGachaStatisticsFactory
         List<Model.Entity.GachaItem> items,
         List<HistoryWishBuilder> historyWishBuilders,
         in GachaLogServiceMetadataContext context,
-        bool isEmptyHistoryWishVisible)
+        bool isEmptyHistoryWishVisible,
+        bool isNeverHeldStatisticsItemVisible)
     {
         TypedWishSummaryBuilderContext standardContext = TypedWishSummaryBuilderContext.StandardWish(taskContext, gachaLogClient);
         TypedWishSummaryBuilder standardWishBuilder = new(standardContext);
@@ -62,6 +75,45 @@ internal sealed partial class GachaStatisticsFactory : IGachaStatisticsFactory
         Dictionary<Weapon, int> purpleWeaponCounter = [];
         Dictionary<Weapon, int> blueWeaponCounter = [];
 
+        if (isNeverHeldStatisticsItemVisible)
+        {
+            orangeAvatarCounter = context.IdAvatarMap.Values
+                .Where(avatar => avatar.Quality == QualityType.QUALITY_ORANGE)
+                .ToDictionary(avatar => avatar, _ => 0);
+            purpleAvatarCounter = context.IdAvatarMap.Values
+               .Where(avatar => avatar.Quality == QualityType.QUALITY_PURPLE)
+               .ToDictionary(avatar => avatar, _ => 0);
+            orangeWeaponCounter = context.IdWeaponMap.Values
+               .Where(weapon => weapon.Quality == QualityType.QUALITY_ORANGE)
+               .ToDictionary(weapon => weapon, _ => 0);
+
+            HashSet<Weapon> purpleWeapons = [];
+            foreach (uint weaponId in PurpleStandardWeaponIdsSet)
+            {
+                purpleWeapons.Add(context.IdWeaponMap[weaponId]);
+            }
+
+            foreach (GachaEvent gachaEvent in context.GachaEvents)
+            {
+                if (gachaEvent.Type is GachaType.ActivityWeapon)
+                {
+                    foreach (uint weaponId in gachaEvent.UpPurpleList)
+                    {
+                        purpleWeapons.Add(context.IdWeaponMap[weaponId]);
+                    }
+                }
+            }
+
+            HashSet<Weapon> blueWeapons = [];
+            foreach (uint weaponId in BlueStandardWeaponIdsSet)
+            {
+                blueWeapons.Add(context.IdWeaponMap[weaponId]);
+            }
+
+            purpleWeaponCounter = purpleWeapons.ToDictionary(weapon => weapon, _ => 0);
+            blueWeaponCounter = blueWeapons.ToDictionary(weapon => weapon, _ => 0);
+        }
+
         // Pre group builders
         Dictionary<GachaType, List<HistoryWishBuilder>> historyWishBuilderMap = historyWishBuilders
             .GroupBy(b => b.ConfigType)

src/Snap.Hutao/Snap.Hutao/Service/Game/GameFileSystem.cs

@@ -36,4 +36,6 @@ internal sealed class GameFileSystem
     public string GameConfigFilePath { get => gameConfigFilePath ??= Path.Combine(GameDirectory, GameConstants.ConfigFileName); }
 
     public string PCGameSDKFilePath { get => pcGameSDKFilePath ??= Path.Combine(GameDirectory, GameConstants.PCGameSDKFilePath); }
+
+    public string ScreenShotDirectory { get => Path.Combine(GameDirectory, "ScreenShot"); }
 }

src/Snap.Hutao/Snap.Hutao/Service/Hutao/IHutaoAsAService.cs

@@ -1,12 +1,11 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
-using Snap.Hutao.Web.Hutao.HutaoAsAService;
 using System.Collections.ObjectModel;
 
 namespace Snap.Hutao.Service.Hutao;
 
 internal interface IHutaoAsAService
 {
-    ValueTask<ObservableCollection<Announcement>> GetHutaoAnnouncementCollectionAsync(CancellationToken token = default);
+    ValueTask<ObservableCollection<Web.Hutao.HutaoAsAService.Announcement>> GetHutaoAnnouncementCollectionAsync(CancellationToken token = default);
 }

src/Snap.Hutao/Snap.Hutao/Service/Notification/InfoBarOptionsBuilderExtension.cs

@@ -47,6 +47,14 @@ internal static class InfoBarOptionsBuilderExtension
         return builder;
     }
 
+    public static IInfoBarOptionsBuilder SetActionButton<TBuilder>(this TBuilder builder, Action<ButtonBuilder> configureButton)
+        where TBuilder : IInfoBarOptionsBuilder
+    {
+        ButtonBuilder buttonBaseBuilder = new ButtonBuilder().Configure(configureButton);
+        builder.Configure(builder => builder.Options.ActionButton = buttonBaseBuilder.Button);
+        return builder;
+    }
+
     public static IInfoBarOptionsBuilder SetDelay<TBuilder>(this TBuilder builder, int milliSeconds)
         where TBuilder : IInfoBarOptionsBuilder
     {

src/Snap.Hutao/Snap.Hutao/Service/Notification/InfoBarServiceExtension.cs

@@ -2,6 +2,7 @@
 // Licensed under the MIT license.
 
 using Microsoft.UI.Xaml.Controls;
+using Snap.Hutao.Control.Builder.ButtonBase;
 using Snap.Hutao.Core.Abstraction.Extension;
 
 namespace Snap.Hutao.Service.Notification;
@@ -18,6 +19,11 @@ internal static class InfoBarServiceExtension
         infoBarService.Information(builder => builder.SetTitle(title).SetMessage(message).SetDelay(milliSeconds));
     }
 
+    public static void Information(this IInfoBarService infoBarService, string title, string message, string buttonContent, ICommand buttonCommand, int milliSeconds = 5000)
+    {
+        infoBarService.Information(builder => builder.SetTitle(title).SetMessage(message).SetActionButton(buttonBuilder => buttonBuilder.SetContent(buttonContent).SetCommand(buttonCommand)).SetDelay(milliSeconds));
+    }
+
     public static void Information(this IInfoBarService infoBarService, Action<IInfoBarOptionsBuilder> configure)
     {
         infoBarService.PrepareInfoBarAndShow(builder => builder.SetSeverity(InfoBarSeverity.Informational).Configure(configure));
@@ -48,6 +54,11 @@ internal static class InfoBarServiceExtension
         infoBarService.Warning(builder => builder.SetTitle(title).SetMessage(message).SetDelay(milliSeconds));
     }
 
+    public static void Warning(this IInfoBarService infoBarService, string title, string message, string buttonContent, ICommand buttonCommand, int milliSeconds = 30000)
+    {
+        infoBarService.Warning(builder => builder.SetTitle(title).SetMessage(message).SetActionButton(buttonBuilder => buttonBuilder.SetContent(buttonContent).SetCommand(buttonCommand)).SetDelay(milliSeconds));
+    }
+
     public static void Warning(this IInfoBarService infoBarService, Action<IInfoBarOptionsBuilder> configure)
     {
         infoBarService.PrepareInfoBarAndShow(builder => builder.SetSeverity(InfoBarSeverity.Warning).Configure(configure));
@@ -63,6 +74,11 @@ internal static class InfoBarServiceExtension
         infoBarService.Error(builder => builder.SetTitle(title).SetMessage(message).SetDelay(milliSeconds));
     }
 
+    public static void Error(this IInfoBarService infoBarService, string title, string message, string buttonContent, ICommand buttonCommand, int milliSeconds = 0)
+    {
+        infoBarService.Error(builder => builder.SetTitle(title).SetMessage(message).SetActionButton(buttonBuilder => buttonBuilder.SetContent(buttonContent).SetCommand(buttonCommand)).SetDelay(milliSeconds));
+    }
+
     public static void Error(this IInfoBarService infoBarService, Exception ex, int milliSeconds = 0)
     {
         infoBarService.Error(builder => builder.SetTitle(ex.GetType().Name).SetMessage(ex.Message).SetDelay(milliSeconds));
@@ -73,8 +89,13 @@ internal static class InfoBarServiceExtension
         infoBarService.Error(builder => builder.SetTitle(ex.GetType().Name).SetMessage($"{subtitle}\n{ex.Message}").SetDelay(milliSeconds));
     }
 
+    public static void Error(this IInfoBarService infoBarService, Exception ex, string subtitle, string buttonContent, ICommand buttonCommand, int milliSeconds = 0)
+    {
+        infoBarService.Error(builder => builder.SetTitle(ex.GetType().Name).SetMessage($"{subtitle}\n{ex.Message}").SetActionButton(buttonBuilder => buttonBuilder.SetContent(buttonContent).SetCommand(buttonCommand)).SetDelay(milliSeconds));
+    }
+
     public static void Error(this IInfoBarService infoBarService, Action<IInfoBarOptionsBuilder> configure)
     {
         infoBarService.PrepareInfoBarAndShow(builder => builder.SetSeverity(InfoBarSeverity.Error).Configure(configure));
     }
-}
+}

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

@@ -44,6 +44,8 @@
     <SelfContained>true</SelfContained>
     <WindowsAppSDKSelfContained>true</WindowsAppSDKSelfContained>
     <WindowsAppSdkUndockedRegFreeWinRTInitialize>false</WindowsAppSdkUndockedRegFreeWinRTInitialize>
+    <ServerGarbageCollection>true</ServerGarbageCollection>
+    <GarbageCollectionAdaptationMode>1</GarbageCollectionAdaptationMode>
   </PropertyGroup>
 
   <ItemGroup>
@@ -176,6 +178,7 @@
     <None Remove="View\Dialog\HutaoPassportResetPasswordDialog.xaml" />
     <None Remove="View\Dialog\HutaoPassportUnregisterDialog.xaml" />
     <None Remove="View\Dialog\LaunchGameAccountNameDialog.xaml" />
+    <None Remove="View\Dialog\LaunchGameConfigurationFixDialog.xaml" />
     <None Remove="View\Dialog\LaunchGamePackageConvertDialog.xaml" />
     <None Remove="View\Dialog\ReconfirmDialog.xaml" />
     <None Remove="View\Dialog\UserDialog.xaml" />
@@ -302,8 +305,8 @@
     <PackageReference Include="CommunityToolkit.WinUI.Controls.TokenizingTextBox" Version="8.0.240109" />
     <PackageReference Include="CommunityToolkit.WinUI.Media" Version="8.0.240109" />
     <PackageReference Include="CommunityToolkit.WinUI.Notifications" Version="7.1.2" />
-    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="8.0.3" />
-    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="8.0.3">
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="8.0.4" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="8.0.4">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
@@ -318,7 +321,7 @@
     </PackageReference>
     <PackageReference Include="Microsoft.VisualStudio.Validation" Version="17.8.8" />
     <PackageReference Include="Microsoft.Windows.SDK.BuildTools" Version="10.0.22621.3233" />
-    <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.5.240311000" />
+    <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.5.240404000" />
     <PackageReference Include="QRCoder" Version="1.4.3" />
     <PackageReference Include="Snap.Discord.GameSDK" Version="1.6.0" />
     <PackageReference Include="Snap.Hutao.Deployment.Runtime" Version="1.16.0">
@@ -347,7 +350,9 @@
     <ProjectCapability Include="Msix" />
   </ItemGroup>
   <ItemGroup>
-    <None Include="..\.editorconfig" Link=".editorconfig" />
+    <Page Update="View\Dialog\LaunchGameConfigurationFixDialog.xaml">
+      <Generator>MSBuild:Compile</Generator>
+    </Page>
   </ItemGroup>
   <ItemGroup>
     <Page Update="Control\Theme\SegmentedOverride.xaml">

src/Snap.Hutao/Snap.Hutao/View/Card/AchievementCard.xaml

@@ -52,9 +52,13 @@
                     Grid.Row="0"
                     HorizontalAlignment="Right"
                     Text="{Binding DisplayName}"/>
-                <Viewbox Grid.Row="1" StretchDirection="DownOnly">
+                <Viewbox
+                    Grid.Row="1"
+                    HorizontalAlignment="Left"
+                    StretchDirection="DownOnly">
                     <TextBlock
                         Margin="0,4,0,0"
+                        HorizontalAlignment="Left"
                         Style="{StaticResource TitleTextBlockStyle}"
                         Text="{Binding FinishDescription}"/>
                 </Viewbox>

src/Snap.Hutao/Snap.Hutao/View/Dialog/LaunchGameConfigurationFixDialog.xaml

@@ -0,0 +1,26 @@
+<ContentDialog
+    x:Class="Snap.Hutao.View.Dialog.LaunchGameConfigurationFixDialog"
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
+    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+    xmlns:shccs="using:Snap.Hutao.Control.Collection.Selector"
+    xmlns:shcm="using:Snap.Hutao.Control.Markup"
+    xmlns:shvd="using:Snap.Hutao.View.Dialog"
+    Title="{shcm:ResourceString Name=ViewDialogLaunchGameConfigurationFixDialogTitle}"
+    d:DataContext="{d:DesignInstance shvd:LaunchGameConfigurationFixDialog}"
+    CloseButtonText="{shcm:ResourceString Name=ContentDialogCancelCloseButtonText}"
+    PrimaryButtonText="{shcm:ResourceString Name=ContentDialogConfirmPrimaryButtonText}"
+    Style="{StaticResource DefaultContentDialogStyle}"
+    mc:Ignorable="d">
+
+    <shccs:ComboBox2
+        HorizontalAlignment="Stretch"
+        VerticalAlignment="Center"
+        DisplayMemberPath="DisplayName"
+        EnableMemberPath="IsNotCompatOnly"
+        Header="{shcm:ResourceString Name=ViewDialogLaunchGameConfigurationFixDialogHint}"
+        ItemsSource="{x:Bind KnownSchemes}"
+        SelectedItem="{x:Bind SelectedScheme, Mode=TwoWay}"
+        Style="{StaticResource DefaultComboBoxStyle}"/>
+</ContentDialog>

src/Snap.Hutao/Snap.Hutao/View/Dialog/LaunchGameConfigurationFixDialog.xaml.cs

@@ -0,0 +1,28 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.UI.Xaml.Controls;
+using Snap.Hutao.Service.Game.Scheme;
+
+namespace Snap.Hutao.View.Dialog;
+
+[DependencyProperty("KnownSchemes", typeof(IEnumerable<LaunchScheme>))]
+[DependencyProperty("SelectedScheme", typeof(LaunchScheme))]
+internal sealed partial class LaunchGameConfigurationFixDialog : ContentDialog
+{
+    private readonly ITaskContext taskContext;
+
+    public LaunchGameConfigurationFixDialog(IServiceProvider serviceProvider)
+    {
+        InitializeComponent();
+
+        taskContext = serviceProvider.GetRequiredService<ITaskContext>();
+    }
+
+    public async ValueTask<ValueResult<bool, LaunchScheme>> GetLaunchSchemeAsync()
+    {
+        await taskContext.SwitchToMainThreadAsync();
+        ContentDialogResult result = await ShowAsync();
+        return new(result is ContentDialogResult.Primary, SelectedScheme);
+    }
+}

src/Snap.Hutao/Snap.Hutao/View/Guide/GuideView.xaml

@@ -49,7 +49,7 @@
             <RowDefinition/>
             <RowDefinition Height="auto"/>
         </Grid.RowDefinitions>
-        <cwc:SwitchPresenter Value="{Binding State, Mode=OneWay}">
+        <cwc:SwitchPresenter ContentTransitions="{ThemeResource EntranceThemeTransitions}" Value="{Binding State, Mode=OneWay}">
             <cwc:Case Value="{shcm:UInt32 Value=0}">
                 <Grid HorizontalAlignment="Center" VerticalAlignment="Center">
                     <GridView
@@ -125,10 +125,11 @@
                     <StackPanel
                         Margin="16"
                         HorizontalAlignment="Center"
-                        VerticalAlignment="Center">
+                        VerticalAlignment="Center"
+                        Spacing="{ThemeResource SettingsCardSpacing}">
                         <TextBlock
                             Margin="1,0,0,5"
-                            Style="{StaticResource SettingsSectionHeaderTextBlockStyle}"
+                            Style="{StaticResource TitleTextBlockStyle}"
                             Text="Segoe Fluent Icons"/>
                         <StackPanel
                             Margin="0,8"
@@ -155,7 +156,10 @@
                             <Run Text="{shcm:ResourceString Name=ViewGuideStepEnvironmentFontDescription2}"/>
                         </TextBlock>
                         <TextBlock Text="{shcm:ResourceString Name=ViewGuideStepEnvironmentAfterInstallDescription}"/>
-                        <TextBlock Style="{StaticResource SettingsSectionHeaderTextBlockStyle}" Text="{shcm:ResourceString Name=ViewPageSettingWebview2Header}"/>
+                        <TextBlock
+                            Margin="1,32,0,5"
+                            Style="{StaticResource TitleTextBlockStyle}"
+                            Text="{shcm:ResourceString Name=ViewPageSettingWebview2Header}"/>
                         <TextBlock Style="{StaticResource SubtitleTextBlockStyle}" Text="{Binding RuntimeOptions.WebView2Version}"/>
                         <TextBlock>
                             <Run Text="{shcm:ResourceString Name=ViewGuideStepEnvironmentWebView2Description1}"/>
@@ -169,6 +173,78 @@
                 </Grid>
             </cwc:Case>
             <cwc:Case Value="{shcm:UInt32 Value=3}">
+                <Grid>
+                    <Grid.RowDefinitions>
+                        <RowDefinition/>
+                        <RowDefinition Height="auto"/>
+                    </Grid.RowDefinitions>
+                    <StackPanel
+                        Grid.Row="0"
+                        Margin="16"
+                        HorizontalAlignment="Center"
+                        VerticalAlignment="Center">
+                        <TextBlock Style="{StaticResource SubtitleTextBlockStyle}" Text="{shcm:ResourceString Name=ViewPageSettingHomeAnnouncementRegionHeader}"/>
+                        <ListView
+                            MinWidth="320"
+                            Margin="0,8,0,0"
+                            DisplayMemberPath="Name"
+                            ItemsSource="{Binding AppOptions.LazyRegions.Value}"
+                            SelectedItem="{Binding SelectedRegion, Mode=TwoWay}"/>
+                    </StackPanel>
+
+                    <TextBlock
+                        Grid.Row="1"
+                        Margin="16"
+                        HorizontalAlignment="Center"
+                        VerticalAlignment="Center"
+                        HorizontalTextAlignment="Center"
+                        Opacity="0.7"
+                        Style="{StaticResource CaptionTextBlockStyle}"
+                        Text="{shcm:ResourceString Name=ViewGuideStepCommonSettingHint}"/>
+                </Grid>
+            </cwc:Case>
+            <cwc:Case Value="{shcm:UInt32 Value=4}">
+                <Grid>
+                    <Grid.RowDefinitions>
+                        <RowDefinition/>
+                        <RowDefinition Height="auto"/>
+                    </Grid.RowDefinitions>
+
+                    <StackPanel
+                        Grid.Row="0"
+                        Margin="16"
+                        HorizontalAlignment="Center"
+                        VerticalAlignment="Center">
+                        <TextBlock Style="{StaticResource SubtitleTextBlockStyle}" Text="{shcm:ResourceString Name=ViewGuideStepStaticResourceSettingQualityHeader}"/>
+                        <ListView
+                            MinWidth="320"
+                            Margin="0,8,0,32"
+                            DisplayMemberPath="Name"
+                            ItemsSource="{Binding StaticResourceOptions.ImageQualities}"
+                            SelectedItem="{Binding StaticResourceOptions.ImageQuality, Mode=TwoWay}"/>
+                        <TextBlock Style="{StaticResource SubtitleTextBlockStyle}" Text="{shcm:ResourceString Name=ViewGuideStepStaticResourceSettingMinimumHeader}"/>
+                        <ListView
+                            MinWidth="320"
+                            Margin="0,8,0,32"
+                            DisplayMemberPath="Name"
+                            ItemsSource="{Binding StaticResourceOptions.ImageArchives}"
+                            SelectedItem="{Binding StaticResourceOptions.ImageArchive, Mode=TwoWay}"/>
+                        
+                        <TextBlock Margin="0,16,0,0" Text="{Binding StaticResourceOptions.SizeInformationText, Mode=OneWay}"/>
+                    </StackPanel>
+
+                    <TextBlock
+                        Grid.Row="1"
+                        Margin="16"
+                        HorizontalAlignment="Center"
+                        VerticalAlignment="Center"
+                        Foreground="{ThemeResource SystemFillColorCriticalBrush}"
+                        HorizontalTextAlignment="Center"
+                        Style="{StaticResource CaptionTextBlockStyle}"
+                        Text="{shcm:ResourceString Name=ViewGuideStepStaticResourceSettingHint}"/>
+                </Grid>
+            </cwc:Case>
+            <cwc:Case Value="{shcm:UInt32 Value=5}">
                 <StackPanel Margin="32,0" HorizontalAlignment="Left">
                     <TextBlock
                         Margin="1,16,0,5"
@@ -190,12 +266,23 @@
             <StackPanel HorizontalAlignment="Center" Orientation="Horizontal">
                 <cwc:Segmented
                     Margin="16"
+                    HorizontalAlignment="Center"
                     IsHitTestVisible="False"
                     SelectedIndex="{Binding State, Mode=TwoWay}">
+                    <!--
                     <cwc:SegmentedItem Content="{shcm:ResourceString Name=ViewGuideStepLanguage}" Icon="{shcm:FontIcon Glyph=&#xF2B7;}"/>
                     <cwc:SegmentedItem Content="{shcm:ResourceString Name=ViewGuideStepDocument}" Icon="{shcm:FontIcon Glyph=&#xF28B;}"/>
                     <cwc:SegmentedItem Content="{shcm:ResourceString Name=ViewGuideStepEnvironment}" Icon="{shcm:FontIcon Glyph=&#xE81E;}"/>
+                    <cwc:SegmentedItem Content="{shcm:ResourceString Name=ViewGuideStepCommonSetting}" Icon="{shcm:FontIcon Glyph=&#xE713;}"/>
+                    <cwc:SegmentedItem Content="{shcm:ResourceString Name=ViewGuideStepStaticResourceSetting}" Icon="{shcm:FontIcon Glyph=&#xE8BA;}"/>
                     <cwc:SegmentedItem Content="{shcm:ResourceString Name=ViewGuideStepStaticResource}" Icon="{shcm:FontIcon Glyph=&#xE8B9;}"/>
+                    -->
+                    <cwc:SegmentedItem Icon="{shcm:FontIcon Glyph=&#xF2B7;}"/>
+                    <cwc:SegmentedItem Icon="{shcm:FontIcon Glyph=&#xF28B;}"/>
+                    <cwc:SegmentedItem Icon="{shcm:FontIcon Glyph=&#xE81E;}"/>
+                    <cwc:SegmentedItem Icon="{shcm:FontIcon Glyph=&#xE713;}"/>
+                    <cwc:SegmentedItem Icon="{shcm:FontIcon Glyph=&#xE8BA;}"/>
+                    <cwc:SegmentedItem Icon="{shcm:FontIcon Glyph=&#xE8B9;}"/>
                 </cwc:Segmented>
                 <Button
                     Command="{Binding NextOrCompleteCommand}"

src/Snap.Hutao/Snap.Hutao/View/Guide/GuideView.xaml.cs

@@ -2,6 +2,7 @@
 // Licensed under the MIT license.
 
 using Microsoft.UI.Xaml.Controls;
+using Snap.Hutao.Control.Extension;
 using Snap.Hutao.ViewModel.Guide;
 
 namespace Snap.Hutao.View.Guide;
@@ -14,6 +15,6 @@ internal sealed partial class GuideView : UserControl
     public GuideView()
     {
         InitializeComponent();
-        DataContext = Ioc.Default.GetRequiredService<GuideViewModel>();
+        DataContext = this.ServiceProvider().GetRequiredService<GuideViewModel>();
     }
 }

src/Snap.Hutao/Snap.Hutao/View/Page/GachaLogPage.xaml

@@ -3,7 +3,8 @@
     xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
     xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
     xmlns:cw="using:CommunityToolkit.WinUI"
-    xmlns:cwc="using:CommunityToolkit.WinUI.Controls"
+    xmlns:cwcont="using:CommunityToolkit.WinUI.Controls"
+    xmlns:cwconv="using:CommunityToolkit.WinUI.Converters"
     xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
     xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
     xmlns:mxi="using:Microsoft.Xaml.Interactivity"
@@ -24,6 +25,11 @@
     </mxi:Interaction.Behaviors>
 
     <Page.Resources>
+        <cwconv:DoubleToObjectConverter x:Key="DoubleToOpacityConverter" GreaterThan="0">
+            <cwconv:DoubleToObjectConverter.TrueValue>1.0</cwconv:DoubleToObjectConverter.TrueValue>
+            <cwconv:DoubleToObjectConverter.FalseValue>0.4</cwconv:DoubleToObjectConverter.FalseValue>
+        </cwconv:DoubleToObjectConverter>
+
         <Flyout x:Key="HutaoCloudFlyout">
             <Grid>
                 <mxi:Interaction.Behaviors>
@@ -120,12 +126,12 @@
                             Style="{StaticResource SubtitleTextBlockStyle}"
                             Text="{shcm:ResourceString Name=ViewPageGachaLogHutaoCloudNotAllowed}"
                             TextAlignment="Center"/>
-                        <cwc:SettingsCard
+                        <cwcont:SettingsCard
                             Command="{Binding HutaoCloudViewModel.NavigateToSpiralAbyssRecordCommand}"
                             Description="{shcm:ResourceString Name=ViewPageGachaLogHutaoCloudSpiralAbyssActivityDescription}"
                             Header="{shcm:ResourceString Name=ViewPageGachaLogHutaoCloudSpiralAbyssActivityHeader}"
                             IsClickEnabled="True"/>
-                        <cwc:SettingsCard
+                        <cwcont:SettingsCard
                             Command="{Binding HutaoCloudViewModel.NavigateToAfdianSkuCommand}"
                             Description="{shcm:ResourceString Name=ViewPageGachaLogHutaoCloudAfdianPurchaseDescription}"
                             Header="{shcm:ResourceString Name=ViewPageGachaLogHutaoCloudAfdianPurchaseHeader}"
@@ -210,6 +216,7 @@
                 <shvc:ItemIcon
                     Badge="{Binding Badge}"
                     Icon="{Binding Icon}"
+                    Opacity="{Binding Count, Converter={StaticResource DoubleToOpacityConverter}}"
                     Quality="{Binding Quality}"/>
                 <Border
                     HorizontalAlignment="Right"
@@ -328,14 +335,14 @@
                                                 HorizontalAlignment="Left"
                                                 cw:Effects.Shadow="{ThemeResource CompatCardShadow}">
                                                 <Grid HorizontalAlignment="Center" Style="{StaticResource GridCardStyle}">
-                                                    <cwc:ConstrainedBox AspectRatio="1080:533">
+                                                    <cwcont:ConstrainedBox AspectRatio="1080:533">
                                                         <shci:CachedImage
                                                             HorizontalAlignment="Center"
                                                             VerticalAlignment="Center"
                                                             CornerRadius="{ThemeResource ControlCornerRadius}"
                                                             Source="{Binding SelectedHistoryWish.BannerImage}"
                                                             Stretch="UniformToFill"/>
-                                                    </cwc:ConstrainedBox>
+                                                    </cwcont:ConstrainedBox>
                                                     <Border Grid.ColumnSpan="2" Background="{ThemeResource DarkOnlyOverlayMaskColorBrush}"/>
                                                 </Grid>
                                             </Border>
@@ -507,35 +514,35 @@
                             Style="{StaticResource SubtitleTextBlockStyle}"
                             Text="{shcm:ResourceString Name=ViewPageGachaLogHint}"/>
                         <StackPanel Margin="0,24,0,0" Spacing="{StaticResource SettingsCardSpacing}">
-                            <cwc:SettingsCard
+                            <cwcont:SettingsCard
                                 ActionIconToolTip="{shcm:ResourceString Name=ViewPageGachaLogRefreshAction}"
                                 Command="{Binding RefreshBySTokenCommand}"
                                 Description="{shcm:ResourceString Name=ViewPageGachaLogRefreshBySTokenDescription}"
                                 Header="{shcm:ResourceString Name=ViewPageGachaLogRefreshBySToken}"
                                 HeaderIcon="{shcm:FontIcon Glyph=&#xE192;}"
                                 IsClickEnabled="True"/>
-                            <cwc:SettingsCard
+                            <cwcont:SettingsCard
                                 ActionIconToolTip="{shcm:ResourceString Name=ViewPageGachaLogRefreshAction}"
                                 Command="{Binding RefreshByWebCacheCommand}"
                                 Description="{shcm:ResourceString Name=ViewPageGachaLogRefreshByWebCacheDescription}"
                                 Header="{shcm:ResourceString Name=ViewPageGachaLogRefreshByWebCache}"
                                 HeaderIcon="{shcm:FontIcon Glyph=&#xE81E;}"
                                 IsClickEnabled="True"/>
-                            <cwc:SettingsCard
+                            <cwcont:SettingsCard
                                 ActionIconToolTip="{shcm:ResourceString Name=ViewPageGachaLogInputAction}"
                                 Command="{Binding RefreshByManualInputCommand}"
                                 Description="{shcm:ResourceString Name=ViewPageGachaLogRefreshByManualInputDescription}"
                                 Header="{shcm:ResourceString Name=ViewPageGachaLogRefreshByManualInput}"
                                 HeaderIcon="{shcm:FontIcon Glyph=&#xE765;}"
                                 IsClickEnabled="True"/>
-                            <cwc:SettingsCard
+                            <cwcont:SettingsCard
                                 ActionIconToolTip="{shcm:ResourceString Name=ViewPageGachaLogImportAction}"
                                 Command="{Binding ImportFromUIGFJsonCommand}"
                                 Description="{shcm:ResourceString Name=ViewPageGachaLogImportDescription}"
                                 Header="{shcm:ResourceString Name=ViewPageGachaLogImportHeader}"
                                 HeaderIcon="{shcm:FontIcon Glyph=&#xE8B5;}"
                                 IsClickEnabled="True"/>
-                            <cwc:SettingsCard
+                            <cwcont:SettingsCard
                                 Description="{shcm:ResourceString Name=ViewPageGachaLogRecoverFromHutaoCloudDescription}"
                                 FlyoutBase.AttachedFlyout="{StaticResource HutaoCloudFlyout}"
                                 Header="{shcm:ResourceString Name=ViewPageGachaLogHutaoCloud}"
@@ -546,7 +553,7 @@
                                         <shcb:ShowAttachedFlyoutAction/>
                                     </mxic:EventTriggerBehavior>
                                 </mxi:Interaction.Behaviors>
-                            </cwc:SettingsCard>
+                            </cwcont:SettingsCard>
                         </StackPanel>
                     </StackPanel>
                 </Border>

src/Snap.Hutao/Snap.Hutao/View/Page/SettingPage.xaml

@@ -559,6 +559,15 @@
                                         OffContent="{shcm:ResourceString Name=ViewPageSettingEmptyHistoryVisibleOff}"
                                         OnContent="{shcm:ResourceString Name=ViewPageSettingEmptyHistoryVisibleOn}"/>
                                 </cwc:SettingsCard>
+                                <cwc:SettingsCard
+                                    Description="{shcm:ResourceString Name=ViewPageSettingNeverHeldItemVisibleDescription}"
+                                    Header="{shcm:ResourceString Name=ViewPageSettingNeverHeldItemVisibleHeader}"
+                                    HeaderIcon="{shcm:FontIcon Glyph=&#xE890;}">
+                                    <ToggleSwitch
+                                        IsOn="{Binding AppOptions.IsNeverHeldStatisticsItemVisible, Mode=TwoWay}"
+                                        OffContent="{shcm:ResourceString Name=ViewPageSettingEmptyHistoryVisibleOff}"
+                                        OnContent="{shcm:ResourceString Name=ViewPageSettingEmptyHistoryVisibleOn}"/>
+                                </cwc:SettingsCard>
                             </StackPanel>
                         </Border>
                     </Border>

src/Snap.Hutao/Snap.Hutao/ViewModel/Game/IViewModelSupportLaunchExecution.cs

@@ -1,12 +1,21 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
+using Snap.Hutao.Model.Entity;
 using Snap.Hutao.Service.Game.PathAbstraction;
+using Snap.Hutao.Service.Notification;
 using System.Collections.Immutable;
 
 namespace Snap.Hutao.ViewModel.Game;
 
 internal interface IViewModelSupportLaunchExecution
 {
-    void SetGamePathEntriesAndSelectedGamePathEntry(ImmutableList<GamePathEntry> gamePathEntries, GamePathEntry? selectedEntry);
+    LaunchGameShared Shared { get; }
+
+    GameAccount? SelectedGameAccount { get; }
+
+    void SetGamePathEntriesAndSelectedGamePathEntry(ImmutableList<GamePathEntry> gamePathEntries, GamePathEntry? selectedEntry)
+    {
+        // Do nothing
+    }
 }

src/Snap.Hutao/Snap.Hutao/ViewModel/Game/LaunchGameLaunchExecution.cs

@@ -0,0 +1,36 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.Service.Game.Launching;
+using Snap.Hutao.Service.Game.Scheme;
+using Snap.Hutao.Service.Notification;
+
+namespace Snap.Hutao.ViewModel.Game;
+
+internal static class LaunchGameLaunchExecution
+{
+    public static async ValueTask LaunchExecutionAsync(this IViewModelSupportLaunchExecution launchExecution)
+    {
+        IServiceProvider root = Ioc.Default;
+        IInfoBarService infoBarService = root.GetRequiredService<IInfoBarService>();
+        ILogger<IViewModelSupportLaunchExecution> logger = root.GetRequiredService<ILogger<IViewModelSupportLaunchExecution>>();
+
+        LaunchScheme? scheme = launchExecution.Shared.GetCurrentLaunchSchemeFromConfigFile();
+        try
+        {
+            // Root service provider is required.
+            LaunchExecutionContext context = new(root, launchExecution, scheme, launchExecution.SelectedGameAccount);
+            LaunchExecutionResult result = await new LaunchExecutionInvoker().InvokeAsync(context).ConfigureAwait(false);
+
+            if (result.Kind is not LaunchExecutionResultKind.Ok)
+            {
+                infoBarService.Warning(result.ErrorMessage);
+            }
+        }
+        catch (Exception ex)
+        {
+            logger.LogCritical(ex, "Launch failed");
+            infoBarService.Error(ex);
+        }
+    }
+}

src/Snap.Hutao/Snap.Hutao/ViewModel/Game/LaunchGameShared.cs

@@ -2,39 +2,104 @@
 // Licensed under the MIT license.
 
 using Snap.Hutao.Core.ExceptionService;
+using Snap.Hutao.Factory.ContentDialog;
 using Snap.Hutao.Service.Game;
 using Snap.Hutao.Service.Game.Configuration;
 using Snap.Hutao.Service.Game.Scheme;
+using Snap.Hutao.Service.Navigation;
 using Snap.Hutao.Service.Notification;
+using Snap.Hutao.View.Dialog;
+using Snap.Hutao.View.Page;
+using System.IO;
 
 namespace Snap.Hutao.ViewModel.Game;
 
-internal static class LaunchGameShared
+[Injection(InjectAs.Transient)]
+[ConstructorGenerated]
+internal sealed partial class LaunchGameShared
 {
-    public static LaunchScheme? GetCurrentLaunchSchemeFromConfigFile(IGameServiceFacade gameService, IInfoBarService infoBarService)
+    private readonly IContentDialogFactory contentDialogFactory;
+    private readonly INavigationService navigationService;
+    private readonly IGameServiceFacade gameService;
+    private readonly IInfoBarService infoBarService;
+    private readonly LaunchOptions launchOptions;
+    private readonly ITaskContext taskContext;
+
+    public LaunchScheme? GetCurrentLaunchSchemeFromConfigFile()
     {
         ChannelOptions options = gameService.GetChannelOptions();
 
-        if (options.ErrorKind is ChannelOptionsErrorKind.None)
+        switch (options.ErrorKind)
         {
-            try
-            {
-                return KnownLaunchSchemes.Get().Single(scheme => scheme.Equals(options));
-            }
-            catch (InvalidOperationException)
-            {
-                if (!IgnoredInvalidChannelOptions.Contains(options))
+            case ChannelOptionsErrorKind.None:
+                try
                 {
-                    // 后台收集
-                    throw ThrowHelper.NotSupported($"不支持的 MultiChannel: {options}");
+                    return KnownLaunchSchemes.Get().Single(scheme => scheme.Equals(options));
                 }
-            }
-        }
-        else
-        {
-            infoBarService.Warning($"{options.ErrorKind}", SH.FormatViewModelLaunchGameMultiChannelReadFail(options.FilePath));
+                catch (InvalidOperationException)
+                {
+                    if (!IgnoredInvalidChannelOptions.Contains(options))
+                    {
+                        // 后台收集
+                        HutaoException.Throw(HutaoExceptionKind.GameConfigInvalidChannelOptions, $"不支持的 ChannelOptions: {options}");
+                    }
+                }
+
+                break;
+            case ChannelOptionsErrorKind.ConfigurationFileNotFound:
+                infoBarService.Warning($"{options.ErrorKind}", SH.FormatViewModelLaunchGameMultiChannelReadFail(options.FilePath), SH.ViewModelLaunchGameFixConfigurationFileButtonText, HandleConfigurationFileNotFoundCommand);
+                break;
+            case ChannelOptionsErrorKind.GamePathNullOrEmpty:
+                infoBarService.Warning($"{options.ErrorKind}", SH.FormatViewModelLaunchGameMultiChannelReadFail(options.FilePath), SH.ViewModelLaunchGameSetGamePathButtonText, HandleGamePathNullOrEmptyCommand);
+                break;
         }
 
         return default;
     }
+
+    [Command("HandleConfigurationFileNotFoundCommand")]
+    private async Task HandleConfigurationFileNotFoundAsync()
+    {
+        if (!launchOptions.TryGetGameFileSystem(out GameFileSystem? gameFileSystem))
+        {
+            return;
+        }
+
+        bool isOversea = LaunchScheme.ExecutableIsOversea(gameFileSystem.GameFileName);
+        string dataFolder = isOversea ? GameConstants.GenshinImpactData : GameConstants.YuanShenData;
+        string persistentScriptVersionFile = Path.Combine(gameFileSystem.GameDirectory, dataFolder, "Persistent", "ScriptVersion");
+        string version = await File.ReadAllTextAsync(persistentScriptVersionFile).ConfigureAwait(false);
+
+        LaunchGameConfigurationFixDialog dialog = await contentDialogFactory
+            .CreateInstanceAsync<LaunchGameConfigurationFixDialog>()
+            .ConfigureAwait(false);
+
+        await taskContext.SwitchToMainThreadAsync();
+        dialog.KnownSchemes = KnownLaunchSchemes.Get().Where(scheme => scheme.IsOversea == isOversea);
+        dialog.SelectedScheme = dialog.KnownSchemes.First(scheme => scheme.IsNotCompatOnly);
+        (bool isOk, LaunchScheme launchScheme) = await dialog.GetLaunchSchemeAsync().ConfigureAwait(false);
+
+        if (isOk)
+        {
+            string gameBiz = launchScheme.IsOversea ? "hk4e_global" : "hk4e_cn";
+            string content = $"""
+                [General]
+                channel={launchScheme.Channel:D}
+                cps=mihoyo
+                game_version={version}
+                sub_channel={launchScheme.SubChannel:D}
+                sdk_version=
+                game_biz={gameBiz}
+                """;
+
+            await File.WriteAllTextAsync(gameFileSystem.GameConfigFilePath, content).ConfigureAwait(false);
+            infoBarService.Success(SH.ViewModelLaunchGameFixConfigurationFileSuccess);
+        }
+    }
+
+    [Command("HandleGamePathNullOrEmptyCommand")]
+    private void HandleGamePathNullOrEmpty()
+    {
+        navigationService.Navigate<LaunchGamePage>(INavigationAwaiter.Default);
+    }
 }

src/Snap.Hutao/Snap.Hutao/ViewModel/Game/LaunchGameViewModel.cs

@@ -40,6 +40,7 @@ internal sealed partial class LaunchGameViewModel : Abstraction.ViewModel, IView
     private readonly LaunchStatusOptions launchStatusOptions;
     private readonly IGameLocatorFactory gameLocatorFactory;
     private readonly ILogger<LaunchGameViewModel> logger;
+    private readonly LaunchGameShared launchGameShared;
     private readonly IInfoBarService infoBarService;
     private readonly ResourceClient resourceClient;
     private readonly RuntimeOptions runtimeOptions;
@@ -59,6 +60,8 @@ internal sealed partial class LaunchGameViewModel : Abstraction.ViewModel, IView
     private GamePathEntry? selectedGamePathEntry;
     private GameAccountFilter? gameAccountFilter;
 
+    LaunchGameShared IViewModelSupportLaunchExecution.Shared { get => launchGameShared; }
+
     public LaunchOptions LaunchOptions { get => launchOptions; }
 
     public LaunchStatusOptions LaunchStatusOptions { get => launchStatusOptions; }
@@ -82,7 +85,6 @@ internal sealed partial class LaunchGameViewModel : Abstraction.ViewModel, IView
 
     public GameResource? GameResource { get => gameResource; set => SetProperty(ref gameResource, value); }
 
-    [AlsoAsyncSets(nameof(SelectedScheme), nameof(GameAccountsView))]
     public bool GamePathSelectedAndValid
     {
         get => gamePathSelectedAndValid;
@@ -99,7 +101,7 @@ internal sealed partial class LaunchGameViewModel : Abstraction.ViewModel, IView
                 {
                     using (await EnterCriticalExecutionAsync().ConfigureAwait(false))
                     {
-                        LaunchScheme? scheme = LaunchGameShared.GetCurrentLaunchSchemeFromConfigFile(gameService, infoBarService);
+                        LaunchScheme? scheme = launchGameShared.GetCurrentLaunchSchemeFromConfigFile();
 
                         await taskContext.SwitchToMainThreadAsync();
                         await SetSelectedSchemeAsync(scheme).ConfigureAwait(true);
@@ -148,7 +150,6 @@ internal sealed partial class LaunchGameViewModel : Abstraction.ViewModel, IView
 
     public ImmutableList<GamePathEntry> GamePathEntries { get => gamePathEntries; set => SetProperty(ref gamePathEntries, value); }
 
-    [AlsoSets(nameof(GamePathSelectedAndValid))]
     public GamePathEntry? SelectedGamePathEntry
     {
         get => selectedGamePathEntry;
@@ -180,6 +181,12 @@ internal sealed partial class LaunchGameViewModel : Abstraction.ViewModel, IView
         return ValueTask.FromResult(true);
     }
 
+    [Command("IdentifyMonitorsCommand")]
+    private static async Task IdentifyMonitorsAsync()
+    {
+        await IdentifyMonitorWindow.IdentifyAllMonitorsAsync(3);
+    }
+
     [Command("SetGamePathCommand")]
     private async Task SetGamePathAsync()
     {
@@ -209,21 +216,7 @@ internal sealed partial class LaunchGameViewModel : Abstraction.ViewModel, IView
     [Command("LaunchCommand")]
     private async Task LaunchAsync()
     {
-        try
-        {
-            LaunchExecutionContext context = new(Ioc.Default, this, SelectedScheme, SelectedGameAccount);
-            LaunchExecutionResult result = await new LaunchExecutionInvoker().InvokeAsync(context).ConfigureAwait(false);
-
-            if (result.Kind is not LaunchExecutionResultKind.Ok)
-            {
-                infoBarService.Warning(result.ErrorMessage);
-            }
-        }
-        catch (Exception ex)
-        {
-            logger.LogCritical(ex, "Launch failed");
-            infoBarService.Error(ex);
-        }
+        await this.LaunchExecutionAsync().ConfigureAwait(false);
     }
 
     [Command("DetectGameAccountCommand")]
@@ -244,7 +237,7 @@ internal sealed partial class LaunchGameViewModel : Abstraction.ViewModel, IView
                 SelectedGameAccount = account;
             }
         }
-        catch (UserdataCorruptedException ex)
+        catch (Exception ex)
         {
             infoBarService.Error(ex);
         }
@@ -253,47 +246,54 @@ internal sealed partial class LaunchGameViewModel : Abstraction.ViewModel, IView
     [Command("AttachGameAccountCommand")]
     private void AttachGameAccountToCurrentUserGameRole(GameAccount? gameAccount)
     {
-        if (gameAccount is not null)
+        if (gameAccount is null)
         {
-            if (userService.Current?.SelectedUserGameRole is { } role)
-            {
-                gameService.AttachGameAccountToUid(gameAccount, role.GameUid);
-            }
-            else
-            {
-                infoBarService.Warning(SH.MustSelectUserAndUid);
-            }
+            return;
+        }
+
+        if (userService.Current?.SelectedUserGameRole is { } role)
+        {
+            gameService.AttachGameAccountToUid(gameAccount, role.GameUid);
+        }
+        else
+        {
+            infoBarService.Warning(SH.MustSelectUserAndUid);
         }
     }
 
     [Command("ModifyGameAccountCommand")]
     private async Task ModifyGameAccountAsync(GameAccount? gameAccount)
     {
-        if (gameAccount is not null)
+        if (gameAccount is null)
         {
-            await gameService.ModifyGameAccountAsync(gameAccount).ConfigureAwait(false);
+            return;
         }
+
+        await gameService.ModifyGameAccountAsync(gameAccount).ConfigureAwait(false);
     }
 
     [Command("RemoveGameAccountCommand")]
     private async Task RemoveGameAccountAsync(GameAccount? gameAccount)
     {
-        if (gameAccount is not null)
+        if (gameAccount is null)
         {
-            await gameService.RemoveGameAccountAsync(gameAccount).ConfigureAwait(false);
+            return;
         }
+
+        await gameService.RemoveGameAccountAsync(gameAccount).ConfigureAwait(false);
     }
 
     [Command("OpenScreenshotFolderCommand")]
     private async Task OpenScreenshotFolderAsync()
     {
-        string game = LaunchOptions.GamePath;
-        string? directory = Path.GetDirectoryName(game);
-        ArgumentException.ThrowIfNullOrEmpty(directory);
-        string screenshot = Path.Combine(directory, "ScreenShot");
-        if (Directory.Exists(screenshot))
+        if (!launchOptions.TryGetGameFileSystem(out GameFileSystem? gameFileSystem))
         {
-            await Windows.System.Launcher.LaunchFolderPathAsync(screenshot);
+            return;
+        }
+
+        if (Directory.Exists(gameFileSystem.ScreenShotDirectory))
+        {
+            await Windows.System.Launcher.LaunchFolderPathAsync(gameFileSystem.ScreenShotDirectory);
         }
     }
 
@@ -301,12 +301,12 @@ internal sealed partial class LaunchGameViewModel : Abstraction.ViewModel, IView
     {
         if (SetProperty(ref selectedScheme, value, nameof(SelectedScheme)))
         {
-            UpdateGameResourceAsync(value).SafeForget();
-            await UpdateGameAccountsViewAsync().ConfigureAwait(false);
-
             // Clear the selected game account to prevent setting
             // incorrect CN/OS account when scheme not match
             SelectedGameAccount = default;
+
+            await UpdateGameAccountsViewAsync().ConfigureAwait(false);
+            UpdateGameResourceAsync(value).SafeForget();
         }
 
         async ValueTask UpdateGameResourceAsync(LaunchScheme? scheme)
@@ -340,28 +340,4 @@ internal sealed partial class LaunchGameViewModel : Abstraction.ViewModel, IView
             };
         }
     }
-
-    [Command("IdentifyMonitorsCommand")]
-    private async Task IdentifyMonitorsAsync()
-    {
-        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(3).ConfigureAwait(true);
-
-        foreach (IdentifyMonitorWindow window in windows)
-        {
-            window.Close();
-        }
-    }
 }

src/Snap.Hutao/Snap.Hutao/ViewModel/Game/LaunchGameViewModelSlim.cs

@@ -22,7 +22,7 @@ namespace Snap.Hutao.ViewModel.Game;
 internal sealed partial class LaunchGameViewModelSlim : Abstraction.ViewModelSlim<View.Page.LaunchGamePage>, IViewModelSupportLaunchExecution
 {
     private readonly LaunchStatusOptions launchStatusOptions;
-    private readonly ILogger<LaunchGameViewModelSlim> logger;
+    private readonly LaunchGameShared launchGameShared;
     private readonly IInfoBarService infoBarService;
     private readonly IGameServiceFacade gameService;
     private readonly ITaskContext taskContext;
@@ -31,6 +31,8 @@ internal sealed partial class LaunchGameViewModelSlim : Abstraction.ViewModelSli
     private GameAccount? selectedGameAccount;
     private GameAccountFilter? gameAccountFilter;
 
+    LaunchGameShared IViewModelSupportLaunchExecution.Shared { get => launchGameShared; }
+
     public LaunchStatusOptions LaunchStatusOptions { get => launchStatusOptions; }
 
     public AdvancedCollectionView<GameAccount>? GameAccountsView { get => gameAccountsView; set => SetProperty(ref gameAccountsView, value); }
@@ -40,14 +42,10 @@ internal sealed partial class LaunchGameViewModelSlim : Abstraction.ViewModelSli
     /// </summary>
     public GameAccount? SelectedGameAccount { get => selectedGameAccount; set => SetProperty(ref selectedGameAccount, value); }
 
-    public void SetGamePathEntriesAndSelectedGamePathEntry(ImmutableList<GamePathEntry> gamePathEntries, GamePathEntry? selectedEntry)
-    {
-    }
-
     /// <inheritdoc/>
     protected override async Task OpenUIAsync()
     {
-        LaunchScheme? scheme = LaunchGameShared.GetCurrentLaunchSchemeFromConfigFile(gameService, infoBarService);
+        LaunchScheme? scheme = launchGameShared.GetCurrentLaunchSchemeFromConfigFile();
         ObservableCollection<GameAccount> accounts = gameService.GameAccountCollection;
 
         try
@@ -58,7 +56,7 @@ internal sealed partial class LaunchGameViewModelSlim : Abstraction.ViewModelSli
                 SelectedGameAccount ??= gameService.DetectCurrentGameAccount(scheme);
             }
         }
-        catch (UserdataCorruptedException ex)
+        catch (Exception ex)
         {
             infoBarService.Error(ex);
         }
@@ -75,23 +73,6 @@ internal sealed partial class LaunchGameViewModelSlim : Abstraction.ViewModelSli
     [Command("LaunchCommand")]
     private async Task LaunchAsync()
     {
-        IInfoBarService infoBarService = ServiceProvider.GetRequiredService<IInfoBarService>();
-        LaunchScheme? scheme = LaunchGameShared.GetCurrentLaunchSchemeFromConfigFile(gameService, infoBarService);
-
-        try
-        {
-            LaunchExecutionContext context = new(Ioc.Default, this, scheme, SelectedGameAccount);
-            LaunchExecutionResult result = await new LaunchExecutionInvoker().InvokeAsync(context).ConfigureAwait(false);
-
-            if (result.Kind is not LaunchExecutionResultKind.Ok)
-            {
-                infoBarService.Warning(result.ErrorMessage);
-            }
-        }
-        catch (Exception ex)
-        {
-            logger.LogCritical(ex, "Launch failed");
-            infoBarService.Error(ex);
-        }
+        await this.LaunchExecutionAsync().ConfigureAwait(false);
     }
 }

src/Snap.Hutao/Snap.Hutao/ViewModel/Guide/DownloadSummary.cs

@@ -7,105 +7,107 @@ using Snap.Hutao.Core;
 using Snap.Hutao.Core.Caching;
 using Snap.Hutao.Core.ExceptionService;
 using Snap.Hutao.Core.IO;
+using Snap.Hutao.Factory.Progress;
+using Snap.Hutao.Web.Request.Builder;
+using Snap.Hutao.Web.Request.Builder.Abstraction;
+using System.Collections.Frozen;
 using System.IO;
 using System.IO.Compression;
 using System.Net.Http;
 
 namespace Snap.Hutao.ViewModel.Guide;
 
-/// <summary>
-/// 下载信息
-/// </summary>
 internal sealed class DownloadSummary : ObservableObject
 {
+    private static readonly FrozenSet<string?> AllowedMediaTypes = FrozenSet.ToFrozenSet(
+    [
+        "application/octet-stream",
+        "application/zip",
+    ]);
+
     private readonly IServiceProvider serviceProvider;
     private readonly ITaskContext taskContext;
     private readonly IImageCache imageCache;
+    private readonly IHttpRequestMessageBuilderFactory httpRequestMessageBuilderFactory;
     private readonly HttpClient httpClient;
+
     private readonly string fileName;
     private readonly string fileUrl;
-    private readonly Progress<StreamCopyStatus> progress;
+    private readonly IProgress<StreamCopyStatus> progress;
+
     private string description = SH.ViewModelWelcomeDownloadSummaryDefault;
     private double progressValue;
 
-    /// <summary>
-    /// 构造一个新的下载信息
-    /// </summary>
-    /// <param name="serviceProvider">服务提供器</param>
-    /// <param name="fileName">压缩文件名称</param>
     public DownloadSummary(IServiceProvider serviceProvider, string fileName)
     {
         taskContext = serviceProvider.GetRequiredService<ITaskContext>();
+        httpRequestMessageBuilderFactory = serviceProvider.GetRequiredService<IHttpRequestMessageBuilderFactory>();
         httpClient = serviceProvider.GetRequiredService<HttpClient>();
+        httpClient.DefaultRequestHeaders.UserAgent.ParseAdd(serviceProvider.GetRequiredService<RuntimeOptions>().UserAgent);
         imageCache = serviceProvider.GetRequiredService<IImageCache>();
-        RuntimeOptions runtimeOptions = serviceProvider.GetRequiredService<RuntimeOptions>();
-        httpClient.DefaultRequestHeaders.UserAgent.ParseAdd(runtimeOptions.UserAgent);
 
         this.serviceProvider = serviceProvider;
 
-        DisplayName = fileName;
         this.fileName = fileName;
         fileUrl = Web.HutaoEndpoints.StaticZip(fileName);
 
-        progress = new(UpdateProgressStatus);
+        progress = serviceProvider.GetRequiredService<IProgressFactory>().CreateForMainThread<StreamCopyStatus>(UpdateProgressStatus);
     }
 
-    /// <summary>
-    /// 显示名称
-    /// </summary>
-    public string DisplayName { get; init; }
+    public string DisplayName { get => fileName; }
 
-    /// <summary>
-    /// 描述
-    /// </summary>
     public string Description { get => description; private set => SetProperty(ref description, value); }
 
-    /// <summary>
-    /// 进度值，最大1
-    /// </summary>
     public double ProgressValue { get => progressValue; set => SetProperty(ref progressValue, value); }
 
-    /// <summary>
-    /// 异步下载并解压
-    /// </summary>
-    /// <returns>任务</returns>
     public async ValueTask<bool> DownloadAndExtractAsync()
     {
         ILogger<DownloadSummary> logger = serviceProvider.GetRequiredService<ILogger<DownloadSummary>>();
         try
         {
-            HttpResponseMessage response = await httpClient.GetAsync(fileUrl, HttpCompletionOption.ResponseHeadersRead).ConfigureAwait(false);
+            HttpRequestMessage message = httpRequestMessageBuilderFactory
+                .Create()
+                .SetRequestUri(fileUrl)
+                .SetStaticResourceControlHeaders()
+                .Get()
+                .HttpRequestMessage;
 
-            if (response.Content.Headers.ContentType?.MediaType is not ("application/octet-stream" or "application/zip"))
+            using (message)
             {
-                logger.LogWarning("Download Static Zip failed, Content-Type is {Type}", response.Content.Headers.ContentType);
-                await taskContext.SwitchToMainThreadAsync();
-                Description = SH.ViewModelWelcomeDownloadSummaryContentTypeNotMatch;
-                return false;
-            }
-
-            long contentLength = response.Content.Headers.ContentLength ?? 0;
-            logger.LogInformation("Begin download, length: {length}", contentLength);
-            using (Stream content = await response.Content.ReadAsStreamAsync().ConfigureAwait(false))
-            {
-                using (TempFileStream temp = new(FileMode.OpenOrCreate, FileAccess.ReadWrite))
+                using (HttpResponseMessage response = await httpClient.SendAsync(message, HttpCompletionOption.ResponseHeadersRead).ConfigureAwait(false))
                 {
-                    await new StreamCopyWorker(content, temp, contentLength).CopyAsync(progress).ConfigureAwait(false);
-                    ExtractFiles(temp);
+                    if (!AllowedMediaTypes.Contains(response.Content.Headers.ContentType?.MediaType))
+                    {
+                        logger.LogWarning("Download Static Zip failed, Content-Type is {Type}", response.Content.Headers.ContentType);
+                        await taskContext.SwitchToMainThreadAsync();
+                        Description = SH.ViewModelWelcomeDownloadSummaryContentTypeNotMatch;
+                        return false;
+                    }
 
-                    await taskContext.SwitchToMainThreadAsync();
-                    ProgressValue = 1;
-                    Description = SH.ViewModelWelcomeDownloadSummaryComplete;
-                    return true;
+                    long contentLength = response.Content.Headers.ContentLength ?? 0;
+                    logger.LogInformation("Begin download, size: {length}", Converters.ToFileSizeString(contentLength));
+                    using (Stream content = await response.Content.ReadAsStreamAsync().ConfigureAwait(false))
+                    {
+                        using (TempFileStream temp = new(FileMode.OpenOrCreate, FileAccess.ReadWrite))
+                        {
+                            await new StreamCopyWorker(content, temp, contentLength).CopyAsync(progress).ConfigureAwait(false);
+                            ExtractFiles(temp);
+                            await taskContext.SwitchToMainThreadAsync();
+                            ProgressValue = 1;
+                            Description = SH.ViewModelWelcomeDownloadSummaryComplete;
+                            return true;
+                        }
+                    }
                 }
             }
         }
         catch (Exception ex)
         {
-            logger.LogError(ex, "Download Static Zip failed");
+            logger.LogError(ex, "Download static zip failed");
+
             await taskContext.SwitchToMainThreadAsync();
-            Description = ex is HttpRequestException httpRequestException
-                ? $"{SH.ViewModelWelcomeDownloadSummaryException} - [HTTP '{httpRequestException.StatusCode:D}'] [Error '{httpRequestException.HttpRequestError}']"
+            Description = ex is HttpRequestException httpRequestEx
+                ? $"{SH.ViewModelWelcomeDownloadSummaryException} - [HTTP '{httpRequestEx.StatusCode:D}'] [Error '{httpRequestEx.HttpRequestError}']"
                 : ex.Message;
             return false;
         }
@@ -114,7 +116,7 @@ internal sealed class DownloadSummary : ObservableObject
     private void UpdateProgressStatus(StreamCopyStatus status)
     {
         Description = $"{Converters.ToFileSizeString(status.BytesCopied)}/{Converters.ToFileSizeString(status.TotalBytes)}";
-        ProgressValue = status.TotalBytes == 0 ? 0 : (double)status.BytesCopied / status.TotalBytes;
+        ProgressValue = status.TotalBytes is 0 ? 0 : (double)status.BytesCopied / status.TotalBytes;
     }
 
     private void ExtractFiles(Stream stream)

src/Snap.Hutao/Snap.Hutao/ViewModel/Guide/GuideState.cs

@@ -24,7 +24,17 @@ internal enum GuideState : uint
     Environment,
 
     /// <summary>
-    /// 开始下载资源
+    /// 正在查看常用设置
+    /// </summary>
+    CommonSetting,
+
+    /// <summary>
+    /// 正在查看图像资源设置
+    /// </summary>
+    StaticResourceSetting,
+
+    /// <summary>
+    /// 开始下载图像资源
     /// </summary>
     StaticResourceBegin,
 

src/Snap.Hutao/Snap.Hutao/ViewModel/Guide/GuideViewModel.cs

@@ -6,6 +6,9 @@ using Snap.Hutao.Core;
 using Snap.Hutao.Core.Setting;
 using Snap.Hutao.Model;
 using Snap.Hutao.Service;
+using Snap.Hutao.Web.Hoyolab;
+using Snap.Hutao.Web.Hutao;
+using Snap.Hutao.Web.Hutao.Response;
 using System.Collections.ObjectModel;
 using System.Globalization;
 
@@ -20,12 +23,15 @@ internal sealed partial class GuideViewModel : Abstraction.ViewModel
 {
     private readonly IServiceProvider serviceProvider;
     private readonly ITaskContext taskContext;
+    private readonly StaticResourceOptions staticResourceOptions;
     private readonly CultureOptions cultureOptions;
     private readonly RuntimeOptions runtimeOptions;
+    private readonly AppOptions appOptions;
 
     private string nextOrCompleteButtonText = SH.ViewModelGuideActionNext;
     private bool isNextOrCompleteButtonEnabled = true;
     private NameValue<CultureInfo>? selectedCulture;
+    private NameValue<Region>? selectedRegion;
     private bool isTermOfServiceAgreed;
     private bool isPrivacyPolicyAgreed;
     private bool isIssueReportAgreed;
@@ -36,8 +42,7 @@ internal sealed partial class GuideViewModel : Abstraction.ViewModel
     {
         get
         {
-            uint value = LocalSetting.Get(SettingKeys.Major1Minor7Revision0GuideState, 0U);
-            GuideState state = (GuideState)value;
+            GuideState state = UnsafeLocalSetting.Get(SettingKeys.Major1Minor10Revision0GuideState, GuideState.Language);
 
             if (state is GuideState.Document)
             {
@@ -61,12 +66,12 @@ internal sealed partial class GuideViewModel : Abstraction.ViewModel
                 (NextOrCompleteButtonText, IsNextOrCompleteButtonEnabled) = (SH.ViewModelGuideActionNext, true);
             }
 
-            return value;
+            return (uint)state;
         }
 
         set
         {
-            LocalSetting.Set(SettingKeys.Major1Minor7Revision0GuideState, value);
+            LocalSetting.Set(SettingKeys.Major1Minor10Revision0GuideState, value);
             OnPropertyChanged();
         }
     }
@@ -79,6 +84,10 @@ internal sealed partial class GuideViewModel : Abstraction.ViewModel
 
     public RuntimeOptions RuntimeOptions { get => runtimeOptions; }
 
+    public AppOptions AppOptions { get => appOptions; }
+
+    public StaticResourceOptions StaticResourceOptions { get => staticResourceOptions; }
+
     public NameValue<CultureInfo>? SelectedCulture
     {
         get => selectedCulture ??= CultureOptions.GetCurrentCultureForSelectionOrDefault();
@@ -93,13 +102,26 @@ internal sealed partial class GuideViewModel : Abstraction.ViewModel
         }
     }
 
+    public NameValue<Region>? SelectedRegion
+    {
+        get => selectedRegion ??= AppOptions.GetCurrentRegionForSelectionOrDefault();
+        set
+        {
+            if (SetProperty(ref selectedRegion, value) && value is not null)
+            {
+                AppOptions.Region = value.Value;
+            }
+        }
+    }
+
+    #region Agreement
     public bool IsTermOfServiceAgreed
     {
         get => isTermOfServiceAgreed; set
         {
             if (SetProperty(ref isTermOfServiceAgreed, value))
             {
-                OnAgreeSateChanged();
+                OnAgreementStateChanged();
             }
         }
     }
@@ -110,7 +132,7 @@ internal sealed partial class GuideViewModel : Abstraction.ViewModel
         {
             if (SetProperty(ref isPrivacyPolicyAgreed, value))
             {
-                OnAgreeSateChanged();
+                OnAgreementStateChanged();
             }
         }
     }
@@ -121,7 +143,7 @@ internal sealed partial class GuideViewModel : Abstraction.ViewModel
         {
             if (SetProperty(ref isIssueReportAgreed, value))
             {
-                OnAgreeSateChanged();
+                OnAgreementStateChanged();
             }
         }
     }
@@ -132,27 +154,38 @@ internal sealed partial class GuideViewModel : Abstraction.ViewModel
         {
             if (SetProperty(ref isOpenSourceLicenseAgreed, value))
             {
-                OnAgreeSateChanged();
+                OnAgreementStateChanged();
             }
         }
     }
+    #endregion
 
-    /// <summary>
-    /// 下载信息
-    /// </summary>
     public ObservableCollection<DownloadSummary>? DownloadSummaries
     {
         get => downloadSummaries;
         set => SetProperty(ref downloadSummaries, value);
     }
 
+    protected override async ValueTask<bool> InitializeUIAsync()
+    {
+        HutaoInfrastructureClient hutaoInfrastructureClient = serviceProvider.GetRequiredService<HutaoInfrastructureClient>();
+        HutaoResponse<StaticResourceSizeInformation> response = await hutaoInfrastructureClient.GetStaticSizeAsync().ConfigureAwait(false);
+        if (response.IsOk())
+        {
+            await taskContext.SwitchToMainThreadAsync();
+            StaticResourceOptions.SizeInformation = response.Data;
+        }
+
+        return true;
+    }
+
     [Command("NextOrCompleteCommand")]
     private void NextOrComplete()
     {
         ++State;
     }
 
-    private void OnAgreeSateChanged()
+    private void OnAgreementStateChanged()
     {
         IsNextOrCompleteButtonEnabled = IsTermOfServiceAgreed && IsPrivacyPolicyAgreed && IsIssueReportAgreed && IsOpenSourceLicenseAgreed;
     }
@@ -173,7 +206,7 @@ internal sealed partial class GuideViewModel : Abstraction.ViewModel
         }).ConfigureAwait(false);
 
         StaticResource.FulfillAll();
-        UnsafeLocalSetting.Set(SettingKeys.Major1Minor7Revision0GuideState, GuideState.Completed);
+        UnsafeLocalSetting.Set(SettingKeys.Major1Minor10Revision0GuideState, GuideState.Completed);
         AppInstance.Restart(string.Empty);
     }
 }

src/Snap.Hutao/Snap.Hutao/ViewModel/Guide/StaticResource.cs

@@ -16,7 +16,7 @@ internal static class StaticResource
 
     private static readonly ApplicationDataCompositeValue DefaultResourceVersionMap = new()
     {
-        // DO NOT MIDIFY THIS MAP
+        // DO NOT MODIFY THIS MAP
         { "AchievementIcon", 0 },
         { "AvatarCard", 0 },
         { "AvatarIcon", 0 },
@@ -46,31 +46,31 @@ internal static class StaticResource
 
     private static readonly ApplicationDataCompositeValue LatestResourceVersionMap = new()
     {
-        { "AchievementIcon", 1 },
-        { "AvatarCard", 1 },
-        { "AvatarIcon", 4 },
-        { "Bg", 2 },
-        { "ChapterIcon", 2 },
+        { "AchievementIcon", 2 },
+        { "AvatarCard", 2 },
+        { "AvatarIcon", 5 },
+        { "Bg", 3 },
+        { "ChapterIcon", 3 },
         { "CodexMonster", 0 },
-        { "Costume", 1 },
-        { "EmotionIcon", 2 },
-        { "EquipIcon", 3 },
-        { "GachaAvatarIcon", 3 },
-        { "GachaAvatarImg", 3 },
-        { "GachaEquipIcon", 3 },
+        { "Costume", 2 },
+        { "EmotionIcon", 3 },
+        { "EquipIcon", 4 },
+        { "GachaAvatarIcon", 4 },
+        { "GachaAvatarImg", 4 },
+        { "GachaEquipIcon", 4 },
         { "GcgCharAvatarIcon", 0 },
-        { "IconElement", 2 },
-        { "ItemIcon", 3 },
-        { "LoadingPic", 1 },
-        { "MonsterIcon", 2 },
-        { "MonsterSmallIcon", 1 },
-        { "NameCardIcon", 2 },
-        { "NameCardPic", 3 },
+        { "IconElement", 3 },
+        { "ItemIcon", 4 },
+        { "LoadingPic", 2 },
+        { "MonsterIcon", 3 },
+        { "MonsterSmallIcon", 2 },
+        { "NameCardIcon", 3 },
+        { "NameCardPic", 4 },
         { "NameCardPicAlpha", 0 },
-        { "Property", 1 },
-        { "RelicIcon", 3 },
-        { "Skill", 3 },
-        { "Talent", 3 },
+        { "Property", 2 },
+        { "RelicIcon", 4 },
+        { "Skill", 4 },
+        { "Talent", 4 },
     };
 
     public static void FulfillAll()

src/Snap.Hutao/Snap.Hutao/ViewModel/Guide/StaticResourceArchive.cs

@@ -0,0 +1,14 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.ViewModel.Guide;
+
+[Localization]
+internal enum StaticResourceArchive
+{
+    [LocalizationKey(nameof(SH.ViewGuideStepStaticResourceSettingMinimumOff))]
+    Full,
+
+    [LocalizationKey(nameof(SH.ViewGuideStepStaticResourceSettingMinimumOn))]
+    Minimum,
+}

src/Snap.Hutao/Snap.Hutao/ViewModel/Guide/StaticResourceHttpHeaderBuilderExtension.cs

@@ -0,0 +1,26 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.Core.Setting;
+using Snap.Hutao.Web.Request.Builder;
+using Snap.Hutao.Web.Request.Builder.Abstraction;
+using System.Net.Http.Headers;
+
+namespace Snap.Hutao.ViewModel.Guide;
+
+internal static class StaticResourceHttpHeaderBuilderExtension
+{
+    public static TBuilder SetStaticResourceControlHeaders<TBuilder>(this TBuilder builder)
+        where TBuilder : IHttpHeadersBuilder<HttpHeaders>
+    {
+        return builder
+            .SetHeader("x-quality", $"{UnsafeLocalSetting.Get(SettingKeys.StaticResourceImageQuality, StaticResourceQuality.Raw)}")
+            .SetHeader("x-archive", $"{UnsafeLocalSetting.Get(SettingKeys.StaticResourceImageArchive, StaticResourceArchive.Full)}");
+    }
+
+    public static TBuilder SetStaticResourceControlHeadersIf<TBuilder>(this TBuilder builder, bool condition)
+        where TBuilder : IHttpHeadersBuilder<HttpHeaders>
+    {
+        return condition ? builder.SetStaticResourceControlHeaders() : builder;
+    }
+}

src/Snap.Hutao/Snap.Hutao/ViewModel/Guide/StaticResourceOptions.cs

@@ -0,0 +1,82 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using CommunityToolkit.Common;
+using CommunityToolkit.Mvvm.ComponentModel;
+using Snap.Hutao.Core.Setting;
+using Snap.Hutao.Model;
+using Snap.Hutao.Web.Hutao;
+
+namespace Snap.Hutao.ViewModel.Guide;
+
+[Injection(InjectAs.Singleton)]
+internal sealed class StaticResourceOptions : ObservableObject
+{
+    private readonly List<NameValue<StaticResourceQuality>> imageQualities = CollectionsNameValue.FromEnum<StaticResourceQuality>(q => q.GetLocalizedDescription());
+    private readonly List<NameValue<StaticResourceArchive>> imageArchives = CollectionsNameValue.FromEnum<StaticResourceArchive>(a => a.GetLocalizedDescription());
+
+    private NameValue<StaticResourceQuality>? imageQuality;
+    private NameValue<StaticResourceArchive>? imageArchive;
+    private string? sizeInformationText;
+
+    private StaticResourceSizeInformation? sizeInformation;
+
+    public List<NameValue<StaticResourceQuality>> ImageQualities { get => imageQualities; }
+
+    public NameValue<StaticResourceQuality>? ImageQuality
+    {
+        get => imageQuality ??= ImageQualities.First(q => q.Value == UnsafeLocalSetting.Get(SettingKeys.StaticResourceImageQuality, StaticResourceQuality.Raw));
+        set
+        {
+            if (SetProperty(ref imageQuality, value) && value is not null)
+            {
+                UnsafeLocalSetting.Set(SettingKeys.StaticResourceImageQuality, value.Value);
+                UpdateSizeInformationText();
+            }
+        }
+    }
+
+    public List<NameValue<StaticResourceArchive>> ImageArchives { get => imageArchives; }
+
+    public NameValue<StaticResourceArchive>? ImageArchive
+    {
+        get => imageArchive ??= ImageArchives.First(a => a.Value == UnsafeLocalSetting.Get(SettingKeys.StaticResourceImageArchive, StaticResourceArchive.Full));
+        set
+        {
+            if (SetProperty(ref imageArchive, value) && value is not null)
+            {
+                UnsafeLocalSetting.Set(SettingKeys.StaticResourceImageArchive, value.Value);
+                UpdateSizeInformationText();
+            }
+        }
+    }
+
+    public StaticResourceSizeInformation? SizeInformation
+    {
+        get => sizeInformation;
+        set
+        {
+            sizeInformation = value;
+            UpdateSizeInformationText();
+        }
+    }
+
+    public string? SizeInformationText { get => sizeInformationText; set => SetProperty(ref sizeInformationText, value); }
+
+    private void UpdateSizeInformationText()
+    {
+        if (SizeInformation is not null)
+        {
+            long result = (ImageQuality?.Value, ImageArchive?.Value) switch
+            {
+                (StaticResourceQuality.Raw, StaticResourceArchive.Full) => SizeInformation.RawFull,
+                (StaticResourceQuality.Raw, StaticResourceArchive.Minimum) => SizeInformation.RawMinimum,
+                (StaticResourceQuality.High, StaticResourceArchive.Full) => SizeInformation.HighFull,
+                (StaticResourceQuality.High, StaticResourceArchive.Minimum) => SizeInformation.HighMinimum,
+                _ => 0,
+            };
+
+            SizeInformationText = SH.FormatViewGuideStaticResourceDownloadSize(Converters.ToFileSizeString(result));
+        }
+    }
+}

src/Snap.Hutao/Snap.Hutao/ViewModel/Guide/StaticResourceQuality.cs

@@ -0,0 +1,14 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.ViewModel.Guide;
+
+[Localization]
+internal enum StaticResourceQuality
+{
+    [LocalizationKey(nameof(SH.ViewModelGuideStaticResourceQualityRaw))]
+    Raw,
+
+    [LocalizationKey(nameof(SH.ViewModelGuideStaticResourceQualityHigh))]
+    High,
+}

src/Snap.Hutao/Snap.Hutao/ViewModel/Home/AnnouncementViewModel.cs

@@ -3,7 +3,7 @@
 
 using Snap.Hutao.Core.Setting;
 using Snap.Hutao.Service;
-using Snap.Hutao.Service.Abstraction;
+using Snap.Hutao.Service.Announcement;
 using Snap.Hutao.Service.Hutao;
 using Snap.Hutao.View.Card;
 using Snap.Hutao.View.Card.Primitive;

src/Snap.Hutao/Snap.Hutao/ViewModel/Setting/SettingViewModel.cs

@@ -224,7 +224,7 @@ internal sealed partial class SettingViewModel : Abstraction.ViewModel
     private static void ResetStaticResource()
     {
         StaticResource.FailAll();
-        UnsafeLocalSetting.Set(SettingKeys.Major1Minor7Revision0GuideState, GuideState.StaticResourceBegin);
+        UnsafeLocalSetting.Set(SettingKeys.Major1Minor10Revision0GuideState, GuideState.StaticResourceBegin);
         AppInstance.Restart(string.Empty);
     }
 

src/Snap.Hutao/Snap.Hutao/ViewModel/TestViewModel.cs

@@ -84,7 +84,7 @@ internal sealed partial class TestViewModel : Abstraction.ViewModel
     [Command("ResetGuideStateCommand")]
     private static void ResetGuideState()
     {
-        UnsafeLocalSetting.Set(SettingKeys.Major1Minor7Revision0GuideState, GuideState.Language);
+        UnsafeLocalSetting.Set(SettingKeys.Major1Minor10Revision0GuideState, GuideState.Language);
     }
 
     [Command("ExceptionCommand")]

src/Snap.Hutao/Snap.Hutao/Web/Hutao/HutaoInfrastructureClient.cs

@@ -17,6 +17,16 @@ internal sealed partial class HutaoInfrastructureClient
     private readonly ILogger<HutaoInfrastructureClient> logger;
     private readonly HttpClient httpClient;
 
+    public async ValueTask<HutaoResponse<StaticResourceSizeInformation>> GetStaticSizeAsync(CancellationToken token = default)
+    {
+        HttpRequestMessageBuilder builder = httpRequestMessageBuilderFactory.Create()
+            .SetRequestUri(HutaoEndpoints.StaticSize)
+            .Get();
+
+        HutaoResponse<StaticResourceSizeInformation>? resp = await builder.TryCatchSendAsync<HutaoResponse<StaticResourceSizeInformation>>(httpClient, logger, token).ConfigureAwait(false);
+        return Web.Response.Response.DefaultIfNull(resp);
+    }
+
     public async ValueTask<HutaoResponse<IPInformation>> GetIPInformationAsync(CancellationToken token = default)
     {
         HttpRequestMessageBuilder builder = httpRequestMessageBuilderFactory.Create()

src/Snap.Hutao/Snap.Hutao/Web/Hutao/StaticResourceSizeInformation.cs

@@ -0,0 +1,19 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Web.Hutao;
+
+internal sealed partial class StaticResourceSizeInformation
+{
+    [JsonPropertyName("raw_full")]
+    public long RawFull { get; set; }
+
+    [JsonPropertyName("raw_minimum")]
+    public long RawMinimum { get; set; }
+
+    [JsonPropertyName("tiny_full")]
+    public long HighFull { get; set; }
+
+    [JsonPropertyName("tiny_minimum")]
+    public long HighMinimum { get; set; }
+}

src/Snap.Hutao/Snap.Hutao/Web/HutaoEndpoints.cs

@@ -270,6 +270,8 @@ internal static class HutaoEndpoints
     {
         return $"{ApiSnapGenshinStaticZip}/{fileName}.zip";
     }
+
+    public const string StaticSize = $"{ApiSnapGenshin}/static/size";
     #endregion
 
     #region Wallpaper

src/Snap.Hutao/Snap.Hutao/Web/Request/Builder/HttpContentBuilderExtension.cs

@@ -35,8 +35,7 @@ internal static class HttpContentBuilderExtension
     }
 
     [DebuggerStepThrough]
-    public static T SetFormUrlEncodedContent<T>(
-        this T builder, IEnumerable<KeyValuePair<string, string>> content)
+    public static T SetFormUrlEncodedContent<T>(this T builder, IEnumerable<KeyValuePair<string, string>> content)
         where T : IHttpContentBuilder
     {
         ArgumentNullException.ThrowIfNull(builder);

src/Snap.Hutao/Snap.Hutao/Web/Request/Builder/HttpHeadersBuilderExtension.cs

@@ -41,12 +41,6 @@ internal static partial class HttpHeadersBuilderExtension
         return builder.ConfigureHeaders<TBuilder, THeaders>(headers => headers.Add(name, value));
     }
 
-    public static T SetReferer<T>(this T builder, string referer)
-        where T : IHttpHeadersBuilder<HttpHeaders>
-    {
-        return builder.SetHeader("Referer", referer);
-    }
-
     [DebuggerStepThrough]
     public static T SetHeader<T>(this T builder, string name)
         where T : IHttpHeadersBuilder<HttpHeaders>
@@ -80,6 +74,12 @@ internal static partial class HttpHeadersBuilderExtension
             .AddHeader<TBuilder, THeaders>(name, value);
     }
 
+    public static T SetReferer<T>(this T builder, string referer)
+        where T : IHttpHeadersBuilder<HttpHeaders>
+    {
+        return builder.SetHeader("Referer", referer);
+    }
+
     [DebuggerStepThrough]
     public static T RemoveHeader<T>(this T builder, params string?[]? names)
         where T : IHttpHeadersBuilder<HttpHeaders>

src/Snap.Hutao/Snap.Hutao/Web/Request/Builder/HttpHeadersExtension.cs

@@ -12,7 +12,7 @@ internal static class HttpHeadersExtension
         ArgumentNullException.ThrowIfNull(name);
 
         // We have to work around the .NET API a little bit. See the comment below for details.
-        values ??= Enumerable.Empty<string?>();
+        values ??= [];
         values = values.Where(v => v is not null);
 
         if (values.Any())