trigger gc after viewmodel dispose

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

@@ -40,7 +40,7 @@ body:
     attributes:
       label: Snap Hutao 版本
       description: 在应用标题，应用程序的反馈中心界面中可以找到
-      placeholder: 例：1.9.9.0
+      placeholder: 例：1.4.15.0
     validations:
       required: true
 
@@ -62,19 +62,20 @@ body:
       description: 请设置一个你认为合适的分类，这将帮助我们快速定位问题
       options:
         - 安装和环境
-        - 游戏启动器
-        - 祈愿记录
         - 成就管理
-        - 我的角色
+        - 角色信息面板
+        - 游戏启动器
         - 实时便笺
         - 养成计算
-        - 深境螺旋/胡桃数据库
-        - Wiki
-        - 米游社账号面板
-        - 每日签到奖励
-        - 胡桃通行证/胡桃云
-        - 用户界面
         - 文件缓存
+        - 祈愿记录
+        - 玩家查询
+        - 胡桃数据库
+        - 用户界面
+        - 胡桃云
+        - 胡桃帐号
+        - 签到
+        - 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.9.9.0
+      placeholder: e.g. 1.4.15.0
     validations:
       required: true
 
@@ -62,19 +62,20 @@ 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
-        - Spiral Abyss
-        - Wiki
-        - MiHoYo Account Panel
-        - Daily Checkin Reward
-        - Hutao Passport/Hutao Cloud
-        - User Interface
         - File Cache
+        - Wish Export
+        - Game Record
+        - Hutao Database
+        - User Interface
+        - Snap Hutao Cloud
+        - Snap Hutao Account
+        - Checkin
+        - Wiki
         - Announcement
         - Other
     validations:

.github/pull_request_template.md

@@ -1,15 +0,0 @@
-<!--- 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,7 +5,6 @@ on:
     branches:
       - main
       - develop
-      - 'feat/*'
     paths-ignore:
       - '.gitattributes'
       - '.github/**'
@@ -45,8 +44,13 @@ jobs:
         run: dotnet tool restore && dotnet cake
         env:
           VERSION_API_TOKEN: ${{ secrets.VERSION_API_TOKEN }}
-          CERTIFICATE: ${{ secrets.CERTIFICATE }}
+
-          PW: ${{ secrets.PW }}
+      - name: Sign Msix
+        if: success() && github.event_name != 'pull_request'
+        shell: pwsh
+        run: |
+          [System.Convert]::FromBase64String("${{ secrets.CERTIFICATE }}") | Set-Content -AsByteStream temp.pfx
+          signtool.exe sign /debug /v /a /fd SHA256 /f temp.pfx /p ${{ secrets.PW }} ${{ github.workspace }}\src\output\Snap.Hutao.Alpha-${{ steps.cake.outputs.version }}.msix
 
       - name: Upload signed msix
         if: success() && github.event_name != 'pull_request'
@@ -69,54 +73,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
-  fallback_build:
-    runs-on: windows-latest
-    needs: build
-    if: failure()
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup .NET
-        uses: actions/setup-dotnet@v4
-        with:
-          dotnet-version: 8.0
-
-      - name: Cake
-        id: cake
-        shell: pwsh
-        run: dotnet tool restore && dotnet cake
-        env:
-          VERSION_API_TOKEN: ${{ secrets.VERSION_API_TOKEN }}
-          CERTIFICATE: ${{ secrets.CERTIFICATE }}
-          PW: ${{ secrets.PW }}
-
-      - name: Upload signed msix
-        if: success() && github.event_name != 'pull_request'
-        uses: actions/upload-artifact@v4
-        with:
-          name: Snap.Hutao.Alpha-${{ steps.cake.outputs.version }}
-          path: ${{ github.workspace }}/src/output/Snap.Hutao.Alpha-${{ steps.cake.outputs.version }}.msix
-
-      - name: Add summary
-        if: success() && github.event_name != 'pull_request'
-        shell: pwsh
-        run: |
-          $summary = "
-          > [!WARNING]
-          > 该版本是由 CI 程序自动打包生成的 `Alpha` 测试版本，**仅供开发者测试使用**
-
-          > [!TIP]
-          > 普通用户请[点击这里](https://github.com/DGP-Studio/Snap.Hutao/releases/latest/)下载最新的稳定版本
-
-          > [!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) 到 `受信任的根证书颁发机构` 以安装测试版安装包
           "
 
           echo $summary >> $Env:GITHUB_STEP_SUMMARY

.github/workflows/close_stale.yml

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

README.md

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

build.cake

@@ -11,18 +11,6 @@ var version = "version";
 var repoDir = "repoDir";
 var outputPath = "outputPath";
 
-var pfxPath = "pfxPath";
-var pw = "pw";
-
-// 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");
@@ -65,11 +53,6 @@ if (GitHubActions.IsRunningOnGitHubActions)
             }
         );
 
-        var certificateBase64 = HasEnvironmentVariable("CERTIFICATE") ? EnvironmentVariable("CERTIFICATE") : throw new Exception("Cannot find CERTIFICATE");
-        pw = HasEnvironmentVariable("PW") ? EnvironmentVariable("PW") : throw new Exception("Cannot find PW");
-        pfxPath = System.IO.Path.Combine(repoDir, "temp.pfx");
-        System.IO.File.WriteAllBytes(pfxPath, System.Convert.FromBase64String(certificateBase64));
-
         Information($"Version: {version}");
     }
 
@@ -96,19 +79,10 @@ else // Local
     Information($"Version: {version}");
 }
 
-// Windows SDK
-var registry = new WindowsRegistry();
-var winsdkRegistry = registry.LocalMachine.OpenKey(@"SOFTWARE\Microsoft\Windows Kits\Installed Roots");
-var winsdkVersion = winsdkRegistry.GetSubKeyNames().MaxBy(key => int.Parse(key.Split(".")[2]));
-var winsdkPath = (string)winsdkRegistry.GetValue("KitsRoot10");
-var winsdkBinPath = System.IO.Path.Combine(winsdkPath, "bin", winsdkVersion, "x64");
-Information($"Windows SDK: {winsdkPath}");
-
 Task("Build")
     .IsDependentOn("Build binary package")
     .IsDependentOn("Copy files")
-    .IsDependentOn("Build MSIX")
+    .IsDependentOn("Build MSIX");
-    .IsDependentOn("Sign");
 
 Task("NuGet Restore")
     .Does(() =>
@@ -183,7 +157,6 @@ 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);
@@ -224,11 +197,8 @@ Task("Build MSIX")
     {
         arguments = "pack /d " + binPath + " /p " + System.IO.Path.Combine(outputPath, $"Snap.Hutao.Local-{version}.msix");
     }
-
-    var makeappxPath = System.IO.Path.Combine(winsdkBinPath, "makeappx.exe");
-
     var p = StartProcess(
-        makeappxPath,
+        "makeappx.exe",
         new ProcessSettings
         {
             Arguments = arguments
@@ -236,46 +206,7 @@ Task("Build MSIX")
     );
     if (p != 0)
     {
-        throw new InvalidOperationException("Build MSIX failed with exit code " + p);
+        throw new InvalidOperationException("Build failed with exit code " + p);
-    }
-});
-
-Task("Sign")
-    .IsDependentOn("Build MSIX")
-    .Does(() =>
-{
-    if (AppVeyor.IsRunningOnAppVeyor)
-    {
-        Information("Move to SignPath. Skip signing.");
-        return;
-    }
-    else if (GitHubActions.IsRunningOnGitHubActions)
-    {
-        if (GitHubActions.Environment.PullRequest.IsPullRequest)
-        {
-            Information("Is Pull Request. Skip signing.");
-            return;
-        }
-
-        var signPath = System.IO.Path.Combine(winsdkBinPath, "signtool.exe");
-        var arguments = $"sign /debug /v /a /fd SHA256 /f {pfxPath} /p {pw} {System.IO.Path.Combine(outputPath, $"Snap.Hutao.Alpha-{version}.msix")}";
-
-        var p = StartProcess(
-            signPath,
-            new ProcessSettings
-            {
-                Arguments = arguments
-            }
-        );
-        if (p != 0)
-        {
-            throw new InvalidOperationException("Sign failed with exit code " + p);
-        }
-    }
-    else
-    {
-        Information("Local configuration. Skip signing.");
-        return;
     }
 });
 

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

@@ -1,28 +0,0 @@
-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/IncomingFeature/SpiralAbyssScheduleIdTest.cs

@@ -6,25 +6,14 @@ namespace Snap.Hutao.Test.IncomingFeature;
 public class SpiralAbyssScheduleIdTest
 {
     private static readonly TimeSpan Utc8 = new(8, 0, 0);
-    private static readonly DateTimeOffset AcrobaticsBattleIntroducedTime = new(2024, 7, 1, 4, 0, 0, Utc8);
 
     [TestMethod]
     public void Test()
     {
         Console.WriteLine($"当前第 {GetForDateTimeOffset(DateTimeOffset.Now)} 期");
 
-        // 2020-07-01 04:00:00 为第 1 期
+        DateTimeOffset dateTimeOffset = new(2020, 7, 1, 4, 0, 0, Utc8);
-        // 2024-06-16 04:00:00 为第 96 期
+        Console.WriteLine($"2020-07-01 04:00:00 为第 {GetForDateTimeOffset(dateTimeOffset)} 期");
-        // 2024-07-01 04:00:00 为第 97 期
-        // 2024-07-16 04:00:00 为第 98 期
-        // 2024-08-01 04:00:00 为第 99 期
-        Console.WriteLine($"2020-07-01 04:00:00 为第 {GetForDateTimeOffset(new(2020, 07, 01, 4, 0, 0, Utc8))} 期");
-        Console.WriteLine($"2024-06-16 04:00:00 为第 {GetForDateTimeOffset(new(2024, 06, 16, 4, 0, 0, Utc8))} 期");
-        Console.WriteLine($"2024-07-01 04:00:00 为第 {GetForDateTimeOffset(new(2024, 07, 01, 4, 0, 0, Utc8))} 期");
-        Console.WriteLine($"2024-07-16 04:00:00 为第 {GetForDateTimeOffset(new(2024, 07, 16, 4, 0, 0, Utc8))} 期");
-        Console.WriteLine($"2024-08-01 04:00:00 为第 {GetForDateTimeOffset(new(2024, 08, 01, 4, 0, 0, Utc8))} 期");
-        Console.WriteLine($"2024-08-16 04:00:00 为第 {GetForDateTimeOffset(new(2024, 08, 16, 4, 0, 0, Utc8))} 期");
-        Console.WriteLine($"2024-09-01 04:00:00 为第 {GetForDateTimeOffset(new(2024, 09, 01, 4, 0, 0, Utc8))} 期");
     }
 
     public static int GetForDateTimeOffset(DateTimeOffset dateTimeOffset)
@@ -49,12 +38,6 @@ public class SpiralAbyssScheduleIdTest
             periodNum--;
         }
 
