fix #1633

fix #1632

.github/ISSUE_TEMPLATE/CHS-bug-report.yml

@@ -40,7 +40,7 @@ body:
     attributes:
       label: Snap Hutao 版本
       description: 在应用标题，应用程序的反馈中心界面中可以找到
-      placeholder: 例：1.4.15.0
+      placeholder: 例：1.9.9.0
     validations:
       required: true
 
@@ -62,20 +62,19 @@ body:
       description: 请设置一个你认为合适的分类，这将帮助我们快速定位问题
       options:
         - 安装和环境
-        - 成就管理
-        - 角色信息面板
         - 游戏启动器
+        - 祈愿记录
+        - 成就管理
+        - 我的角色
         - 实时便笺
         - 养成计算
-        - 文件缓存
-        - 祈愿记录
-        - 玩家查询
-        - 胡桃数据库
-        - 用户界面
-        - 胡桃云
-        - 胡桃帐号
-        - 签到
+        - 深境螺旋/胡桃数据库
         - Wiki
+        - 米游社账号面板
+        - 每日签到奖励
+        - 胡桃通行证/胡桃云
+        - 用户界面
+        - 文件缓存
         - 公告
         - 其它
     validations:

.github/ISSUE_TEMPLATE/ENG-bug-report.yml

@@ -40,7 +40,7 @@ body:
     attributes:
       label: Snap Hutao Version
       description: You can find the version in application's title bar
-      placeholder: e.g. 1.4.15.0
+      placeholder: e.g. 1.9.9.0
     validations:
       required: true
 
@@ -62,20 +62,19 @@ body:
       description: Please select the most associated category of your issue
       options:
         - Installation and Environment
+        - Game Launcher
+        - Wish Export
         - Achievement
         - My Character
-        - Game Launcher
         - Realtime Note
         - Develop Plan
-        - File Cache
-        - Wish Export
-        - Game Record
-        - Hutao Database
-        - User Interface
-        - Snap Hutao Cloud
-        - Snap Hutao Account
-        - Checkin
+        - Spiral Abyss
         - Wiki
+        - MiHoYo Account Panel
+        - Daily Checkin Reward
+        - Hutao Passport/Hutao Cloud
+        - User Interface
+        - File Cache
         - Announcement
         - Other
     validations:

.github/pull_request_template.md

@@ -0,0 +1,15 @@
+<!--- Hi, thanks for considering make a PR contribution to Snap Hutao, we appreciate your work. -->
+<!--- Before you create this PR, please fill the following form and checklist -->
+
+## Description
+
+<!--- Describe your changes -->
+
+## Related Issue
+
+<!--- If there's an associated issue, please use [GitHub Keyword](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests) to link it -->
+<!-- e.g. fix #999, resolve #999, close #999 -->
+
+## Checklist
+
+- [ ] The target PR branch is `develop` branch

.github/workflows/alpha.yml

@@ -5,6 +5,7 @@ on:
     branches:
       - main
       - develop
+      - 'feat/*'
     paths-ignore:
       - '.gitattributes'
       - '.github/**'
@@ -73,7 +74,7 @@ jobs:
           > [!IMPORTANT]
           > 请注意，从 Snap Hutao Alpha 2023.12.21.3 开始，我们将使用全新的 CI 证书，原有的 Snap.Hutao.CI.cer 将在几天后过期停止使用。
           >
