remove blank spaces

fix #1632

.github/workflows/alpha.yml

@@ -29,7 +29,14 @@ on:
 
 jobs:
   build:
-    runs-on: self-hosted
+    runs-on: ${{ matrix.runner }}
+
+    strategy:
+      matrix:
+        runner:
+          - self-hosted
+          - windows-latest
+
     steps:
       - name: Checkout
         uses: actions/checkout@v4

.github/workflows/close_stale.yml

@@ -10,7 +10,7 @@ jobs:
       - uses: actions/stale@v9
         with:
           any-of-labels: 'needs-more-info,需要更多信息'
-          stale-issue-message: 'This issue is stale because it has been open 30 days with no activity. Remove stale label or comment or this will be closed in 3 days.'
+          stale-issue-message: 'This issue is stale because it has been open 7 days with no activity. Remove stale label or comment or this will be closed in 3 days.'
           days-before-stale: 7
           days-before-close: 3
           close-issue-reason: not_planned

README.md

@@ -17,7 +17,15 @@ You can follow the instructions in the [Quick Start](https://hut.ao/en/quick-sta
 
 ## 本地化翻译 / Localization
 
-[![zh-TW translation](https://img.shields.io/badge/dynamic/json?color=blue&label=zh-TW&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27zh-TW%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao) [![en translation](https://img.shields.io/badge/dynamic/json?color=blue&label=en&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27en%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao) [![id translation](https://img.shields.io/badge/dynamic/json?color=blue&label=id&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27id%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao) [![ja translation](https://img.shields.io/badge/dynamic/json?color=blue&label=ja&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27ja%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao) [![ko translation](https://img.shields.io/badge/dynamic/json?color=blue&label=ko&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27ko%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao) [![pt-PT translation](https://img.shields.io/badge/dynamic/json?color=blue&label=pt-PT&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27pt-PT%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao) [![ru translation](https://img.shields.io/badge/dynamic/json?color=blue&label=ru&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27ru%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+[![zh-TW translation](https://img.shields.io/badge/dynamic/json?color=blue&label=zh-TW&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27zh-TW%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+[![en translation](https://img.shields.io/badge/dynamic/json?color=blue&label=en&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27en%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+[![fr translation](https://img.shields.io/badge/dynamic/json?color=blue&label=fr&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27fr%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+[![id translation](https://img.shields.io/badge/dynamic/json?color=blue&label=id&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27id%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+[![ja translation](https://img.shields.io/badge/dynamic/json?color=blue&label=ja&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27ja%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+[![ko translation](https://img.shields.io/badge/dynamic/json?color=blue&label=ko&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27ko%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+[![pt-PT translation](https://img.shields.io/badge/dynamic/json?color=blue&label=pt-PT&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27pt-PT%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+[![ru translation](https://img.shields.io/badge/dynamic/json?color=blue&label=ru&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27ru%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+[![vi translation](https://img.shields.io/badge/dynamic/json?color=blue&label=vi&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27vi%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
 
 Snap Hutao 使用 [Crowdin](https://translate.hut.ao/) 作为客户端文本翻译平台，在该平台上你可以为你熟悉的语言提交翻译文本。我们感谢每一个为 Snap Hutao 做出贡献的社区成员，并且欢迎更多的朋友能参与到这个项目中。
 
@@ -46,13 +54,13 @@ Snap Hutao uses [Crowdin](https://translate.hut.ao/) as a client text translatio
 * [CommunityToolkit/dotnet](https://github.com/CommunityToolkit/dotnet)
 * [CommunityToolkit/Labs-Windows](https://github.com/CommunityToolkit/Labs-Windows)
 * [CommunityToolkit/Windows](https://github.com/CommunityToolkit/Windows)
-* [dahall/taskscheduler](https://github.com/dahall/taskscheduler)
 * [dotnet/efcore](https://github.com/dotnet/efcore)
 * [dotnet/runtime](https://github.com/dotnet/runtime)
 * [DotNetAnalyzers/StyleCopAnalyzers](https://github.com/DotNetAnalyzers/StyleCopAnalyzers)
 * [microsoft/vs-validation](https://github.com/microsoft/vs-validation)
 * [microsoft/WindowsAppSDK](https://github.com/microsoft/WindowsAppSDK)
 * [microsoft/microsoft-ui-xaml](https://github.com/microsoft/microsoft-ui-xaml)
+* [quartznet/quartznet](https://github.com/quartznet/quartznet)
 
 ### 支撑项目 / Supporter Project
 
@@ -64,9 +72,9 @@ Snap Hutao uses [Crowdin](https://translate.hut.ao/) as a client text translatio
 Snap Hutao is currently using sponsored software from the following service providers.
 
 | [![](https://www.netlify.com/v3/img/components/netlify-light.svg)](https://www.netlify.com/) | [![](https://support.crowdin.com/assets/logos/core-logo/svg/crowdin-core-logo-cDark.svg)](https://crowdin.com/) | [![](https://gitlab.cn/images/icons/logos/logo-121-75.svg)](https://gitlab.cn/) |
-|:----------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------:|
+|:-:|:-:|:-:|
-|              [![](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/73ae8b90-f3c7-4033-b2b7-f4126331ce66)](https://about.signpath.io)              |                        [![](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/49aed8ee-9f19-4a8a-998c-7b93ee286d65)](https://1password.com/)                         |  [![](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/ad121220-d2d3-4f49-b215-b6d063dc229d)](https://about.signpath.io)   |
+|[![](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/73ae8b90-f3c7-4033-b2b7-f4126331ce66)](https://about.signpath.io)|[![](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/49aed8ee-9f19-4a8a-998c-7b93ee286d65)](https://1password.com/)|[![](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/ad121220-d2d3-4f49-b215-b6d063dc229d)](https://www.digitalocean.com)|
-
+|[![jetbrains](https://github.com/DGP-Studio/Snap.Hutao/assets/36357191/4105772a-728a-4a84-9c6e-d713a5698a20)](https://www.jetbrains.com/opensource/)|||
 
 - Netlify provides document and home page hosting service for Snap Hutao
 
@@ -80,6 +88,8 @@ Snap Hutao is currently using sponsored software from the following service prov
   
 - DigitalOcean provides reliable cloud database for Snap Hutao database backup
 
+- Jetbrains provides powerful IDE for Snap Hutao infrastructure services coding
+
 ## 开发 / Development
 
 ![Snap.Hutao](https://repobeats.axiom.co/api/embed/f029553fbe0c60689b1710476ec8512452163fc9.svg)

build.cake

@@ -11,6 +11,15 @@ var version = "version";
 var repoDir = "repoDir";
 var outputPath = "outputPath";
 
+// Extension
+
+static ProcessArgumentBuilder AppendIf(this ProcessArgumentBuilder builder, string text, bool condition)
+{
+    return condition ? builder.Append(text) : builder;
+}
+
+// Properties
+
 string solution
 {
     get => System.IO.Path.Combine(repoDir, "src", "Snap.Hutao", "Snap.Hutao.sln");
@@ -157,6 +166,7 @@ Task("Build binary package")
                                             .Append("/p:AppxPackageSigningEnabled=false")
                                             .Append("/p:AppxBundle=Never")
                                             .Append("/p:AppxPackageOutput=" + outputPath)
+                                            .AppendIf("/p:AlphaConstants=IS_ALPHA_BUILD", !AppVeyor.IsRunningOnAppVeyor)
     };
 
     DotNetBuild(project, settings);

src/Snap.Hutao/Snap.Hutao.Test/BaseClassLibrary/TypeReflectionTest.cs

@@ -1,5 +1,4 @@
-using Microsoft.VisualStudio.TestTools.UnitTesting;
+using System;
-using System;
 
 namespace Snap.Hutao.Test.BaseClassLibrary;
 

src/Snap.Hutao/Snap.Hutao.Test/BaseClassLibrary/UnsafeAccessorTest.cs

@@ -16,7 +16,7 @@ public class UnsafeAccessorTest
     [UnsafeAccessor(UnsafeAccessorKind.Method, Name = "get_TestProperty")]
     private static extern int InternalGetInterfaceProperty(ITestInterface instance);
 
-    interface ITestInterface
+    internal interface ITestInterface
     {
         internal int TestProperty { get; }
     }

src/Snap.Hutao/Snap.Hutao.Test/RuntimeBehavior/UnsafeRuntimeBehaviorTest.cs

@@ -1,4 +1,5 @@
-using System.Collections.Generic;
+using System;
+using System.Collections.Generic;
 using System.Runtime.CompilerServices;
 using System.Runtime.InteropServices;
 
@@ -46,7 +47,14 @@ public sealed class UnsafeRuntimeBehaviorTest
         Assert.AreEqual(1212, testStruct.Value4);
     }
 
-
+    [TestMethod]
+    public unsafe void UnsafeUtf8StringReference()
+    {
+        void* ptr = Unsafe.AsPointer(ref MemoryMarshal.GetReference("test"u8));
+        GC.Collect(GC.MaxGeneration);
+        ReadOnlySpan<byte> bytes = MemoryMarshal.CreateReadOnlySpanFromNullTerminated((byte*)ptr);
+        Console.WriteLine(System.Text.Encoding.UTF8.GetString(bytes));
+    }
 
     private readonly struct TestStruct
     {

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

@@ -85,7 +85,7 @@ public sealed partial class App : Application
         }
         catch (Exception ex)
         {
-            System.Diagnostics.Debug.WriteLine(ex);
+            Debug.WriteLine(ex);
             Process.GetCurrentProcess().Kill();
         }
     }

src/Snap.Hutao/Snap.Hutao/Control/Collection/AdvancedCollectionView/VectorChangedEventArgs.cs

@@ -7,7 +7,7 @@ namespace Snap.Hutao.Control.Collection.AdvancedCollectionView;
 
 internal sealed class VectorChangedEventArgs : IVectorChangedEventArgs
 {
-    public VectorChangedEventArgs(CollectionChange cc, int index = -1, object item = null!)
+    public VectorChangedEventArgs(CollectionChange cc, int index = -1, object item = default!)
     {
         CollectionChange = cc;
         Index = (uint)index;

src/Snap.Hutao/Snap.Hutao/Control/DependencyValueConverter.cs

@@ -3,6 +3,7 @@
 
 using Microsoft.UI.Xaml;
 using Microsoft.UI.Xaml.Data;
+using Snap.Hutao.Core.ExceptionService;
 
 namespace Snap.Hutao.Control;
 
@@ -40,6 +41,6 @@ internal abstract class DependencyValueConverter<TFrom, TTo> : DependencyObject,
     /// <returns>源</returns>
     public virtual TFrom ConvertBack(TTo to)
     {
-        throw Must.NeverHappen();
+        throw HutaoException.NotSupported();
     }
 }

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

@@ -39,7 +39,6 @@ internal static class FrameworkElementExtension
         }
         catch (Exception ex)
         {
-
             ILogger? logger = service.GetRequiredService(typeof(ILogger<>).MakeGenericType([frameworkElement.GetType()])) as ILogger;
             logger?.LogError(ex, "Failed to initialize DataContext");
             throw;

src/Snap.Hutao/Snap.Hutao/Control/Helper/FrameworkElementHelper.cs

@@ -7,6 +7,8 @@ namespace Snap.Hutao.Control.Helper;
 
 [SuppressMessage("", "SH001")]
 [DependencyProperty("SquareLength", typeof(double), 0D, nameof(OnSquareLengthChanged), IsAttached = true, AttachedType = typeof(FrameworkElement))]
+[DependencyProperty("IsActualThemeBindingEnabled", typeof(bool), false, nameof(OnIsActualThemeBindingEnabled), IsAttached = true, AttachedType = typeof(FrameworkElement))]
+[DependencyProperty("ActualTheme", typeof(ElementTheme), ElementTheme.Default, IsAttached = true, AttachedType = typeof(FrameworkElement))]
 public sealed partial class FrameworkElementHelper
 {
     private static void OnSquareLengthChanged(DependencyObject dp, DependencyPropertyChangedEventArgs e)
@@ -15,4 +17,22 @@ public sealed partial class FrameworkElementHelper
         element.Width = (double)e.NewValue;
         element.Height = (double)e.NewValue;
     }
+
+    private static void OnIsActualThemeBindingEnabled(DependencyObject dp, DependencyPropertyChangedEventArgs e)
+    {
+        FrameworkElement element = (FrameworkElement)dp;
+        if ((bool)e.NewValue)
+        {
+            element.ActualThemeChanged += OnActualThemeChanged;
+        }
+        else
+        {
+            element.ActualThemeChanged -= OnActualThemeChanged;
+        }
+
+        static void OnActualThemeChanged(FrameworkElement sender, object args)
+        {
+            SetActualTheme(sender, sender.ActualTheme);
+        }
+    }
 }

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

@@ -1,8 +1,6 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
-using Microsoft.UI.Xaml.Media;
-using Microsoft.UI.Xaml.Media.Imaging;
 using Snap.Hutao.Control.Extension;
 using Snap.Hutao.Core.Caching;
 using Snap.Hutao.Core.ExceptionService;

src/Snap.Hutao/Snap.Hutao/Control/Image/Implementation/ImageExBase.cs

@@ -6,9 +6,6 @@ using Microsoft.UI.Composition;
 using Microsoft.UI.Xaml;
 using Microsoft.UI.Xaml.Media;
 using Microsoft.UI.Xaml.Media.Imaging;
-using Snap.Hutao.Win32;
-using System.IO;
-using Windows.Foundation;
 
 namespace Snap.Hutao.Control.Image.Implementation;
 

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

@@ -63,12 +63,12 @@ internal sealed partial class UniformStaggeredLayout : VirtualizingLayout
     /// <inheritdoc/>
     protected override Size MeasureOverride(VirtualizingLayoutContext context, Size availableSize)
     {
-        if (context.ItemCount == 0)
+        if (context.ItemCount is 0)
         {
             return new Size(availableSize.Width, 0);
         }
 
-        if ((context.RealizationRect.Width == 0) && (context.RealizationRect.Height == 0))
+        if ((context.RealizationRect.Width is 0) && (context.RealizationRect.Height is 0))
         {
             return new Size(availableSize.Width, 0.0f);
         }

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

@@ -0,0 +1,25 @@
+// Licensed to the .NET Fou// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.UI.Xaml;
+using Windows.Foundation;
+
+namespace Snap.Hutao.Control.Layout;
+
+internal sealed class WrapItem
+{
+    public WrapItem(int index)
+    {
+        Index = index;
+    }
+
+    public static Point EmptyPosition { get; } = new(float.NegativeInfinity, float.NegativeInfinity);
+
+    public int Index { get; }
+
+    public Size Size { get; set; } = Size.Empty;
+
+    public Point Position { get; set; } = EmptyPosition;
+
+    public UIElement? Element { get; set; }
+}

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

@@ -0,0 +1,220 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.UI.Xaml;
+using Microsoft.UI.Xaml.Controls;
+using System.Collections.Specialized;
+using Windows.Foundation;
+
+namespace Snap.Hutao.Control.Layout;
+
+[DependencyProperty("HorizontalSpacing", typeof(double), 0D, nameof(LayoutPropertyChanged))]
+[DependencyProperty("VerticalSpacing", typeof(double), 0D, nameof(LayoutPropertyChanged))]
+internal sealed partial class WrapLayout : VirtualizingLayout
+{
+    protected override void InitializeForContextCore(VirtualizingLayoutContext context)
+    {
+        context.LayoutState = new WrapLayoutState(context);
+    }
+
+    protected override void UninitializeForContextCore(VirtualizingLayoutContext context)
+    {
+        context.LayoutState = default;
+    }
+
+    protected override void OnItemsChangedCore(VirtualizingLayoutContext context, object source, NotifyCollectionChangedEventArgs args)
+    {
+        WrapLayoutState state = (WrapLayoutState)context.LayoutState;
+
+        switch (args.Action)
+        {
+            case NotifyCollectionChangedAction.Add:
+                state.RemoveFromIndex(args.NewStartingIndex);
+                break;
+
+            case NotifyCollectionChangedAction.Move:
+                int minIndex = Math.Min(args.NewStartingIndex, args.OldStartingIndex);
+                state.RemoveFromIndex(minIndex);
+                state.RecycleElementAt(args.OldStartingIndex);
+                state.RecycleElementAt(args.NewStartingIndex);
+                break;
+
+            case NotifyCollectionChangedAction.Remove:
+                state.RemoveFromIndex(args.OldStartingIndex);
+                break;
+
+            case NotifyCollectionChangedAction.Replace:
+                state.RemoveFromIndex(args.NewStartingIndex);
+                state.RecycleElementAt(args.NewStartingIndex);
+                break;
+
+            case NotifyCollectionChangedAction.Reset:
+                state.Clear();
+                break;
+        }
+
+        base.OnItemsChangedCore(context, source, args);
+    }
+
+    protected override Size MeasureOverride(VirtualizingLayoutContext context, Size availableSize)
+    {
+        if (context.ItemCount is 0)
+        {
+            return new Size(availableSize.Width, 0);
+        }
+
+        if ((context.RealizationRect.Width is 0) && (context.RealizationRect.Height is 0))
+        {
+            return new Size(availableSize.Width, 0.0f);
+        }
+
+        Size spacing = new(HorizontalSpacing, VerticalSpacing);
+
+        WrapLayoutState state = (WrapLayoutState)context.LayoutState;
+
+        if (spacing != state.Spacing || state.AvailableWidth != availableSize.Width)
+        {
+            state.ClearPositions();
+            state.Spacing = spacing;
+            state.AvailableWidth = availableSize.Width;
+        }
+
+        double currentHeight = 0;
+        Point itemPosition = default;
+        for (int i = 0; i < context.ItemCount; ++i)
+        {
+            bool itemMeasured = false;
+            WrapItem item = state.GetItemAt(i);
+            if (item.Size == Size.Empty)
+            {
+                item.Element = context.GetOrCreateElementAt(i);
+                item.Element.Measure(availableSize);
+                item.Size = item.Element.DesiredSize;
+                itemMeasured = true;
+            }
+
+            Size itemSize = item.Size;
+
+            if (item.Position == WrapItem.EmptyPosition)
+            {
+                if (availableSize.Width < itemPosition.X + itemSize.Width)
+                {
+                    // New Row
+                    itemPosition.X = 0;
+                    itemPosition.Y += currentHeight + spacing.Height;
+                    currentHeight = 0;
+                }
+
+                item.Position = itemPosition;
+            }
+
+            itemPosition = item.Position;
+
+            double bottom = itemPosition.Y + itemSize.Height;
+            if (bottom < context.RealizationRect.Top)
+            {
+                // Item is "above" the bounds
+                if (item.Element is not null)
+                {
+                    context.RecycleElement(item.Element);
+                    item.Element = default;
+                }
+
+                continue;
+            }
+            else if (itemPosition.Y > context.RealizationRect.Bottom)
+            {
+                // Item is "below" the bounds.
+                if (item.Element is not null)
+                {
+                    context.RecycleElement(item.Element);
+                    item.Element = default;
+                }
+
+                // We don't need to measure anything below the bounds
+                break;
+            }
+            else if (!itemMeasured)
+            {
+                // Always measure elements that are within the bounds
+                item.Element = context.GetOrCreateElementAt(i);
+                item.Element.Measure(availableSize);
+
+                itemSize = item.Element.DesiredSize;
+                if (itemSize != item.Size)
+                {
+                    // this item changed size; we need to recalculate layout for everything after this
+                    state.RemoveFromIndex(i + 1);
+                    item.Size = itemSize;
+
+                    // did the change make it go into the new row?
+                    if (availableSize.Width < itemPosition.X + itemSize.Width)
+                    {
+                        // New Row
+                        itemPosition.X = 0;
+                        itemPosition.Y += currentHeight + spacing.Height;
+                        currentHeight = 0;
+                    }
+
+                    item.Position = itemPosition;
+                }
+            }
+
+            itemPosition.X += itemSize.Width + spacing.Width;
+            currentHeight = Math.Max(itemSize.Height, currentHeight);
+        }
+
+        return new Size(double.IsInfinity(availableSize.Width) ? 0 : Math.Ceiling(availableSize.Width), state.GetHeight());
+    }
+
+    protected override Size ArrangeOverride(VirtualizingLayoutContext context, Size finalSize)
+    {
+        if (context.ItemCount > 0)
+        {
+            WrapLayoutState state = (WrapLayoutState)context.LayoutState;
+
+            for (int i = 0; i < context.ItemCount; ++i)
+            {
+                if (!ArrangeItem(context, state.GetItemAt(i)))
+                {
+                    break;
+                }
+            }
+        }
+
+        return finalSize;
+
+        static bool ArrangeItem(VirtualizingLayoutContext context, WrapItem item)
+        {
+            if (item.Size == Size.Empty || item.Position == WrapItem.EmptyPosition)
+            {
+                return false;
+            }
+
+            Size size = item.Size;
+            Point position = item.Position;
+
+            if (context.RealizationRect.Top <= position.Y + size.Height && position.Y <= context.RealizationRect.Bottom)
+            {
+                // place the item
+                UIElement child = context.GetOrCreateElementAt(item.Index);
+                child.Arrange(new Rect(position, size));
+            }
+            else if (position.Y > context.RealizationRect.Bottom)
+            {
+                return false;
+            }
+
+            return true;
+        }
+    }
+
+    private static void LayoutPropertyChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
+    {
+        if (d is WrapLayout layout)
+        {
+            layout.InvalidateMeasure();
+            layout.InvalidateArrange();
+        }
+    }
+}

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

@@ -0,0 +1,109 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.UI.Xaml.Controls;
+using System.Runtime.InteropServices;
+using Windows.Foundation;
+
+namespace Snap.Hutao.Control.Layout;
+
+internal sealed class WrapLayoutState
+{
+    private readonly List<WrapItem> items = [];
+    private readonly VirtualizingLayoutContext context;
+
+    public WrapLayoutState(VirtualizingLayoutContext context)
+    {
+        this.context = context;
+    }
+
+    public Orientation Orientation { get; private set; }
+
+    public Size Spacing { get; set; }
+
+    public double AvailableWidth { get; set; }
+
+    public WrapItem GetItemAt(int index)
+    {
+        ArgumentOutOfRangeException.ThrowIfNegative(index);
+
+        if (index <= (items.Count - 1))
+        {
+            return items[index];
+        }
+        else
+        {
+            WrapItem item = new(index);
+            items.Add(item);
+            return item;
+        }
+    }
+
+    public void Clear()
+    {
+        for (int i = 0; i < items.Count; i++)
+        {
+            RecycleElementAt(i);
+        }
+
+        items.Clear();
+    }
+
+    public void RemoveFromIndex(int index)
+    {
+        if (index >= items.Count)
+        {
+            // Item was added/removed but we haven't realized that far yet
+            return;
+        }
+
+        int numToRemove = items.Count - index;
+        items.RemoveRange(index, numToRemove);
+    }
+
+    public void ClearPositions()
+    {
+        foreach (ref readonly WrapItem item in CollectionsMarshal.AsSpan(items))
+        {
+            item.Position = WrapItem.EmptyPosition;
+        }
+    }
+
+    public double GetHeight()
+    {
+        if (items.Count is 0)
+        {
+            return 0;
+        }
+
+        Point? lastPosition = default;
+        double maxHeight = 0;
+
+        Span<WrapItem> itemSpan = CollectionsMarshal.AsSpan(items);
+        for (int i = items.Count - 1; i >= 0; --i)
+        {
+            ref readonly WrapItem item = ref itemSpan[i];
+
+            if (item.Position == WrapItem.EmptyPosition || item.Size == Size.Empty)
+            {
+                continue;
+            }
+
+            if (lastPosition is not null && lastPosition.Value.Y > item.Position.Y)
+            {
+                // This is a row above the last item.
+                break;
+            }
+
+            lastPosition = item.Position;
+            maxHeight = Math.Max(maxHeight, item.Size.Height);
+        }
+
+        return lastPosition?.Y + maxHeight ?? 0;
+    }
+
+    public void RecycleElementAt(int index)
+    {
+        context.RecycleElement(context.GetOrCreateElementAt(index));
+    }
+}

src/Snap.Hutao/Snap.Hutao/Control/Text/Syntax/MiHoYo/MiHoYoColorTextSyntax.cs

@@ -1,6 +1,8 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
+using Snap.Hutao.Core.ExceptionService;
+
 namespace Snap.Hutao.Control.Text.Syntax.MiHoYo;
 
 internal sealed class MiHoYoColorTextSyntax : MiHoYoXmlElementSyntax
@@ -27,7 +29,7 @@ internal sealed class MiHoYoColorTextSyntax : MiHoYoXmlElementSyntax
             {
                 MiHoYoColorKind.Rgba => new(Position.Start + 17, Position.End - 8),
                 MiHoYoColorKind.Rgb => new(Position.Start + 15, Position.End - 8),
-                _ => throw Must.NeverHappen(),
+                _ => throw HutaoException.NotSupported(),
             };
         }
     }
@@ -40,7 +42,7 @@ internal sealed class MiHoYoColorTextSyntax : MiHoYoXmlElementSyntax
             {
                 MiHoYoColorKind.Rgba => new(Position.Start + 8, Position.Start + 16),
                 MiHoYoColorKind.Rgb => new(Position.Start + 8, Position.Start + 14),
-                _ => throw Must.NeverHappen(),
+                _ => throw HutaoException.NotSupported(),
             };
         }
     }

src/Snap.Hutao/Snap.Hutao/Control/Text/Syntax/MiHoYo/MiHoYoSyntaxTree.cs

@@ -1,8 +1,11 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
+using Snap.Hutao.Core.ExceptionService;
+
 namespace Snap.Hutao.Control.Text.Syntax.MiHoYo;
 
+// TODO: Pooling syntax nodes to reduce memory allocation
 internal sealed class MiHoYoSyntaxTree
 {
     public MiHoYoSyntaxNode Root { get; set; } = default!;
@@ -75,7 +78,7 @@ internal sealed class MiHoYoSyntaxTree
                         {
                             17 => MiHoYoColorKind.Rgba,
                             15 => MiHoYoColorKind.Rgb,
-                            _ => throw Must.NeverHappen(),
+                            _ => throw HutaoException.NotSupported(),
                         };
 
                         TextPosition position = new(0, endOfXmlColorRightClosingAtUnprocessedContent);

src/Snap.Hutao/Snap.Hutao/Control/ValueConverter.cs

@@ -2,6 +2,7 @@
 // Licensed under the MIT license.
 
 using Microsoft.UI.Xaml.Data;
+using Snap.Hutao.Core.ExceptionService;
 
 namespace Snap.Hutao.Control;
 
@@ -39,6 +40,6 @@ internal abstract class ValueConverter<TFrom, TTo> : IValueConverter
     /// <returns>源</returns>
     public virtual TFrom ConvertBack(TTo to)
     {
-        throw Must.NeverHappen();
+        throw HutaoException.NotSupported();
     }
 }

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

@@ -2,13 +2,9 @@
 // Licensed under the MIT license.
 
 using CommunityToolkit.Mvvm.Messaging;
-using Microsoft.Extensions.DependencyInjection.Extensions;
 using Quartz;
 using Snap.Hutao.Core.Logging;
 using Snap.Hutao.Service;
-using Snap.Hutao.Service.DailyNote;
-using Snap.Hutao.Service.Job;
-using System.Collections.Specialized;
 using System.Globalization;
 using System.Runtime.CompilerServices;
 using Windows.Globalization;

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

@@ -1,22 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-namespace Snap.Hutao.Core.ExceptionService;
-
-/// <summary>
-/// 数据库损坏异常
-/// </summary>
-[HighQuality]
-[Obsolete("Use HutaoException instead")]
-internal sealed class DatabaseCorruptedException : Exception
-{
-    /// <summary>
-    /// 构造一个新的用户数据损坏异常
-    /// </summary>
-    /// <param name="message">消息</param>
-    /// <param name="innerException">内部错误</param>
-    public DatabaseCorruptedException(string message, Exception? innerException)
-        : base(SH.FormatCoreExceptionServiceDatabaseCorruptedMessage($"{message}\n{innerException?.Message}"), innerException)
-    {
-    }
-}

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

@@ -1,6 +1,8 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
+using System.Runtime.CompilerServices;
+
 namespace Snap.Hutao.Core.ExceptionService;
 
 internal sealed class HutaoException : Exception
@@ -11,11 +13,13 @@ internal sealed class HutaoException : Exception
     }
 
     [DoesNotReturn]
+    [MethodImpl(MethodImplOptions.NoInlining)]
     public static HutaoException Throw(string message, Exception? innerException = default)
     {
         throw new HutaoException(message, innerException);
     }
 
+    [MethodImpl(MethodImplOptions.NoInlining)]
     public static void ThrowIf([DoesNotReturnIf(true)] bool condition, string message, Exception? innerException = default)
     {
         if (condition)
@@ -24,6 +28,7 @@ internal sealed class HutaoException : Exception
         }
     }
 
+    [MethodImpl(MethodImplOptions.NoInlining)]
     public static void ThrowIfNot([DoesNotReturnIf(false)] bool condition, string message, Exception? innerException = default)
     {
         if (!condition)
@@ -33,18 +38,28 @@ internal sealed class HutaoException : Exception
     }
 
     [DoesNotReturn]
+    [MethodImpl(MethodImplOptions.NoInlining)]
+    public static ArgumentException Argument(string message, string? paramName)
+    {
+        throw new ArgumentException(message, paramName);
+    }
+
+    [DoesNotReturn]
+    [MethodImpl(MethodImplOptions.NoInlining)]
     public static HutaoException GachaStatisticsInvalidItemId(uint id, Exception? innerException = default)
     {
         throw new HutaoException(SH.FormatServiceGachaStatisticsFactoryItemIdInvalid(id), innerException);
     }
 
     [DoesNotReturn]
+    [MethodImpl(MethodImplOptions.NoInlining)]
     public static HutaoException UserdataCorrupted(string message, Exception? innerException = default)
     {
         throw new HutaoException(message, innerException);
     }
 
     [DoesNotReturn]
+    [MethodImpl(MethodImplOptions.NoInlining)]
     public static InvalidCastException InvalidCast<TFrom, TTo>(string name, Exception? innerException = default)
     {
         string message = $"This instance of '{typeof(TFrom).FullName}' '{name}' doesn't implement '{typeof(TTo).FullName}'";
@@ -52,18 +67,21 @@ internal sealed class HutaoException : Exception
     }
 
     [DoesNotReturn]
+    [MethodImpl(MethodImplOptions.NoInlining)]
     public static InvalidOperationException InvalidOperation(string message, Exception? innerException = default)
     {
         throw new InvalidOperationException(message, innerException);
     }
 
     [DoesNotReturn]
+    [MethodImpl(MethodImplOptions.NoInlining)]
     public static NotSupportedException NotSupported(string? message = default, Exception? innerException = default)
     {
         throw new NotSupportedException(message, innerException);
     }
 
     [DoesNotReturn]
+    [MethodImpl(MethodImplOptions.NoInlining)]
     public static OperationCanceledException OperationCanceled(string message, Exception? innerException = default)
     {
         throw new OperationCanceledException(message, innerException);

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

@@ -1,23 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-namespace Snap.Hutao.Core.ExceptionService;
-
-/// <summary>
-/// 运行环境异常
-/// 用户的计算机中的某些设置不符合要求
-/// </summary>
-[HighQuality]
-[Obsolete("Use HutaoException instead")]
-internal sealed class RuntimeEnvironmentException : Exception
-{
-    /// <summary>
-    /// 构造一个新的运行环境异常
-    /// </summary>
-    /// <param name="message">消息</param>
-    /// <param name="innerException">内部错误</param>
-    public RuntimeEnvironmentException(string message, Exception? innerException)
-        : base($"{message}\n{innerException?.Message}", innerException)
-    {
-    }
-}

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

@@ -1,9 +1,6 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
-using Snap.Hutao.Service.Game;
-using Snap.Hutao.Service.Game.Package;
-using System.IO;
 using System.Runtime.CompilerServices;
 
 namespace Snap.Hutao.Core.ExceptionService;
@@ -22,92 +19,4 @@ internal static class ThrowHelper
     {
         throw new ArgumentException(message, paramName);
     }
-
-    [DoesNotReturn]
-    [MethodImpl(MethodImplOptions.NoInlining)]
-    public static DatabaseCorruptedException DatabaseCorrupted(string message, Exception? inner)
-    {
-        throw new DatabaseCorruptedException(message, inner);
-    }
-
-    [DoesNotReturn]
-    [MethodImpl(MethodImplOptions.NoInlining)]
-    public static GameFileOperationException GameFileOperation(string message, Exception? inner)
-    {
-        throw new GameFileOperationException(message, inner);
-    }
-
-    [DoesNotReturn]
-    [MethodImpl(MethodImplOptions.NoInlining)]
-    public static InvalidDataException InvalidData(string message, Exception? inner = default)
-    {
-        throw new InvalidDataException(message, inner);
-    }
-
-    [MethodImpl(MethodImplOptions.NoInlining)]
-    public static void InvalidDataIf([DoesNotReturnIf(true)] bool condition, string message, Exception? inner = default)
-    {
-        if (condition)
-        {
-            throw new InvalidDataException(message, inner);
-        }
-    }
-
-    [DoesNotReturn]
-    [MethodImpl(MethodImplOptions.NoInlining)]
-    public static InvalidOperationException InvalidOperation(string message, Exception? inner = default)
-    {
-        throw new InvalidOperationException(message, inner);
-    }
-
-    [DoesNotReturn]
-    [MethodImpl(MethodImplOptions.NoInlining)]
-    public static NotSupportedException NotSupported()
-    {
-        throw new NotSupportedException();
-    }
-
-    [DoesNotReturn]
-    [MethodImpl(MethodImplOptions.NoInlining)]
-    public static NotSupportedException NotSupported(string message)
-    {
-        throw new NotSupportedException(message);
-    }
-
-    [MethodImpl(MethodImplOptions.NoInlining)]
-    public static void NotSupportedIf(bool condition, string message)
-    {
-        if (condition)
-        {
-            throw new NotSupportedException(message);
-        }
-    }
-
-    [DoesNotReturn]
-    [MethodImpl(MethodImplOptions.NoInlining)]
-    public static OperationCanceledException OperationCanceled(string message, Exception? inner = default)
-    {
-        throw new OperationCanceledException(message, inner);
-    }
-
-    [DoesNotReturn]
-    [MethodImpl(MethodImplOptions.NoInlining)]
-    public static PackageConvertException PackageConvert(string message, Exception? inner = default)
-    {
-        throw new PackageConvertException(message, inner);
-    }
-
-    [DoesNotReturn]
-    [MethodImpl(MethodImplOptions.NoInlining)]
-    public static RuntimeEnvironmentException RuntimeEnvironment(string message, Exception? inner)
-    {
-        throw new RuntimeEnvironmentException(message, inner);
-    }
-
-    [DoesNotReturn]
-    [MethodImpl(MethodImplOptions.NoInlining)]
-    public static UserdataCorruptedException UserdataCorrupted(string message, Exception? inner)
-    {
-        throw new UserdataCorruptedException(message, inner);
-    }
 }

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

@@ -1,22 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-namespace Snap.Hutao.Core.ExceptionService;
-
-/// <summary>
-/// 用户数据损坏异常
-/// </summary>
-[HighQuality]
-[Obsolete("Use HutaoException instead")]
-internal sealed class UserdataCorruptedException : Exception
-{
-    /// <summary>
-    /// 构造一个新的用户数据损坏异常
-    /// </summary>
-    /// <param name="message">消息</param>
-    /// <param name="innerException">内部错误</param>
-    public UserdataCorruptedException(string message, Exception? innerException)
-        : base(SH.FormatCoreExceptionServiceUserdataCorruptedMessage($"{message}\n{innerException?.Message}"), innerException)
-    {
-    }
-}

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

@@ -78,7 +78,7 @@ internal sealed class HttpShardCopyWorker<TStatus> : IDisposable
                 using (HttpResponseMessage response = await httpClient.SendAsync(request, HttpCompletionOption.ResponseHeadersRead, token).ConfigureAwait(false))
                 {
                     response.EnsureSuccessStatusCode();
-                    using (IMemoryOwner<byte> memoryOwner = MemoryPool<byte>.Shared.Rent())
+                    using (IMemoryOwner<byte> memoryOwner = MemoryPool<byte>.Shared.Rent(bufferSize))
                     {
                         Memory<byte> buffer = memoryOwner.Memory;
                         using (Stream stream = await response.Content.ReadAsStreamAsync(token).ConfigureAwait(false))

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

@@ -27,6 +27,7 @@ internal sealed class StreamReaderWriter : IDisposable
     }
 
     /// <inheritdoc cref="StreamWriter.WriteAsync(string?)"/>
+    [SuppressMessage("", "SH003")]
     public Task WriteAsync(string value)
     {
         return writer.WriteAsync(value);

src/Snap.Hutao/Snap.Hutao/Core/Json/Converter/SeparatorCommaInt32EnumerableConverter.cs

@@ -22,7 +22,7 @@ internal sealed class SeparatorCommaInt32EnumerableConverter : JsonConverter<IEn
             return EnumerateNumbers(source);
         }
 
-        return Enumerable.Empty<int>();
+        return [];
     }
 
     /// <inheritdoc/>

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

@@ -44,6 +44,7 @@ internal sealed partial class AppActivation : IAppActivation, IAppActivationActi
     private readonly IServiceProvider serviceProvider;
     private readonly ICurrentXamlWindowReference currentWindowReference;
     private readonly ITaskContext taskContext;
+
     private readonly SemaphoreSlim activateSemaphore = new(1);
 
     /// <inheritdoc/>
@@ -65,16 +66,27 @@ internal sealed partial class AppActivation : IAppActivation, IAppActivationActi
         serviceProvider.GetRequiredService<PrivateNamedPipeServer>().RunAsync().SafeForget();
         ToastNotificationManagerCompat.OnActivated += NotificationActivate;
 
-        serviceProvider.GetRequiredService<HotKeyOptions>().RegisterAll();
+        using (activateSemaphore.Enter())
-        if (serviceProvider.GetRequiredService<AppOptions>().IsNotifyIconEnabled)
         {
-            XamlWindowLifetime.ApplicationLaunchedWithNotifyIcon = true;
+            // TODO: Introduced in 1.10.2, remove in later version
-            serviceProvider.GetRequiredService<App>().DispatcherShutdownMode = DispatcherShutdownMode.OnExplicitShutdown;
+            serviceProvider.GetRequiredService<IScheduleTaskInterop>().UnregisterAllTasks();
-            _ = serviceProvider.GetRequiredService<NotifyIconController>();
-        }
 
-        serviceProvider.GetRequiredService<IScheduleTaskInterop>().UnregisterAllTasks();
+            if (UnsafeLocalSetting.Get(SettingKeys.Major1Minor10Revision0GuideState, GuideState.Language) < GuideState.Completed)
-        serviceProvider.GetRequiredService<IQuartzService>().StartAsync(default).SafeForget();
+            {
+                return;
+            }
+
+            serviceProvider.GetRequiredService<HotKeyOptions>().RegisterAll();
+
+            if (serviceProvider.GetRequiredService<AppOptions>().IsNotifyIconEnabled)
+            {
+                XamlWindowLifetime.ApplicationLaunchedWithNotifyIcon = true;
+                serviceProvider.GetRequiredService<App>().DispatcherShutdownMode = DispatcherShutdownMode.OnExplicitShutdown;
+                _ = serviceProvider.GetRequiredService<NotifyIconController>();
+            }
+
+            serviceProvider.GetRequiredService<IQuartzService>().StartAsync(default).SafeForget();
+        }
     }
 
     public void Dispose()
@@ -172,7 +184,6 @@ internal sealed partial class AppActivation : IAppActivation, IAppActivationActi
             }
         }
 
-        // If it's the first time launch, show the guide window anyway.
         if (UnsafeLocalSetting.Get(SettingKeys.Major1Minor10Revision0GuideState, GuideState.Language) < GuideState.Completed)
         {
             await taskContext.SwitchToMainThreadAsync();

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

@@ -4,7 +4,6 @@
 using Microsoft.UI.Xaml;
 using Snap.Hutao.Core.Windowing;
 using Snap.Hutao.Win32.Foundation;
-using WinRT.Interop;
 
 namespace Snap.Hutao.Core.LifeCycle;
 

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

@@ -83,9 +83,10 @@ internal static class LoggerExtension
         logger.LogColorized(logLevel, 0, exception, message, args);
     }
 
+    [SuppressMessage("", "CA2254")]
     public static void LogColorized(this ILogger logger, LogLevel logLevel, EventId eventId, Exception? exception, LogMessage message, params LogArgument[] args)
     {
-        string colorizedMessage = Colorize(message, args, out object?[] outArgs)!;
+        string? colorizedMessage = Colorize(message, args, out object?[] outArgs);
         logger.Log(logLevel, eventId, exception, colorizedMessage, outArgs);
     }
 

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

@@ -2,9 +2,7 @@
 // Licensed under the MIT license.
 
 using Microsoft.Win32.TaskScheduler;
-using System.IO;
 using System.Runtime.InteropServices;
-using Windows.Storage;
 
 namespace Snap.Hutao.Core.Shell;
 

src/Snap.Hutao/Snap.Hutao/Core/Threading/AsyncBarrier.cs

@@ -25,7 +25,7 @@ internal class AsyncBarrier
     /// <param name="participants">The number of participants.</param>
     public AsyncBarrier(int participants)
     {
-        Must.Range(participants >= 1, "Participants of AsyncBarrier can not be less than 1");
+        ArgumentOutOfRangeException.ThrowIfLessThan(participants, 1, "Participants of AsyncBarrier can not be less than 1");
         participantCount = participants;
 
         // Allocate the stack so no resizing is necessary.

src/Snap.Hutao/Snap.Hutao/Core/Threading/SemaphoreSlimExtension.cs

@@ -15,7 +15,7 @@ internal static class SemaphoreSlimExtension
         }
         catch (ObjectDisposedException ex)
         {
-            ThrowHelper.OperationCanceled(SH.CoreThreadingSemaphoreSlimDisposed, ex);
+            HutaoException.OperationCanceled(SH.CoreThreadingSemaphoreSlimDisposed, ex);
         }
 
         return new SemaphoreSlimToken(semaphoreSlim);
@@ -29,7 +29,7 @@ internal static class SemaphoreSlimExtension
         }
         catch (ObjectDisposedException ex)
         {
-            ThrowHelper.OperationCanceled(SH.CoreThreadingSemaphoreSlimDisposed, ex);
+            HutaoException.OperationCanceled(SH.CoreThreadingSemaphoreSlimDisposed, ex);
         }
 
         return new SemaphoreSlimToken(semaphoreSlim);

src/Snap.Hutao/Snap.Hutao/Core/Validation/Must.cs

@@ -1,56 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using System.Runtime.CompilerServices;
-
-namespace Snap.Hutao.Core.Validation;
-
-/// <summary>
-/// 封装验证方法,简化微软验证
-/// </summary>
-[HighQuality]
-[Obsolete("Use HutaoException instead")]
-internal static class Must
-{
-    /// <summary>
-    /// Throws an <see cref="ArgumentException"/> if a condition does not evaluate to true.
-    /// </summary>
-    /// <param name="condition">The condition to check.</param>
-    /// <param name="message">message</param>
-    /// <param name="parameterName">The name of the parameter to blame in the exception, if thrown.</param>
-    [MethodImpl(MethodImplOptions.NoInlining)]
-    public static void Argument([DoesNotReturnIf(false)] bool condition, string? message, [CallerArgumentExpression(nameof(condition))] string? parameterName = null)
-    {
-        if (!condition)
-        {
-            throw new ArgumentException(message, parameterName);
-        }
-    }
-
-    /// <summary>
-    /// Throws an <see cref="ArgumentOutOfRangeException"/> if a condition does not evaluate to true.
-    /// </summary>
-    /// <param name="condition">The condition to check.</param>
-    /// <param name="message">message</param>
-    /// <param name="parameterName">The name of the parameter to blame in the exception, if thrown.</param>
-    [MethodImpl(MethodImplOptions.NoInlining)]
-    public static void Range([DoesNotReturnIf(false)] bool condition, string? message, [CallerArgumentExpression(nameof(condition))] string? parameterName = null)
-    {
-        if (!condition)
-        {
-            throw new ArgumentOutOfRangeException(parameterName, message);
-        }
-    }
-
-    /// <summary>
-    /// Unconditionally throws an <see cref="NotSupportedException"/>.
-    /// </summary>
-    /// <param name="context">上下文</param>
-    /// <returns>Nothing. This method always throws.</returns>
-    [DoesNotReturn]
-    [MethodImpl(MethodImplOptions.NoInlining)]
-    public static Exception NeverHappen(string? context = null)
-    {
-        throw new NotSupportedException(context);
-    }
-}

src/Snap.Hutao/Snap.Hutao/Core/Windowing/Backdrop/InputActiveDesktopAcrylicBackdrop.cs

@@ -10,7 +10,7 @@ using System.Collections.Concurrent;
 namespace Snap.Hutao.Core.Windowing.Backdrop;
 
 // https://github.com/microsoft/microsoft-ui-xaml/blob/winui3/release/1.5-stable/controls/dev/Materials/DesktopAcrylicBackdrop/DesktopAcrylicBackdrop.cpp
-internal sealed class InputActiveDesktopAcrylicBackdrop : SystemBackdrop
+internal sealed partial class InputActiveDesktopAcrylicBackdrop : SystemBackdrop
 {
     private readonly ConcurrentDictionary<ICompositionSupportsSystemBackdrop, DesktopAcrylicController> controllers = [];
 
@@ -18,11 +18,10 @@ internal sealed class InputActiveDesktopAcrylicBackdrop : SystemBackdrop
     {
         base.OnTargetConnected(target, xamlRoot);
 
-        DesktopAcrylicController newController = new();
         SystemBackdropConfiguration configuration = GetDefaultSystemBackdropConfiguration(target, xamlRoot);
-
         configuration.IsInputActive = true;
 
+        DesktopAcrylicController newController = new();
         newController.AddSystemBackdropTarget(target);
         newController.SetSystemBackdropConfiguration(configuration);
         controllers.TryAdd(target, newController);

src/Snap.Hutao/Snap.Hutao/Core/Windowing/Backdrop/SystemBackdropDesktopWindowXamlSourceAccess.cs

@@ -24,6 +24,8 @@ internal sealed class SystemBackdropDesktopWindowXamlSourceAccess : SystemBackdr
         get; private set;
     }
 
+    public SystemBackdrop? InnerBackdrop { get => innerBackdrop; }
+
     protected override void OnTargetConnected(ICompositionSupportsSystemBackdrop target, XamlRoot xamlRoot)
     {
         DesktopWindowXamlSource = DesktopWindowXamlSource.FromAbi(target.As<IInspectable>().ThisPtr);

src/Snap.Hutao/Snap.Hutao/Core/Windowing/Backdrop/TransparentBackdrop.cs

@@ -29,25 +29,26 @@ internal sealed class TransparentBackdrop : SystemBackdrop, IBackdropNeedEraseBa
 
     internal Windows.UI.Composition.Compositor Compositor
     {
-        get
+        get => LazyInitializer.EnsureInitialized(ref compositor, ref compositorLock, () =>
         {
-            return LazyInitializer.EnsureInitialized(ref compositor, ref compositorLock, () =>
+            DispatcherQueue.EnsureSystemDispatcherQueue();
-            {
+            return new Windows.UI.Composition.Compositor();
-                DispatcherQueue.EnsureSystemDispatcherQueue();
+        });
-                return new Windows.UI.Composition.Compositor();
-            });
-        }
     }
 
-    protected override void OnTargetConnected(ICompositionSupportsSystemBackdrop connectedTarget, XamlRoot xamlRoot)
+    protected override void OnTargetConnected(ICompositionSupportsSystemBackdrop target, XamlRoot xamlRoot)
     {
+        base.OnTargetConnected(target, xamlRoot);
+
         brush ??= Compositor.CreateColorBrush(tintColor);
-        connectedTarget.SystemBackdrop = brush;
+        target.SystemBackdrop = brush;
     }
 
-    protected override void OnTargetDisconnected(ICompositionSupportsSystemBackdrop disconnectedTarget)
+    protected override void OnTargetDisconnected(ICompositionSupportsSystemBackdrop target)
     {
-        disconnectedTarget.SystemBackdrop = null;
+        base.OnTargetDisconnected(target);
+
+        target.SystemBackdrop = null;
 
         if (compositorLock is not null)
         {

src/Snap.Hutao/Snap.Hutao/Core/Windowing/HotKey/HotKeyCombination.cs

@@ -2,7 +2,6 @@
 // Licensed under the MIT license.
 
 using CommunityToolkit.Mvvm.ComponentModel;
-using Snap.Hutao.Core.LifeCycle;
 using Snap.Hutao.Core.Setting;
 using Snap.Hutao.Model;
 using Snap.Hutao.Service.Notification;
@@ -27,7 +26,6 @@ internal sealed class HotKeyCombination : ObservableObject
 
     private bool registered;
 
-    private bool modifierHasWindows;
     private bool modifierHasControl;
     private bool modifierHasShift;
     private bool modifierHasAlt;
@@ -36,6 +34,7 @@ internal sealed class HotKeyCombination : ObservableObject
     private VirtualKey key;
     private bool isEnabled;
 
+    [SuppressMessage("", "SH002")]
     public HotKeyCombination(IServiceProvider serviceProvider, HWND hwnd, string settingKey, int hotKeyId, HOT_KEY_MODIFIERS defaultModifiers, VirtualKey defaultKey)
     {
         infoBarService = serviceProvider.GetRequiredService<IInfoBarService>();
@@ -52,7 +51,10 @@ internal sealed class HotKeyCombination : ObservableObject
             isEnabled = LocalSetting.Get($"{settingKey}.IsEnabled", true);
 
             HotKeyParameter actual = LocalSettingGetHotKeyParameter();
-            modifiers = actual.Modifiers;
+
+            // HOT_KEY_MODIFIERS.MOD_WIN is reversed for use by the OS.
+            // It should not be used by the application.
+            modifiers = actual.Modifiers & ~HOT_KEY_MODIFIERS.MOD_WIN;
             InitializeModifiersCompositionFields();
             key = actual.Key;
 
@@ -61,18 +63,6 @@ internal sealed class HotKeyCombination : ObservableObject
     }
 
     #region Binding Property
-    public bool ModifierHasWindows
-    {
-        get => modifierHasWindows;
-        set
-        {
-            if (SetProperty(ref modifierHasWindows, value))
-            {
-                UpdateModifiers();
-            }
-        }
-    }
-
     public bool ModifierHasControl
     {
         get => modifierHasControl;
@@ -218,11 +208,6 @@ internal sealed class HotKeyCombination : ObservableObject
     {
         StringBuilder stringBuilder = new();
 
-        if (Modifiers.HasFlag(HOT_KEY_MODIFIERS.MOD_WIN))
-        {
-            stringBuilder.Append("Win").Append(" + ");
-        }
-
         if (Modifiers.HasFlag(HOT_KEY_MODIFIERS.MOD_CONTROL))
         {
             stringBuilder.Append("Ctrl").Append(" + ");
@@ -247,11 +232,6 @@ internal sealed class HotKeyCombination : ObservableObject
     {
         HOT_KEY_MODIFIERS modifiers = default;
 
-        if (ModifierHasWindows)
-        {
-            modifiers |= HOT_KEY_MODIFIERS.MOD_WIN;
-        }
-
         if (ModifierHasControl)
         {
             modifiers |= HOT_KEY_MODIFIERS.MOD_CONTROL;
@@ -272,11 +252,6 @@ internal sealed class HotKeyCombination : ObservableObject
 
     private void InitializeModifiersCompositionFields()
     {
-        if (Modifiers.HasFlag(HOT_KEY_MODIFIERS.MOD_WIN))
-        {
-            modifierHasWindows = true;
-        }
-
         if (Modifiers.HasFlag(HOT_KEY_MODIFIERS.MOD_CONTROL))
         {
             modifierHasControl = true;

src/Snap.Hutao/Snap.Hutao/Core/Windowing/HotKey/HotKeyMessageWindow.cs

@@ -33,7 +33,7 @@ internal sealed class HotKeyMessageWindow : IDisposable
             atom = RegisterClassW(&wc);
         }
 
-        ArgumentOutOfRangeException.ThrowIfEqual<ushort>(atom, 0);
+        ArgumentOutOfRangeException.ThrowIfZero(atom);
 
         HWND = CreateWindowExW(0, WindowClassName, WindowClassName, 0, 0, 0, 0, 0, default, default, default, default);
 

src/Snap.Hutao/Snap.Hutao/Core/Windowing/NotifyIcon/NotifyIconContextMenu.xaml

@@ -2,8 +2,10 @@
     x:Class="Snap.Hutao.Core.Windowing.NotifyIcon.NotifyIconContextMenu"
     xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
     xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+    xmlns:cw="using:CommunityToolkit.WinUI"
     xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
     xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+    xmlns:shch="using:Snap.Hutao.Control.Helper"
     xmlns:shcm="using:Snap.Hutao.Control.Markup"
     xmlns:shcwb="using:Snap.Hutao.Core.Windowing.Backdrop"
     xmlns:shv="using:Snap.Hutao.ViewModel"
@@ -30,7 +32,10 @@
             <RowDefinition/>
             <RowDefinition/>
         </Grid.RowDefinitions>
-        <TextBlock Margin="8" Text="{Binding Title}"/>
+        <TextBlock
+            Margin="8"
+            Style="{StaticResource BodyTextBlockStyle}"
+            Text="{Binding Title}"/>
         <Grid Grid.Row="1" Background="{ThemeResource CardBackgroundFillColorSecondaryBrush}">
             <StackPanel
                 Margin="4,0"

src/Snap.Hutao/Snap.Hutao/Core/Windowing/NotifyIcon/NotifyIconController.cs

@@ -30,7 +30,8 @@ internal sealed class NotifyIconController : IDisposable
         icon = new(iconFile.Path);
         id = Unsafe.As<byte, Guid>(ref MemoryMarshal.GetArrayDataReference(MD5.HashData(Encoding.UTF8.GetBytes(iconFile.Path))));
 
-        xamlHostWindow = new();
+        xamlHostWindow = new(serviceProvider);
+        xamlHostWindow.MoveAndResize(default);
 
         messageWindow = new()
         {
@@ -46,8 +47,6 @@ internal sealed class NotifyIconController : IDisposable
         messageWindow.Dispose();
         NotifyIconMethods.Delete(id);
         icon.Dispose();
-
-        xamlHostWindow.Dispose();
     }
 
     public RECT GetRect()

src/Snap.Hutao/Snap.Hutao/Core/Windowing/NotifyIcon/NotifyIconMessageWindow.cs

@@ -38,7 +38,7 @@ internal sealed class NotifyIconMessageWindow : IDisposable
             atom = RegisterClassW(&wc);
         }
 
-        ArgumentOutOfRangeException.ThrowIfEqual<ushort>(atom, 0);
+        ArgumentOutOfRangeException.ThrowIfZero(atom);
 
         // https://learn.microsoft.com/zh,cn/windows/win32/shell/taskbar#taskbar,creation,notification
         WM_TASKBARCREATED = RegisterWindowMessageW("TaskbarCreated");
@@ -145,7 +145,9 @@ internal sealed class NotifyIconMessageWindow : IDisposable
 
     private readonly struct LPARAM2
     {
+#pragma warning disable CS0649
         public readonly uint Low;
         public readonly uint High;
+#pragma warning restore CS0649
     }
 }

src/Snap.Hutao/Snap.Hutao/Core/Windowing/NotifyIcon/NotifyIconXamlHostWindow.cs

@@ -15,11 +15,9 @@ using static Snap.Hutao.Win32.User32;
 
 namespace Snap.Hutao.Core.Windowing.NotifyIcon;
 
-internal sealed class NotifyIconXamlHostWindow : Window, IDisposable, IWindowNeedEraseBackground
+internal sealed class NotifyIconXamlHostWindow : Window, IWindowNeedEraseBackground
 {
-    private readonly XamlWindowSubclass subclass;
+    public NotifyIconXamlHostWindow(IServiceProvider serviceProvider)
-
-    public NotifyIconXamlHostWindow()
     {
         Content = new Border();
 
@@ -36,10 +34,7 @@ internal sealed class NotifyIconXamlHostWindow : Window, IDisposable, IWindowNee
             presenter.SetBorderAndTitleBar(false, false);
         }
 
-        subclass = new(this);
+        this.InitializeController(serviceProvider);
-        subclass.Initialize();
-
-        Activate();
     }
 
     public void ShowFlyoutAt(FlyoutBase flyout, Point point, RECT icon)
@@ -53,7 +48,7 @@ internal sealed class NotifyIconXamlHostWindow : Window, IDisposable, IWindowNee
         ShowWindow(hwnd, SHOW_WINDOW_CMD.SW_NORMAL);
         SetForegroundWindow(hwnd);
 
-        AppWindow.MoveAndResize(StructMarshal.RectInt32(icon));
+        MoveAndResize(icon);
         flyout.ShowAt(Content, new()
         {
             Placement = FlyoutPlacementMode.Auto,
@@ -61,8 +56,8 @@ internal sealed class NotifyIconXamlHostWindow : Window, IDisposable, IWindowNee
         });
     }
 
-    public void Dispose()
+    public void MoveAndResize(RECT icon)
     {
-        subclass.Dispose();
+        AppWindow.MoveAndResize(StructMarshal.RectInt32(icon));
     }
 }

src/Snap.Hutao/Snap.Hutao/Core/Windowing/WindowExtension.cs

@@ -76,13 +76,17 @@ internal static class WindowExtension
         ShowWindow(GetWindowHandle(window), SHOW_WINDOW_CMD.SW_HIDE);
     }
 
-    public static void SetLayered(this Window window)
+    public static void SetLayered(this Window window, bool full = true)
     {
         HWND hwnd = (HWND)WindowNative.GetWindowHandle(window);
         nint style = GetWindowLongPtrW(hwnd, WINDOW_LONG_PTR_INDEX.GWL_EXSTYLE);
         style |= (nint)WINDOW_EX_STYLE.WS_EX_LAYERED;
         SetWindowLongPtrW(hwnd, WINDOW_LONG_PTR_INDEX.GWL_EXSTYLE, style);
-        SetLayeredWindowAttributes(hwnd, RGB(0, 0, 0), 0, LAYERED_WINDOW_ATTRIBUTES_FLAGS.LWA_COLORKEY | LAYERED_WINDOW_ATTRIBUTES_FLAGS.LWA_ALPHA);
+
+        if (full)
+        {
+            SetLayeredWindowAttributes(hwnd, RGB(0, 0, 0), 0, LAYERED_WINDOW_ATTRIBUTES_FLAGS.LWA_COLORKEY | LAYERED_WINDOW_ATTRIBUTES_FLAGS.LWA_ALPHA);
+        }
     }
 
     public static unsafe void BringToForeground(this Window window)

src/Snap.Hutao/Snap.Hutao/Core/Windowing/XamlWindowController.cs

@@ -104,9 +104,7 @@ internal sealed class XamlWindowController
             args.Handled = true;
             window.Hide();
 
-            RECT iconRect = serviceProvider.GetRequiredService<NotifyIconController>().GetRect();
+            if (!IsNotifyIconVisible())
-            RECT primaryRect = StructMarshal.RECT(DisplayArea.Primary.OuterBounds);
-            if (!IntersectRect(out _, in primaryRect, in iconRect))
             {
                 new ToastContentBuilder()
                     .AddText(SH.CoreWindowingNotifyIconPromotedHint)
@@ -133,6 +131,28 @@ internal sealed class XamlWindowController
         }
     }
 
+    private unsafe bool IsNotifyIconVisible()
+    {
+        RECT iconRect = serviceProvider.GetRequiredService<NotifyIconController>().GetRect();
+
+        if (UniversalApiContract.IsPresent(WindowsVersion.Windows11))
+        {
+            RECT primaryRect = StructMarshal.RECT(DisplayArea.Primary.OuterBounds);
+            return IntersectRect(out _, in primaryRect, in iconRect);
+        }
+
+        HWND shellTrayWnd = FindWindowExW(default, default, "Shell_TrayWnd", default);
+        HWND trayNotifyWnd = FindWindowExW(shellTrayWnd, default, "TrayNotifyWnd", default);
+        HWND button = FindWindowExW(trayNotifyWnd, default, "Button", default);
+
+        if (GetWindowRect(button, out RECT buttonRect))
+        {
+            return !EqualRect(in buttonRect, in iconRect);
+        }
+
+        return false;
+    }
+
     #region SystemBackdrop & ElementTheme
 
     private void OnOptionsPropertyChanged(object? sender, PropertyChangedEventArgs e)

src/Snap.Hutao/Snap.Hutao/Core/Windowing/XamlWindowNonRudeHWND.cs

@@ -12,6 +12,7 @@ internal sealed class XamlWindowNonRudeHWND : IDisposable
     private const string NonRudeHWND = "NonRudeHWND";
     private readonly HWND hwnd;
 
+    [SuppressMessage("", "SH002")]
     public XamlWindowNonRudeHWND(HWND hwnd)
     {
         this.hwnd = hwnd;

src/Snap.Hutao/Snap.Hutao/Core/Windowing/XamlWindowSubclass.cs

@@ -5,12 +5,10 @@ using Microsoft.UI.Windowing;
 using Microsoft.UI.Xaml;
 using Snap.Hutao.Core.Windowing.Abstraction;
 using Snap.Hutao.Core.Windowing.Backdrop;
-using Snap.Hutao.Core.Windowing.NotifyIcon;
 using Snap.Hutao.Win32;
 using Snap.Hutao.Win32.Foundation;
 using Snap.Hutao.Win32.UI.Shell;
 using Snap.Hutao.Win32.UI.WindowsAndMessaging;
-using System.Diagnostics;
 using System.Runtime.CompilerServices;
 using System.Runtime.InteropServices;
 using static Snap.Hutao.Win32.ComCtl32;
@@ -87,7 +85,9 @@ internal sealed class XamlWindowSubclass : IDisposable
 
             case WM_ERASEBKGND:
                 {
-                    if (state.window is IWindowNeedEraseBackground || state.window.SystemBackdrop is IBackdropNeedEraseBackground)
+                    if (state.window is IWindowNeedEraseBackground ||
+                        state.window.SystemBackdrop is IBackdropNeedEraseBackground ||
+                        state.window.SystemBackdrop is SystemBackdropDesktopWindowXamlSourceAccess { InnerBackdrop: IBackdropNeedEraseBackground })
                     {
                         return (LRESULT)(int)BOOL.TRUE;
                     }

src/Snap.Hutao/Snap.Hutao/Factory/Progress/ProgressFactory.cs

@@ -15,7 +15,7 @@ internal sealed partial class ProgressFactory : IProgressFactory
     {
         if (taskContext is not ITaskContextUnsafe @unsafe)
         {
-            throw ThrowHelper.NotSupported();
+            throw HutaoException.NotSupported();
         }
 
         return new DispatcherQueueProgress<T>(handler, @unsafe.DispatcherQueue);

src/Snap.Hutao/Snap.Hutao/GlobalUsing.cs

@@ -14,7 +14,6 @@ global using Snap.Hutao.Core.Annotation;
 global using Snap.Hutao.Core.DependencyInjection;
 global using Snap.Hutao.Core.DependencyInjection.Annotation;
 global using Snap.Hutao.Core.Threading;
-global using Snap.Hutao.Core.Validation;
 global using Snap.Hutao.Extension;
 global using Snap.Hutao.Resource.Localization;
 

src/Snap.Hutao/Snap.Hutao/Model/Calculable/CalculableSkill.cs

@@ -3,6 +3,7 @@
 
 using CommunityToolkit.Mvvm.ComponentModel;
 using Snap.Hutao.Core.Abstraction;
+using Snap.Hutao.Core.ExceptionService;
 using Snap.Hutao.Core.Setting;
 using Snap.Hutao.Model.Intrinsic;
 using Snap.Hutao.Model.Metadata.Avatar;
@@ -97,7 +98,7 @@ internal sealed class CalculableSkill
             SkillType.A => SettingKeys.CultivationAvatarSkillACurrent,
             SkillType.E => SettingKeys.CultivationAvatarSkillECurrent,
             SkillType.Q => SettingKeys.CultivationAvatarSkillQCurrent,
-            _ => throw Must.NeverHappen(),
+            _ => throw HutaoException.NotSupported(),
         };
     }
 
@@ -108,7 +109,7 @@ internal sealed class CalculableSkill
             SkillType.A => SettingKeys.CultivationAvatarSkillATarget,
             SkillType.E => SettingKeys.CultivationAvatarSkillETarget,
             SkillType.Q => SettingKeys.CultivationAvatarSkillQTarget,
-            _ => throw Must.NeverHappen(),
+            _ => throw HutaoException.NotSupported(),
         };
     }
 }

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

@@ -2,6 +2,7 @@
 // Licensed under the MIT license.
 
 using Snap.Hutao.Core.Abstraction;
+using Snap.Hutao.Core.ExceptionService;
 using Snap.Hutao.Model.Entity.Primitive;
 using Snap.Hutao.Service.Cultivation;
 using System.ComponentModel.DataAnnotations;
@@ -63,7 +64,7 @@ internal sealed class CultivateEntryLevelInformation : IMappingFrom<CultivateEnt
                 WeaponLevelFrom = source.WeaponLevelFrom,
                 WeaponLevelTo = source.WeaponLevelTo,
             },
-            _ => throw Must.NeverHappen($"不支持的养成类型{type}"),
+            _ => throw HutaoException.NotSupported($"不支持的养成类型{type}"),
         };
     }
 }

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

@@ -4,7 +4,6 @@
 using CommunityToolkit.Mvvm.ComponentModel;
 using Snap.Hutao.Core.Abstraction;
 using Snap.Hutao.Model.Entity.Abstraction;
-using Snap.Hutao.Model.Primitive;
 using Snap.Hutao.ViewModel.DailyNote;
 using Snap.Hutao.ViewModel.User;
 using Snap.Hutao.Web.Hoyolab.Takumi.Binding;

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

@@ -20,7 +20,7 @@ internal sealed class AppDbContextDesignTimeFactory : IDesignTimeDbContextFactor
         string userdataDbName = @"D:\Hutao\Userdata.db";
         return AppDbContext.Create(default!, $"Data Source={userdataDbName}");
 #else
-        throw Must.NeverHappen();
+        throw Core.ExceptionService.HutaoException.NotSupported();
 #endif
     }
 }

src/Snap.Hutao/Snap.Hutao/Model/Intrinsic/Frozen/IntrinsicFrozen.cs

@@ -11,25 +11,25 @@ namespace Snap.Hutao.Model.Intrinsic.Frozen;
 [HighQuality]
 internal static class IntrinsicFrozen
 {
-    public static FrozenSet<string> AssociationTypes { get; } = Enum.GetValues<AssociationType>().Select(e => e.GetLocalizedDescriptionOrDefault()).OfType<string>().ToFrozenSet();
+    public static FrozenSet<string> AssociationTypes { get; } = NamesFromEnum<AssociationType>(e => e.GetLocalizedDescriptionOrDefault());
 
-    public static FrozenSet<NameValue<AssociationType>> AssociationTypeNameValues { get; } = Enum.GetValues<AssociationType>().Select(e => new NameValue<AssociationType>(e.GetLocalizedDescriptionOrDefault()!, e)).Where(nv => !string.IsNullOrEmpty(nv.Name)).ToFrozenSet();
+    public static FrozenSet<NameValue<AssociationType>> AssociationTypeNameValues { get; } = NameValuesFromEnum<AssociationType>(e => e.GetLocalizedDescriptionOrDefault());
 
-    public static FrozenSet<string> WeaponTypes { get; } = Enum.GetValues<WeaponType>().Select(e => e.GetLocalizedDescriptionOrDefault()).OfType<string>().ToFrozenSet();
+    public static FrozenSet<string> WeaponTypes { get; } = NamesFromEnum<WeaponType>(e => e.GetLocalizedDescriptionOrDefault());
 
-    public static FrozenSet<NameValue<WeaponType>> WeaponTypeNameValues { get; } = Enum.GetValues<WeaponType>().Select(e => new NameValue<WeaponType>(e.GetLocalizedDescriptionOrDefault()!, e)).Where(nv => !string.IsNullOrEmpty(nv.Name)).ToFrozenSet();
+    public static FrozenSet<NameValue<WeaponType>> WeaponTypeNameValues { get; } = NameValuesFromEnum<WeaponType>(e => e.GetLocalizedDescriptionOrDefault());
 
-    public static FrozenSet<string> ItemQualities { get; } = Enum.GetValues<QualityType>().Select(e => e.GetLocalizedDescriptionOrDefault()).OfType<string>().ToFrozenSet();
+    public static FrozenSet<string> ItemQualities { get; } = NamesFromEnum<QualityType>(e => e.GetLocalizedDescriptionOrDefault());
 
-    public static FrozenSet<NameValue<QualityType>> ItemQualityNameValues { get; } = Enum.GetValues<QualityType>().Select(e => new NameValue<QualityType>(e.GetLocalizedDescriptionOrDefault()!, e)).Where(nv => !string.IsNullOrEmpty(nv.Name)).ToFrozenSet();
+    public static FrozenSet<NameValue<QualityType>> ItemQualityNameValues { get; } = NameValuesFromEnum<QualityType>(e => e.GetLocalizedDescriptionOrDefault());
 
-    public static FrozenSet<string> BodyTypes { get; } = Enum.GetValues<BodyType>().Select(e => e.GetLocalizedDescriptionOrDefault()).OfType<string>().ToFrozenSet();
+    public static FrozenSet<string> BodyTypes { get; } = NamesFromEnum<BodyType>(e => e.GetLocalizedDescriptionOrDefault());
 
-    public static FrozenSet<NameValue<BodyType>> BodyTypeNameValues { get; } = Enum.GetValues<BodyType>().Select(e => new NameValue<BodyType>(e.GetLocalizedDescriptionOrDefault()!, e)).Where(nv => !string.IsNullOrEmpty(nv.Name)).ToFrozenSet();
+    public static FrozenSet<NameValue<BodyType>> BodyTypeNameValues { get; } = NameValuesFromEnum<BodyType>(e => e.GetLocalizedDescriptionOrDefault());
 
-    public static FrozenSet<string> FightProperties { get; } = Enum.GetValues<FightProperty>().Select(e => e.GetLocalizedDescriptionOrDefault()).OfType<string>().ToFrozenSet();
+    public static FrozenSet<string> FightProperties { get; } = NamesFromEnum<FightProperty>(e => e.GetLocalizedDescriptionOrDefault());
 
-    public static FrozenSet<NameValue<FightProperty>> FightPropertyNameValues { get; } = Enum.GetValues<FightProperty>().Select(e => new NameValue<FightProperty>(e.GetLocalizedDescriptionOrDefault()!, e)).Where(nv => !string.IsNullOrEmpty(nv.Name)).ToFrozenSet();
+    public static FrozenSet<NameValue<FightProperty>> FightPropertyNameValues { get; } = NameValuesFromEnum<FightProperty>(e => e.GetLocalizedDescriptionOrDefault());
 
     public static FrozenSet<string> ElementNames { get; } = FrozenSet.ToFrozenSet(
     [
@@ -63,4 +63,50 @@ internal static class IntrinsicFrozen
         SH.ModelMetadataMaterialWeaponEnhancementMaterial,
         SH.ModelMetadataMaterialWeaponAscensionMaterial,
     ]);
+
+    private static FrozenSet<string> NamesFromEnum<TEnum>(Func<TEnum, string?> selector)
+        where TEnum : struct, Enum
+    {
+        return NamesFromEnumValues(Enum.GetValues<TEnum>(), selector);
+    }
+
+    private static FrozenSet<string> NamesFromEnumValues<TEnum>(TEnum[] values, Func<TEnum, string?> selector)
+    {
+        return NotNull(values, selector).ToFrozenSet();
+
+        static IEnumerable<string> NotNull(TEnum[] values, Func<TEnum, string?> selector)
+        {
+            foreach (TEnum value in values)
+            {
+                string? name = selector(value);
+                if (!string.IsNullOrEmpty(name))
+                {
+                    yield return name;
+                }
+            }
+        }
+    }
+
+    private static FrozenSet<NameValue<TEnum>> NameValuesFromEnum<TEnum>(Func<TEnum, string?> selector)
+        where TEnum : struct, Enum
+    {
+        return NameValuesFromEnumValues(Enum.GetValues<TEnum>(), selector);
+    }
+
+    private static FrozenSet<NameValue<TEnum>> NameValuesFromEnumValues<TEnum>(TEnum[] values, Func<TEnum, string?> selector)
+    {
+        return NotNull(values, selector).ToFrozenSet();
+
+        static IEnumerable<NameValue<TEnum>> NotNull(TEnum[] values, Func<TEnum, string?> selector)
+        {
+            foreach (TEnum value in values)
+            {
+                string? name = selector(value);
+                if (!string.IsNullOrEmpty(name))
+                {
+                    yield return new(name, value);
+                }
+            }
+        }
+    }
 }

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

@@ -2,6 +2,7 @@
 // Licensed under the MIT license.
 
 using Snap.Hutao.Control;
+using Snap.Hutao.Core.ExceptionService;
 using Snap.Hutao.Model.Intrinsic;
 
 namespace Snap.Hutao.Model.Metadata.Converter;
@@ -21,7 +22,7 @@ internal sealed class AssociationTypeIconConverter : ValueConverter<AssociationT
             AssociationType.ASSOC_TYPE_FONTAINE => "Fontaine",
             AssociationType.ASSOC_TYPE_NATLAN => default,
             AssociationType.ASSOC_TYPE_SNEZHNAYA => default,
-            _ => throw Must.NeverHappen(),
+            _ => throw HutaoException.NotSupported(),
         };
 
         return association is null

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

@@ -68,7 +68,7 @@ internal sealed partial class DescriptionsParametersDescriptor : ValueConverter<
             }
             else
             {
-                ThrowHelper.InvalidOperation($"ParameterFormat failed, value: `{desc}`", default);
+                HutaoException.InvalidOperation($"ParameterFormat failed, value: `{desc}`", default);
             }
         }
 

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

@@ -2,6 +2,7 @@
 // Licensed under the MIT license.
 
 using Snap.Hutao.Control;
+using Snap.Hutao.Core.ExceptionService;
 using Snap.Hutao.Model.Intrinsic;
 using System.Collections.Frozen;
 
@@ -41,7 +42,7 @@ internal sealed class WeaponTypeIconConverter : ValueConverter<WeaponType, Uri>
             WeaponType.WEAPON_POLE => "03",
             WeaponType.WEAPON_CLAYMORE => "04",
             WeaponType.WEAPON_CATALYST => "Catalyst_MD",
-            _ => throw Must.NeverHappen(),
+            _ => throw HutaoException.NotSupported(),
         };
 
         return Web.HutaoEndpoints.StaticRaw("Skill", $"Skill_A_{weapon}.png").ToUri();

src/Snap.Hutao/Snap.Hutao/Package.appxmanifest

@@ -13,7 +13,7 @@
   <Identity
     Name="60568DGPStudio.SnapHutao"
     Publisher="CN=35C8E923-85DF-49A7-9172-B39DC6312C52"
-    Version="1.10.1.0" />
+    Version="1.10.2.0" />
 
   <Properties>
     <DisplayName>Snap Hutao</DisplayName>

src/Snap.Hutao/Snap.Hutao/Package.development.appxmanifest

@@ -13,7 +13,7 @@
   <Identity
     Name="60568DGPStudio.SnapHutaoDev"
     Publisher="CN=35C8E923-85DF-49A7-9172-B39DC6312C52"
-    Version="1.10.1.0" />
+    Version="1.10.2.0" />
 
   <Properties>
     <DisplayName>Snap Hutao Dev</DisplayName>

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

@@ -2,13 +2,13 @@
 // Licensed under the MIT license.
 
 using Microsoft.UI.Xaml;
-using Snap.Hutao.Core.Windowing.NotifyIcon;
 using System.Runtime.CompilerServices;
 using System.Runtime.InteropServices;
 using WinRT;
 
 // Visible to test project.
 [assembly: InternalsVisibleTo("Snap.Hutao.Test")]
+[assembly: DisableRuntimeMarshalling]
 
 namespace Snap.Hutao;
 

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

@@ -1568,6 +1568,12 @@
   <data name="ViewModelCultivationProjectInvalidName" xml:space="preserve">
     <value>不能添加名称无效的计划</value>
   </data>
+  <data name="ViewModelCultivationRemoveProjectContent" xml:space="preserve">
+    <value>此操作不可逆，此计划的养成物品与背包材料将会丢失</value>
+  </data>
+  <data name="ViewModelCultivationRemoveProjectTitle" xml:space="preserve">
+    <value>确认要删除当前计划吗？</value>
+  </data>
   <data name="ViewModelDailyNoteConfigWebhookUrlComplete" xml:space="preserve">
     <value>实时便笺 Webhook Url 配置成功</value>
   </data>
@@ -1958,6 +1964,9 @@
   <data name="ViewPageDailyNoteNotificationSetting" xml:space="preserve">
     <value>通知设置</value>
   </data>
+  <data name="ViewPageDailyNoteNotificationUnavailableHint" xml:space="preserve">
+    <value>胡桃的通知权限已被关闭</value>
+  </data>
   <data name="ViewPageDailyNoteRefresh" xml:space="preserve">
     <value>立即刷新</value>
   </data>
@@ -1988,6 +1997,9 @@
   <data name="ViewPageDailyNoteSettingRefreshHeader" xml:space="preserve">
     <value>刷新</value>
   </data>
+  <data name="ViewPageDailyNoteSettingRefreshNotifyIconDisabledHint" xml:space="preserve">
+    <value>未启用通知区域图标，关闭窗口后自动刷新将不会执行</value>
+  </data>
   <data name="ViewPageDailyNoteSlientModeDescription" xml:space="preserve">
     <value>在我游玩原神时不通知我</value>
   </data>
@@ -3024,7 +3036,7 @@
     <value>武器资料</value>
   </data>
   <data name="WebAnnouncementMatchPermanentActivityTime" xml:space="preserve">
-    <value>(?:〓活动时间〓|〓任务开放时间〓).*?(\d\.\d)版本更新(?:完成|)后永久开放</value>
+    <value>(?:(?:〓活动时间〓|〓任务开放时间〓).*?(\d\.\d)版本更新(?:完成|)|&amp;lt;t class=\"t_(?:gl|lc)\".*?&amp;gt;(.*?)&amp;lt;/t&amp;gt;)后永久开放</value>
   </data>
   <data name="WebAnnouncementMatchPersistentActivityTime" xml:space="preserve">
     <value>〓活动时间〓.*?(\d\.\d)版本期间持续开放</value>
@@ -3245,6 +3257,9 @@
   <data name="WebResponseRequestExceptionFormat" xml:space="preserve">
     <value>[{0}] 中的 [{1}] 网络请求异常，请稍后再试</value>
   </data>
+  <data name="WebResponseSignInErrorHint" xml:space="preserve">
+    <value>登录失败，请前往 HoYoLAB 初始化账号，原始消息：{0}</value>
+  </data>
   <data name="WindowIdentifyMonitorHeader" xml:space="preserve">
     <value>显示器编号</value>
   </data>

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

@@ -152,6 +152,8 @@ internal sealed partial class AnnouncementService : IAnnouncementService
                     announcement.StartTime = versionStartTime;
                     continue;
                 }
+
+                announcement.StartTime = UnsafeDateTimeOffset.ParseDateTime(permanent.Groups[2].ValueSpan, offset);
             }
 
             if (AnnouncementRegex.PersistentActivityAfterUpdateTimeRegex.Match(announcement.Content) is { Success: true } persistent)

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

@@ -32,7 +32,7 @@ internal sealed partial class AvatarInfoDbBulkOperation
 
     public async ValueTask<List<EntityAvatarInfo>> UpdateDbAvatarInfosByShowcaseAsync(string uid, IEnumerable<EnkaAvatarInfo> webInfos, CancellationToken token)
     {
-        List<EntityAvatarInfo> dbInfos = await avatarInfoDbService.GetAvatarInfoListByUidAsync(uid).ConfigureAwait(false);
+        List<EntityAvatarInfo> dbInfos = await avatarInfoDbService.GetAvatarInfoListByUidAsync(uid, token).ConfigureAwait(false);
         EnsureItemsAvatarIdUnique(ref dbInfos, uid, out Dictionary<AvatarId, EntityAvatarInfo> dbInfoMap);
 
         using (IServiceScope scope = serviceProvider.CreateScope())
@@ -50,14 +50,14 @@ internal sealed partial class AvatarInfoDbBulkOperation
                 AddOrUpdateAvatarInfo(entity, uid, appDbContext, webInfo);
             }
 
-            return await avatarInfoDbService.GetAvatarInfoListByUidAsync(uid).ConfigureAwait(false);
+            return await avatarInfoDbService.GetAvatarInfoListByUidAsync(uid, token).ConfigureAwait(false);
         }
     }
 
     public async ValueTask<List<EntityAvatarInfo>> UpdateDbAvatarInfosByGameRecordCharacterAsync(UserAndUid userAndUid, CancellationToken token)
     {
         string uid = userAndUid.Uid.Value;
-        List<EntityAvatarInfo> dbInfos = await avatarInfoDbService.GetAvatarInfoListByUidAsync(uid).ConfigureAwait(false);
+        List<EntityAvatarInfo> dbInfos = await avatarInfoDbService.GetAvatarInfoListByUidAsync(uid, token).ConfigureAwait(false);
         EnsureItemsAvatarIdUnique(ref dbInfos, uid, out Dictionary<AvatarId, EntityAvatarInfo> dbInfoMap);
 
         using (IServiceScope scope = serviceProvider.CreateScope())
@@ -103,14 +103,14 @@ internal sealed partial class AvatarInfoDbBulkOperation
         }
 
     Return:
