impl #1430

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/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,8 +78,9 @@ 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 (IMemoryOwner<byte> memoryOwner = MemoryPool<byte>.Shared.Rent())
+                    {
+                        Memory<byte> buffer = memoryOwner.Memory;
                         using (Stream stream = await response.Content.ReadAsStreamAsync(token).ConfigureAwait(false))
                         {
                             int totalBytesRead = 0;
@@ -110,6 +112,7 @@ internal sealed class HttpShardCopyWorker<TStatus> : IDisposable
                 }
             }
         }
+    }
 
     public void Dispose()
     {

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,12 +52,15 @@ internal class StreamCopyWorker<TStatus>
 
         long totalBytesRead = 0;
         int bytesRead;
-        Memory<byte> buffer = new byte[bufferSize];
+
+        using (IMemoryOwner<byte> memoryOwner = MemoryPool<byte>.Shared.Rent(bufferSize))
+        {
+            Memory<byte> buffer = memoryOwner.Memory;
 
             do
             {
                 bytesRead = await source.ReadAsync(buffer).ConfigureAwait(false);
-            if (bytesRead == 0)
+                if (bytesRead is 0)
                 {
                     progress.Report(statusFactory(totalBytesRead));
                     break;
@@ -73,4 +77,5 @@ internal class StreamCopyWorker<TStatus>
             }
             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 StaticResourceUseTrimmedArchive = "StaticResourceUseTrimmedArchive";
     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/Resource/Localization/SH.resx

@@ -1397,6 +1397,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>
@@ -1407,7 +1413,7 @@
     <value>安装完成后重启胡桃以查看是否正常生效</value>
   </data>
   <data name="ViewGuideStepEnvironmentFontDescription1" xml:space="preserve">
-    <value>如果上方的图标中存在乱码，请前往</value>
+    <value>如果上方的图标中存在乱码或方块字，请前往</value>
   </data>
   <data name="ViewGuideStepEnvironmentFontDescription2" xml:space="preserve">
     <value>下载并自行安装图标字体</value>
@@ -1424,6 +1430,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>全部资源（节省 0% 磁盘空间占用）</value>
+  </data>
+  <data name="ViewGuideStepStaticResourceSettingMinimumOn" xml:space="preserve">
+    <value>部分资源（节省 13.5% 磁盘空间占用）</value>
+  </data>
+  <data name="ViewGuideStepStaticResourceSettingQualityHeader" xml:space="preserve">
+    <value>图片资源质量</value>
+  </data>
   <data name="ViewHutaoDatabaseHeader" xml:space="preserve">
     <value>深渊统计</value>
   </data>
@@ -1613,6 +1637,12 @@
   <data name="ViewModelGuideActionStaticResourceBegin" xml:space="preserve">
     <value>下载资源文件中，请稍候</value>
   </data>
+  <data name="ViewModelGuideStaticResourceQualityHigh" xml:space="preserve">
+    <value>高质量（节省 72.8% 磁盘空间占用）</value>
+  </data>
+  <data name="ViewModelGuideStaticResourceQualityRaw" xml:space="preserve">
+    <value>原图（节省 0% 磁盘空间占用）</value>
+  </data>
   <data name="ViewModelHutaoPassportEmailNotValidHint" xml:space="preserve">
     <value>请输入正确的邮箱</value>
   </data>

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

@@ -19,7 +19,7 @@ internal sealed class HutaoStatisticsFactory
     private readonly GachaEvent avatarEvent;
     private readonly GachaEvent avatarEvent2;
     private readonly GachaEvent weaponEvent;
-    private readonly GachaEvent? chronicledEvent;
+    private readonly GachaEvent chronicledEvent;
 
     public HutaoStatisticsFactory(in HutaoStatisticsFactoryMetadataContext context)
     {
@@ -32,7 +32,7 @@ internal sealed class HutaoStatisticsFactory
         avatarEvent = context.GachaEvents.Single(g => g.From < now && g.To > now && g.Type == GachaType.ActivityAvatar);
         avatarEvent2 = context.GachaEvents.Single(g => g.From < now && g.To > now && g.Type == GachaType.SpecialActivityAvatar);
         weaponEvent = context.GachaEvents.Single(g => g.From < now && g.To > now && g.Type == GachaType.ActivityWeapon);
-        chronicledEvent = context.GachaEvents.SingleOrDefault(g => g.From < now && g.To > now && g.Type == GachaType.ActivityCity);
+        chronicledEvent = context.GachaEvents.Single(g => g.From < now && g.To > now && g.Type == GachaType.ActivityCity);
     }
 
     public HutaoStatistics Create(GachaEventStatistics raw)
@@ -42,7 +42,7 @@ internal sealed class HutaoStatisticsFactory
             AvatarEvent = CreateWishSummary(avatarEvent, raw.AvatarEvent),
             AvatarEvent2 = CreateWishSummary(avatarEvent2, raw.AvatarEvent2),
             WeaponEvent = CreateWishSummary(weaponEvent, raw.WeaponEvent),
-            Chronicled = chronicledEvent is null ? null : CreateWishSummary(chronicledEvent, raw.Chronicled),
+            Chronicled = CreateWishSummary(chronicledEvent, raw.Chronicled),
         };
     }
 

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

@@ -151,7 +151,6 @@
     <None Remove="View\Control\DescParamComboBox.xaml" />
     <None Remove="View\Control\Elevation.xaml" />
     <None Remove="View\Control\HutaoStatisticsCard.xaml" />
-    <None Remove="View\Control\HutaoStatisticsPanel.xaml" />
     <None Remove="View\Control\ItemIcon.xaml" />
     <None Remove="View\Control\LaunchGameResourceExpander.xaml" />
     <None Remove="View\Control\LoadingView.xaml" />
@@ -348,14 +347,6 @@
   <ItemGroup Condition="'$(DisableMsixProjectCapabilityAddedByProject)'!='true' and '$(EnablePreviewMsixTooling)'=='true'">
     <ProjectCapability Include="Msix" />
   </ItemGroup>
-  <ItemGroup>
-    <None Include="..\.editorconfig" Link=".editorconfig" />
-  </ItemGroup>
-  <ItemGroup>
-    <Page Update="View\Control\HutaoStatisticsPanel.xaml">
-      <Generator>MSBuild:Compile</Generator>
-    </Page>
-  </ItemGroup>
   <ItemGroup>
     <Page Update="View\Dialog\LaunchGameConfigurationFixDialog.xaml">
       <Generator>MSBuild:Compile</Generator>

src/Snap.Hutao/Snap.Hutao/View/Control/HutaoStatisticsPanel.xaml

@@ -1,13 +0,0 @@
-<shcp:HorizontalEqualPanel
-    x:Class="Snap.Hutao.View.Control.HutaoStatisticsPanel"
-    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:shcp="using:Snap.Hutao.Control.Panel"
-    xmlns:shvc="using:Snap.Hutao.View.Control"
-    mc:Ignorable="d">
-    <shvc:HutaoStatisticsCard DataContext="{x:Bind Statistics.AvatarEvent}"/>
-    <shvc:HutaoStatisticsCard DataContext="{x:Bind Statistics.AvatarEvent2}"/>
-    <shvc:HutaoStatisticsCard DataContext="{x:Bind Statistics.WeaponEvent}"/>
-</shcp:HorizontalEqualPanel>

src/Snap.Hutao/Snap.Hutao/View/Control/HutaoStatisticsPanel.xaml.cs

@@ -1,38 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Microsoft.UI.Xaml;
-using Snap.Hutao.Control.Panel;
-using Snap.Hutao.ViewModel.GachaLog;
-
-namespace Snap.Hutao.View.Control;
-
-[DependencyProperty("Statistics", typeof(HutaoStatistics), default, nameof(OnStatisticsChanged))]
-internal sealed partial class HutaoStatisticsPanel : HorizontalEqualPanel
-{
-    public HutaoStatisticsPanel()
-    {
-        InitializeComponent();
-
-        if (DataContext is HutaoStatistics statistics && statistics.Chronicled is { } chronicled)
-        {
-            Children.Add(new HutaoStatisticsCard
-            {
-                DataContext = chronicled,
-            });
-        }
-    }
-
-    private static void OnStatisticsChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
-    {
-        HutaoStatisticsPanel panel = (HutaoStatisticsPanel)obj;
-
-        if (args.NewValue is HutaoStatistics { Chronicled: { } chronicled })
-        {
-            panel.Children.Add(new HutaoStatisticsCard
-            {
-                DataContext = chronicled,
-            });
-        }
-    }
-}

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

@@ -6,6 +6,7 @@
     xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
     xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
     xmlns:mxi="using:Microsoft.Xaml.Interactivity"
+    xmlns:shc="using:Snap.Hutao.Control"
     xmlns:shcb="using:Snap.Hutao.Control.Behavior"
     xmlns:shcm="using:Snap.Hutao.Control.Markup"
     xmlns:shvg="using:Snap.Hutao.ViewModel.Guide"
@@ -49,7 +50,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 +126,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 +157,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 +174,74 @@
                 </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}"/>