-          > 请安装 [DGP_Studio_CA.crt](https://github.com/DGP-Automation/Hutao-Auto-Release/releases/download/certificate-ca/DGP_Studio_CA.crt) 以安装测试版安装包
+          > 请安装 [DGP_Studio_CA.crt](https://github.com/DGP-Automation/Hutao-Auto-Release/releases/download/certificate-ca/DGP_Studio_CA.crt) 到 `受信任的根证书颁发机构` 以安装测试版安装包
           "
 
           echo $summary >> $Env:GITHUB_STEP_SUMMARY

README.md

@@ -17,7 +17,7 @@ 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) ![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) ![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) ![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) ![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)![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)  ![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)
+[![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)
 
 Snap Hutao 使用 [Crowdin](https://translate.hut.ao/) 作为客户端文本翻译平台，在该平台上你可以为你熟悉的语言提交翻译文本。我们感谢每一个为 Snap Hutao 做出贡献的社区成员，并且欢迎更多的朋友能参与到这个项目中。
 

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

@@ -0,0 +1,28 @@
+using System.Runtime.CompilerServices;
+
+namespace Snap.Hutao.Test.BaseClassLibrary;
+
+[TestClass]
+public class UnsafeAccessorTest
+{
+    [TestMethod]
+    public void UnsafeAccessorCanGetInterfaceProperty()
+    {
+        TestClass test = new();
+        int value = InternalGetInterfaceProperty(test);
+        Assert.AreEqual(3, value);
+    }
+
+    [UnsafeAccessor(UnsafeAccessorKind.Method, Name = "get_TestProperty")]
+    private static extern int InternalGetInterfaceProperty(ITestInterface instance);
+
+    internal interface ITestInterface
+    {
+        internal int TestProperty { get; }
+    }
+
+    internal sealed class TestClass : ITestInterface
+    {
+        public int TestProperty { get; } = 3;
+    }
+}

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

@@ -1,6 +1,7 @@
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Logging;
 using System;
+using System.Linq;
 
 namespace Snap.Hutao.Test.PlatformExtensions;
 
@@ -11,6 +12,8 @@ public sealed class DependencyInjectionTest
         .AddSingleton<IService, ServiceA>()
         .AddSingleton<IService, ServiceB>()
         .AddScoped<IScopedService, ServiceA>()
+        .AddKeyedTransient<IKeyedService, KeyedServiceA>("A")
+        .AddKeyedTransient<IKeyedService, KeyedServiceB>("B")
         .AddTransient(typeof(IGenericService<>), typeof(GenericService<>))
         .AddLogging(builder => builder.AddConsole())
         .BuildServiceProvider();
@@ -50,6 +53,15 @@ public sealed class DependencyInjectionTest
         Assert.IsNotNull(services.GetRequiredService<ILoggerFactory>().CreateLogger(nameof(IScopedService)));
     }
 
+    [TestMethod]
+    public void KeyedServicesCanBeResolvedAsEnumerable()
+    {
+        Assert.IsNotNull(services.GetRequiredKeyedService<IKeyedService>("A"));
+        Assert.IsNotNull(services.GetRequiredKeyedService<IKeyedService>("B"));
+
+        Assert.AreEqual(0, services.GetServices<IKeyedService>().Count());
+    }
+
     private interface IService
     {
         Guid Id { get; }
@@ -95,4 +107,14 @@ public sealed class DependencyInjectionTest
         {
         }
     }
+
+    private interface IKeyedService;
+
+    private sealed class KeyedServiceA : IKeyedService
+    {
+    }
+
+    private sealed class KeyedServiceB : IKeyedService
+    {
+    }
 }

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

@@ -6,7 +6,7 @@
         <ResourceDictionary>
             <ResourceDictionary.MergedDictionaries>
                 <XamlControlsResources/>
-                <ResourceDictionary Source="ms-appx:///CommunityToolkit.WinUI.Controls.TokenizingTextBox/TokenizingTextBox.xaml"/>
+                <ResourceDictionary Source="ms-appx:///CommunityToolkit.WinUI.Controls.SettingsControls/SettingsCard/SettingsCard.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Loading.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Image/CachedImage.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Theme/Card.xaml"/>
@@ -29,6 +29,7 @@
                 <ResourceDictionary Source="ms-appx:///Control/Theme/TransitionCollection.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Theme/Uri.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Theme/WindowOverride.xaml"/>
+                <ResourceDictionary Source="ms-appx:///Control/TokenizingTextBox/TokenizingTextBox.xaml"/>
                 <ResourceDictionary Source="ms-appx:///View/Card/Primitive/CardProgressBar.xaml"/>
             </ResourceDictionary.MergedDictionaries>
 

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

@@ -8,7 +8,7 @@ using Snap.Hutao.Core.ExceptionService;
 using Snap.Hutao.Core.LifeCycle;
 using Snap.Hutao.Core.LifeCycle.InterProcess;
 using Snap.Hutao.Core.Logging;
-using Snap.Hutao.Core.Shell;
+using Snap.Hutao.Core.Windowing;
 using System.Diagnostics;
 
 namespace Snap.Hutao;
@@ -39,7 +39,7 @@ public sealed partial class App : Application
         """;
 
     private readonly IServiceProvider serviceProvider;
-    private readonly IActivation activation;
+    private readonly IAppActivation activation;
     private readonly ILogger<App> logger;
 
     /// <summary>
@@ -50,13 +50,19 @@ public sealed partial class App : Application
     {
         // Load app resource
         InitializeComponent();
-        activation = serviceProvider.GetRequiredService<IActivation>();
+        activation = serviceProvider.GetRequiredService<IAppActivation>();
         logger = serviceProvider.GetRequiredService<ILogger<App>>();
         serviceProvider.GetRequiredService<ExceptionRecorder>().Record(this);
 
         this.serviceProvider = serviceProvider;
     }
 
+    public new void Exit()
+    {
+        XamlWindowLifetime.ApplicationExiting = true;
+        base.Exit();
+    }
+
     /// <inheritdoc/>
     protected override void OnLaunched(LaunchActivatedEventArgs args)
     {
@@ -73,15 +79,13 @@ public sealed partial class App : Application
             logger.LogColorizedInformation((ConsoleBanner, ConsoleColor.DarkYellow));
             LogDiagnosticInformation();
 
-            // manually invoke
+            // Manually invoke
             activation.Activate(HutaoActivationArguments.FromAppActivationArguments(activatedEventArgs));
-            activation.Initialize();
-
-            serviceProvider.GetRequiredService<IJumpListInterop>().ConfigureAsync().SafeForget();
+            activation.PostInitialization();
         }
-        catch
+        catch (Exception ex)
         {
-            // AppInstance.GetCurrent() calls failed
+            Debug.WriteLine(ex);
             Process.GetCurrentProcess().Kill();
         }
     }

src/Snap.Hutao/Snap.Hutao/Control/AutoSuggestBox/AutoSuggestTokenBox.cs

@@ -1,12 +1,10 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
-using CommunityToolkit.WinUI;
-using CommunityToolkit.WinUI.Controls;
 using Microsoft.UI.Xaml;
 using Microsoft.UI.Xaml.Controls;
-using Microsoft.UI.Xaml.Controls.Primitives;
 using Snap.Hutao.Control.Extension;
+using Snap.Hutao.Control.TokenizingTextBox;
 using System.Collections;
 
 namespace Snap.Hutao.Control.AutoSuggestBox;
@@ -14,33 +12,16 @@ namespace Snap.Hutao.Control.AutoSuggestBox;
 [DependencyProperty("FilterCommand", typeof(ICommand))]
 [DependencyProperty("FilterCommandParameter", typeof(object))]
 [DependencyProperty("AvailableTokens", typeof(IReadOnlyDictionary<string, SearchToken>))]
-internal sealed partial class AutoSuggestTokenBox : TokenizingTextBox
+internal sealed partial class AutoSuggestTokenBox : TokenizingTextBox.TokenizingTextBox
 {
     public AutoSuggestTokenBox()
     {
-        DefaultStyleKey = typeof(TokenizingTextBox);
+        DefaultStyleKey = typeof(TokenizingTextBox.TokenizingTextBox);
         TextChanged += OnFilterSuggestionRequested;
         QuerySubmitted += OnQuerySubmitted;
         TokenItemAdding += OnTokenItemAdding;
         TokenItemAdded += OnTokenItemCollectionChanged;
         TokenItemRemoved += OnTokenItemCollectionChanged;
-        Loaded += OnLoaded;
-    }
-
-    private void OnLoaded(object sender, RoutedEventArgs e)
-    {
-        if (this.FindDescendant("SuggestionsPopup") is Popup { Child: Border { Child: ListView listView } border })
-        {
-            IAppResourceProvider appResourceProvider = this.ServiceProvider().GetRequiredService<IAppResourceProvider>();
-
-            listView.Background = null;
-            listView.Margin = appResourceProvider.GetResource<Thickness>("AutoSuggestListPadding");
-
-            border.Background = appResourceProvider.GetResource<Microsoft.UI.Xaml.Media.Brush>("AutoSuggestBoxSuggestionsListBackground");
-            CornerRadius overlayCornerRadius = appResourceProvider.GetResource<CornerRadius>("OverlayCornerRadius");
-            CornerRadiusFilterConverter cornerRadiusFilterConverter = new() { Filter = CornerRadiusFilterKind.Bottom };
-            border.CornerRadius = (CornerRadius)cornerRadiusFilterConverter.Convert(overlayCornerRadius, typeof(CornerRadius), default, default);
-        }
     }
 
     private void OnFilterSuggestionRequested(Microsoft.UI.Xaml.Controls.AutoSuggestBox sender, AutoSuggestBoxTextChangedEventArgs args)
@@ -73,7 +54,7 @@ internal sealed partial class AutoSuggestTokenBox : TokenizingTextBox
         CommandInvocation.TryExecute(FilterCommand, FilterCommandParameter);
     }
 
-    private void OnTokenItemAdding(TokenizingTextBox sender, TokenItemAddingEventArgs args)
+    private void OnTokenItemAdding(TokenizingTextBox.TokenizingTextBox sender, TokenItemAddingEventArgs args)
     {
         if (string.IsNullOrWhiteSpace(args.TokenText))
         {
@@ -90,7 +71,7 @@ internal sealed partial class AutoSuggestTokenBox : TokenizingTextBox
         }
     }
 
-    private void OnTokenItemCollectionChanged(TokenizingTextBox sender, object args)
+    private void OnTokenItemCollectionChanged(TokenizingTextBox.TokenizingTextBox sender, object args)
     {
         if (args is SearchToken { Kind: SearchTokenKind.None } token)
         {

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;
@@ -23,13 +21,10 @@ internal sealed class CachedImage : Implementation.ImageEx
     {
         DefaultStyleKey = typeof(CachedImage);
         DefaultStyleResourceUri = "ms-appx:///Control/Image/CachedImage.xaml".ToUri();
-
-        IsCacheEnabled = true;
-        EnableLazyLoading = false;
     }
 
     /// <inheritdoc/>
-    protected override async Task<ImageSource?> ProvideCachedResourceAsync(Uri imageUri, CancellationToken token)
+    protected override async Task<Uri?> ProvideCachedResourceAsync(Uri imageUri, CancellationToken token)
     {
         IImageCache imageCache = this.ServiceProvider().GetRequiredService<IImageCache>();
 
@@ -38,7 +33,7 @@ internal sealed class CachedImage : Implementation.ImageEx
             HutaoException.ThrowIf(string.IsNullOrEmpty(imageUri.Host), SH.ControlImageCachedImageInvalidResourceUri);
             string file = await imageCache.GetFileFromCacheAsync(imageUri).ConfigureAwait(true); // BitmapImage need to be created by main thread.
             token.ThrowIfCancellationRequested(); // check token state to determine whether the operation should be canceled.
-            return new BitmapImage(file.ToUri()); // BitmapImage initialize with a uri will increase image quality and loading speed.
+            return file.ToUri();
         }
         catch (COMException)
         {

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

@@ -6,7 +6,6 @@
         <Setter Property="Background" Value="Transparent"/>
         <Setter Property="Foreground" Value="{ThemeResource ApplicationForegroundThemeBrush}"/>
         <Setter Property="IsTabStop" Value="False"/>
-        <Setter Property="LazyLoadingThreshold" Value="256"/>
         <Setter Property="Template">
             <Setter.Value>
                 <ControlTemplate TargetType="shci:CachedImage">

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;
 
@@ -21,12 +18,6 @@ namespace Snap.Hutao.Control.Image.Implementation;
 [TemplatePart(Name = PartImage, Type = typeof(object))]
 [TemplatePart(Name = PartPlaceholderImage, Type = typeof(object))]
 [DependencyProperty("Stretch", typeof(Stretch), Stretch.Uniform)]
-[DependencyProperty("DecodePixelHeight", typeof(int), 0)]
-[DependencyProperty("DecodePixelWidth", typeof(int), 0)]
-[DependencyProperty("DecodePixelType", typeof(DecodePixelType), DecodePixelType.Physical)]
-[DependencyProperty("IsCacheEnabled", typeof(bool), false)]
-[DependencyProperty("EnableLazyLoading", typeof(bool), false, nameof(EnableLazyLoadingChanged))]
-[DependencyProperty("LazyLoadingThreshold", typeof(double), default(double), nameof(LazyLoadingThresholdChanged))]
 [DependencyProperty("PlaceholderSource", typeof(object), default(object))]
 [DependencyProperty("PlaceholderStretch", typeof(Stretch), Stretch.Uniform)]
 [DependencyProperty("PlaceholderMargin", typeof(Thickness))]
@@ -42,8 +33,6 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
     protected const string FailedState = "Failed";
 
     private CancellationTokenSource? tokenSource;
-    private object? lazyLoadingSource;
-    private bool isInViewport;
 
     public bool IsInitialized { get; private set; }
 
@@ -58,10 +47,10 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
 
     public abstract CompositionBrush GetAlphaMask();
 
-    protected virtual Task<ImageSource?> ProvideCachedResourceAsync(Uri imageUri, CancellationToken token)
+    protected virtual Task<Uri?> ProvideCachedResourceAsync(Uri imageUri, CancellationToken token)
     {
         // By default we just use the built-in UWP image cache provided within the Image control.
-        return Task.FromResult<ImageSource?>(new BitmapImage(imageUri));
+        return Task.FromResult<Uri?>(imageUri);
     }
 
     protected virtual void OnImageOpened(object sender, RoutedEventArgs e)
@@ -80,19 +69,10 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         RemoveImageFailed(OnImageFailed);
 
         Image = GetTemplateChild(PartImage);
-        PlaceholderImage = GetTemplateChild(PartPlaceholderImage);
 
         IsInitialized = true;
 
-        if (Source is null || !EnableLazyLoading || isInViewport)
-        {
-            lazyLoadingSource = null;
-            SetSource(Source);
-        }
-        else
-        {
-            lazyLoadingSource = Source;
-        }
+        SetSource(Source);
 
         AttachImageOpened(OnImageOpened);
         AttachImageFailed(OnImageFailed);
@@ -148,33 +128,6 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         }
     }
 
-    private static void EnableLazyLoadingChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
-    {
-        if (d is not ImageExBase control)
-        {
-            return;
-        }
-
-        bool value = (bool)e.NewValue;
-        if (value)
-        {
-            control.LayoutUpdated += control.OnImageExBaseLayoutUpdated;
-            control.InvalidateLazyLoading();
-        }
-        else
-        {
-            control.LayoutUpdated -= control.OnImageExBaseLayoutUpdated;
-        }
-    }
-
-    private static void LazyLoadingThresholdChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
-    {
-        if (d is ImageExBase { EnableLazyLoading: true } control)
-        {
-            control.InvalidateLazyLoading();
-        }
-    }
-
     private static void SourceChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
     {
         if (d is not ImageExBase control)
@@ -187,15 +140,7 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
             return;
         }
 
-        if (e.NewValue is null || !control.EnableLazyLoading || control.isInViewport)
-        {
-            control.lazyLoadingSource = null;
-            control.SetSource(e.NewValue);
-        }
-        else
-        {
-            control.lazyLoadingSource = e.NewValue;
-        }
+        control.SetSource(e.NewValue);
     }
 
     private static bool IsHttpUri(Uri uri)
@@ -203,11 +148,8 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         return uri.IsAbsoluteUri && (uri.Scheme == "http" || uri.Scheme == "https");
     }
 
-    private void AttachSource(ImageSource? source)
+    private void AttachSource(BitmapImage? source, Uri? uri)
     {
-        // Setting the source at this point should call ImageExOpened/VisualStateManager.GoToState
-        // as we register to both the ImageOpened/ImageFailed events of the underlying control.
-        // We only need to call those methods if we fail in other cases before we get here.
         if (Image is Microsoft.UI.Xaml.Controls.Image image)
         {
             image.Source = source;
@@ -221,13 +163,15 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         {
             VisualStateManager.GoToState(this, UnloadedState, true);
         }
-        else if (source is BitmapSource { PixelHeight: > 0, PixelWidth: > 0 })
+        else
         {
+            // https://learn.microsoft.com/en-us/windows/uwp/debug-test-perf/optimize-animations-and-media#optimize-image-resources
+            source.UriSource = uri;
             VisualStateManager.GoToState(this, LoadedState, true);
         }
     }
 
-    private void AttachPlaceholderSource(ImageSource? source)
+    private void AttachPlaceholderSource(BitmapImage? source, Uri? uri)
     {
         if (PlaceholderImage is Microsoft.UI.Xaml.Controls.Image image)
         {
@@ -242,8 +186,10 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         {
             VisualStateManager.GoToState(this, UnloadedState, true);
         }
-        else if (source is BitmapSource { PixelHeight: > 0, PixelWidth: > 0 })
+        else
         {
+            // https://learn.microsoft.com/en-us/windows/uwp/debug-test-perf/optimize-animations-and-media#optimize-image-resources
+            source.UriSource = uri;
             VisualStateManager.GoToState(this, LoadedState, true);
         }
     }
@@ -256,10 +202,9 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         }
 
         tokenSource?.Cancel();
-
         tokenSource = new CancellationTokenSource();
 
-        AttachSource(null);
+        AttachSource(default, default);
 
         if (source is null)
         {
@@ -268,13 +213,6 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
 
         VisualStateManager.GoToState(this, LoadingState, true);
 
-        if (source as ImageSource is { } imageSource)
-        {
-            AttachSource(imageSource);
-
-            return;
-        }
-
         if (source as Uri is not { } uri)
         {
             string? url = source as string ?? source.ToString();
@@ -319,20 +257,13 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         tokenSource?.Cancel();
         tokenSource = new();
 
-        AttachPlaceholderSource(null);
+        AttachPlaceholderSource(default, default);
 
         if (source is null)
         {
             return;
         }
 
-        if (source as ImageSource is { } imageSource)
-        {
-            AttachPlaceholderSource(imageSource);
-
-            return;
-        }
-
         if (source as Uri is not { } uri)
         {
             string? url = source as string ?? source.ToString();
@@ -354,13 +285,13 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
                 return;
             }
 
-            ImageSource? img = await ProvideCachedResourceAsync(uri, tokenSource.Token).ConfigureAwait(true);
+            Uri? actualUri = await ProvideCachedResourceAsync(uri, tokenSource.Token).ConfigureAwait(true);
 
             ArgumentNullException.ThrowIfNull(tokenSource);
             if (!tokenSource.IsCancellationRequested)
             {
                 // Only attach our image if we still have a valid request.
-                AttachPlaceholderSource(img);
+                AttachPlaceholderSource(new BitmapImage(), actualUri);
             }
         }
         catch (OperationCanceledException)
@@ -379,99 +310,13 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
             return;
         }
 
-        if (IsCacheEnabled)
+        Uri? actualUri = await ProvideCachedResourceAsync(imageUri, token).ConfigureAwait(true);
+
+        ArgumentNullException.ThrowIfNull(tokenSource);
+        if (!tokenSource.IsCancellationRequested)
         {
-            ImageSource? img = await ProvideCachedResourceAsync(imageUri, token).ConfigureAwait(true);
-
-            ArgumentNullException.ThrowIfNull(tokenSource);
-            if (!tokenSource.IsCancellationRequested)
-            {
-                // Only attach our image if we still have a valid request.
-                AttachSource(img);
-            }
-        }
-        else if (string.Equals(imageUri.Scheme, "data", StringComparison.OrdinalIgnoreCase))
-        {
-            string source = imageUri.OriginalString;
-            const string base64Head = "base64,";
-            int index = source.IndexOf(base64Head, StringComparison.Ordinal);
-            if (index >= 0)
-            {
-                byte[] bytes = Convert.FromBase64String(source[(index + base64Head.Length)..]);
-                BitmapImage bitmap = new();
-                await bitmap.SetSourceAsync(new MemoryStream(bytes).AsRandomAccessStream());
-
-                ArgumentNullException.ThrowIfNull(tokenSource);
-                if (!tokenSource.IsCancellationRequested)
-                {
-                    AttachSource(bitmap);
-                }
-            }
-        }
-        else
-        {
-            AttachSource(new BitmapImage(imageUri)
-            {
-                CreateOptions = BitmapCreateOptions.IgnoreImageCache,
-            });
-        }
-    }
-
-    private void OnImageExBaseLayoutUpdated(object? sender, object e)
-    {
-        InvalidateLazyLoading();
-    }
-
-    private void InvalidateLazyLoading()
-    {
-        if (!IsLoaded)
-        {
-            isInViewport = false;
-            return;
-        }
-
-        // Find the first ascendant ScrollViewer, if not found, use the root element.
-        FrameworkElement? hostElement = default;
-        IEnumerable<FrameworkElement> ascendants = this.FindAscendants().OfType<FrameworkElement>();
-        foreach (FrameworkElement ascendant in ascendants)
-        {
-            hostElement = ascendant;
-            if (hostElement is Microsoft.UI.Xaml.Controls.ScrollViewer)
-            {
-                break;
-            }
-        }
-
-        if (hostElement is null)
-        {
-            isInViewport = false;
-            return;
-        }
-
-        Rect controlRect = TransformToVisual(hostElement).TransformBounds(StructMarshal.Rect(ActualSize));
-        double lazyLoadingThreshold = LazyLoadingThreshold;
-
-        // Left/Top 1 Threshold, Right/Bottom 2 Threshold
-        Rect hostRect = new(
-            0 - lazyLoadingThreshold,
-            0 - lazyLoadingThreshold,
-            hostElement.ActualWidth + (2 * lazyLoadingThreshold),
-            hostElement.ActualHeight + (2 * lazyLoadingThreshold));
-
-        if (controlRect.IntersectsWith(hostRect))
-        {
-            isInViewport = true;
-
-            if (lazyLoadingSource is not null)
-            {
-                object source = lazyLoadingSource;
-                lazyLoadingSource = null;
-                SetSource(source);
-            }
-        }
-        else
-        {
-            isInViewport = false;
+            // Only attach our image if we still have a valid request.
+            AttachSource(new BitmapImage(), actualUri);
         }
     }
 }

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/Media/Rgba32.cs

@@ -8,45 +8,19 @@ using Windows.UI;
 
 namespace Snap.Hutao.Control.Media;
 
-/// <summary>
-/// RGBA 颜色
-/// </summary>
 [HighQuality]
 internal struct Rgba32
 {
-    /// <summary>
-    /// R
-    /// </summary>
     public byte R;
-
-    /// <summary>
-    /// G
-    /// </summary>
     public byte G;
-
-    /// <summary>
-    /// B
-    /// </summary>
     public byte B;
-
-    /// <summary>
-    /// A
-    /// </summary>
     public byte A;
 
-    /// <summary>
-    /// 构造一个新的 RGBA8 颜色
-    /// </summary>
-    /// <param name="hex">色值字符串</param>
     public Rgba32(string hex)
         : this(hex.Length == 6 ? Convert.ToUInt32($"{hex}FF", 16) : Convert.ToUInt32(hex, 16))
     {
     }
 
-    /// <summary>
-    /// 使用 RGBA 代码初始化新的结构
-    /// </summary>
-    /// <param name="xrgbaCode">RGBA 代码</param>
     public unsafe Rgba32(uint xrgbaCode)
     {
         // uint layout: 0xRRGGBBAA is AABBGGRR
@@ -80,11 +54,6 @@ internal struct Rgba32
         return *(Color*)&rgba;
     }
 
-    /// <summary>
-    /// 从 HSL 颜色转换
-    /// </summary>
-    /// <param name="hsl">HSL 颜色</param>
-    /// <returns>RGBA8颜色</returns>
     public static Rgba32 FromHsl(Hsla32 hsl)
     {
         double chroma = (1 - Math.Abs((2 * hsl.L) - 1)) * hsl.S;
@@ -138,10 +107,6 @@ internal struct Rgba32
         return new(r, g, b, a);
     }
 
-    /// <summary>
-    /// 转换到 HSL 颜色
-    /// </summary>
-    /// <returns>HSL 颜色</returns>
     public readonly Hsla32 ToHsl()
     {
         const double toDouble = 1.0 / 255;

src/Snap.Hutao/Snap.Hutao/Control/Media/Rgba64.cs

@@ -0,0 +1,14 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+// Some part of this file came from:
+// https://github.com/xunkong/desktop/tree/main/src/Desktop/Desktop/Pages/CharacterInfoPage.xaml.cs
+
+namespace Snap.Hutao.Control.Media;
+
+internal struct Rgba64
+{
+    public Half R;
+    public Half G;
+    public Half B;
+    public Half A;
+}

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

@@ -104,6 +104,7 @@ internal class ScopedPage : Page
 
                 // Dispose the scope
                 pageScope.Dispose();
+                GC.Collect(GC.MaxGeneration, GCCollectionMode.Aggressive, true);
             }
         }
     }

src/Snap.Hutao/Snap.Hutao/Control/ScopedPageScopeReferenceTracker.cs

@@ -22,7 +22,6 @@ internal sealed partial class ScopedPageScopeReferenceTracker : IScopedPageScope
 
     public IServiceScope CreateScope()
     {
-        GC.Collect(GC.MaxGeneration, GCCollectionMode.Aggressive, true);
         IServiceScope currentScope = serviceProvider.CreateScope();
 
         // In case previous one is not disposed.

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/Theme/Uri.xaml

@@ -17,8 +17,13 @@
     <x:String x:Key="UI_Icon_Intee_Explore_1">https://api.snapgenshin.com/static/raw/Bg/UI_Icon_Intee_Explore_1.png</x:String>
     <x:String x:Key="UI_ImgSign_ItemIcon">https://api.snapgenshin.com/static/raw/Bg/UI_ImgSign_ItemIcon.png</x:String>
     <x:String x:Key="UI_ItemIcon_None">https://api.snapgenshin.com/static/raw/Bg/UI_ItemIcon_None.png</x:String>
-    <x:String x:Key="UI_MarkQuest_Events_Proce">https://api.snapgenshin.com/static/raw/Bg/UI_MarkQuest_Events_Proce.png</x:String>
-    <x:String x:Key="UI_MarkTower">https://api.snapgenshin.com/static/raw/Bg/UI_MarkTower.png</x:String>
+
+    <!--  Mark  -->
+    <x:String x:Key="UI_MarkQuest_Events_Proce">https://api.snapgenshin.com/static/raw/Mark/UI_MarkQuest_Events_Proce.png</x:String>
+    <x:String x:Key="UI_MarkQuest_Events_Start">https://api.snapgenshin.com/static/raw/Mark/UI_MarkQuest_Events_Start.png</x:String>
+    <x:String x:Key="UI_MarkQuest_Main_Proce">https://api.snapgenshin.com/static/raw/Mark/UI_MarkQuest_Main_Proce.png</x:String>
+    <x:String x:Key="UI_MarkQuest_Main_Start">https://api.snapgenshin.com/static/raw/Mark/UI_MarkQuest_Main_Start.png</x:String>
+    <x:String x:Key="UI_MarkTower">https://api.snapgenshin.com/static/raw/Mark/UI_MarkTower.png</x:String>
 
     <!--  ItemIcon  -->
     <x:String x:Key="UI_ItemIcon_201">https://api.snapgenshin.com/static/raw/ItemIcon/UI_ItemIcon_201.png</x:String>

src/Snap.Hutao/Snap.Hutao/Control/TokenizingTextBox/ITokenStringContainer.cs

@@ -0,0 +1,11 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Control.TokenizingTextBox;
+
+internal interface ITokenStringContainer
+{
+    string Text { get; set; }
+
+    bool IsLast { get; }
+}

src/Snap.Hutao/Snap.Hutao/Control/TokenizingTextBox/InterspersedObservableCollection.cs

@@ -0,0 +1,350 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using CommunityToolkit.WinUI.Helpers;
+using System.Collections;
+using System.Collections.Specialized;
+
+namespace Snap.Hutao.Control.TokenizingTextBox;
+
+internal sealed class InterspersedObservableCollection : IList, IEnumerable<object>, INotifyCollectionChanged
+{
+    private readonly Dictionary<int?, object> interspersedObjects = [];
+    private bool isInsertingOriginal;
+
+    public InterspersedObservableCollection(object itemsSource)
+    {
+        if (itemsSource is not IList list)
+        {
+            throw new ArgumentException("The input items source must be assignable to the System.Collections.IList type.");
+        }
+
+        ItemsSource = list;
+
+        if (ItemsSource is INotifyCollectionChanged notifier)
+        {
+            WeakEventListener<InterspersedObservableCollection, object?, NotifyCollectionChangedEventArgs> weakPropertyChangedListener = new(this)
+            {
+                OnEventAction = static (instance, source, eventArgs) => instance.ItemsSource_CollectionChanged(source, eventArgs),
+                OnDetachAction = (weakEventListener) => notifier.CollectionChanged -= weakEventListener.OnEvent, // Use Local Reference Only
+            };
+            notifier.CollectionChanged += weakPropertyChangedListener.OnEvent;
+        }
+    }
+
+    public event NotifyCollectionChangedEventHandler? CollectionChanged;
+
+    public IList ItemsSource { get; private set; }
+
+    public bool IsFixedSize => false;
+
+    public bool IsReadOnly => false;
+
+    public int Count => ItemsSource.Count + interspersedObjects.Count;
+
+    public bool IsSynchronized => false;
+
+    public object SyncRoot => new();
+
+    public object? this[int index]
+    {
+        get
+        {
+            if (interspersedObjects.TryGetValue(index, out object? value))
+            {
+                return value;
+            }
+
+            // Find out the number of elements in our dictionary with keys below ours.
+            return ItemsSource[ToInnerIndex(index)];
+        }
+        set => throw new NotImplementedException();
+    }
+
+    public void Insert(int index, object? obj)
+    {
+        MoveKeysForward(index, 1); // Move existing keys at index over to make room for new item
+
+        ArgumentNullException.ThrowIfNull(obj);
+        interspersedObjects[index] = obj;
+
+        CollectionChanged?.Invoke(this, new(NotifyCollectionChangedAction.Add, obj, index));
+    }
+
+    public void InsertAt(int outerIndex, object obj)
+    {
+        // Find out our closest index based on interspersed keys
+        int index = outerIndex - interspersedObjects.Keys.Count(key => key!.Value < outerIndex); // Note: we exclude the = from ToInnerIndex here
+
+        // If we're inserting where we would normally, then just do that, otherwise we need extra room to not move other keys
+        if (index != outerIndex)
+        {
+            MoveKeysForward(outerIndex, 1); // Skip over until the current spot unlike normal
+
+            isInsertingOriginal = true; // Prevent Collection callback from moving keys forward on insert
+        }
+
+        // Insert into original collection
+        ItemsSource.Insert(index, obj);
+
+        // TODO: handle manipulation/notification if not observable
+    }
+
+    public IEnumerator<object> GetEnumerator()
+    {
+        int i = 0; // Index of our current 'virtual' position
+        int count = 0;
+        int realized = 0;
+
+        foreach (object element in ItemsSource)
+        {
+            while (interspersedObjects.TryGetValue(i++, out object? obj))
+            {
+                realized++; // Track interspersed items used
+
+                yield return obj;
+            }
+
+            count++; // Track original items used
+
+            yield return element;
+        }
+
+        // Add any remaining items in our interspersed collection past the index we reached in the original collection
+        if (realized < interspersedObjects.Count)
+        {
+            // Only select items past our current index, but make sure we've sorted them by their index as well.
+            foreach ((int? _, object value) in interspersedObjects.Where(kvp => kvp.Key >= i).OrderBy(kvp => kvp.Key))
+            {
+                yield return value;
+            }
+        }
+    }
+
+    public int Add(object? value)
+    {
+        ArgumentNullException.ThrowIfNull(value);
+        int index = ItemsSource.Add(value); //// TODO: If the collection isn't observable, we should do manipulations/notifications here...?
+        return ToOuterIndex(index);
+    }
+
+    public void Clear()
+    {
+        ItemsSource.Clear();
+        interspersedObjects.Clear();
+    }
+
+    public bool Contains(object? value)
+    {
+        ArgumentNullException.ThrowIfNull(value);
+        return interspersedObjects.ContainsValue(value) || ItemsSource.Contains(value);
+    }
+
+    public int IndexOf(object? value)
+    {
+        ArgumentNullException.ThrowIfNull(value);
+        (int? key, object _) = ItemKeySearch(value);
+
+        if (key is int k)
+        {
+            return k;
+        }
+
+        int index = ItemsSource.IndexOf(value);
+
+        // Find out the number of elements in our dictionary with keys below ours.
+        return index == -1 ? -1 : ToOuterIndex(index);
+    }
+
+    public void Remove(object? value)
+    {
+        ArgumentNullException.ThrowIfNull(value);
+        (int? key, object obj) = ItemKeySearch(value);
+
+        if (key is int k)
+        {
+            interspersedObjects.Remove(k);
+
+            MoveKeysBackward(k, 1); // Move other interspersed items back
+
+            CollectionChanged?.Invoke(this, new NotifyCollectionChangedEventArgs(NotifyCollectionChangedAction.Remove, obj, k));
+        }
+        else
+        {
+            ItemsSource.Remove(value); // TODO: If not observable, update indices?
+        }
+    }
+
+    public void RemoveAt(int index)
+    {
+        throw new NotImplementedException();
+    }
+
+    public void CopyTo(Array array, int index)
+    {
+        throw new NotImplementedException();
+    }
+
+    IEnumerator IEnumerable.GetEnumerator()
+    {
+        return GetEnumerator();
+    }
+
+    private void ItemsSource_CollectionChanged(object? source, NotifyCollectionChangedEventArgs eventArgs)
+    {
+        switch (eventArgs.Action)
+        {
+            case NotifyCollectionChangedAction.Add:
+                // Shift any existing interspersed items after the inserted item
+                ArgumentNullException.ThrowIfNull(eventArgs.NewItems);
+                int count = eventArgs.NewItems.Count;
+
+                if (count > 0)
+                {
+                    if (!isInsertingOriginal)
+                    {
+                        MoveKeysForward(eventArgs.NewStartingIndex, count);
+                    }
+
+                    isInsertingOriginal = false;
+
+                    CollectionChanged?.Invoke(this, new(NotifyCollectionChangedAction.Add, eventArgs.NewItems, ToOuterIndex(eventArgs.NewStartingIndex)));
+                }
+
+                break;
+            case NotifyCollectionChangedAction.Remove:
+                ArgumentNullException.ThrowIfNull(eventArgs.OldItems);
+                count = eventArgs.OldItems.Count;
+
+                if (count > 0)
+                {
+                    int outerIndex = ToOuterIndexAfterRemoval(eventArgs.OldStartingIndex);
+
+                    MoveKeysBackward(outerIndex, count);
+
+                    CollectionChanged?.Invoke(this, new(NotifyCollectionChangedAction.Remove, eventArgs.OldItems, outerIndex));
+                }
+
+                break;
+            case NotifyCollectionChangedAction.Reset:
+
+                ReadjustKeys();
+
+                // TODO: ListView doesn't like this notification and throws a visual tree duplication exception...
+                // Not sure what to do with that yet...
+                CollectionChanged?.Invoke(this, eventArgs);
+                break;
+        }
+    }
+
+    private void MoveKeysForward(int pivot, int amount)
+    {
+        // Sort in reverse order to work from highest to lowest
+        foreach (int? key in interspersedObjects.Keys.OrderByDescending(v => v))
+        {
+            if (key < pivot) //// If it's the last item in the collection, we still want to move our last key, otherwise we'd use <=
+            {
+                break;
+            }
+
+            interspersedObjects[key + amount] = interspersedObjects[key];
+            interspersedObjects.Remove(key);
+        }
+    }
+
+    private void MoveKeysBackward(int pivot, int amount)
+    {
+        // Sort in regular order to work from the earliest indices onwards
+        foreach (int? key in interspersedObjects.Keys.OrderBy(v => v))
+        {
+            // Skip elements before the pivot point
+            if (key <= pivot) //// Include pivot point as that's the point where we start modifying beyond
+            {
+                continue;
+            }
+
+            interspersedObjects[key - amount] = interspersedObjects[key];
+            interspersedObjects.Remove(key);
+        }
+    }
+
+    private void ReadjustKeys()
+    {
+        int count = ItemsSource.Count;
+        int existing = 0;
+
+        foreach (int? key in interspersedObjects.Keys.OrderBy(v => v))
+        {
+            if (key <= count)
+            {
+                existing++;
+                continue;
+            }
+
+            interspersedObjects[count + existing++] = interspersedObjects[key];
+            interspersedObjects.Remove(key);
+        }
+    }
+
+    private int ToInnerIndex(int outerIndex)
+    {
+        ArgumentOutOfRangeException.ThrowIfGreaterThanOrEqual(outerIndex, Count);
+
+        if (interspersedObjects.ContainsKey(outerIndex))
+        {
+            throw new ArgumentException("The outer index can't be inserted as a key to the original collection.");
+        }
+
+        return outerIndex - interspersedObjects.Keys.Count(key => key!.Value <= outerIndex);
+    }
+
+    private int ToOuterIndex(int innerIndex)
+    {
+        ArgumentOutOfRangeException.ThrowIfGreaterThanOrEqual(innerIndex, ItemsSource.Count);
+
+        foreach ((int? key, object _) in interspersedObjects.OrderBy(v => v.Key))
+        {
+            if (innerIndex >= key)
+            {
+                innerIndex++;
+            }
+            else
+            {
+                break;
+            }
+        }
+
+        return innerIndex;
+    }
+
+    private int ToOuterIndexAfterRemoval(int innerIndexToProject)
+    {
+        ArgumentOutOfRangeException.ThrowIfGreaterThanOrEqual(innerIndexToProject, ItemsSource.Count + 1);
+
+        //// TODO: Deal with bounds (0 / Count)? Or is it the same?
+
+        foreach ((int? key, object _) in interspersedObjects.OrderBy(v => v.Key))
+        {
+            if (innerIndexToProject >= key)
+            {
+                innerIndexToProject++;
+            }
+            else
+            {
+                break;
+            }
+        }
+
+        return innerIndexToProject;
+    }
+
+    private KeyValuePair<int?, object> ItemKeySearch(object value)
+    {
+        if (value is null)
+        {
+            return interspersedObjects.FirstOrDefault(kvp => kvp.Value is null);
+        }
+
+        return interspersedObjects.FirstOrDefault(kvp => kvp.Value.Equals(value));
+    }
+}

src/Snap.Hutao/Snap.Hutao/Control/TokenizingTextBox/PretokenStringContainer.cs

@@ -0,0 +1,27 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.UI.Xaml;
+
+namespace Snap.Hutao.Control.TokenizingTextBox;
+
+[DependencyProperty("Text", typeof(string))]
+internal sealed partial class PretokenStringContainer : DependencyObject, ITokenStringContainer
+{
+    public PretokenStringContainer(bool isLast = false)
+    {
+        IsLast = isLast;
+    }
+
+    public PretokenStringContainer(string text)
+    {
+        Text = text;
+    }
+
+    public bool IsLast { get; private set; }
+
+    public override string ToString()
+    {
+        return Text;
+    }
+}

src/Snap.Hutao/Snap.Hutao/Control/TokenizingTextBox/TokenItemAddingEventArgs.cs

@@ -0,0 +1,18 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using CommunityToolkit.Common.Deferred;
+
+namespace Snap.Hutao.Control.TokenizingTextBox;
+
+internal sealed class TokenItemAddingEventArgs : DeferredCancelEventArgs
+{
+    public TokenItemAddingEventArgs(string token)
+    {
+        TokenText = token;
+    }
+
+    public string TokenText { get; private set; }
+
+    public object? Item { get; set; }
+}

src/Snap.Hutao/Snap.Hutao/Control/TokenizingTextBox/TokenItemRemovingEventArgs.cs

@@ -0,0 +1,19 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using CommunityToolkit.Common.Deferred;
+
+namespace Snap.Hutao.Control.TokenizingTextBox;
+
+internal sealed class TokenItemRemovingEventArgs : DeferredCancelEventArgs
+{
+    public TokenItemRemovingEventArgs(object item, TokenizingTextBoxItem token)
+    {
+        Item = item;
+        Token = token;
+    }
+
+    public object Item { get; private set; }
+
+    public TokenizingTextBoxItem Token { get; private set; }
+}

src/Snap.Hutao/Snap.Hutao/Control/TokenizingTextBox/TokenizingTextBox.cs

@@ -0,0 +1,951 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using CommunityToolkit.WinUI;
+using CommunityToolkit.WinUI.Deferred;
+using CommunityToolkit.WinUI.Helpers;
+using Microsoft.UI.Input;
+using Microsoft.UI.Xaml;
+using Microsoft.UI.Xaml.Automation.Peers;
+using Microsoft.UI.Xaml.Controls;
+using Microsoft.UI.Xaml.Input;
+using System.Collections.ObjectModel;
+using Windows.ApplicationModel.DataTransfer;
+using Windows.Foundation;
+using Windows.Foundation.Metadata;
+using Windows.System;
+using Windows.UI.Core;
+using DispatcherQueue = Microsoft.UI.Dispatching.DispatcherQueue;
+using DispatcherQueuePriority = Microsoft.UI.Dispatching.DispatcherQueuePriority;
+
+namespace Snap.Hutao.Control.TokenizingTextBox;
+
+[DependencyProperty("AutoSuggestBoxStyle", typeof(Style))]
+[DependencyProperty("AutoSuggestBoxTextBoxStyle", typeof(Style))]
+[DependencyProperty("MaximumTokens", typeof(int), -1, nameof(OnMaximumTokensChanged))]
+[DependencyProperty("PlaceholderText", typeof(string))]
+[DependencyProperty("QueryIcon", typeof(IconSource))]
+[DependencyProperty("SuggestedItemsSource", typeof(object))]
+[DependencyProperty("SuggestedItemTemplate", typeof(DataTemplate))]
+[DependencyProperty("SuggestedItemTemplateSelector", typeof(DataTemplateSelector))]
+[DependencyProperty("SuggestedItemContainerStyle", typeof(Style))]
+[DependencyProperty("TabNavigateBackOnArrow", typeof(bool), false)]
+[DependencyProperty("Text", typeof(string), default, nameof(TextPropertyChanged))]
+[DependencyProperty("TextMemberPath", typeof(string))]
+[DependencyProperty("TokenItemTemplate", typeof(DataTemplate))]
+[DependencyProperty("TokenItemTemplateSelector", typeof(DataTemplateSelector))]
+[DependencyProperty("TokenDelimiter", typeof(string), " ")]
+[DependencyProperty("TokenSpacing", typeof(double))]
+[TemplatePart(Name = NormalState, Type = typeof(VisualState))]
+[TemplatePart(Name = PointerOverState, Type = typeof(VisualState))]
+[TemplatePart(Name = FocusedState, Type = typeof(VisualState))]
+[TemplatePart(Name = UnfocusedState, Type = typeof(VisualState))]
+[TemplatePart(Name = MaxReachedState, Type = typeof(VisualState))]
+[TemplatePart(Name = MaxUnreachedState, Type = typeof(VisualState))]
+[SuppressMessage("", "SA1124")]
+internal partial class TokenizingTextBox : ListViewBase
+{
+    public const string NormalState = "Normal";
+    public const string PointerOverState = "PointerOver";
+    public const string FocusedState = "Focused";
+    public const string UnfocusedState = "Unfocused";
+    public const string MaxReachedState = "MaxReachedState";
+    public const string MaxUnreachedState = "MaxUnreachedState";
+
+    private DispatcherQueue dispatcherQueue;
+    private InterspersedObservableCollection innerItemsSource;
+    private ITokenStringContainer currentTextEdit; // Don't update this directly outside of initialization, use UpdateCurrentTextEdit Method
+    private ITokenStringContainer lastTextEdit;
+
+    public TokenizingTextBox()
+    {
+        // Setup our base state of our collection
+        innerItemsSource = new InterspersedObservableCollection(new ObservableCollection<object>()); // TODO: Test this still will let us bind to ItemsSource in XAML?
+        currentTextEdit = lastTextEdit = new PretokenStringContainer(true);
+        innerItemsSource.Insert(innerItemsSource.Count, currentTextEdit);
+        ItemsSource = innerItemsSource;
+        //// TODO: Consolidate with callback below for ItemsSourceProperty changed?
+
+        DefaultStyleKey = typeof(TokenizingTextBox);
+
+        // TODO: Do we want to support ItemsSource better? Need to investigate how that works with adding...
+        RegisterPropertyChangedCallback(ItemsSourceProperty, ItemsSource_PropertyChanged);
+        PreviewKeyDown += TokenizingTextBox_PreviewKeyDown;
+        PreviewKeyUp += TokenizingTextBox_PreviewKeyUp;
+        CharacterReceived += TokenizingTextBox_CharacterReceived;
+        ItemClick += TokenizingTextBox_ItemClick;
+
+        dispatcherQueue = DispatcherQueue;
+    }
+
+    public event TypedEventHandler<Microsoft.UI.Xaml.Controls.AutoSuggestBox, AutoSuggestBoxTextChangedEventArgs>? TextChanged;
+
+    public event TypedEventHandler<Microsoft.UI.Xaml.Controls.AutoSuggestBox, AutoSuggestBoxSuggestionChosenEventArgs>? SuggestionChosen;
+
+    public event TypedEventHandler<Microsoft.UI.Xaml.Controls.AutoSuggestBox, AutoSuggestBoxQuerySubmittedEventArgs>? QuerySubmitted;
+
+    public event TypedEventHandler<TokenizingTextBox, TokenItemAddingEventArgs>? TokenItemAdding;
+
+    public event TypedEventHandler<TokenizingTextBox, object>? TokenItemAdded;
+
+    public event TypedEventHandler<TokenizingTextBox, TokenItemRemovingEventArgs>? TokenItemRemoving;
+
+    public event TypedEventHandler<TokenizingTextBox, object>? TokenItemRemoved;
+
+    private enum MoveDirection
+    {
+        Next,
+        Previous,
+    }
+
+    public static bool IsShiftPressed => InputKeyboardSource.GetKeyStateForCurrentThread(VirtualKey.Shift).HasFlag(CoreVirtualKeyStates.Down);
+
+    public static bool IsXamlRootAvailable { get; } = ApiInformation.IsPropertyPresent("Windows.UI.Xaml.UIElement", "XamlRoot");
+
+    public static bool IsControlPressed => InputKeyboardSource.GetKeyStateForCurrentThread(VirtualKey.Control).HasFlag(CoreVirtualKeyStates.Down);
+
+    public bool PauseTokenClearOnFocus { get; set; }
+
+    public bool IsClearingForClick { get; set; }
+
+    public string SelectedTokenText
+    {
+        get => PrepareSelectionForClipboard();
+    }
+
+    public void RaiseQuerySubmitted(Microsoft.UI.Xaml.Controls.AutoSuggestBox sender, AutoSuggestBoxQuerySubmittedEventArgs args)
+    {
+        QuerySubmitted?.Invoke(sender, args);
+    }
+
+    public void RaiseSuggestionChosen(Microsoft.UI.Xaml.Controls.AutoSuggestBox sender, AutoSuggestBoxSuggestionChosenEventArgs args)
+    {
+        SuggestionChosen?.Invoke(sender, args);
+    }
+
+    public void RaiseTextChanged(Microsoft.UI.Xaml.Controls.AutoSuggestBox sender, AutoSuggestBoxTextChangedEventArgs args)
+    {
+        TextChanged?.Invoke(sender, args);
+    }
+
+    public void AddTokenItem(object data, bool atEnd = false)
+    {
+        _ = AddTokenAsync(data, atEnd);
+    }
+
+    public async ValueTask ClearAsync()
+    {
+        while (innerItemsSource.Count > 1)
+        {
+            if (ContainerFromItem(innerItemsSource[0]) is TokenizingTextBoxItem container)
+            {
+                if (!await RemoveTokenAsync(container, innerItemsSource[0]).ConfigureAwait(true))
+                {
+                    // if a removal operation fails then stop the clear process
+                    break;
+                }
+            }
+        }
+
+        // Clear the active pretoken string.
+        // Setting the text property directly avoids a delay when setting the text in the autosuggest box.
+        Text = string.Empty;
+    }
+
+    public async Task AddTokenAsync(object data, bool? atEnd = default)
+    {
+        if (MaximumTokens >= 0 && MaximumTokens <= innerItemsSource.ItemsSource.Count)
+        {
+            // No tokens for you
+            return;
+        }
+
+        if (data is string str && TokenItemAdding is not null)
+        {
+            TokenItemAddingEventArgs tiaea = new(str);
+            await TokenItemAdding.InvokeAsync(this, tiaea).ConfigureAwait(true);
+
+            if (tiaea.Cancel)
+            {
+                return;
+            }
+
+            if (tiaea.Item is not null)
+            {
+                data = tiaea.Item; // Transformed by event implementor
+            }
+        }
+
+        // If we've been typing in the last box, just add this to the end of our collection
+        if (atEnd == true || currentTextEdit == lastTextEdit)
+        {
+            innerItemsSource.InsertAt(innerItemsSource.Count - 1, data);
+        }
+        else
+        {
+            // Otherwise, we'll insert before our current box
+            ITokenStringContainer edit = currentTextEdit;
+            int index = innerItemsSource.IndexOf(edit);
+
+            // Insert our new data item at the location of our textbox
+            innerItemsSource.InsertAt(index, data);
+
+            // Remove our textbox
+            innerItemsSource.Remove(edit);
+        }
+
+        // Focus back to our end box as Outlook does.
+        TokenizingTextBoxItem last = (TokenizingTextBoxItem)ContainerFromItem(lastTextEdit);
+        last?.AutoSuggestTextBox.Focus(FocusState.Keyboard);
+
+        TokenItemAdded?.Invoke(this, data);
+
+        GuardAgainstPlaceholderTextLayoutIssue();
+    }
+
+    public async ValueTask RemoveAllSelectedTokens()
+    {
+        while (SelectedItems.Count > 0)
+        {
+            if (ContainerFromItem(SelectedItems[0]) is TokenizingTextBoxItem container)
+            {
+                if (IndexFromContainer(container) != Items.Count - 1)
+                {
+                    // if its a text box, remove any selected text, and if its then empty remove the container, unless its focused
+                    if (SelectedItems[0] is ITokenStringContainer)
+                    {
+                        TextBox asb = container.AutoSuggestTextBox;
+
+                        // grab any selected text
+                        string tempStr = asb.SelectionStart == 0
+                            ? string.Empty
+                            : asb.Text[..asb.SelectionStart];
+                        tempStr +=
+                            asb.SelectionStart +
+                            asb.SelectionLength < asb.Text.Length
+                                ? asb.Text[(asb.SelectionStart + asb.SelectionLength)..]
+                                : string.Empty;
+
+                        if (tempStr.Length is 0)
+                        {
+                            // Need to be careful not to remove the last item in the list
+                            await RemoveTokenAsync(container).ConfigureAwait(true);
+                        }
+                        else
+                        {
+                            asb.Text = tempStr;
+                        }
+                    }
+                    else
+                    {
+                        // if the item is a token just remove it.
+                        await RemoveTokenAsync(container).ConfigureAwait(true);
+                    }
+                }
+                else
+                {
+                    if (SelectedItems.Count == 1)
+                    {
+                        // at this point we have one selection and its the default textbox.
+                        // stop the iteration here
+                        break;
+                    }
+                }
+            }
+        }
+    }
+
+    public bool SelectPreviousItem(TokenizingTextBoxItem item)
+    {
+        return SelectNewItem(item, -1, i => i > 0);
+    }
+
+    public bool SelectNextItem(TokenizingTextBoxItem item)
+    {
+        return SelectNewItem(item, 1, i => i < Items.Count - 1);
+    }
+
+    public void SelectAllTokensAndText()
+    {
+        void SelectAllTokensAndTextCore()
+        {
+            this.SelectAllSafe();
+
+            // need to synchronize the select all and the focus behavior on the text box
+            // because there is no way to identify that the focus has been set from this point
+            // to avoid instantly clearing the selection of tokens
+            PauseTokenClearOnFocus = true;
+
+            foreach (object? item in Items)
+            {
+                if (item is ITokenStringContainer)
+                {
+                    // grab any selected text
+                    if (ContainerFromItem(item) is TokenizingTextBoxItem pretoken)
+                    {
+                        pretoken.AutoSuggestTextBox.SelectionStart = 0;
+                        pretoken.AutoSuggestTextBox.SelectionLength = pretoken.AutoSuggestTextBox.Text.Length;
+                    }
+                }
+            }
+
+            if (ContainerFromIndex(Items.Count - 1) is TokenizingTextBoxItem container)
+            {
+                container.Focus(FocusState.Programmatic);
+            }
+        }
+
+        _ = dispatcherQueue.EnqueueAsync(SelectAllTokensAndTextCore, DispatcherQueuePriority.Normal);
+    }
+
+    public void DeselectAllTokensAndText(TokenizingTextBoxItem? ignoreItem = default)
+    {
+        this.DeselectAll();
+        ClearAllTextSelections(ignoreItem);
+    }
+
+    protected void UpdateCurrentTextEdit(ITokenStringContainer edit)
+    {
+        currentTextEdit = edit;
+
+        Text = edit.Text; // Update our text property.
+    }
+
+    protected override AutomationPeer OnCreateAutomationPeer()
+    {
+        return new TokenizingTextBoxAutomationPeer(this);
+    }
+
+    /// <inheritdoc/>
+    protected override void OnApplyTemplate()
+    {
+        base.OnApplyTemplate();
+
+        MenuFlyoutItem selectAllMenuItem = new()
+        {
+            Text = "Select all",
+        };
+        selectAllMenuItem.Click += (s, e) => SelectAllTokensAndText();
+        MenuFlyout menuFlyout = new();
+        menuFlyout.Items.Add(selectAllMenuItem);
+
+        if (IsXamlRootAvailable && XamlRoot is not null)
+        {
+            menuFlyout.XamlRoot = XamlRoot;
+        }
+
+        ContextFlyout = menuFlyout;
+    }
+
+    /// <inheritdoc/>
+    protected override DependencyObject GetContainerForItemOverride()
+    {
+        return new TokenizingTextBoxItem();
+    }
+
+    /// <inheritdoc/>
+    protected override bool IsItemItsOwnContainerOverride(object item)
+    {
+        return item is TokenizingTextBoxItem;
+    }
+
+    /// <inheritdoc/>
+    protected override void PrepareContainerForItemOverride(DependencyObject element, object item)
+    {
+        base.PrepareContainerForItemOverride(element, item);
+
+        if (element is TokenizingTextBoxItem tokenitem)
+        {
+            tokenitem.Owner = this;
+
+            tokenitem.ContentTemplateSelector = TokenItemTemplateSelector;
+            tokenitem.ContentTemplate = TokenItemTemplate;
+
+            tokenitem.ClearClicked -= TokenizingTextBoxItem_ClearClicked;
+            tokenitem.ClearClicked += TokenizingTextBoxItem_ClearClicked;
+
+            tokenitem.ClearAllAction -= TokenizingTextBoxItem_ClearAllAction;
+            tokenitem.ClearAllAction += TokenizingTextBoxItem_ClearAllAction;
+
+            tokenitem.GotFocus -= TokenizingTextBoxItem_GotFocus;
+            tokenitem.GotFocus += TokenizingTextBoxItem_GotFocus;
+
+            tokenitem.LostFocus -= TokenizingTextBoxItem_LostFocus;
+            tokenitem.LostFocus += TokenizingTextBoxItem_LostFocus;
+
+            MenuFlyout menuFlyout = new();
+
+            MenuFlyoutItem removeMenuItem = new()
+            {
+                Text = "Remove",
+            };
+            removeMenuItem.Click += (s, e) => TokenizingTextBoxItem_ClearClicked(tokenitem, default);
+
+            menuFlyout.Items.Add(removeMenuItem);
+
+            if (IsXamlRootAvailable && XamlRoot is not null)
+            {
+                menuFlyout.XamlRoot = XamlRoot;
+            }
+
+            MenuFlyoutItem selectAllMenuItem = new()
+            {
+                Text = "Select all",
+            };
+            selectAllMenuItem.Click += (s, e) => SelectAllTokensAndText();
+
+            menuFlyout.Items.Add(selectAllMenuItem);
+
+            tokenitem.ContextFlyout = menuFlyout;
+        }
+    }
+
+    private static void TextPropertyChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
+    {
+        if (d is TokenizingTextBox { currentTextEdit: { } } ttb)
+        {
+            if (e.NewValue is string newValue)
+            {
+                ttb.currentTextEdit.Text = newValue;
+
+                // Notify inner container of text change, see issue #4749
+                TokenizingTextBoxItem item = (TokenizingTextBoxItem)ttb.ContainerFromItem(ttb.currentTextEdit);
+                item?.UpdateText(ttb.currentTextEdit.Text);
+            }
+        }
+    }
+
+    private static void OnMaximumTokensChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
+    {
+        if (d is TokenizingTextBox { MaximumTokens: >= 0 } ttb && e.NewValue is int newMaxTokens)
+        {
+            int tokenCount = ttb.innerItemsSource.ItemsSource.Count;
+            if (tokenCount > 0 && tokenCount > newMaxTokens)
+            {
+                int tokensToRemove = tokenCount - Math.Max(newMaxTokens, 0);
+
+                // Start at the end, remove any extra tokens.
+                for (int i = tokenCount; i > tokenCount - tokensToRemove; --i)
+                {
+                    object? token = ttb.innerItemsSource.ItemsSource[i - 1];
+
+                    if (token is not null)
+                    {
+                        // Force remove the items. No warning and no option to cancel.
+                        ttb.innerItemsSource.Remove(token);
+                        ttb.TokenItemRemoved?.Invoke(ttb, token);
+                    }
+                }
+            }
+        }
+    }
+
+    private void ItemsSource_PropertyChanged(DependencyObject sender, DependencyProperty dp)
+    {
+        // If we're given a different ItemsSource, we need to wrap that collection in our helper class.
+        if (ItemsSource is { } and not InterspersedObservableCollection)
+        {
+            innerItemsSource = new(ItemsSource);
+
+            if (MaximumTokens >= 0 && innerItemsSource.ItemsSource.Count >= MaximumTokens)
+            {
+                // Reduce down to below the max as necessary.
+                int endCount = MaximumTokens > 0 ? MaximumTokens : 0;
+                for (int i = innerItemsSource.ItemsSource.Count - 1; i >= endCount; --i)
+                {
+                    innerItemsSource.Remove(innerItemsSource[i]);
+                }
+            }
+
+            // Add our text box at the end of items and set its default value to our initial text, fix for #4749
+            currentTextEdit = lastTextEdit = new PretokenStringContainer(true) { Text = Text };
+            innerItemsSource.Insert(innerItemsSource.Count, currentTextEdit);
+            ItemsSource = innerItemsSource;
+        }
+    }
+
+    private void TokenizingTextBox_ItemClick(object sender, ItemClickEventArgs e)
+    {
+        // If the user taps an item in the list, make sure to clear any text selection as required
+        // Note, token selection is cleared by the listview default behavior
+        if (!IsControlPressed)
+        {
+            // Set class state flag to prevent click item being immediately deselected
+            IsClearingForClick = true;
+            ClearAllTextSelections(default);
+        }
+    }
+
+    private void TokenizingTextBox_PreviewKeyUp(object sender, KeyRoutedEventArgs e)
+    {
+        switch (e.Key)
+        {
+            case VirtualKey.Escape:
+                // Clear any selection and place the focus back into the text box
+                DeselectAllTokensAndText();
+                FocusPrimaryAutoSuggestBox();
+                break;
+        }
+    }
+
+    private void FocusPrimaryAutoSuggestBox()
+    {
+        if (Items?.Count > 0)
+        {
+            if (ContainerFromIndex(Items.Count - 1) is TokenizingTextBoxItem container)
+            {
+                container.Focus(FocusState.Programmatic);
+            }
+        }
+    }
+
+    private async void TokenizingTextBox_PreviewKeyDown(object sender, KeyRoutedEventArgs e)
+    {
+        switch (e.Key)
+        {
+            case VirtualKey.C:
+                if (IsControlPressed)
+                {
+                    CopySelectedToClipboard();
+                    e.Handled = true;
+                    return;
+                }
+
+                break;
+
+            case VirtualKey.X:
+                if (IsControlPressed)
+                {
+                    CopySelectedToClipboard();
+
+                    // now clear all selected tokens and text, or all if none are selected
+                    await RemoveAllSelectedTokens().ConfigureAwait(false);
+                }
+
+                break;
+
+            // For moving between tokens
+            case VirtualKey.Left:
+                e.Handled = MoveFocusAndSelection(MoveDirection.Previous);
+                return;
+
+            case VirtualKey.Right:
+                e.Handled = MoveFocusAndSelection(MoveDirection.Next);
+                return;
+
+            case VirtualKey.A:
+                // modify the select-all behavior to ensure the text in the edit box gets selected.
+                if (IsControlPressed)
+                {
+                    SelectAllTokensAndText();
+                    e.Handled = true;
+                    return;
+                }
+
+                break;
+        }
+    }
+
+    private async void TokenizingTextBox_CharacterReceived(UIElement sender, CharacterReceivedRoutedEventArgs args)
+    {
+        TokenizingTextBoxItem container = (TokenizingTextBoxItem)ContainerFromItem(currentTextEdit);
+
+        if (container is not null && !(GetFocusedElement().Equals(container.AutoSuggestTextBox) || char.IsControl(args.Character)))
+        {
+            if (SelectedItems.Count > 0)
+            {
+                int index = innerItemsSource.IndexOf(SelectedItems.First());
+
+                await RemoveAllSelectedTokens().ConfigureAwait(false);
+
+                void RemoveOldItems()
+                {
+                    // If we're before the last textbox and it's empty, redirect focus to that one instead
+                    if (index == innerItemsSource.Count - 1 && string.IsNullOrWhiteSpace(lastTextEdit.Text))
+                    {
+                        if (ContainerFromItem(lastTextEdit) is TokenizingTextBoxItem lastContainer)
+                        {
+                            lastContainer.UseCharacterAsUser = true; // Make sure we trigger a refresh of suggested items.
+
+                            lastTextEdit.Text = string.Empty + args.Character;
+
+                            UpdateCurrentTextEdit(lastTextEdit);
+
+                            lastContainer.AutoSuggestTextBox.SelectionStart = 1; // Set position to after our new character inserted
+
+                            lastContainer.AutoSuggestTextBox.Focus(FocusState.Keyboard);
+                        }
+                    }
+                    else
+                    {
+                        //// Otherwise, create a new textbox for this text.
+
+                        UpdateCurrentTextEdit(new PretokenStringContainer((string.Empty + args.Character).Trim())); // Trim so that 'space' isn't inserted and can be used to insert a new box.
+
+                        innerItemsSource.Insert(index, currentTextEdit);
+
+                        void Containerization()
+                        {
+                            if (ContainerFromIndex(index) is TokenizingTextBoxItem newContainer) // Should be our last text box
+                            {
+                                newContainer.UseCharacterAsUser = true; // Make sure we trigger a refresh of suggested items.
+
+                                void WaitForLoad(object s, RoutedEventArgs eargs)
+                                {
+                                    if (newContainer.AutoSuggestTextBox is not null)
+                                    {
+                                        newContainer.AutoSuggestTextBox.SelectionStart = 1; // Set position to after our new character inserted
+
+                                        newContainer.AutoSuggestTextBox.Focus(FocusState.Keyboard);
+                                    }
+
+                                    newContainer.Loaded -= WaitForLoad;
+                                }
+
+                                newContainer.AutoSuggestTextBoxLoaded += WaitForLoad;
+                            }
+                        }
+
+                        // Need to wait for containerization
+                        _ = DispatcherQueue.EnqueueAsync(Containerization, DispatcherQueuePriority.Normal);
+                    }
+                }
+
+                // Wait for removal of old items
+                _ = DispatcherQueue.EnqueueAsync(RemoveOldItems, DispatcherQueuePriority.Normal);
+            }
+            else
+            {
+                // If no items are selected, send input to the last active string container.
+                // This code is only fires during an edgecase where an item is in the process of being deleted and the user inputs a character before the focus has been redirected to a string container.
+                if (innerItemsSource[^1] is ITokenStringContainer textToken)
+                {
+                    if (ContainerFromIndex(Items.Count - 1) is TokenizingTextBoxItem last) // Should be our last text box
+                    {
+                        string text = last.AutoSuggestTextBox.Text;
+                        int selectionStart = last.AutoSuggestTextBox.SelectionStart;
+                        int position = selectionStart > text.Length ? text.Length : selectionStart;
+                        textToken.Text = text[..position] + args.Character + text[position..];
+
+                        last.AutoSuggestTextBox.SelectionStart = position + 1; // Set position to after our new character inserted
+
+                        last.AutoSuggestTextBox.Focus(FocusState.Keyboard);
+                    }
+                }
+            }
+        }
+    }
+
+    private object GetFocusedElement()
+    {
+        if (IsXamlRootAvailable && XamlRoot is not null)
+        {
+            return FocusManager.GetFocusedElement(XamlRoot);
+        }
+        else
+        {
+            return FocusManager.GetFocusedElement();
+        }
+    }
+
+    private void TokenizingTextBoxItem_GotFocus(object sender, RoutedEventArgs e)
+    {
+        // Keep track of our currently focused textbox
+        if (sender is TokenizingTextBoxItem { Content: ITokenStringContainer text })
+        {
+            UpdateCurrentTextEdit(text);
+        }
+    }
+
+    private void TokenizingTextBoxItem_LostFocus(object sender, RoutedEventArgs e)
+    {
+        // Keep track of our currently focused textbox
+        if (sender is TokenizingTextBoxItem { Content: ITokenStringContainer text } &&
+            string.IsNullOrWhiteSpace(text.Text) && text != lastTextEdit)
+        {
+            // We're leaving an inner textbox that's blank, so we'll remove it
+            innerItemsSource.Remove(text);
+
+            UpdateCurrentTextEdit(lastTextEdit);
+
+            GuardAgainstPlaceholderTextLayoutIssue();
+        }
+    }
+
+    private async ValueTask<bool> RemoveTokenAsync(TokenizingTextBoxItem item, object? data = null)
+    {
+        data ??= ItemFromContainer(item);
+
+        if (TokenItemRemoving is not null)
+        {
+            TokenItemRemovingEventArgs tirea = new(data, item);
+            await TokenItemRemoving.InvokeAsync(this, tirea).ConfigureAwait(true);
+
+            if (tirea.Cancel)
+            {
+                return false;
+            }
+        }
+
+        innerItemsSource.Remove(data);
+
+        TokenItemRemoved?.Invoke(this, data);
+
+        GuardAgainstPlaceholderTextLayoutIssue();
+
+        return true;
+    }
+
+    private void GuardAgainstPlaceholderTextLayoutIssue()
+    {
+        // If the *PlaceholderText is visible* on the last AutoSuggestBox, it can incorrectly layout itself
+        // when the *ASB has focus*. We think this is an optimization in the platform, but haven't been able to
+        // isolate a straight-reproduction of this issue outside of this control (though we have eliminated
+        // most Toolkit influences like ASB/TextBox Style, the InterspersedObservableCollection, etc...).
+        // The only Toolkit component involved here should be WrapPanel (which is a straight-forward Panel).
+        // We also know the ASB itself is adjusting it's size correctly, it's the inner component.
+        //
+        // To combat this issue:
+        //   We toggle the visibility of the Placeholder ContentControl in order to force it's layout to update properly
+        FrameworkElement? placeholder = ContainerFromItem(lastTextEdit)?.FindDescendant("PlaceholderTextContentPresenter");
+
+        if (placeholder?.Visibility == Visibility.Visible)
+        {
+            placeholder.Visibility = Visibility.Collapsed;
+
+            // After we ensure we've hid the control, make it visible again (this is imperceptible to the user).
+            _ = CompositionTargetHelper.ExecuteAfterCompositionRenderingAsync(() =>
+            {
+                placeholder.Visibility = Visibility.Visible;
+            });
+        }
+    }
+
+    private bool MoveFocusAndSelection(MoveDirection direction)
+    {
+        bool retVal = false;
+
+        if (GetCurrentContainerItem() is { } currentContainerItem)
+        {
+            object? currentItem = ItemFromContainer(currentContainerItem);
+            int previousIndex = Items.IndexOf(currentItem);
+            int index = previousIndex;
+
+            if (direction == MoveDirection.Previous)
+            {
+                if (previousIndex > 0)
+                {
+                    index -= 1;
+                }
+                else
+                {
+                    if (TabNavigateBackOnArrow)
+                    {
+                        FocusManager.TryMoveFocus(FocusNavigationDirection.Previous, new FindNextElementOptions
+                        {
+                            SearchRoot = XamlRoot.Content,
+                        });
+                    }
+
+                    retVal = true;
+                }
+            }
+            else if (direction == MoveDirection.Next)
+            {
+                if (previousIndex < Items.Count - 1)
+                {
+                    index += 1;
+                }
+            }
+
+            // Only do stuff if the index is actually changing
+            if (index != previousIndex)
+            {
+                if (ContainerFromIndex(index) is TokenizingTextBoxItem newItem)
+                {
+                    // Check for the new item being a text control.
+                    // this must happen before focus is set to avoid seeing the caret
+                    // jump in come cases
+                    if (Items[index] is ITokenStringContainer && !IsShiftPressed)
+                    {
+                        newItem.AutoSuggestTextBox.SelectionLength = 0;
+                        newItem.AutoSuggestTextBox.SelectionStart = direction == MoveDirection.Next
+                            ? 0
+                            : newItem.AutoSuggestTextBox.Text.Length;
+                    }
+
+                    newItem.Focus(FocusState.Keyboard);
+
+                    // if no control keys are selected then the selection also becomes just this item
+                    if (IsShiftPressed)
+                    {
+                        // What we do here depends on where the selection started
+                        // if the previous item is between the start and new position then we add the new item to the selected range
+                        // if the new item is between the start and the previous position then we remove the previous position
+                        int newDistance = Math.Abs(SelectedIndex - index);
+                        int oldDistance = Math.Abs(SelectedIndex - previousIndex);
+
+                        if (newDistance > oldDistance)
+                        {
+                            SelectedItems.Add(Items[index]);
+                        }
+                        else
+                        {
+                            SelectedItems.Remove(Items[previousIndex]);
+                        }
+                    }
+                    else if (!IsControlPressed)
+                    {
+                        SelectedIndex = index;
+
+                        // This looks like a bug in the underlying ListViewBase control.
+                        // Might need to be reviewed if the base behavior is fixed
+                        // When two consecutive items are selected and the navigation moves between them,
+                        // the first time that happens the old focused item is not unselected
+                        if (SelectedItems.Count > 1)
+                        {
+                            SelectedItems.Clear();
+                            SelectedIndex = index;
+                        }
+                    }
+
+                    retVal = true;
+                }
+            }
+        }
+
+        return retVal;
+    }
+
+    private TokenizingTextBoxItem? GetCurrentContainerItem()
+    {
+        if (IsXamlRootAvailable && XamlRoot is not null)
+        {
+            return (TokenizingTextBoxItem)FocusManager.GetFocusedElement(XamlRoot);
+        }
+        else
+        {
+            return (TokenizingTextBoxItem)FocusManager.GetFocusedElement();
+        }
+    }
+
+    private void ClearAllTextSelections(TokenizingTextBoxItem? ignoreItem)
+    {
+        // Clear any selection in the text box
+        foreach (object? item in Items)
+        {
+            if (item is ITokenStringContainer)
+            {
+                if (ContainerFromItem(item) is TokenizingTextBoxItem container)
+                {
+                    if (container != ignoreItem)
+                    {
+                        container.AutoSuggestTextBox.SelectionLength = 0;
+                    }
+                }
+            }
+        }
+    }
+
+    private bool SelectNewItem(TokenizingTextBoxItem item, int increment, Func<int, bool> testFunc)
+    {
+        // find the item in the list
+        int currentIndex = IndexFromContainer(item);
+
+        // Select previous token item (if there is one).
+        if (testFunc(currentIndex))
+        {
+            if (ContainerFromItem(Items[currentIndex + increment]) is ListViewItem newItem)
+            {
+                newItem.Focus(FocusState.Keyboard);
+                SelectedItems.Add(Items[currentIndex + increment]);
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    private async void TokenizingTextBoxItem_ClearAllAction(TokenizingTextBoxItem sender, RoutedEventArgs args)
+    {
+        // find the first item selected
+        int newSelectedIndex = -1;
+
+        if (SelectedRanges.Count > 0)
+        {
+            newSelectedIndex = SelectedRanges[0].FirstIndex - 1;
+        }
+
+        await RemoveAllSelectedTokens().ConfigureAwait(true);
+
+        SelectedIndex = newSelectedIndex;
+
+        if (newSelectedIndex is -1)
+        {
+            newSelectedIndex = Items.Count - 1;
+        }
+
+        // focus the item prior to the first selected item
+        if (ContainerFromIndex(newSelectedIndex) is TokenizingTextBoxItem container)
+        {
+            container.Focus(FocusState.Keyboard);
+        }
+    }
+
+    private async void TokenizingTextBoxItem_ClearClicked(TokenizingTextBoxItem sender, RoutedEventArgs? args)
+    {
+        await RemoveTokenAsync(sender).ConfigureAwait(true);
+    }
+
+    private void CopySelectedToClipboard()
+    {
+        DataPackage dataPackage = new()
+        {
+            RequestedOperation = DataPackageOperation.Copy,
+        };
+
+        string tokenString = PrepareSelectionForClipboard();
+
+        if (!string.IsNullOrEmpty(tokenString))
+        {
+            dataPackage.SetText(tokenString);
+            Clipboard.SetContent(dataPackage);
+        }
+    }
+
+    private string PrepareSelectionForClipboard()
+    {
+        string tokenString = string.Empty;
+        bool addSeparator = false;
+
+        // Copy all items if none selected (and no text selected)
+        foreach (object? item in SelectedItems.Count > 0 ? SelectedItems : Items)
+        {
+            if (addSeparator)
+            {
+                tokenString += TokenDelimiter;
+            }
+            else
+            {
+                addSeparator = true;
+            }
+
+            if (item is ITokenStringContainer)
+            {
+                // grab any selected text
+                if (ContainerFromItem(item) is TokenizingTextBoxItem { AutoSuggestTextBox: { } textBox })
+                {
+                    tokenString += textBox.Text.Substring(
+                        textBox.SelectionStart,
+                        textBox.SelectionLength);
+                }
+            }
+            else
+            {
+                tokenString += item.ToString();
+            }
+        }
+
+        return tokenString;
+    }
+}

src/Snap.Hutao/Snap.Hutao/Control/TokenizingTextBox/TokenizingTextBox.xaml

@@ -0,0 +1,172 @@
+<ResourceDictionary
+    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:shct="using:Snap.Hutao.Control.TokenizingTextBox"
+    xmlns:win="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
+    <ResourceDictionary.MergedDictionaries>
+        <ResourceDictionary Source="ms-appx:///Control/TokenizingTextBox/TokenizingTextBoxItem.xaml"/>
+    </ResourceDictionary.MergedDictionaries>
+
+    <!--  Resources for TokenizingTextBox  -->
+    <Thickness x:Key="TokenizingTextBoxPadding">3,2,3,2</Thickness>
+    <Thickness x:Key="TokenizingTextBoxPresenterMargin">0,0,6,0</Thickness>
+    <x:Double x:Key="TokenizingTextBoxTokenSpacing">2</x:Double>
+
+    <shct:TokenizingTextBoxStyleSelector
+        x:Key="TokenizingTextBoxStyleSelector"
+        TextStyle="{StaticResource TokenizingTextBoxItemTextStyle}"
+        TokenStyle="{StaticResource TokenizingTextBoxItemTokenStyle}"/>
+
+    <!--  Default style for TokenizingTextBox  -->
+    <Style BasedOn="{StaticResource DefaultTokenizingTextBoxStyle}" TargetType="shct:TokenizingTextBox"/>
+
+    <Style x:Key="DefaultTokenizingTextBoxStyle" TargetType="shct:TokenizingTextBox">
+        <Setter Property="AutoSuggestBoxTextBoxStyle" Value="{StaticResource TokenizingTextBoxTextBoxStyle}"/>
+        <Setter Property="Foreground" Value="{ThemeResource TextControlForeground}"/>
+        <Setter Property="Background" Value="{ThemeResource TextControlBackground}"/>
+        <Setter Property="BorderBrush" Value="{ThemeResource TextControlBorderBrush}"/>
+        <Setter Property="BorderThickness" Value="{StaticResource TextControlBorderThemeThickness}"/>
+        <Setter Property="IsTabStop" Value="False"/>
+        <Setter Property="TabNavigation" Value="Once"/>
+        <win:Setter Property="IsSwipeEnabled" Value="False"/>
+        <Setter Property="CornerRadius" Value="{ThemeResource ControlCornerRadius}"/>
+        <Setter Property="Padding" Value="{StaticResource TokenizingTextBoxPadding}"/>
+        <Setter Property="SelectionMode" Value="Extended"/>
+        <Setter Property="ScrollViewer.HorizontalScrollBarVisibility" Value="Disabled"/>
+        <Setter Property="ScrollViewer.VerticalScrollBarVisibility" Value="Auto"/>
+        <Setter Property="ScrollViewer.HorizontalScrollMode" Value="Disabled"/>
+        <win:Setter Property="ScrollViewer.IsHorizontalRailEnabled" Value="True"/>
+        <Setter Property="ScrollViewer.VerticalScrollMode" Value="Enabled"/>
+        <win:Setter Property="ScrollViewer.IsVerticalRailEnabled" Value="True"/>
+        <Setter Property="ScrollViewer.ZoomMode" Value="Disabled"/>
+        <win:Setter Property="ScrollViewer.IsDeferredScrollingEnabled" Value="False"/>
+        <Setter Property="ScrollViewer.BringIntoViewOnFocusChange" Value="True"/>
+        <Setter Property="TokenSpacing" Value="{StaticResource TokenizingTextBoxTokenSpacing}"/>
+        <Setter Property="UseSystemFocusVisuals" Value="{StaticResource UseSystemFocusVisuals}"/>
+        <Setter Property="IsItemClickEnabled" Value="True"/>
+        <win:Setter Property="ItemContainerTransitions">
+            <Setter.Value>
+                <TransitionCollection/>
+            </Setter.Value>
+        </win:Setter>
+        <Setter Property="ItemsPanel">
+            <Setter.Value>
+                <ItemsPanelTemplate>
+                    <cwc:WrapPanel
+                        cw:FrameworkElementExtensions.AncestorType="shct:TokenizingTextBox"
+                        HorizontalSpacing="{Binding (cw:FrameworkElementExtensions.Ancestor).TokenSpacing, RelativeSource={RelativeSource Self}}"
+                        StretchChild="Last"
+                        VerticalSpacing="{Binding (cw:FrameworkElementExtensions.Ancestor).TokenSpacing, RelativeSource={RelativeSource Self}}"/>
+                </ItemsPanelTemplate>
+            </Setter.Value>
+        </Setter>
+        <Setter Property="ItemContainerStyleSelector" Value="{StaticResource TokenizingTextBoxStyleSelector}"/>
+        <Setter Property="Template" Value="{StaticResource TokenizingTextBoxTemplate}"/>
+    </Style>
+
+    <ControlTemplate x:Key="TokenizingTextBoxTemplate" TargetType="shct:TokenizingTextBox">
+        <Grid Name="RootPanel">
+            <Grid.RowDefinitions>
+                <RowDefinition Height="Auto"/>
+                <RowDefinition Height="*"/>
+                <RowDefinition Height="Auto"/>
+            </Grid.RowDefinitions>
+
+            <ContentPresenter
+                Margin="{ThemeResource TextBoxTopHeaderMargin}"
+                VerticalAlignment="Top"
+                Content="{TemplateBinding Header}"
+                ContentTemplate="{TemplateBinding HeaderTemplate}"
+                FontWeight="Normal"
+                Foreground="{ThemeResource TextControlHeaderForeground}"
+                TextWrapping="Wrap"
+                Transitions="{TemplateBinding HeaderTransitions}"/>
+            <Border
+                x:Name="BackgroundVisual"
+                Grid.Row="1"
+                Background="{TemplateBinding Background}"
+                BorderBrush="{TemplateBinding BorderBrush}"
+                BorderThickness="{TemplateBinding BorderThickness}"
+                CornerRadius="{TemplateBinding CornerRadius}"/>
+
+            <Border
+                x:Name="FocusVisual"
+                Grid.Row="1"
+                Background="{ThemeResource TextControlBackgroundFocused}"
+                BorderBrush="{ThemeResource TextControlBorderBrushFocused}"
+                BorderThickness="{TemplateBinding BorderThickness}"
+                CornerRadius="{TemplateBinding CornerRadius}"
+                Opacity="0"/>
+            <!--  Background in WinUI is TextControlBackgroundFocused, but that uses a different resource in WinUI than system  -->
+
+            <ScrollViewer
+                x:Name="ScrollViewer"
+                Grid.Row="1"
+                win:AutomationProperties.AccessibilityView="Raw"
+                win:IsDeferredScrollingEnabled="{TemplateBinding ScrollViewer.IsDeferredScrollingEnabled}"
+                win:IsHorizontalRailEnabled="{TemplateBinding ScrollViewer.IsHorizontalRailEnabled}"
+                win:IsHorizontalScrollChainingEnabled="{TemplateBinding ScrollViewer.IsHorizontalScrollChainingEnabled}"
+                win:IsVerticalRailEnabled="{TemplateBinding ScrollViewer.IsVerticalRailEnabled}"
+                win:IsVerticalScrollChainingEnabled="{TemplateBinding ScrollViewer.IsVerticalScrollChainingEnabled}"
+                BringIntoViewOnFocusChange="{TemplateBinding ScrollViewer.BringIntoViewOnFocusChange}"
+                HorizontalScrollBarVisibility="{TemplateBinding ScrollViewer.HorizontalScrollBarVisibility}"
+                HorizontalScrollMode="{TemplateBinding ScrollViewer.HorizontalScrollMode}"
+                TabNavigation="{TemplateBinding TabNavigation}"
+                VerticalScrollBarVisibility="{TemplateBinding ScrollViewer.VerticalScrollBarVisibility}"
+                VerticalScrollMode="{TemplateBinding ScrollViewer.VerticalScrollMode}"
+                ZoomMode="{TemplateBinding ScrollViewer.ZoomMode}">
+
+                <ItemsPresenter Margin="{StaticResource TokenizingTextBoxPresenterMargin}" Padding="{TemplateBinding Padding}"/>
+            </ScrollViewer>
+
+            <ContentPresenter
+                Grid.Row="2"
+                VerticalAlignment="Top"
+                Content="{TemplateBinding Footer}"
+                ContentTemplate="{TemplateBinding FooterTemplate}"
+                FontWeight="Normal"
+                TextWrapping="Wrap"
+                Transitions="{TemplateBinding FooterTransitions}"/>
+
+            <VisualStateManager.VisualStateGroups>
+                <VisualStateGroup x:Name="CommonStates">
+                    <VisualState x:Name="Disabled">
+                        <Storyboard>
+                            <ObjectAnimationUsingKeyFrames Storyboard.TargetName="BackgroundVisual" Storyboard.TargetProperty="Background">
+                                <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlBackgroundDisabled}"/>
+                            </ObjectAnimationUsingKeyFrames>
+                            <ObjectAnimationUsingKeyFrames Storyboard.TargetName="BackgroundVisual" Storyboard.TargetProperty="BorderBrush">
+                                <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlBorderBrushDisabled}"/>
+                            </ObjectAnimationUsingKeyFrames>
+
+                        </Storyboard>
+                    </VisualState>
+                    <VisualState x:Name="Normal"/>
+                    <VisualState x:Name="PointerOver">
+                        <Storyboard>
+                            <ObjectAnimationUsingKeyFrames Storyboard.TargetName="BackgroundVisual" Storyboard.TargetProperty="BorderBrush">
+                                <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlBorderBrushPointerOver}"/>
+                            </ObjectAnimationUsingKeyFrames>
+                            <ObjectAnimationUsingKeyFrames Storyboard.TargetName="BackgroundVisual" Storyboard.TargetProperty="Background">
+                                <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlBackgroundPointerOver}"/>
+                            </ObjectAnimationUsingKeyFrames>
+                        </Storyboard>
+                    </VisualState>
+                </VisualStateGroup>
+
+                <VisualStateGroup x:Name="FocusStates">
+                    <VisualState x:Name="Focused">
+                        <VisualState.Setters>
+                            <Setter Target="BackgroundVisual.BorderBrush" Value="Transparent"/>
+                            <Setter Target="FocusVisual.BorderThickness" Value="{ThemeResource TextControlBorderThemeThicknessFocused}"/>
+                            <Setter Target="FocusVisual.Opacity" Value="1"/>
+                        </VisualState.Setters>
+                    </VisualState>
+                    <VisualState x:Name="Unfocused"/>
+                </VisualStateGroup>
+            </VisualStateManager.VisualStateGroups>
+        </Grid>
+    </ControlTemplate>
+</ResourceDictionary>

src/Snap.Hutao/Snap.Hutao/Control/TokenizingTextBox/TokenizingTextBoxAutomationPeer.cs

@@ -0,0 +1,84 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.UI.Xaml.Automation;
+using Microsoft.UI.Xaml.Automation.Peers;
+using Microsoft.UI.Xaml.Automation.Provider;
+using Microsoft.UI.Xaml.Controls;
+
+namespace Snap.Hutao.Control.TokenizingTextBox;
+
+internal class TokenizingTextBoxAutomationPeer : ListViewBaseAutomationPeer, IValueProvider
+{
+    public TokenizingTextBoxAutomationPeer(TokenizingTextBox owner)
+        : base(owner)
+    {
+    }
+
+    public bool IsReadOnly => !OwningTokenizingTextBox.IsEnabled;
+
+    public string Value => OwningTokenizingTextBox.Text;
+
+    private TokenizingTextBox OwningTokenizingTextBox
+    {
+        get => (TokenizingTextBox)Owner;
+    }
+
+    public void SetValue(string value)
+    {
+        if (IsReadOnly)
+        {
+            throw new ElementNotEnabledException($"Could not set the value of the {nameof(TokenizingTextBox)} ");
+        }
+
+        OwningTokenizingTextBox.Text = value;
+    }
+
+    protected override string GetClassNameCore()
+    {
+        return Owner.GetType().Name;
+    }
+
+    protected override string GetNameCore()
+    {
+        string name = OwningTokenizingTextBox.Name;
+        if (!string.IsNullOrWhiteSpace(name))
+        {
+            return name;
+        }
+
+        name = AutomationProperties.GetName(OwningTokenizingTextBox);
+        return !string.IsNullOrWhiteSpace(name) ? name : base.GetNameCore();
+    }
+
+    protected override object GetPatternCore(PatternInterface patternInterface)
+    {
+        return patternInterface switch
+        {
+            PatternInterface.Value => this,
+            _ => base.GetPatternCore(patternInterface),
+        };
+    }
+
+    protected override IList<AutomationPeer> GetChildrenCore()
+    {
+        TokenizingTextBox owner = OwningTokenizingTextBox;
+
+        ItemCollection items = owner.Items;
+        if (items.Count <= 0)
+        {
+            return default!;
+        }
+
+        List<AutomationPeer> peers = new(items.Count);
+        for (int i = 0; i < items.Count; i++)
+        {
+            if (owner.ContainerFromIndex(i) is TokenizingTextBoxItem element)
+            {
+                peers.Add(FromElement(element) ?? CreatePeerForElement(element));
+            }
+        }
+
+        return peers;
+    }
+}

src/Snap.Hutao/Snap.Hutao/Control/TokenizingTextBox/TokenizingTextBoxItem.cs

@@ -0,0 +1,480 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using CommunityToolkit.WinUI;
+using Microsoft.UI.Xaml;
+using Microsoft.UI.Xaml.Controls;
+using Microsoft.UI.Xaml.Controls.Primitives;
+using Microsoft.UI.Xaml.Data;
+using Microsoft.UI.Xaml.Input;
+using Windows.Foundation;
+using Windows.System;
+
+namespace Snap.Hutao.Control.TokenizingTextBox;
+
+[DependencyProperty("ClearButtonStyle", typeof(Style))]
+[DependencyProperty("Owner", typeof(TokenizingTextBox))]
+[TemplatePart(Name = PART_ClearButton, Type = typeof(ButtonBase))] //// Token case
+[TemplatePart(Name = PART_AutoSuggestBox, Type = typeof(Microsoft.UI.Xaml.Controls.AutoSuggestBox))] //// String case
+[TemplatePart(Name = PART_TokensCounter, Type = typeof(TextBlock))]
+[SuppressMessage("", "SA1124")]
+internal partial class TokenizingTextBoxItem : ListViewItem
+{
+    private const string PART_ClearButton = "PART_RemoveButton";
+    private const string PART_AutoSuggestBox = "PART_AutoSuggestBox";
+    private const string PART_TokensCounter = "PART_TokensCounter";
+    private const string QueryButton = "QueryButton";
+
+    private Microsoft.UI.Xaml.Controls.AutoSuggestBox autoSuggestBox;
+    private TextBox autoSuggestTextBox;
+    private Button clearButton;
+    private bool isSelectedFocusOnFirstCharacter;
+    private bool isSelectedFocusOnLastCharacter;
+
+    public TokenizingTextBoxItem()
+    {
+        DefaultStyleKey = typeof(TokenizingTextBoxItem);
+
+        // TODO: only add these if token?
+        RightTapped += TokenizingTextBoxItem_RightTapped;
+        KeyDown += TokenizingTextBoxItem_KeyDown;
+    }
+
+    public event TypedEventHandler<TokenizingTextBoxItem, RoutedEventArgs>? AutoSuggestTextBoxLoaded;
+
+    public event TypedEventHandler<TokenizingTextBoxItem, RoutedEventArgs>? ClearClicked;
+
+    public event TypedEventHandler<TokenizingTextBoxItem, RoutedEventArgs>? ClearAllAction;
+
+    public TextBox AutoSuggestTextBox { get => autoSuggestTextBox; }
+
+    public bool UseCharacterAsUser { get; set; }
+
+    private bool IsCaretAtStart
+    {
+        get => autoSuggestTextBox?.SelectionStart is 0;
+    }
+
+    private bool IsCaretAtEnd
+    {
+        get => autoSuggestTextBox?.SelectionStart == autoSuggestTextBox?.Text.Length || autoSuggestTextBox?.SelectionStart + autoSuggestTextBox?.SelectionLength == autoSuggestTextBox?.Text.Length;
+    }
+
+    private bool IsAllSelected
+    {
+        get => autoSuggestTextBox?.SelectedText == autoSuggestTextBox?.Text && !string.IsNullOrEmpty(autoSuggestTextBox?.Text);
+    }
+
+    // Called to update text by link:TokenizingTextBox.Properties.cs:TextPropertyChanged
+    public void UpdateText(string text)
+    {
+        if (autoSuggestBox is not null)
+        {
+            autoSuggestBox.Text = text;
+        }
+        else
+        {
+            void WaitForLoad(object s, RoutedEventArgs eargs)
+            {
+                if (autoSuggestTextBox is not null)
+                {
+                    autoSuggestTextBox.Text = text;
+                }
+
+                AutoSuggestTextBoxLoaded -= WaitForLoad;
+            }
+
+            AutoSuggestTextBoxLoaded += WaitForLoad;
+        }
+    }
+
+    /// <inheritdoc/>
+    protected override void OnApplyTemplate()
+    {
+        base.OnApplyTemplate();
+
+        if (GetTemplateChild(PART_AutoSuggestBox) is Microsoft.UI.Xaml.Controls.AutoSuggestBox suggestbox)
+        {
+            OnApplyTemplateAutoSuggestBox(suggestbox);
+        }
+
+        if (clearButton is not null)
+        {
+            clearButton.Click -= ClearButton_Click;
+        }
+
+        clearButton = (Button)GetTemplateChild(PART_ClearButton);
+
+        if (clearButton is not null)
+        {
+            clearButton.Click += ClearButton_Click;
+        }
+    }
+
+    private void ClearButton_Click(object sender, RoutedEventArgs e)
+    {
+        ClearClicked?.Invoke(this, e);
+    }
+
+    private void TokenizingTextBoxItem_RightTapped(object sender, RightTappedRoutedEventArgs e)
+    {
+        ContextFlyout.ShowAt(this);
+    }
+
+    private void TokenizingTextBoxItem_KeyDown(object sender, KeyRoutedEventArgs e)
+    {
+        if (Content is not ITokenStringContainer)
+        {
+            // We only want to 'remove' our token if we're not a textbox.
+            switch (e.Key)
+            {
+                case VirtualKey.Back:
+                case VirtualKey.Delete:
+                    {
+                        ClearAllAction?.Invoke(this, e);
+                        break;
+                    }
+            }
+        }
+    }
+
+    /// Called from <see cref="OnApplyTemplate"/>
+    private void OnApplyTemplateAutoSuggestBox(Microsoft.UI.Xaml.Controls.AutoSuggestBox auto)
+    {
+        if (autoSuggestBox is not null)
+        {
+            autoSuggestBox.Loaded -= OnASBLoaded;
+
+            autoSuggestBox.QuerySubmitted -= AutoSuggestBox_QuerySubmitted;
+            autoSuggestBox.SuggestionChosen -= AutoSuggestBox_SuggestionChosen;
+            autoSuggestBox.TextChanged -= AutoSuggestBox_TextChanged;
+            autoSuggestBox.PointerEntered -= AutoSuggestBox_PointerEntered;
+            autoSuggestBox.PointerExited -= AutoSuggestBox_PointerExited;
+            autoSuggestBox.PointerCanceled -= AutoSuggestBox_PointerExited;
+            autoSuggestBox.PointerCaptureLost -= AutoSuggestBox_PointerExited;
+            autoSuggestBox.GotFocus -= AutoSuggestBox_GotFocus;
+            autoSuggestBox.LostFocus -= AutoSuggestBox_LostFocus;
+
+            // Remove any previous QueryIcon
+            autoSuggestBox.QueryIcon = default;
+        }
+
+        autoSuggestBox = auto;
+
+        if (autoSuggestBox is not null)
+        {
+            autoSuggestBox.Loaded += OnASBLoaded;
+
+            autoSuggestBox.QuerySubmitted += AutoSuggestBox_QuerySubmitted;
+            autoSuggestBox.SuggestionChosen += AutoSuggestBox_SuggestionChosen;
+            autoSuggestBox.TextChanged += AutoSuggestBox_TextChanged;
+            autoSuggestBox.PointerEntered += AutoSuggestBox_PointerEntered;
+            autoSuggestBox.PointerExited += AutoSuggestBox_PointerExited;
+            autoSuggestBox.PointerCanceled += AutoSuggestBox_PointerExited;
+            autoSuggestBox.PointerCaptureLost += AutoSuggestBox_PointerExited;
+            autoSuggestBox.GotFocus += AutoSuggestBox_GotFocus;
+            autoSuggestBox.LostFocus += AutoSuggestBox_LostFocus;
+
+            // Setup a binding to the QueryIcon of the Parent if we're the last box.
+            if (Content is ITokenStringContainer str)
+            {
+                // We need to set our initial text in all cases.
+                autoSuggestBox.Text = str.Text;
+
+                // We only set/bind some properties on the last textbox to mimic the autosuggestbox look
+                if (str.IsLast)
+                {
+                    // Workaround for https://github.com/microsoft/microsoft-ui-xaml/issues/2568
+                    if (Owner.QueryIcon is FontIconSource fis &&
+                        fis.ReadLocalValue(FontIconSource.FontSizeProperty) == DependencyProperty.UnsetValue)
+                    {
+                        // This can be expensive, could we optimize?
+                        // Also, this is changing the FontSize on the IconSource (which could be shared?)
+                        fis.FontSize = Owner.TryFindResource("TokenizingTextBoxIconFontSize") as double? ?? 16;
+                    }
+
+                    Binding iconBinding = new()
+                    {
+                        Source = Owner,
+                        Path = new PropertyPath(nameof(Owner.QueryIcon)),
+                        RelativeSource = new()
+                        {
+                            Mode = RelativeSourceMode.TemplatedParent,
+                        },
+                    };
+
+                    IconSourceElement iconSourceElement = new();
+                    iconSourceElement.SetBinding(IconSourceElement.IconSourceProperty, iconBinding);
+                    autoSuggestBox.QueryIcon = iconSourceElement;
+                }
+            }
+        }
+    }
+
+    private async void AutoSuggestBox_QuerySubmitted(Microsoft.UI.Xaml.Controls.AutoSuggestBox sender, AutoSuggestBoxQuerySubmittedEventArgs args)
+    {
+        Owner.RaiseQuerySubmitted(sender, args);
+
+        object? chosenItem = default;
+        if (args.ChosenSuggestion is not null)
+        {
+            chosenItem = args.ChosenSuggestion;
+        }
+        else if (!string.IsNullOrWhiteSpace(args.QueryText))
+        {
+            chosenItem = args.QueryText;
+        }
+
+        if (chosenItem is not null)
+        {
+            await Owner.AddTokenAsync(chosenItem).ConfigureAwait(true); // TODO: Need to pass index?
+            sender.Text = string.Empty;
+            Owner.Text = string.Empty;
+            sender.Focus(FocusState.Programmatic);
+        }
+    }
+
+    private void AutoSuggestBox_SuggestionChosen(Microsoft.UI.Xaml.Controls.AutoSuggestBox sender, AutoSuggestBoxSuggestionChosenEventArgs args)
+    {
+        Owner.RaiseSuggestionChosen(sender, args);
+    }
+
+    private void AutoSuggestBox_TextChanged(Microsoft.UI.Xaml.Controls.AutoSuggestBox sender, AutoSuggestBoxTextChangedEventArgs args)
+    {
+        if (sender.Text is null)
+        {
+            return;
+        }
+
+        if (!EqualityComparer<string>.Default.Equals(sender.Text, Owner.Text))
+        {
+            Owner.Text = sender.Text; // Update parent text property, if different
+        }
+
+        // Override our programmatic manipulation as we're redirecting input for the user
+        if (UseCharacterAsUser)
+        {
+            UseCharacterAsUser = false;
+
+            args.Reason = AutoSuggestionBoxTextChangeReason.UserInput;
+        }
+
+        Owner.RaiseTextChanged(sender, args);
+
+        string t = sender.Text?.Trim() ?? string.Empty;
+
+        // Look for Token Delimiters to create new tokens when text changes.
+        if (!string.IsNullOrEmpty(Owner.TokenDelimiter) && t.Contains(Owner.TokenDelimiter, StringComparison.OrdinalIgnoreCase))
+        {
+            bool lastDelimited = t[^1] == Owner.TokenDelimiter[0];
+
+            string[] tokens = t.Split(Owner.TokenDelimiter);
+            int numberToProcess = lastDelimited ? tokens.Length : tokens.Length - 1;
+            for (int position = 0; position < numberToProcess; position++)
+            {
+                string token = tokens[position];
+                token = token.Trim();
+                if (token.Length > 0)
+                {
+                    _ = Owner.AddTokenAsync(token); //// TODO: Pass Index?
+                }
+            }
+
+            if (lastDelimited)
+            {
+                sender.Text = string.Empty;
+            }
+            else
+            {
+                sender.Text = tokens[^1].Trim();
+            }
+        }
+    }
+
+    private void AutoSuggestBox_PointerEntered(object sender, PointerRoutedEventArgs e)
+    {
+        VisualStateManager.GoToState(Owner, TokenizingTextBox.PointerOverState, true);
+    }
+
+    private void AutoSuggestBox_PointerExited(object sender, PointerRoutedEventArgs e)
+    {
+        VisualStateManager.GoToState(Owner, TokenizingTextBox.NormalState, true);
+    }
+
+    private void AutoSuggestBox_LostFocus(object sender, RoutedEventArgs e)
+    {
+        VisualStateManager.GoToState(Owner, TokenizingTextBox.UnfocusedState, true);
+    }
+
+    private void AutoSuggestBox_GotFocus(object sender, RoutedEventArgs e)
+    {
+        // Verify if the usual behavior of clearing token selection is required
+        if (Owner.PauseTokenClearOnFocus == false && !TokenizingTextBox.IsShiftPressed)
+        {
+            // Clear any selected tokens
+            Owner.DeselectAll();
+        }
+
+        Owner.PauseTokenClearOnFocus = false;
+
+        VisualStateManager.GoToState(Owner, TokenizingTextBox.FocusedState, true);
+    }
+
+    private void OnASBLoaded(object sender, RoutedEventArgs e)
+    {
+        if (autoSuggestTextBox is not null)
+        {
+            autoSuggestTextBox.PreviewKeyDown -= AutoSuggestTextBox_PreviewKeyDown;
+            autoSuggestTextBox.TextChanging -= AutoSuggestTextBox_TextChangingAsync;
+            autoSuggestTextBox.SelectionChanged -= AutoSuggestTextBox_SelectionChanged;
+            autoSuggestTextBox.SelectionChanging -= AutoSuggestTextBox_SelectionChanging;
+        }
+
+        autoSuggestTextBox ??= autoSuggestBox.FindDescendant<TextBox>()!;
+
+        UpdateQueryIconVisibility();
+        UpdateTokensCounter(this);
+
+        // Local function for Selection changed
+        void AutoSuggestTextBox_SelectionChanged(object box, RoutedEventArgs args)
+        {
+            if (!(IsAllSelected || TokenizingTextBox.IsShiftPressed || Owner.IsClearingForClick))
+            {
+                Owner.DeselectAllTokensAndText(this);
+            }
+
+            // Ensure flag is always reset
+            Owner.IsClearingForClick = false;
+        }
+
+        // local function for clearing selection on interaction with text box
+        async void AutoSuggestTextBox_TextChangingAsync(TextBox o, TextBoxTextChangingEventArgs args)
+        {
+            // remove any selected tokens.
+            if (Owner.SelectedItems.Count > 1)
+            {
+                await Owner.RemoveAllSelectedTokens().ConfigureAwait(true);
+            }
+        }
+
+        if (autoSuggestTextBox is not null)
+        {
+            autoSuggestTextBox.PreviewKeyDown += AutoSuggestTextBox_PreviewKeyDown;
+            autoSuggestTextBox.TextChanging += AutoSuggestTextBox_TextChangingAsync;
+            autoSuggestTextBox.SelectionChanged += AutoSuggestTextBox_SelectionChanged;
+            autoSuggestTextBox.SelectionChanging += AutoSuggestTextBox_SelectionChanging;
+
+            AutoSuggestTextBoxLoaded?.Invoke(this, e);
+        }
+    }
+
+    private void AutoSuggestTextBox_SelectionChanging(TextBox sender, TextBoxSelectionChangingEventArgs args)
+    {
+        isSelectedFocusOnFirstCharacter = args.SelectionLength > 0 && args.SelectionStart is 0 && autoSuggestTextBox.SelectionStart > 0;
+        isSelectedFocusOnLastCharacter =
+            //// see if we are NOW on the last character.
+            //// test if the new selection includes the last character, and the current selection doesn't
+            (args.SelectionStart + args.SelectionLength == autoSuggestTextBox.Text.Length) &&
+            (autoSuggestTextBox.SelectionStart + autoSuggestTextBox.SelectionLength != autoSuggestTextBox.Text.Length);
+    }
+
+    private void AutoSuggestTextBox_PreviewKeyDown(object sender, KeyRoutedEventArgs e)
+    {
+        if (IsCaretAtStart &&
+            (e.Key is VirtualKey.Back ||
+             e.Key is VirtualKey.Left))
+        {
+            // if the back key is pressed and there is any selection in the text box then the text box can handle it
+            if ((e.Key is VirtualKey.Left && isSelectedFocusOnFirstCharacter) ||
+                autoSuggestTextBox.SelectionLength is 0)
+            {
+                if (Owner.SelectPreviousItem(this))
+                {
+                    if (!TokenizingTextBox.IsShiftPressed)
+                    {
+                        // Clear any text box selection
+                        autoSuggestTextBox.SelectionLength = 0;
+                    }
+
+                    e.Handled = true;
+                }
+            }
+        }
+        else if (IsCaretAtEnd && e.Key is VirtualKey.Right)
+        {
+            // if the back key is pressed and there is any selection in the text box then the text box can handle it
+            if (isSelectedFocusOnLastCharacter || autoSuggestTextBox.SelectionLength is 0)
+            {
+                if (Owner.SelectNextItem(this))
+                {
+                    if (!TokenizingTextBox.IsShiftPressed)
+                    {
+                        // Clear any text box selection
+                        autoSuggestTextBox.SelectionLength = 0;
+                    }
+
+                    e.Handled = true;
+                }
+            }
+        }
+        else if (e.Key is VirtualKey.A && TokenizingTextBox.IsControlPressed)
+        {
+            // Need to provide this shortcut from the textbox only, as ListViewBase will do it for us on token.
+            Owner.SelectAllTokensAndText();
+        }
+    }
+
+    private void UpdateTokensCounter(TokenizingTextBoxItem ttbi)
+    {
+        if (autoSuggestBox?.FindDescendant(PART_TokensCounter) is TextBlock maxTokensCounter)
+        {
+            void OnTokenCountChanged(TokenizingTextBox ttb, object? value = default)
+            {
+                if (ttb.ItemsSource is InterspersedObservableCollection itemsSource)
+                {
+                    int currentTokens = itemsSource.ItemsSource.Count;
+                    int maxTokens = ttb.MaximumTokens;
+
+                    maxTokensCounter.Text = $"{currentTokens}/{maxTokens}";
+                    maxTokensCounter.Visibility = Visibility.Visible;
+
+                    string targetState = (currentTokens >= maxTokens)
+                        ? TokenizingTextBox.MaxReachedState
+                        : TokenizingTextBox.MaxUnreachedState;
+
+                    VisualStateManager.GoToState(autoSuggestTextBox, targetState, true);
+                }
+            }
+
+            ttbi.Owner.TokenItemAdded -= OnTokenCountChanged;
+            ttbi.Owner.TokenItemRemoved -= OnTokenCountChanged;
+
+            if (Content is ITokenStringContainer { IsLast: true } str && ttbi is { Owner.MaximumTokens: >= 0 })
+            {
+                ttbi.Owner.TokenItemAdded += OnTokenCountChanged;
+                ttbi.Owner.TokenItemRemoved += OnTokenCountChanged;
+                OnTokenCountChanged(ttbi.Owner);
+            }
+            else
+            {
+                maxTokensCounter.Visibility = Visibility.Collapsed;
+                maxTokensCounter.Text = string.Empty;
+            }
+        }
+    }
+
+    private void UpdateQueryIconVisibility()
+    {
+        if (autoSuggestBox.FindDescendant(QueryButton) is Button queryButton)
+        {
+            if (Owner.QueryIcon is not null)
+            {
+                queryButton.Visibility = Visibility.Visible;
+            }
+            else
+            {
+                queryButton.Visibility = Visibility.Collapsed;
+            }
+        }
+    }
+}

src/Snap.Hutao/Snap.Hutao/Control/TokenizingTextBox/TokenizingTextBoxItem.xaml

@@ -0,0 +1,837 @@
+<ResourceDictionary
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+    xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
+    xmlns:shct="using:Snap.Hutao.Control.TokenizingTextBox"
+    xmlns:win="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
+
+    <ResourceDictionary.ThemeDictionaries>
+        <ResourceDictionary x:Key="Default">
+            <StaticResource x:Key="TokenItemBackground" ResourceKey="ControlFillColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBackgroundPointerOver" ResourceKey="ControlFillColorSecondaryBrush"/>
+            <StaticResource x:Key="TokenItemBackgroundPressed" ResourceKey="ControlFillColorSecondaryBrush"/>
+            <StaticResource x:Key="TokenItemBackgroundSelected" ResourceKey="AccentFillColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBackgroundPointerOverSelected" ResourceKey="AccentFillColorSecondaryBrush"/>
+            <StaticResource x:Key="TokenItemBackgroundPressedSelected" ResourceKey="AccentFillColorTertiaryBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrush" ResourceKey="ControlStrokeColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrushPointerOver" ResourceKey="ControlStrokeColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrushPressed" ResourceKey="ControlStrokeColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrushSelected" ResourceKey="AccentFillColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrushPointerOverSelected" ResourceKey="AccentFillColorSecondaryBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrushPressedSelected" ResourceKey="AccentFillColorTertiaryBrush"/>
+            <StaticResource x:Key="TokenItemForeground" ResourceKey="TextFillColorPrimaryBrush"/>
+            <StaticResource x:Key="TokenItemForegroundPointerOver" ResourceKey="TextFillColorPrimaryBrush"/>
+            <StaticResource x:Key="TokenItemForegroundPressed" ResourceKey="TextFillColorSecondaryBrush"/>
+            <StaticResource x:Key="TokenItemForegroundSelected" ResourceKey="TextOnAccentFillColorPrimaryBrush"/>
+            <StaticResource x:Key="TokenItemForegroundPointerOverSelected" ResourceKey="TextOnAccentFillColorPrimaryBrush"/>
+            <StaticResource x:Key="TokenItemForegroundPressedSelected" ResourceKey="TextOnAccentFillColorSecondaryBrush"/>
+            <Thickness x:Key="TokenItemBorderThickness">1</Thickness>
+        </ResourceDictionary>
+        <ResourceDictionary x:Key="Light">
+            <StaticResource x:Key="TokenItemBackground" ResourceKey="ControlFillColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBackgroundPointerOver" ResourceKey="ControlFillColorSecondaryBrush"/>
+            <StaticResource x:Key="TokenItemBackgroundPressed" ResourceKey="ControlFillColorSecondaryBrush"/>
+            <StaticResource x:Key="TokenItemBackgroundSelected" ResourceKey="AccentFillColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBackgroundPointerOverSelected" ResourceKey="AccentFillColorSecondaryBrush"/>
+            <StaticResource x:Key="TokenItemBackgroundPressedSelected" ResourceKey="AccentFillColorTertiaryBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrush" ResourceKey="ControlStrokeColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrushPointerOver" ResourceKey="ControlStrokeColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrushPressed" ResourceKey="ControlStrokeColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrushSelected" ResourceKey="AccentFillColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrushPointerOverSelected" ResourceKey="AccentFillColorSecondaryBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrushPressedSelected" ResourceKey="AccentFillColorTertiaryBrush"/>
+            <StaticResource x:Key="TokenItemForeground" ResourceKey="TextFillColorPrimaryBrush"/>
+            <StaticResource x:Key="TokenItemForegroundPointerOver" ResourceKey="TextFillColorPrimaryBrush"/>
+            <StaticResource x:Key="TokenItemForegroundPressed" ResourceKey="TextFillColorSecondaryBrush"/>
+            <StaticResource x:Key="TokenItemForegroundSelected" ResourceKey="TextOnAccentFillColorPrimaryBrush"/>
+            <StaticResource x:Key="TokenItemForegroundPointerOverSelected" ResourceKey="TextOnAccentFillColorPrimaryBrush"/>
+            <StaticResource x:Key="TokenItemForegroundPressedSelected" ResourceKey="TextOnAccentFillColorSecondaryBrush"/>
+            <Thickness x:Key="TokenItemBorderThickness">1</Thickness>
+        </ResourceDictionary>
+        <ResourceDictionary x:Key="HighContrast">
+            <StaticResource x:Key="TokenItemBackground" ResourceKey="ControlFillColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBackgroundPointerOver" ResourceKey="ControlFillColorSecondaryBrush"/>
+            <StaticResource x:Key="TokenItemBackgroundPressed" ResourceKey="ControlFillColorSecondaryBrush"/>
+            <StaticResource x:Key="TokenItemBackgroundSelected" ResourceKey="AccentFillColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBackgroundPointerOverSelected" ResourceKey="AccentFillColorSecondaryBrush"/>
+            <StaticResource x:Key="TokenItemBackgroundPressedSelected" ResourceKey="AccentFillColorTertiaryBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrush" ResourceKey="ControlStrokeColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrushPointerOver" ResourceKey="ControlStrokeColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrushPressed" ResourceKey="ControlStrokeColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrushSelected" ResourceKey="AccentFillColorDefaultBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrushPointerOverSelected" ResourceKey="AccentFillColorSecondaryBrush"/>
+            <StaticResource x:Key="TokenItemBorderBrushPressedSelected" ResourceKey="AccentFillColorTertiaryBrush"/>
+            <StaticResource x:Key="TokenItemForeground" ResourceKey="TextFillColorPrimaryBrush"/>
+            <StaticResource x:Key="TokenItemForegroundPointerOver" ResourceKey="TextFillColorPrimaryBrush"/>
+            <StaticResource x:Key="TokenItemForegroundPressed" ResourceKey="TextFillColorSecondaryBrush"/>
+            <StaticResource x:Key="TokenItemForegroundSelected" ResourceKey="TextOnAccentFillColorPrimaryBrush"/>
+            <StaticResource x:Key="TokenItemForegroundPointerOverSelected" ResourceKey="TextOnAccentFillColorPrimaryBrush"/>
+            <StaticResource x:Key="TokenItemForegroundPressedSelected" ResourceKey="TextOnAccentFillColorSecondaryBrush"/>
+            <Thickness x:Key="TokenItemBorderThickness">1</Thickness>
+        </ResourceDictionary>
+    </ResourceDictionary.ThemeDictionaries>
+
+    <!--<Thickness x:Key="ButtonPadding">8,4,8,5</Thickness> Not sure if we'll also need this later-->
+    <Thickness x:Key="TextControlThemePadding">10,3,6,6</Thickness>
+    <!--  Need local copy of this, as including WinUI overrides this to something that adds too much padding for our inner box  -->
+    <x:Double x:Key="TokenizingTextBoxIconFontSize">10</x:Double>
+
+    <Thickness x:Key="TokenItemPadding">8,4,4,4</Thickness>
+    <Thickness x:Key="TokenizingTextBoxItemPresenterMargin">0,-2,0,1</Thickness>
+    <HorizontalAlignment x:Key="TokenizingTextBoxItemHorizontalContentAlignment">Center</HorizontalAlignment>
+    <VerticalAlignment x:Key="TokenizingTextBoxItemVerticalContentAlignment">Center</VerticalAlignment>
+
+    <CornerRadius x:Key="PopupOverlayCornerRadius">0,0,0,8</CornerRadius>
+
+    <Style x:Key="TokenizingTextBoxDeleteButtonStyle" TargetType="Button">
+        <Setter Property="Template">
+            <Setter.Value>
+                <ControlTemplate TargetType="Button">
+                    <Grid
+                        x:Name="ButtonLayoutGrid"
+                        Margin="{StaticResource AutoSuggestBoxDeleteButtonMargin}"
+                        Background="{ThemeResource TextControlButtonBackground}"
+                        BorderBrush="{ThemeResource TextControlButtonBorderBrush}"
+                        BorderThickness="{TemplateBinding BorderThickness}"
+                        CornerRadius="{ThemeResource ControlCornerRadius}">
+                        <!--  FontSize is ignored here, see https://github.com/microsoft/microsoft-ui-xaml/issues/2568  -->
+                        <!--  Set in code-behind link:TokenizingTextBoxItem.AutoSuggestBox.cs#L104  -->
+                        <TextBlock
+                            x:Name="GlyphElement"
+                            HorizontalAlignment="Center"
+                            VerticalAlignment="Center"
+                            win:AutomationProperties.AccessibilityView="Raw"
+                            FontFamily="{ThemeResource SymbolThemeFontFamily}"
+                            FontSize="{ThemeResource TokenizingTextBoxIconFontSize}"
+                            FontStyle="Normal"
+                            Foreground="{ThemeResource TextControlButtonForeground}"
+                            Text="&#xE894;"/>
+                        <VisualStateManager.VisualStateGroups>
+                            <VisualStateGroup x:Name="CommonStates">
+                                <VisualState x:Name="Normal"/>
+                                <VisualState x:Name="PointerOver">
+                                    <Storyboard>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ButtonLayoutGrid" Storyboard.TargetProperty="Background">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlButtonBackgroundPointerOver}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ButtonLayoutGrid" Storyboard.TargetProperty="BorderBrush">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlButtonBorderBrushPointerOver}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="GlyphElement" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlButtonForegroundPointerOver}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                    </Storyboard>
+                                </VisualState>
+                                <VisualState x:Name="Pressed">
+                                    <Storyboard>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ButtonLayoutGrid" Storyboard.TargetProperty="Background">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlButtonBackgroundPressed}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ButtonLayoutGrid" Storyboard.TargetProperty="BorderBrush">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlButtonBorderBrushPressed}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="GlyphElement" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlButtonForegroundPressed}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                    </Storyboard>
+                                </VisualState>
+                                <VisualState x:Name="Disabled">
+                                    <Storyboard>
+                                        <DoubleAnimation
+                                            Storyboard.TargetName="ButtonLayoutGrid"
+                                            Storyboard.TargetProperty="Opacity"
+                                            To="0"
+                                            Duration="0"/>
+                                    </Storyboard>
+                                </VisualState>
+                            </VisualStateGroup>
+                        </VisualStateManager.VisualStateGroups>
+                    </Grid>
+                </ControlTemplate>
+            </Setter.Value>
+        </Setter>
+    </Style>
+
+    <Style x:Name="TokenizingTextBoxQueryButtonStyle" TargetType="Button">
+        <Setter Property="Template">
+            <Setter.Value>
+                <ControlTemplate TargetType="Button">
+                    <ContentPresenter
+                        x:Name="ContentPresenter"
+                        Margin="{ThemeResource AutoSuggestBoxInnerButtonMargin}"
+                        Padding="{TemplateBinding Padding}"
+                        HorizontalContentAlignment="{TemplateBinding HorizontalContentAlignment}"
+                        VerticalContentAlignment="{TemplateBinding VerticalContentAlignment}"
+                        muxc:AnimatedIcon.State="Normal"
+                        win:AutomationProperties.AccessibilityView="Raw"
+                        Background="{ThemeResource TextControlButtonBackground}"
+                        BackgroundSizing="{TemplateBinding BackgroundSizing}"
+                        BorderBrush="{ThemeResource TextControlButtonBorderBrush}"
+                        BorderThickness="{TemplateBinding BorderThickness}"
+                        Content="{TemplateBinding Content}"
+                        ContentTemplate="{TemplateBinding ContentTemplate}"
+                        ContentTransitions="{TemplateBinding ContentTransitions}"
+                        CornerRadius="{TemplateBinding CornerRadius}"
+                        FontSize="{TemplateBinding FontSize}">
+                        <VisualStateManager.VisualStateGroups>
+                            <VisualStateGroup x:Name="CommonStates">
+                                <VisualState x:Name="Normal"/>
+
+                                <VisualState x:Name="PointerOver">
+                                    <Storyboard>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="Background">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlButtonBackgroundPointerOver}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="BorderBrush">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlButtonBorderBrushPointerOver}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlButtonForegroundPointerOver}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                    </Storyboard>
+                                    <VisualState.Setters>
+                                        <Setter Target="ContentPresenter.(muxc:AnimatedIcon.State)" Value="PointerOver"/>
+                                    </VisualState.Setters>
+                                </VisualState>
+
+                                <VisualState x:Name="Pressed">
+                                    <Storyboard>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="Background">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlButtonBackgroundPressed}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="BorderBrush">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlButtonBorderBrushPressed}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlButtonForegroundPressed}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                    </Storyboard>
+                                    <VisualState.Setters>
+                                        <Setter Target="ContentPresenter.(muxc:AnimatedIcon.State)" Value="Pressed"/>
+                                    </VisualState.Setters>
+                                </VisualState>
+
+                                <VisualState x:Name="Disabled">
+                                    <Storyboard>
+                                        <DoubleAnimation
+                                            Storyboard.TargetName="ContentPresenter"
+                                            Storyboard.TargetProperty="Opacity"
+                                            To="0"
+                                            Duration="0"/>
+                                    </Storyboard>
+                                </VisualState>
+                            </VisualStateGroup>
+                        </VisualStateManager.VisualStateGroups>
+                    </ContentPresenter>
+                </ControlTemplate>
+            </Setter.Value>
+        </Setter>
+    </Style>
+
+    <!--  Inner TextBox Style with removed borders to look like part of the outer textbox facade we've setup  -->
+    <Style
+        x:Key="TokenizingTextBoxTextBoxStyle"
+        BasedOn="{StaticResource AutoSuggestBoxTextBoxStyle}"
+        TargetType="TextBox">
+        <Setter Property="MinWidth" Value="{ThemeResource TextControlThemeMinWidth}"/>
+        <Setter Property="Foreground" Value="{ThemeResource TextControlForeground}"/>
+        <Setter Property="Background" Value="Transparent"/>
+        <Setter Property="BorderBrush" Value="Transparent"/>
+        <Setter Property="SelectionHighlightColor" Value="{ThemeResource TextControlSelectionHighlightColor}"/>
+        <Setter Property="BorderThickness" Value="0"/>
+        <!--  Override  -->
+        <Setter Property="FontFamily" Value="{ThemeResource ContentControlThemeFontFamily}"/>
+        <Setter Property="FontSize" Value="{ThemeResource ControlContentThemeFontSize}"/>
+        <Setter Property="ScrollViewer.HorizontalScrollMode" Value="Auto"/>
+        <Setter Property="ScrollViewer.VerticalScrollMode" Value="Auto"/>
+        <Setter Property="ScrollViewer.HorizontalScrollBarVisibility" Value="Hidden"/>
+        <Setter Property="ScrollViewer.VerticalScrollBarVisibility" Value="Hidden"/>
+        <win:Setter Property="ScrollViewer.IsDeferredScrollingEnabled" Value="False"/>
+        <Setter Property="Padding" Value="8,5,6,6"/>
+        <Setter Property="CornerRadius" Value="{ThemeResource ControlCornerRadius}"/>
+        <Setter Property="MinHeight" Value="28"/>
+        <!--  Override  -->
+        <win:Setter Property="SelectionHighlightColorWhenNotFocused" Value="{ThemeResource TextControlSelectionHighlightColor}"/>
+        <!--  Override  -->
+        <Setter Property="Template">
+            <Setter.Value>
+                <ControlTemplate TargetType="TextBox">
+                    <Grid ColumnSpacing="2">
+                        <Grid.ColumnDefinitions>
+                            <ColumnDefinition Width="*"/>
+                            <ColumnDefinition Width="Auto"/>
+                            <ColumnDefinition Width="Auto"/>
+                            <ColumnDefinition Width="Auto"/>
+                        </Grid.ColumnDefinitions>
+                        <Grid.RowDefinitions>
+                            <RowDefinition Height="Auto"/>
+                            <RowDefinition Height="*"/>
+                        </Grid.RowDefinitions>
+                        <Border
+                            x:Name="BorderElement"
+                            Grid.Row="1"
+                            Grid.RowSpan="1"
+                            Grid.ColumnSpan="3"
+                            BorderBrush="{TemplateBinding BorderBrush}"
+                            BorderThickness="{TemplateBinding BorderThickness}"/>
+                        <ContentPresenter
+                            x:Name="HeaderContentPresenter"
+                            Grid.Row="0"
+                            Grid.ColumnSpan="3"
+                            Margin="{ThemeResource AutoSuggestBoxTopHeaderMargin}"
+                            x:DeferLoadStrategy="Lazy"
+                            Content="{TemplateBinding Header}"
+                            ContentTemplate="{TemplateBinding HeaderTemplate}"
+                            FontWeight="Normal"
+                            Foreground="{ThemeResource TextControlHeaderForeground}"
+                            TextWrapping="Wrap"
+                            Visibility="Collapsed"/>
+                        <ScrollViewer
+                            x:Name="ContentElement"
+                            Grid.Row="1"
+                            Margin="{TemplateBinding BorderThickness}"
+                            Padding="{TemplateBinding Padding}"
+                            win:AutomationProperties.AccessibilityView="Raw"
+                            win:IsDeferredScrollingEnabled="{TemplateBinding ScrollViewer.IsDeferredScrollingEnabled}"
+                            win:IsHorizontalRailEnabled="{TemplateBinding ScrollViewer.IsHorizontalRailEnabled}"
+                            win:IsVerticalRailEnabled="{TemplateBinding ScrollViewer.IsVerticalRailEnabled}"
+                            HorizontalScrollBarVisibility="{TemplateBinding ScrollViewer.HorizontalScrollBarVisibility}"
+                            HorizontalScrollMode="{TemplateBinding ScrollViewer.HorizontalScrollMode}"
+                            IsTabStop="False"
+                            VerticalScrollBarVisibility="{TemplateBinding ScrollViewer.VerticalScrollBarVisibility}"
+                            VerticalScrollMode="{TemplateBinding ScrollViewer.VerticalScrollMode}"
+                            ZoomMode="Disabled"/>
+                        <ContentControl
+                            x:Name="PlaceholderTextContentPresenter"
+                            Grid.Row="1"
+                            Grid.ColumnSpan="2"
+                            Padding="{TemplateBinding Padding}"
+                            VerticalContentAlignment="Center"
+                            Content="{TemplateBinding PlaceholderText}"
+                            Foreground="{ThemeResource TextControlPlaceholderForeground}"
+                            IsHitTestVisible="False"
+                            IsTabStop="False"/>
+                        <Button
+                            x:Name="DeleteButton"
+                            Grid.Row="1"
+                            Grid.Column="1"
+                            Width="32"
+                            Height="28"
+                            Padding="{ThemeResource HelperButtonThemePadding}"
+                            VerticalAlignment="Stretch"
+                            win:AutomationProperties.AccessibilityView="Raw"
+                            BorderThickness="{TemplateBinding BorderThickness}"
+                            CornerRadius="{TemplateBinding CornerRadius}"
+                            FontSize="{TemplateBinding FontSize}"
+                            IsTabStop="False"
+                            Style="{StaticResource TokenizingTextBoxDeleteButtonStyle}"
+                            Visibility="Collapsed"/>
+
+                        <TextBlock
+                            Name="PART_TokensCounter"
+                            Grid.Row="1"
+                            Grid.Column="2"
+                            Margin="2,0,0,2"
+                            VerticalAlignment="Center"
+                            Foreground="{ThemeResource TextFillColorSecondaryBrush}"
+                            Style="{StaticResource CaptionTextBlockStyle}"/>
+
+                        <Button
+                            x:Name="QueryButton"
+                            Grid.Row="1"
+                            Grid.Column="3"
+                            Width="32"
+                            Height="28"
+                            Margin="0,0,2,0"
+                            Padding="0"
+                            VerticalAlignment="Stretch"
+                            win:AutomationProperties.AccessibilityView="Raw"
+                            BorderThickness="{TemplateBinding BorderThickness}"
+                            CornerRadius="{TemplateBinding CornerRadius}"
+                            FontSize="{TemplateBinding FontSize}"
+                            IsTabStop="False"
+                            Style="{StaticResource TokenizingTextBoxQueryButtonStyle}"/>
+
+                        <VisualStateManager.VisualStateGroups>
+                            <VisualStateGroup x:Name="CommonStates">
+                                <VisualState x:Name="Disabled">
+                                    <Storyboard>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="HeaderContentPresenter" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlHeaderForegroundDisabled}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentElement" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlForegroundDisabled}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="PlaceholderTextContentPresenter" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlPlaceholderForegroundDisabled}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                    </Storyboard>
+                                </VisualState>
+                                <VisualState x:Name="Normal"/>
+                                <VisualState x:Name="PointerOver">
+                                    <Storyboard>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="PlaceholderTextContentPresenter" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlPlaceholderForegroundPointerOver}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentElement" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlForegroundPointerOver}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                    </Storyboard>
+                                </VisualState>
+                                <VisualState x:Name="Focused">
+                                    <Storyboard>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="PlaceholderTextContentPresenter" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlPlaceholderForegroundFocused}"/>
+                                            <!--  WinUI override  -->
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentElement" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlForegroundFocused}"/>
+                                            <!--  WinUI override  -->
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <!--<ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentElement"
+                                                                   Storyboard.TargetProperty="RequestedTheme">
+                                        <DiscreteObjectKeyFrame KeyTime="0"
+                                                                Value="Light" />
+                                    </ObjectAnimationUsingKeyFrames>-->
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="QueryButton" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextControlButtonForeground}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                    </Storyboard>
+                                </VisualState>
+                            </VisualStateGroup>
+                            <VisualStateGroup x:Name="ButtonStates">
+                                <VisualState x:Name="ButtonVisible">
+                                    <Storyboard>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="DeleteButton" Storyboard.TargetProperty="Visibility">
+                                            <DiscreteObjectKeyFrame KeyTime="0">
+                                                <DiscreteObjectKeyFrame.Value>
+                                                    <Visibility>Visible</Visibility>
+                                                </DiscreteObjectKeyFrame.Value>
+                                            </DiscreteObjectKeyFrame>
+                                        </ObjectAnimationUsingKeyFrames>
+                                    </Storyboard>
+                                </VisualState>
+                                <VisualState x:Name="ButtonCollapsed"/>
+                            </VisualStateGroup>
+                            <VisualStateGroup x:Name="TokensCounterStates">
+                                <VisualState x:Name="MaxReachedState">
+                                    <Storyboard>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="PART_TokensCounter" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource SystemFillColorCriticalBrush}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                    </Storyboard>
+                                </VisualState>
+                                <VisualState x:Name="MaxUnreachedState"/>
+                            </VisualStateGroup>
+                        </VisualStateManager.VisualStateGroups>
+                    </Grid>
+                </ControlTemplate>
+            </Setter.Value>
+        </Setter>
+    </Style>
+
+    <Style x:Key="TokenizingTextBoxItemTextStyle" TargetType="shct:TokenizingTextBoxItem">
+        <Setter Property="Background" Value="{ThemeResource SystemControlBackgroundChromeMediumLowBrush}"/>
+        <Setter Property="BorderBrush" Value="{ThemeResource SystemControlTransparentBrush}"/>
+        <Setter Property="IsTabStop" Value="False"/>
+        <Setter Property="UseSystemFocusVisuals" Value="False"/>
+        <Setter Property="MinWidth" Value="128"/>
+        <Setter Property="Template">
+            <Setter.Value>
+                <ControlTemplate TargetType="shct:TokenizingTextBoxItem">
+                    <AutoSuggestBox
+                        Name="PART_AutoSuggestBox"
+                        DisplayMemberPath="{Binding Path=Owner.DisplayMemberPath, RelativeSource={RelativeSource Mode=TemplatedParent}}"
+                        ItemTemplate="{Binding Path=Owner.SuggestedItemTemplate, RelativeSource={RelativeSource Mode=TemplatedParent}}"
+                        ItemsSource="{Binding Path=Owner.SuggestedItemsSource, RelativeSource={RelativeSource Mode=TemplatedParent}}"
+                        PlaceholderText="{Binding Path=Owner.PlaceholderText, RelativeSource={RelativeSource Mode=TemplatedParent}}"
+                        Style="{StaticResource SystemAutoSuggestBoxStyle}"
+                        Text="{Binding Text, Mode=TwoWay}"
+                        TextBoxStyle="{StaticResource TokenizingTextBoxTextBoxStyle}"
+                        TextMemberPath="{Binding Path=Owner.TextMemberPath, RelativeSource={RelativeSource Mode=TemplatedParent}}"
+                        UpdateTextOnSelect="False"/>
+                </ControlTemplate>
+            </Setter.Value>
+        </Setter>
+    </Style>
+
+    <!--  Copy of System Style from 18362 to try and workaround WinUI Styles  -->
+    <Style x:Key="SystemAutoSuggestBoxStyle" TargetType="AutoSuggestBox">
+        <Setter Property="VerticalAlignment" Value="Top"/>
+        <Setter Property="IsTabStop" Value="False"/>
+        <Setter Property="TextBoxStyle" Value="{StaticResource AutoSuggestBoxTextBoxStyle}"/>
+        <Setter Property="UseSystemFocusVisuals" Value="{ThemeResource IsApplicationFocusVisualKindReveal}"/>
+        <Setter Property="Template">
+            <Setter.Value>
+                <ControlTemplate TargetType="AutoSuggestBox">
+                    <Grid x:Name="LayoutRoot">
+                        <Grid.ColumnDefinitions>
+                            <ColumnDefinition Width="*"/>
+                        </Grid.ColumnDefinitions>
+
+                        <Grid.RowDefinitions>
+                            <RowDefinition Height="*"/>
+                        </Grid.RowDefinitions>
+
+                        <TextBox
+                            x:Name="TextBox"
+                            Width="{TemplateBinding Width}"
+                            Margin="0"
+                            win:DesiredCandidateWindowAlignment="BottomEdge"
+                            Canvas.ZIndex="0"
+                            CornerRadius="4"
+                            Header="{TemplateBinding Header}"
+                            PlaceholderText="{TemplateBinding PlaceholderText}"
+                            ScrollViewer.BringIntoViewOnFocusChange="False"
+                            Style="{TemplateBinding TextBoxStyle}"
+                            UseSystemFocusVisuals="{TemplateBinding UseSystemFocusVisuals}"/>
+
+                        <Popup x:Name="SuggestionsPopup">
+                            <Border
+                                x:Name="SuggestionsContainer"
+                                Background="{ThemeResource AutoSuggestBoxSuggestionsListBackground}"
+                                CornerRadius="{StaticResource PopupOverlayCornerRadius}">
+                                <ListView
+                                    x:Name="SuggestionsList"
+                                    MaxHeight="{ThemeResource AutoSuggestListMaxHeight}"
+                                    Margin="{ThemeResource AutoSuggestListPadding}"
+                                    Padding="{ThemeResource AutoSuggestListPadding}"
+                                    BorderBrush="{ThemeResource AutoSuggestBoxSuggestionsListBorderBrush}"
+                                    BorderThickness="{ThemeResource AutoSuggestListBorderThemeThickness}"
+                                    DisplayMemberPath="{TemplateBinding DisplayMemberPath}"
+                                    IsItemClickEnabled="True"
+                                    ItemContainerStyle="{TemplateBinding ItemContainerStyle}"
+                                    ItemTemplate="{TemplateBinding ItemTemplate}"
+                                    ItemTemplateSelector="{TemplateBinding ItemTemplateSelector}"/>
+                            </Border>
+                        </Popup>
+
+                        <VisualStateManager.VisualStateGroups>
+                            <VisualStateGroup x:Name="Orientation">
+                                <VisualState x:Name="Landscape"/>
+                                <VisualState x:Name="Portrait"/>
+
+                            </VisualStateGroup>
+
+                        </VisualStateManager.VisualStateGroups>
+                    </Grid>
+
+                </ControlTemplate>
+            </Setter.Value>
+        </Setter>
+    </Style>
+
+
+
+    <Style x:Key="TokenizingTextBoxItemTokenStyle" TargetType="shct:TokenizingTextBoxItem">
+        <Setter Property="ClearButtonStyle" Value="{StaticResource SubtleButtonStyle}"/>
+        <Setter Property="HorizontalContentAlignment" Value="{StaticResource TokenizingTextBoxItemHorizontalContentAlignment}"/>
+        <Setter Property="VerticalContentAlignment" Value="{StaticResource TokenizingTextBoxItemVerticalContentAlignment}"/>
+        <!--<Setter Property="HorizontalAlignment" Value="Center" />-->
+        <Setter Property="VerticalAlignment" Value="Center"/>
+        <Setter Property="FontFamily" Value="{ThemeResource ContentControlThemeFontFamily}"/>
+        <Setter Property="Background" Value="{ThemeResource TokenItemBackground}"/>
+        <Setter Property="BorderBrush" Value="{ThemeResource TokenItemBorderBrush}"/>
+        <Setter Property="BorderThickness" Value="{ThemeResource TokenItemBorderThickness}"/>
+        <Setter Property="CornerRadius" Value="2"/>
+        <Setter Property="Padding" Value="{ThemeResource TokenItemPadding}"/>
+        <Setter Property="IsTabStop" Value="True"/>
+        <Setter Property="TabNavigation" Value="Local"/>
+        <Setter Property="Foreground" Value="{ThemeResource TokenItemForeground}"/>
+        <Setter Property="FontWeight" Value="Normal"/>
+        <Setter Property="UseSystemFocusVisuals" Value="True"/>
+        <Setter Property="FocusVisualMargin" Value="-3"/>
+        <Setter Property="BackgroundSizing" Value="InnerBorderEdge"/>
+        <Setter Property="FontSize" Value="{ThemeResource ControlContentThemeFontSize}"/>
+        <Setter Property="Template">
+            <Setter.Value>
+                <ControlTemplate TargetType="shct:TokenizingTextBoxItem">
+                    <Grid
+                        x:Name="PART_RootGrid"
+                        Height="{TemplateBinding Height}"
+                        Padding="{TemplateBinding Padding}"
+                        HorizontalAlignment="{TemplateBinding HorizontalAlignment}"
+                        VerticalAlignment="{TemplateBinding VerticalAlignment}"
+                        Background="{TemplateBinding Background}"
+                        BackgroundSizing="{TemplateBinding BackgroundSizing}"
+                        BorderBrush="{TemplateBinding BorderBrush}"
+                        BorderThickness="{TemplateBinding BorderThickness}"
+                        ColumnSpacing="8"
+                        Control.IsTemplateFocusTarget="True"
+                        CornerRadius="{TemplateBinding CornerRadius}">
+                        <win:Grid.BackgroundTransition>
+                            <win:BrushTransition Duration="0:0:0.083"/>
+                        </win:Grid.BackgroundTransition>
+                        <Grid.ColumnDefinitions>
+                            <ColumnDefinition Width="Auto"/>
+                            <ColumnDefinition Width="Auto"/>
+                        </Grid.ColumnDefinitions>
+                        <!--  Content  -->
+                        <ContentPresenter
+                            x:Name="PART_ContentPresenter"
+                            Margin="0,-1,0,0"
+                            VerticalAlignment="Center"
+                            HorizontalContentAlignment="{TemplateBinding HorizontalContentAlignment}"
+                            VerticalContentAlignment="{TemplateBinding VerticalContentAlignment}"
+                            win:OpticalMarginAlignment="TrimSideBearings"
+                            BackgroundSizing="{TemplateBinding BackgroundSizing}"
+                            Content="{TemplateBinding Content}"
+                            ContentTransitions="{TemplateBinding ContentTransitions}"
+                            FontWeight="{TemplateBinding FontWeight}"
+                            Foreground="{TemplateBinding Foreground}"/>
+                        <Button
+                            x:Name="PART_RemoveButton"
+                            Grid.Row="1"
+                            Grid.Column="1"
+                            Width="20"
+                            Height="20"
+                            MinWidth="0"
+                            MinHeight="0"
+                            Margin="0,0,0,-2"
+                            Padding="2"
+                            VerticalAlignment="Center"
+                            CornerRadius="99"
+                            IsTabStop="False"
+                            Style="{TemplateBinding ClearButtonStyle}">
+                            <FontIcon FontSize="12" Glyph="&#xE894;"/>
+                        </Button>
+                        <VisualStateManager.VisualStateGroups>
+                            <VisualStateGroup x:Name="CommonStates">
+                                <VisualState x:Name="Normal"/>
+                                <VisualState x:Name="PointerOver">
+                                    <VisualState.Setters>
+                                        <Setter Target="PART_RootGrid.Background" Value="{ThemeResource TokenItemBackgroundPointerOver}"/>
+                                    </VisualState.Setters>
+                                </VisualState>
+                                <VisualState x:Name="Pressed">
+                                    <VisualState.Setters>
+                                        <Setter Target="PART_RootGrid.Background" Value="{ThemeResource TokenItemBackgroundPressed}"/>
+                                        <Setter Target="PART_RootGrid.BorderBrush" Value="{ThemeResource TokenItemBorderBrushPointerOver}"/>
+                                        <Setter Target="PART_ContentPresenter.Foreground" Value="{ThemeResource TokenItemForegroundPointerOver}"/>
+                                        <Setter Target="PART_RemoveButton.Foreground" Value="{ThemeResource TokenItemForegroundPointerOver}"/>
+                                    </VisualState.Setters>
+                                </VisualState>
+                                <VisualState x:Name="Selected">
+                                    <VisualState.Setters>
+                                        <Setter Target="PART_RootGrid.Background" Value="{ThemeResource TokenItemBackgroundSelected}"/>
+                                        <Setter Target="PART_RootGrid.BorderBrush" Value="{ThemeResource TokenItemBorderBrushSelected}"/>
+                                        <Setter Target="PART_ContentPresenter.Foreground" Value="{ThemeResource TokenItemForegroundSelected}"/>
+                                        <Setter Target="PART_RemoveButton.Style" Value="{ThemeResource SubtleAccentButtonStyle}"/>
+                                        <Setter Target="PART_RootGrid.BackgroundSizing" Value="OuterBorderEdge"/>
+                                    </VisualState.Setters>
+                                </VisualState>
+                                <VisualState x:Name="PointerOverSelected">
+                                    <VisualState.Setters>
+                                        <Setter Target="PART_RootGrid.Background" Value="{ThemeResource TokenItemBackgroundPointerOverSelected}"/>
+                                        <Setter Target="PART_RootGrid.BorderBrush" Value="{ThemeResource TokenItemBorderBrushPointerOverSelected}"/>
+                                        <Setter Target="PART_ContentPresenter.Foreground" Value="{ThemeResource TokenItemForegroundPointerOverSelected}"/>
+                                        <Setter Target="PART_RemoveButton.Style" Value="{ThemeResource SubtleAccentButtonStyle}"/>
+                                        <Setter Target="PART_RootGrid.BackgroundSizing" Value="OuterBorderEdge"/>
+                                    </VisualState.Setters>
+                                </VisualState>
+                                <VisualState x:Name="PressedSelected">
+                                    <VisualState.Setters>
+                                        <Setter Target="PART_RootGrid.Background" Value="{ThemeResource TokenItemBackgroundPressedSelected}"/>
+                                        <Setter Target="PART_RootGrid.BorderBrush" Value="{ThemeResource TokenItemBorderBrushPressedSelected}"/>
+                                        <Setter Target="PART_ContentPresenter.Foreground" Value="{ThemeResource TokenItemForegroundPressedSelected}"/>
+                                        <Setter Target="PART_RemoveButton.Style" Value="{ThemeResource SubtleAccentButtonStyle}"/>
+                                        <Setter Target="PART_RootGrid.BackgroundSizing" Value="OuterBorderEdge"/>
+                                    </VisualState.Setters>
+                                </VisualState>
+                            </VisualStateGroup>
+                            <VisualStateGroup x:Name="DisabledStates">
+                                <VisualState x:Name="Enabled"/>
+                                <VisualState x:Name="Disabled">
+                                    <VisualState.Setters>
+                                        <Setter Target="PART_ContentPresenter.Opacity" Value="{ThemeResource ListViewItemDisabledThemeOpacity}"/>
+                                    </VisualState.Setters>
+                                </VisualState>
+                            </VisualStateGroup>
+                        </VisualStateManager.VisualStateGroups>
+                    </Grid>
+                </ControlTemplate>
+            </Setter.Value>
+        </Setter>
+    </Style>
+
+    <!--  Default style for TokenizingTextBoxItem  -->
+    <Style BasedOn="{StaticResource TokenizingTextBoxItemTokenStyle}" TargetType="shct:TokenizingTextBoxItem"/>
+
+    <Style x:Key="SubtleButtonStyle" TargetType="Button">
+        <Setter Property="Background" Value="{ThemeResource SubtleFillColorTransparent}"/>
+        <Setter Property="BackgroundSizing" Value="InnerBorderEdge"/>
+        <Setter Property="Foreground" Value="{ThemeResource TextFillColorPrimary}"/>
+        <Setter Property="BorderThickness" Value="0"/>
+        <Setter Property="Padding" Value="{StaticResource ButtonPadding}"/>
+        <Setter Property="HorizontalAlignment" Value="Left"/>
+        <Setter Property="VerticalAlignment" Value="Center"/>
+        <Setter Property="FontFamily" Value="{ThemeResource ContentControlThemeFontFamily}"/>
+        <Setter Property="FontWeight" Value="Normal"/>
+        <Setter Property="FontSize" Value="{ThemeResource ControlContentThemeFontSize}"/>
+        <Setter Property="UseSystemFocusVisuals" Value="{StaticResource UseSystemFocusVisuals}"/>
+        <Setter Property="FocusVisualMargin" Value="-3"/>
+        <Setter Property="CornerRadius" Value="{ThemeResource ControlCornerRadius}"/>
+        <Setter Property="Template">
+            <Setter.Value>
+                <ControlTemplate TargetType="Button">
+                    <ContentPresenter
+                        x:Name="ContentPresenter"
+                        Padding="{TemplateBinding Padding}"
+                        HorizontalContentAlignment="{TemplateBinding HorizontalContentAlignment}"
+                        VerticalContentAlignment="{TemplateBinding VerticalContentAlignment}"
+                        muxc:AnimatedIcon.State="Normal"
+                        win:AutomationProperties.AccessibilityView="Raw"
+                        Background="{TemplateBinding Background}"
+                        BackgroundSizing="{TemplateBinding BackgroundSizing}"
+                        BorderBrush="{TemplateBinding BorderBrush}"
+                        BorderThickness="{TemplateBinding BorderThickness}"
+                        Content="{TemplateBinding Content}"
+                        ContentTemplate="{TemplateBinding ContentTemplate}"
+                        ContentTransitions="{TemplateBinding ContentTransitions}"
+                        CornerRadius="{TemplateBinding CornerRadius}">
+                        <win:ContentPresenter.BackgroundTransition>
+                            <win:BrushTransition Duration="0:0:0.083"/>
+                        </win:ContentPresenter.BackgroundTransition>
+
+                        <VisualStateManager.VisualStateGroups>
+                            <VisualStateGroup x:Name="CommonStates">
+                                <VisualState x:Name="Normal"/>
+                                <VisualState x:Name="PointerOver">
+                                    <Storyboard>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="Background">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource SubtleFillColorSecondary}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextFillColorPrimary}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                    </Storyboard>
+                                    <VisualState.Setters>
+                                        <Setter Target="ContentPresenter.(muxc:AnimatedIcon.State)" Value="PointerOver"/>
+                                    </VisualState.Setters>
+                                </VisualState>
+
+                                <VisualState x:Name="Pressed">
+                                    <Storyboard>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="Background">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource SubtleFillColorTertiary}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextFillColorSecondary}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                    </Storyboard>
+                                    <VisualState.Setters>
+                                        <Setter Target="ContentPresenter.(muxc:AnimatedIcon.State)" Value="Pressed"/>
+                                    </VisualState.Setters>
+                                </VisualState>
+
+                                <VisualState x:Name="Disabled">
+                                    <Storyboard>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="Background">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource ControlFillColorDisabled}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextFillColorDisabled}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                    </Storyboard>
+                                    <VisualState.Setters>
+                                        <!--  DisabledVisual Should be handled by the control, not the animated icon.  -->
+                                        <Setter Target="ContentPresenter.(muxc:AnimatedIcon.State)" Value="Normal"/>
+                                    </VisualState.Setters>
+                                </VisualState>
+                            </VisualStateGroup>
+                        </VisualStateManager.VisualStateGroups>
+                    </ContentPresenter>
+                </ControlTemplate>
+            </Setter.Value>
+        </Setter>
+    </Style>
+
+    <Style x:Key="SubtleAccentButtonStyle" TargetType="Button">
+        <Setter Property="Background" Value="{ThemeResource SubtleFillColorTransparent}"/>
+        <Setter Property="BackgroundSizing" Value="InnerBorderEdge"/>
+        <Setter Property="Foreground" Value="{ThemeResource TextOnAccentFillColorPrimaryBrush}"/>
+        <Setter Property="BorderThickness" Value="0"/>
+        <Setter Property="Padding" Value="{StaticResource ButtonPadding}"/>
+        <Setter Property="HorizontalAlignment" Value="Left"/>
+        <Setter Property="VerticalAlignment" Value="Center"/>
+        <Setter Property="FontFamily" Value="{ThemeResource ContentControlThemeFontFamily}"/>
+        <Setter Property="FontWeight" Value="Normal"/>
+        <Setter Property="FontSize" Value="{ThemeResource ControlContentThemeFontSize}"/>
+        <Setter Property="UseSystemFocusVisuals" Value="{StaticResource UseSystemFocusVisuals}"/>
+        <Setter Property="FocusVisualMargin" Value="-3"/>
+        <Setter Property="CornerRadius" Value="{ThemeResource ControlCornerRadius}"/>
+        <Setter Property="Template">
+            <Setter.Value>
+                <ControlTemplate TargetType="Button">
+                    <ContentPresenter
+                        x:Name="ContentPresenter"
+                        Padding="{TemplateBinding Padding}"
+                        HorizontalContentAlignment="{TemplateBinding HorizontalContentAlignment}"
+                        VerticalContentAlignment="{TemplateBinding VerticalContentAlignment}"
+                        muxc:AnimatedIcon.State="Normal"
+                        win:AutomationProperties.AccessibilityView="Raw"
+                        Background="{TemplateBinding Background}"
+                        BackgroundSizing="{TemplateBinding BackgroundSizing}"
+                        BorderBrush="{TemplateBinding BorderBrush}"
+                        BorderThickness="{TemplateBinding BorderThickness}"
+                        Content="{TemplateBinding Content}"
+                        ContentTemplate="{TemplateBinding ContentTemplate}"
+                        ContentTransitions="{TemplateBinding ContentTransitions}"
+                        CornerRadius="{TemplateBinding CornerRadius}">
+                        <win:ContentPresenter.BackgroundTransition>
+                            <win:BrushTransition Duration="0:0:0.083"/>
+                        </win:ContentPresenter.BackgroundTransition>
+
+                        <VisualStateManager.VisualStateGroups>
+                            <VisualStateGroup x:Name="CommonStates">
+                                <VisualState x:Name="Normal"/>
+                                <VisualState x:Name="PointerOver">
+                                    <Storyboard>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="Background">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource SubtleFillColorSecondary}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextOnAccentFillColorPrimaryBrush}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                    </Storyboard>
+                                    <VisualState.Setters>
+                                        <Setter Target="ContentPresenter.(muxc:AnimatedIcon.State)" Value="PointerOver"/>
+                                    </VisualState.Setters>
+                                </VisualState>
+
+                                <VisualState x:Name="Pressed">
+                                    <Storyboard>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="Background">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource SubtleFillColorTertiary}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="Foreground">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource TextOnAccentFillColorSecondaryBrush}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                    </Storyboard>
+                                    <VisualState.Setters>
+                                        <Setter Target="ContentPresenter.(muxc:AnimatedIcon.State)" Value="Pressed"/>
+                                    </VisualState.Setters>
+                                </VisualState>
+
+                                <VisualState x:Name="Disabled">
+                                    <Storyboard>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="Background">
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource ControlFillColorTransparentBrush}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                        <ObjectAnimationUsingKeyFrames Storyboard.TargetName="ContentPresenter" Storyboard.TargetProperty="Foreground">
+                                            <!--  Should be TextOnAccentFillColorDisabledBrush, but doesn't seem to work? This is the same visual effect  -->
+                                            <DiscreteObjectKeyFrame KeyTime="0" Value="{ThemeResource ControlFillColorDefaultBrush}"/>
+                                        </ObjectAnimationUsingKeyFrames>
+                                    </Storyboard>
+                                    <VisualState.Setters>
+                                        <Setter Target="ContentPresenter.(muxc:AnimatedIcon.State)" Value="Normal"/>
+                                    </VisualState.Setters>
+                                </VisualState>
+                            </VisualStateGroup>
+                        </VisualStateManager.VisualStateGroups>
+                    </ContentPresenter>
+                </ControlTemplate>
+            </Setter.Value>
+        </Setter>
+    </Style>
+</ResourceDictionary>

src/Snap.Hutao/Snap.Hutao/Control/TokenizingTextBox/TokenizingTextBoxStyleSelector.cs

@@ -0,0 +1,25 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.UI.Xaml;
+using Microsoft.UI.Xaml.Controls;
+
+namespace Snap.Hutao.Control.TokenizingTextBox;
+
+internal class TokenizingTextBoxStyleSelector : StyleSelector
+{
+    public Style TokenStyle { get; set; } = default!;
+
+    public Style TextStyle { get; set; } = default!;
+
+    /// <inheritdoc/>
+    protected override Style SelectStyleCore(object item, DependencyObject container)
+    {
+        if (item is ITokenStringContainer)
+        {
+            return TextStyle;
+        }
+
+        return TokenStyle;
+    }
+}

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/Caching/ImageCache.cs

@@ -1,6 +1,7 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
+using Microsoft.Extensions.Caching.Memory;
 using Snap.Hutao.Core.DependencyInjection.Annotation.HttpClient;
 using Snap.Hutao.Core.IO;
 using Snap.Hutao.Core.IO.Hashing;
@@ -28,6 +29,7 @@ namespace Snap.Hutao.Core.Caching;
 internal sealed partial class ImageCache : IImageCache, IImageCacheFilePathOperation
 {
     private const string CacheFolderName = nameof(ImageCache);
+    private const string CacheFailedDownloadTasksName = $"{nameof(ImageCache)}.FailedDownloadTasks";
 
     private readonly FrozenDictionary<int, TimeSpan> retryCountToDelay = FrozenDictionary.ToFrozenDictionary(
     [
@@ -38,10 +40,11 @@ internal sealed partial class ImageCache : IImageCache, IImageCacheFilePathOpera
 
     private readonly ConcurrentDictionary<string, Task> concurrentTasks = new();
 
-    private readonly IHttpClientFactory httpClientFactory;
     private readonly IHttpRequestMessageBuilderFactory httpRequestMessageBuilderFactory;
+    private readonly IHttpClientFactory httpClientFactory;
     private readonly IServiceProvider serviceProvider;
     private readonly ILogger<ImageCache> logger;
+    private readonly IMemoryCache memoryCache;
 
     private string? baseFolder;
     private string? cacheFolder;
@@ -192,6 +195,16 @@ internal sealed partial class ImageCache : IImageCache, IImageCacheFilePathOpera
 
                     if (responseMessage.IsSuccessStatusCode)
                     {
+                        if (responseMessage.Content.Headers.ContentType?.MediaType is "application/json")
+                        {
+#if DEBUG
+                            DebugTrack(uri);
+#endif
+                            string raw = await responseMessage.Content.ReadAsStringAsync().ConfigureAwait(false);
+                            logger.LogColorizedCritical("Failed to download '{Uri}' with unexpected body '{Raw}'", (uri, ConsoleColor.Red), (raw, ConsoleColor.DarkYellow));
+                            return;
+                        }
+
                         using (Stream httpStream = await responseMessage.Content.ReadAsStreamAsync().ConfigureAwait(false))
                         {
                             using (FileStream fileStream = File.Create(baseFile))
@@ -214,10 +227,25 @@ internal sealed partial class ImageCache : IImageCache, IImageCacheFilePathOpera
                             }
 
                         default:
+#if DEBUG
+                            DebugTrack(uri);
+#endif
+                            logger.LogColorizedCritical("Failed to download '{Uri}' with status code '{StatusCode}'", (uri, ConsoleColor.Red), (responseMessage.StatusCode, ConsoleColor.DarkYellow));
                             return;
                     }
                 }
             }
         }
     }
-}
+}
+
+#if DEBUG
+internal partial class ImageCache
+{
+    private void DebugTrack(Uri uri)
+    {
+        HashSet<string>? set = memoryCache.GetOrCreate(CacheFailedDownloadTasksName, entry => entry.Value ??= new HashSet<string>()) as HashSet<string>;
+        set?.Add(uri.ToString());
+    }
+}
+#endif

src/Snap.Hutao/Snap.Hutao/Core/Convert.cs

@@ -1,25 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using System.Security.Cryptography;
-using System.Text;
-
-namespace Snap.Hutao.Core;
-
-/// <summary>
-/// 支持Md5转换
-/// </summary>
-[HighQuality]
-internal static class Convert
-{
-    /// <summary>
-    /// 获取字符串的MD5计算结果
-    /// </summary>
-    /// <param name="source">源字符串</param>
-    /// <returns>计算的结果</returns>
-    public static string ToMd5HexString(string source)
-    {
-        byte[] hash = MD5.HashData(Encoding.UTF8.GetBytes(source));
-        return System.Convert.ToHexString(hash);
-    }
-}

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

@@ -1,26 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Snap.Hutao.Core.DependencyInjection.Abstraction;
-
-namespace Snap.Hutao.Core.DependencyInjection;
-
-/// <summary>
-/// 对象扩展
-/// </summary>
-[HighQuality]
-internal static class CastServiceExtension
-{
-    /// <summary>
-    /// <see langword="as"/> 的链式调用扩展
-    /// </summary>
-    /// <typeparam name="T">目标转换类型</typeparam>
-    /// <param name="service">对象</param>
-    /// <returns>转换类型后的对象</returns>
-    [Obsolete("Not useful anymore")]
-    public static T? As<T>(this ICastService service)
-        where T : class
-    {
-        return service as T;
-    }
-}

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

@@ -2,6 +2,7 @@
 // Licensed under the MIT license.
 
 using CommunityToolkit.Mvvm.Messaging;
+using Quartz;
 using Snap.Hutao.Core.Logging;
 using Snap.Hutao.Service;
 using System.Globalization;
@@ -33,6 +34,9 @@ internal static class DependencyInjection
             })
             .AddMemoryCache()
 
+            // Quartz
+            .AddQuartz()
+
             // Hutao extensions
             .AddJsonOptions()
             .AddDatabase()

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

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

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

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

src/Snap.Hutao/Snap.Hutao/Core/ExceptionService/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,12 +13,14 @@ internal sealed class HutaoException : Exception
     }
 
     [DoesNotReturn]
+    [MethodImpl(MethodImplOptions.NoInlining)]
     public static HutaoException Throw(string message, Exception? innerException = default)
     {
         throw new HutaoException(message, innerException);
     }
 
-    public static void ThrowIf(bool condition, string message, Exception? innerException = default)
+    [MethodImpl(MethodImplOptions.NoInlining)]
+    public static void ThrowIf([DoesNotReturnIf(true)] bool condition, string message, Exception? innerException = default)
     {
         if (condition)
         {
@@ -24,7 +28,8 @@ internal sealed class HutaoException : Exception
         }
     }
 
-    public static void ThrowIfNot(bool condition, string message, Exception? innerException = default)
+    [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,14 +67,23 @@ 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)
     {
-        return new OperationCanceledException(message, innerException);
+        throw new OperationCanceledException(message, innerException);
     }
 }

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

@@ -1,23 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-namespace Snap.Hutao.Core.ExceptionService;
-
-internal enum HutaoExceptionKind
-{
-    None,
-
-    // Foundation
-    ImageCacheInvalidUri,
-    DatabaseCorrupted,
-    UserdataCorrupted,
-
-    // IO
-    FileSystemCreateFileInsufficientPermissions,
-    PrivateNamedPipeContentHashIncorrect,
-
-    // Service
-    GachaStatisticsInvalidItemId,
-    GameFpsUnlockingFailed,
-    GameConfigInvalidChannelOptions,
-}

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

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

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

@@ -8,12 +8,17 @@ namespace Snap.Hutao.Core.IO.Hashing;
 
 internal static class Hash
 {
-    public static string SHA1HexString(string input)
+    public static unsafe string SHA1HexString(string input)
     {
-        return HashCore(BitConverter.ToString, SHA1.HashData, Encoding.UTF8.GetBytes, input);
+        return HashCore(Convert.ToHexString, SHA1.HashData, Encoding.UTF8.GetBytes, input);
     }
 
-    private static TResult HashCore<TInput, TResult>(Func<byte[], TResult> resultConverter, Func<byte[], byte[]> hashMethod, Func<TInput, byte[]> bytesConverter, TInput input)
+    public static unsafe string MD5HexString(string input)
+    {
+        return HashCore(Convert.ToHexString, System.Security.Cryptography.MD5.HashData, Encoding.UTF8.GetBytes, input);
+    }
+
+    private static unsafe TResult HashCore<TInput, TResult>(Func<byte[], TResult> resultConverter, Func<byte[], byte[]> hashMethod, Func<TInput, byte[]> bytesConverter, TInput input)
     {
         return resultConverter(hashMethod(bytesConverter(input)));
     }

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

@@ -34,6 +34,6 @@ internal static class MD5
     public static async ValueTask<string> HashAsync(Stream stream, CancellationToken token = default)
     {
         byte[] bytes = await System.Security.Cryptography.MD5.HashDataAsync(stream, token).ConfigureAwait(false);
-        return System.Convert.ToHexString(bytes);
+        return Convert.ToHexString(bytes);
     }
 }

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

@@ -18,6 +18,6 @@ internal static class SHA256
     public static async ValueTask<string> HashAsync(Stream stream, CancellationToken token = default)
     {
         byte[] bytes = await System.Security.Cryptography.SHA256.HashDataAsync(stream, token).ConfigureAwait(false);
-        return System.Convert.ToHexString(bytes);
+        return Convert.ToHexString(bytes);
     }
 }

src/Snap.Hutao/Snap.Hutao/Core/IO/Http/Loopback/LoopbackManager.cs

@@ -7,7 +7,7 @@ using Snap.Hutao.Win32.NetworkManagement.WindowsFirewall;
 using Snap.Hutao.Win32.Security;
 using System.Runtime.InteropServices;
 using static Snap.Hutao.Win32.AdvApi32;
-using static Snap.Hutao.Win32.ApiMsWinNetIsolation;
+using static Snap.Hutao.Win32.FirewallApi;
 using static Snap.Hutao.Win32.Macros;
 
 namespace Snap.Hutao.Core.IO.Http.Loopback;

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

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

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

@@ -0,0 +1,21 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Core;
+
+internal sealed class LazySlim<T>
+{
+    private readonly Func<T> valueFactory;
+
+    [MaybeNull]
+    private T value;
+    private bool initialized;
+    private object? syncRoot;
+
+    public LazySlim(Func<T> valueFactory)
+    {
+        this.valueFactory = valueFactory;
+    }
+
+    public T Value { get => LazyInitializer.EnsureInitialized(ref value, ref initialized, ref syncRoot, valueFactory); }
+}

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

@@ -3,11 +3,18 @@
 
 using CommunityToolkit.WinUI.Notifications;
 using Microsoft.Extensions.Caching.Memory;
+using Microsoft.UI.Xaml;
 using Snap.Hutao.Core.LifeCycle.InterProcess;
 using Snap.Hutao.Core.Setting;
+using Snap.Hutao.Core.Shell;
+using Snap.Hutao.Core.Windowing;
+using Snap.Hutao.Core.Windowing.HotKey;
+using Snap.Hutao.Core.Windowing.NotifyIcon;
+using Snap.Hutao.Service;
 using Snap.Hutao.Service.DailyNote;
 using Snap.Hutao.Service.Discord;
 using Snap.Hutao.Service.Hutao;
+using Snap.Hutao.Service.Job;
 using Snap.Hutao.Service.Metadata;
 using Snap.Hutao.Service.Navigation;
 using Snap.Hutao.ViewModel.Guide;
@@ -20,9 +27,9 @@ namespace Snap.Hutao.Core.LifeCycle;
 /// </summary>
 [HighQuality]
 [ConstructorGenerated]
-[Injection(InjectAs.Singleton, typeof(IActivation))]
+[Injection(InjectAs.Singleton, typeof(IAppActivation))]
 [SuppressMessage("", "CA1001")]
-internal sealed partial class Activation : IActivation
+internal sealed partial class AppActivation : IAppActivation, IAppActivationActionHandlersAccess, IDisposable
 {
     public const string Action = nameof(Action);
     public const string Uid = nameof(Uid);
@@ -35,13 +42,16 @@ internal sealed partial class Activation : IActivation
     private const string UrlActionRefresh = "/REFRESH";
 
     private readonly IServiceProvider serviceProvider;
-    private readonly ICurrentWindowReference currentWindowReference;
+    private readonly ICurrentXamlWindowReference currentWindowReference;
     private readonly ITaskContext taskContext;
+
     private readonly SemaphoreSlim activateSemaphore = new(1);
 
     /// <inheritdoc/>
     public void Activate(HutaoActivationArguments args)
     {
+        // Before activate, we try to redirect to the opened process in App,
+        // And we check if it's a toast activation.
         if (ToastNotificationManagerCompat.WasCurrentProcessToastActivated())
         {
             return;
@@ -51,10 +61,64 @@ internal sealed partial class Activation : IActivation
     }
 
     /// <inheritdoc/>
-    public void Initialize()
+    public void PostInitialization()
     {
         serviceProvider.GetRequiredService<PrivateNamedPipeServer>().RunAsync().SafeForget();
         ToastNotificationManagerCompat.OnActivated += NotificationActivate;
+
+        using (activateSemaphore.Enter())
+        {
+            serviceProvider.GetRequiredService<HotKeyOptions>().RegisterAll();
+            if (UnsafeLocalSetting.Get(SettingKeys.Major1Minor10Revision0GuideState, GuideState.Language) < GuideState.Completed)
+            {
+                return;
+            }
+
+            if (serviceProvider.GetRequiredService<AppOptions>().IsNotifyIconEnabled)
+            {
+                XamlWindowLifetime.ApplicationLaunchedWithNotifyIcon = true;
+                serviceProvider.GetRequiredService<App>().DispatcherShutdownMode = DispatcherShutdownMode.OnExplicitShutdown;
+                _ = serviceProvider.GetRequiredService<NotifyIconController>();
+            }
+
+            serviceProvider.GetRequiredService<IScheduleTaskInterop>().UnregisterAllTasks();
+            serviceProvider.GetRequiredService<IQuartzService>().StartAsync(default).SafeForget();
+        }
+    }
+
+    public void Dispose()
+    {
+        activateSemaphore.Dispose();
+    }
+
+    public async ValueTask HandleLaunchGameActionAsync(string? uid = null)
+    {
+        serviceProvider
+            .GetRequiredService<IMemoryCache>()
+            .Set(ViewModel.Game.LaunchGameViewModel.DesiredUid, uid);
+
+        await taskContext.SwitchToMainThreadAsync();
+
+        if (currentWindowReference.Window is null)
+        {
+            currentWindowReference.Window = serviceProvider.GetRequiredService<LaunchGameWindow>();
+            return;
+        }
+
+        if (currentWindowReference.Window is MainWindow)
+        {
+            await serviceProvider
+                .GetRequiredService<INavigationService>()
+                .NavigateAsync<View.Page.LaunchGamePage>(INavigationAwaiter.Default, true)
+                .ConfigureAwait(false);
+
+            return;
+        }
+        else
+        {
+            // We have a non-Main Window, just exit current process anyway
+            Process.GetCurrentProcess().Kill();
+        }
     }
 
     private void NotificationActivate(ToastNotificationActivatedEventArgsCompat args)
@@ -94,12 +158,6 @@ internal sealed partial class Activation : IActivation
             ArgumentNullException.ThrowIfNull(args.LaunchActivatedArguments);
             switch (args.LaunchActivatedArguments)
             {
-                case LaunchGame:
-                    {
-                        await HandleLaunchGameActionAsync().ConfigureAwait(false);
-                        break;
-                    }
-
                 default:
                     {
                         await HandleNormalLaunchActionAsync().ConfigureAwait(false);
@@ -112,10 +170,9 @@ internal sealed partial class Activation : IActivation
     private async ValueTask HandleNormalLaunchActionAsync()
     {
         // Increase launch times
-        LocalSetting.Update(SettingKeys.LaunchTimes, 0, x => x + 1);
+        LocalSetting.Update(SettingKeys.LaunchTimes, 0, x => unchecked(x + 1));
 
-        // If it's the first time launch, we show the guide window anyway.
-        // Otherwise, we check if there's any unfulfilled resource category present.
+        // If the guide is completed, we check if there's any unfulfilled resource category present.
         if (UnsafeLocalSetting.Get(SettingKeys.Major1Minor10Revision0GuideState, GuideState.Language) >= GuideState.StaticResourceBegin)
         {
             if (StaticResource.IsAnyUnfulfilledCategoryPresent())
@@ -127,7 +184,7 @@ internal sealed partial class Activation : IActivation
         if (UnsafeLocalSetting.Get(SettingKeys.Major1Minor10Revision0GuideState, GuideState.Language) < GuideState.Completed)
         {
             await taskContext.SwitchToMainThreadAsync();
-            serviceProvider.GetRequiredService<GuideWindow>();
+            currentWindowReference.Window = serviceProvider.GetRequiredService<GuideWindow>();
         }
         else
         {
@@ -144,7 +201,7 @@ internal sealed partial class Activation : IActivation
 
         await taskContext.SwitchToMainThreadAsync();
 
-        serviceProvider.GetRequiredService<MainWindow>();
+        currentWindowReference.Window = serviceProvider.GetRequiredService<MainWindow>();
 
         await taskContext.SwitchToBackgroundAsync();
 
@@ -158,10 +215,7 @@ internal sealed partial class Activation : IActivation
             hutaoUserServiceInitialization.InitializeInternalAsync().SafeForget();
         }
 
-        serviceProvider
-            .GetRequiredService<IDiscordService>()
-            .SetNormalActivityAsync()
-            .SafeForget();
+        serviceProvider.GetRequiredService<IDiscordService>().SetNormalActivityAsync().SafeForget();
     }
 
     private async ValueTask HandleUrlActivationAsync(Uri uri, bool isRedirectTo)
@@ -244,34 +298,4 @@ internal sealed partial class Activation : IActivation
                 }
         }
     }
-
-    private async ValueTask HandleLaunchGameActionAsync(string? uid = null)
-    {
-        serviceProvider
-            .GetRequiredService<IMemoryCache>()
-            .Set(ViewModel.Game.LaunchGameViewModel.DesiredUid, uid);
-
-        await taskContext.SwitchToMainThreadAsync();
-
-        if (currentWindowReference.Window is null)
-        {
-            serviceProvider.GetRequiredService<LaunchGameWindow>();
-            return;
-        }
-
-        if (currentWindowReference.Window is MainWindow)
-        {
-            await serviceProvider
-                .GetRequiredService<INavigationService>()
-                .NavigateAsync<View.Page.LaunchGamePage>(INavigationAwaiter.Default, true)
-                .ConfigureAwait(false);
-
-            return;
-        }
-        else
-        {
-            // We have a non-Main Window, just exit current process anyway
-            Process.GetCurrentProcess().Kill();
-        }
-    }
 }

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

@@ -1,24 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Microsoft.UI.Xaml;
-using Snap.Hutao.Core.Windowing;
-using Snap.Hutao.Win32.Foundation;
-using WinRT.Interop;
-
-namespace Snap.Hutao.Core.LifeCycle;
-
-internal static class CurrentWindowReferenceExtension
-{
-    public static XamlRoot GetXamlRoot(this ICurrentWindowReference reference)
-    {
-        return reference.Window.Content.XamlRoot;
-    }
-
-    public static HWND GetWindowHandle(this ICurrentWindowReference reference)
-    {
-        return reference.Window is IWindowOptionsSource optionsSource
-            ? optionsSource.WindowOptions.Hwnd
-            : WindowNative.GetWindowHandle(reference.Window);
-    }
-}

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

@@ -5,19 +5,19 @@ using Microsoft.UI.Xaml;
 
 namespace Snap.Hutao.Core.LifeCycle;
 
-[Injection(InjectAs.Singleton, typeof(ICurrentWindowReference))]
-internal sealed class CurrentWindowReference : ICurrentWindowReference
+[Injection(InjectAs.Singleton, typeof(ICurrentXamlWindowReference))]
+internal sealed class CurrentXamlWindowReference : ICurrentXamlWindowReference
 {
     private readonly WeakReference<Window> reference = new(default!);
 
     [SuppressMessage("", "SH007")]
-    public Window Window
+    public Window? Window
     {
         get
         {
             reference.TryGetTarget(out Window? window);
             return window!;
         }
-        set => reference.SetTarget(value);
+        set => reference.SetTarget(value!);
     }
 }

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

@@ -0,0 +1,22 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.UI.Xaml;
+using Snap.Hutao.Core.Windowing;
+using Snap.Hutao.Win32.Foundation;
+
+namespace Snap.Hutao.Core.LifeCycle;
+
+internal static class CurrentXamlWindowReferenceExtension
+{
+    public static XamlRoot GetXamlRoot(this ICurrentXamlWindowReference reference)
+    {
+        ArgumentNullException.ThrowIfNull(reference.Window);
+        return reference.Window.Content.XamlRoot;
+    }
+
+    public static HWND GetWindowHandle(this ICurrentXamlWindowReference reference)
+    {
+        return WindowExtension.GetWindowHandle(reference.Window);
+    }
+}

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

@@ -1,14 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-namespace Snap.Hutao.Core.LifeCycle;
-
-/// <summary>
-/// 激活
-/// </summary>
-internal interface IActivation
-{
-    void Activate(HutaoActivationArguments args);
-
-    void Initialize();
-}

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

@@ -0,0 +1,16 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Core.LifeCycle;
+
+internal interface IAppActivation
+{
+    void Activate(HutaoActivationArguments args);
+
+    void PostInitialization();
+}
+
+internal interface IAppActivationActionHandlersAccess
+{
+    ValueTask HandleLaunchGameActionAsync(string? uid = null);
+}

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

@@ -5,10 +5,10 @@ using Microsoft.UI.Xaml;
 
 namespace Snap.Hutao.Core.LifeCycle;
 
-internal interface ICurrentWindowReference
+internal interface ICurrentXamlWindowReference
 {
     /// <summary>
     /// Only set in WindowController
     /// </summary>
-    public Window Window { get; set; }
+    public Window? Window { get; set; }
 }

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

@@ -16,6 +16,6 @@ internal sealed partial class PrivateNamedPipeMessageDispatcher
             return;
         }
 
-        serviceProvider.GetRequiredService<IActivation>().Activate(args);
+        serviceProvider.GetRequiredService<IAppActivation>().Activate(args);
     }
 }

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

@@ -10,11 +10,18 @@ namespace Snap.Hutao.Core.Logging;
 
 internal sealed class ConsoleWindowLifeTime : IDisposable
 {
+    public const bool DebugModeEnabled =
+#if IS_ALPHA_BUILD
+        true;
+#else
+        false;
+#endif
+
     private readonly bool consoleWindowAllocated;
 
     public ConsoleWindowLifeTime()
     {
-        if (LocalSetting.Get(SettingKeys.IsAllocConsoleDebugModeEnabled, false))
+        if (LocalSetting.Get(SettingKeys.IsAllocConsoleDebugModeEnabled, DebugModeEnabled))
         {
             consoleWindowAllocated = AllocConsole();
             if (consoleWindowAllocated)

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

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

src/Snap.Hutao/Snap.Hutao/Core/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);
     }
 
@@ -151,7 +152,7 @@ internal static class LoggerExtension
                     }
                     else
                     {
-                        resultMessageBuilder.Append(ConsoleVirtualTerminalSequences.Default);
+                        resultMessageBuilder.Append(ConsoleVirtualTerminalSequences.ForegroundWhite);
                     }
                 }
             }
@@ -164,7 +165,7 @@ internal static class LoggerExtension
         // Restore default colors
         if (message.ForegroundColor.HasValue || message.BackgroundColor.HasValue)
         {
-            resultMessageBuilder.Append(ConsoleVirtualTerminalSequences.Default);
+            resultMessageBuilder.Append(ConsoleVirtualTerminalSequences.ForegroundWhite);
         }
 
         return resultMessageBuilder.ToString();

src/Snap.Hutao/Snap.Hutao/Core/ReadOnlySpan2D.cs

@@ -0,0 +1,27 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using System.Runtime.CompilerServices;
+using System.Runtime.InteropServices;
+
+namespace Snap.Hutao.Core;
+
+internal readonly ref struct ReadOnlySpan2D<T>
+    where T : unmanaged
+{
+    private readonly ref T reference;
+    private readonly int length;
+    private readonly int columns;
+
+    public unsafe ReadOnlySpan2D(void* pointer, int length, int columns)
+    {
+        reference = ref *(T*)pointer;
+        this.length = length;
+        this.columns = columns;
+    }
+
+    public ReadOnlySpan<T> this[int row]
+    {
+        get => MemoryMarshal.CreateReadOnlySpan(ref Unsafe.Add(ref reference, row * columns), columns);
+    }
+}

src/Snap.Hutao/Snap.Hutao/Core/RuntimeOptions.cs

@@ -3,6 +3,7 @@
 
 using Microsoft.Web.WebView2.Core;
 using Microsoft.Win32;
+using Snap.Hutao.Core.IO.Hashing;
 using Snap.Hutao.Core.Setting;
 using System.IO;
 using System.Security.Principal;
@@ -15,15 +16,13 @@ namespace Snap.Hutao.Core;
 [Injection(InjectAs.Singleton)]
 internal sealed class RuntimeOptions
 {
-    private readonly IServiceProvider serviceProvider;
-
-    private readonly Lazy<(Version Version, string UserAgent)> lazyVersionAndUserAgent = new(() =>
+    private readonly LazySlim<(Version Version, string UserAgent)> lazyVersionAndUserAgent = new(() =>
     {
         Version version = Package.Current.Id.Version.ToVersion();
         return (version, $"Snap Hutao/{version}");
     });
 
-    private readonly Lazy<string> lazyDataFolder = new(() =>
+    private readonly LazySlim<string> lazyDataFolder = new(() =>
     {
         string preferredPath = LocalSetting.Get(SettingKeys.DataFolderPath, string.Empty);
 
@@ -48,14 +47,14 @@ internal sealed class RuntimeOptions
         return path;
     });
 
-    private readonly Lazy<string> lazyDeviceId = new(() =>
+    private readonly LazySlim<string> lazyDeviceId = new(() =>
     {
         string userName = Environment.UserName;
         object? machineGuid = Registry.GetValue(@"HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography\", "MachineGuid", userName);
-        return Convert.ToMd5HexString($"{userName}{machineGuid}");
+        return Hash.MD5HexString($"{userName}{machineGuid}");
     });
 
-    private readonly Lazy<(string Version, bool Supported)> lazyWebViewEnvironment = new(() =>
+    private readonly LazySlim<(string Version, bool Supported)> lazyWebViewEnvironment = new(() =>
     {
         try
         {
@@ -68,7 +67,7 @@ internal sealed class RuntimeOptions
         }
     });
 
-    private readonly Lazy<bool> lazyElevated = new(() =>
+    private readonly LazySlim<bool> lazyElevated = new(() =>
     {
         if (LocalSetting.Get(SettingKeys.OverrideElevationRequirement, false))
         {
@@ -82,18 +81,18 @@ internal sealed class RuntimeOptions
         }
     });
 
-    private readonly Lazy<string> lazyLocalCache = new(() => ApplicationData.Current.LocalCacheFolder.Path);
-    private readonly Lazy<string> lazyInstalledLocation = new(() => Package.Current.InstalledLocation.Path);
-    private readonly Lazy<string> lazyFamilyName = new(() => Package.Current.Id.FamilyName);
+    private readonly LazySlim<string> lazyLocalCache = new(() => ApplicationData.Current.LocalCacheFolder.Path);
+    private readonly LazySlim<string> lazyInstalledLocation = new(() => Package.Current.InstalledLocation.Path);
+    private readonly LazySlim<string> lazyFamilyName = new(() => Package.Current.Id.FamilyName);
 
-    private bool isToastAvailable;
-    private bool isToastAvailableInitialized;
-    private object isToastAvailableLock = new();
-
-    public RuntimeOptions(IServiceProvider serviceProvider, ILogger<RuntimeOptions> logger)
+    private readonly LazySlim<bool> lazyToastAvailable = new(() =>
     {
-        this.serviceProvider = serviceProvider;
+        ITaskContext taskContext = Ioc.Default.GetRequiredService<ITaskContext>();
+        return taskContext.InvokeOnMainThread(() => ToastNotificationManager.CreateToastNotifier().Setting is NotificationSetting.Enabled);
+    });
 
+    public RuntimeOptions()
+    {
         AppLaunchTime = DateTimeOffset.UtcNow;
     }
 
@@ -117,19 +116,7 @@ internal sealed class RuntimeOptions
 
     public bool IsElevated { get => lazyElevated.Value; }
 
-    public bool IsToastAvailable
-    {
-        get
-        {
-            return LazyInitializer.EnsureInitialized(ref isToastAvailable, ref isToastAvailableInitialized, ref isToastAvailableLock, GetIsToastAvailable);
-
-            bool GetIsToastAvailable()
-            {
-                ITaskContext taskContext = serviceProvider.GetRequiredService<ITaskContext>();
-                return taskContext.InvokeOnMainThread(() => ToastNotificationManager.CreateToastNotifier().Setting is NotificationSetting.Enabled);
-            }
-        }
-    }
+    public bool IsToastAvailable { get => lazyToastAvailable.Value; }
 
     public DateTimeOffset AppLaunchTime { get; }
 }

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

@@ -12,8 +12,13 @@ internal static class SettingKeys
 {
     #region MainWindow
     public const string WindowRect = "WindowRect";
+    public const string GuideWindowRect = "GuideWindowRect";
     public const string IsNavPaneOpen = "IsNavPaneOpen";
     public const string IsInfoBarToggleChecked = "IsInfoBarToggleChecked";
+
+    #endregion
+
+    #region Infrastructure
     public const string ExcludedAnnouncementIds = "ExcludedAnnouncementIds";
     #endregion
 

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

@@ -1,16 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-namespace Snap.Hutao.Core.Shell;
-
-/// <summary>
-/// 跳转列表交互
-/// </summary>
-internal interface IJumpListInterop
-{
-    /// <summary>
-    /// 异步配置跳转列表
-    /// </summary>
-    /// <returns>任务</returns>
-    ValueTask ConfigureAsync();
-}

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

@@ -8,20 +8,9 @@ namespace Snap.Hutao.Core.Shell;
 /// </summary>
 internal interface IScheduleTaskInterop
 {
-    bool IsDailyNoteRefreshEnabled();
-
-    /// <summary>
-    /// 注册实时便笺刷新任务
-    /// </summary>
-    /// <param name="interval">间隔（秒）</param>
-    /// <returns>是否注册或修改成功</returns>
-    bool RegisterForDailyNoteRefresh(int interval);
-
     /// <summary>
     /// 卸载全部注册的任务
     /// </summary>
     /// <returns>是否卸载成功</returns>
     bool UnregisterAllTasks();
-
-    bool UnregisterForDailyNoteRefresh();
 }

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

@@ -1,36 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Snap.Hutao.Core.LifeCycle;
-using Windows.UI.StartScreen;
-
-namespace Snap.Hutao.Core.Shell;
-
-/// <summary>
-/// 跳转列表交互
-/// </summary>
-[HighQuality]
-[Injection(InjectAs.Transient, typeof(IJumpListInterop))]
-internal sealed class JumpListInterop : IJumpListInterop
-{
-    /// <summary>
-    /// 异步配置跳转列表
-    /// </summary>
-    /// <returns>任务</returns>
-    public async ValueTask ConfigureAsync()
-    {
-        if (JumpList.IsSupported())
-        {
-            JumpList list = await JumpList.LoadCurrentAsync();
-
-            list.Items.Clear();
-
-            JumpListItem launchGameItem = JumpListItem.CreateWithArguments(Activation.LaunchGame, SH.CoreJumpListHelperLaunchGameItemDisplayName);
-            launchGameItem.Logo = "ms-appx:///Resource/Navigation/LaunchGame.png".ToUri();
-
-            list.Items.Add(launchGameItem);
-
-            await list.SaveAsync();
-        }
-    }
-}

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;
 
@@ -16,60 +14,6 @@ namespace Snap.Hutao.Core.Shell;
 internal sealed class ScheduleTaskInterop : IScheduleTaskInterop
 {
     private const string DailyNoteRefreshTaskName = "SnapHutaoDailyNoteRefreshTask";
-    private const string DailyNoteRefreshScriptName = "DailyNoteRefresh";
-
-    /// <summary>
-    /// 注册实时便笺刷新任务
-    /// </summary>
-    /// <param name="interval">间隔（秒）</param>
-    /// <returns>是否注册或修改成功</returns>
-    public bool RegisterForDailyNoteRefresh(int interval)
-    {
-        try
-        {
-            TaskDefinition task = TaskService.Instance.NewTask();
-            task.RegistrationInfo.Description = SH.CoreScheduleTaskHelperDailyNoteRefreshTaskDescription;
-            task.Triggers.Add(new TimeTrigger() { Repetition = new(TimeSpan.FromSeconds(interval), TimeSpan.Zero), });
-
-            string scriptPath = EnsureWScriptCreated(DailyNoteRefreshScriptName, "hutao://DailyNote/Refresh");
-            task.Actions.Add("wscript", $@"/b ""{scriptPath}""");
-
-            TaskService.Instance.RootFolder.RegisterTaskDefinition(DailyNoteRefreshTaskName, task);
-            return true;
-        }
-        catch (Exception)
-        {
-            if (WScriptExists(DailyNoteRefreshScriptName, out string fullPath))
-            {
-                File.Delete(fullPath);
-            }
-
-            return false;
-        }
-    }
-
-    public bool UnregisterForDailyNoteRefresh()
-    {
-        try
-        {
-            TaskService.Instance.RootFolder.DeleteTask(DailyNoteRefreshTaskName, false);
-            if (WScriptExists(DailyNoteRefreshScriptName, out string fullPath))
-            {
-                File.Delete(fullPath);
-            }
-
-            return true;
-        }
-        catch (Exception)
-        {
-            return false;
-        }
-    }
-
-    public bool IsDailyNoteRefreshEnabled()
-    {
-        return TaskService.Instance.RootFolder.Tasks.Any(task => task.Name is DailyNoteRefreshTaskName);
-    }
 
     /// <summary>
     /// 卸载全部注册的任务