-        return await avatarInfoDbService.GetAvatarInfoListByUidAsync(uid).ConfigureAwait(false);
+        return await avatarInfoDbService.GetAvatarInfoListByUidAsync(uid, token).ConfigureAwait(false);
     }
 
     public async ValueTask<List<EntityAvatarInfo>> UpdateDbAvatarInfosByCalculateAvatarDetailAsync(UserAndUid userAndUid, CancellationToken token)
     {
         token.ThrowIfCancellationRequested();
         string uid = userAndUid.Uid.Value;
-        List<EntityAvatarInfo> dbInfos = await avatarInfoDbService.GetAvatarInfoListByUidAsync(uid).ConfigureAwait(false);
+        List<EntityAvatarInfo> dbInfos = await avatarInfoDbService.GetAvatarInfoListByUidAsync(uid, token).ConfigureAwait(false);
         EnsureItemsAvatarIdUnique(ref dbInfos, uid, out Dictionary<AvatarId, EntityAvatarInfo> dbInfoMap);
 
         using (IServiceScope scope = serviceProvider.CreateScope())
@@ -146,7 +146,7 @@ internal sealed partial class AvatarInfoDbBulkOperation
             }
         }
 
-        return await avatarInfoDbService.GetAvatarInfoListByUidAsync(uid).ConfigureAwait(false);
+        return await avatarInfoDbService.GetAvatarInfoListByUidAsync(uid, token).ConfigureAwait(false);
     }
 
     [MethodImpl(MethodImplOptions.AggressiveInlining)]

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