+                        <ToggleSwitch
+                            IsOn="{Binding StaticResourceOptions.UseTrimmedArchive, Mode=TwoWay}"
+                            OffContent="{shcm:ResourceString Name=ViewGuideStepStaticResourceSettingMinimumOff}"
+                            OnContent="{shcm:ResourceString Name=ViewGuideStepStaticResourceSettingMinimumOn}"/>
+                    </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,11 +263,14 @@
             <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:Segmented>
                 <Button

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

@@ -468,15 +468,24 @@
                             Margin="16"
                             CornerRadius="{ThemeResource ControlCornerRadius}"
                             IsLoading="{Binding HutaoCloudStatisticsViewModel.IsInitialized, Converter={StaticResource BoolNegationConverter}}"/>
-                        <shvc:HutaoStatisticsPanel
+                        <Grid
                             Margin="16"
-                            Spacing="16"
-                            Statistics="{Binding HutaoCloudStatisticsViewModel.Statistics}"
+                            ColumnSpacing="16"
                             Visibility="{Binding HutaoCloudStatisticsViewModel.IsInitialized, Converter={StaticResource BoolToVisibilityConverter}}">
                             <mxi:Interaction.Behaviors>
                                 <shcb:InvokeCommandOnLoadedBehavior Command="{Binding HutaoCloudStatisticsViewModel.OpenUICommand}"/>
                             </mxi:Interaction.Behaviors>