@@ -91,25 +35,4 @@ internal sealed class ScheduleTaskInterop : IScheduleTaskInterop
             return false;
         }
     }
-
-    private static string EnsureWScriptCreated(string name, string url, bool forceCreate = false)
-    {
-        if (WScriptExists(name, out string fullName) && !forceCreate)
-        {
-            return fullName;
-        }
-
-        string script = $"""CreateObject("WScript.Shell").Run "cmd /c start {url}", 0, False""";
-        File.WriteAllText(fullName, script);
-
-        return fullName;
-    }
-
-    private static bool WScriptExists(string name, out string fullName)
-    {
-        string tempFolder = ApplicationData.Current.TemporaryFolder.Path;
-        fullName = Path.Combine(tempFolder, "Script", $"{name}.vbs");
-        Directory.CreateDirectory(Path.Combine(tempFolder, "Script"));
-        return File.Exists(fullName);
-    }
 }

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

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

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/Threading/SpinWaitPolyfill.cs

@@ -1,9 +1,9 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
-namespace Snap.Hutao.Core.Threading;
+using System.Diagnostics;
 
-internal delegate bool SpinWaitPredicate<T>(ref readonly T state);
+namespace Snap.Hutao.Core.Threading;
 
 internal static class SpinWaitPolyfill
 {
@@ -15,4 +15,23 @@ internal static class SpinWaitPolyfill
             spinner.SpinOnce();
         }
     }