@@ -32,6 +32,7 @@ internal static class AvatarViewBuilderExtension
         return builder;
     }
 
+    [SuppressMessage("", "SH002")]
     public static TBuilder SetCalculatorRefreshTimeFormat<TBuilder>(this TBuilder builder, DateTimeOffset refreshTime, Func<object?, string> format, string defaultValue)
         where TBuilder : IAvatarViewBuilder
     {
@@ -116,6 +117,7 @@ internal static class AvatarViewBuilderExtension
         return builder.Configure(b => b.View.FetterLevel = level);
     }
 
+    [SuppressMessage("", "SH002")]
     public static TBuilder SetGameRecordRefreshTimeFormat<TBuilder>(this TBuilder builder, DateTimeOffset refreshTime, Func<object?, string> format, string defaultValue)
         where TBuilder : IAvatarViewBuilder
     {
@@ -128,6 +130,7 @@ internal static class AvatarViewBuilderExtension
         return builder.Configure(b => b.View.GameRecordRefreshTimeFormat = gameRecordRefreshTimeFormat);
     }
 
+    [SuppressMessage("", "SH002")]
     public static TBuilder SetId<TBuilder>(this TBuilder builder, AvatarId id)
         where TBuilder : IAvatarViewBuilder
     {
@@ -175,6 +178,7 @@ internal static class AvatarViewBuilderExtension
         return builder.Configure(b => b.View.Reliquaries = reliquaries);
     }
 