-                        </shvc:HutaoStatisticsPanel>
+                            <Grid.ColumnDefinitions>
+                                <ColumnDefinition/>
+                                <ColumnDefinition/>
+                                <ColumnDefinition/>
+                                <ColumnDefinition/>
+                            </Grid.ColumnDefinitions>
+                            <shvc:HutaoStatisticsCard Grid.Column="0" DataContext="{Binding HutaoCloudStatisticsViewModel.Statistics.AvatarEvent}"/>
+                            <shvc:HutaoStatisticsCard Grid.Column="1" DataContext="{Binding HutaoCloudStatisticsViewModel.Statistics.AvatarEvent2}"/>
+                            <shvc:HutaoStatisticsCard Grid.Column="2" DataContext="{Binding HutaoCloudStatisticsViewModel.Statistics.WeaponEvent}"/>
+                            <shvc:HutaoStatisticsCard Grid.Column="3" DataContext="{Binding HutaoCloudStatisticsViewModel.Statistics.Chronicled}"/>
+                        </Grid>
                     </Grid>
                 </PivotItem>
             </Pivot>

src/Snap.Hutao/Snap.Hutao/ViewModel/GachaLog/HutaoStatistics.cs

@@ -26,5 +26,5 @@ internal sealed class HutaoStatistics
     /// <summary>
     /// 集录祈愿
     /// </summary>
-    public HutaoWishSummary? Chronicled { get; set; }
+    public HutaoWishSummary Chronicled { get; set; } = default!;
 }

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