+
+    [SuppressMessage("", "SH002")]
+    public static unsafe bool SpinUntil<T>(ref T state, delegate*<ref readonly T, bool> condition, TimeSpan timeout)
+    {
+        long startTime = Stopwatch.GetTimestamp();
+
+        SpinWait spinner = default;
+        while (!condition(ref state))
+        {
+            spinner.SpinOnce();
+
+            if (timeout < Stopwatch.GetElapsedTime(startTime))
+            {
+                return false;
+            }
+        }
+
+        return true;
+    }
 }

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/Abstraction/IXamlWindowContentAsFrameworkElement.cs

@@ -0,0 +1,11 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.UI.Xaml;
+
+namespace Snap.Hutao.Core.Windowing.Abstraction;
+
+internal interface IXamlWindowContentAsFrameworkElement
+{
+    FrameworkElement ContentAccess { get; }
+}

src/Snap.Hutao/Snap.Hutao/Core/Windowing/Abstraction/IXamlWindowExtendContentIntoTitleBar.cs

@@ -0,0 +1,11 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.UI.Xaml;
+
+namespace Snap.Hutao.Core.Windowing.Abstraction;
+
+internal interface IXamlWindowExtendContentIntoTitleBar
+{
+    FrameworkElement TitleBarAccess { get; }
+}