+    [SuppressMessage("", "SH002")]
     public static TBuilder SetShowcaseRefreshTimeFormat<TBuilder>(this TBuilder builder, DateTimeOffset refreshTime, Func<object?, string> format, string defaultValue)
         where TBuilder : IAvatarViewBuilder
     {

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

@@ -43,6 +43,7 @@ internal static class WeaponViewBuilderExtension
         return builder.SetIcon<TBuilder, WeaponView>(icon);
     }
 
+    [SuppressMessage("", "SH002")]
     public static TBuilder SetId<TBuilder>(this TBuilder builder, WeaponId id)
         where TBuilder : IWeaponViewBuilder
     {

src/Snap.Hutao/Snap.Hutao/Service/Cultivation/MaterialIdComparer.cs

@@ -12,11 +12,13 @@ internal sealed class MaterialIdComparer : IComparer<MaterialId>
 
     public static MaterialIdComparer Shared { get => LazyInitializer.EnsureInitialized(ref shared, ref syncRoot, () => new()); }
 
+    [SuppressMessage("", "SH002")]
     public int Compare(MaterialId x, MaterialId y)
     {
         return Transform(x).CompareTo(Transform(y));
     }
 
+    [SuppressMessage("", "SH002")]
     private static uint Transform(MaterialId value)
     {
         return value.Value switch

src/Snap.Hutao/Snap.Hutao/Service/DailyNote/DailyNoteNotificationOperation.cs

@@ -48,29 +48,9 @@ internal sealed partial class DailyNoteNotificationOperation
             return;
         }
 
-        string? attribution = SH.ServiceDailyNoteNotifierAttribution;
+        string attribution = entry.UserGameRole is not null
-
+            ? entry.UserGameRole.ToString()
-        if (entry.UserGameRole is not null)
+            : await GetUserUidAsync(entry).ConfigureAwait(false);
-        {
-            attribution = entry.UserGameRole.ToString();
-        }
-        else
-        {
-            Response<ListWrapper<UserGameRole>> rolesResponse;
-            using (IServiceScope scope = serviceScopeFactory.CreateScope())
-            {
-                BindingClient bindingClient = scope.ServiceProvider.GetRequiredService<BindingClient>();
-                rolesResponse = await bindingClient
-                    .GetUserGameRolesOverseaAwareAsync(entry.User)
-                    .ConfigureAwait(false);
-            }
-
-            if (rolesResponse.IsOk())
-            {
-                List<UserGameRole> roles = rolesResponse.Data.List;
-                attribution = roles.SingleOrDefault(r => r.GameUid == entry.Uid)?.ToString() ?? ToastAttributionUnknown;
-            }
-        }
 
         ToastContentBuilder builder = new ToastContentBuilder()
             .AddHeader(ToastHeaderIdArgument, SH.ServiceDailyNoteNotifierTitle, ToastHeaderIdArgument)
@@ -130,4 +110,24 @@ internal sealed partial class DailyNoteNotificationOperation
         // Prevent notify when we are in game && silent mode.
         return options.IsSilentWhenPlayingGame && gameService.IsGameRunning();
     }