@@ -7,76 +7,76 @@ 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)
+            {
+                using (HttpResponseMessage response = await httpClient.SendAsync(message, HttpCompletionOption.ResponseHeadersRead).ConfigureAwait(false))
+                {
+                    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();
@@ -85,14 +85,13 @@ internal sealed class DownloadSummary : ObservableObject
                     }
 
                     long contentLength = response.Content.Headers.ContentLength ?? 0;
-            logger.LogInformation("Begin download, length: {length}", contentLength);
+                    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;
@@ -100,12 +99,15 @@ internal sealed class DownloadSummary : ObservableObject
                         }
                     }
                 }
+            }
+        }
         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,7 @@ using Snap.Hutao.Core;
 using Snap.Hutao.Core.Setting;
 using Snap.Hutao.Model;
 using Snap.Hutao.Service;
+using Snap.Hutao.Web.Hoyolab;
 using System.Collections.ObjectModel;
 using System.Globalization;
 
@@ -20,12 +21,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 +40,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 +64,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 +82,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 +100,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 +130,7 @@ internal sealed partial class GuideViewModel : Abstraction.ViewModel
         {
             if (SetProperty(ref isPrivacyPolicyAgreed, value))
             {
-                OnAgreeSateChanged();
+                OnAgreementStateChanged();
             }
         }
     }
@@ -121,7 +141,7 @@ internal sealed partial class GuideViewModel : Abstraction.ViewModel
         {
             if (SetProperty(ref isIssueReportAgreed, value))
             {
-                OnAgreeSateChanged();
+                OnAgreementStateChanged();
             }
         }
     }
@@ -132,14 +152,12 @@ internal sealed partial class GuideViewModel : Abstraction.ViewModel
         {
             if (SetProperty(ref isOpenSourceLicenseAgreed, value))
             {
-                OnAgreeSateChanged();
+                OnAgreementStateChanged();
             }
         }
     }
+    #endregion
 
-    /// <summary>
-    /// 下载信息
-    /// </summary>
     public ObservableCollection<DownloadSummary>? DownloadSummaries
     {
         get => downloadSummaries;
@@ -152,7 +170,7 @@ internal sealed partial class GuideViewModel : Abstraction.ViewModel
         ++State;
     }
 
-    private void OnAgreeSateChanged()
+    private void OnAgreementStateChanged()
     {
         IsNextOrCompleteButtonEnabled = IsTermOfServiceAgreed && IsPrivacyPolicyAgreed && IsIssueReportAgreed && IsOpenSourceLicenseAgreed;
     }
@@ -173,7 +191,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 },

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

@@ -0,0 +1,20 @@
+// 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-minimum", $"{LocalSetting.Get(SettingKeys.StaticResourceUseTrimmedArchive, false)}");
+    }
+}

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

@@ -0,0 +1,41 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.Core.Setting;
+using Snap.Hutao.Model;
+
+namespace Snap.Hutao.ViewModel.Guide;
+
+[Injection(InjectAs.Singleton)]
+internal sealed class StaticResourceOptions
+{
+    private readonly List<NameValue<StaticResourceQuality>> imageQualities = CollectionsNameValue.FromEnum<StaticResourceQuality>(q => q.GetLocalizedDescription());
+
+    private NameValue<StaticResourceQuality>? imageQuality;
+
+    public StaticResourceOptions()
+    {
+        ImageQuality = ImageQualities.First(q => q.Value == UnsafeLocalSetting.Get(SettingKeys.StaticResourceImageQuality, StaticResourceQuality.Raw));
+    }
+
+    public List<NameValue<StaticResourceQuality>> ImageQualities { get => imageQualities; }
+
+    public NameValue<StaticResourceQuality>? ImageQuality
+    {
+        get => imageQuality;
+        set
+        {
+            if (value is not null)
+            {
+                imageQuality = value;
+                UnsafeLocalSetting.Set(SettingKeys.StaticResourceImageQuality, value.Value);
+            }
+        }
+    }
+
+    public bool UseTrimmedArchive
+    {
+        get => LocalSetting.Get(SettingKeys.StaticResourceUseTrimmedArchive, false);
+        set => LocalSetting.Set(SettingKeys.StaticResourceUseTrimmedArchive, value);
+    }
+}

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/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/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())