src/Snap.Hutao/Snap.Hutao/Core/Windowing/Abstraction/IXamlWindowHasInitSize.cs

@@ -0,0 +1,11 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Windows.Graphics;
+
+namespace Snap.Hutao.Core.Windowing.Abstraction;
+
+internal interface IXamlWindowHasInitSize
+{
+    SizeInt32 InitSize { get; }
+}

src/Snap.Hutao/Snap.Hutao/Core/Windowing/Abstraction/IXamlWindowOptionsSource.cs

@@ -1,15 +1,15 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
-namespace Snap.Hutao.Core.Windowing;
+namespace Snap.Hutao.Core.Windowing.Abstraction;
 
 /// <summary>
 /// 为扩展窗体提供必要的选项
 /// </summary>
-internal interface IWindowOptionsSource
+internal interface IXamlWindowOptionsSource
 {
     /// <summary>
     /// 窗体选项
     /// </summary>
-    WindowOptions WindowOptions { get; }
+    XamlWindowOptions WindowOptions { get; }
 }

src/Snap.Hutao/Snap.Hutao/Core/Windowing/Abstraction/IXamlWindowRectPersisted.cs

@@ -0,0 +1,9 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Core.Windowing.Abstraction;
+
+internal interface IXamlWindowRectPersisted : IXamlWindowHasInitSize
+{
+    string PersistRectKey { get; }
+}