+
+    private async ValueTask<string> GetUserUidAsync(DailyNoteEntry entry)
+    {
+        Response<ListWrapper<UserGameRole>> rolesResponse;
+        using (IServiceScope scope = serviceScopeFactory.CreateScope())
+        {
+            BindingClient bindingClient = scope.ServiceProvider.GetRequiredService<BindingClient>();
+            rolesResponse = await bindingClient
+                .GetUserGameRolesOverseaAwareAsync(entry.User)
+                .ConfigureAwait(false);
+        }
+
+        if (rolesResponse.IsOk())
+        {
+            List<UserGameRole> roles = rolesResponse.Data.List;
+            return roles.SingleOrDefault(r => r.GameUid == entry.Uid)?.ToString() ?? ToastAttributionUnknown;
+        }
+
+        return SH.ServiceDailyNoteNotifierAttribution;
+    }
 }

src/Snap.Hutao/Snap.Hutao/Service/DailyNote/DailyNoteService.cs

@@ -54,6 +54,7 @@ internal sealed partial class DailyNoteService : IDailyNoteService, IRecipient<U
         DailyNoteEntry newEntry = DailyNoteEntry.From(userAndUid);
 
         Web.Response.Response<WebDailyNote> dailyNoteResponse;
+        DailyNoteMetadataContext context;
         using (IServiceScope scope = serviceProvider.CreateScope())
         {
             IGameRecordClient gameRecordClient = scope.ServiceProvider
@@ -63,6 +64,8 @@ internal sealed partial class DailyNoteService : IDailyNoteService, IRecipient<U
             dailyNoteResponse = await gameRecordClient
                 .GetDailyNoteAsync(userAndUid, token)
                 .ConfigureAwait(false);
+
+            context = await scope.GetRequiredService<IMetadataService>().GetContextAsync<DailyNoteMetadataContext>(token).ConfigureAwait(false);
         }
 
         if (dailyNoteResponse.IsOk())