-        if (dateTimeOffset >= AcrobaticsBattleIntroducedTime)
-        {
-            // 当超过 96 期时，每一个月一期
-            periodNum = (4 * 12 * 2) + ((periodNum - (4 * 12 * 2)) / 2);
-        }
-
         return periodNum;
     }
 }

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

@@ -1,7 +1,6 @@
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Logging;
 using System;
-using System.Linq;
 
 namespace Snap.Hutao.Test.PlatformExtensions;
 
@@ -12,8 +11,6 @@ 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();
@@ -53,15 +50,6 @@ 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; }
@@ -107,14 +95,4 @@ public sealed class DependencyInjectionTest
         {
         }
     }
-
-    private interface IKeyedService;
-
-    private sealed class KeyedServiceA : IKeyedService
-    {
-    }
-
-    private sealed class KeyedServiceB : IKeyedService
-    {
-    }
 }

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

@@ -1,45 +0,0 @@
-using System.Drawing;
-using System.Net.Http;
-using System.Net.Http.Json;
-using System.Runtime.CompilerServices;
-using System.Threading;
-using System.Threading.Tasks;
-
-namespace Snap.Hutao.Test.RuntimeBehavior;
-
-[TestClass]
-public sealed class HttpClientBehaviorTest
-{
-    private const int MessageNotYetSent = 0;
-
-    [TestMethod]
-    public async Task RetrySendHttpRequestMessage()
-    {
-        using (HttpClient httpClient = new())
-        {
-            HttpRequestMessage requestMessage = new(HttpMethod.Post, "https://jsonplaceholder.typicode.com/posts");
-            JsonContent content = JsonContent.Create(new Point(12, 34));
-            requestMessage.Content = content;
-            using (requestMessage)
-            {
-                await httpClient.SendAsync(requestMessage).ConfigureAwait(false);
-            }
-
-            Interlocked.Exchange(ref GetPrivateSendStatus(requestMessage), MessageNotYetSent);
-            Volatile.Write(ref GetPrivateDisposed(content), false);
-            await httpClient.SendAsync(requestMessage).ConfigureAwait(false);
-        }
-    }
-
-    // private int _sendStatus
-    [UnsafeAccessor(UnsafeAccessorKind.Field, Name = "_sendStatus")]
-    private static extern ref int GetPrivateSendStatus(HttpRequestMessage message);
-
-    // private bool _disposed
-    [UnsafeAccessor(UnsafeAccessorKind.Field, Name = "_disposed")]
-    private static extern ref bool GetPrivateDisposed(HttpRequestMessage message);
-
-    // private bool _disposed
-    [UnsafeAccessor(UnsafeAccessorKind.Field, Name = "_disposed")]
-    private static extern ref bool GetPrivateDisposed(HttpContent content);
-}

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

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

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

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

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

@@ -6,7 +6,6 @@
         <ResourceDictionary>
             <ResourceDictionary.MergedDictionaries>
                 <XamlControlsResources/>
-                <ResourceDictionary Source="ms-appx:///CommunityToolkit.WinUI.Controls.SettingsControls/SettingsCard/SettingsCard.xaml"/>
                 <ResourceDictionary Source="ms-appx:///CommunityToolkit.WinUI.Controls.TokenizingTextBox/TokenizingTextBox.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Loading.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Image/CachedImage.xaml"/>

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.Windowing;
+using Snap.Hutao.Core.Shell;
 using System.Diagnostics;
 
 namespace Snap.Hutao;