src/Snap.Hutao/Snap.Hutao/Core/Windowing/Abstraction/IXamlWindowSubclassMinMaxInfoHandler.cs

@@ -0,0 +1,11 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.Win32.UI.WindowsAndMessaging;
+
+namespace Snap.Hutao.Core.Windowing.Abstraction;
+
+internal interface IXamlWindowSubclassMinMaxInfoHandler
+{
+    unsafe void HandleMinMaxInfo(ref MINMAXINFO info, double scalingFactor);
+}

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

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

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

@@ -0,0 +1,40 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.UI.Composition;
+using Microsoft.UI.Composition.SystemBackdrops;
+using Microsoft.UI.Xaml;
+using Microsoft.UI.Xaml.Media;
+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 partial class InputActiveDesktopAcrylicBackdrop : SystemBackdrop
+{
+    private readonly ConcurrentDictionary<ICompositionSupportsSystemBackdrop, DesktopAcrylicController> controllers = [];
+
+    protected override void OnTargetConnected(ICompositionSupportsSystemBackdrop target, XamlRoot xamlRoot)
+    {
+        base.OnTargetConnected(target, xamlRoot);
+
+        SystemBackdropConfiguration configuration = GetDefaultSystemBackdropConfiguration(target, xamlRoot);
+        configuration.IsInputActive = true;
+
+        DesktopAcrylicController newController = new();
+        newController.AddSystemBackdropTarget(target);
+        newController.SetSystemBackdropConfiguration(configuration);
+        controllers.TryAdd(target, newController);
+    }
+
+    protected override void OnTargetDisconnected(ICompositionSupportsSystemBackdrop target)
+    {
+        base.OnTargetDisconnected(target);
+
+        if (controllers.TryRemove(target, out DesktopAcrylicController? controller))
+        {
+            controller.RemoveSystemBackdropTarget(target);
+            controller.Dispose();
+        }
+    }
+}

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