@@ -71,6 +74,7 @@ internal sealed partial class DailyNoteService : IDailyNoteService, IRecipient<U
         }
 
         newEntry.UserGameRole = userService.GetUserGameRoleByUid(roleUid);
+        newEntry.ArchonQuestView = DailyNoteArchonQuestView.Create(newEntry.DailyNote, context.Chapters);
         await dailyNoteDbService.AddDailyNoteEntryAsync(newEntry, token).ConfigureAwait(false);
 
         newEntry.User = userAndUid.User;

src/Snap.Hutao/Snap.Hutao/Service/DailyNote/NotifySuppression/NotifySuppressionContext.cs

@@ -18,6 +18,7 @@ internal sealed class NotifySuppressionContext : INotifySuppressionContext
 
     public DailyNoteEntry Entry { get => entry; }
 
+    [SuppressMessage("", "SH002")]
     public void Add(DailyNoteNotifyInfo info)
     {
         infos.Add(info);

src/Snap.Hutao/Snap.Hutao/Service/DailyNote/NotifySuppression/NotifySuppressionInvoker.cs

@@ -18,6 +18,7 @@ internal static class NotifySuppressionInvoker
         context.Invoke<ExpeditionNotifySuppressionChecker>();
     }
 
+    [SuppressMessage("", "CA1859")]
     private static void Invoke<T>(this INotifySuppressionContext context)
         where T : INotifySuppressionChecker, new()
     {

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

@@ -59,7 +59,7 @@ internal sealed partial class GachaStatisticsFactory : IGachaStatisticsFactory
         HomaGachaLogClient gachaLogClient,
         List<Model.Entity.GachaItem> items,
         List<HistoryWishBuilder> historyWishBuilders,
-        in GachaLogServiceMetadataContext context,
+        GachaLogServiceMetadataContext context,
         AppOptions appOptions)
     {
         TypedWishSummaryBuilderContext standardContext = TypedWishSummaryBuilderContext.StandardWish(taskContext, gachaLogClient);

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

@@ -75,7 +75,7 @@ internal sealed class HutaoStatisticsFactory
                     QualityType.QUALITY_ORANGE => orangeItems,
                     QualityType.QUALITY_PURPLE => purpleItems,
                     QualityType.QUALITY_BLUE => blueItems,
-                    _ => throw Must.NeverHappen("意外的物品等级"),
+                    _ => throw HutaoException.NotSupported("意外的物品等级"),
                 };
 
                 list.Add(statisticsItem);