@@ -39,7 +39,7 @@ public sealed partial class App : Application
         """;
 
     private readonly IServiceProvider serviceProvider;
-    private readonly IAppActivation activation;
+    private readonly IActivation activation;
     private readonly ILogger<App> logger;
 
     /// <summary>
@@ -50,19 +50,13 @@ public sealed partial class App : Application
     {
         // Load app resource
         InitializeComponent();
-        activation = serviceProvider.GetRequiredService<IAppActivation>();
+        activation = serviceProvider.GetRequiredService<IActivation>();
         logger = serviceProvider.GetRequiredService<ILogger<App>>();
         serviceProvider.GetRequiredService<ExceptionRecorder>().Record(this);
 
         this.serviceProvider = serviceProvider;
     }
 
-    public new void Exit()
-    {
-        XamlLifetime.ApplicationExiting = true;
-        base.Exit();
-    }
-
     /// <inheritdoc/>
     protected override void OnLaunched(LaunchActivatedEventArgs args)
     {
@@ -72,7 +66,6 @@ public sealed partial class App : Application
 
             if (serviceProvider.GetRequiredService<PrivateNamedPipeClient>().TryRedirectActivationTo(activatedEventArgs))
             {
-                logger.LogDebug("Application exiting on RedirectActivationTo");
                 Exit();
                 return;
             }
@@ -80,20 +73,15 @@ public sealed partial class App : Application
             logger.LogColorizedInformation((ConsoleBanner, ConsoleColor.DarkYellow));
             LogDiagnosticInformation();
 
-            // Manually invoke
+            // manually invoke
-            HutaoActivationArguments hutaoArgs = HutaoActivationArguments.FromAppActivationArguments(activatedEventArgs);
+            activation.Activate(HutaoActivationArguments.FromAppActivationArguments(activatedEventArgs));
-            if (hutaoArgs.Kind is HutaoActivationKind.Toast)
+            activation.Initialize();
-            {
-                Exit();
-                return;
-            }
 
-            activation.Activate(hutaoArgs);
+            serviceProvider.GetRequiredService<IJumpListInterop>().ConfigureAsync().SafeForget();
-            activation.PostInitialization();
         }
-        catch (Exception ex)
+        catch
         {
-            logger.LogError(ex, "Application failed in App.OnLaunched");
+            // AppInstance.GetCurrent() calls failed
             Process.GetCurrentProcess().Kill();
         }
     }

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

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

src/Snap.Hutao/Snap.Hutao/Control/Collection/Alternating/AlternatingItemsControl.cs

@@ -0,0 +1,39 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.UI.Xaml.Controls;
+using Windows.Foundation.Collections;
+
+namespace Snap.Hutao.Control.Collection.Alternating;
+
+[Obsolete("Use SettingsCard instead")]
+[DependencyProperty("ItemAlternateBackground", typeof(Microsoft.UI.Xaml.Media.Brush))]
+internal sealed partial class AlternatingItemsControl : ItemsControl
+{
+    private readonly VectorChangedEventHandler<object> itemsVectorChangedEventHandler;
+
+    public AlternatingItemsControl()
+    {
+        itemsVectorChangedEventHandler = OnItemsVectorChanged;
+        Items.VectorChanged += itemsVectorChangedEventHandler;
+    }
+
+    private void OnItemsVectorChanged(IObservableVector<object> items, IVectorChangedEventArgs args)
+    {
+        if (args.CollectionChange is CollectionChange.Reset)
+        {
+            int index = (int)args.Index;
+            for (int i = index; i < items.Count; i++)
+            {
+                if (items[i] is IAlternatingItem item)
+                {
+                    item.Background = i % 2 is 0 ? default : ItemAlternateBackground;
+                }
+                else
+                {
+                    break;
+                }
+            }
+        }
+    }
+}

src/Snap.Hutao/Snap.Hutao/Control/Collection/Alternating/IAlternatingItem.cs

@@ -0,0 +1,10 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Control.Collection.Alternating;
+
+[Obsolete("Use SettingsCard instead")]
+internal interface IAlternatingItem
+{
+    public Microsoft.UI.Xaml.Media.Brush? Background { get; set; }
+}

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

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

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

@@ -39,6 +39,7 @@ 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,8 +7,6 @@ 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)
@@ -17,22 +15,4 @@ 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,6 +1,8 @@
 // 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;
@@ -21,10 +23,13 @@ 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<Uri?> ProvideCachedResourceAsync(Uri imageUri, CancellationToken token)
+    protected override async Task<ImageSource?> ProvideCachedResourceAsync(Uri imageUri, CancellationToken token)
     {
         IImageCache imageCache = this.ServiceProvider().GetRequiredService<IImageCache>();
 
@@ -33,7 +38,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 file.ToUri();
+            return new BitmapImage(file.ToUri()); // BitmapImage initialize with a uri will increase image quality and loading speed.
         }
         catch (COMException)
         {

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

@@ -6,6 +6,7 @@
         <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,6 +6,9 @@ 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;
 
@@ -18,6 +21,12 @@ 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))]
@@ -33,6 +42,8 @@ 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; }
 
@@ -47,10 +58,10 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
 
     public abstract CompositionBrush GetAlphaMask();
 
-    protected virtual Task<Uri?> ProvideCachedResourceAsync(Uri imageUri, CancellationToken token)
+    protected virtual Task<ImageSource?> ProvideCachedResourceAsync(Uri imageUri, CancellationToken token)
     {
         // By default we just use the built-in UWP image cache provided within the Image control.
-        return Task.FromResult<Uri?>(imageUri);
+        return Task.FromResult<ImageSource?>(new BitmapImage(imageUri));
     }
 
     protected virtual void OnImageOpened(object sender, RoutedEventArgs e)
@@ -69,10 +80,19 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         RemoveImageFailed(OnImageFailed);
 
         Image = GetTemplateChild(PartImage);
+        PlaceholderImage = GetTemplateChild(PartPlaceholderImage);
 
         IsInitialized = true;
 
-        SetSource(Source);
+        if (Source is null || !EnableLazyLoading || isInViewport)
+        {
+            lazyLoadingSource = null;
+            SetSource(Source);
+        }
+        else
+        {
+            lazyLoadingSource = Source;
+        }
 
         AttachImageOpened(OnImageOpened);
         AttachImageFailed(OnImageFailed);
@@ -128,6 +148,33 @@ 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)
@@ -140,7 +187,15 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
             return;
         }
 
-        control.SetSource(e.NewValue);
+        if (e.NewValue is null || !control.EnableLazyLoading || control.isInViewport)
+        {
+            control.lazyLoadingSource = null;
+            control.SetSource(e.NewValue);
+        }
+        else
+        {
+            control.lazyLoadingSource = e.NewValue;
+        }
     }
 
     private static bool IsHttpUri(Uri uri)
@@ -148,8 +203,11 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         return uri.IsAbsoluteUri && (uri.Scheme == "http" || uri.Scheme == "https");
     }
 
-    private void AttachSource(BitmapImage? source, Uri? uri)
+    private void AttachSource(ImageSource? source)
     {
+        // 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;
@@ -163,15 +221,13 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         {
             VisualStateManager.GoToState(this, UnloadedState, true);
         }
-        else
+        else if (source is BitmapSource { PixelHeight: > 0, PixelWidth: > 0 })
         {
-            // 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(BitmapImage? source, Uri? uri)
+    private void AttachPlaceholderSource(ImageSource? source)
     {
         if (PlaceholderImage is Microsoft.UI.Xaml.Controls.Image image)
         {
@@ -186,10 +242,8 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         {
             VisualStateManager.GoToState(this, UnloadedState, true);
         }
-        else
+        else if (source is BitmapSource { PixelHeight: > 0, PixelWidth: > 0 })
         {
-            // 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);
         }
     }
@@ -202,9 +256,10 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         }
 
         tokenSource?.Cancel();
+
         tokenSource = new CancellationTokenSource();
 
-        AttachSource(default, default);
+        AttachSource(null);
 
         if (source is null)
         {
@@ -213,6 +268,13 @@ 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();
@@ -257,13 +319,20 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         tokenSource?.Cancel();
         tokenSource = new();
 
-        AttachPlaceholderSource(default, default);
+        AttachPlaceholderSource(null);
 
         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();
@@ -285,13 +354,13 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
                 return;
             }
 
-            Uri? actualUri = await ProvideCachedResourceAsync(uri, tokenSource.Token).ConfigureAwait(true);
+            ImageSource? img = 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(new BitmapImage(), actualUri);
+                AttachPlaceholderSource(img);
             }
         }
         catch (OperationCanceledException)
@@ -310,13 +379,99 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
             return;
         }
 
-        Uri? actualUri = await ProvideCachedResourceAsync(imageUri, token).ConfigureAwait(true);
+        if (IsCacheEnabled)
-
-        ArgumentNullException.ThrowIfNull(tokenSource);
-        if (!tokenSource.IsCancellationRequested)
         {
-            // Only attach our image if we still have a valid request.
+            ImageSource? img = await ProvideCachedResourceAsync(imageUri, token).ConfigureAwait(true);
-            AttachSource(new BitmapImage(), actualUri);
+
+            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;
         }
     }
 }

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 is 0)
+        if (context.ItemCount == 0)
         {
             return new Size(availableSize.Width, 0);
         }
 
-        if ((context.RealizationRect.Width is 0) && (context.RealizationRect.Height is 0))
+        if ((context.RealizationRect.Width == 0) && (context.RealizationRect.Height == 0))
         {
             return new Size(availableSize.Width, 0.0f);
         }

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

@@ -1,25 +0,0 @@
-// 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

@@ -1,220 +0,0 @@
-// 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

@@ -1,109 +0,0 @@
-// 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/Loading.cs

@@ -2,7 +2,6 @@
 // Licensed under the MIT license.
 
 using Microsoft.UI.Xaml;
-using Microsoft.UI.Xaml.Markup;
 
 namespace Snap.Hutao.Control;
 
@@ -37,18 +36,9 @@ internal class Loading : Microsoft.UI.Xaml.Controls.ContentControl
     private static void IsLoadingPropertyChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
     {
         Loading control = (Loading)d;
+        control.presenter ??= control.GetTemplateChild("ContentGrid") as FrameworkElement;
 
-        if ((bool)e.NewValue)
+        control?.Update();
-        {
-            control.presenter ??= control.GetTemplateChild("ContentGrid") as FrameworkElement;
-        }
-        else if (control.presenter is not null)
-        {
-            XamlMarkupHelper.UnloadObject(control.presenter);
-            control.presenter = null;
-        }
-
-        control.Update();
     }
 
     private void Update()

src/Snap.Hutao/Snap.Hutao/Control/Loading.xaml

@@ -23,8 +23,7 @@
                         <ContentPresenter
                             x:Name="ContentGrid"
                             HorizontalAlignment="{TemplateBinding HorizontalContentAlignment}"
-                            VerticalAlignment="{TemplateBinding VerticalContentAlignment}"
+                            VerticalAlignment="{TemplateBinding VerticalContentAlignment}">
-                            x:Load="False">
                             <ContentPresenter.RenderTransform>
                                 <CompositeTransform/>
                             </ContentPresenter.RenderTransform>
@@ -85,4 +84,4 @@
         </Setter>
     </Style>
 
-</ResourceDictionary>
+</ResourceDictionary>

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

@@ -8,19 +8,45 @@ 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
@@ -54,6 +80,11 @@ 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;
@@ -107,6 +138,10 @@ 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

@@ -1,14 +0,0 @@
-// 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

@@ -3,11 +3,8 @@
 
 using Microsoft.UI.Xaml;
 using Microsoft.UI.Xaml.Controls;
-using Microsoft.UI.Xaml.Markup;
 using Microsoft.UI.Xaml.Navigation;
-using Snap.Hutao.Core.Abstraction;
 using Snap.Hutao.Service.Navigation;
-using Snap.Hutao.View.Helper;
 using Snap.Hutao.ViewModel.Abstraction;
 
 namespace Snap.Hutao.Control;
@@ -39,11 +36,6 @@ internal class ScopedPage : Page
         extra.NotifyNavigationCompleted();
     }
 
-    public virtual void UnloadObjectOverride(DependencyObject unloadableObject)
-    {
-        XamlMarkupHelper.UnloadObject(unloadableObject);
-    }
-
     /// <summary>
     /// 初始化
     /// 应当在 InitializeComponent() 前调用
@@ -54,14 +46,8 @@ internal class ScopedPage : Page
     {
         try
         {
-            TViewModel viewModel = pageScope.ServiceProvider.GetRequiredService<TViewModel>();
+            IViewModel viewModel = pageScope.ServiceProvider.GetRequiredService<TViewModel>();
-            using (viewModel.DisposeLock.Enter())
+            viewModel.CancellationToken = viewCancellationTokenSource.Token;
-            {
-                viewModel.IsViewDisposed = false;
-                viewModel.CancellationToken = viewCancellationTokenSource.Token;
-                viewModel.DeferContentLoader = new DeferContentLoader(this);
-            }
-
             DataContext = viewModel;
         }
         catch (Exception ex)
@@ -110,9 +96,10 @@ internal class ScopedPage : Page
             viewCancellationTokenSource.Cancel();
             IViewModel viewModel = (IViewModel)DataContext;
 
-            using (viewModel.DisposeLock.Enter())
+            using (SemaphoreSlim locker = viewModel.DisposeLock)
             {
                 // Wait to ensure viewmodel operation is completed
+                locker.Wait();
                 viewModel.IsViewDisposed = true;
 
                 // Dispose the scope

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

@@ -22,6 +22,7 @@ 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,8 +1,6 @@
 // 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
@@ -29,7 +27,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 HutaoException.NotSupported(),
+                _ => throw Must.NeverHappen(),
             };
         }
     }
@@ -42,7 +40,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 HutaoException.NotSupported(),
+                _ => throw Must.NeverHappen(),
             };
         }
     }

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

@@ -1,11 +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;
 
-// TODO: Pooling syntax nodes to reduce memory allocation
 internal sealed class MiHoYoSyntaxTree
 {
     public MiHoYoSyntaxNode Root { get; set; } = default!;
@@ -78,7 +75,7 @@ internal sealed class MiHoYoSyntaxTree
                         {
                             17 => MiHoYoColorKind.Rgba,
                             15 => MiHoYoColorKind.Rgb,
-                            _ => throw HutaoException.NotSupported(),
+                            _ => throw Must.NeverHappen(),
                         };
 
                         TextPosition position = new(0, endOfXmlColorRightClosingAtUnprocessedContent);

src/Snap.Hutao/Snap.Hutao/Control/Theme/InfoBarOverride.xaml

@@ -52,12 +52,6 @@
     <Thickness x:Key="InfoBarIconMargin">19,16,19,16</Thickness>
     <Thickness x:Key="InfoBarContentRootPadding">0,0,0,0</Thickness>
     <x:Double x:Key="InfoBarIconFontSize">20</x:Double>
-
-    <Thickness x:Key="InfoBarTitleHorizontalOrientationMargin">0,0,0,0</Thickness>
-    <Thickness x:Key="InfoBarMessageHorizontalOrientationMargin">12,0,0,0</Thickness>
-    <Thickness x:Key="InfoBarTitleVerticalOrientationMargin">0,16,0,0</Thickness>
-    <Thickness x:Key="InfoBarMessageVerticalOrientationMargin">0,6,0,0</Thickness>
-
     <!--  TODO: When will DefaultInfoBarStyle added  -->
     <Style TargetType="InfoBar">
         <Setter Property="shch:InfoBarHelper.IsTextSelectionEnabled" Value="False"/>
@@ -134,7 +128,6 @@
                             <InfoBarPanel
                                 Grid.Column="1"
                                 Margin="{StaticResource InfoBarPanelMargin}"
-                                VerticalAlignment="Center"
                                 HorizontalOrientationPadding="{StaticResource InfoBarPanelHorizontalOrientationPadding}"
                                 VerticalOrientationPadding="{StaticResource InfoBarPanelVerticalOrientationPadding}">
                                 <TextBlock
@@ -180,7 +173,6 @@
                             <Button
                                 Name="CloseButton"
                                 Grid.Column="2"
-                                VerticalAlignment="Top"
                                 Command="{TemplateBinding CloseButtonCommand}"
                                 CommandParameter="{TemplateBinding CloseButtonCommandParameter}"
                                 Style="{TemplateBinding CloseButtonStyle}">
@@ -244,14 +236,7 @@
 
                         <VisualStateManager.VisualStateGroups>
                             <VisualStateGroup x:Name="SeverityLevels">
-                                <VisualState x:Name="Informational">
+                                <VisualState x:Name="Informational"/>
-                                    <VisualState.Setters>
-                                        <Setter Target="ContentRoot.Background" Value="{ThemeResource InfoBarInformationalSeverityBackgroundBrush}"/>
-                                        <Setter Target="IconBackground.Foreground" Value="{ThemeResource InfoBarInformationalSeverityIconBackground}"/>
-                                        <Setter Target="StandardIcon.Text" Value="{StaticResource InfoBarInformationalIconGlyph}"/>
-                                        <Setter Target="StandardIcon.Foreground" Value="{ThemeResource InfoBarInformationalSeverityIconForeground}"/>
-                                    </VisualState.Setters>
-                                </VisualState>
                                 <VisualState x:Name="Error">
                                     <VisualState.Setters>
                                         <Setter Target="ContentRoot.Background" Value="{ThemeResource InfoBarErrorSeverityBackgroundBrush}"/>

src/Snap.Hutao/Snap.Hutao/Control/Theme/TransitionCollection.xaml

@@ -1,4 +1,4 @@
-<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
+<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
     <TransitionCollection x:Key="ContentThemeTransitions">
         <ContentThemeTransition/>
     </TransitionCollection>
@@ -20,4 +20,4 @@
     <TransitionCollection x:Key="NavigationThemeTransitions">
         <NavigationThemeTransition/>
     </TransitionCollection>
-</ResourceDictionary>
+</ResourceDictionary>

src/Snap.Hutao/Snap.Hutao/Control/Theme/Uri.xaml

@@ -17,13 +17,8 @@
     <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>
-    <!--  Mark  -->
+    <x:String x:Key="UI_MarkTower">https://api.snapgenshin.com/static/raw/Bg/UI_MarkTower.png</x:String>
-    <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/ValueConverter.cs

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

src/Snap.Hutao/Snap.Hutao/Core/Abstraction/IPinnable.cs

@@ -5,5 +5,5 @@ namespace Snap.Hutao.Core.Abstraction;
 
 internal interface IPinnable<TData>
 {
-    ref TData GetPinnableReference();
+    ref readonly TData GetPinnableReference();
 }

src/Snap.Hutao/Snap.Hutao/Core/Abstraction/IResurrectable.cs

@@ -1,9 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-namespace Snap.Hutao.Core.Abstraction;
-
-internal interface IResurrectable
-{
-    void Resurrect();
-}

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

@@ -1,7 +1,6 @@
 // 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;
@@ -11,13 +10,16 @@ using Snap.Hutao.Web.Request.Builder;
 using Snap.Hutao.Web.Request.Builder.Abstraction;
 using System.Collections.Concurrent;
 using System.Collections.Frozen;
-using System.Diagnostics;
 using System.IO;
 using System.Net;
 using System.Net.Http;
 
 namespace Snap.Hutao.Core.Caching;
 
+/// <summary>
+/// Provides methods and tools to cache files in a folder
+/// The class's name will become the cache folder's name
+/// </summary>
 [HighQuality]
 [ConstructorGenerated]
 [Injection(InjectAs.Singleton, typeof(IImageCache))]
@@ -25,9 +27,9 @@ namespace Snap.Hutao.Core.Caching;
 [PrimaryHttpMessageHandler(MaxConnectionsPerServer = 8)]
 internal sealed partial class ImageCache : IImageCache, IImageCacheFilePathOperation
 {
-    private const string CacheFailedDownloadTasksName = $"{nameof(ImageCache)}.FailedDownloadTasks";
+    private const string CacheFolderName = nameof(ImageCache);
 
-    private static readonly FrozenDictionary<int, TimeSpan> DelayFromRetryCount = FrozenDictionary.ToFrozenDictionary(
+    private readonly FrozenDictionary<int, TimeSpan> retryCountToDelay = FrozenDictionary.ToFrozenDictionary(
     [
         KeyValuePair.Create(0, TimeSpan.FromSeconds(4)),
         KeyValuePair.Create(1, TimeSpan.FromSeconds(16)),
@@ -36,19 +38,21 @@ internal sealed partial class ImageCache : IImageCache, IImageCacheFilePathOpera
 
     private readonly ConcurrentDictionary<string, Task> concurrentTasks = new();
 
-    private readonly IHttpRequestMessageBuilderFactory httpRequestMessageBuilderFactory;
     private readonly IHttpClientFactory httpClientFactory;
+    private readonly IHttpRequestMessageBuilderFactory httpRequestMessageBuilderFactory;
     private readonly IServiceProvider serviceProvider;
     private readonly ILogger<ImageCache> logger;
-    private readonly IMemoryCache memoryCache;
 
+    private string? baseFolder;
     private string? cacheFolder;
 
     private string CacheFolder
     {
         get => LazyInitializer.EnsureInitialized(ref cacheFolder, () =>
         {
-            return serviceProvider.GetRequiredService<RuntimeOptions>().GetLocalCacheImageCacheFolder();
+            baseFolder ??= serviceProvider.GetRequiredService<RuntimeOptions>().LocalCache;
+            DirectoryInfo info = Directory.CreateDirectory(Path.Combine(baseFolder, CacheFolderName));
+            return info.FullName;
         });
     }
 
@@ -142,7 +146,8 @@ internal sealed partial class ImageCache : IImageCache, IImageCacheFilePathOpera
             return treatNullFileAsInvalid;
         }
 
-        return new FileInfo(file).Length == 0;
+        FileInfo fileInfo = new(file);
+        return fileInfo.Length == 0;
     }
 
     private void RemoveCore(IEnumerable<string> filePaths)
@@ -164,76 +169,55 @@ internal sealed partial class ImageCache : IImageCache, IImageCacheFilePathOpera
     [SuppressMessage("", "SH003")]
     private async Task DownloadFileAsync(Uri uri, string baseFile)
     {
-        using (HttpClient httpClient = httpClientFactory.CreateClient(nameof(ImageCache)))
+        int retryCount = 0;
+        HttpClient httpClient = httpClientFactory.CreateClient(nameof(ImageCache));
+        while (retryCount < 3)
         {
-            int retryCount = 0;
-
             HttpRequestMessageBuilder requestMessageBuilder = httpRequestMessageBuilderFactory
                 .Create()
                 .SetRequestUri(uri)
-                .SetStaticResourceControlHeadersIf(uri.Host.Contains("api.snapgenshin.com", StringComparison.OrdinalIgnoreCase)) // These headers are only available for our own api
+
+                // These headers are only available for our own api
+                .SetStaticResourceControlHeadersIf(uri.Host.Contains("api.snapgenshin.com", StringComparison.OrdinalIgnoreCase))
                 .Get();
 
-            while (retryCount < 3)
+            using (HttpRequestMessage requestMessage = requestMessageBuilder.HttpRequestMessage)
             {
-                requestMessageBuilder.Resurrect();
+                using (HttpResponseMessage responseMessage = await httpClient.SendAsync(requestMessage, HttpCompletionOption.ResponseHeadersRead).ConfigureAwait(false))
-
-                using (HttpRequestMessage requestMessage = requestMessageBuilder.HttpRequestMessage)
                 {
-                    using (HttpResponseMessage responseMessage = await httpClient.SendAsync(requestMessage, HttpCompletionOption.ResponseHeadersRead).ConfigureAwait(false))
+                    if (responseMessage.RequestMessage is { RequestUri: { } target } && target != uri)
                     {
-                        // Redirect detection
+                        logger.LogDebug("The Request '{Source}' has been redirected to '{Target}'", uri, target);
-                        if (responseMessage.RequestMessage is { RequestUri: { } target } && target != uri)
+                    }
-                        {
-                            logger.LogDebug("The Request '{Source}' has been redirected to '{Target}'", uri, target);
-                        }
 
-                        if (responseMessage.IsSuccessStatusCode)
+                    if (responseMessage.IsSuccessStatusCode)
+                    {
+                        using (Stream httpStream = await responseMessage.Content.ReadAsStreamAsync().ConfigureAwait(false))
                         {
-                            if (responseMessage.Content.Headers.ContentType?.MediaType is "application/json")
+                            using (FileStream fileStream = File.Create(baseFile))
                             {
-                                DebugTrackFailedUri(uri);
+                                await httpStream.CopyToAsync(fileStream).ConfigureAwait(false);
-                                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))
+                    switch (responseMessage.StatusCode)
+                    {
+                        case HttpStatusCode.TooManyRequests:
                             {
-                                using (FileStream fileStream = File.Create(baseFile))
+                                retryCount++;
-                                {
+                                TimeSpan delay = responseMessage.Headers.RetryAfter?.Delta ?? retryCountToDelay[retryCount];
-                                    await httpStream.CopyToAsync(fileStream).ConfigureAwait(false);
+                                logger.LogInformation("Retry download '{Uri}' after {Delay}.", uri, delay);
-                                    return;
+                                await Task.Delay(delay).ConfigureAwait(false);
-                                }
+                                break;
                             }
-                        }
 
-                        switch (responseMessage.StatusCode)
+                        default:
-                        {
+                            return;
-                            case HttpStatusCode.TooManyRequests:
-                                {
-                                    retryCount++;
-                                    TimeSpan delay = responseMessage.Headers.RetryAfter?.Delta ?? DelayFromRetryCount[retryCount];
-                                    logger.LogInformation("Retry download '{Uri}' after {Delay}.", uri, delay);
-                                    await Task.Delay(delay).ConfigureAwait(false);
-                                    break;
-                                }
-
-                            default:
-                                DebugTrackFailedUri(uri);
-                                logger.LogColorizedCritical("Failed to download '{Uri}' with status code '{StatusCode}'", (uri, ConsoleColor.Red), (responseMessage.StatusCode, ConsoleColor.DarkYellow));
-                                return;
-                        }
                     }
                 }
             }
         }
     }
-
-    [Conditional("DEBUG")]
-    private void DebugTrackFailedUri(Uri uri)
-    {
-        HashSet<string>? set = memoryCache.GetOrCreate(CacheFailedDownloadTasksName, entry => new HashSet<string>());
-        set?.Add(uri.ToString());
-    }
 }

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

@@ -0,0 +1,25 @@
+// 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/Database/ObservableReorderableDbCollection.cs

@@ -70,7 +70,7 @@ internal sealed class ObservableReorderableDbCollection<TEntity> : ObservableCol
 
 [SuppressMessage("", "SA1402")]
 internal sealed class ObservableReorderableDbCollection<TEntityOnly, TEntity> : ObservableCollection<TEntityOnly>
-    where TEntityOnly : class, IEntityAccess<TEntity>
+    where TEntityOnly : class, IEntityOnly<TEntity>
     where TEntity : class, IReorderable
 {
     private readonly IServiceProvider serviceProvider;

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

@@ -73,7 +73,7 @@ internal sealed partial class ScopedDbCurrent<TEntity, TMessage>
 
 [ConstructorGenerated]
 internal sealed partial class ScopedDbCurrent<TEntityOnly, TEntity, TMessage>
-    where TEntityOnly : class, IEntityAccess<TEntity>
+    where TEntityOnly : class, IEntityOnly<TEntity>
     where TEntity : class, ISelectable
     where TMessage : Message.ValueChangedMessage<TEntityOnly>, new()
 {

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

@@ -0,0 +1,26 @@
+// 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,7 +2,6 @@
 // Licensed under the MIT license.
 
 using CommunityToolkit.Mvvm.Messaging;
-using Quartz;
 using Snap.Hutao.Core.Logging;
 using Snap.Hutao.Service;
 using System.Globalization;
@@ -34,14 +33,11 @@ internal static class DependencyInjection
             })
             .AddMemoryCache()
 
-            // Quartz
-            .AddQuartz()
-
             // Hutao extensions
             .AddJsonOptions()
             .AddDatabase()
             .AddInjections()
-            .AddConfiguredHttpClients()
+            .AddAllHttpClients()
 
             // Discrete services
             .AddSingleton<IMessenger, WeakReferenceMessenger>()

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

@@ -34,27 +34,27 @@ internal static class IocConfiguration
             .AddTransient(typeof(Database.ScopedDbCurrent<,>))
             .AddTransient(typeof(Database.ScopedDbCurrent<,,>))
             .AddDbContextPool<AppDbContext>(AddDbContextCore);
+    }
 
-        static void AddDbContextCore(IServiceProvider serviceProvider, DbContextOptionsBuilder builder)
+    private static void AddDbContextCore(IServiceProvider serviceProvider, DbContextOptionsBuilder builder)
+    {
+        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(serviceProvider, sqlConnectionString))
         {
-            RuntimeOptions runtimeOptions = serviceProvider.GetRequiredService<RuntimeOptions>();
+            if (context.Database.GetPendingMigrations().Any())
-            string dbFile = System.IO.Path.Combine(runtimeOptions.DataFolder, "Userdata.db");
-            string sqlConnectionString = $"Data Source={dbFile}";
-
-            // Temporarily create a context
-            using (AppDbContext context = AppDbContext.Create(serviceProvider, sqlConnectionString))
             {
-                if (context.Database.GetPendingMigrations().Any())
+                System.Diagnostics.Debug.WriteLine("[Database] Performing AppDbContext Migrations");
-                {
+                context.Database.Migrate();
-                    System.Diagnostics.Debug.WriteLine("[Database] Performing AppDbContext Migrations");
-                    context.Database.Migrate();
-                }
             }
-
-            builder
-                .EnableSensitiveDataLogging()
-                .UseQueryTrackingBehavior(QueryTrackingBehavior.NoTracking)
-                .UseSqlite(sqlConnectionString);
         }
+
+        builder
+            .EnableSensitiveDataLogging()
+            .UseQueryTrackingBehavior(QueryTrackingBehavior.NoTracking)
+            .UseSqlite(sqlConnectionString);
     }
 }

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

@@ -15,7 +15,7 @@ internal static partial class IocHttpClientConfiguration
 {
     private const string ApplicationJson = "application/json";
 
-    public static IServiceCollection AddConfiguredHttpClients(this IServiceCollection services)
+    public static IServiceCollection AddAllHttpClients(this IServiceCollection services)
     {
         services
             .ConfigureHttpClientDefaults(clientBuilder =>
@@ -27,7 +27,7 @@ internal static partial class IocHttpClientConfiguration
                         HttpClientHandler clientHandler = (HttpClientHandler)handler;
                         clientHandler.AllowAutoRedirect = true;
                         clientHandler.UseProxy = true;
-                        clientHandler.Proxy = provider.GetRequiredService<HttpProxyUsingSystemProxy>();
+                        clientHandler.Proxy = provider.GetRequiredService<DynamicHttpProxy>();
                     });
             })
             .AddHttpClients();

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

@@ -0,0 +1,22 @@
+// 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,8 +1,6 @@
 // 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
@@ -13,14 +11,12 @@ internal sealed class HutaoException : Exception
     }
 
     [DoesNotReturn]
-    [MethodImpl(MethodImplOptions.NoInlining)]
     public static HutaoException Throw(string message, Exception? innerException = default)
     {
         throw new HutaoException(message, innerException);
     }
 
-    [MethodImpl(MethodImplOptions.NoInlining)]
+    public static void ThrowIf(bool condition, string message, Exception? innerException = default)
-    public static void ThrowIf([DoesNotReturnIf(true)] bool condition, string message, Exception? innerException = default)
     {
         if (condition)
         {
@@ -28,8 +24,7 @@ internal sealed class HutaoException : Exception
         }
     }
 
-    [MethodImpl(MethodImplOptions.NoInlining)]
+    public static void ThrowIfNot(bool condition, string message, Exception? innerException = default)
-    public static void ThrowIfNot([DoesNotReturnIf(false)] bool condition, string message, Exception? innerException = default)
     {
         if (!condition)
         {
@@ -38,28 +33,18 @@ 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}'";
@@ -67,23 +52,14 @@ internal sealed class HutaoException : Exception
     }
 
     [DoesNotReturn]
-    [MethodImpl(MethodImplOptions.NoInlining)]
-    public static InvalidOperationException InvalidOperation(string message, Exception? innerException = default)
-    {
-        throw new InvalidOperationException(message, innerException);
-    }
-
-    [DoesNotReturn]
-    [MethodImpl(MethodImplOptions.NoInlining)]
     public static NotSupportedException NotSupported(string? message = default, Exception? innerException = default)
     {
         throw new NotSupportedException(message, innerException);
     }
 
     [DoesNotReturn]
-    [MethodImpl(MethodImplOptions.NoInlining)]
     public static OperationCanceledException OperationCanceled(string message, Exception? innerException = default)
     {
-        throw new OperationCanceledException(message, innerException);
+        return new OperationCanceledException(message, innerException);
     }
 }

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

@@ -0,0 +1,23 @@
+// 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

@@ -0,0 +1,23 @@
+// 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

@@ -0,0 +1,113 @@
+// 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;
+
+/// <summary>
+/// 帮助更好的抛出异常
+/// </summary>
+[HighQuality]
+[System.Diagnostics.StackTraceHidden]
+[Obsolete("Use HutaoException instead")]
+internal static class ThrowHelper
+{
+    [DoesNotReturn]
+    [MethodImpl(MethodImplOptions.NoInlining)]
+    public static ArgumentException Argument(string message, string? paramName)
+    {
+        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

@@ -0,0 +1,22 @@
+// 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/DirectoryOperation.cs

@@ -2,12 +2,7 @@
 // Licensed under the MIT license.
 
 using Microsoft.VisualBasic.FileIO;
-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;
 
@@ -23,29 +18,4 @@ internal static class DirectoryOperation
         FileSystem.MoveDirectory(sourceDirName, destDirName, true);
         return true;
     }
-
-    public static unsafe bool UnsafeRename(string path, string name, FILEOPERATION_FLAGS flags = FILEOPERATION_FLAGS.FOF_ALLOWUNDO | FILEOPERATION_FLAGS.FOF_NOCONFIRMMKDIR)
-    {
-        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->SetOperationFlags(flags);
-                pFileOperation->RenameItem(pShellItem, name, default);
-
-                if (SUCCEEDED(pFileOperation->PerformOperations()))
-                {
-                    result = true;
-                }
-
-                IUnknownMarshal.Release(pShellItem);
-            }
-
-            IUnknownMarshal.Release(pFileOperation);
-        }
-
-        return result;
-    }
 }

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

@@ -1,6 +1,7 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
+using Snap.Hutao.Win32.Foundation;
 using Snap.Hutao.Win32.System.Com;
 using Snap.Hutao.Win32.UI.Shell;
 using System.IO;
@@ -45,30 +46,6 @@ internal static class FileOperation
         return true;
     }
 
-    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;
-    }
-
     public static unsafe bool UnsafeMove(string sourceFileName, string destFileName)
     {
         bool result = false;
@@ -86,13 +63,37 @@ internal static class FileOperation
                         result = true;
                     }
 
-                    IUnknownMarshal.Release(pDestShellItem);
+                    pDestShellItem->Release();
                 }
 
-                IUnknownMarshal.Release(pSourceShellItem);
+                pSourceShellItem->Release();
             }
 
-            IUnknownMarshal.Release(pFileOperation);
+            pFileOperation->Release();
+        }
+
+        return result;
+    }
+
+    public static unsafe bool UnsafeDelete(string path)
+    {
+        bool result = false;
+
+        if (SUCCEEDED(CoCreateInstance(in Win32.UI.Shell.FileOperation.CLSID, default, CLSCTX.CLSCTX_INPROC_SERVER, in IFileOperation.IID, out IFileOperation* pFileOperation)))
+        {
+            if (SUCCEEDED(SHCreateItemFromParsingName(path, default, in IShellItem.IID, out IShellItem* pShellItem)))
+            {
+                pFileOperation->DeleteItem(pShellItem, default);
+
+                if (SUCCEEDED(pFileOperation->PerformOperations()))
+                {
+                    result = true;
+                }
+
+                pShellItem->Release();
+            }
+
+            pFileOperation->Release();
         }
 
         return result;

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

@@ -6,22 +6,14 @@ using System.Text;
 
 namespace Snap.Hutao.Core.IO.Hashing;
 
-#if NET9_0_OR_GREATER
-[Obsolete]
-#endif
 internal static class Hash
 {
-    public static unsafe string SHA1HexString(string input)
+    public static string SHA1HexString(string input)
     {
-        return HashCore(Convert.ToHexString, SHA1.HashData, Encoding.UTF8.GetBytes, input);
+        return HashCore(System.Convert.ToHexString, SHA1.HashData, Encoding.UTF8.GetBytes, input);
     }
 
-    public static unsafe string MD5HexString(string input)
+    private static TResult HashCore<TInput, TResult>(Func<byte[], TResult> resultConverter, Func<byte[], byte[]> hashMethod, Func<TInput, byte[]> bytesConverter, TInput 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 Convert.ToHexString(bytes);
+        return System.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 Convert.ToHexString(bytes);
+        return System.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.FirewallApi;
+using static Snap.Hutao.Win32.ApiMsWinNetIsolation;
 using static Snap.Hutao.Win32.Macros;
 
 namespace Snap.Hutao.Core.IO.Http.Loopback;

src/Snap.Hutao/Snap.Hutao/Core/IO/Http/Proxy/DynamicHttpProxy.cs

@@ -3,14 +3,13 @@
 
 using CommunityToolkit.Mvvm.ComponentModel;
 using Snap.Hutao.Win32.Registry;
-using System.Linq.Expressions;
 using System.Net;
 using System.Reflection;
 
 namespace Snap.Hutao.Core.IO.Http.Proxy;
 
 [Injection(InjectAs.Singleton)]
-internal sealed partial class HttpProxyUsingSystemProxy : ObservableObject, IWebProxy, IDisposable
+internal sealed partial class DynamicHttpProxy : ObservableObject, IWebProxy, IDisposable
 {
     private const string ProxySettingPath = @"HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings\Connections";
 
@@ -21,7 +20,7 @@ internal sealed partial class HttpProxyUsingSystemProxy : ObservableObject, IWeb
 
     private IWebProxy innerProxy = default!;
 
-    public HttpProxyUsingSystemProxy(IServiceProvider serviceProvider)
+    public DynamicHttpProxy(IServiceProvider serviceProvider)
     {
         this.serviceProvider = serviceProvider;
         UpdateInnerProxy();

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(bufferSize))
+                    using (IMemoryOwner<byte> memoryOwner = MemoryPool<byte>.Shared.Rent())
                     {
                         Memory<byte> buffer = memoryOwner.Memory;
                         using (Stream stream = await response.Content.ReadAsStreamAsync(token).ConfigureAwait(false))

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

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

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

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

src/Snap.Hutao/Snap.Hutao/Core/LazySlim.cs

@@ -1,21 +0,0 @@
-// 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/Activation.cs

@@ -3,18 +3,11 @@
 
 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;
@@ -27,9 +20,9 @@ namespace Snap.Hutao.Core.LifeCycle;
 /// </summary>
 [HighQuality]
 [ConstructorGenerated]
-[Injection(InjectAs.Singleton, typeof(IAppActivation))]
+[Injection(InjectAs.Singleton, typeof(IActivation))]
 [SuppressMessage("", "CA1001")]
-internal sealed partial class AppActivation : IAppActivation, IAppActivationActionHandlersAccess, IDisposable
+internal sealed partial class Activation : IActivation
 {
     public const string Action = nameof(Action);
     public const string Uid = nameof(Uid);
@@ -42,95 +35,26 @@ internal sealed partial class AppActivation : IAppActivation, IAppActivationActi
     private const string UrlActionRefresh = "/REFRESH";
 
     private readonly IServiceProvider serviceProvider;
-    private readonly ICurrentXamlWindowReference currentWindowReference;
+    private readonly ICurrentWindowReference currentWindowReference;
     private readonly ITaskContext taskContext;
-
     private readonly SemaphoreSlim activateSemaphore = new(1);
 
     /// <inheritdoc/>
     public void Activate(HutaoActivationArguments args)
     {
+        if (ToastNotificationManagerCompat.WasCurrentProcessToastActivated())
+        {
+            return;
+        }
+
         HandleActivationAsync(args).SafeForget();
     }
 
     /// <inheritdoc/>
-    public void PostInitialization()
+    public void Initialize()
     {
-        RunPostInitializationAsync().SafeForget();
+        serviceProvider.GetRequiredService<PrivateNamedPipeServer>().RunAsync().SafeForget();
-
+        ToastNotificationManagerCompat.OnActivated += NotificationActivate;
-        async ValueTask RunPostInitializationAsync()
-        {
-            await taskContext.SwitchToBackgroundAsync();
-
-            serviceProvider.GetRequiredService<PrivateNamedPipeServer>().RunAsync().SafeForget();
-            ToastNotificationManagerCompat.OnActivated += NotificationActivate;
-
-            using (await activateSemaphore.EnterAsync().ConfigureAwait(false))
-            {
-                // TODO: Introduced in 1.10.2, remove in later version
-                serviceProvider.GetRequiredService<IJumpListInterop>().ClearAsync().SafeForget();
-                serviceProvider.GetRequiredService<IScheduleTaskInterop>().UnregisterAllTasks();
-
-                if (UnsafeLocalSetting.Get(SettingKeys.Major1Minor10Revision0GuideState, GuideState.Language) < GuideState.Completed)
-                {
-                    return;
-                }
-
-                serviceProvider.GetRequiredService<HotKeyOptions>().RegisterAll();
-
-                if (serviceProvider.GetRequiredService<AppOptions>().IsNotifyIconEnabled)
-                {
-                    XamlLifetime.ApplicationLaunchedWithNotifyIcon = true;
-
-                    await taskContext.SwitchToMainThreadAsync();
-                    serviceProvider.GetRequiredService<App>().DispatcherShutdownMode = DispatcherShutdownMode.OnExplicitShutdown;
-                    _ = serviceProvider.GetRequiredService<NotifyIconController>();
-                }
-
-                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();
-
-        switch (currentWindowReference.Window)
-        {
-            case null:
-                LaunchGameWindow launchGameWindow = serviceProvider.GetRequiredService<LaunchGameWindow>();
-                currentWindowReference.Window = launchGameWindow;
-
-                launchGameWindow.SwitchTo();
-                launchGameWindow.BringToForeground();
-                return;
-
-            case MainWindow:
-                await serviceProvider
-                    .GetRequiredService<INavigationService>()
-                    .NavigateAsync<View.Page.LaunchGamePage>(INavigationAwaiter.Default, true)
-                    .ConfigureAwait(false);
-                return;
-
-            case LaunchGameWindow currentLaunchGameWindow:
-                currentLaunchGameWindow.SwitchTo();
-                currentLaunchGameWindow.BringToForeground();
-                return;
-
-            default:
-                Process.GetCurrentProcess().Kill();
-                return;
-        }
     }
 
     private void NotificationActivate(ToastNotificationActivatedEventArgsCompat args)
@@ -149,8 +73,6 @@ internal sealed partial class AppActivation : IAppActivation, IAppActivationActi
 
     private async ValueTask HandleActivationAsync(HutaoActivationArguments args)
     {
-        await taskContext.SwitchToBackgroundAsync();
-
         if (activateSemaphore.CurrentCount > 0)
         {
             using (await activateSemaphore.EnterAsync().ConfigureAwait(false))
@@ -172,63 +94,57 @@ internal sealed partial class AppActivation : IAppActivation, IAppActivationActi
             ArgumentNullException.ThrowIfNull(args.LaunchActivatedArguments);
             switch (args.LaunchActivatedArguments)
             {
+                case LaunchGame:
+                    {
+                        await HandleLaunchGameActionAsync().ConfigureAwait(false);
+                        break;
+                    }
+
                 default:
                     {
-                        await HandleNormalLaunchActionAsync(args.IsRedirectTo).ConfigureAwait(false);
+                        await HandleNormalLaunchActionAsync().ConfigureAwait(false);
                         break;
                     }
             }
         }
     }
 
-    private async ValueTask HandleNormalLaunchActionAsync(bool isRedirectTo)
+    private async ValueTask HandleNormalLaunchActionAsync()
     {
-        if (!isRedirectTo)
+        // Increase launch times
+        LocalSetting.Update(SettingKeys.LaunchTimes, 0, x => 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 (UnsafeLocalSetting.Get(SettingKeys.Major1Minor10Revision0GuideState, GuideState.Language) >= GuideState.StaticResourceBegin)
         {
-            // Increase launch times
+            if (StaticResource.IsAnyUnfulfilledCategoryPresent())
-            LocalSetting.Update(SettingKeys.LaunchTimes, 0, x => unchecked(x + 1));
-
-            // 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())
+                UnsafeLocalSetting.Set(SettingKeys.Major1Minor10Revision0GuideState, GuideState.StaticResourceBegin);
-                {
-                    UnsafeLocalSetting.Set(SettingKeys.Major1Minor10Revision0GuideState, GuideState.StaticResourceBegin);
-                }
-            }
-
-            if (UnsafeLocalSetting.Get(SettingKeys.Major1Minor10Revision0GuideState, GuideState.Language) < GuideState.Completed)
-            {
-                await taskContext.SwitchToMainThreadAsync();
-
-                GuideWindow guideWindow = serviceProvider.GetRequiredService<GuideWindow>();
-                currentWindowReference.Window = guideWindow;
-
-                guideWindow.SwitchTo();
-                guideWindow.BringToForeground();
-                return;
             }
         }
 
-        await WaitMainWindowOrCurrentAsync().ConfigureAwait(false);
+        if (UnsafeLocalSetting.Get(SettingKeys.Major1Minor10Revision0GuideState, GuideState.Language) < GuideState.Completed)
+        {
+            await taskContext.SwitchToMainThreadAsync();
+            serviceProvider.GetRequiredService<GuideWindow>();
+        }
+        else
+        {
+            await WaitMainWindowAsync().ConfigureAwait(false);
+        }
     }
 
-    private async ValueTask WaitMainWindowOrCurrentAsync()
+    private async ValueTask WaitMainWindowAsync()
     {
-        if (currentWindowReference.Window is { } window)
+        if (currentWindowReference.Window is not null)
         {
-            window.SwitchTo();
-            window.BringToForeground();
             return;
         }
 
         await taskContext.SwitchToMainThreadAsync();
 
-        MainWindow mainWindow = serviceProvider.GetRequiredService<MainWindow>();
+        serviceProvider.GetRequiredService<MainWindow>();
-        currentWindowReference.Window = mainWindow;
-
-        mainWindow.SwitchTo();
-        mainWindow.BringToForeground();
 
         await taskContext.SwitchToBackgroundAsync();
 
@@ -242,7 +158,10 @@ internal sealed partial class AppActivation : IAppActivation, IAppActivationActi
             hutaoUserServiceInitialization.InitializeInternalAsync().SafeForget();
         }
 
-        serviceProvider.GetRequiredService<IDiscordService>().SetNormalActivityAsync().SafeForget();
+        serviceProvider
+            .GetRequiredService<IDiscordService>()
+            .SetNormalActivityAsync()
+            .SafeForget();
     }
 
     private async ValueTask HandleUrlActivationAsync(Uri uri, bool isRedirectTo)
@@ -257,7 +176,7 @@ internal sealed partial class AppActivation : IAppActivation, IAppActivationActi
         {
             case CategoryAchievement:
                 {
-                    await WaitMainWindowOrCurrentAsync().ConfigureAwait(false);
+                    await WaitMainWindowAsync().ConfigureAwait(false);
                     await HandleAchievementActionAsync(action, parameter, isRedirectTo).ConfigureAwait(false);
                     break;
                 }
@@ -270,7 +189,7 @@ internal sealed partial class AppActivation : IAppActivation, IAppActivationActi
 
             default:
                 {
-                    await HandleNormalLaunchActionAsync(isRedirectTo).ConfigureAwait(false);
+                    await HandleNormalLaunchActionAsync().ConfigureAwait(false);
                     break;
                 }
         }
@@ -325,4 +244,34 @@ internal sealed partial class AppActivation : IAppActivation, IAppActivationActi
                 }
         }
     }
+
+    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/CurrentWindowReference.cs

@@ -5,19 +5,19 @@ using Microsoft.UI.Xaml;
 
 namespace Snap.Hutao.Core.LifeCycle;
 
-[Injection(InjectAs.Singleton, typeof(ICurrentXamlWindowReference))]
+[Injection(InjectAs.Singleton, typeof(ICurrentWindowReference))]
-internal sealed class CurrentXamlWindowReference : ICurrentXamlWindowReference
+internal sealed class CurrentWindowReference : ICurrentWindowReference
 {
     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/CurrentWindowReferenceExtension.cs

@@ -0,0 +1,24 @@
+// 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/CurrentXamlWindowReferenceExtension.cs

@@ -1,22 +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;
-
-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/HutaoActivationArguments.cs

@@ -1,7 +1,6 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
-using Microsoft.Extensions.Primitives;
 using Microsoft.Windows.AppLifecycle;
 
 namespace Snap.Hutao.Core.LifeCycle;
@@ -10,8 +9,6 @@ internal sealed class HutaoActivationArguments
 {
     public bool IsRedirectTo { get; set; }
 
-    public bool IsToastActivated { get; set; }
-
     public HutaoActivationKind Kind { get; set; }
 
     public Uri? ProtocolActivatedUri { get; set; }
@@ -33,15 +30,6 @@ internal sealed class HutaoActivationArguments
                     if (args.TryGetLaunchActivatedArguments(out string? arguments))
                     {
                         result.LaunchActivatedArguments = arguments;
-
-                        foreach (StringSegment segment in new StringTokenizer(arguments, [' ']))
-                        {
-                            if (segment.AsSpan().SequenceEqual("-ToastActivated"))
-                            {
-                                result.Kind = HutaoActivationKind.Toast;
-                                break;
-                            }
-                        }
                     }
 
                     break;

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

@@ -7,6 +7,5 @@ internal enum HutaoActivationKind
 {
     None,
     Launch,
-    Toast,
     Protocol,
 }

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

@@ -0,0 +1,14 @@
+// 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

@@ -1,16 +0,0 @@
-// 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/ICurrentWindowReference.cs

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

src/Snap.Hutao/Snap.Hutao/Core/LifeCycle/InterProcess/Model/ElevationStatusResponse.cs

@@ -1,14 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-namespace Snap.Hutao.Core.LifeCycle.InterProcess.Model;
-
-internal sealed class ElevationStatusResponse
-{
-    public ElevationStatusResponse(bool isElevated)
-    {
-        IsElevated = isElevated;
-    }
-
-    public bool IsElevated { get; set; }
-}

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

@@ -6,9 +6,6 @@ namespace Snap.Hutao.Core.LifeCycle.InterProcess;
 internal enum PipePacketCommand : byte
 {
     None = 0,
-    Exit = 1,
 
     RedirectActivation = 10,
-    RequestElevationStatus = 11,
-    ResponseElevationStatus = 12,
 }

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

@@ -8,5 +8,5 @@ internal enum PipePacketType : byte
     None = 0,
     Request = 1,
     Response = 2,
-    SessionTermination = 3,
+    Termination = 3,
 }

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

@@ -1,84 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Snap.Hutao.Core.ExceptionService;
-using System.Buffers;
-using System.IO.Hashing;
-using System.IO.Pipes;
-using System.Runtime.CompilerServices;
-
-namespace Snap.Hutao.Core.LifeCycle.InterProcess;
-
-internal static class PipeStreamExtension
-{
-    public static TData? ReadJsonContent<TData>(this PipeStream stream, ref readonly PipePacketHeader header)
-    {
-        using (IMemoryOwner<byte> memoryOwner = MemoryPool<byte>.Shared.Rent(header.ContentLength))
-        {
-            Span<byte> content = memoryOwner.Memory.Span[..header.ContentLength];
-            stream.ReadExactly(content);
-
-            HutaoException.ThrowIf(XxHash64.HashToUInt64(content) != header.Checksum, "PipePacket Content Hash incorrect");
-            return JsonSerializer.Deserialize<TData>(content);
-        }
-    }
-
-    public static unsafe void ReadPacket<TData>(this PipeStream stream, out PipePacketHeader header, out TData? data)
-        where TData : class
-    {
-        data = default;
-
-        stream.ReadPacket(out header);
-        if (header.ContentType is PipePacketContentType.Json)
-        {
-            data = stream.ReadJsonContent<TData>(in header);
-        }
-    }
-
-    [SkipLocalsInit]
-    public static unsafe void ReadPacket(this PipeStream stream, out PipePacketHeader header)
-    {
-        fixed (PipePacketHeader* pHeader = &header)
-        {
-            stream.ReadExactly(new(pHeader, sizeof(PipePacketHeader)));
-        }
-    }
-
-    public static unsafe void WritePacketWithJsonContent<TData>(this PipeStream stream, byte version, PipePacketType type, PipePacketCommand command, TData data)
-    {
-        PipePacketHeader header = default;
-        header.Version = version;
-        header.Type = type;
-        header.Command = command;
-        header.ContentType = PipePacketContentType.Json;
-
-        stream.WritePacket(ref header, JsonSerializer.SerializeToUtf8Bytes(data));
-    }
-
-    public static unsafe void WritePacket(this PipeStream stream, ref PipePacketHeader header, byte[] content)
-    {
-        header.ContentLength = content.Length;
-        header.Checksum = XxHash64.HashToUInt64(content);
-
-        stream.WritePacket(in header);
-        stream.Write(content);
-    }
-
-    public static unsafe void WritePacket(this PipeStream stream, byte version, PipePacketType type, PipePacketCommand command)
-    {
-        PipePacketHeader header = default;
-        header.Version = version;
-        header.Type = type;
-        header.Command = command;
-
-        stream.WritePacket(in header);
-    }
-
-    public static unsafe void WritePacket(this PipeStream stream, ref readonly PipePacketHeader header)
-    {
-        fixed (PipePacketHeader* pHeader = &header)
-        {
-            stream.Write(new(pHeader, sizeof(PipePacketHeader)));
-        }
-    }
-}

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

@@ -1,10 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-namespace Snap.Hutao.Core.LifeCycle.InterProcess;
-
-internal static class PrivateNamedPipe
-{
-    public const int Version = 1;
-    public const string Name = "Snap.Hutao.PrivateNamedPipe";
-}

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

@@ -2,39 +2,45 @@
 // Licensed under the MIT license.
 
 using Microsoft.Windows.AppLifecycle;
-using Snap.Hutao.Core.LifeCycle.InterProcess.Model;
+using System.IO.Hashing;
 using System.IO.Pipes;
 
 namespace Snap.Hutao.Core.LifeCycle.InterProcess;
 
 [Injection(InjectAs.Singleton)]
-[ConstructorGenerated]
+internal sealed class PrivateNamedPipeClient : IDisposable
-internal sealed partial class PrivateNamedPipeClient : IDisposable
 {
-    private readonly NamedPipeClientStream clientStream = new(".", PrivateNamedPipe.Name, PipeDirection.InOut, PipeOptions.Asynchronous | PipeOptions.WriteThrough);
+    private readonly NamedPipeClientStream clientStream = new(".", "Snap.Hutao.PrivateNamedPipe", PipeDirection.InOut, PipeOptions.Asynchronous | PipeOptions.WriteThrough);
-    private readonly RuntimeOptions runtimeOptions;
 
     public unsafe bool TryRedirectActivationTo(AppActivationArguments args)
     {
         if (clientStream.TryConnectOnce())
         {
-            clientStream.WritePacket(PrivateNamedPipe.Version, PipePacketType.Request, PipePacketCommand.RequestElevationStatus);
-            clientStream.ReadPacket(out PipePacketHeader header, out ElevationStatusResponse? response);
-            ArgumentNullException.ThrowIfNull(response);
-
-            // Prefer elevated instance
-            if (runtimeOptions.IsElevated && !response.IsElevated)
             {
-                // Notify previous instance to exit
+                PipePacketHeader redirectActivationPacket = default;
-                clientStream.WritePacket(PrivateNamedPipe.Version, PipePacketType.SessionTermination, PipePacketCommand.Exit);
+                redirectActivationPacket.Version = 1;
-                clientStream.Flush();
+                redirectActivationPacket.Type = PipePacketType.Request;
-                return false;
+                redirectActivationPacket.Command = PipePacketCommand.RedirectActivation;
+                redirectActivationPacket.ContentType = PipePacketContentType.Json;
+
+                HutaoActivationArguments hutaoArgs = HutaoActivationArguments.FromAppActivationArguments(args, isRedirected: true);
+                byte[] jsonBytes = JsonSerializer.SerializeToUtf8Bytes(hutaoArgs);
+
+                redirectActivationPacket.ContentLength = jsonBytes.Length;
+                redirectActivationPacket.Checksum = XxHash64.HashToUInt64(jsonBytes);
+
+                clientStream.Write(new(&redirectActivationPacket, sizeof(PipePacketHeader)));
+                clientStream.Write(jsonBytes);
+            }
+
+            {
+                PipePacketHeader terminationPacket = default;
+                terminationPacket.Version = 1;
+                terminationPacket.Type = PipePacketType.Termination;
+
+                clientStream.Write(new(&terminationPacket, sizeof(PipePacketHeader)));
             }
 
-            // Redirect to previous instance
-            HutaoActivationArguments hutaoArgs = HutaoActivationArguments.FromAppActivationArguments(args, isRedirected: true);
-            clientStream.WritePacketWithJsonContent(PrivateNamedPipe.Version, PipePacketType.Request, PipePacketCommand.RedirectActivation, hutaoArgs);
-            clientStream.WritePacket(PrivateNamedPipe.Version, PipePacketType.SessionTermination, PipePacketCommand.None);
             clientStream.Flush();
             return true;
         }

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

@@ -16,13 +16,6 @@ internal sealed partial class PrivateNamedPipeMessageDispatcher
             return;
         }
 
-        serviceProvider.GetRequiredService<IAppActivation>().Activate(args);
+        serviceProvider.GetRequiredService<IActivation>().Activate(args);
-    }
-
-    public void ExitApplication()
-    {
-        ITaskContext taskContext = serviceProvider.GetRequiredService<ITaskContext>();
-        App app = serviceProvider.GetRequiredService<App>();
-        taskContext.BeginInvokeOnMainThread(app.Exit);
     }
 }

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

@@ -1,50 +1,22 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
-using Snap.Hutao.Core.LifeCycle.InterProcess.Model;
+using Snap.Hutao.Core.ExceptionService;
+using System.IO.Hashing;
 using System.IO.Pipes;
-using System.Security.AccessControl;
-using System.Security.Principal;
 
 namespace Snap.Hutao.Core.LifeCycle.InterProcess;
 
 [Injection(InjectAs.Singleton)]
+[ConstructorGenerated]
 internal sealed partial class PrivateNamedPipeServer : IDisposable
 {
     private readonly PrivateNamedPipeMessageDispatcher messageDispatcher;
-    private readonly RuntimeOptions runtimeOptions;
 
+    private readonly NamedPipeServerStream serverStream = new("Snap.Hutao.PrivateNamedPipe", PipeDirection.InOut, NamedPipeServerStream.MaxAllowedServerInstances, PipeTransmissionMode.Byte, PipeOptions.Asynchronous | PipeOptions.WriteThrough);
     private readonly CancellationTokenSource serverTokenSource = new();
     private readonly SemaphoreSlim serverSemaphore = new(1);
 
-    private readonly NamedPipeServerStream serverStream;
-
-    public PrivateNamedPipeServer(IServiceProvider serviceProvider)
-    {
-        messageDispatcher = serviceProvider.GetRequiredService<PrivateNamedPipeMessageDispatcher>();
-        runtimeOptions = serviceProvider.GetRequiredService<RuntimeOptions>();
-
-        PipeSecurity? pipeSecurity = default;
-
-        if (runtimeOptions.IsElevated)
-        {
-            SecurityIdentifier everyOne = new(WellKnownSidType.WorldSid, null);
-
-            pipeSecurity = new();
-            pipeSecurity.AddAccessRule(new PipeAccessRule(everyOne, PipeAccessRights.FullControl, AccessControlType.Allow));
-        }
-
-        serverStream = NamedPipeServerStreamAcl.Create(
-            PrivateNamedPipe.Name,
-            PipeDirection.InOut,
-            NamedPipeServerStream.MaxAllowedServerInstances,
-            PipeTransmissionMode.Byte,
-            PipeOptions.Asynchronous | PipeOptions.WriteThrough,
-            0,
-            0,
-            pipeSecurity);
-    }
-
     public void Dispose()
     {
         serverTokenSource.Cancel();
@@ -73,30 +45,36 @@ internal sealed partial class PrivateNamedPipeServer : IDisposable
         }
     }
 
+    private static unsafe byte[] GetValidatedContent(NamedPipeServerStream serverStream, PipePacketHeader* header)
+    {
+        byte[] content = new byte[header->ContentLength];
+        serverStream.ReadAtLeast(content, header->ContentLength, false);
+        HutaoException.ThrowIf(XxHash64.HashToUInt64(content) != header->Checksum, "PipePacket Content Hash incorrect");
+        return content;
+    }
+
     private unsafe void RunPacketSession(NamedPipeServerStream serverStream, CancellationToken token)
     {
-        while (serverStream.IsConnected && !token.IsCancellationRequested)
+        Span<byte> headerSpan = stackalloc byte[sizeof(PipePacketHeader)];
+        bool sessionTerminated = false;
+        while (serverStream.IsConnected && !sessionTerminated && !token.IsCancellationRequested)
         {
-            serverStream.ReadPacket(out PipePacketHeader header);
+            serverStream.ReadExactly(headerSpan);
-            switch ((header.Type, header.Command))
+            fixed (byte* pHeader = headerSpan)
             {
-                case (PipePacketType.Request, PipePacketCommand.RequestElevationStatus):
+                PipePacketHeader* header = (PipePacketHeader*)pHeader;
-                    ElevationStatusResponse resp = new(runtimeOptions.IsElevated);
-                    serverStream.WritePacketWithJsonContent(PrivateNamedPipe.Version, PipePacketType.Response, PipePacketCommand.ResponseElevationStatus, resp);
-                    serverStream.Flush();
-                    break;
-                case (PipePacketType.Request, PipePacketCommand.RedirectActivation):
-                    HutaoActivationArguments? hutaoArgs = serverStream.ReadJsonContent<HutaoActivationArguments>(in header);
-                    messageDispatcher.RedirectActivation(hutaoArgs);
-                    break;
-                case (PipePacketType.SessionTermination, _):
-                    serverStream.Disconnect();
-                    if (header.Command is PipePacketCommand.Exit)
-                    {
-                        messageDispatcher.ExitApplication();
-                    }
 
-                    return;
+                switch ((header->Type, header->Command, header->ContentType))
+                {
+                    case (PipePacketType.Request, PipePacketCommand.RedirectActivation, PipePacketContentType.Json):
+                        ReadOnlySpan<byte> content = GetValidatedContent(serverStream, header);
+                        messageDispatcher.RedirectActivation(JsonSerializer.Deserialize<HutaoActivationArguments>(content));
+                        break;
+                    case (PipePacketType.Termination, _, _):
+                        serverStream.Disconnect();
+                        sessionTerminated = true;
+                        return;
+                }
             }
         }
     }

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

@@ -10,18 +10,11 @@ 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, DebugModeEnabled))
+        if (LocalSetting.Get(SettingKeys.IsAllocConsoleDebugModeEnabled, false))
         {
             consoleWindowAllocated = AllocConsole();
             if (consoleWindowAllocated)

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

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

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

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

src/Snap.Hutao/Snap.Hutao/Core/RuntimeOptionsExtension.cs

@@ -27,11 +27,4 @@ internal static class RuntimeOptionsExtension
         Directory.CreateDirectory(directory);
         return directory;
     }
-
-    public static string GetLocalCacheImageCacheFolder(this RuntimeOptions options)
-    {
-        string directory = Path.Combine(options.LocalCache, "ImageCache");
-        Directory.CreateDirectory(directory);
-        return directory;
-    }
 }

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

@@ -12,13 +12,8 @@ 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

@@ -3,7 +3,14 @@
 
 namespace Snap.Hutao.Core.Shell;
 
+/// <summary>
+/// 跳转列表交互
+/// </summary>
 internal interface IJumpListInterop
 {
-    ValueTask ClearAsync();
+    /// <summary>
+    /// 异步配置跳转列表
+    /// </summary>
+    /// <returns>任务</returns>
+    ValueTask ConfigureAsync();
 }

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

@@ -8,9 +8,20 @@ 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,14 +1,23 @@
 // 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
 {
-    public async ValueTask ClearAsync()
+    /// <summary>
+    /// 异步配置跳转列表
+    /// </summary>
+    /// <returns>任务</returns>
+    public async ValueTask ConfigureAsync()
     {
         if (JumpList.IsSupported())
         {
@@ -16,6 +25,11 @@ internal sealed class JumpListInterop : IJumpListInterop
 
             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,7 +2,9 @@
 // Licensed under the MIT license.
 
 using Microsoft.Win32.TaskScheduler;
+using System.IO;
 using System.Runtime.InteropServices;
+using Windows.Storage;
 
 namespace Snap.Hutao.Core.Shell;
 
@@ -14,6 +16,60 @@ 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>
     /// 卸载全部注册的任务
@@ -35,4 +91,25 @@ 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

@@ -54,7 +54,7 @@ internal sealed partial class ShellLinkInterop : IShellLinkInterop
             pShellLink->SetShowCmd(SHOW_WINDOW_CMD.SW_NORMAL);
             pShellLink->SetIconLocation(targetLogoPath, 0);
 
-            if (SUCCEEDED(IUnknownMarshal.QueryInterface(pShellLink, in IPersistFile.IID, out IPersistFile* pPersistFile)))
+            if (SUCCEEDED(pShellLink->QueryInterface(in IPersistFile.IID, out IPersistFile* pPersistFile)))
             {
                 string desktop = Environment.GetFolderPath(Environment.SpecialFolder.Desktop);
                 string target = Path.Combine(desktop, $"{SH.FormatAppNameAndVersion(runtimeOptions.Version)}.lnk");
@@ -64,10 +64,10 @@ internal sealed partial class ShellLinkInterop : IShellLinkInterop
                     result = true;
                 }
 
-                IUnknownMarshal.Release(pPersistFile);
+                pPersistFile->Release();
             }
 
-            IUnknownMarshal.Release(pShellLink);
+            pShellLink->Release();
         }
 
         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)
     {
-        ArgumentOutOfRangeException.ThrowIfLessThan(participants, 1, "Participants of AsyncBarrier can not be less than 1");
+        Must.Range(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)
         {
-            HutaoException.OperationCanceled(SH.CoreThreadingSemaphoreSlimDisposed, ex);
+            ThrowHelper.OperationCanceled(SH.CoreThreadingSemaphoreSlimDisposed, ex);
         }
 
         return new SemaphoreSlimToken(semaphoreSlim);
@@ -29,7 +29,7 @@ internal static class SemaphoreSlimExtension
         }
         catch (ObjectDisposedException ex)
         {
-            HutaoException.OperationCanceled(SH.CoreThreadingSemaphoreSlimDisposed, ex);
+            ThrowHelper.OperationCanceled(SH.CoreThreadingSemaphoreSlimDisposed, ex);
         }
 
         return new SemaphoreSlimToken(semaphoreSlim);

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

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

src/Snap.Hutao/Snap.Hutao/Core/TypeNameHelper.cs

@@ -103,7 +103,7 @@ internal static class TypeNameHelper
 
             if (builder is null)
             {
-                if (options.NestedTypeDelimiter is not DefaultNestedTypeDelimiter)
+                if (options.NestedTypeDelimiter != DefaultNestedTypeDelimiter)
                 {
                     return name.Replace(DefaultNestedTypeDelimiter, options.NestedTypeDelimiter);
                 }
@@ -112,7 +112,7 @@ internal static class TypeNameHelper
             }
 
             builder.Append(name);
-            if (options.NestedTypeDelimiter is not DefaultNestedTypeDelimiter)
+            if (options.NestedTypeDelimiter != DefaultNestedTypeDelimiter)
             {
                 builder.Replace(DefaultNestedTypeDelimiter, options.NestedTypeDelimiter, builder.Length - name.Length, name.Length);
             }

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

@@ -0,0 +1,56 @@
+// 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);
+    }
+}