@@ -0,0 +1,52 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.UI.Composition;
+using Microsoft.UI.Xaml;
+using Microsoft.UI.Xaml.Hosting;
+using Microsoft.UI.Xaml.Media;
+using System.Runtime.CompilerServices;
+using WinRT;
+
+namespace Snap.Hutao.Core.Windowing.Backdrop;
+
+internal sealed class SystemBackdropDesktopWindowXamlSourceAccess : SystemBackdrop
+{
+    private readonly SystemBackdrop? innerBackdrop;
+
+    public SystemBackdropDesktopWindowXamlSourceAccess(SystemBackdrop? systemBackdrop)
+    {
+        innerBackdrop = systemBackdrop;
+    }
+
+    public DesktopWindowXamlSource? DesktopWindowXamlSource
+    {
+        get; private set;
+    }
+
+    public SystemBackdrop? InnerBackdrop { get => innerBackdrop; }
+
+    protected override void OnTargetConnected(ICompositionSupportsSystemBackdrop target, XamlRoot xamlRoot)
+    {
+        DesktopWindowXamlSource = DesktopWindowXamlSource.FromAbi(target.As<IInspectable>().ThisPtr);
+        if (innerBackdrop is not null)
+        {
+            ProtectedOnTargetConnected(innerBackdrop, target, xamlRoot);
+        }
+    }
+
+    protected override void OnTargetDisconnected(ICompositionSupportsSystemBackdrop target)
+    {
+        DesktopWindowXamlSource = null;
+        if (innerBackdrop is not null)
+        {
+            ProtectedOnTargetDisconnected(innerBackdrop, target);
+        }
+    }
+
+    [UnsafeAccessor(UnsafeAccessorKind.Method, Name = nameof(OnTargetConnected))]
+    private static extern void ProtectedOnTargetConnected(SystemBackdrop systemBackdrop, ICompositionSupportsSystemBackdrop target, XamlRoot xamlRoot);
+
+    [UnsafeAccessor(UnsafeAccessorKind.Method, Name = nameof(OnTargetDisconnected))]
+    private static extern void ProtectedOnTargetDisconnected(SystemBackdrop systemBackdrop, ICompositionSupportsSystemBackdrop target);
+}

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