src/Snap.Hutao/Snap.Hutao/Service/GachaLog/GachaLogDbService.cs

@@ -31,7 +31,7 @@ internal sealed partial class GachaLogDbService : IGachaLogDbService
         catch (SqliteException ex)
         {
             string message = SH.FormatServiceGachaLogArchiveCollectionUserdataCorruptedMessage(ex.Message);
-            throw ThrowHelper.UserdataCorrupted(message, ex);
+            throw HutaoException.Throw(message, ex);
         }
     }
 
@@ -97,7 +97,7 @@ internal sealed partial class GachaLogDbService : IGachaLogDbService
         }
         catch (SqliteException ex)
         {
-            ThrowHelper.UserdataCorrupted(SH.ServiceGachaLogEndIdUserdataCorruptedMessage, ex);
+            HutaoException.Throw(SH.ServiceGachaLogEndIdUserdataCorruptedMessage, ex);
         }
 
         return item?.Id ?? 0L;
@@ -126,7 +126,7 @@ internal sealed partial class GachaLogDbService : IGachaLogDbService
         }
         catch (SqliteException ex)
         {
-            ThrowHelper.UserdataCorrupted(SH.ServiceGachaLogEndIdUserdataCorruptedMessage, ex);
+            HutaoException.Throw(SH.ServiceGachaLogEndIdUserdataCorruptedMessage, ex);
         }
 
         return item?.Id ?? 0L;
@@ -156,7 +156,7 @@ internal sealed partial class GachaLogDbService : IGachaLogDbService
         }
         catch (SqliteException ex)
         {
-            ThrowHelper.UserdataCorrupted(SH.ServiceGachaLogEndIdUserdataCorruptedMessage, ex);
+            HutaoException.Throw(SH.ServiceGachaLogEndIdUserdataCorruptedMessage, ex);
         }
 
         return item?.Id ?? 0L;

src/Snap.Hutao/Snap.Hutao/Service/GachaLog/GachaLogService.cs

@@ -3,6 +3,7 @@
 
 using Snap.Hutao.Core.Database;
 using Snap.Hutao.Core.Diagnostics;
+using Snap.Hutao.Core.ExceptionService;
 using Snap.Hutao.Model.Entity;
 using Snap.Hutao.Model.InterChange.GachaLog;
 using Snap.Hutao.Service.GachaLog.Factory;
@@ -124,7 +125,7 @@ internal sealed partial class GachaLogService : IGachaLogService
         {
             RefreshStrategy.AggressiveMerge => false,
             RefreshStrategy.LazyMerge => true,
-            _ => throw Must.NeverHappen(),
+            _ => throw HutaoException.NotSupported(),
         };
 
         (bool authkeyValid, GachaArchive? result) = await FetchGachaLogsAsync(query, isLazy, progress, token).ConfigureAwait(false);

src/Snap.Hutao/Snap.Hutao/Service/GachaLog/GachaLogServiceMetadataContext.cs

@@ -1,6 +1,7 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
+using Snap.Hutao.Core.ExceptionService;
 using Snap.Hutao.Model;
 using Snap.Hutao.Model.Metadata;
 using Snap.Hutao.Model.Metadata.Abstraction;
@@ -65,7 +66,7 @@ internal sealed class GachaLogServiceMetadataContext : IMetadataContext,
         {
             8U => IdAvatarMap[id],
             5U => IdWeaponMap[id],
-            _ => throw Must.NeverHappen($"Id places: {place}"),
+            _ => throw HutaoException.NotSupported($"Id places: {place}"),
         };
     }
 

src/Snap.Hutao/Snap.Hutao/Service/GachaLog/QueryProvider/GachaLogQueryProviderFactory.cs

@@ -1,6 +1,8 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
+using Snap.Hutao.Core.ExceptionService;
+
 namespace Snap.Hutao.Service.GachaLog.QueryProvider;
 
 [ConstructorGenerated]
@@ -17,7 +19,7 @@ internal sealed partial class GachaLogQueryProviderFactory : IGachaLogQueryProvi
             RefreshOption.SToken => serviceProvider.GetRequiredService<GachaLogQuerySTokenProvider>(),
             RefreshOption.WebCache => serviceProvider.GetRequiredService<GachaLogQueryWebCacheProvider>(),
             RefreshOption.ManualInput => serviceProvider.GetRequiredService<GachaLogQueryManualInputProvider>(),
-            _ => throw Must.NeverHappen("不支持的刷新选项"),
+            _ => throw HutaoException.NotSupported("不支持的刷新选项"),
         };
     }
 }

src/Snap.Hutao/Snap.Hutao/Service/GachaLog/UIGFImportService.cs

@@ -28,7 +28,7 @@ internal sealed partial class UIGFImportService : IUIGFImportService
 
         if (!uigf.IsCurrentVersionSupported(out UIGFVersion version))
         {
-            ThrowHelper.InvalidOperation(SH.ServiceUIGFImportUnsupportedVersion);
+            HutaoException.InvalidOperation(SH.ServiceUIGFImportUnsupportedVersion);
         }
 
         // v2.3+ support any locale
@@ -39,13 +39,13 @@ internal sealed partial class UIGFImportService : IUIGFImportService
             if (!cultureOptions.LanguageCodeFitsCurrentLocale(uigf.Info.Language))
             {
                 string message = SH.FormatServiceGachaUIGFImportLanguageNotMatch(uigf.Info.Language, cultureOptions.LanguageCode);
-                ThrowHelper.InvalidOperation(message);
+                HutaoException.InvalidOperation(message);
             }
 
             if (!uigf.IsMajor2Minor2OrLowerListValid(out long id))
             {
                 string message = SH.FormatServiceGachaLogUIGFImportItemInvalidFormat(id);
-                ThrowHelper.InvalidOperation(message);
+                HutaoException.InvalidOperation(message);
             }
         }
 
@@ -54,7 +54,7 @@ internal sealed partial class UIGFImportService : IUIGFImportService
             if (!uigf.IsMajor2Minor3OrHigherListValid(out long id))
             {
                 string message = SH.FormatServiceGachaLogUIGFImportItemInvalidFormat(id);
-                ThrowHelper.InvalidOperation(message);
+                HutaoException.InvalidOperation(message);
             }
         }
 
@@ -79,7 +79,7 @@ internal sealed partial class UIGFImportService : IUIGFImportService
                     .OrderByDescending(i => i.Id)
                     .Select(i => GachaItem.From(archiveId, i, context.GetItemId(i)))
                     .ToList(),
-                _ => throw Must.NeverHappen(),
+                _ => throw HutaoException.NotSupported(),
             };
 
             ThrowIfContainsInvalidItem(currentTypedList);
@@ -97,7 +97,7 @@ internal sealed partial class UIGFImportService : IUIGFImportService
         // 因此从尾部开始查找
         if (currentTypeToAdd.LastOrDefault(item => item.ItemId is 0U) is { } item)
         {
-            ThrowHelper.InvalidOperation(SH.FormatServiceGachaLogUIGFImportItemInvalidFormat(item.Id));
+            HutaoException.InvalidOperation(SH.FormatServiceGachaLogUIGFImportItemInvalidFormat(item.Id));
         }
     }
 }

src/Snap.Hutao/Snap.Hutao/Service/Game/Account/GameAccountService.cs

@@ -129,7 +129,7 @@ internal sealed partial class GameAccountService : IGameAccountService
         }
         catch (InvalidOperationException ex)
         {
-            throw ThrowHelper.UserdataCorrupted(SH.ServiceGameDetectGameAccountMultiMatched, ex);
+            throw HutaoException.Throw(SH.ServiceGameDetectGameAccountMultiMatched, ex);
         }
     }
 }

src/Snap.Hutao/Snap.Hutao/Service/Game/Account/RegistryInterop.cs

@@ -70,7 +70,7 @@ internal static class RegistryInterop
         {
             SchemeType.ChineseOfficial => (ChineseKeyName, SdkChineseValueName),
             SchemeType.Oversea => (OverseaKeyName, SdkOverseaValueName),
-            _ => throw ThrowHelper.NotSupported($"Invalid account SchemeType: {scheme}"),
+            _ => throw HutaoException.NotSupported($"Invalid account SchemeType: {scheme}"),
         };
     }
 }

src/Snap.Hutao/Snap.Hutao/Service/Game/Automation/ScreenCapture/GameScreenCaptureContext.cs

@@ -22,6 +22,7 @@ internal readonly struct GameScreenCaptureContext
     private readonly IDirect3DDevice direct3DDevice;
     private readonly HWND hwnd;
 
+    [SuppressMessage("", "SH002")]
     public GameScreenCaptureContext(IDirect3DDevice direct3DDevice, HWND hwnd)
     {
         this.direct3DDevice = direct3DDevice;
@@ -87,6 +88,7 @@ internal readonly struct GameScreenCaptureContext
         return clientBox.right <= width && clientBox.bottom <= height;
     }
 
+    [SuppressMessage("", "SH002")]
     private static DirectXPixelFormat DeterminePixelFormat(HWND hwnd)
     {
         HDC hdc = GetDC(hwnd);

src/Snap.Hutao/Snap.Hutao/Service/Game/Automation/ScreenCapture/GameScreenCaptureMemoryPool.cs

@@ -9,7 +9,7 @@ namespace Snap.Hutao.Service.Game.Automation.ScreenCapture;
 
 internal sealed class GameScreenCaptureMemoryPool : MemoryPool<byte>
 {
-    private static LazySlim<GameScreenCaptureMemoryPool> lazyShared = new(() => new());
+    private static readonly LazySlim<GameScreenCaptureMemoryPool> LazyShared = new(() => new());
 
     private readonly object syncRoot = new();
     private readonly LinkedList<GameScreenCaptureBuffer> unrentedBuffers = [];
@@ -17,7 +17,7 @@ internal sealed class GameScreenCaptureMemoryPool : MemoryPool<byte>
 
     private int bufferCount;
 
-    public new static GameScreenCaptureMemoryPool Shared { get => lazyShared.Value; }
+    public static new GameScreenCaptureMemoryPool Shared { get => LazyShared.Value; }
 
     public override int MaxBufferSize { get => Array.MaxLength; }
 
@@ -25,7 +25,7 @@ internal sealed class GameScreenCaptureMemoryPool : MemoryPool<byte>
 
     public override IMemoryOwner<byte> Rent(int minBufferSize = -1)
     {
-        ArgumentOutOfRangeException.ThrowIfLessThan(minBufferSize, 0);
+        ArgumentOutOfRangeException.ThrowIfNegative(minBufferSize);
 
         lock (syncRoot)
         {

src/Snap.Hutao/Snap.Hutao/Service/Game/Automation/ScreenCapture/GameScreenCaptureSession.cs

@@ -9,7 +9,6 @@ using Snap.Hutao.Win32.Graphics.Dxgi;
 using Snap.Hutao.Win32.Graphics.Dxgi.Common;
 using Snap.Hutao.Win32.System.WinRT.Graphics.Capture;
 using System.Buffers;
-using System.Numerics;
 using System.Runtime.CompilerServices;
 using System.Runtime.InteropServices;
 using Windows.Graphics;
@@ -114,8 +113,9 @@ internal sealed class GameScreenCaptureSession : IDisposable
             {
                 UnsafeProcessFrameSurface(frame.Surface);
             }
-            catch (Exception ex) // TODO: test if it's device lost.
+            catch (Exception ex)
             {
+                // TODO: test if it's device lost.
                 logger.LogError(ex, "Failed to process the frame surface.");
                 needsReset = true;
             }
@@ -209,8 +209,9 @@ internal sealed class GameScreenCaptureSession : IDisposable
                     {
                         subresource[row][..rowLength].CopyTo(buffer.Memory.Span.Slice(row * rowLength, rowLength));
                     }
-
+#pragma warning disable CA2000
                     frameRawPixelDataTaskCompletionSource.SetResult(new(buffer, (int)textureWidth, (int)textureHeight));
+#pragma warning restore CA2000
                     return;
                 }
 
@@ -235,8 +236,9 @@ internal sealed class GameScreenCaptureSession : IDisposable
                             pixel.A = (byte)(float16Pixel.A * ByteMaxValue);
                         }
                     }
-
+#pragma warning disable CA2000
                     frameRawPixelDataTaskCompletionSource.SetResult(new(buffer, (int)textureWidth, (int)textureHeight));
+#pragma warning restore CA2000
                     return;
                 }
 

src/Snap.Hutao/Snap.Hutao/Service/Game/Package/PackageConvertException.cs

@@ -7,6 +7,7 @@ namespace Snap.Hutao.Service.Game.Package;
 /// 包转换异常
 /// </summary>
 [HighQuality]
+[Obsolete]
 internal sealed class PackageConvertException : Exception
 {
     /// <inheritdoc cref="Exception(string?, Exception?)"/>

src/Snap.Hutao/Snap.Hutao/Service/Game/Package/PackageConverter.cs

@@ -180,7 +180,7 @@ internal sealed partial class PackageConverter
         }
         catch (IOException ex)
         {
-            throw ThrowHelper.PackageConvert(SH.ServiceGamePackageRequestPackageVerionFailed, ex);
+            throw HutaoException.Throw(SH.ServiceGamePackageRequestPackageVerionFailed, ex);
         }
     }
 
@@ -252,13 +252,13 @@ internal sealed partial class PackageConverter
             {
                 // System.IO.IOException: The response ended prematurely.
                 // System.IO.IOException: Received an unexpected EOF or 0 bytes from the transport stream.
-                ThrowHelper.PackageConvert(SH.FormatServiceGamePackageRequestScatteredFileFailed(remoteName), ex);
+                HutaoException.Throw(SH.FormatServiceGamePackageRequestScatteredFileFailed(remoteName), ex);
             }
         }
 
         if (!string.Equals(info.Remote.Md5, await MD5.HashFileAsync(cacheFile).ConfigureAwait(false), StringComparison.OrdinalIgnoreCase))
         {
-            ThrowHelper.PackageConvert(SH.FormatServiceGamePackageRequestScatteredFileFailed(remoteName));
+            HutaoException.Throw(SH.FormatServiceGamePackageRequestScatteredFileFailed(remoteName));
         }
     }
 
@@ -318,7 +318,7 @@ internal sealed partial class PackageConverter
         {
             // Access to the path is denied.
             // When user install the game in special folder like 'Program Files'
-            throw ThrowHelper.GameFileOperation(SH.ServiceGamePackageRenameDataFolderFailed, ex);
+            throw HutaoException.Throw(SH.ServiceGamePackageRenameDataFolderFailed, ex);
         }
 
         // 重新下载所有 *pkg_version 文件

src/Snap.Hutao/Snap.Hutao/Service/Hutao/HutaoAsAService.cs

@@ -27,7 +27,7 @@ internal sealed partial class HutaoAsAService : IHutaoAsAService
         {
             RelayCommand<HutaoAnnouncement> dismissCommand = new(DismissAnnouncement);
 
-            ApplicationDataCompositeValue excludedIds = LocalSetting.Get(SettingKeys.ExcludedAnnouncementIds, new ApplicationDataCompositeValue());
+            ApplicationDataCompositeValue excludedIds = LocalSetting.Get(SettingKeys.ExcludedAnnouncementIds, []);
             List<long> data = excludedIds.Select(kvp => long.Parse(kvp.Key, CultureInfo.InvariantCulture)).ToList();
 
             Response<List<HutaoAnnouncement>> response;
@@ -56,7 +56,7 @@ internal sealed partial class HutaoAsAService : IHutaoAsAService
     {
         if (announcement is not null && announcements is not null)
         {
-            ApplicationDataCompositeValue excludedIds = LocalSetting.Get(SettingKeys.ExcludedAnnouncementIds, new ApplicationDataCompositeValue());
+            ApplicationDataCompositeValue excludedIds = LocalSetting.Get(SettingKeys.ExcludedAnnouncementIds, []);
 
             foreach ((string key, object value) in excludedIds)
             {

src/Snap.Hutao/Snap.Hutao/Service/Hutao/HutaoSpiralAbyssStatisticsCache.cs

@@ -59,14 +59,14 @@ internal sealed partial class HutaoSpiralAbyssStatisticsCache : IHutaoSpiralAbys
         if (await metadataService.InitializeAsync().ConfigureAwait(false))
         {
             Dictionary<AvatarId, Avatar> idAvatarMap = await GetIdAvatarMapExtendedAsync().ConfigureAwait(false);
-            List<Task> tasks = new(5)
+            List<Task> tasks =
-            {
+            [
                 AvatarAppearanceRankAsync(idAvatarMap),
                 AvatarUsageRanksAsync(idAvatarMap),
                 AvatarConstellationInfosAsync(idAvatarMap),
                 TeamAppearancesAsync(idAvatarMap),
                 OverviewAsync(),
-            };
+            ];
 
             await Task.WhenAll(tasks).ConfigureAwait(false);
 

src/Snap.Hutao/Snap.Hutao/Service/Hutao/ObjectCacheDbService.cs

@@ -55,7 +55,7 @@ internal sealed partial class ObjectCacheDbService : IObjectCacheDbService
         }
         catch (DbUpdateException ex)
         {
-            ThrowHelper.DatabaseCorrupted($"无法存储 Key:{key} 对应的值到数据库缓存", ex);
+            HutaoException.Throw($"无法存储 Key:{key} 对应的值到数据库缓存", ex);
         }
 
         return default!;

src/Snap.Hutao/Snap.Hutao/Service/Job/JobIdentity.cs

@@ -1,9 +1,6 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
-using Quartz;
-using Snap.Hutao.Service.DailyNote;
-
 namespace Snap.Hutao.Service.Job;
 
 internal static class JobIdentity

src/Snap.Hutao/Snap.Hutao/Service/Job/QuartzService.cs

@@ -62,7 +62,7 @@ internal sealed partial class QuartzService : IQuartzService, IDisposable
     {
         DisposeAsync().GetAwaiter().GetResult();
 
-        async ValueTask DisposeAsync()
+        async Task DisposeAsync()
         {
             if (scheduler is null)
             {

src/Snap.Hutao/Snap.Hutao/Service/SpiralAbyss/SpiralAbyssRecordService.cs

@@ -21,7 +21,6 @@ namespace Snap.Hutao.Service.SpiralAbyss;
 [Injection(InjectAs.Scoped, typeof(ISpiralAbyssRecordService))]
 internal sealed partial class SpiralAbyssRecordService : ISpiralAbyssRecordService
 {
-    //private readonly IOverseaSupportFactory<IGameRecordClient> gameRecordClientFactory;
     private readonly ISpiralAbyssRecordDbService spiralAbyssRecordDbService;
     private readonly IServiceScopeFactory serviceScopeFactory;
     private readonly IMetadataService metadataService;

src/Snap.Hutao/Snap.Hutao/Service/SupportedCultures.cs

@@ -15,7 +15,7 @@ internal static class SupportedCultures
         /*ToNameValue(CultureInfo.GetCultureInfo("de")),*/
         ToNameValue(CultureInfo.GetCultureInfo("en")),
         /*ToNameValue(CultureInfo.GetCultureInfo("es")),*/
-        /*ToNameValue(CultureInfo.GetCultureInfo("fr")),*/
+        ToNameValue(CultureInfo.GetCultureInfo("fr")),
         ToNameValue(CultureInfo.GetCultureInfo("id")),
         /*ToNameValue(CultureInfo.GetCultureInfo("it")),*/
         ToNameValue(CultureInfo.GetCultureInfo("ja")),

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

@@ -25,7 +25,7 @@
     <AppxBundle>Never</AppxBundle>
     <HoursBetweenUpdateChecks>0</HoursBetweenUpdateChecks>
     <StartupObject>Snap.Hutao.Program</StartupObject>
-    <DefineConstants>$(DefineConstants);DISABLE_XAML_GENERATED_MAIN;DISABLE_XAML_GENERATED_BREAK_ON_UNHANDLED_EXCEPTION;DISABLE_XAML_GENERATED_BINDING_DEBUG_OUTPUT</DefineConstants>
+    <DefineConstants>$(DefineConstants);DISABLE_XAML_GENERATED_MAIN;DISABLE_XAML_GENERATED_BREAK_ON_UNHANDLED_EXCEPTION;DISABLE_XAML_GENERATED_BINDING_DEBUG_OUTPUT;$(AlphaConstants)</DefineConstants>
     <AllowUnsafeBlocks>True</AllowUnsafeBlocks>
     <DebugSymbols>true</DebugSymbols>
     <DebugType>embedded</DebugType>
@@ -117,6 +117,7 @@
     <None Remove="Resource\BlurBackground.png" />
     <None Remove="Resource\Font\CascadiaMono.ttf" />
     <None Remove="Resource\Font\MiSans-Regular.ttf" />
+    <None Remove="Resource\GuideStaticResourceQualityComparison.png" />
     <None Remove="Resource\HutaoIconSourceTransparentBackgroundGradient1.png" />
     <None Remove="Resource\Icon\UI_AchievementIcon_3_3.png" />
     <None Remove="Resource\Icon\UI_GachaShowPanel_Bg_Weapon.png" />
@@ -216,6 +217,7 @@
     <AdditionalFiles Include="stylecop.json" />
     <AdditionalFiles Include="Resource\Localization\SH.resx" />
     <AdditionalFiles Include="Resource\Localization\SH.en.resx" />
+    <AdditionalFiles Include="Resource\Localization\SH.fr.resx" />
     <AdditionalFiles Include="Resource\Localization\SH.id.resx" />
     <AdditionalFiles Include="Resource\Localization\SH.ja.resx" />
     <AdditionalFiles Include="Resource\Localization\SH.ko.resx" />
@@ -265,6 +267,7 @@
     <Content Include="Resource\BlurBackground.png" />
     <Content Include="Resource\Font\CascadiaMono.ttf" />
     <Content Include="Resource\Font\MiSans-Regular.ttf" />
+    <Content Include="Resource\GuideStaticResourceQualityComparison.png" />
     <Content Include="Resource\HutaoIconSourceTransparentBackgroundGradient1.png" />
     <Content Include="Resource\Icon\UI_AchievementIcon_3_3.png" />
     <Content Include="Resource\Icon\UI_GachaShowPanel_Bg_Weapon.png" />
@@ -323,7 +326,7 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
     <PackageReference Include="Microsoft.VisualStudio.Validation" Version="17.8.8" />
-    <PackageReference Include="Microsoft.Windows.SDK.BuildTools" Version="10.0.22621.3233" />
+    <PackageReference Include="Microsoft.Windows.SDK.BuildTools" Version="10.0.26100.1" />
     <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.5.240428000" />
     <PackageReference Include="QRCoder" Version="1.5.1" />
     <PackageReference Include="Quartz.Extensions.DependencyInjection" Version="3.9.0" />
@@ -336,7 +339,7 @@
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
     </PackageReference>
-    <PackageReference Include="Snap.Hutao.SourceGeneration" Version="1.0.7">
+    <PackageReference Include="Snap.Hutao.SourceGeneration" Version="1.0.8">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>

src/Snap.Hutao/Snap.Hutao/View/Converter/Int32ToVisibilityConverter.cs

@@ -22,6 +22,6 @@ internal sealed class Int32ToVisibilityConverter : IValueConverter
     /// <inheritdoc/>
     public object ConvertBack(object value, Type targetType, object parameter, string language)
     {
-        throw ThrowHelper.NotSupported();
+        throw HutaoException.NotSupported();
     }
 }

src/Snap.Hutao/Snap.Hutao/View/Converter/Int32ToVisibilityRevertConverter.cs

@@ -22,6 +22,6 @@ internal sealed class Int32ToVisibilityRevertConverter : IValueConverter
     /// <inheritdoc/>
     public object ConvertBack(object value, Type targetType, object parameter, string language)
     {
-        throw ThrowHelper.NotSupported();
+        throw HutaoException.NotSupported();
     }
 }

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

@@ -2,6 +2,7 @@
     x:Class="Snap.Hutao.View.Guide.GuideView"
     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:d="http://schemas.microsoft.com/expression/blend/2008"
     xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
@@ -210,28 +211,75 @@
                         <RowDefinition Height="auto"/>
                     </Grid.RowDefinitions>
 
-                    <StackPanel
+                    <Grid
                         Grid.Row="0"
-                        Margin="16"
+                        Margin="72"
                         HorizontalAlignment="Center"
-                        VerticalAlignment="Center">
+                        ColumnSpacing="32">
-                        <TextBlock Style="{StaticResource SubtitleTextBlockStyle}" Text="{shcm:ResourceString Name=ViewGuideStepStaticResourceSettingQualityHeader}"/>
+                        <Grid.ColumnDefinitions>
-                        <ListView
+                            <ColumnDefinition/>
-                            MinWidth="320"
+                            <ColumnDefinition/>
-                            Margin="0,8,0,32"
+                        </Grid.ColumnDefinitions>
-                            DisplayMemberPath="Name"
+                        <cwc:ConstrainedBox Grid.Column="0" AspectRatio="1:1">
-                            ItemsSource="{Binding StaticResourceOptions.ImageQualities}"
+                            <Border cw:Effects.Shadow="{ThemeResource CompatCardShadow}">
-                            SelectedItem="{Binding StaticResourceOptions.ImageQuality, Mode=TwoWay}"/>
+                                <Grid
-                        <TextBlock Style="{StaticResource SubtitleTextBlockStyle}" Text="{shcm:ResourceString Name=ViewGuideStepStaticResourceSettingMinimumHeader}"/>
+                                    BorderBrush="{x:Null}"
-                        <ListView
+                                    BorderThickness="0"
-                            MinWidth="320"
+                                    Style="{ThemeResource GridCardStyle}">
-                            Margin="0,8,0,32"
+                                    <Grid.RowDefinitions>
-                            DisplayMemberPath="Name"
+                                        <RowDefinition/>
-                            ItemsSource="{Binding StaticResourceOptions.ImageArchives}"
+                                        <RowDefinition Height="auto"/>
-                            SelectedItem="{Binding StaticResourceOptions.ImageArchive, Mode=TwoWay}"/>
+                                    </Grid.RowDefinitions>
-
+                                    <Grid Grid.Row="0">
-                        <TextBlock Margin="0,16,0,0" Text="{Binding StaticResourceOptions.SizeInformationText, Mode=OneWay}"/>
+                                        <Image
-                    </StackPanel>
+                                            HorizontalAlignment="Center"
+                                            VerticalAlignment="Center"
+                                            Source="ms-appx:///Resource/GuideStaticResourceQualityComparison.png"/>
+                                        <Rectangle
+                                            Width="2"
+                                            HorizontalAlignment="Center"
+                                            VerticalAlignment="Stretch"
+                                            Fill="White"/>
+                                    </Grid>
+                                    <Grid
+                                        Grid.Row="1"
+                                        Padding="16"
+                                        HorizontalAlignment="Stretch"
+                                        VerticalAlignment="Bottom"
+                                        Background="{ThemeResource ContentDialogBackground}"
+                                        BorderThickness="0,1,0,0"
+                                        CornerRadius="{ThemeResource ControlCornerRadiusBottom}"
+                                        Style="{ThemeResource GridCardStyle}">
+                                        <StackPanel HorizontalAlignment="Left" Orientation="Vertical">
+                                            <TextBlock Text="{shcm:ResourceString Name=ViewModelGuideStaticResourceQualityHigh}" TextAlignment="Left"/>
+                                            <TextBlock Text="233 KB" TextAlignment="Left"/>
+                                        </StackPanel>
+                                        <StackPanel HorizontalAlignment="Right" Orientation="Vertical">
+                                            <TextBlock Text="{shcm:ResourceString Name=ViewModelGuideStaticResourceQualityRaw}" TextAlignment="Right"/>
+                                            <TextBlock Text="1030 KB" TextAlignment="Right"/>
+                                        </StackPanel>
+                                    </Grid>
+                                </Grid>
+                            </Border>
+                        </cwc:ConstrainedBox>
+                        <StackPanel Grid.Column="1" VerticalAlignment="Top">
+                            <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>
+                    </Grid>
 
                     <TextBlock
                         Grid.Row="1"

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

@@ -381,7 +381,7 @@
                                     ItemTemplate="{StaticResource InventoryItemTemplate}"
                                     ItemsSource="{Binding InventoryItems}">
                                     <ItemsRepeater.Layout>
-                                        <cwcont:WrapLayout HorizontalSpacing="12" VerticalSpacing="12"/>
+                                        <shcl:WrapLayout HorizontalSpacing="12" VerticalSpacing="12"/>
                                     </ItemsRepeater.Layout>
                                 </ItemsRepeater>
                             </ScrollView>