@@ -9,9 +9,9 @@ using Windows.UI;
 
 namespace Snap.Hutao.Core.Windowing.Backdrop;
 
-internal sealed class TransparentBackdrop : SystemBackdrop, IDisposable, IBackdropNeedEraseBackground
+internal sealed class TransparentBackdrop : SystemBackdrop, IBackdropNeedEraseBackground
 {
-    private readonly object compositorLock = new();
+    private object? compositorLock;
 
     private Color tintColor;
     private Windows.UI.Composition.CompositionColorBrush? brush;
@@ -29,37 +29,33 @@ internal sealed class TransparentBackdrop : SystemBackdrop, IDisposable, IBackdr
 
     internal Windows.UI.Composition.Compositor Compositor
     {
-        get
+        get => LazyInitializer.EnsureInitialized(ref compositor, ref compositorLock, () =>
         {
-            if (compositor is null)
-            {
-                lock (compositorLock)
-                {
-                    if (compositor is null)
-                    {
-                        DispatcherQueue.EnsureSystemDispatcherQueue();
-                        compositor = new Windows.UI.Composition.Compositor();
-                    }
-                }
-            }
+            DispatcherQueue.EnsureSystemDispatcherQueue();
+            return new Windows.UI.Composition.Compositor();
+        });
+    }
 
-            return compositor;
+    protected override void OnTargetConnected(ICompositionSupportsSystemBackdrop target, XamlRoot xamlRoot)
+    {
+        base.OnTargetConnected(target, xamlRoot);
+
+        brush ??= Compositor.CreateColorBrush(tintColor);
+        target.SystemBackdrop = brush;
+    }
+
+    protected override void OnTargetDisconnected(ICompositionSupportsSystemBackdrop target)
+    {
+        base.OnTargetDisconnected(target);
+
+        target.SystemBackdrop = null;
+
+        if (compositorLock is not null)
+        {
+            lock (compositorLock)
+            {
+                compositor?.Dispose();
+            }
         }
     }
-
-    public void Dispose()
-    {
-        compositor?.Dispose();
-    }
-
-    protected override void OnTargetConnected(ICompositionSupportsSystemBackdrop connectedTarget, XamlRoot xamlRoot)
-    {
-        brush ??= Compositor.CreateColorBrush(tintColor);
-        connectedTarget.SystemBackdrop = brush;
-    }
-
-    protected override void OnTargetDisconnected(ICompositionSupportsSystemBackdrop disconnectedTarget)
-    {
-        disconnectedTarget.SystemBackdrop = 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;
@@ -17,17 +16,16 @@ namespace Snap.Hutao.Core.Windowing.HotKey;
 [SuppressMessage("", "SA1124")]
 internal sealed class HotKeyCombination : ObservableObject
 {
-    private readonly ICurrentWindowReference currentWindowReference;
     private readonly IInfoBarService infoBarService;
     private readonly RuntimeOptions runtimeOptions;
 
+    private readonly HWND hwnd;
     private readonly string settingKey;
     private readonly int hotKeyId;
     private readonly HotKeyParameter defaultHotKeyParameter;
 
     private bool registered;
 
-    private bool modifierHasWindows;
     private bool modifierHasControl;
     private bool modifierHasShift;
     private bool modifierHasAlt;
@@ -36,12 +34,13 @@ internal sealed class HotKeyCombination : ObservableObject
     private VirtualKey key;
     private bool isEnabled;
 
-    public HotKeyCombination(IServiceProvider serviceProvider, string settingKey, int hotKeyId, HOT_KEY_MODIFIERS defaultModifiers, VirtualKey defaultKey)
+    [SuppressMessage("", "SH002")]
+    public HotKeyCombination(IServiceProvider serviceProvider, HWND hwnd, string settingKey, int hotKeyId, HOT_KEY_MODIFIERS defaultModifiers, VirtualKey defaultKey)
     {
-        currentWindowReference = serviceProvider.GetRequiredService<ICurrentWindowReference>();
         infoBarService = serviceProvider.GetRequiredService<IInfoBarService>();
         runtimeOptions = serviceProvider.GetRequiredService<RuntimeOptions>();
 
+        this.hwnd = hwnd;
         this.settingKey = settingKey;
         this.hotKeyId = hotKeyId;
         defaultHotKeyParameter = new(defaultModifiers, defaultKey);
@@ -52,8 +51,11 @@ internal sealed class HotKeyCombination : ObservableObject
             isEnabled = LocalSetting.Get($"{settingKey}.IsEnabled", true);
 
             HotKeyParameter actual = LocalSettingGetHotKeyParameter();
-            modifiers = actual.Modifiers;
-            InitializeModifiersComposeFields();
+
+            // 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;
 
             keyNameValue = VirtualKeys.GetList().Single(v => v.Value == 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;
@@ -164,8 +154,8 @@ internal sealed class HotKeyCombination : ObservableObject
 
                 _ = (value, registered) switch
                 {
-                    (true, false) => RegisterForCurrentWindow(),
-                    (false, true) => UnregisterForCurrentWindow(),
+                    (true, false) => Register(),
+                    (false, true) => Unregister(),
                     _ => false,
                 };
             }
@@ -174,7 +164,7 @@ internal sealed class HotKeyCombination : ObservableObject
 
     public string DisplayName { get => ToString(); }
 
-    public bool RegisterForCurrentWindow()
+    public bool Register()
     {
         if (!runtimeOptions.IsElevated || !IsEnabled)
         {
@@ -186,7 +176,6 @@ internal sealed class HotKeyCombination : ObservableObject
             return true;
         }
 
-        HWND hwnd = currentWindowReference.GetWindowHandle();
         BOOL result = RegisterHotKey(hwnd, hotKeyId, Modifiers, (uint)Key);
         registered = result;
 
@@ -198,7 +187,7 @@ internal sealed class HotKeyCombination : ObservableObject
         return result;
     }
 
-    public bool UnregisterForCurrentWindow()
+    public bool Unregister()
     {
         if (!runtimeOptions.IsElevated)
         {
@@ -210,7 +199,6 @@ internal sealed class HotKeyCombination : ObservableObject
             return true;
         }
 
-        HWND hwnd = currentWindowReference.GetWindowHandle();
         BOOL result = UnregisterHotKey(hwnd, hotKeyId);
         registered = !result;
         return result;
@@ -220,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(" + ");
@@ -249,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,13 +250,8 @@ internal sealed class HotKeyCombination : ObservableObject
         Modifiers = modifiers;
     }
 
-    private void InitializeModifiersComposeFields()
+    private void InitializeModifiersCompositionFields()
     {
-        if (Modifiers.HasFlag(HOT_KEY_MODIFIERS.MOD_WIN))
-        {
-            modifierHasWindows = true;
-        }
-
         if (Modifiers.HasFlag(HOT_KEY_MODIFIERS.MOD_CONTROL))
         {
             modifierHasControl = true;
@@ -309,7 +282,7 @@ internal sealed class HotKeyCombination : ObservableObject
         HotKeyParameter current = new(Modifiers, Key);
         LocalSetting.Set(settingKey, *(int*)&current);
 
-        UnregisterForCurrentWindow();
-        RegisterForCurrentWindow();
+        Unregister();
+        Register();
     }
 }

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

@@ -1,97 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Snap.Hutao.Win32.UI.Input.KeyboardAndMouse;
-using System.Runtime.InteropServices;
-using static Snap.Hutao.Win32.User32;
-
-namespace Snap.Hutao.Core.Windowing.HotKey;
-
-[SuppressMessage("", "CA1001")]
-[Injection(InjectAs.Singleton, typeof(IHotKeyController))]
-[ConstructorGenerated]
-internal sealed partial class HotKeyController : IHotKeyController
-{
-    private static readonly WaitCallback RunMouseClickRepeatForever = MouseClickRepeatForever;
-
-    private readonly object syncRoot = new();
-
-    private readonly HotKeyOptions hotKeyOptions;
-
-    private volatile CancellationTokenSource? cancellationTokenSource;
-
-    public void RegisterAll()
-    {
-        hotKeyOptions.MouseClickRepeatForeverKeyCombination.RegisterForCurrentWindow();
-    }
-
-    public void UnregisterAll()
-    {
-        hotKeyOptions.MouseClickRepeatForeverKeyCombination.UnregisterForCurrentWindow();
-    }
-
-    public void OnHotKeyPressed(in HotKeyParameter parameter)
-    {
-        if (parameter.Equals(hotKeyOptions.MouseClickRepeatForeverKeyCombination))
-        {
-            ToggleMouseClickRepeatForever();
-        }
-    }
-
-    private static unsafe INPUT CreateInputForMouseEvent(MOUSE_EVENT_FLAGS flags)
-    {
-        INPUT input = default;
-        input.type = INPUT_TYPE.INPUT_MOUSE;
-        input.Anonymous.mi.dwFlags = flags;
-        return input;
-    }
-
-    [SuppressMessage("", "SH007")]
-    private static unsafe void MouseClickRepeatForever(object? state)
-    {
-        CancellationToken token = (CancellationToken)state!;
-
-        // We want to use this thread for a long time
-        while (!token.IsCancellationRequested)
-        {
-            INPUT[] inputs =
-            [
-                CreateInputForMouseEvent(MOUSE_EVENT_FLAGS.MOUSEEVENTF_LEFTDOWN),
-                CreateInputForMouseEvent(MOUSE_EVENT_FLAGS.MOUSEEVENTF_LEFTUP),
-            ];
-
-            if (SendInput(inputs.AsSpan(), sizeof(INPUT)) is 0)
-            {
-                Marshal.ThrowExceptionForHR(Marshal.GetLastPInvokeError());
-            }
-
-            if (token.IsCancellationRequested)
-            {
-                return;
-            }
-
-            Thread.Sleep(System.Random.Shared.Next(100, 150));
-        }
-    }
-
-    private void ToggleMouseClickRepeatForever()
-    {
-        lock (syncRoot)
-        {
-            if (hotKeyOptions.IsMouseClickRepeatForeverOn)
-            {
-                // Turn off
-                cancellationTokenSource?.Cancel();
-                cancellationTokenSource = default;
-                hotKeyOptions.IsMouseClickRepeatForeverOn = false;
-            }
-            else
-            {
-                // Turn on
-                cancellationTokenSource = new();
-                ThreadPool.QueueUserWorkItem(RunMouseClickRepeatForever, cancellationTokenSource.Token);
-                hotKeyOptions.IsMouseClickRepeatForeverOn = true;
-            }
-        }
-    }
-}

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

@@ -0,0 +1,92 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.Win32.Foundation;
+using Snap.Hutao.Win32.UI.WindowsAndMessaging;
+using System.Collections.Concurrent;
+using System.Runtime.CompilerServices;
+using System.Runtime.InteropServices;
+using static Snap.Hutao.Win32.ConstValues;
+using static Snap.Hutao.Win32.User32;
+
+namespace Snap.Hutao.Core.Windowing.HotKey;
+
+internal sealed class HotKeyMessageWindow : IDisposable
+{
+    private const string WindowClassName = "SnapHutaoHotKeyMessageWindowClass";
+
+    private static readonly ConcurrentDictionary<HWND, HotKeyMessageWindow> WindowTable = [];
+
+    private bool isDisposed;
+
+    public unsafe HotKeyMessageWindow()
+    {
+        ushort atom;
+        fixed (char* className = WindowClassName)
+        {
+            WNDCLASSW wc = new()
+            {
+                lpfnWndProc = WNDPROC.Create(&OnWindowProcedure),
+                lpszClassName = className,
+            };
+
+            atom = RegisterClassW(&wc);
+        }
+
+        ArgumentOutOfRangeException.ThrowIfZero(atom);
+
+        HWND = CreateWindowExW(0, WindowClassName, WindowClassName, 0, 0, 0, 0, 0, default, default, default, default);
+
+        if (HWND == default)
+        {
+            Marshal.ThrowExceptionForHR(Marshal.GetLastPInvokeError());
+        }
+
+        WindowTable.TryAdd(HWND, this);
+    }
+
+    ~HotKeyMessageWindow()
+    {
+        Dispose();
+    }
+
+    public Action<HotKeyParameter>? HotKeyPressed { get; set; }
+
+    public HWND HWND { get; }
+
+    public void Dispose()
+    {
+        if (isDisposed)
+        {
+            return;
+        }
+
+        isDisposed = true;
+
+        DestroyWindow(HWND);
+        WindowTable.TryRemove(HWND, out _);
+
+        GC.SuppressFinalize(this);
+    }
+
+    [SuppressMessage("", "SH002")]
+    [UnmanagedCallersOnly(CallConvs = [typeof(CallConvStdcall)])]
+    private static unsafe LRESULT OnWindowProcedure(HWND hwnd, uint uMsg, WPARAM wParam, LPARAM lParam)
+    {
+        if (!WindowTable.TryGetValue(hwnd, out HotKeyMessageWindow? window))
+        {
+            return DefWindowProcW(hwnd, uMsg, wParam, lParam);
+        }
+
+        switch (uMsg)
+        {
+            case WM_HOTKEY:
+                window.HotKeyPressed?.Invoke(*(HotKeyParameter*)&lParam);
+                break;
+            default:
+                break;
+        }
+
+        return DefWindowProcW(hwnd, uMsg, wParam, lParam);
+    }
+}

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

@@ -4,19 +4,35 @@
 using CommunityToolkit.Mvvm.ComponentModel;
 using Snap.Hutao.Core.Setting;
 using Snap.Hutao.Model;
+using Snap.Hutao.Win32.UI.Input.KeyboardAndMouse;
+using System.Runtime.InteropServices;
 using Windows.System;
+using static Snap.Hutao.Win32.User32;
 
 namespace Snap.Hutao.Core.Windowing.HotKey;
 
 [Injection(InjectAs.Singleton)]
-internal sealed partial class HotKeyOptions : ObservableObject
+internal sealed partial class HotKeyOptions : ObservableObject, IDisposable
 {
+    private static readonly WaitCallback RunMouseClickRepeatForever = MouseClickRepeatForever;
+
+    private readonly object syncRoot = new();
+    private readonly HotKeyMessageWindow hotKeyMessageWindow;
+
+    private volatile CancellationTokenSource? cancellationTokenSource;
+
+    private bool isDisposed;
     private bool isMouseClickRepeatForeverOn;
     private HotKeyCombination mouseClickRepeatForeverKeyCombination;
 
     public HotKeyOptions(IServiceProvider serviceProvider)
     {
-        mouseClickRepeatForeverKeyCombination = new(serviceProvider, SettingKeys.HotKeyMouseClickRepeatForever, 100000, default, VirtualKey.F8);
+        hotKeyMessageWindow = new()
+        {
+            HotKeyPressed = OnHotKeyPressed,
+        };
+
+        mouseClickRepeatForeverKeyCombination = new(serviceProvider, hotKeyMessageWindow.HWND, SettingKeys.HotKeyMouseClickRepeatForever, 100000, default, VirtualKey.F8);
     }
 
     public List<NameValue<VirtualKey>> VirtualKeys { get; } = HotKey.VirtualKeys.GetList();
@@ -32,4 +48,92 @@ internal sealed partial class HotKeyOptions : ObservableObject
         get => mouseClickRepeatForeverKeyCombination;
         set => SetProperty(ref mouseClickRepeatForeverKeyCombination, value);
     }
+
+    public void Dispose()
+    {
+        if (isDisposed)
+        {
+            return;
+        }
+
+        isDisposed = true;
+
+        MouseClickRepeatForeverKeyCombination.Unregister();
+
+        hotKeyMessageWindow.Dispose();
+        cancellationTokenSource?.Dispose();
+
+        GC.SuppressFinalize(this);
+    }
+
+    public void RegisterAll()
+    {
+        MouseClickRepeatForeverKeyCombination.Register();
+    }
+
+    private static unsafe INPUT CreateInputForMouseEvent(MOUSE_EVENT_FLAGS flags)
+    {
+        INPUT input = default;
+        input.type = INPUT_TYPE.INPUT_MOUSE;
+        input.Anonymous.mi.dwFlags = flags;
+        return input;
+    }
+
+    [SuppressMessage("", "SH007")]
+    private static unsafe void MouseClickRepeatForever(object? state)
+    {
+        CancellationToken token = (CancellationToken)state!;
+
+        // We want to use this thread for a long time
+        while (!token.IsCancellationRequested)
+        {
+            INPUT[] inputs =
+            [
+                CreateInputForMouseEvent(MOUSE_EVENT_FLAGS.MOUSEEVENTF_LEFTDOWN),
+                CreateInputForMouseEvent(MOUSE_EVENT_FLAGS.MOUSEEVENTF_LEFTUP),
+            ];
+
+            if (SendInput(inputs.AsSpan(), sizeof(INPUT)) is 0)
+            {
+                Marshal.ThrowExceptionForHR(Marshal.GetLastPInvokeError());
+            }
+
+            if (token.IsCancellationRequested)
+            {
+                return;
+            }
+
+            Thread.Sleep(System.Random.Shared.Next(100, 150));
+        }
+    }
+
+    [SuppressMessage("", "SH002")]
+    private void OnHotKeyPressed(HotKeyParameter parameter)
+    {
+        if (parameter.Equals(MouseClickRepeatForeverKeyCombination))
+        {
+            ToggleMouseClickRepeatForever();
+        }
+    }
+
+    private void ToggleMouseClickRepeatForever()
+    {
+        lock (syncRoot)
+        {
+            if (IsMouseClickRepeatForeverOn)
+            {
+                // Turn off
+                cancellationTokenSource?.Cancel();
+                cancellationTokenSource = default;
+                IsMouseClickRepeatForeverOn = false;
+            }
+            else
+            {
+                // Turn on
+                cancellationTokenSource = new();
+                ThreadPool.QueueUserWorkItem(RunMouseClickRepeatForever, cancellationTokenSource.Token);
+                IsMouseClickRepeatForeverOn = true;
+            }
+        }
+    }
 }

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

@@ -1,13 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-namespace Snap.Hutao.Core.Windowing.HotKey;
-
-internal interface IHotKeyController
-{
-    void OnHotKeyPressed(in HotKeyParameter parameter);
-
-    void RegisterAll();
-
-    void UnregisterAll();
-}