1.7.13 package

.config/dotnet-tools.json

@@ -1,12 +0,0 @@
-{
-  "version": 1,
-  "isRoot": true,
-  "tools": {
-    "cake.tool": {
-      "version": "4.0.0",
-      "commands": [
-        "dotnet-cake"
-      ]
-    }
-  }
-}

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

@@ -18,28 +18,28 @@ body:
       options:
         - label: 我已阅读 Snap Hutao 文档中的[常见问题](https://hut.ao/advanced/FAQ.html)和[常见程序异常](https://hut.ao/advanced/exceptions.html)，我的问题没有在文档中得到解答
           required: true
-
+          
         - label: 我知道文档站的导航栏中有**搜索功能**，且已经搜索过相关关键词
           required: true
 
-        - label: 我的问题不是[已完成](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aopen+is%3Aissue+label%3A%E5%B7%B2%E5%AE%8C%E6%88%90)的问题也不是一个别人已发布的**重复的**问题
+        - label: 我的问题不是[已修复](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aopen+is%3Aissue+label%3A%E5%B7%B2%E4%BF%AE%E5%A4%8D)的问题也不是一个别人已发布的**重复的**问题
           required: true
 
   - type: input
     id: winver
     attributes:
       label: Windows 版本
-      description: |
+      description: | 
         `Win+R` 输入 `winver` 回车后在打开的窗口第二行可以找到
       placeholder: 例：22000.556
     validations:
       required: true
-
+   
   - type: input
     id: shver
     attributes:
       label: Snap Hutao 版本
-      description: 在应用标题，应用程序的反馈中心界面中可以找到
+      description: 在应用标题，应用程序的设置界面中靠下的位置可以找到
       placeholder: 例：1.4.15.0
     validations:
       required: true
@@ -48,10 +48,10 @@ body:
     id: deviceid
     attributes:
       label: 设备 ID
-      description: |
-        在胡桃工具箱的反馈中心界面，你可以找到并复制你的设备 ID
+      description: | 
+        在胡桃工具箱的设置界面，你可以找到并复制你的设备 ID
         如果你的问题涉及程序崩溃，请填写该项，这将有助于我们定位问题
-        如果你的程序已经无法启动，请下载并运行[诊断工具](https://github.com/DGP-Automation/ISSUE_TEMPLATES/releases/download/diagnosis_tools/Snap.Hutao.Diagnostic.Tooling.exe)，它将显示你的设备 ID
+        如果你的程序已经无法启动，请下载并运行[此PowerShell脚本](https://github.com/DGP-Studio/ISSUE_TEMPLATES/releases/download/get_device_id/GetHutaoDeviceId.ps1)，它将显示你的设备 ID
     validations:
       required: false
 
@@ -79,15 +79,13 @@ body:
         - 公告
         - 其它
     validations:
-      required: true
+      required: true   
 
   - type: textarea
     id: what-happened
     attributes:
       label: 发生了什么？
-      description: |
-        详细的描述问题发生前后的行为，以便我们解决问题。**如果你的问题涉及程序崩溃，你应当检查 Windows 事件查看器，并将相关的 `.Net 错误`详情附上**
-        如果你无法找到该日志，请下载并运行[诊断工具](https://github.com/DGP-Automation/ISSUE_TEMPLATES/releases/download/diagnosis_tools/Snap.Hutao.DiagTools.exe)，它将转储问题日志至工具运行目录中的 `Snap.Hutao Error Log.txt`
+      description: 详细的描述问题发生前后的行为，以便我们解决问题。**如果你的问题涉及程序崩溃，你应当检查 Windows 事件查看器，并将相关的 `.Net 错误`详情附上**
     validations:
       required: true
 
@@ -107,3 +105,4 @@ body:
       options:
         - label: 我认为上述的描述已经足以详细，以允许开发人员能复现该问题
           required: true
+      

.github/ISSUE_TEMPLATE/CHS-feature-request.yml

@@ -1,7 +1,7 @@
 name: 功能请求 
 description: 通过这个议题来向开发团队分享你的想法
 title: "[Feat]: 在这里填写一个合适的标题"
-labels: ["功能", "needs-triage", "priority:none"]
+labels: ["功能", "priority:none"]
 assignees:
   - Lightczx
 body:

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

@@ -18,23 +18,23 @@ body:
       options:
         - label: I have read [FAQ page](https://hut.ao/advanced/FAQ.html) and [Exception page](https://hut.ao/advanced/exceptions.html) in Snap Hutao document, and my issue is not answered
           required: true
-
+          
         - label: I and tried **search feature** in Snap Hutao document site, and no associated article
           required: true
 
-        - label: My issue is not a [finished issue](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aopen+is%3Aissue+label%3A%E5%B7%B2%E5%AE%8C%E6%88%90), and it's not a duplicated issue
+        - label: My issue is not a [fixed issue](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aopen+is%3Aissue+label%3A%E5%B7%B2%E4%BF%AE%E5%A4%8D), and it's not a duplicated issue
           required: true
 
   - type: input
     id: winver
     attributes:
       label: Windows Version
-      description: |
+      description: | 
         Use `Win+R` and input `winver`, Windows build version is usually at the second line
       placeholder: e.g. 22000.556
     validations:
       required: true
-
+   
   - type: input
     id: shver
     attributes:
@@ -48,10 +48,10 @@ body:
     id: deviceid
     attributes:
       label: Device ID
-      description: |
-        In Snap Hutao's Feedback Center, you can find and copy your device ID
+      description: | 
+        In Snap Hutao's settings page, you can find and copy your device ID
         If your issue is about program crash, please fill this so we can dump the log and locate the source easier
-        If your program cannot startup, please download and run [Diagnostic Tooling](https://github.com/DGP-Automation/ISSUE_TEMPLATES/releases/download/diagnosis_tools/Snap.Hutao.Diagnostic.Tooling.exe), it will shows your device ID.
+        If your program cannot startup, please download and run [this PowerShell script](https://github.com/DGP-Studio/ISSUE_TEMPLATES/releases/download/get_device_id/GetHutaoDeviceId.ps1), it will shows your device ID.
     validations:
       required: false
 
@@ -74,20 +74,18 @@ body:
         - User Interface
         - Snap Hutao Cloud
         - Snap Hutao Account
-        - Checkin
+        - Checkin        
         - Wiki
         - Announcement
         - Other
     validations:
-      required: true
+      required: true   
 
   - type: textarea
     id: what-happened
     attributes:
       label: What Happened?
-      description: |
-        Describe your issue in detail to help us identify the issue. **If your issue is about program crash, you should check Windows Event Viewer, and attach associated `.Net Error` details here**If your program cannot startup, please download and run [this PowerShell script](https://github.com/DGP-Studio/ISSUE_TEMPLATES/releases/download/get_device_id/GetHutaoDeviceId.ps1), it will shows your device ID.
-        If you cannot find it, please download and run [Diagnosis Tool](https://github.com/DGP-Automation/ISSUE_TEMPLATES/releases/download/diagnosis_tools/Snap.Hutao.DiagTools.exe), it will dump the error log to `Snap.Hutao Error Log.txt` in the working directory of the tool.
+      description: Describe your issue in detail to help us identify the issue. **If your issue is about program crash, you should check Windows Event Viewer, and attach associated `.Net Error` details here**
     validations:
       required: true
 
@@ -107,3 +105,4 @@ body:
       options:
         - label: I believe the description above is detail enough to allow developers to reproduce the issue
           required: true
+      

.github/ISSUE_TEMPLATE/ENG-feature-request.yml

@@ -1,7 +1,7 @@
 name: Feature Request [English Form]
 description: Tell us about your thought
 title: "[Feat]: Place your title here"
-labels: ["功能", "needs-triage", "priority:none"]
+labels: ["功能", "priority:none"]
 assignees:
   - Lightczx
 body:

.github/ISSUE_TEMPLATE/MGMT-publish.yml

@@ -1,37 +0,0 @@
-name: Publish Process
-description: FOR ADMIN USE ONLY. WILL CAUSE A BAN IF NO PERMISSION.
-title: "[Publish]: Version 1.9.98"
-labels: ["Publish"]
-assignees:
-  - Lightczx
-body:
-- type: textarea
-  id: main-body
-  attributes:
-    label: Publish Process
-    value: |
-
-      ## 创建版本
-
-      - [ ]  同步一次 [Crowdin](https://crowdin.com/project/snap-hutao) 翻译
-      - [ ]  发布 RC 版本（Optional）
-      - [ ]  合并入主分支
-      - [ ]  整理更新内容，等待翻译
-      - [ ]  在 [Snap.Hutao.Docs@next-patch](https://github.com/DGP-Studio/Snap.Hutao.Docs/tree/next-patch) 分支更新文档并直接开 PR
-          - [ ]  更新日志
-          - [ ]  功能文档更新
-
-       ***
-
-      - [ ] 主分支合并入 release 分支
-      - [ ] 等待 Release 自动发布
-      - [ ] 检查极狐是否同步完成 Release
-      - [ ] 通知用户
-- type: checkboxes
-  id: checklist-final
-  attributes:
-    label: Final Check
-    description: Understand what you are doing
-    options:
-      - label: I understand that I will get banned from repository if I don't have permission to use this template
-        required: true

.github/dependabot.yml

@@ -13,8 +13,4 @@ updates:
     groups:
       packages:
         patterns:
-          - "*"
-  - package-ecosystem: "github-actions"
-    directory: "/.github/workflows" # GitHub Workflows
-    schedule:
-      interval: "weekly"
+          - "*"

.github/workflows/PublishDistribution.yml

@@ -12,9 +12,40 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
+      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
+      - name: Checkout Repo
+        uses: actions/checkout@v3
+        
+      # Download Assets
+      - name: Download Release
+        timeout-minutes: 5
+        uses: robinraju/release-downloader@v1.7
+        with: 
+          repository: "DGP-Studio/Snap.Hutao"
+          latest: true
+          fileName: "*.msix"
+          out-file-path: ./release-download
+          
+      # Upload to Drive
+      - name: Upload Drive
+        timeout-minutes: 15
+        env:
+          RCCONF: ${{ secrets.RCCONF }}
+        run: |
+          curl https://rclone.org/install.sh | sudo bash
+          mkdir -p ~/.config/rclone/
+          cat << EOF > ~/.config/rclone/rclone.conf
+          $RCCONF
+          EOF
+          
+          rclone copy ./release-download/* dgpODCN:/releases/
+
       # Purge Patch System Cache
       - name: Purge Patch
         env:
+          PATCH_HOSTS: ${{ secrets.PATCH_HOSTS }}
+          PURGE_TOKEN: ${{ secrets.PURGE_TOKEN }}
           PURGE_URL: ${{ secrets.PURGE_URL }}
         run: |
-          curl -X PATCH $PURGE_URL
+          sudo echo "$PATCH_HOSTS" | sudo tee -a /etc/hosts
+          curl --header "Authorization: token $PURGE_TOKEN" $PURGE_URL

.github/workflows/alpha.yml

@@ -1,79 +0,0 @@
-name: Snap Hutao Alpha
-on:
-  workflow_dispatch:
-  push:
-    branches:
-      - main
-      - develop
-    paths-ignore:
-      - '.gitattributes'
-      - '.github/**'
-      - '.gitignore'
-      - '.gitmodules'
-      - '**.md'
-      - 'LICENSE'
-      - '**.yml'
-  pull_request:
-    branches:
-      - develop
-    paths-ignore:
-      - '.gitattributes'
-      - '.github/**'
-      - '.gitignore'
-      - '.gitmodules'
-      - '**.md'
-      - 'LICENSE'
-      - '**.yml'
-      - '**.resx'
-
-jobs:
-  build:
-    runs-on: self-hosted
-    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 }}
-
-      - 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'
-        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

@@ -1,16 +0,0 @@
-name: 'Close stale issues and PRs'
-on:
-  schedule:
-    - cron: '30 1 * * *'
-
-jobs:
-  stale:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/stale@v9
-        with:
-          any-of-labels: 'needs-more-info,需要更多信息'
-          stale-issue-message: 'This issue is stale because it has been open 30 days with no activity. Remove stale label or comment or this will be closed in 3 days.'
-          days-before-stale: 7
-          days-before-close: 3
-          close-issue-reason: not_planned

.github/workflows/issue_similarity.yml

@@ -1,20 +0,0 @@
-name: Issues Similarity Analysis
-
-on:
-  issues:
-    types: [opened, edited]
-
-jobs:
-  similarity-analysis:
-    runs-on: ubuntu-latest
-    steps:
-      - name: analysis
-        uses: actions-cool/issues-similarity-analysis@v1
-        with:
-          filter-threshold: 0.5
-          comment-title: '### Probable Similar Topics'
-          title-excludes: '[Publish]:,[Bug]:,[Feat]:,[Network]:,[ENG]'
-          comment-body: '${index}. ${similarity} #${number}'
-          show-footer: false
-          show-mentioned: true
-          since-days: 365

.github/workflows/lock_closed_issues.yml

@@ -1,26 +0,0 @@
-name: 'Lock Threads'
-
-on:
-  schedule:
-    - cron: '0 0 * * *'
-  workflow_dispatch:
-
-permissions:
-  issues: write
-  pull-requests: write
-  discussions: write
-
-concurrency:
-  group: lock-threads
-
-jobs:
-  action:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: dessant/lock-threads@v5
-        with:
-          issue-inactive-days: '30'
-          issue-comment: 'This issue has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related topic.'
-          issue-lock-reason: 'resolved'
-          process-only: 'issues'
-          log-output: false

.gitignore

@@ -1,6 +1,7 @@
 desktop.ini
 
 *.csproj.user
+*.pubxml
 *.DotSettings.user
 
 .vs/
@@ -15,7 +16,8 @@ src/Snap.Hutao/Snap.Hutao/Snap.Hutao_TemporaryKey.pfx
 src/Snap.Hutao/Snap.Hutao.Win32/bin/
 src/Snap.Hutao/Snap.Hutao.Win32/obj/
 
-src/Snap.Hutao/Snap.Hutao.Test/bin/
-src/Snap.Hutao/Snap.Hutao.Test/obj/
+src/Snap.Hutao/Snap.Hutao.SourceGeneration/bin/
+src/Snap.Hutao/Snap.Hutao.SourceGeneration/obj/
 
-src/Snap.Hutao/Snap.Hutao/Properties/PublishProfiles/FolderProfile.pubxml.user
+src/Snap.Hutao/Snap.Hutao.Test/bin/
+src/Snap.Hutao/Snap.Hutao.Test/obj/

.gitlab-ci.yml

@@ -1,77 +0,0 @@
-stages:
-  - fetch
-  - release
-  - refresh
-
-Fetch:
-  stage: fetch
-  rules:
-    - if: $CI_COMMIT_TAG
-  tags:
-    - us3
-  script:
-    - apt-get update -qy
-    - apt-get install -y curl jq
-    - RELEASE_INFO=$(curl -sSL "https://api.github.com/repos/$CI_PROJECT_PATH/releases/latest")
-    - ASSET_URL=$(echo "$RELEASE_INFO" | jq -r '.assets[] | select(.name | endswith(".msix")) | .browser_download_url')
-    - SHA256SUMS_URL=$(echo "$RELEASE_INFO" | jq -r '.assets[] | select(.name == "SHA256SUMS") | .browser_download_url')
-    - curl -LJO "$ASSET_URL"
-    - curl -LJO "$SHA256SUMS_URL"
-    - FILE_NAME=$(basename "$ASSET_URL")
-    - SHA256SUMS_NAME=$(basename "$SHA256SUMS_URL")
-    - echo "File name at script stage is $FILE_NAME"
-    - echo "SHA256SUMS name at script stage is $SHA256SUMS_NAME"
-    - echo "THIS_FILE_NAME=$FILE_NAME" >> next.env
-    - echo "THIS_SHA256SUMS_NAME=$SHA256SUMS_NAME" >> next.env
-  after_script:
-    - echo "Current Job ID is $CI_JOB_ID"
-    - echo "THIS_JOB_ID=$CI_JOB_ID" >> next.env
-  artifacts:
-    paths:
-      - "*.msix"
-      - "SHA256SUMS"
-    expire_in: 180 days
-    reports:
-      dotenv: next.env
-
-release:
-  stage: release
-  image: registry.gitlab.com/gitlab-org/release-cli:latest
-  rules:
-    - if: $CI_COMMIT_TAG
-  needs:
-    - job: Fetch
-      artifacts: true
-  variables:
-    TAG: '$CI_COMMIT_TAG'
-  script:
-    - echo "Create Release $TAG"
-    - echo "$THIS_JOB_ID"
-    - echo "$THIS_FILE_NAME"
-  release:
-    name: '$TAG'
-    tag_name: '$TAG'
-    ref: '$TAG'
-    description: 'Release $TAG by CI'
-    assets:
-      links:
-        - name: "$THIS_FILE_NAME"
-          url: "https://$CI_SERVER_SHELL_SSH_HOST/$CI_PROJECT_PATH/-/jobs/$THIS_JOB_ID/artifacts/raw/$THIS_FILE_NAME?inline=false"
-          link_type: package
-        - name: "$THIS_SHA256SUMS_NAME"
-          url: "https://$CI_SERVER_SHELL_SSH_HOST/$CI_PROJECT_PATH/-/jobs/$THIS_JOB_ID/artifacts/raw/$THIS_SHA256SUMS_NAME?inline=false"
-          link_type: other
-        - name: "artifact_archive"
-          url: "https://$CI_SERVER_SHELL_SSH_HOST/$CI_PROJECT_PATH/-/jobs/$THIS_JOB_ID/artifacts/download?file_type=archive"
-          link_type: other
-          
-Refresh:
-  stage: refresh
-  rules:
-    - if: $CI_COMMIT_TAG
-  needs:
-    - job: release
-  script:
-    - apt-get install -y curl
-    - curl -X PATCH "$PURGE_URL"
-    - curl -X POST -o /dev/null "$UPLOAD_OSS_URL"

CONTRIBUTING.md

@@ -4,15 +4,13 @@
 
 ### Setup Snap.Hutao Project
 
-1. Download and install [Visual Studio 2022 Community](https://visualstudio.microsoft.com/downloads/).
-   - No need to select workloads; Visual Studio will handle it automatically.
-   - Close Visual Studio Installer to ensure a smooth installation experience for workloads.
-   - If using Visual Studio 2022 17.9 preview, skip step 5, as automatic extension installation is supported in this version.
-2. Use git to clone the project `https://github.com/DGP-Studio/Snap.Hutao.git` to your local device.
-3. Switch to the`develop` branch using git.
-4. Open the project solution with your Visual Studio. Visual Studio will prompt you to install the necessary workloads, closing and reopening automatically.
-5. (For Visual Studio 2022 17.8) Install the [Single-project MSIX Packaging Tools for VS 2022](https://marketplace.visualstudio.com/items?itemName=ProjectReunion.MicrosoftSingleProjectMSIXPackagingToolsDev17) provided by Microsoft in Visual Studio marketplace.
-6. Open the project solution with your Visual Studio, and you are ready to go.
+1. Download and install [Visual Studio 2022 Community](https://visualstudio.microsoft.com/downloads/)
+2. Open Visual Studio Installer to complete Visual Studio installation
+   - You need to install `.NET desktop development`, `Desktop development with C++` and `Universal Windows Platform development` components
+3. Install `Single-project MSIX Packaging Tools for VS 2022` provided by Microsoft in Visual Studio marketplace
+4. Use git to clone the project `https://github.com/DGP-Studio/Snap.Hutao.git` to your local device 
+5. Switch git branch to `develop`
+6. Open project solution with your Visual Studio and then you are ready to go
 
 ### Start Pull Request
 

README.md

@@ -1,5 +1,4 @@
-![HutaoRepoBanner2-20231222](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/2d178de1-95bc-44a1-a95e-20c5f11a8628)
-
+![](res/HutaoRepoBanner2.png)
 
 胡桃工具箱是一款以 MIT 协议开源的原神工具箱，专为现代化 Windows 平台设计，旨在改善桌面端玩家的游戏体验。通过将既有的官方资源与开发团队设计的全新 功能相结合，它提供了一套完整且实用的工具集，且无需依赖任何移动设备。它不对游戏客户端进行任何破坏性修改以确保工具箱的安全性
 
@@ -7,29 +6,7 @@ Snap Hutao is an open-source Genshin Impact toolkit under MIT license, designed
 
 ## 下载使用 / Download
 
-![](https://ci.appveyor.com/api/projects/status/n4s40t9llru4si9y?svg=true) [![GitHub Release](https://img.shields.io/github/release/DGP-Studio/Snap.Hutao?style=flat)](https://github.com/DGP-Studio/Snap.Hutao/releases/latest) [![Github All Releases](https://img.shields.io/github/downloads/DGP-Studio/Snap.Hutao/total.svg?style=flat)]() 
-
----
-
-#### 使用安装器安装 / Install with Snap.Hutao.Depolyment Installer
-
-Snap.Hutao.Depolyment 是一个由 DGP-Studio 重新包装的 Windows 应用安装器，适用于缺少专业计算机知识的一般用户，可以在安装时同时解决缺少必要系统环境的问题。
-
-Snap.Hutao.Depolyment is a Windows application installer repackaged by DGP-Studio for the users who lacks computer knowledge and can solve the problem of missing necessary system environment at the same time as the installation.
-
-[从 GitHub 发布页获取 / Download from GitHub release](https://github.com/DGP-Studio/Snap.Hutao.Deployment/releases/latest) 
-
-[从极狐Lab 发布页获取 / Download from Jihu Gitlab release](https://jihulab.com/DGP-Studio/Snap.Hutao.Deployment/-/releases)
-
-#### 使用 MSIX 包安装 / Install with MSIX Package
-
-直接使用 Snap Hutao MSIX 安装包，使用 Windows 内置的 App Installer 即可安装。如在安装中出现问题，请查阅我们的[常见问题](https://hut.ao/zh/advanced/FAQ.html)文档
-
-Install with Snap Hutao MSIX package, can be installed with Windows built-in App Installer. If you faced any issue, please check our [FAQ](https://hut.ao/en/advanced/FAQ.html) document.
-
-[从 GitHub 发布页获取 / Download from GitHub release](https://github.com/DGP-Studio/Snap.Hutao/releases/latest) 
-
-[从极狐Lab 发布页获取 / Download from Jihu Gitlab release](https://jihulab.com/DGP-Studio/Snap.Hutao/-/releases)
+[<img src="https://get.microsoft.com/images/zh-cn%20light.svg"  width="30%" height="30%">](https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52)
 
 ## 贡献 / Contribute
 
@@ -44,7 +21,9 @@ Install with Snap Hutao MSIX package, can be installed with Windows built-in App
 
 ### 特定的原神项目 / Specific Genshin-related Projects
 
-* [Scighost/Starward](https://github.com/Scighost/Starward)
+* [biuuu/genshin-wish-export](https://github.com/biuuu/genshin-wish-export)
+* [xunkong/xunkong](https://github.com/xunkong/xunkong)
+* [YuehaiTeam/cocogoat](https://github.com/YuehaiTeam/cocogoat)
 
 ### 使用的技术栈 / Tech Stack
 
@@ -55,6 +34,7 @@ Install with Snap Hutao MSIX package, can be installed with Windows built-in App
 * [dotnet/efcore](https://github.com/dotnet/efcore)
 * [dotnet/runtime](https://github.com/dotnet/runtime)
 * [DotNetAnalyzers/StyleCopAnalyzers](https://github.com/DotNetAnalyzers/StyleCopAnalyzers)
+* [microsoft/CsWin32](https://github.com/microsoft/CsWin32)
 * [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)
@@ -64,29 +44,7 @@ Install with Snap Hutao MSIX package, can be installed with Windows built-in App
 * [Snap.Hutao.Server](https://github.com/DGP-Studio/Snap.Hutao.Server)
 * [Snap.Metadata](https://github.com/DGP-Studio/Snap.Metadata)
 
-## 赞助商 / Sponsorship
-
-Snap Hutao is currently using sponsored software from the following service providers.
-
-| [![](https://www.netlify.com/v3/img/components/netlify-light.svg)](https://www.netlify.com/) | [![](https://support.crowdin.com/assets/logos/core-logo/svg/crowdin-core-logo-cDark.svg)](https://crowdin.com/) | [![](https://gitlab.cn/images/icons/logos/logo-121-75.svg)](https://gitlab.cn/) |
-|:----------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------:|
-|              [![](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/73ae8b90-f3c7-4033-b2b7-f4126331ce66)](https://about.signpath.io)              |                        [![](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/49aed8ee-9f19-4a8a-998c-7b93ee286d65)](https://1password.com/)                         |  [![](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/ad121220-d2d3-4f49-b215-b6d063dc229d)](https://about.signpath.io)   |
-
-
-- Netlify provides document and home page hosting service for Snap Hutao
-
-- Crowdin provides its SaaS platform to help Snap Hutao's localization
-
-- Jihu GitLab (极狐) provides Git repository and CI/CD SaaS service for Snap Hutao in China
-
-- Free code signing provided by [SignPath.io](https://signpath.io/), certificate by [SignPath Foundation](https://signpath.org/)
-
-- 1Password provides Snap Hutao development team with their amazing password management software
-  
-- DigitalOcean provides reliable cloud database for Snap Hutao database backup
-
 ## 开发 / Development
-
 ![Snap.Hutao](https://repobeats.axiom.co/api/embed/f029553fbe0c60689b1710476ec8512452163fc9.svg)
 
-[![Star History Chart](https://api.star-history.com/svg?repos=DGP-Studio/Snap.Hutao&type=Date)](https://star-history.com/#DGP-Studio/Snap.Hutao&Date)
+[![Star History Chart](https://api.star-history.com/svg?repos=DGP-Studio/Snap.Hutao&type=Date)](https://star-history.com/#DGP-Studio/Snap.Hutao&Date)

appveyor.yml

@@ -1,20 +0,0 @@
-version: 1.0.{build}
-branches:
-  only:
-    - "release"
-build_cloud: HUTAO-SERVER
-image: Visual Studio 2022
-clone_depth: 3
-clone_folder: D:\appveyor\project\Snap.Hutao.Project
-install:
-- pwsh: dotnet tool restore
-build_script:
-- pwsh: dotnet cake
-artifacts:
-- path: src/output/*.msix
-  type: file
-deploy:
-- provider: Webhook
-  url: https://app.signpath.io/API/v1/7a941fa3-64d8-4c45-bd03-92a02bcd4964/Integrations/AppVeyor?ProjectSlug=Snap.Hutao&SigningPolicySlug=release-signing&ArtifactConfigurationSlug=msix
-  authorization:
-    secure: j8srQ5/UYWhI+jlm3Vo3D3QfXoRyQ9hOn3ynJGtwusKui4+uDi4gykdUFYCITZxK+C/fOCAZNJ+YaKSm/OaiXw==

azure-pipelines.yml

@@ -0,0 +1,191 @@
+# CI process script for Snap.Hutao
+# Usage:
+# 1. Append the script in Pipelines
+# 2. Upload the pfx and cer certificates to Pipelines Library secrets
+# 3. Permit the pfx usage
+# 4. Add a `pw` variable in the script variables, which is pfx password
+# 5. Connect the GitHub in project settings
+# 6. Run
+
+trigger:
+  branches:
+    include:
+    - main
+    - develop
+  paths:
+    exclude:
+    - README.md
+    - azure-pipelines.yml
+    - .github/ISSUE_TEMPLATE/*.yml
+    - .github/workflows/*.yml
+    - src/Snap.Hutao/Snap.Hutao/Resource/Localization/*.resx
+pr:
+  branches:
+   include:
+   - main
+  paths:
+   exclude:
+     - README.md
+     - azure-pipelines.yml
+     - .github/ISSUE_TEMPLATE/*.yml
+     - .github/workflows/*.yml
+     - src/Snap.Hutao/Snap.Hutao/Resource/Localization/*.resx
+    
+
+pool:
+  name: Default
+  demands: agent.name -equals Hutao-Server
+
+variables:
+  DOTNET_SKIP_FIRST_TIME_EXPERIENCE: true
+  solution: '$(Build.SourcesDirectory)/src/Snap.Hutao/Snap.Hutao.sln'
+  project: $(Build.SourcesDirectory)/src/Snap.Hutao/Snap.Hutao/Snap.Hutao.csproj'
+  buildPlatform: 'x64'
+  buildConfiguration: 'Release'
+  build_date: $[ format('{0:yyyy}.{0:M}.{0:d}', pipeline.startTime) ]
+
+
+steps:
+- task: GetRevision@1
+  displayName: get Pipelines revision number
+  inputs:
+    VariableName: 'rev_number'
+
+- task: UseDotNet@2
+  displayName: Install dotNet
+  inputs:
+    packageType: 'sdk'
+    version: '7.x'
+    includePreviewVersions: true
+
+- task: NuGetToolInstaller@1
+  name: 'NuGetToolInstaller'
+  displayName: 'NuGet Installer'
+
+- task: NuGetCommand@2
+  displayName: NuGet restore
+  inputs:
+    command: 'restore'
+    restoreSolution: '$(solution)'
+    feedsToUse: 'config'
+    nugetConfigPath: '$(Build.SourcesDirectory)/NuGet.Config'
+
+- task: MsixPackaging@1
+  displayName: Build binary package
+  inputs:
+    outputPath: '$(Build.ArtifactStagingDirectory)/'
+    solution: '$(solution)'
+    clean: false
+    generateBundle: false
+    buildConfiguration: 'Release'
+    buildPlatform: 'x64'
+    updateAppVersion: false
+    appPackageDistributionMode: 'SideloadOnly'
+    msbuildLocationMethod: 'location'
+    msbuildLocation: 'C:\Program Files\Microsoft Visual Studio\2022\Enterprise\Msbuild\Current\Bin\MSBuild.exe'
+
+- task: MagicChunks@2
+  inputs:
+    sourcePath: '$(Build.SourcesDirectory)\src\Snap.Hutao\Snap.Hutao\bin\x64\Release\net7.0-windows10.0.19041.0\win10-x64\AppxManifest.xml'
+    fileType: 'Xml'
+    targetPathType: 'source'
+    transformationType: 'json'
+    transformations: |
+      {
+        "Package/Identity/@Name": "7f0db578-026f-4e0b-a75b-d5d06bb0a74c",
+        "Package/Identity/@Publisher": "CN=DGP Studio CI",
+        "Package/Identity/@Version": "$(build_date).$(rev_number)",
+        "Package/Properties/DisplayName": "胡桃 Alpha",
+        "Package/Properties/PublisherDisplayName":"DGP Studio CI",
+        "Package/Applications/Application/uap:VisualElements/@DisplayName": "胡桃 Alpha"
+      }
+
+- task: CmdLine@2
+  displayName: Create resources folder
+  inputs:
+    script: |
+      mkdir Assets
+      
+      mkdir Resource
+    workingDirectory: '$(Build.SourcesDirectory)\src\Snap.Hutao\Snap.Hutao\bin\x64\Release\net7.0-windows10.0.19041.0\win10-x64'
+      
+
+- task: CopyFiles@2
+  displayName: Copy Assets Folder
+  inputs:
+    SourceFolder: '$(Build.SourcesDirectory)\src\Snap.Hutao\Snap.Hutao\Assets'
+    Contents: '**'
+    TargetFolder: '$(Build.SourcesDirectory)\src\Snap.Hutao\Snap.Hutao\bin\x64\Release\net7.0-windows10.0.19041.0\win10-x64\Assets'
+
+- task: CopyFiles@2
+  displayName: Copy Resource Folder
+  inputs:
+    SourceFolder: '$(Build.SourcesDirectory)\src\Snap.Hutao\Snap.Hutao\Resource'
+    Contents: '**'
+    TargetFolder: '$(Build.SourcesDirectory)\src\Snap.Hutao\Snap.Hutao\bin\x64\Release\net7.0-windows10.0.19041.0\win10-x64\Resource'
+
+- task: CmdLine@2
+  displayName: Build MSIX
+  inputs:
+    script: '"C:\Program Files (x86)\Windows Kits\10\bin\10.0.22621.0\x64\makeappx.exe" pack /d $(Build.SourcesDirectory)\src\Snap.Hutao\Snap.Hutao\bin\x64\Release\net7.0-windows10.0.19041.0\win10-x64 /p $(Build.ArtifactStagingDirectory)/Snap.Hutao.Alpha-$(build_date).$(rev_number).msix'
+
+- task: MsixSigning@1
+  name: signMsix
+  displayName: Sign MSIX package
+  inputs:
+    package: '$(Build.ArtifactStagingDirectory)/Snap.Hutao.Alpha-$(build_date).$(rev_number).msix'
+    certificate: 'DGP_Studio_CI.pfx'
+    passwordVariable: 'pw'
+  condition: succeeded()
+
+
+#- task: PublishPipelineArtifact@1
+#  displayName: 'Upload Output'
+#  inputs:
+#    targetPath: '$(Build.ArtifactStagingDirectory)/'
+#    artifact: 'Output'
+#    publishLocation: 'pipeline'
+
+- task: DownloadSecureFile@1
+  name: cerFile
+  displayName: Download Root CA
+  inputs:
+    secureFile: 'Snap.Hutao.CI.cer'
+
+- task: GitHubRelease@1
+  inputs:
+    gitHubConnection: 'github.com_Masterain'
+    repositoryName: 'DGP-Studio/Snap.Hutao'
+    action: 'create'
+    target: '$(Build.SourceVersion)'
+    tagSource: 'userSpecifiedTag'
+    tag: '$(build_date).$(rev_number)'
+    title: '$(build_date).$(rev_number)'
+    releaseNotesSource: 'inline'
+    releaseNotesInline: |
+      ## 普通用户请勿下载
+      该版本是由 CI 程序自动打包生成的 `Alpha` 测试版本，**仅供开发者测试使用**
+
+      普通用户请[点击这里](https://github.com/DGP-Studio/Snap.Hutao/releases/latest/)下载最新的稳定版本
+
+    assets: |
+      $(Build.ArtifactStagingDirectory)/*
+      $(cerFile.secureFilePath)
+    isPreRelease: true
+    changeLogCompareToRelease: 'lastFullRelease'
+    changeLogType: 'commitBased'
+
+
+- task: rclone@1
+  displayName: Upload CI via Rclone
+  condition: and(succeeded(), eq(variables['Build.SourceBranch'], 'refs/heads/main'))
+  inputs:
+    arguments: 'copy $(Build.ArtifactStagingDirectory)/Snap.Hutao.Alpha-$(build_date).$(rev_number).msix downloadDGPCN:/releases/Alpha/'
+    configPath: 'C:\agent\_work\_tasks\rclone.conf'
+
+- task: rclone@1
+  displayName: Upload PR CI via Rclone
+  condition: and(succeeded(), eq(variables['Build.Reason'], 'PullRequest'))
+  inputs:
+    arguments: 'copy $(Build.ArtifactStagingDirectory)/Snap.Hutao.Alpha-$(build_date).$(rev_number).msix downloadDGPCN:/releases/PR/'
+    configPath: 'C:\agent\_work\_tasks\rclone.conf'

build.cake

@@ -1,189 +0,0 @@
-#tool "nuget:?package=nuget.commandline&version=6.9.1"
-#addin nuget:?package=Cake.Http&version=4.0.0
-
-var target = Argument("target", "Build");
-var configuration = Argument("configuration", "Release");
-
-// Pre-define
-
-var version = "version";
-
-var repoDir = "repoDir";
-var outputPath = "outputPath";
-
-string solution
-{
-    get => System.IO.Path.Combine(repoDir, "src", "Snap.Hutao", "Snap.Hutao.sln");
-}
-string project
-{
-    get => System.IO.Path.Combine(repoDir, "src", "Snap.Hutao", "Snap.Hutao", "Snap.Hutao.csproj");
-}
-string binPath
-{
-    get => System.IO.Path.Combine(repoDir, "src", "Snap.Hutao", "Snap.Hutao", "bin", "x64", "Release", "net8.0-windows10.0.22621.0", "win-x64");
-}
-string manifest
-{
-    get => System.IO.Path.Combine(repoDir, "src", "Snap.Hutao", "Snap.Hutao", "Package.appxmanifest");
-}
-
-if (GitHubActions.IsRunningOnGitHubActions)
-{
-    repoDir = GitHubActions.Environment.Workflow.Workspace.FullPath;
-    outputPath = System.IO.Path.Combine(repoDir, "src", "output");
-
-    if (GitHubActions.Environment.PullRequest.IsPullRequest)
-    {
-        version = System.DateTime.Now.ToString("yyyy.M.d.0");
-
-        Information("Is Pull Request. Skip version.");
-    }
-    else
-    {
-        var versionAuth = HasEnvironmentVariable("VERSION_API_TOKEN") ? EnvironmentVariable("VERSION_API_TOKEN") : throw new Exception("Cannot find VERSION_API_TOKEN");
-        version = HttpGet(
-            "https://internal.snapgenshin.cn/BuildIntergration/RequestNewVersion",
-            new HttpSettings
-            {
-                Headers = new Dictionary<string, string>
-                    {
-                    { "Authorization", versionAuth }
-                    }
-            }
-        );
-
-        Information($"Version: {version}");
-    }
-
-    GitHubActions.Commands.SetOutputParameter("version", version);
-}
-else if (AppVeyor.IsRunningOnAppVeyor)
-{
-    repoDir = AppVeyor.Environment.Build.Folder;
-    outputPath = System.IO.Path.Combine(repoDir, "src", "output");
-
-    version = XmlPeek(manifest, "appx:Package/appx:Identity/@Version", new XmlPeekSettings
-    {
-        Namespaces = new Dictionary<string, string> { { "appx", "http://schemas.microsoft.com/appx/manifest/foundation/windows10" } }
-    })[..^2];
-    Information($"Version: {version}");
-}
-
-Task("Build")
-    .IsDependentOn("Build binary package")
-    .IsDependentOn("Copy files")
-    .IsDependentOn("Build MSIX");
-
-Task("NuGet Restore")
-    .Does(() =>
-{
-    Information("Restoring packages...");
-
-    var nugetConfig = System.IO.Path.Combine(repoDir, "NuGet.Config");
-    DotNetRestore(project, new DotNetRestoreSettings
-    {
-        Verbosity = DotNetVerbosity.Detailed,
-        Interactive = false,
-        ConfigFile = nugetConfig
-    });
-});
-
-Task("Generate AppxManifest")
-    .Does(() =>
-{
-    Information("Generating AppxManifest...");
-
-    var content = System.IO.File.ReadAllText(manifest);
-
-    if (GitHubActions.IsRunningOnGitHubActions)
-    {
-        Information("Using CI configuraion");
-        content = content
-            .Replace("Snap Hutao", "Snap Hutao Alpha")
-            .Replace("胡桃", "胡桃 Alpha")
-            .Replace("DGP Studio", "DGP Studio CI");
-        content = System.Text.RegularExpressions.Regex.Replace(content, "  Name=\"([^\"]*)\"", "  Name=\"7f0db578-026f-4e0b-a75b-d5d06bb0a74c\"");
-        content = System.Text.RegularExpressions.Regex.Replace(content, "  Publisher=\"([^\"]*)\"", "  Publisher=\"E=admin@dgp-studio.cn, CN=DGP Studio CI, OU=CI, O=DGP-Studio, L=San Jose, S=CA, C=US\"");
-        content = System.Text.RegularExpressions.Regex.Replace(content, "  Version=\"([0-9\\.]+)\"", $"  Version=\"{version}\"");
-    }
-    else if (AppVeyor.IsRunningOnAppVeyor)
-    {
-        Information("Using Release configuration");
-        content = System.Text.RegularExpressions.Regex.Replace(content, "  Publisher=\"([^\"]*)\"", "  Publisher=\"CN=SignPath Foundation, O=SignPath Foundation, L=Lewes, S=Delaware, C=US\"");
-    }
-
-    System.IO.File.WriteAllText(manifest, content);
-
-    Information("Generated.");
-});
-
-Task("Build binary package")
-    .IsDependentOn("NuGet Restore")
-    .IsDependentOn("Generate AppxManifest")
-    .Does(() =>
-{
-    Information("Building binary package...");
-
-    var settings = new DotNetBuildSettings
-    {
-        Configuration = configuration
-    };
-
-    settings.MSBuildSettings = new DotNetMSBuildSettings
-    {
-        ArgumentCustomization = args => args.Append("/p:Platform=x64")
-                                            .Append("/p:UapAppxPackageBuildMode=SideloadOnly")
-                                            .Append("/p:AppxPackageSigningEnabled=false")
-                                            .Append("/p:AppxBundle=Never")
-                                            .Append("/p:AppxPackageOutput=" + outputPath)
-    };
-
-    DotNetBuild(project, settings);
-});
-
-Task("Copy files")
-    .IsDependentOn("Build binary package")
-    .Does(() =>
-{
-    Information("Copying assets...");
-    CopyDirectory(
-        System.IO.Path.Combine(repoDir, "src", "Snap.Hutao", "Snap.Hutao", "Assets"),
-        System.IO.Path.Combine(binPath, "Assets")
-    );
-
-    Information("Copying resource...");
-    CopyDirectory(
-        System.IO.Path.Combine(repoDir, "src", "Snap.Hutao", "Snap.Hutao", "Resource"),
-        System.IO.Path.Combine(binPath, "Resource")
-    );
-});
-
-Task("Build MSIX")
-    .IsDependentOn("Build binary package")
-    .IsDependentOn("Copy files")
-    .Does(() =>
-{
-    var arguments = "arguments";
-    if (GitHubActions.IsRunningOnGitHubActions)
-    {
-        arguments = "pack /d " + binPath + " /p " + System.IO.Path.Combine(outputPath, $"Snap.Hutao.Alpha-{version}.msix");
-    }
-    else if (AppVeyor.IsRunningOnAppVeyor)
-    {
-        arguments = "pack /d " + binPath + " /p " + System.IO.Path.Combine(outputPath, $"Snap.Hutao-{version}.msix");
-    }
-    var p = StartProcess(
-        "makeappx.exe",
-        new ProcessSettings
-        {
-            Arguments = arguments
-        }
-    );
-    if (p != 0)
-    {
-        throw new InvalidOperationException("Build failed with exit code " + p);
-    }
-});
-
-RunTarget(target);

src/Snap.Hutao/.editorconfig

@@ -108,9 +108,7 @@ dotnet_naming_style.pascal_case.capitalization = pascal_case
 dotnet_diagnostic.SA1629.severity = none
 dotnet_diagnostic.SA1642.severity = none
 
-dotnet_diagnostic.IDE0005.severity = warning
 dotnet_diagnostic.IDE0060.severity = none
-dotnet_diagnostic.IDE0290.severity = none
 
 # SA1208: System using directives should be placed before other using directives
 dotnet_diagnostic.SA1208.severity = none
@@ -124,6 +122,9 @@ dotnet_diagnostic.SA1623.severity = none
 # SA1636: File header copyright text should match
 dotnet_diagnostic.SA1636.severity = none
 
+# SA1414: Tuple types in signatures should have element names
+dotnet_diagnostic.SA1414.severity = none
+
 # SA0001: XML comment analysis disabled
 dotnet_diagnostic.SA0001.severity = none
 csharp_style_prefer_parameter_null_checking = true:suggestion
@@ -321,7 +322,6 @@ dotnet_diagnostic.CA2227.severity = suggestion
 
 # CA2251: 使用 “string.Equals”
 dotnet_diagnostic.CA2251.severity = suggestion
-csharp_style_prefer_primary_constructors = true:suggestion
 
 [*.vb]
 #### 命名样式 ####

src/Snap.Hutao/.vsconfig

@@ -1,11 +0,0 @@
-{
-    "version": "1.0",
-    "components": [
-        "Microsoft.VisualStudio.Workload.ManagedDesktop",
-        "Microsoft.VisualStudio.Workload.NativeDesktop",
-        "Microsoft.VisualStudio.Workload.Universal"
-    ],
-    "extensions": [
-        "https://marketplace.visualstudio.com/items?itemName=ProjectReunion.MicrosoftSingleProjectMSIXPackagingToolsDev17"
-    ]
-}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/Automation/AttributeGenerator.cs

@@ -0,0 +1,147 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.CodeAnalysis;
+
+namespace Snap.Hutao.SourceGeneration.Automation;
+
+[Generator(LanguageNames.CSharp)]
+internal sealed class AttributeGenerator : IIncrementalGenerator
+{
+    public void Initialize(IncrementalGeneratorInitializationContext context)
+    {
+        context.RegisterPostInitializationOutput(GenerateAllAttributes);
+    }
+
+    public static void GenerateAllAttributes(IncrementalGeneratorPostInitializationContext context)
+    {
+        string coreAnnotations = """
+            using System.Diagnostics;
+
+            namespace Snap.Hutao.Core.Annotation;
+
+            [AttributeUsage(AttributeTargets.Method, Inherited = false)]
+            internal sealed class CommandAttribute : Attribute
+            {
+                public CommandAttribute(string name)
+                {
+                }
+
+                public bool AllowConcurrentExecutions { get; set; }
+            }
+
+            [AttributeUsage(AttributeTargets.Class, Inherited = false)]
+            internal sealed class ConstructorGeneratedAttribute : Attribute
+            {
+                public ConstructorGeneratedAttribute()
+                {
+                }
+
+                public bool CallBaseConstructor { get; set; }
+                public bool ResolveHttpClient { get; set; }
+            }
+
+            [AttributeUsage(AttributeTargets.Class, AllowMultiple = true, Inherited = false)]
+            internal sealed class DependencyPropertyAttribute : Attribute
+            {
+                public DependencyPropertyAttribute(string name, Type type)
+                {
+                }
+
+                public DependencyPropertyAttribute(string name, Type type, object defaultValue)
+                {
+                }
+
+                public DependencyPropertyAttribute(string name, Type type, object defaultValue, string valueChangedCallbackName)
+                {
+                }
+
+                public bool IsAttached { get; set; }
+                public Type AttachedType { get; set; } = default;
+            }
+
+            [AttributeUsage(AttributeTargets.All, Inherited = false)]
+            [Conditional("DEBUG")]
+            internal sealed class HighQualityAttribute : Attribute
+            {
+            }
+            """;
+        context.AddSource("Snap.Hutao.Core.Annotation.Attributes.g.cs", coreAnnotations);
+
+        string coreDependencyInjectionAnnotationHttpClients = """
+            namespace Snap.Hutao.Core.DependencyInjection.Annotation.HttpClient;
+
+            [AttributeUsage(AttributeTargets.Class, Inherited = false)]
+            internal sealed class HttpClientAttribute : Attribute
+            {
+                public HttpClientAttribute(HttpClientConfiguration configuration)
+                {
+                }
+
+                public HttpClientAttribute(HttpClientConfiguration configuration, Type interfaceType)
+                {
+                }
+            }
+
+            internal enum HttpClientConfiguration
+            {
+                /// <summary>
+                /// 默认配置
+                /// </summary>
+                Default,
+
+                /// <summary>
+                /// 米游社请求配置
+                /// </summary>
+                XRpc,
+
+                /// <summary>
+                /// 米游社登录请求配置
+                /// </summary>
+                XRpc2,
+
+                /// <summary>
+                /// Hoyolab app
+                /// </summary>
+                XRpc3,
+            }
+
+            [AttributeUsage(AttributeTargets.Class, Inherited = false)]
+            internal sealed class PrimaryHttpMessageHandlerAttribute : Attribute
+            {
+                /// <inheritdoc cref="System.Net.Http.HttpClientHandler.MaxConnectionsPerServer"/>
+                public int MaxConnectionsPerServer { get; set; }
+
+                /// <summary>
+                /// <inheritdoc cref="System.Net.Http.HttpClientHandler.UseCookies"/>
+                /// </summary>
+                public bool UseCookies { get; set; }
+            }
+            """;
+        context.AddSource("Snap.Hutao.Core.DependencyInjection.Annotation.HttpClient.Attributes.g.cs", coreDependencyInjectionAnnotationHttpClients);
+
+        string coreDependencyInjectionAnnotations = """
+            namespace Snap.Hutao.Core.DependencyInjection.Annotation;
+
+            internal enum InjectAs
+            {
+                Singleton,
+                Transient,
+                Scoped,
+            }
+
+            [AttributeUsage(AttributeTargets.Class, AllowMultiple = true, Inherited = false)]
+            internal sealed class InjectionAttribute : Attribute
+            {
+                public InjectionAttribute(InjectAs injectAs)
+                {
+                }
+
+                public InjectionAttribute(InjectAs injectAs, Type interfaceType)
+                {
+                }
+            }
+            """;
+        context.AddSource("Snap.Hutao.Core.DependencyInjection.Annotation.Attributes.g.cs", coreDependencyInjectionAnnotations);
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/Automation/CommandGenerator.cs

@@ -0,0 +1,98 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.CodeAnalysis;
+using Microsoft.CodeAnalysis.CSharp.Syntax;
+using Snap.Hutao.SourceGeneration.Primitive;
+using System.Collections.Immutable;
+using System.Linq;
+using System.Threading;
+
+namespace Snap.Hutao.SourceGeneration.Automation;
+
+[Generator(LanguageNames.CSharp)]
+internal sealed class CommandGenerator : IIncrementalGenerator
+{
+    public const string AttributeName = "Snap.Hutao.Core.Annotation.CommandAttribute";
+
+    public void Initialize(IncrementalGeneratorInitializationContext context)
+    {
+        IncrementalValueProvider<ImmutableArray<GeneratorSyntaxContext2<IMethodSymbol>>> commands =
+            context.SyntaxProvider.CreateSyntaxProvider(FilterAttributedMethods, CommandMethod)
+            .Where(GeneratorSyntaxContext2<IMethodSymbol>.NotNull)
+            .Collect();
+
+        context.RegisterImplementationSourceOutput(commands, GenerateCommandImplementations);
+    }
+
+    private static bool FilterAttributedMethods(SyntaxNode node, CancellationToken token)
+    {
+        return node is MethodDeclarationSyntax methodDeclarationSyntax
+            && methodDeclarationSyntax.Parent is ClassDeclarationSyntax classDeclarationSyntax
+            && classDeclarationSyntax.Modifiers.Count > 1
+            && methodDeclarationSyntax.HasAttributeLists();
+    }
+
+    private static GeneratorSyntaxContext2<IMethodSymbol> CommandMethod(GeneratorSyntaxContext context, CancellationToken token)
+    {
+        if (context.TryGetDeclaredSymbol(token, out IMethodSymbol? methodSymbol))
+        {
+            ImmutableArray<AttributeData> attributes = methodSymbol.GetAttributes();
+            if (attributes.Any(data => data.AttributeClass!.ToDisplayString() == AttributeName))
+            {
+                return new(context, methodSymbol, attributes);
+            }
+        }
+
+        return default;
+    }
+
+    private static void GenerateCommandImplementations(SourceProductionContext production, ImmutableArray<GeneratorSyntaxContext2<IMethodSymbol>> context2s)
+    {
+        foreach (GeneratorSyntaxContext2<IMethodSymbol> context2 in context2s.DistinctBy(c => c.Symbol.ToDisplayString()))
+        {
+            GenerateCommandImplementation(production, context2);
+        }
+    }
+
+    private static void GenerateCommandImplementation(SourceProductionContext production, GeneratorSyntaxContext2<IMethodSymbol> context2)
+    {
+        INamedTypeSymbol classSymbol = context2.Symbol.ContainingType;
+
+        AttributeData commandInfo = context2.SingleAttribute(AttributeName);
+        string commandName = (string)commandInfo.ConstructorArguments[0].Value!;
+
+        string commandType = context2.Symbol.ReturnType.IsOrInheritsFrom("System.Threading.Tasks.Task")
+            ? "AsyncRelayCommand"
+            : "RelayCommand";
+
+        string genericParameter = context2.Symbol.Parameters.ElementAtOrDefault(0) is IParameterSymbol parameter
+            ? $"<{parameter.Type.ToDisplayString(SymbolDisplayFormats.FullyQualifiedNonNullableFormat)}>"
+            : string.Empty;
+
+        string concurrentExecution = commandInfo.HasNamedArgumentWith<bool>("AllowConcurrentExecutions", value => value)
+            ? ", AsyncRelayCommandOptions.AllowConcurrentExecutions"
+            : string.Empty;
+
+        string className = classSymbol.ToDisplayString(SymbolDisplayFormat.MinimallyQualifiedFormat);
+
+        string code = $$"""
+            using CommunityToolkit.Mvvm.Input;
+
+            namespace {{classSymbol.ContainingNamespace}};
+
+            partial class {{className}}
+            {
+                private ICommand _{{commandName}};
+
+                public ICommand {{commandName}}
+                {
+                    get => _{{commandName}} ??= new {{commandType}}{{genericParameter}}({{context2.Symbol.Name}}{{concurrentExecution}});
+                }
+            }
+            """;
+
+        string normalizedClassName = classSymbol.ToDisplayString().Replace('<', '{').Replace('>', '}');
+        production.AddSource($"{normalizedClassName}.{commandName}.g.cs", code);
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/Automation/ConstructorGenerator.cs

@@ -0,0 +1,193 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.CodeAnalysis;
+using Microsoft.CodeAnalysis.CSharp.Syntax;
+using Snap.Hutao.SourceGeneration.Primitive;
+using System;
+using System.Collections.Generic;
+using System.Collections.Immutable;
+using System.Linq;
+using System.Text;
+using System.Threading;
+
+namespace Snap.Hutao.SourceGeneration.Automation;
+
+[Generator(LanguageNames.CSharp)]
+internal sealed class ConstructorGenerator : IIncrementalGenerator
+{
+    private const string AttributeName = "Snap.Hutao.Core.Annotation.ConstructorGeneratedAttribute";
+    private const string CompilerGenerated = "System.Runtime.CompilerServices.CompilerGeneratedAttribute";
+
+    //private static readonly DiagnosticDescriptor genericTypeNotSupportedDescriptor = new("SH102", "Generic type is not supported to generate .ctor", "Type [{0}] is not supported", "Quality", DiagnosticSeverity.Error, true);
+
+    public void Initialize(IncrementalGeneratorInitializationContext context)
+    {
+        IncrementalValueProvider<ImmutableArray<GeneratorSyntaxContext2>> injectionClasses =
+            context.SyntaxProvider.CreateSyntaxProvider(FilterAttributedClasses, ConstructorGeneratedClass)
+            .Where(GeneratorSyntaxContext2.NotNull)
+            .Collect();
+
+        context.RegisterSourceOutput(injectionClasses, GenerateConstructorImplementations);
+    }
+
+    private static bool FilterAttributedClasses(SyntaxNode node, CancellationToken token)
+    {
+        return node is ClassDeclarationSyntax classDeclarationSyntax
+            && classDeclarationSyntax.Modifiers.Count > 1
+            && classDeclarationSyntax.HasAttributeLists();
+    }
+
+    private static GeneratorSyntaxContext2 ConstructorGeneratedClass(GeneratorSyntaxContext context, CancellationToken token)
+    {
+        if (context.TryGetDeclaredSymbol(token, out INamedTypeSymbol? classSymbol))
+        {
+            ImmutableArray<AttributeData> attributes = classSymbol.GetAttributes();
+            if (attributes.Any(data => data.AttributeClass!.ToDisplayString() == AttributeName))
+            {
+                return new(context, classSymbol, attributes);
+            }
+        }
+
+        return default;
+    }
+
+    private static void GenerateConstructorImplementations(SourceProductionContext production, ImmutableArray<GeneratorSyntaxContext2> context2s)
+    {
+        foreach (GeneratorSyntaxContext2 context2 in context2s.DistinctBy(c => c.Symbol.ToDisplayString()))
+        {
+            GenerateConstructorImplementation(production, context2);
+        }
+    }
+
+    private static void GenerateConstructorImplementation(SourceProductionContext production, GeneratorSyntaxContext2 context2)
+    {
+        AttributeData constructorInfo = context2.SingleAttribute(AttributeName);
+
+        bool resolveHttpClient = constructorInfo.HasNamedArgumentWith<bool>("ResolveHttpClient", value => value);
+        bool callBaseConstructor = constructorInfo.HasNamedArgumentWith<bool>("CallBaseConstructor", value => value);
+        string httpclient = resolveHttpClient ? ", System.Net.Http.HttpClient httpClient" : string.Empty;
+
+        FieldValueAssignmentOptions options = new(resolveHttpClient, callBaseConstructor);
+
+        StringBuilder sourceBuilder = new StringBuilder().Append($$"""
+            namespace {{context2.Symbol.ContainingNamespace}};
+
+            [global::System.CodeDom.Compiler.GeneratedCodeAttribute("{{nameof(ConstructorGenerator)}}", "1.0.0.0")]
+            partial class {{context2.Symbol.ToDisplayString(SymbolDisplayFormats.QualifiedNonNullableFormat)}}
+            {
+                public {{context2.Symbol.Name}}(System.IServiceProvider serviceProvider{{httpclient}}){{(options.CallBaseConstructor ? " : base(serviceProvider)" : string.Empty)}}
+                {
+
+            """);
+
+        FillUpWithFieldValueAssignment(sourceBuilder, context2, options);
+
+        sourceBuilder.Append("""
+                }
+            }
+            """);
+
+        string normalizedClassName = context2.Symbol.ToDisplayString().Replace('<', '{').Replace('>', '}');
+        production.AddSource($"{normalizedClassName}.ctor.g.cs", sourceBuilder.ToString());
+    }
+
+    private static void FillUpWithFieldValueAssignment(StringBuilder builder, GeneratorSyntaxContext2 context2, FieldValueAssignmentOptions options)
+    {
+        IEnumerable<IFieldSymbol> fields = context2.Symbol.GetMembers()
+            .Where(m => m.Kind == SymbolKind.Field)
+            .OfType<IFieldSymbol>();
+
+        foreach (IFieldSymbol fieldSymbol in fields)
+        {
+            if (fieldSymbol.Name.AsSpan()[0] is '<')
+            {
+                continue;
+            }
+
+            bool shoudSkip = false;
+            foreach (SyntaxReference syntaxReference in fieldSymbol.DeclaringSyntaxReferences)
+            {
+                if (syntaxReference.GetSyntax() is VariableDeclaratorSyntax declarator)
+                {
+                    if (declarator.Initializer is not null)
+                    {
+                        // Skip field with initializer
+                        builder.Append("        // Skip field with initializer: ").AppendLine(fieldSymbol.Name);
+                        shoudSkip = true;
+                        break;
+                    }
+                }
+            }
+
+            if (shoudSkip)
+            {
+                continue;
+            }
+
+            if (fieldSymbol.IsReadOnly && !fieldSymbol.IsStatic)
+            {
+                switch (fieldSymbol.Type.ToDisplayString())
+                {
+                    case "System.IServiceProvider":
+                        builder
+                            .Append("        this.")
+                            .Append(fieldSymbol.Name)
+                            .AppendLine(" = serviceProvider;");
+                        break;
+
+                    case "System.Net.Http.HttpClient":
+                        if (options.ResolveHttpClient)
+                        {
+                            builder
+                                .Append("        this.")
+                                .Append(fieldSymbol.Name)
+                                .AppendLine(" = httpClient;");
+                        }
+                        else
+                        {
+                            builder
+                                .Append("        this.")
+                                .Append(fieldSymbol.Name)
+                                .Append(" = serviceProvider.GetRequiredService<System.Net.Http.IHttpClientFactory>().CreateClient(nameof(")
+                                .Append(context2.Symbol.Name)
+                                .AppendLine("));");
+                        }
+                        break;
+
+                    default:
+                        builder
+                            .Append("        this.")
+                            .Append(fieldSymbol.Name)
+                            .Append(" = serviceProvider.GetRequiredService<")
+                            .Append(fieldSymbol.Type)
+                            .AppendLine(">();");
+                        break;
+                }
+            }
+        }
+
+        foreach (INamedTypeSymbol interfaceSymbol in context2.Symbol.Interfaces)
+        {
+            if (interfaceSymbol.Name == "IRecipient")
+            {
+                builder
+                    .Append("        CommunityToolkit.Mvvm.Messaging.IMessengerExtensions.Register<")
+                    .Append(interfaceSymbol.TypeArguments[0])
+                    .AppendLine(">(serviceProvider.GetRequiredService<CommunityToolkit.Mvvm.Messaging.IMessenger>(), this);");
+            }
+        }
+    }
+
+    private readonly struct FieldValueAssignmentOptions
+    {
+        public readonly bool ResolveHttpClient;
+        public readonly bool CallBaseConstructor;
+
+        public FieldValueAssignmentOptions(bool resolveHttpClient, bool callBaseConstructor)
+        {
+            ResolveHttpClient = resolveHttpClient;
+            CallBaseConstructor = callBaseConstructor;
+        }
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/Automation/DependencyPropertyGenerator.cs

@@ -0,0 +1,149 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.CodeAnalysis;
+using Microsoft.CodeAnalysis.CSharp.Syntax;
+using Snap.Hutao.SourceGeneration.Primitive;
+using System.Collections.Generic;
+using System.Collections.Immutable;
+using System.Linq;
+using System.Threading;
+
+namespace Snap.Hutao.SourceGeneration.Automation;
+
+[Generator(LanguageNames.CSharp)]
+internal sealed class DependencyPropertyGenerator : IIncrementalGenerator
+{
+    private const string AttributeName = "Snap.Hutao.Core.Annotation.DependencyPropertyAttribute";
+
+    public void Initialize(IncrementalGeneratorInitializationContext context)
+    {
+        IncrementalValueProvider<ImmutableArray<GeneratorSyntaxContext2>> commands =
+            context.SyntaxProvider.CreateSyntaxProvider(FilterAttributedClasses, CommandMethod)
+            .Where(GeneratorSyntaxContext2.NotNull)
+            .Collect();
+
+        context.RegisterImplementationSourceOutput(commands, GenerateDependencyPropertyImplementations);
+    }
+
+    private static bool FilterAttributedClasses(SyntaxNode node, CancellationToken token)
+    {
+        return node is ClassDeclarationSyntax classDeclarationSyntax
+            && classDeclarationSyntax.Modifiers.Count > 1
+            && classDeclarationSyntax.HasAttributeLists();
+    }
+
+    private static GeneratorSyntaxContext2 CommandMethod(GeneratorSyntaxContext context, CancellationToken token)
+    {
+        if (context.TryGetDeclaredSymbol(token, out INamedTypeSymbol? methodSymbol))
+        {
+            ImmutableArray<AttributeData> attributes = methodSymbol.GetAttributes();
+            if (attributes.Any(data => data.AttributeClass!.ToDisplayString() == AttributeName))
+            {
+                return new(context, methodSymbol, attributes);
+            }
+        }
+
+        return default;
+    }
+
+    private static void GenerateDependencyPropertyImplementations(SourceProductionContext production, ImmutableArray<GeneratorSyntaxContext2> context2s)
+    {
+        foreach (GeneratorSyntaxContext2 context2 in context2s.DistinctBy(c => c.Symbol.ToDisplayString()))
+        {
+            GenerateDependencyPropertyImplementation(production, context2);
+        }
+    }
+
+    private static void GenerateDependencyPropertyImplementation(SourceProductionContext production, GeneratorSyntaxContext2 context2)
+    {
+        foreach (AttributeData propertyInfo in context2.Attributes.Where(attr => attr.AttributeClass!.ToDisplayString() == AttributeName))
+        {
+            string owner = context2.Symbol.ToDisplayString(SymbolDisplayFormat.MinimallyQualifiedFormat);
+            Dictionary<string, TypedConstant> namedArguments = propertyInfo.NamedArguments.ToDictionary();
+            bool isAttached = namedArguments.TryGetValue("IsAttached", out TypedConstant constant) && (bool)constant.Value!;
+            string register = isAttached ? "RegisterAttached" : "Register";
+
+            ImmutableArray<TypedConstant> arguments = propertyInfo.ConstructorArguments;
+
+            string propertyName = (string)arguments[0].Value!;
+            string propertyType = arguments[1].Value!.ToString();
+            string defaultValue = GetLiteralString(arguments.ElementAtOrDefault(2)) ?? "default";
+            string propertyChangedCallback = arguments.ElementAtOrDefault(3) is { IsNull: false } arg3 ? $", {arg3.Value}" : string.Empty;
+
+            string code;
+            if (isAttached)
+            {
+                string objType = namedArguments.TryGetValue("AttachedType", out TypedConstant attachedType)
+                    ? attachedType.Value!.ToString()
+                    : "object";
+
+                code = $$"""
+                    using Microsoft.UI.Xaml;
+
+                    namespace {{context2.Symbol.ContainingNamespace}};
+
+                    partial class {{owner}}
+                    {
+                        private static readonly DependencyProperty {{propertyName}}Property =
+                            DependencyProperty.RegisterAttached("{{propertyName}}", typeof({{propertyType}}), typeof({{owner}}), new PropertyMetadata(({{propertyType}}){{defaultValue}}{{propertyChangedCallback}}));
+
+                        public static {{propertyType}} Get{{propertyName}}({{objType}} obj)
+                        {
+                            return ({{propertyType}})obj?.GetValue({{propertyName}}Property);
+                        }
+
+                        public static void Set{{propertyName}}({{objType}} obj, {{propertyType}} value)
+                        {
+                            obj.SetValue({{propertyName}}Property, value);
+                        }
+                    }
+                    """;
+            }
+            else
+            {
+                code = $$"""
+                    using Microsoft.UI.Xaml;
+
+                    namespace {{context2.Symbol.ContainingNamespace}};
+
+                    partial class {{owner}}
+                    {
+                        private static readonly DependencyProperty {{propertyName}}Property =
+                            DependencyProperty.Register(nameof({{propertyName}}), typeof({{propertyType}}), typeof({{owner}}), new PropertyMetadata(({{propertyType}}){{defaultValue}}{{propertyChangedCallback}}));
+
+                        public {{propertyType}} {{propertyName}}
+                        {
+                            get => ({{propertyType}})GetValue({{propertyName}}Property);
+                            set => SetValue({{propertyName}}Property, value);
+                        }
+                    }
+                    """;
+            }
+
+            string normalizedClassName = context2.Symbol.ToDisplayString().Replace('<', '{').Replace('>', '}');
+            production.AddSource($"{normalizedClassName}.{propertyName}.g.cs", code);
+        }
+    }
+
+    private static string? GetLiteralString(TypedConstant typedConstant)
+    {
+        if (typedConstant.IsNull)
+        {
+            return default;
+        }
+
+        if (typedConstant.Value is bool boolValue)
+        {
+            return boolValue ? "true" : "false";
+        }
+
+        string result = typedConstant.Value!.ToString();
+        if (string.IsNullOrEmpty(result))
+        {
+            return default;
+        }
+
+        return result;
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/Automation/SaltConstantGenerator.cs

@@ -0,0 +1,72 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.CodeAnalysis;
+using System;
+using System.Net.Http;
+using System.Runtime.Serialization;
+
+namespace Snap.Hutao.SourceGeneration.Automation;
+
+[Generator(LanguageNames.CSharp)]
+internal sealed class SaltConstantGenerator : IIncrementalGenerator
+{
+    private static readonly HttpClient httpClient;
+    private static readonly Lazy<Response<SaltLatest>> lazySaltInfo;
+
+    static SaltConstantGenerator()
+    {
+        httpClient = new();
+        lazySaltInfo = new Lazy<Response<SaltLatest>>(() =>
+        {
+            string body = httpClient.GetStringAsync("https://internal.snapgenshin.cn/Archive/Salt/Latest").GetAwaiter().GetResult();
+            return JsonParser.FromJson<Response<SaltLatest>>(body)!;
+        });
+    }
+
+    public void Initialize(IncrementalGeneratorInitializationContext context)
+    {
+        context.RegisterPostInitializationOutput(GenerateSaltContstants);
+    }
+
+    private static void GenerateSaltContstants(IncrementalGeneratorPostInitializationContext context)
+    {
+        Response<SaltLatest> saltInfo = lazySaltInfo.Value;
+        string code = $$"""
+            namespace Snap.Hutao.Web.Hoyolab;
+
+            internal sealed class SaltConstants
+            {
+                public const string CNVersion = "{{saltInfo.Data.CNVersion}}";
+                public const string CNK2 = "{{saltInfo.Data.CNK2}}";
+                public const string CNLK2 = "{{saltInfo.Data.CNLK2}}";
+
+                public const string OSVersion = "{{saltInfo.Data.OSVersion}}";
+                public const string OSK2 = "{{saltInfo.Data.OSK2}}";
+                public const string OSLK2 = "{{saltInfo.Data.OSLK2}}";
+            }
+            """;
+        context.AddSource("SaltConstants.g.cs", code);
+    }
+
+    private sealed class Response<T>
+    {
+        [DataMember(Name = "data")]
+        public T Data { get; set; } = default!;
+    }
+
+    internal sealed class SaltLatest
+    {
+        public string CNVersion { get; set; } = default!;
+
+        public string CNK2 { get; set; } = default!;
+
+        public string CNLK2 { get; set; } = default!;
+
+        public string OSVersion { get; set; } = default!;
+
+        public string OSK2 { get; set; } = default!;
+
+        public string OSLK2 { get; set; } = default!;
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/CodeAnalysis/NotNullWhenAttribute.cs

@@ -0,0 +1,18 @@
+namespace System.Diagnostics.CodeAnalysis;
+
+/// <summary>Specifies that when a method returns <see cref="ReturnValue"/>, the parameter will not be null even if the corresponding type allows it.</summary>
+[AttributeUsage(AttributeTargets.Parameter, Inherited = false)]
+internal sealed class NotNullWhenAttribute : Attribute
+{
+    /// <summary>Initializes the attribute with the specified return value condition.</summary>
+    /// <param name="returnValue">
+    /// The return value condition. If the method returns this value, the associated parameter will not be null.
+    /// </param>
+    public NotNullWhenAttribute(bool returnValue)
+    {
+        ReturnValue = returnValue;
+    }
+
+    /// <summary>Gets the return value condition.</summary>
+    public bool ReturnValue { get; }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/DependencyInjection/HttpClientGenerator.cs

@@ -0,0 +1,146 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.CodeAnalysis;
+using Microsoft.CodeAnalysis.CSharp;
+using Microsoft.CodeAnalysis.CSharp.Syntax;
+using Snap.Hutao.SourceGeneration.Primitive;
+using System.Collections.Generic;
+using System.Collections.Immutable;
+using System.Linq;
+using System.Text;
+using System.Threading;
+
+namespace Snap.Hutao.SourceGeneration.DependencyInjection;
+
+[Generator(LanguageNames.CSharp)]
+internal sealed class HttpClientGenerator : IIncrementalGenerator
+{
+    private const string AttributeName = "Snap.Hutao.Core.DependencyInjection.Annotation.HttpClient.HttpClientAttribute";
+
+    private const string HttpClientConfiguration = "Snap.Hutao.Core.DependencyInjection.Annotation.HttpClient.HttpClientConfiguration.";
+    private const string PrimaryHttpMessageHandlerAttributeName = "Snap.Hutao.Core.DependencyInjection.Annotation.HttpClient.PrimaryHttpMessageHandlerAttribute";
+    private const string CRLF = "\r\n";
+
+    private static readonly DiagnosticDescriptor injectionShouldOmitDescriptor = new("SH201", "Injection 特性可以省略", "HttpClient 特性已将 {0} 注册为 Transient 服务", "Quality", DiagnosticSeverity.Warning, true);
+
+    public void Initialize(IncrementalGeneratorInitializationContext context)
+    {
+        IncrementalValueProvider<ImmutableArray<GeneratorSyntaxContext2>> injectionClasses = context.SyntaxProvider
+            .CreateSyntaxProvider(FilterAttributedClasses, HttpClientClass)
+            .Where(GeneratorSyntaxContext2.NotNull)
+            .Collect();
+
+        context.RegisterImplementationSourceOutput(injectionClasses, GenerateAddHttpClientsImplementation);
+    }
+
+    private static bool FilterAttributedClasses(SyntaxNode node, CancellationToken token)
+    {
+        return node is ClassDeclarationSyntax classDeclarationSyntax
+            && classDeclarationSyntax.HasAttributeLists();
+    }
+
+    private static GeneratorSyntaxContext2 HttpClientClass(GeneratorSyntaxContext context, CancellationToken token)
+    {
+        if (context.TryGetDeclaredSymbol(token, out INamedTypeSymbol? classSymbol))
+        {
+            ImmutableArray<AttributeData> attributes = classSymbol.GetAttributes();
+            if (attributes.Any(data => data.AttributeClass!.ToDisplayString() == AttributeName))
+            {
+                return new(context, classSymbol, attributes);
+            }
+        }
+
+        return default;
+    }
+
+    private static void GenerateAddHttpClientsImplementation(SourceProductionContext context, ImmutableArray<GeneratorSyntaxContext2> context2s)
+    {
+        StringBuilder sourceBuilder = new StringBuilder().Append($$"""
+            // Copyright (c) DGP Studio. All rights reserved.
+            // Licensed under the MIT license.
+
+            using Snap.Hutao.Web.Hoyolab.DynamicSecret;
+            using System.Net.Http;
+            
+            namespace Snap.Hutao.Core.DependencyInjection;
+            
+            internal static partial class IocHttpClientConfiguration
+            {
+                [global::System.CodeDom.Compiler.GeneratedCodeAttribute("{{nameof(HttpClientGenerator)}}", "1.0.0.0")]
+                public static partial IServiceCollection AddHttpClients(this IServiceCollection services)
+                {
+            """);
+
+        FillUpWithAddHttpClient(sourceBuilder, context, context2s);
+
+        sourceBuilder.Append("""
+
+                    return services;
+                }
+            }
+            """);
+
+        context.AddSource("IocHttpClientConfiguration.g.cs", sourceBuilder.ToString());
+    }
+
+    private static void FillUpWithAddHttpClient(StringBuilder sourceBuilder, SourceProductionContext production, ImmutableArray<GeneratorSyntaxContext2> contexts)
+    {
+        List<string> lines = new();
+        StringBuilder lineBuilder = new();
+
+        foreach (GeneratorSyntaxContext2 context in contexts.DistinctBy(c => c.Symbol.ToDisplayString()))
+        {
+            if (context.SingleOrDefaultAttribute(InjectionGenerator.AttributeName) is AttributeData injectionData)
+            {
+                if (injectionData.ConstructorArguments[0].ToCSharpString() == InjectionGenerator.InjectAsTransientName)
+                {
+                    if (injectionData.ConstructorArguments.Length < 2)
+                    {
+                        production.ReportDiagnostic(Diagnostic.Create(injectionShouldOmitDescriptor, context.Context.Node.GetLocation(), context.Context.Node));
+                    }
+                }
+            }
+
+            lineBuilder.Clear().Append(CRLF);
+            lineBuilder.Append(@"        services.AddHttpClient<");
+
+            AttributeData httpClientData = context.SingleAttribute(AttributeName);
+            ImmutableArray<TypedConstant> arguments = httpClientData.ConstructorArguments;
+
+            if (arguments.Length == 2)
+            {
+                lineBuilder.Append($"{arguments[1].Value}, ");
+            }
+
+            lineBuilder.Append($"{context.Symbol.ToDisplayString()}>(");
+            lineBuilder.Append(arguments[0].ToCSharpString().Substring(HttpClientConfiguration.Length)).Append("Configuration)");
+
+            if (context.SingleOrDefaultAttribute(PrimaryHttpMessageHandlerAttributeName) is AttributeData handlerData)
+            {
+                ImmutableArray<KeyValuePair<string, TypedConstant>> properties = handlerData.NamedArguments;
+                lineBuilder.Append(@".ConfigurePrimaryHttpMessageHandler(() => new HttpClientHandler() {");
+
+                foreach (KeyValuePair<string, TypedConstant> property in properties)
+                {
+                    lineBuilder.Append(' ');
+                    lineBuilder.Append(property.Key);
+                    lineBuilder.Append(" = ");
+                    lineBuilder.Append(property.Value.ToCSharpString());
+                    lineBuilder.Append(',');
+                }
+
+                lineBuilder.Append(" })");
+            }
+
+            lineBuilder.Append(';');
+
+            lines.Add(lineBuilder.ToString());
+        }
+
+        foreach (string line in lines.OrderBy(x => x))
+        {
+            sourceBuilder.Append(line);
+        }
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/DependencyInjection/InjectionGenerator.cs

@@ -0,0 +1,126 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.CodeAnalysis;
+using Microsoft.CodeAnalysis.CSharp;
+using Microsoft.CodeAnalysis.CSharp.Syntax;
+using Snap.Hutao.SourceGeneration.Primitive;
+using System.Collections.Generic;
+using System.Collections.Immutable;
+using System.Linq;
+using System.Text;
+using System.Threading;
+
+namespace Snap.Hutao.SourceGeneration.DependencyInjection;
+
+[Generator(LanguageNames.CSharp)]
+internal sealed class InjectionGenerator : IIncrementalGenerator
+{
+    public const string AttributeName = "Snap.Hutao.Core.DependencyInjection.Annotation.InjectionAttribute";
+    public const string InjectAsSingletonName = "Snap.Hutao.Core.DependencyInjection.Annotation.InjectAs.Singleton";
+    public const string InjectAsTransientName = "Snap.Hutao.Core.DependencyInjection.Annotation.InjectAs.Transient";
+    public const string InjectAsScopedName = "Snap.Hutao.Core.DependencyInjection.Annotation.InjectAs.Scoped";
+
+    private static readonly DiagnosticDescriptor invalidInjectionDescriptor = new("SH101", "无效的 InjectAs 枚举值", "尚未支持生成 {0} 配置", "Quality", DiagnosticSeverity.Error, true);
+
+    public void Initialize(IncrementalGeneratorInitializationContext context)
+    {
+        IncrementalValueProvider<ImmutableArray<GeneratorSyntaxContext2>> injectionClasses = context.SyntaxProvider
+            .CreateSyntaxProvider(FilterAttributedClasses, HttpClientClass)
+            .Where(GeneratorSyntaxContext2.NotNull)
+            .Collect();
+
+        context.RegisterImplementationSourceOutput(injectionClasses, GenerateAddInjectionsImplementation);
+    }
+
+    private static bool FilterAttributedClasses(SyntaxNode node, CancellationToken token)
+    {
+        return node is ClassDeclarationSyntax classDeclarationSyntax
+            && classDeclarationSyntax.HasAttributeLists();
+    }
+
+    private static GeneratorSyntaxContext2 HttpClientClass(GeneratorSyntaxContext context, CancellationToken token)
+    {
+        if (context.TryGetDeclaredSymbol(token, out INamedTypeSymbol? classSymbol))
+        {
+            ImmutableArray<AttributeData> attributes = classSymbol.GetAttributes();
+            if (attributes.Any(data => data.AttributeClass!.ToDisplayString() == AttributeName))
+            {
+                return new(context, classSymbol, attributes);
+            }
+        }
+
+        return default;
+    }
+
+    private static void GenerateAddInjectionsImplementation(SourceProductionContext context, ImmutableArray<GeneratorSyntaxContext2> context2s)
+    {
+        StringBuilder sourceBuilder = new StringBuilder().Append($$"""
+            // Copyright (c) DGP Studio. All rights reserved.
+            // Licensed under the MIT license.
+
+            namespace Snap.Hutao.Core.DependencyInjection;
+            
+            internal static partial class ServiceCollectionExtension
+            {
+                [global::System.CodeDom.Compiler.GeneratedCodeAttribute("{{nameof(InjectionGenerator)}}", "1.0.0.0")]
+                public static partial IServiceCollection AddInjections(this IServiceCollection services)
+                {
+            """);
+
+        FillUpWithAddServices(sourceBuilder, context, context2s);
+        sourceBuilder.Append("""
+
+                    return services;
+                }
+            }
+            """);
+
+        context.AddSource("ServiceCollectionExtension.g.cs", sourceBuilder.ToString());
+    }
+
+    private static void FillUpWithAddServices(StringBuilder sourceBuilder, SourceProductionContext production, ImmutableArray<GeneratorSyntaxContext2> contexts)
+    {
+        List<string> lines = new();
+        StringBuilder lineBuilder = new();
+
+        foreach (GeneratorSyntaxContext2 context in contexts.DistinctBy(c => c.Symbol.ToDisplayString()))
+        {
+            lineBuilder.Clear().AppendLine();
+
+            AttributeData injectionInfo = context.SingleAttribute(AttributeName);
+            ImmutableArray<TypedConstant> arguments = injectionInfo.ConstructorArguments;
+
+            string injectAsName = arguments[0].ToCSharpString();
+            switch (injectAsName)
+            {
+                case InjectAsSingletonName:
+                    lineBuilder.Append("        services.AddSingleton<");
+                    break;
+                case InjectAsTransientName:
+                    lineBuilder.Append("        services.AddTransient<");
+                    break;
+                case InjectAsScopedName:
+                    lineBuilder.Append("        services.AddScoped<");
+                    break;
+                default:
+                    production.ReportDiagnostic(Diagnostic.Create(invalidInjectionDescriptor, context.Context.Node.GetLocation(), injectAsName));
+                    break;
+            }
+
+            if (arguments.Length == 2)
+            {
+                lineBuilder.Append($"{arguments[1].Value}, ");
+            }
+
+            lineBuilder.Append($"{context.Symbol.ToDisplayString()}>();");
+
+            lines.Add(lineBuilder.ToString());
+        }
+
+        foreach (string line in lines.OrderBy(x => x))
+        {
+            sourceBuilder.Append(line);
+        }
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/DependencyInjection/ServiceAnalyzer.cs

@@ -0,0 +1,78 @@
+using Microsoft.CodeAnalysis;
+using Microsoft.CodeAnalysis.CSharp;
+using Microsoft.CodeAnalysis.CSharp.Syntax;
+using Microsoft.CodeAnalysis.Diagnostics;
+using Snap.Hutao.SourceGeneration.Primitive;
+using System.Collections.Immutable;
+using System.Linq;
+
+namespace Snap.Hutao.SourceGeneration.DependencyInjection;
+
+[DiagnosticAnalyzer(LanguageNames.CSharp)]
+internal class ServiceAnalyzer : DiagnosticAnalyzer
+{
+    private static readonly DiagnosticDescriptor NonSingletonUseServiceProviderDescriptor = new("SH301", "Non Singleton service should avoid direct use of IServiceProvider", "Non Singleton service should avoid direct use of IServiceProvider", "Quality", DiagnosticSeverity.Info, true);
+    private static readonly DiagnosticDescriptor SingletonServiceCaptureNonSingletonServiceDescriptor = new("SH302", "Singleton service should avoid keep reference of non singleton service", "Singleton service should avoid keep reference of non singleton service", "Quality", DiagnosticSeverity.Info, true);
+
+    public override ImmutableArray<DiagnosticDescriptor> SupportedDiagnostics
+    {
+        get => new DiagnosticDescriptor[]
+    {
+        NonSingletonUseServiceProviderDescriptor,
+        SingletonServiceCaptureNonSingletonServiceDescriptor,
+    }.ToImmutableArray();
+    }
+
+    public override void Initialize(AnalysisContext context)
+    {
+        context.ConfigureGeneratedCodeAnalysis(GeneratedCodeAnalysisFlags.None);
+        context.EnableConcurrentExecution();
+
+        context.RegisterCompilationStartAction(CompilationStart);
+    }
+
+    private static void CompilationStart(CompilationStartAnalysisContext context)
+    {
+        context.RegisterSyntaxNodeAction(HandleNonSingletonUseServiceProvider, SyntaxKind.ClassDeclaration);
+        context.RegisterSyntaxNodeAction(HandleSingletonServiceCaptureNonSingletonService, SyntaxKind.ClassDeclaration);
+    }
+
+    private static void HandleNonSingletonUseServiceProvider(SyntaxNodeAnalysisContext context)
+    {
+        ClassDeclarationSyntax classDeclarationSyntax = (ClassDeclarationSyntax)context.Node;
+        if (classDeclarationSyntax.HasAttributeLists())
+        {
+            INamedTypeSymbol? classSymbol = context.SemanticModel.GetDeclaredSymbol(classDeclarationSyntax);
+            if (classSymbol is not null)
+            {
+                foreach (AttributeData attributeData in classSymbol.GetAttributes())
+                {
+                    if (attributeData.AttributeClass!.ToDisplayString() is InjectionGenerator.AttributeName)
+                    {
+                        string serviceType = attributeData.ConstructorArguments[0].ToCSharpString();
+                        if (serviceType is InjectionGenerator.InjectAsTransientName or InjectionGenerator.InjectAsScopedName)
+                        {
+                            HandleNonSingletonUseServiceProviderActual(context, classSymbol);
+                        }
+                    }
+                }
+            }
+        }
+    }
+
+    private static void HandleNonSingletonUseServiceProviderActual(SyntaxNodeAnalysisContext context, INamedTypeSymbol classSymbol)
+    {
+        ISymbol? symbol = classSymbol.GetMembers().Where(m => m is IFieldSymbol f && f.Type.ToDisplayString() == "System.IServiceProvider").SingleOrDefault();
+
+        if (symbol is not null)
+        {
+            Diagnostic diagnostic = Diagnostic.Create(NonSingletonUseServiceProviderDescriptor, symbol.Locations.FirstOrDefault());
+            context.ReportDiagnostic(diagnostic);
+        }
+    }
+
+    private static void HandleSingletonServiceCaptureNonSingletonService(SyntaxNodeAnalysisContext context)
+    {
+        //classSymbol.GetMembers().Where(m => m is IFieldSymbol { IsReadOnly: true, DeclaredAccessibility: Accessibility.Private } f);
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/Enum/LocalizedEnumGenerator.cs

@@ -0,0 +1,136 @@
+using Microsoft.CodeAnalysis;
+using Microsoft.CodeAnalysis.CSharp.Syntax;
+using Snap.Hutao.SourceGeneration.Primitive;
+using System.Collections.Generic;
+using System.Collections.Immutable;
+using System.Linq;
+using System.Text;
+using System.Threading;
+
+namespace Snap.Hutao.SourceGeneration.Enum;
+
+[Generator(LanguageNames.CSharp)]
+internal class LocalizedEnumGenerator : IIncrementalGenerator
+{
+    private const string AttributeName = "Snap.Hutao.Resource.Localization.LocalizationAttribute";
+    private const string LocalizationKeyName = "Snap.Hutao.Resource.Localization.LocalizationKeyAttribute";
+
+    public void Initialize(IncrementalGeneratorInitializationContext context)
+    {
+        IncrementalValuesProvider<GeneratorSyntaxContext2> localizationEnums = context.SyntaxProvider
+            .CreateSyntaxProvider(FilterAttributedEnums, LocalizationEnum)
+            .Where(GeneratorSyntaxContext2.NotNull);
+
+        context.RegisterSourceOutput(localizationEnums, GenerateGetLocalizedDescriptionImplementation);
+    }
+
+    private static bool FilterAttributedEnums(SyntaxNode node, CancellationToken token)
+    {
+        return node is EnumDeclarationSyntax enumDeclarationSyntax
+            && enumDeclarationSyntax.HasAttributeLists();
+    }
+
+    private static GeneratorSyntaxContext2 LocalizationEnum(GeneratorSyntaxContext context, CancellationToken token)
+    {
+        if (context.SemanticModel.GetDeclaredSymbol(context.Node, token) is INamedTypeSymbol enumSymbol)
+        {
+            ImmutableArray<AttributeData> attributes = enumSymbol.GetAttributes();
+            if (attributes.Any(data => data.AttributeClass!.ToDisplayString() == AttributeName))
+            {
+                return new(context, enumSymbol, attributes);
+            }
+        }
+
+        return default;
+    }
+
+    private static void GenerateGetLocalizedDescriptionImplementation(SourceProductionContext context, GeneratorSyntaxContext2 context2)
+    {
+        StringBuilder sourceBuilder = new StringBuilder().Append($$"""
+            // Copyright (c) DGP Studio. All rights reserved.
+            // Licensed under the MIT license.
+            
+            using System.Globalization;
+
+            namespace Snap.Hutao.Resource.Localization;
+
+            [global::System.CodeDom.Compiler.GeneratedCodeAttribute("{{nameof(LocalizedEnumGenerator)}}", "1.0.0.0")]
+            internal static class {{context2.Symbol.Name}}Extension
+            {
+                /// <summary>
+                /// 获取本地化的描述
+                /// </summary>
+                /// <param name="value">枚举值</param>
+                /// <returns>本地化的描述</returns>
+                public static string GetLocalizedDescription(this {{context2.Symbol}} value)
+                {
+                    string key = value switch
+                    {
+
+            """);
+
+        FillUpWithSwitchBranches(sourceBuilder, context2);
+
+        sourceBuilder.Append($$"""
+                        _ => string.Empty,
+                    };
+
+                    if (string.IsNullOrEmpty(key))
+                    {
+                        return Enum.GetName(value);
+                    }
+                    else
+                    {
+                        return SH.ResourceManager.GetString(key, CultureInfo.CurrentCulture);
+                    }
+                }
+
+                /// <summary>
+                /// 获取本地化的描述
+                /// </summary>
+                /// <param name="value">枚举值</param>
+                /// <returns>本地化的描述</returns>
+                [return:MaybeNull]
+                public static string GetLocalizedDescriptionOrDefault(this {{context2.Symbol}} value)
+                {
+                    string key = value switch
+                    {
+
+            """);
+
+        FillUpWithSwitchBranches(sourceBuilder, context2);
+
+        sourceBuilder.Append($$"""
+                        _ => string.Empty,
+                    };
+
+                    return SH.ResourceManager.GetString(key, CultureInfo.CurrentCulture);
+                }
+            }
+            """);
+
+        context.AddSource($"{context2.Symbol.Name}Extension.g.cs", sourceBuilder.ToString());
+    }
+
+    private static void FillUpWithSwitchBranches(StringBuilder sourceBuilder, GeneratorSyntaxContext2 context)
+    {
+        IEnumerable<IFieldSymbol> fields = context.Symbol.GetMembers()
+            .Where(m => m.Kind == SymbolKind.Field)
+            .Cast<IFieldSymbol>();
+
+        foreach (IFieldSymbol fieldSymbol in fields)
+        {
+            AttributeData? localizationKeyInfo = fieldSymbol.GetAttributes()
+                .SingleOrDefault(data => data.AttributeClass!.ToDisplayString() == LocalizationKeyName);
+            if (localizationKeyInfo != null)
+            {
+                sourceBuilder
+                    .Append("            ")
+                    .Append(fieldSymbol)
+                    .Append(" => \"")
+                    .Append(localizationKeyInfo.ConstructorArguments[0].Value)
+                    .AppendLine("\",");
+            }
+        }
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/GlobalSuppressions.cs

@@ -0,0 +1,8 @@
+// This file is used by Code Analysis to maintain SuppressMessage
+// attributes that are applied to this project.
+// Project-level suppressions either have no target or are given
+// a specific target and scoped to a namespace, type, member, etc.
+
+using System.Diagnostics.CodeAnalysis;
+
+[assembly: SuppressMessage("", "RS2008")]

src/Snap.Hutao/Snap.Hutao.SourceGeneration/Identity/IdentityGenerator.cs

@@ -0,0 +1,202 @@
+using Microsoft.CodeAnalysis;
+using System.Collections.Generic;
+using System.Collections.Immutable;
+using System.IO;
+using System.Linq;
+using System.Text;
+
+namespace Snap.Hutao.SourceGeneration.Identity;
+
+[Generator(LanguageNames.CSharp)]
+internal sealed class IdentityGenerator : IIncrementalGenerator
+{
+    private const string FileName = "IdentityStructs.json";
+
+    public void Initialize(IncrementalGeneratorInitializationContext context)
+    {
+        IncrementalValueProvider<ImmutableArray<AdditionalText>> provider = context.AdditionalTextsProvider.Where(MatchFileName).Collect();
+
+        context.RegisterImplementationSourceOutput(provider, GenerateIdentityStructs);
+    }
+
+    private static bool MatchFileName(AdditionalText text)
+    {
+        return Path.GetFileName(text.Path) == FileName;
+    }
+
+    private static void GenerateIdentityStructs(SourceProductionContext context, ImmutableArray<AdditionalText> texts)
+    {
+        AdditionalText jsonFile = texts.Single();
+
+        string identityJson = jsonFile.GetText(context.CancellationToken)!.ToString();
+        List<IdentityStructMetadata> identities = identityJson.FromJson<List<IdentityStructMetadata>>()!;
+
+        if (identities.Any())
+        {
+            foreach (IdentityStructMetadata identityStruct in identities)
+            {
+                GenerateIdentityStruct(context, identityStruct);
+            }
+        }
+    }
+
+    private static void GenerateIdentityStruct(SourceProductionContext context, IdentityStructMetadata metadata)
+    {
+        string name = metadata.Name;
+
+        StringBuilder sourceBuilder = new StringBuilder().AppendLine($$"""
+            // Copyright (c) DGP Studio. All rights reserved.
+            // Licensed under the MIT license.
+
+            using Snap.Hutao.Model.Primitive.Converter;
+            using System.Numerics;
+
+            namespace Snap.Hutao.Model.Primitive;
+
+            /// <summary>
+            /// {{metadata.Documentation}}
+            /// </summary>
+            [JsonConverter(typeof(IdentityConverter<{{name}}>))]
+            [global::System.CodeDom.Compiler.GeneratedCodeAttribute("{{nameof(IdentityGenerator)}}","1.0.0.0")]
+            internal readonly partial struct {{name}}
+            {
+                /// <summary>
+                /// 值
+                /// </summary>
+                public readonly uint Value;
+
+                /// <summary>
+                /// Initializes a new instance of the <see cref="{{name}}"/> struct.
+                /// </summary>
+                /// <param name="value">value</param>
+                public {{name}}(uint value)
+                {
+                    Value = value;
+                }
+
+                public static implicit operator uint({{name}} value)
+                {
+                    return value.Value;
+                }
+
+                public static implicit operator {{name}}(uint value)
+                {
+                    return new(value);
+                }
+
+                /// <inheritdoc/>
+                public override int GetHashCode()
+                {
+                    return Value.GetHashCode();
+                }
+
+                /// <inheritdoc/>
+                public override string ToString()
+                {
+                    return Value.ToString();
+                }
+            }
+            """);
+
+        if (metadata.Equatable)
+        {
+            sourceBuilder.AppendLine($$"""
+
+                internal readonly partial struct {{name}} : IEquatable<{{name}}>
+                {
+                    /// <inheritdoc/>
+                    public override bool Equals(object obj)
+                    {
+                        return obj is {{name}} other && Equals(other);
+                    }
+
+                    /// <inheritdoc/>
+                    public bool Equals({{name}} other)
+                    {
+                        return Value == other.Value;
+                    }
+                }
+                """);
+        }
+
+        if (metadata.EqualityOperators)
+        {
+            sourceBuilder.AppendLine($$"""
+
+                internal readonly partial struct {{name}} : IEqualityOperators<{{name}}, {{name}}, bool>, IEqualityOperators<{{name}}, uint, bool>
+                {
+                    public static bool operator ==({{name}} left, {{name}} right)
+                    {
+                        return left.Value == right.Value;
+                    }
+                
+                    public static bool operator ==({{name}} left, uint right)
+                    {
+                        return left.Value == right;
+                    }
+
+                    public static bool operator !=({{name}} left, {{name}} right)
+                    {
+                        return !(left == right);
+                    }
+
+                    public static bool operator !=({{name}} left, uint right)
+                    {
+                        return !(left == right);
+                    }
+                }
+                """);
+        }
+
+        if (metadata.AdditionOperators)
+        {
+            sourceBuilder.AppendLine($$"""
+
+                internal readonly partial struct {{name}} : IAdditionOperators<{{name}}, {{name}}, {{name}}>, IAdditionOperators<{{name}}, uint, {{name}}>
+                {
+                    public static {{name}} operator +({{name}} left, {{name}} right)
+                    {
+                        return left.Value + right.Value;
+                    }
+
+                    public static {{name}} operator +({{name}} left, uint right)
+                    {
+                        return left.Value + right;
+                    }
+                }
+                """);
+        }
+
+        if (metadata.IncrementOperators)
+        {
+            sourceBuilder.AppendLine($$"""
+
+                internal readonly partial struct {{name}} : IIncrementOperators<{{name}}>
+                {
+                    public static unsafe {{name}} operator ++({{name}} value)
+                    {
+                        ++*(uint*)&value;
+                        return value;
+                    }
+                }
+                """);
+        }
+
+        context.AddSource($"{name}.g.cs", sourceBuilder.ToString());
+    }
+
+    private sealed class IdentityStructMetadata
+    {
+        public string Name { get; set; } = default!;
+
+        public string? Documentation { get; set; }
+
+        public bool Equatable { get; set; }
+
+        public bool EqualityOperators { get; set; }
+
+        public bool AdditionOperators { get; set; }
+
+        public bool IncrementOperators { get; set; }
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/JsonParser.cs

@@ -0,0 +1,439 @@
+using System;
+using System.Collections;
+using System.Collections.Generic;
+using System.Reflection;
+using System.Runtime.Serialization;
+using System.Text;
+
+namespace Snap.Hutao.SourceGeneration;
+
+// Really simple JSON parser in ~300 lines
+// - Attempts to parse JSON files with minimal GC allocation
+// - Nice and simple "[1,2,3]".FromJson<List<int>>() API
+// - Classes and structs can be parsed too!
+//      class Foo { public int Value; }
+//      "{\"Value\":10}".FromJson<Foo>()
+// - Can parse JSON without type information into Dictionary<string,object> and List<object> e.g.
+//      "[1,2,3]".FromJson<object>().GetType() == typeof(List<object>)
+//      "{\"Value\":10}".FromJson<object>().GetType() == typeof(Dictionary<string,object>)
+// - No JIT Emit support to support AOT compilation on iOS
+// - Attempts are made to NOT throw an exception if the JSON is corrupted or invalid: returns null instead.
+// - Only public fields and property setters on classes/structs will be written to
+//
+// Limitations:
+// - No JIT Emit support to parse structures quickly
+// - Limited to parsing <2GB JSON files (due to int.MaxValue)
+// - Parsing of abstract classes or interfaces is NOT supported and will throw an exception.
+public static class JsonParser
+{
+    [ThreadStatic]
+    private static Stack<List<string>>? splitArrayPool;
+
+    [ThreadStatic]
+    private static StringBuilder? stringBuilder;
+
+    [ThreadStatic]
+    private static Dictionary<Type, Dictionary<string, FieldInfo>>? fieldInfoCache;
+
+    [ThreadStatic]
+    private static Dictionary<Type, Dictionary<string, PropertyInfo>>? propertyInfoCache;
+
+    public static T? FromJson<T>(this string json)
+    {
+        // Initialize, if needed, the ThreadStatic variables
+        propertyInfoCache ??= new Dictionary<Type, Dictionary<string, PropertyInfo>>();
+        fieldInfoCache ??= new Dictionary<Type, Dictionary<string, FieldInfo>>();
+        stringBuilder ??= new StringBuilder();
+        splitArrayPool ??= new Stack<List<string>>();
+
+        // Remove all whitespace not within strings to make parsing simpler
+        stringBuilder.Length = 0;
+        for (int i = 0; i < json.Length; i++)
+        {
+            char c = json[i];
+            if (c == '"')
+            {
+                i = AppendUntilStringEnd(true, i, json);
+                continue;
+            }
+            if (char.IsWhiteSpace(c))
+            {
+                continue;
+            }
+
+            stringBuilder.Append(c);
+        }
+
+        // Parse the thing!
+        return (T?)ParseValue(typeof(T), stringBuilder.ToString());
+    }
+
+    private static int AppendUntilStringEnd(bool appendEscapeCharacter, int startIdx, string json)
+    {
+        stringBuilder!.Append(json[startIdx]);
+        for (int i = startIdx + 1; i < json.Length; i++)
+        {
+            if (json[i] == '\\')
+            {
+                if (appendEscapeCharacter)
+                {
+                    stringBuilder.Append(json[i]);
+                }
+
+                stringBuilder.Append(json[i + 1]);
+                i++;//Skip next character as it is escaped
+            }
+            else if (json[i] == '"')
+            {
+                stringBuilder.Append(json[i]);
+                return i;
+            }
+            else
+            {
+                stringBuilder.Append(json[i]);
+            }
+        }
+        return json.Length - 1;
+    }
+
+    // Splits { <value>:<value>, <value>:<value> } and [ <value>, <value> ] into a list of <value> strings
+    private static List<string> Split(string json)
+    {
+        List<string> splitArray = splitArrayPool!.Count > 0 ? splitArrayPool.Pop() : new List<string>();
+        splitArray.Clear();
+        if (json.Length == 2)
+        {
+            return splitArray;
+        }
+
+        int parseDepth = 0;
+        stringBuilder!.Length = 0;
+        for (int i = 1; i < json.Length - 1; i++)
+        {
+            switch (json[i])
+            {
+                case '[':
+                case '{':
+                    parseDepth++;
+                    break;
+                case ']':
+                case '}':
+                    parseDepth--;
+                    break;
+                case '"':
+                    i = AppendUntilStringEnd(true, i, json);
+                    continue;
+                case ',':
+                case ':':
+                    if (parseDepth == 0)
+                    {
+                        splitArray.Add(stringBuilder.ToString());
+                        stringBuilder.Length = 0;
+                        continue;
+                    }
+                    break;
+            }
+
+            stringBuilder.Append(json[i]);
+        }
+
+        splitArray.Add(stringBuilder.ToString());
+
+        return splitArray;
+    }
+
+    internal static object? ParseValue(Type type, string json)
+    {
+        if (type == typeof(string))
+        {
+            if (json.Length <= 2)
+            {
+                return string.Empty;
+            }
+
+            StringBuilder parseStringBuilder = new(json.Length);
+            for (int i = 1; i < json.Length - 1; ++i)
+            {
+                if (json[i] == '\\' && i + 1 < json.Length - 1)
+                {
+                    int j = "\"\\nrtbf/".IndexOf(json[i + 1]);
+                    if (j >= 0)
+                    {
+                        parseStringBuilder.Append("\"\\\n\r\t\b\f/"[j]);
+                        ++i;
+                        continue;
+                    }
+                    if (json[i + 1] == 'u' && i + 5 < json.Length - 1)
+                    {
+                        if (uint.TryParse(json.Substring(i + 2, 4), System.Globalization.NumberStyles.AllowHexSpecifier, null, out uint c))
+                        {
+                            parseStringBuilder.Append((char)c);
+                            i += 5;
+                            continue;
+                        }
+                    }
+                }
+                parseStringBuilder.Append(json[i]);
+            }
+            return parseStringBuilder.ToString();
+        }
+        if (type.IsPrimitive)
+        {
+            object result = Convert.ChangeType(json, type, System.Globalization.CultureInfo.InvariantCulture);
+            return result;
+        }
+        if (type == typeof(decimal))
+        {
+            decimal.TryParse(json, System.Globalization.NumberStyles.Float, System.Globalization.CultureInfo.InvariantCulture, out decimal result);
+            return result;
+        }
+        if (type == typeof(DateTime))
+        {
+            DateTime.TryParse(json.Replace("\"", ""), System.Globalization.CultureInfo.InvariantCulture, System.Globalization.DateTimeStyles.None, out DateTime result);
+            return result;
+        }
+        if (json == "null")
+        {
+            return null;
+        }
+        if (type.IsEnum)
+        {
+            if (json[0] == '"')
+            {
+                json = json.Substring(1, json.Length - 2);
+            }
+
+            try
+            {
+                return System.Enum.Parse(type, json, false);
+            }
+            catch
+            {
+                return 0;
+            }
+        }
+        if (type.IsArray)
+        {
+            Type arrayType = type.GetElementType();
+            if (json[0] != '[' || json[json.Length - 1] != ']')
+            {
+                return null;
+            }
+
+            List<string> elems = Split(json);
+            Array newArray = Array.CreateInstance(arrayType, elems.Count);
+            for (int i = 0; i < elems.Count; i++)
+            {
+                newArray.SetValue(ParseValue(arrayType, elems[i]), i);
+            }
+
+            splitArrayPool!.Push(elems);
+            return newArray;
+        }
+        if (type.IsGenericType && type.GetGenericTypeDefinition() == typeof(List<>))
+        {
+            Type listType = type.GetGenericArguments()[0];
+            if (json[0] != '[' || json[json.Length - 1] != ']')
+            {
+                return null;
+            }
+
+            List<string> elems = Split(json);
+            IList list = (IList)type.GetConstructor(new Type[] { typeof(int) }).Invoke(new object[] { elems.Count });
+            for (int i = 0; i < elems.Count; i++)
+            {
+                list.Add(ParseValue(listType, elems[i]));
+            }
+
+            splitArrayPool!.Push(elems);
+            return list;
+        }
+        if (type.IsGenericType && type.GetGenericTypeDefinition() == typeof(Dictionary<,>))
+        {
+            Type keyType, valueType;
+            {
+                Type[] args = type.GetGenericArguments();
+                keyType = args[0];
+                valueType = args[1];
+            }
+
+            //Refuse to parse dictionary keys that aren't of type string
+            if (keyType != typeof(string))
+            {
+                return null;
+            }
+            //Must be a valid dictionary element
+            if (json[0] != '{' || json[json.Length - 1] != '}')
+            {
+                return null;
+            }
+            //The list is split into key/value pairs only, this means the split must be divisible by 2 to be valid JSON
+            List<string> elems = Split(json);
+            if (elems.Count % 2 != 0)
+            {
+                return null;
+            }
+
+            IDictionary dictionary = (IDictionary)type.GetConstructor(new Type[] { typeof(int) }).Invoke(new object[] { elems.Count / 2 });
+            for (int i = 0; i < elems.Count; i += 2)
+            {
+                if (elems[i].Length <= 2)
+                {
+                    continue;
+                }
+
+                string keyValue = elems[i].Substring(1, elems[i].Length - 2);
+                object? val = ParseValue(valueType, elems[i + 1]);
+                dictionary[keyValue] = val;
+            }
+            return dictionary;
+        }
+        if (type == typeof(object))
+        {
+            return ParseAnonymousValue(json);
+        }
+        if (json[0] == '{' && json[json.Length - 1] == '}')
+        {
+            return ParseObject(type, json);
+        }
+
+        return null;
+    }
+
+    private static object? ParseAnonymousValue(string json)
+    {
+        if (json.Length == 0)
+        {
+            return null;
+        }
+
+        if (json[0] == '{' && json[json.Length - 1] == '}')
+        {
+            List<string> elems = Split(json);
+            if (elems.Count % 2 != 0)
+            {
+                return null;
+            }
+
+            Dictionary<string, object?> dict = new(elems.Count / 2);
+            for (int i = 0; i < elems.Count; i += 2)
+            {
+                dict[elems[i].Substring(1, elems[i].Length - 2)] = ParseAnonymousValue(elems[i + 1]);
+            }
+
+            return dict;
+        }
+        if (json[0] == '[' && json[json.Length - 1] == ']')
+        {
+            List<string> items = Split(json);
+            List<object?> finalList = new(items.Count);
+            for (int i = 0; i < items.Count; i++)
+            {
+                finalList.Add(ParseAnonymousValue(items[i]));
+            }
+
+            return finalList;
+        }
+        if (json[0] == '"' && json[json.Length - 1] == '"')
+        {
+            string str = json.Substring(1, json.Length - 2);
+            return str.Replace("\\", string.Empty);
+        }
+        if (char.IsDigit(json[0]) || json[0] == '-')
+        {
+            if (json.Contains("."))
+            {
+                double.TryParse(json, System.Globalization.NumberStyles.Float, System.Globalization.CultureInfo.InvariantCulture, out double result);
+                return result;
+            }
+            else
+            {
+                int.TryParse(json, out int result);
+                return result;
+            }
+        }
+        if (json == "true")
+        {
+            return true;
+        }
+
+        if (json == "false")
+        {
+            return false;
+        }
+        // handles json == "null" as well as invalid JSON
+        return null;
+    }
+
+    private static Dictionary<string, T> CreateMemberNameDictionary<T>(T[] members) where T : MemberInfo
+    {
+        Dictionary<string, T> nameToMember = new(StringComparer.OrdinalIgnoreCase);
+        for (int i = 0; i < members.Length; i++)
+        {
+            T member = members[i];
+            if (member.IsDefined(typeof(IgnoreDataMemberAttribute), true))
+            {
+                continue;
+            }
+
+            string name = member.Name;
+            if (member.IsDefined(typeof(DataMemberAttribute), true))
+            {
+                DataMemberAttribute dataMemberAttribute = (DataMemberAttribute)Attribute.GetCustomAttribute(member, typeof(DataMemberAttribute), true);
+                if (!string.IsNullOrEmpty(dataMemberAttribute.Name))
+                {
+                    name = dataMemberAttribute.Name;
+                }
+            }
+
+            nameToMember.Add(name, member);
+        }
+
+        return nameToMember;
+    }
+
+    private static object ParseObject(Type type, string json)
+    {
+        object instance = FormatterServices.GetUninitializedObject(type);
+
+        // The list is split into key/value pairs only, this means the split must be divisible by 2 to be valid JSON
+        List<string> elems = Split(json);
+        if (elems.Count % 2 != 0)
+        {
+            return instance;
+        }
+
+        if (!fieldInfoCache!.TryGetValue(type, out Dictionary<string, FieldInfo> nameToField))
+        {
+            nameToField = CreateMemberNameDictionary(type.GetFields(BindingFlags.Instance | BindingFlags.Public | BindingFlags.FlattenHierarchy));
+            fieldInfoCache.Add(type, nameToField);
+        }
+        if (!propertyInfoCache!.TryGetValue(type, out Dictionary<string, PropertyInfo> nameToProperty))
+        {
+            nameToProperty = CreateMemberNameDictionary(type.GetProperties(BindingFlags.Instance | BindingFlags.Public | BindingFlags.FlattenHierarchy));
+            propertyInfoCache.Add(type, nameToProperty);
+        }
+
+        for (int i = 0; i < elems.Count; i += 2)
+        {
+            if (elems[i].Length <= 2)
+            {
+                continue;
+            }
+
+            string key = elems[i].Substring(1, elems[i].Length - 2);
+            string value = elems[i + 1];
+
+            if (nameToField.TryGetValue(key, out FieldInfo fieldInfo))
+            {
+                fieldInfo.SetValue(instance, ParseValue(fieldInfo.FieldType, value));
+            }
+            else if (nameToProperty.TryGetValue(key, out PropertyInfo propertyInfo))
+            {
+                propertyInfo.SetValue(instance, ParseValue(propertyInfo.PropertyType, value), null);
+            }
+        }
+
+        return instance;
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/Primitive/AttributeDataExtension.cs

@@ -0,0 +1,16 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.CodeAnalysis;
+using System;
+using System.Linq;
+
+namespace Snap.Hutao.SourceGeneration.Primitive;
+
+internal static class AttributeDataExtension
+{
+    public static bool HasNamedArgumentWith<TValue>(this AttributeData data, string key, Func<TValue, bool> predicate)
+    {
+        return data.NamedArguments.Any(a => a.Key == key && predicate((TValue)a.Value.Value!));
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/Primitive/EnumerableExtension.cs

@@ -0,0 +1,41 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace Snap.Hutao.SourceGeneration.Primitive;
+
+internal static class EnumerableExtension
+{
+    public static IEnumerable<TSource> DistinctBy<TSource, TKey>(this IEnumerable<TSource> source, Func<TSource, TKey> keySelector)
+    {
+        return DistinctByIterator(source, keySelector);
+    }
+
+    private static IEnumerable<TSource> DistinctByIterator<TSource, TKey>(IEnumerable<TSource> source, Func<TSource, TKey> keySelector)
+    {
+        using IEnumerator<TSource> enumerator = source.GetEnumerator();
+
+        if (enumerator.MoveNext())
+        {
+            HashSet<TKey> set = new();
+
+            do
+            {
+                TSource element = enumerator.Current;
+                if (set.Add(keySelector(element)))
+                {
+                    yield return element;
+                }
+            }
+            while (enumerator.MoveNext());
+        }
+    }
+
+    public static Dictionary<TKey, TValue> ToDictionary<TKey, TValue>(this IEnumerable<KeyValuePair<TKey, TValue>> source)
+    {
+        return source.ToDictionary(kvp => kvp.Key, kvp => kvp.Value);
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/Primitive/GeneratorSyntaxContext2.cs

@@ -0,0 +1,77 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.CodeAnalysis;
+using System.Collections.Immutable;
+using System.Linq;
+
+namespace Snap.Hutao.SourceGeneration.Primitive;
+
+internal readonly struct GeneratorSyntaxContext2
+{
+    public readonly GeneratorSyntaxContext Context;
+    public readonly INamedTypeSymbol Symbol;
+    public readonly ImmutableArray<AttributeData> Attributes;
+    public readonly bool HasValue = false;
+
+    public GeneratorSyntaxContext2(GeneratorSyntaxContext context, INamedTypeSymbol symbol, ImmutableArray<AttributeData> attributes)
+    {
+        Context = context;
+        Symbol = symbol;
+        Attributes = attributes;
+        HasValue = true;
+    }
+
+    public static bool NotNull(GeneratorSyntaxContext2 context)
+    {
+        return context.HasValue;
+    }
+
+    public bool HasAttributeWithName(string name)
+    {
+        return Attributes.Any(attr => attr.AttributeClass!.ToDisplayString() == name);
+    }
+
+    public AttributeData SingleAttribute(string name)
+    {
+        return Attributes.Single(attribute => attribute.AttributeClass!.ToDisplayString() == name);
+    }
+
+    public AttributeData? SingleOrDefaultAttribute(string name)
+    {
+        return Attributes.SingleOrDefault(attribute => attribute.AttributeClass!.ToDisplayString() == name);
+    }
+
+    public TSyntaxNode Node<TSyntaxNode>()
+        where TSyntaxNode : SyntaxNode
+    {
+        return (TSyntaxNode)Context.Node;
+    }
+}
+
+internal readonly struct GeneratorSyntaxContext2<TSymbol>
+    where TSymbol : ISymbol
+{
+    public readonly GeneratorSyntaxContext Context;
+    public readonly TSymbol Symbol;
+    public readonly ImmutableArray<AttributeData> Attributes;
+    public readonly bool HasValue = false;
+
+    public GeneratorSyntaxContext2(GeneratorSyntaxContext context, TSymbol symbol, ImmutableArray<AttributeData> attributes)
+    {
+        Context = context;
+        Symbol = symbol;
+        Attributes = attributes;
+        HasValue = true;
+    }
+
+    public static bool NotNull(GeneratorSyntaxContext2<TSymbol> context)
+    {
+        return context.HasValue;
+    }
+
+    public AttributeData SingleAttribute(string name)
+    {
+        return Attributes.Single(attribute => attribute.AttributeClass!.ToDisplayString() == name);
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/Primitive/GeneratorSyntaxContextExtension.cs

@@ -0,0 +1,18 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.CodeAnalysis;
+using Microsoft.CodeAnalysis.CSharp;
+using System.Diagnostics.CodeAnalysis;
+
+namespace Snap.Hutao.SourceGeneration.Primitive;
+
+internal static class GeneratorSyntaxContextExtension
+{
+    public static bool TryGetDeclaredSymbol<TSymbol>(this GeneratorSyntaxContext context, System.Threading.CancellationToken token, [NotNullWhen(true)] out TSymbol? symbol)
+        where TSymbol : class, ISymbol
+    {
+        symbol = context.SemanticModel.GetDeclaredSymbol(context.Node, token) as TSymbol;
+        return symbol != null;
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/Primitive/SymbolDisplayFormats.cs

@@ -0,0 +1,21 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.CodeAnalysis;
+
+namespace Snap.Hutao.SourceGeneration.Primitive;
+
+internal static class SymbolDisplayFormats
+{
+    public static SymbolDisplayFormat FullyQualifiedNonNullableFormat { get; } = new(
+        globalNamespaceStyle: SymbolDisplayGlobalNamespaceStyle.Omitted,
+        typeQualificationStyle: SymbolDisplayTypeQualificationStyle.NameAndContainingTypesAndNamespaces,
+        genericsOptions: SymbolDisplayGenericsOptions.IncludeTypeParameters,
+        miscellaneousOptions: SymbolDisplayMiscellaneousOptions.EscapeKeywordIdentifiers | SymbolDisplayMiscellaneousOptions.UseSpecialTypes);
+
+    public static SymbolDisplayFormat QualifiedNonNullableFormat { get; } = new(
+        globalNamespaceStyle: SymbolDisplayGlobalNamespaceStyle.Omitted,
+        typeQualificationStyle: SymbolDisplayTypeQualificationStyle.NameOnly,
+        genericsOptions: SymbolDisplayGenericsOptions.IncludeTypeParameters,
+        miscellaneousOptions: SymbolDisplayMiscellaneousOptions.EscapeKeywordIdentifiers | SymbolDisplayMiscellaneousOptions.UseSpecialTypes);
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/Primitive/SyntaxExtension.cs

@@ -0,0 +1,20 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.CodeAnalysis.CSharp.Syntax;
+
+namespace Snap.Hutao.SourceGeneration.Primitive;
+
+internal static class SyntaxExtension
+{
+    /// <summary>
+    /// Checks whether a given <see cref="MemberDeclarationSyntax"/> has or could potentially have any attribute lists.
+    /// </summary>
+    /// <param name="declaration">The input <see cref="MemberDeclarationSyntax"/> to check.</param>
+    /// <returns>Whether <paramref name="declaration"/> has or potentially has any attribute lists.</returns>
+    public static bool HasAttributeLists<TSyntax>(this TSyntax declaration)
+        where TSyntax : MemberDeclarationSyntax
+    {
+        return declaration.AttributeLists.Count > 0;
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/Primitive/TypeSymbolExtension.cs

@@ -0,0 +1,28 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.CodeAnalysis;
+
+namespace Snap.Hutao.SourceGeneration.Primitive;
+
+internal static class TypeSymbolExtension
+{
+    /// <summary>
+    /// Checks whether or not a given <see cref="ITypeSymbol"/> has or inherits from a specified type.
+    /// </summary>
+    /// <param name="typeSymbol">The target <see cref="ITypeSymbol"/> instance to check.</param>
+    /// <param name="name">The full name of the type to check for inheritance.</param>
+    /// <returns>Whether or not <paramref name="typeSymbol"/> is or inherits from <paramref name="name"/>.</returns>
+    public static bool IsOrInheritsFrom(this ITypeSymbol typeSymbol, string name)
+    {
+        for (ITypeSymbol? currentType = typeSymbol; currentType is not null; currentType = currentType.BaseType)
+        {
+            if (currentType.ToDisplayString() == name)
+            {
+                return true;
+            }
+        }
+
+        return false;
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/Resx/ResxGenerator.cs

@@ -0,0 +1,607 @@
+using Microsoft.CodeAnalysis;
+using Microsoft.CodeAnalysis.Diagnostics;
+using Microsoft.CodeAnalysis.Text;
+using System;
+using System.Collections.Generic;
+using System.Collections.Immutable;
+using System.Globalization;
+using System.IO;
+using System.Linq;
+using System.Text;
+using System.Text.RegularExpressions;
+using System.Xml.Linq;
+using System.Xml.XPath;
+
+namespace Snap.Hutao.SourceGeneration.Resx;
+
+[Generator]
+public sealed class ResxGenerator : IIncrementalGenerator
+{
+    private static readonly DiagnosticDescriptor InvalidResx = new("SH401", "Couldn't parse Resx file", "Couldn't parse Resx file '{0}'", "ResxGenerator", DiagnosticSeverity.Warning, true);
+    private static readonly DiagnosticDescriptor InvalidPropertiesForNamespace = new("SH402", "Couldn't compute namespace", "Couldn't compute namespace for file '{0}'", "ResxGenerator", DiagnosticSeverity.Warning, true);
+    private static readonly DiagnosticDescriptor InvalidPropertiesForResourceName = new("SH403", "Couldn't compute resource name", "Couldn't compute resource name for file '{0}'", "ResxGenerator", DiagnosticSeverity.Warning, true);
+    private static readonly DiagnosticDescriptor InconsistentProperties = new("SH404", "Inconsistent properties", "Property '{0}' values for '{1}' are inconsistent", "ResxGenerator", DiagnosticSeverity.Warning, true);
+
+    public void Initialize(IncrementalGeneratorInitializationContext context)
+    {
+        IncrementalValueProvider<(string? AssemblyName, bool SupportNullableReferenceTypes)> compilationProvider = context.CompilationProvider
+            .Select(static (compilation, cancellationToken) => (compilation.AssemblyName, SupportNullableReferenceTypes: compilation.GetTypeByMetadataName("System.Diagnostics.CodeAnalysis.NotNullIfNotNullAttribute") is not null));
+
+        IncrementalValueProvider<ImmutableArray<AdditionalText>> resxProvider = context.AdditionalTextsProvider
+            .Where(text => text.Path.EndsWith(".resx", StringComparison.OrdinalIgnoreCase))
+            .Collect();
+
+        context.RegisterSourceOutput(
+            source: context.AnalyzerConfigOptionsProvider.Combine(compilationProvider.Combine(resxProvider)),
+            action: (ctx, source) => Execute(ctx, source.Left, source.Right.Left.AssemblyName, source.Right.Left.SupportNullableReferenceTypes, source.Right.Right));
+    }
+
+    private static void Execute(SourceProductionContext context, AnalyzerConfigOptionsProvider options, string? assemblyName, bool supportNullableReferenceTypes, ImmutableArray<AdditionalText> files)
+    {
+        // Group additional file by resource kind ((a.resx, a.en.resx, a.en-us.resx), (b.resx, b.en-us.resx))
+        List<IGrouping<string, AdditionalText>> resxGroups = files
+            .GroupBy(file => GetResourceName(file.Path), StringComparer.OrdinalIgnoreCase)
+            .OrderBy(x => x.Key, StringComparer.Ordinal)
+            .ToList();
+
+        foreach (IGrouping<string, AdditionalText>? resxGroug in resxGroups)
+        {
+            string? rootNamespaceConfiguration = GetMetadataValue(context, options, "RootNamespace", resxGroug);
+            string? projectDirConfiguration = GetMetadataValue(context, options, "ProjectDir", resxGroug);
+            string? namespaceConfiguration = GetMetadataValue(context, options, "Namespace", "DefaultResourcesNamespace", resxGroug);
+            string? resourceNameConfiguration = GetMetadataValue(context, options, "ResourceName", globalName: null, resxGroug);
+            string? classNameConfiguration = GetMetadataValue(context, options, "ClassName", globalName: null, resxGroug);
+
+            string rootNamespace = rootNamespaceConfiguration ?? assemblyName ?? "";
+            string projectDir = projectDirConfiguration ?? assemblyName ?? "";
+            string? defaultResourceName = ComputeResourceName(rootNamespace, projectDir, resxGroug.Key);
+            string? defaultNamespace = ComputeNamespace(rootNamespace, projectDir, resxGroug.Key);
+
+            string? ns = namespaceConfiguration ?? defaultNamespace;
+            string? resourceName = resourceNameConfiguration ?? defaultResourceName;
+            string className = classNameConfiguration ?? ToCSharpNameIdentifier(Path.GetFileName(resxGroug.Key));
+
+            if (ns == null)
+            {
+                context.ReportDiagnostic(Diagnostic.Create(InvalidPropertiesForNamespace, location: null, resxGroug.First().Path));
+            }
+
+            if (resourceName == null)
+            {
+                context.ReportDiagnostic(Diagnostic.Create(InvalidPropertiesForResourceName, location: null, resxGroug.First().Path));
+            }
+
+            List<ResxEntry>? entries = LoadResourceFiles(context, resxGroug);
+
+            string content = $"""
+                // Debug info:
+                // key: {resxGroug.Key}
+                // files: {string.Join(", ", resxGroug.Select(f => f.Path))}
+                // RootNamespace (metadata): {rootNamespaceConfiguration}
+                // ProjectDir (metadata): {projectDirConfiguration}
+                // Namespace / DefaultResourcesNamespace (metadata): {namespaceConfiguration}
+                // ResourceName (metadata): {resourceNameConfiguration}
+                // ClassName (metadata): {classNameConfiguration}
+                // AssemblyName: {assemblyName}
+                // RootNamespace (computed): {rootNamespace}
+                // ProjectDir (computed): {projectDir}
+                // defaultNamespace: {defaultNamespace}
+                // defaultResourceName: {defaultResourceName}
+                // Namespace: {ns}
+                // ResourceName: {resourceName}
+                // ClassName: {className}
+                """;
+
+            if (resourceName != null && entries != null)
+            {
+                content += GenerateCode(ns, className, resourceName, entries, supportNullableReferenceTypes);
+            }
+
+            context.AddSource($"{Path.GetFileName(resxGroug.Key)}.resx.g.cs", SourceText.From(content, Encoding.UTF8));
+        }
+    }
+
+    private static string GenerateCode(string? ns, string className, string resourceName, List<ResxEntry> entries, bool enableNullableAttributes)
+    {
+        StringBuilder sb = new();
+        sb.AppendLine();
+        sb.AppendLine("#nullable enable");
+
+        if (ns != null)
+        {
+            sb.AppendLine($$"""
+
+                namespace {{ns}};
+
+                """);
+        }
+
+        sb.AppendLine($$"""
+            internal partial class {{className}}
+            {
+                private static global::System.Resources.ResourceManager? resourceMan;
+
+                public {{className}}()
+                {
+                }
+
+                [global::System.ComponentModel.EditorBrowsableAttribute(global::System.ComponentModel.EditorBrowsableState.Advanced)]
+                public static global::System.Resources.ResourceManager ResourceManager
+                {
+                    get
+                    {
+                        if (resourceMan is null) 
+                        {
+                            resourceMan = new global::System.Resources.ResourceManager("{{resourceName}}", typeof({{className}}).Assembly);
+                        }
+
+                        return resourceMan;
+                    }
+                }
+
+                [System.ComponentModel.EditorBrowsableAttribute(System.ComponentModel.EditorBrowsableState.Advanced)]
+                public static global::System.Globalization.CultureInfo? Culture { get; set; }
+
+                [return:global::System.Diagnostics.CodeAnalysis.NotNullIfNotNullAttribute("defaultValue")]
+                public static object? GetObject(global::System.Globalization.CultureInfo? culture, string name, object? defaultValue)
+                {
+                    culture ??= Culture;
+                    object? obj = ResourceManager.GetObject(name, culture);
+                    if (obj == null)
+                    {
+                        return defaultValue;
+                    }
+            
+                    return obj;
+                }
+
+                public static object? GetObject(global::System.Globalization.CultureInfo? culture, string name)
+                {
+                    return GetObject(culture: culture, name: name, defaultValue: null);
+                }
+            
+                public static object? GetObject(string name)
+                {
+                    return GetObject(culture: null, name: name, defaultValue: null);
+                }
+
+                [return:global::System.Diagnostics.CodeAnalysis.NotNullIfNotNullAttribute("defaultValue")]
+                public static object? GetObject(string name, object? defaultValue)
+                {
+                    return GetObject(culture: null, name: name, defaultValue: defaultValue);
+                }
+            
+                public static global::System.IO.Stream? GetStream(string name)
+                {
+                    return GetStream(culture: null, name: name);
+                }
+            
+                public static global::System.IO.Stream? GetStream(global::System.Globalization.CultureInfo? culture, string name)
+                {
+                    culture ??= Culture;
+                    return ResourceManager.GetStream(name, culture);
+                }
+            
+                public static string? GetString(global::System.Globalization.CultureInfo? culture, string name)
+                {
+                    return GetString(culture: culture, name: name, args: null);
+                }
+            
+                public static string? GetString(global::System.Globalization.CultureInfo? culture, string name, params object?[]? args)
+                {
+                    culture ??= Culture;
+                    string? str = ResourceManager.GetString(name, culture);
+                    if (str == null)
+                    {
+                        return null;
+                    }
+            
+                    if (args != null)
+                    {
+                        return string.Format(culture, str, args);
+                    }
+                    else
+                    {
+                        return str;
+                    }
+                }
+                
+                public static string? GetString(string name, params object?[]? args)
+                {
+                    return GetString(culture: null, name: name, args: args);
+                }
+
+                [return: global::System.Diagnostics.CodeAnalysis.NotNullIfNotNullAttribute("defaultValue")]
+                public static string? GetString(string name, string? defaultValue)
+                {
+                    return GetStringOrDefault(culture: null, name: name, defaultValue: defaultValue, args: null);
+                }
+            
+                public static string? GetString(string name)
+                {
+                    return GetStringOrDefault(culture: null, name: name, defaultValue: null, args: null);
+                }
+
+                [return:global::System.Diagnostics.CodeAnalysis.NotNullIfNotNullAttribute("defaultValue")]
+                public static string? GetStringOrDefault(global::System.Globalization.CultureInfo? culture, string name, string? defaultValue)
+                {
+                    return GetStringOrDefault(culture: culture, name: name, defaultValue: defaultValue, args: null);
+                }
+
+                [return:global::System.Diagnostics.CodeAnalysis.NotNullIfNotNullAttribute("defaultValue")]
+                public static string? GetStringOrDefault(global::System.Globalization.CultureInfo? culture, string name, string? defaultValue, params object?[]? args)
+                {
+                    culture ??= Culture;
+                    string? str = ResourceManager.GetString(name, culture);
+                    if (str == null)
+                    {
+                        if (defaultValue == null || args == null)
+                        {
+                            return defaultValue;
+                        }
+                        else
+                        {
+                            return string.Format(culture, defaultValue, args);
+                        }
+                    }
+            
+                    if (args != null)
+                    {
+                        return string.Format(culture, str, args);
+                    }
+                    else
+                    {
+                        return str;
+                    }
+                }
+
+                [return:global::System.Diagnostics.CodeAnalysis.NotNullIfNotNullAttribute("defaultValue")]
+                public static string? GetStringOrDefault(string name, string? defaultValue, params object?[]? args)
+                {
+                    return GetStringOrDefault(culture: null, name: name, defaultValue: defaultValue, args: args);
+                }
+
+                [return:global::System.Diagnostics.CodeAnalysis.NotNullIfNotNullAttribute("defaultValue")]
+                public static string? GetStringOrDefault(string name, string? defaultValue)
+                {
+                    return GetStringOrDefault(culture: null, name: name, defaultValue: defaultValue, args: null);
+                }
+            """);
+
+        foreach (ResxEntry? entry in entries.OrderBy(e => e.Name, StringComparer.Ordinal))
+        {
+            if (string.IsNullOrEmpty(entry.Name))
+            {
+                continue;
+            }
+
+            if (entry.IsText)
+            {
+                XElement summary = new("summary", new XElement("para", $"Looks up a localized string for \"{entry.Name}\"."));
+                if (!string.IsNullOrWhiteSpace(entry.Comment))
+                {
+                    summary.Add(new XElement("para", entry.Comment));
+                }
+
+                if (!entry.IsFileRef)
+                {
+                    summary.Add(new XElement("para", $"Value: \"{entry.Value}\"."));
+                }
+
+                string comment = summary.ToString().Replace("\r\n", "\r\n   /// ", StringComparison.Ordinal);
+
+                sb.AppendLine($$"""
+                        /// {{comment}}
+                        public static string {{ToCSharpNameIdentifier(entry.Name!)}}
+                        {
+                            get => GetString("{{entry.Name}}")!;
+                        }
+
+                    """);
+
+                if (entry.Value != null)
+                {
+                    int args = Regex.Matches(entry.Value, "\\{(?<num>[0-9]+)(\\:[^}]*)?\\}", RegexOptions.ExplicitCapture | RegexOptions.CultureInvariant)
+                        .Cast<Match>()
+                        .Select(m => int.Parse(m.Groups["num"].Value, CultureInfo.InvariantCulture))
+                        .Distinct()
+                        .DefaultIfEmpty(-1)
+                        .Max();
+
+                    if (args >= 0)
+                    {
+                        string inParams = string.Join(", ", Enumerable.Range(0, args + 1).Select(arg => "object? arg" + arg.ToString(CultureInfo.InvariantCulture)));
+                        string callParams = string.Join(", ", Enumerable.Range(0, args + 1).Select(arg => "arg" + arg.ToString(CultureInfo.InvariantCulture)));
+
+                        sb.AppendLine($$"""
+                                /// {{comment}}
+                                public static string Format{{ToCSharpNameIdentifier(entry.Name!)}}(global::System.Globalization.CultureInfo? provider, {{inParams}})
+                                {
+                                    return GetString(provider, "{{entry.Name}}", {{callParams}})!;
+                                }
+
+                                /// {{comment}}
+                                public static string Format{{ToCSharpNameIdentifier(entry.Name!)}}({{inParams}})
+                                {
+                                    return GetString("{{entry.Name}}", {{callParams}})!;
+                                }
+
+                            """);
+                    }
+                }
+            }
+            else
+            {
+                sb.AppendLine($$"""
+                        public static global::{{entry.FullTypeName}}? {{ToCSharpNameIdentifier(entry.Name!)}}
+                        {
+                            get => (global::{{entry.FullTypeName}}?)GetObject("{{entry.Name}}");
+                        }
+
+                    """);
+            }
+        }
+
+        sb.AppendLine($$"""
+            }
+
+            internal partial class {{className}}Names
+            {
+            """);
+
+        foreach (ResxEntry entry in entries)
+        {
+            if (string.IsNullOrEmpty(entry.Name))
+            {
+                continue;
+            }
+
+            sb.AppendLine($$"""
+                    public const string {{ToCSharpNameIdentifier(entry.Name!)}} = "entry.Name";
+                """);
+        }
+
+        sb.AppendLine("}");
+
+        return sb.ToString();
+    }
+
+    private static string? ComputeResourceName(string rootNamespace, string projectDir, string resourcePath)
+    {
+        string fullProjectDir = EnsureEndSeparator(Path.GetFullPath(projectDir));
+        string fullResourcePath = Path.GetFullPath(resourcePath);
+
+        if (fullProjectDir == fullResourcePath)
+        {
+            return rootNamespace;
+        }
+
+        if (fullResourcePath.StartsWith(fullProjectDir, StringComparison.Ordinal))
+        {
+            string relativePath = fullResourcePath.Substring(fullProjectDir.Length);
+            return rootNamespace + '.' + relativePath.Replace('/', '.').Replace('\\', '.');
+        }
+
+        return null;
+    }
+
+    private static string? ComputeNamespace(string rootNamespace, string projectDir, string resourcePath)
+    {
+        string fullProjectDir = EnsureEndSeparator(Path.GetFullPath(projectDir));
+        string fullResourcePath = EnsureEndSeparator(Path.GetDirectoryName(Path.GetFullPath(resourcePath))!);
+
+        if (fullProjectDir == fullResourcePath)
+        {
+            return rootNamespace;
+        }
+
+        if (fullResourcePath.StartsWith(fullProjectDir, StringComparison.Ordinal))
+        {
+            string relativePath = fullResourcePath.Substring(fullProjectDir.Length);
+            return rootNamespace + '.' + relativePath.Replace('/', '.').Replace('\\', '.').TrimEnd('.');
+        }
+
+        return null;
+    }
+
+    private static List<ResxEntry>? LoadResourceFiles(SourceProductionContext context, IGrouping<string, AdditionalText> resxGroug)
+    {
+        List<ResxEntry> entries = new();
+        foreach (AdditionalText? entry in resxGroug.OrderBy(file => file.Path, StringComparer.Ordinal))
+        {
+            SourceText? content = entry.GetText(context.CancellationToken);
+            if (content == null)
+            {
+                continue;
+            }
+
+            try
+            {
+                XDocument document = XDocument.Parse(content.ToString());
+                foreach (XElement? element in document.XPathSelectElements("/root/data"))
+                {
+                    string? name = element.Attribute("name")?.Value;
+                    string? type = element.Attribute("type")?.Value;
+                    string? comment = element.Attribute("comment")?.Value;
+                    string? value = element.Element("value")?.Value;
+
+                    ResxEntry existingEntry = entries.Find(e => e.Name == name);
+                    if (existingEntry != null)
+                    {
+                        existingEntry.Comment ??= comment;
+                    }
+                    else
+                    {
+                        entries.Add(new ResxEntry { Name = name, Value = value, Comment = comment, Type = type });
+                    }
+                }
+            }
+            catch
+            {
+                context.ReportDiagnostic(Diagnostic.Create(InvalidResx, location: null, entry.Path));
+                return null;
+            }
+        }
+
+        return entries;
+    }
+
+    private static string? GetMetadataValue(SourceProductionContext context, AnalyzerConfigOptionsProvider analyzerConfigOptionsProvider, string name, IEnumerable<AdditionalText> additionalFiles)
+    {
+        return GetMetadataValue(context, analyzerConfigOptionsProvider, name, name, additionalFiles);
+    }
+
+    private static string? GetMetadataValue(SourceProductionContext context, AnalyzerConfigOptionsProvider analyzerConfigOptionsProvider, string name, string? globalName, IEnumerable<AdditionalText> additionalFiles)
+    {
+        string? result = null;
+        foreach (AdditionalText file in additionalFiles)
+        {
+            if (analyzerConfigOptionsProvider.GetOptions(file).TryGetValue("build_metadata.AdditionalFiles." + name, out string? value))
+            {
+                if (result != null && value != result)
+                {
+                    context.ReportDiagnostic(Diagnostic.Create(InconsistentProperties, location: null, name, file.Path));
+                    return null;
+                }
+
+                result = value;
+            }
+        }
+
+        if (!string.IsNullOrEmpty(result))
+        {
+            return result;
+        }
+
+        if (globalName != null && analyzerConfigOptionsProvider.GlobalOptions.TryGetValue("build_property." + globalName, out string? globalValue) && !string.IsNullOrEmpty(globalValue))
+        {
+            return globalValue;
+        }
+
+        return null;
+    }
+
+    private static string ToCSharpNameIdentifier(string name)
+    {
+        // https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/language-specification/lexical-structure#identifiers
+        // https://docs.microsoft.com/en-us/dotnet/api/system.globalization.unicodecategory?view=net-5.0
+        StringBuilder sb = new();
+        foreach (char c in name)
+        {
+            UnicodeCategory category = char.GetUnicodeCategory(c);
+            switch (category)
+            {
+                case UnicodeCategory.UppercaseLetter:
+                case UnicodeCategory.LowercaseLetter:
+                case UnicodeCategory.TitlecaseLetter:
+                case UnicodeCategory.ModifierLetter:
+                case UnicodeCategory.OtherLetter:
+                case UnicodeCategory.LetterNumber:
+                    sb.Append(c);
+                    break;
+
+                case UnicodeCategory.DecimalDigitNumber:
+                case UnicodeCategory.ConnectorPunctuation:
+                case UnicodeCategory.Format:
+                    if (sb.Length == 0)
+                    {
+                        sb.Append('_');
+                    }
+                    sb.Append(c);
+                    break;
+
+                default:
+                    sb.Append('_');
+                    break;
+            }
+        }
+
+        return sb.ToString();
+    }
+
+    private static string EnsureEndSeparator(string path)
+    {
+        if (path[path.Length - 1] == Path.DirectorySeparatorChar)
+        {
+            return path;
+        }
+
+        return path + Path.DirectorySeparatorChar;
+    }
+
+    private static string GetResourceName(string path)
+    {
+        string pathWithoutExtension = Path.Combine(Path.GetDirectoryName(path)!, Path.GetFileNameWithoutExtension(path));
+        int indexOf = pathWithoutExtension.LastIndexOf('.');
+        if (indexOf < 0)
+        {
+            return pathWithoutExtension;
+        }
+
+        return Regex.IsMatch(pathWithoutExtension.Substring(indexOf + 1), "^[a-zA-Z]{2}(-[a-zA-Z]{2})?$", RegexOptions.ExplicitCapture | RegexOptions.CultureInvariant, TimeSpan.FromSeconds(1))
+            ? pathWithoutExtension.Substring(0, indexOf)
+            : pathWithoutExtension;
+    }
+
+    private sealed class ResxEntry
+    {
+        public string? Name { get; set; }
+        public string? Value { get; set; }
+        public string? Comment { get; set; }
+        public string? Type { get; set; }
+
+        public bool IsText
+        {
+            get
+            {
+                if (Type == null)
+                {
+                    return true;
+                }
+
+                if (Value != null)
+                {
+                    string[] parts = Value.Split(';');
+                    if (parts.Length > 1)
+                    {
+                        string type = parts[1];
+                        if (type.StartsWith("System.String,", StringComparison.Ordinal))
+                        {
+                            return true;
+                        }
+                    }
+                }
+
+                return false;
+            }
+        }
+
+        public string? FullTypeName
+        {
+            get
+            {
+                if (IsText)
+                {
+                    return "string";
+                }
+
+                if (Value != null)
+                {
+                    string[] parts = Value.Split(';');
+                    if (parts.Length > 1)
+                    {
+                        string type = parts[1];
+                        return type.Split(',')[0];
+                    }
+                }
+
+                return null;
+            }
+        }
+
+        public bool IsFileRef
+        {
+            get => Type != null && Type.StartsWith("System.Resources.ResXFileRef,", StringComparison.Ordinal);
+        }
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/Resx/StringExtensions.cs

@@ -0,0 +1,27 @@
+using System;
+using System.Text;
+
+namespace Snap.Hutao.SourceGeneration.Resx;
+
+internal static class StringExtensions
+{
+    public static string Replace(this string str, string oldValue, string newValue, StringComparison comparison)
+    {
+        StringBuilder sb = new();
+
+        int previousIndex = 0;
+        int index = str.IndexOf(oldValue, comparison);
+        while (index is not -1)
+        {
+            sb.Append(str, previousIndex, index - previousIndex);
+            sb.Append(newValue);
+            index += oldValue.Length;
+
+            previousIndex = index;
+            index = str.IndexOf(oldValue, index, comparison);
+        }
+
+        sb.Append(str, previousIndex, str.Length - previousIndex);
+        return sb.ToString();
+    }
+}

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

@@ -0,0 +1,26 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>netstandard2.0</TargetFramework>
+    <IsPackable>false</IsPackable>
+    <LangVersion>latest</LangVersion>
+    <Nullable>enable</Nullable>
+    <Platforms>x64</Platforms>
+    <EnforceExtendedAnalyzerRules>true</EnforceExtendedAnalyzerRules>
+    <Configurations>Debug;Release;Debug As Fake Elevated</Configurations>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <None Remove="stylecop.json" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <AdditionalFiles Include="stylecop.json" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" PrivateAssets="all" Version="3.3.4" />
+    <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.7.0" />
+  </ItemGroup>
+
+</Project>

src/Snap.Hutao/Snap.Hutao.SourceGeneration/UniversalAnalyzer.cs

@@ -0,0 +1,312 @@
+using Microsoft.CodeAnalysis;
+using Microsoft.CodeAnalysis.CSharp;
+using Microsoft.CodeAnalysis.CSharp.Syntax;
+using Microsoft.CodeAnalysis.Diagnostics;
+using Snap.Hutao.SourceGeneration.Primitive;
+using System.Collections.Generic;
+using System.Collections.Immutable;
+using System.Linq;
+
+namespace Snap.Hutao.SourceGeneration;
+
+/// <summary>
+/// 通用分析器
+/// </summary>
+[DiagnosticAnalyzer(LanguageNames.CSharp)]
+internal sealed class UniversalAnalyzer : DiagnosticAnalyzer
+{
+    private static readonly DiagnosticDescriptor typeInternalDescriptor = new("SH001", "Type should be internal", "Type [{0}] should be internal", "Quality", DiagnosticSeverity.Info, true);
+    private static readonly DiagnosticDescriptor readOnlyStructRefDescriptor = new("SH002", "ReadOnly struct should be passed with ref-like key word", "ReadOnly Struct [{0}] should be passed with ref-like key word", "Quality", DiagnosticSeverity.Info, true);
+    private static readonly DiagnosticDescriptor useValueTaskIfPossibleDescriptor = new("SH003", "Use ValueTask instead of Task whenever possible", "Use ValueTask instead of Task", "Quality", DiagnosticSeverity.Info, true);
+    private static readonly DiagnosticDescriptor useIsNotNullPatternMatchingDescriptor = new("SH004", "Use \"is not null\" instead of \"!= null\" whenever possible", "Use \"is not null\" instead of \"!= null\"", "Quality", DiagnosticSeverity.Info, true);
+    private static readonly DiagnosticDescriptor useIsNullPatternMatchingDescriptor = new("SH005", "Use \"is null\" instead of \"== null\" whenever possible", "Use \"is null\" instead of \"== null\"", "Quality", DiagnosticSeverity.Info, true);
+    private static readonly DiagnosticDescriptor useIsPatternRecursiveMatchingDescriptor = new("SH006", "Use \"is { } obj\" whenever possible", "Use \"is {{ }} {0}\"", "Quality", DiagnosticSeverity.Info, true);
+    private static readonly DiagnosticDescriptor useArgumentNullExceptionThrowIfNullDescriptor = new("SH007", "Use \"ArgumentNullException.ThrowIfNull()\" instead of \"!\"", "Use \"ArgumentNullException.ThrowIfNull()\"", "Quality", DiagnosticSeverity.Info, true);
+
+
+    private static readonly ImmutableHashSet<string> RefLikeKeySkipTypes = new HashSet<string>()
+    {
+        "System.Threading.CancellationToken",
+        "System.Guid"
+    }.ToImmutableHashSet();
+
+    public override ImmutableArray<DiagnosticDescriptor> SupportedDiagnostics
+    {
+        get
+        {
+            return new DiagnosticDescriptor[]
+            {
+                typeInternalDescriptor,
+                readOnlyStructRefDescriptor,
+                useValueTaskIfPossibleDescriptor,
+                useIsNotNullPatternMatchingDescriptor,
+                useIsNullPatternMatchingDescriptor,
+                useIsPatternRecursiveMatchingDescriptor,
+                useArgumentNullExceptionThrowIfNullDescriptor
+            }.ToImmutableArray();
+        }
+    }
+
+    public override void Initialize(AnalysisContext context)
+    {
+        context.ConfigureGeneratedCodeAnalysis(GeneratedCodeAnalysisFlags.None);
+        context.EnableConcurrentExecution();
+
+        context.RegisterCompilationStartAction(CompilationStart);
+    }
+
+    private static void CompilationStart(CompilationStartAnalysisContext context)
+    {
+        SyntaxKind[] types =
+        {
+            SyntaxKind.ClassDeclaration,
+            SyntaxKind.InterfaceDeclaration,
+            SyntaxKind.StructDeclaration,
+            SyntaxKind.EnumDeclaration,
+        };
+        context.RegisterSyntaxNodeAction(HandleTypeShouldBeInternal, types);
+        context.RegisterSyntaxNodeAction(HandleMethodParameterShouldUseRefLikeKeyword, SyntaxKind.MethodDeclaration);
+        context.RegisterSyntaxNodeAction(HandleMethodReturnTypeShouldUseValueTaskInsteadOfTask, SyntaxKind.MethodDeclaration);
+        context.RegisterSyntaxNodeAction(HandleConstructorParameterShouldUseRefLikeKeyword, SyntaxKind.ConstructorDeclaration);
+
+        SyntaxKind[] expressions =
+        {
+            SyntaxKind.EqualsExpression,
+            SyntaxKind.NotEqualsExpression,
+        };
+        context.RegisterSyntaxNodeAction(HandleEqualsAndNotEqualsExpressionShouldUsePatternMatching, expressions);
+        context.RegisterSyntaxNodeAction(HandleIsPatternShouldUseRecursivePattern, SyntaxKind.IsPatternExpression);
+        context.RegisterSyntaxNodeAction(HandleArgumentNullExceptionThrowIfNull, SyntaxKind.SuppressNullableWarningExpression);
+
+        // TODO add analyzer for unnecessary IServiceProvider registration
+        // TODO add analyzer for Singlton service use Scoped or Transient services
+    }
+
+    private static void HandleTypeShouldBeInternal(SyntaxNodeAnalysisContext context)
+    {
+        BaseTypeDeclarationSyntax syntax = (BaseTypeDeclarationSyntax)context.Node;
+
+        bool privateExists = false;
+        bool internalExists = false;
+        bool fileExists = false;
+
+        foreach (SyntaxToken token in syntax.Modifiers)
+        {
+            if (token.IsKind(SyntaxKind.PrivateKeyword))
+            {
+                privateExists = true;
+            }
+
+            if (token.IsKind(SyntaxKind.InternalKeyword))
+            {
+                internalExists = true;
+            }
+
+            if (token.IsKind(SyntaxKind.FileKeyword))
+            {
+                fileExists = true;
+            }
+        }
+
+        if (!privateExists && !internalExists && !fileExists)
+        {
+            Location location = syntax.Identifier.GetLocation();
+            Diagnostic diagnostic = Diagnostic.Create(typeInternalDescriptor, location, syntax.Identifier);
+            context.ReportDiagnostic(diagnostic);
+        }
+    }
+
+    private static void HandleMethodReturnTypeShouldUseValueTaskInsteadOfTask(SyntaxNodeAnalysisContext context)
+    {
+        MethodDeclarationSyntax methodSyntax = (MethodDeclarationSyntax)context.Node;
+        IMethodSymbol methodSymbol = context.SemanticModel.GetDeclaredSymbol(methodSyntax)!;
+
+        // 跳过重载方法
+        if (methodSyntax.Modifiers.Any(token => token.IsKind(SyntaxKind.OverrideKeyword)))
+        {
+            return;
+        }
+
+        // ICommand can only use Task or Task<T>
+        if (methodSymbol.GetAttributes().Any(attr => attr.AttributeClass!.ToDisplayString() == Automation.CommandGenerator.AttributeName))
+        {
+            return;
+        }
+
+        if (methodSymbol.ReturnType.IsOrInheritsFrom("System.Threading.Tasks.Task"))
+        {
+            Location location = methodSyntax.ReturnType.GetLocation();
+            Diagnostic diagnostic = Diagnostic.Create(useValueTaskIfPossibleDescriptor, location);
+            context.ReportDiagnostic(diagnostic);
+        }
+    }
+
+    private static void HandleMethodParameterShouldUseRefLikeKeyword(SyntaxNodeAnalysisContext context)
+    {
+        MethodDeclarationSyntax methodSyntax = (MethodDeclarationSyntax)context.Node;
+
+        // 跳过方法定义 如 接口
+        if (methodSyntax.Body == null)
+        {
+            return;
+        }
+
+        IMethodSymbol methodSymbol = context.SemanticModel.GetDeclaredSymbol(methodSyntax)!;
+
+        if (methodSymbol.ReturnType.IsOrInheritsFrom("System.Threading.Tasks.Task"))
+        {
+            return;
+        }
+
+        if (methodSymbol.ReturnType.IsOrInheritsFrom("System.Threading.Tasks.ValueTask"))
+        {
+            return;
+        }
+
+        foreach (SyntaxToken token in methodSyntax.Modifiers)
+        {
+            // 跳过异步方法，因为异步方法无法使用 ref/in/out
+            if (token.IsKind(SyntaxKind.AsyncKeyword))
+            {
+                return;
+            }
+
+            // 跳过重载方法
+            if (token.IsKind(SyntaxKind.OverrideKeyword))
+            {
+                return;
+            }
+        }
+
+        foreach (ParameterSyntax parameter in methodSyntax.ParameterList.Parameters)
+        {
+            if (context.SemanticModel.GetDeclaredSymbol(parameter) is IParameterSymbol symbol)
+            {
+                if (IsBuiltInType(symbol.Type))
+                {
+                    continue;
+                }
+
+                if (RefLikeKeySkipTypes.Contains(symbol.Type.ToDisplayString()))
+                {
+                    continue;
+                }
+
+                if (symbol.Type.IsReadOnly && symbol.RefKind == RefKind.None)
+                {
+                    Location location = parameter.GetLocation();
+                    Diagnostic diagnostic = Diagnostic.Create(readOnlyStructRefDescriptor, location, symbol.Type);
+                    context.ReportDiagnostic(diagnostic);
+                }
+            }
+        }
+    }
+
+    private static void HandleConstructorParameterShouldUseRefLikeKeyword(SyntaxNodeAnalysisContext context)
+    {
+        ConstructorDeclarationSyntax constructorSyntax = (ConstructorDeclarationSyntax)context.Node;
+
+        foreach (ParameterSyntax parameter in constructorSyntax.ParameterList.Parameters)
+        {
+            if (context.SemanticModel.GetDeclaredSymbol(parameter) is IParameterSymbol symbol)
+            {
+                if (IsBuiltInType(symbol.Type))
+                {
+                    continue;
+                }
+
+                // 跳过 CancellationToken
+                if (symbol.Type.ToDisplayString() == "System.Threading.CancellationToken")
+                {
+                    continue;
+                }
+
+                if (symbol.Type.IsReadOnly && symbol.RefKind == RefKind.None)
+                {
+                    Location location = parameter.GetLocation();
+                    Diagnostic diagnostic = Diagnostic.Create(readOnlyStructRefDescriptor, location, symbol.Type);
+                    context.ReportDiagnostic(diagnostic);
+                }
+            }
+        }
+    }
+
+    public static void HandleEqualsAndNotEqualsExpressionShouldUsePatternMatching(SyntaxNodeAnalysisContext context)
+    {
+        BinaryExpressionSyntax syntax = (BinaryExpressionSyntax)context.Node;
+        if (syntax.IsKind(SyntaxKind.NotEqualsExpression) && syntax.Right.IsKind(SyntaxKind.NullLiteralExpression))
+        {
+            Location location = syntax.OperatorToken.GetLocation();
+            Diagnostic diagnostic = Diagnostic.Create(useIsNotNullPatternMatchingDescriptor, location);
+            context.ReportDiagnostic(diagnostic);
+        }
+        else if (syntax.IsKind(SyntaxKind.EqualsExpression) && syntax.Right.IsKind(SyntaxKind.NullLiteralExpression))
+        {
+            Location location = syntax.OperatorToken.GetLocation();
+            Diagnostic diagnostic = Diagnostic.Create(useIsNullPatternMatchingDescriptor, location);
+            context.ReportDiagnostic(diagnostic);
+        }
+    }
+
+    private static void HandleIsPatternShouldUseRecursivePattern(SyntaxNodeAnalysisContext context)
+    {
+        IsPatternExpressionSyntax syntax = (IsPatternExpressionSyntax)context.Node;
+        if (syntax.Pattern is DeclarationPatternSyntax declaration)
+        {
+            ITypeSymbol? leftType = context.SemanticModel.GetTypeInfo(syntax.Expression).ConvertedType;
+            ITypeSymbol? rightType = context.SemanticModel.GetTypeInfo(declaration).ConvertedType;
+            if (SymbolEqualityComparer.Default.Equals(leftType, rightType))
+            {
+                Location location = declaration.GetLocation();
+                Diagnostic diagnostic = Diagnostic.Create(useIsPatternRecursiveMatchingDescriptor, location, declaration.Designation);
+                context.ReportDiagnostic(diagnostic);
+            }
+        }
+    }
+
+    private static void HandleArgumentNullExceptionThrowIfNull(SyntaxNodeAnalysisContext context)
+    {
+        PostfixUnaryExpressionSyntax syntax = (PostfixUnaryExpressionSyntax)context.Node;
+
+        if (syntax.Operand is LiteralExpressionSyntax literal)
+        {
+            if (literal.IsKind(SyntaxKind.DefaultLiteralExpression))
+            {
+                return;
+            }
+        }
+
+        if (syntax.Operand is DefaultExpressionSyntax expression)
+        {
+            return;
+        }
+
+
+        Location location = syntax.GetLocation();
+        Diagnostic diagnostic = Diagnostic.Create(useArgumentNullExceptionThrowIfNullDescriptor, location);
+        context.ReportDiagnostic(diagnostic);
+    }
+
+    private static bool IsBuiltInType(ITypeSymbol symbol)
+    {
+        return symbol.SpecialType switch
+        {
+            SpecialType.System_Boolean => true,
+            SpecialType.System_Char => true,
+            SpecialType.System_SByte => true,
+            SpecialType.System_Byte => true,
+            SpecialType.System_Int16 => true,
+            SpecialType.System_UInt16 => true,
+            SpecialType.System_Int32 => true,
+            SpecialType.System_UInt32 => true,
+            SpecialType.System_Int64 => true,
+            SpecialType.System_UInt64 => true,
+            SpecialType.System_Decimal => true,
+            SpecialType.System_Single => true,
+            SpecialType.System_Double => true,
+            SpecialType.System_IntPtr => true,
+            SpecialType.System_UIntPtr => true,
+            _ => false,
+        };
+    }
+}

src/Snap.Hutao/Snap.Hutao.SourceGeneration/stylecop.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://raw.githubusercontent.com/DotNetAnalyzers/StyleCopAnalyzers/master/StyleCop.Analyzers/StyleCop.Analyzers/Settings/stylecop.schema.json",
+  "settings": {
+    "documentationRules": {
+      "companyName": "DGP Studio",
+      "copyrightText": "Copyright (c) {companyName}. All rights reserved.\nLicensed under the {licenseName} license.",
+      "xmlHeader": false,
+      "variables": {
+        "licenseName": "MIT"
+      }
+    },
+    "orderingRules": {
+      "elementOrder": [
+        "kind",
+        "accessibility",
+        "constant",
+        "static",
+        "readonly"
+      ],
+      "usingDirectivesPlacement": "outsideNamespace"
+    }
+  }
+}

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

@@ -1,37 +0,0 @@
-using System.Collections.Generic;
-using System.Runtime.CompilerServices;
-using System.Runtime.InteropServices;
-
-namespace Snap.Hutao.Test.BaseClassLibrary;
-
-[TestClass]
-public class CollectionsMarshalTest
-{
-    [TestMethod]
-    public void DictionaryMarshalGetValueRefOrNullRefIsNullRef()
-    {
-        Dictionary<uint, string> dictionaryValueKeyRefValue = [];
-        Dictionary<uint, uint> dictionaryValueKeyValueValue = [];
-        Dictionary<string, uint> dictionaryRefKeyValueValue = [];
-        Dictionary<string, string> dictionaryRefKeyRefValue = [];
-
-        Assert.IsTrue(Unsafe.IsNullRef(ref CollectionsMarshal.GetValueRefOrNullRef(dictionaryValueKeyRefValue, 1U)));
-        Assert.IsTrue(Unsafe.IsNullRef(ref CollectionsMarshal.GetValueRefOrNullRef(dictionaryValueKeyValueValue, 1U)));
-        Assert.IsTrue(Unsafe.IsNullRef(ref CollectionsMarshal.GetValueRefOrNullRef(dictionaryRefKeyValueValue, "no such key")));
-        Assert.IsTrue(Unsafe.IsNullRef(ref CollectionsMarshal.GetValueRefOrNullRef(dictionaryRefKeyRefValue, "no such key")));
-    }
-
-    [TestMethod]
-    public void DictionaryMarshalGetValueRefOrAddDefaultIsDefault()
-    {
-        Dictionary<uint, string> dictionaryValueKeyRefValue = [];
-        Dictionary<uint, uint> dictionaryValueKeyValueValue = [];
-        Dictionary<string, uint> dictionaryRefKeyValueValue = [];
-        Dictionary<string, string> dictionaryRefKeyRefValue = [];
-
-        Assert.IsTrue(CollectionsMarshal.GetValueRefOrAddDefault(dictionaryValueKeyRefValue, 1U, out _) == default);
-        Assert.IsTrue(CollectionsMarshal.GetValueRefOrAddDefault(dictionaryValueKeyValueValue, 1U, out _) == default);
-        Assert.IsTrue(CollectionsMarshal.GetValueRefOrAddDefault(dictionaryRefKeyValueValue, "no such key", out _) == default);
-        Assert.IsTrue(CollectionsMarshal.GetValueRefOrAddDefault(dictionaryRefKeyRefValue, "no such key", out _) == default);
-    }
-}

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

@@ -1,117 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Text.Json;
-using System.Text.Json.Serialization;
-
-namespace Snap.Hutao.Test.BaseClassLibrary;
-
-[TestClass]
-public sealed class JsonSerializeTest
-{
-    private readonly JsonSerializerOptions AlowStringNumberOptions = new()
-    {
-        NumberHandling = JsonNumberHandling.AllowReadingFromString,
-    };
-
-    private const string SmapleObjectJson = """
-        {
-            "A" :1
-        }
-        """;
-
-    private const string SmapleEmptyStringObjectJson = """
-        {
-            "A" : ""
-        }
-        """;
-
-    private const string SmapleNumberKeyDictionaryJson = """
-        {
-            "111" : "12",
-            "222" : "34"
-        }
-        """;
-
-    [TestMethod]
-    public void DelegatePropertyCanSerialize()
-    {
-        SampleDelegatePropertyClass sample = JsonSerializer.Deserialize<SampleDelegatePropertyClass>(SmapleObjectJson)!;
-        Assert.AreEqual(sample.B, 1);
-    }
-
-    [TestMethod]
-    [ExpectedException(typeof(JsonException))]
-    public void EmptyStringCannotSerializeAsNumber()
-    {
-        SampleStringReadWriteNumberPropertyClass sample = JsonSerializer.Deserialize<SampleStringReadWriteNumberPropertyClass>(SmapleEmptyStringObjectJson)!;
-        Assert.AreEqual(sample.A, 0);
-    }
-
-    [TestMethod]
-    public void NumberStringKeyCanSerializeAsKey()
-    {
-        Dictionary<int, string> sample = JsonSerializer.Deserialize<Dictionary<int, string>>(SmapleNumberKeyDictionaryJson, AlowStringNumberOptions)!;
-        Assert.AreEqual(sample[111], "12");
-    }
-
-    [TestMethod]
-    public void ByteArraySerializeAsBase64()
-    {
-        SampleByteArrayPropertyClass sample = new()
-        {
-            Array = [1, 2, 3, 4, 5],
-        };
-
-        string result = JsonSerializer.Serialize(sample);
-        Assert.AreEqual(result, """{"Array":"AQIDBAU="}""");
-    }
-
-    [TestMethod]
-    public void InterfaceDefaultMethodCanSerializeActualInstanceMember()
-    {
-        ISampleInterface sample = new SampleClassImplementedInterface()
-        {
-            A = 1,
-            B = 2,
-        };
-
-        string result = sample.ToJson();
-        Console.WriteLine(result);
-        Assert.AreEqual(result, """{"A":1,"B":2}""");
-    }
-
-    private sealed class SampleDelegatePropertyClass
-    {
-        public int A { get => B; set => B = value; }
-        public int B { get; set; }
-    }
-
-    private sealed class SampleStringReadWriteNumberPropertyClass
-    {
-        [JsonNumberHandling(JsonNumberHandling.AllowReadingFromString | JsonNumberHandling.WriteAsString)]
-        public int A { get; set; }
-    }
-
-    private sealed class SampleByteArrayPropertyClass
-    {
-        public byte[]? Array { get; set; }
-    }
-
-    private sealed class SampleClassImplementedInterface : ISampleInterface
-    {
-        public int A { get; set; }
-
-        public int B { get; set; }
-    }
-
-    [JsonDerivedType(typeof(SampleClassImplementedInterface))]
-    private interface ISampleInterface
-    {
-        int A { get; set; }
-
-        string ToJson()
-        {
-            return JsonSerializer.Serialize(this);
-        }
-    }
-}

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

@@ -1,33 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-
-namespace Snap.Hutao.Test.BaseClassLibrary;
-
-[TestClass]
-public sealed class LinqTest
-{
-    [TestMethod]
-    [ExpectedException(typeof(InvalidOperationException))]
-    public void LinqOrderByWithWrapperStructThrow()
-    {
-        List<MyUInt32> list = [1, 5, 2, 6, 3, 7, 4, 8];
-        string result = string.Join(", ", list.OrderBy(i => i).Select(i => i.Value));
-        Console.WriteLine(result);
-    }
-
-    private readonly struct MyUInt32
-    {
-        public readonly uint Value;
-
-        public MyUInt32(uint value)
-        {
-            Value = value;
-        }
-
-        public static implicit operator MyUInt32(uint value)
-        {
-            return new(value);
-        }
-    }
-}

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

@@ -1,19 +0,0 @@
-using System;
-
-namespace Snap.Hutao.Test.BaseClassLibrary;
-
-[TestClass]
-public sealed class TypeReflectionTest
-{
-    [TestMethod]
-    public void TypeCodeOfEnumIsUserlyingTypeTypeCode()
-    {
-        Assert.AreEqual(Type.GetTypeCode(typeof(TestEnum)), TypeCode.Int32);
-    }
-
-    private enum TestEnum
-    {
-        A,
-        B,
-    }
-}

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

@@ -1,7 +1,7 @@
 using Microsoft.Extensions.DependencyInjection;
 using System;
 
-namespace Snap.Hutao.Test.PlatformExtensions;
+namespace Snap.Hutao.Test;
 
 [TestClass]
 public sealed class DependencyInjectionTest

src/Snap.Hutao/Snap.Hutao.Test/IncomingFeature/GameRegistryContentTest.cs

@@ -1,67 +0,0 @@
-using Microsoft.Win32;
-using System;
-using System.Collections.Generic;
-using System.Runtime.InteropServices;
-using System.Runtime.Versioning;
-using System.Text;
-using System.Text.Json;
-
-namespace Snap.Hutao.Test.IncomingFeature;
-
-[TestClass]
-public class GameRegistryContentTest
-{
-    private static readonly JsonSerializerOptions RegistryContentSerializerOptions = new()
-    {
-        WriteIndented = true,
-        Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping,
-    };
-
-    [TestMethod]
-    [SupportedOSPlatform("windows")]
-    public void GetRegistryContent()
-    {
-        GetRegistryContentCore(@"Software\miHoYo\原神");
-        GetRegistryContentCore(@"Software\miHoYo\Genshin Impact");
-    }
-
-    [SupportedOSPlatform("windows")]
-    private static void GetRegistryContentCore(string subkey)
-    {
-        using (RegistryKey key = RegistryKey.OpenBaseKey(RegistryHive.CurrentUser, RegistryView.Registry64))
-        {
-            RegistryKey? gameKey = key.OpenSubKey(subkey);
-            Assert.IsNotNull(gameKey);
-
-            Dictionary<string, object> data = [];
-            foreach (string valueName in gameKey.GetValueNames())
-            {
-                data[valueName] = gameKey.GetValueKind(valueName) switch
-                {
-                    RegistryValueKind.DWord => (int)gameKey.GetValue(valueName)!,
-                    RegistryValueKind.Binary => GetStringOrObject((byte[])gameKey.GetValue(valueName)!),
-                    _ => throw new NotImplementedException()
-                };
-            }
-
-            Console.WriteLine($"Subkey: {subkey}");
-            Console.WriteLine(JsonSerializer.Serialize(data, RegistryContentSerializerOptions));
-        }
-    }
-
-    private static unsafe object GetStringOrObject(byte[] bytes)
-    {
-        fixed (byte* pByte = bytes)
-        {
-            ReadOnlySpan<byte> span = MemoryMarshal.CreateReadOnlySpanFromNullTerminated(pByte);
-            string temp = Encoding.UTF8.GetString(span);
-
-            if (temp.AsSpan()[0] is '{' or '[')
-            {
-                return JsonSerializer.Deserialize<JsonElement>(temp);
-            }
-
-            return temp;
-        }
-    }
-}

src/Snap.Hutao/Snap.Hutao.Test/IncomingFeature/GeniusInvokationDecoding.cs

@@ -1,239 +0,0 @@
-using System;
-using System.Buffers.Binary;
-using System.Globalization;
-using System.Text;
-
-namespace Snap.Hutao.Test.IncomingFeature;
-
-[TestClass]
-public sealed class GeniusInvokationDecoding
-{
-    public TestContext? TestContext { get; set; }
-
-    /// <summary>
-    /// https://www.bilibili.com/video/av278125720
-    /// </summary>
-    [TestMethod]
-    public unsafe void GeniusInvokationShareCodeDecoding()
-    {
-        // 51 bytes obfuscated data
-        byte[] bytes = Convert.FromBase64String("BCHBwxQNAYERyVANCJGBynkOCZER2pgOCrFx8poQChGR9bYQDEGB9rkQDFKRD7oRDeEB");
-
-        // ---------------------------------------------
-        // |   Data   | Caesar Cipher Key |
-        // |----------|-------------------|
-        // | 50 Bytes |       1 Byte      |
-        // ---------------------------------------------
-        // Data:
-        // 00000100 00100001 11000001 11000011 00010100
-        // 00001101 00000001 10000001 00010001 11001001
-        // 01010000 00001101 00001000 10010001 10000001
-        // 11001010 01111001 00001110 00001001 10010001
-        // 00010001 11011010 10011000 00001110 00001010
-        // 10110001 01110001 11110010 10011010 00010000
-        // 00001010 00010001 10010001 11110101 10110110
-        // 00010000 00001100 01000001 10000001 11110110
-        // 10111001 00010000 00001100 01010010 10010001
-        // 00001111 10111010 00010001 00001101 11100001
-        // ---------------------------------------------
-        // Caesar Cipher Key:
-        // 00000001
-        // ---------------------------------------------
-        fixed (byte* ptr = bytes)
-        {
-            // Reinterpret as 50 byte actual data and 1 deobfuscate key byte
-            EncryptedDataAndKey* data = (EncryptedDataAndKey*)ptr;
-            byte* dataPtr = data->Data;
-
-            // ----------------------------------------------------------
-            // |   First   |  Second  | Padding |
-            // |-----------|----------|---------|
-            // |  25 Bytes | 25 Bytes |  1 Byte |
-            // ----------------------------------------------------------
-            // We are doing two things here:
-            // 1. Retrieve actual data by subtracting key
-            // 2. Store data into two halves by alternating between them
-            // ----------------------------------------------------------
-            // What we will get after this step:
-            // ----------------------------------------------------------
-            // First:
-            // 00000011 11000000 00010011 00000000 00010000
-            // 01001111 00000111 10000000 01111000 00001000
-            // 00010000 10010111 00001001 01110000 10011001
-            // 00001001 10010000 10110101 00001011 10000000
-            // 10111000 00001011 10010000 10111001 00001100
-            // ----------------------------------------------------------
-            // Second:
-            // 00100000 11000010 00001100 10000000 11001000
-            // 00001100 10010000 11001001 00001101 10010000
-            // 11011001 00001101 10110000 11110001 00001111
-            // 00010000 11110100 00001111 01000000 11110101
-            // 00001111 01010001 00001110 00010000 11100000
-            // ----------------------------------------------------------
-            RearrangeBuffer rearranged = default;
-            byte* pFirst = rearranged.First;
-            byte* pSecond = rearranged.Second;
-            for (int i = 0; i < 50; i++)
-            {
-                // Determine which half are we going to insert
-                byte** ppTarget = i % 2 == 0 ? &pFirst : &pSecond;
-
-                // (actual data = data - key) and store it directly to the target half
-                **ppTarget = unchecked((byte)(dataPtr[i] - data->Key));
-
-                (*ppTarget)++;
-            }
-
-            // Prepare decoded data result storage
-            DecryptedData decoded = default;
-            ushort* pDecoded = decoded.Data;
-
-            // ----------------------------------------------------------
-            // |   Data   |
-            // |----------| x 17 = 51 Bytes
-            // |  3 Bytes |
-            // ----------------------------------------------------------
-            // Grouping each 3 bytes and read out as 2 ushort with
-            // 12 bits each (Big Endian)
-            // ----------------------------------------------------------
-            // 00000011 1100·0000 00010011|                                    
-            // 00000000 0001·0000 01001111|              
-            // 00000111 1000·0000 01111000|              
-            // 00001000 0001·0000 10010111|              
-            // 00001001 0111·0000 10011001|              
-            // 00001001 1001·0000 10110101|              
-            // 00001011 1000·0000 10111000|              
-            // 00001011 1001·0000 10111001|              
-            // 00001100 0010·0000 11000010|
-            // 00001100 1000·0000 11001000|              
-            // 00001100 1001·0000 11001001|              
-            // 00001101 1001·0000 11011001|              
-            // 00001101 1011·0000 11110001|              
-            // 00001111 0001·0000 11110100|              
-            // 00001111 0100·0000 11110101|              
-            // 00001111 0101·0001 00001110|              
-            // 00010000 1110·0000 -padding|[padding32]   
-            // ----------------------------------------------------------
-            // reinterpret as DecodeGroupingHelper for each 3 bytes
-            DecodeGroupingHelper* pGroup = (DecodeGroupingHelper*)&rearranged;
-            for (int i = 0; i < 17; i++)
-            {
-                (ushort first, ushort second) = pGroup->GetData();
-
-                *pDecoded = first;
-                *(pDecoded + 1) = second;
-
-                pDecoded += 2;
-                pGroup++;
-            }
-
-            // Now we get
-            //  60, 19,  1,
-            //  79,120,120,
-            // 129,151,151,
-            // 153,153,181,
-            // 184,184,185,
-            // 185,194,194,
-            // 200,200,201,
-            // 201,217,217,
-            // 219,241,241,
-            // 244,244,245,
-            // 245,270,270,
-            StringBuilder stringBuilder = new();
-            for (int i = 0; i < 33; i++)
-            {
-                stringBuilder
-                    .AppendFormat(CultureInfo.InvariantCulture, "{0,3}", decoded.Data[i])
-                    .Append(',');
-
-                if (i % 11 == 10)
-                {
-                    stringBuilder.Append('\n');
-                }
-            }
-
-            TestContext?.WriteLine(stringBuilder.ToString(0, stringBuilder.Length - 1));
-
-            ushort[] resultArray = new ushort[33];
-            Span<ushort> result = new((ushort*)&decoded, 33);
-            result.CopyTo(resultArray);
-
-            ushort[] testKnownResult =
-            [
-                060,
-                019,
-                001,
-                079,
-                120,
-                120,
-                129,
-                151,
-                151,
-                153,
-                153,
-                181,
-                184,
-                184,
-                185,
-                185,
-                194,
-                194,
-                200,
-                200,
-                201,
-                201,
-                217,
-                217,
-                219,
-                241,
-                241,
-                244,
-                244,
-                245,
-                245,
-                270,
-                270,
-            ];
-
-            CollectionAssert.AreEqual(resultArray, testKnownResult);
-        }
-    }
-
-    private struct EncryptedDataAndKey
-    {
-        public unsafe fixed byte Data[50];
-        public byte Key;
-    }
-
-    private struct RearrangeBuffer
-    {
-        public unsafe fixed byte First[25];
-        public unsafe fixed byte Second[25];
-
-        // Make it 51 bytes
-        // allow to be group as 17 DecodeGroupingHelper later
-        public byte padding;
-
-        // prevent accidently int32 cast access violation
-        public byte paddingTo32;
-    }
-
-    private struct DecodeGroupingHelper
-    {
-        public unsafe fixed byte Data[3];
-
-        public unsafe (ushort First, ushort Second) GetData()
-        {
-            fixed (byte* ptr = Data)
-            {
-                uint value = BinaryPrimitives.ReverseEndianness((*(uint*)ptr) & 0x00FFFFFF) >> 8; // keep low 24 bits only
-                return ((ushort)((value >> 12) & 0x0FFF), (ushort)(value & 0x0FFF));
-            }
-        }
-    }
-
-    private struct DecryptedData
-    {
-        public unsafe fixed ushort Data[33];
-    }
-}

src/Snap.Hutao/Snap.Hutao.Test/IncomingFeature/SpiralAbyssScheduleIdTest.cs

@@ -1,43 +0,0 @@
-using System;
-
-namespace Snap.Hutao.Test.IncomingFeature;
-
-[TestClass]
-public class SpiralAbyssScheduleIdTest
-{
-    private static readonly TimeSpan Utc8 = new(8, 0, 0);
-
-    [TestMethod]
-    public void Test()
-    {
-        Console.WriteLine($"当前第 {GetForDateTimeOffset(DateTimeOffset.Now)} 期");
-
-        DateTimeOffset dateTimeOffset = new(2020, 7, 1, 4, 0, 0, Utc8);
-        Console.WriteLine($"2020-07-01 04:00:00 为第 {GetForDateTimeOffset(dateTimeOffset)} 期");
-    }
-
-    public static int GetForDateTimeOffset(DateTimeOffset dateTimeOffset)
-    {
-        // Force time in UTC+08
-        dateTimeOffset = dateTimeOffset.ToOffset(Utc8);
-
-        ((int year, int mouth, int day), (int hour, _), _) = dateTimeOffset;
-
-        // 2020-07-01 04:00:00 为第 1 期
-        int periodNum = (((year - 2020) * 12) + (mouth - 6)) * 2;
-
-        // 上半月：1-15 日, 以及 16 日 00:00-04:00
-        if (day < 16 || (day == 16 && hour < 4))
-        {
-            periodNum--;
-        }
-
-        // 上个月：1 日 00:00-04:00
-        if (day is 1 && hour < 4)
-        {
-            periodNum--;
-        }
-
-        return periodNum;
-    }
-}

src/Snap.Hutao/Snap.Hutao.Test/JsonSerializeTest.cs

@@ -0,0 +1,67 @@
+using System.Collections.Generic;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace Snap.Hutao.Test;
+
+[TestClass]
+public class JsonSerializeTest
+{
+    private const string SmapleObjectJson = """
+        {
+            "A" :1
+        }
+        """;
+
+    private const string SmapleEmptyStringObjectJson = """
+        {
+            "A" : ""
+        }
+        """;
+
+    private const string SmapleNumberKeyDictionaryJson = """
+        {
+            "111" : "12",
+            "222" : "34"
+        }
+        """;
+
+    [TestMethod]
+    public void DelegatePropertyCanSerialize()
+    {
+        Sample sample = JsonSerializer.Deserialize<Sample>(SmapleObjectJson)!;
+        Assert.AreEqual(sample.B, 1);
+    }
+
+    [TestMethod]
+    [ExpectedException(typeof(JsonException))]
+    public void EmptyStringCannotSerializeAsNumber()
+    {
+        StringNumberSample sample = JsonSerializer.Deserialize<StringNumberSample>(SmapleEmptyStringObjectJson)!;
+        Assert.AreEqual(sample.A, 0);
+    }
+
+    [TestMethod]
+    public void NumberStringKeyCanSerializeAsKey()
+    {
+        JsonSerializerOptions options = new()
+        {
+            NumberHandling = JsonNumberHandling.AllowReadingFromString,
+        };
+
+        Dictionary<int, string> sample = JsonSerializer.Deserialize<Dictionary<int, string>>(SmapleNumberKeyDictionaryJson, options)!;
+        Assert.AreEqual(sample[111], "12");
+    }
+
+    private sealed class Sample
+    {
+        public int A { get => B; set => B = value; }
+        public int B { get; set; }
+    }
+
+    private sealed class StringNumberSample
+    {
+        [JsonNumberHandling(JsonNumberHandling.AllowReadingFromString | JsonNumberHandling.WriteAsString)]
+        public int A { get; set; }
+    }
+}

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

@@ -9,12 +9,11 @@ public sealed class ForEachRuntimeBehaviorTest
     [TestMethod]
     public void ListOfStringCanEnumerateAsReadOnlySpanOfChar()
     {
-        List<string> strings =
-#if NET8_0_OR_GREATER
-            ["a", "b", "c"];
-#else
-            new() { "a", "b", "c" };
-#endif
+        List<string> strings = new()
+        {
+            "a", "b", "c"
+        };
+
         int count = 0;
         foreach (ReadOnlySpan<char> chars in strings)
         {

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

@@ -8,13 +8,8 @@ public sealed class RangeRuntimeBehaviorTest
     [TestMethod]
     public void RangeTrimLastOne()
     {
-#if NET8_0_OR_GREATER
-        int[] array = [1, 2, 3, 4];
-        int[] test = [1, 2, 3];
-#else
         int[] array = { 1, 2, 3, 4 };
         int[] test = { 1, 2, 3 };
-#endif
         int[] result = array[..^1];
         Assert.AreEqual(3, result.Length);
         Assert.IsTrue(MemoryExtensions.SequenceEqual<int>(test, result));

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

@@ -1,71 +1,16 @@
-using System.Collections.Generic;
-using System.Runtime.CompilerServices;
-using System.Runtime.InteropServices;
-
-namespace Snap.Hutao.Test.RuntimeBehavior;
+namespace Snap.Hutao.Test.RuntimeBehavior;
 
 [TestClass]
 public sealed class UnsafeRuntimeBehaviorTest
 {
     [TestMethod]
-    public unsafe void UInt32AllSetIsUInt32MaxValue()
+    public unsafe void UInt32AllSetIs()
     {
-        byte[] bytes =
-#if NET8_0_OR_GREATER
-            [0xFF, 0xFF, 0xFF, 0xFF];
-#else
-            { 0xFF, 0xFF, 0xFF, 0xFF, };
-#endif
+        byte[] bytes = { 0xFF, 0xFF, 0xFF, 0xFF, };
 
         fixed (byte* pBytes = bytes)
         {
             Assert.AreEqual(uint.MaxValue, *(uint*)pBytes);
         }
     }
-
-    [TestMethod]
-    public unsafe void UInt32LayoutIsLittleEndian()
-    {
-        ulong testValue = 0x1234567887654321;
-        ref BuildVersion version = ref Unsafe.As<ulong, BuildVersion>(ref testValue);
-
-        Assert.AreEqual(0x1234, version.Major);
-        Assert.AreEqual(0x5678, version.Minor);
-        Assert.AreEqual(0x8765, version.Patch);
-        Assert.AreEqual(0x4321, version.Build);
-    }
-
-    [TestMethod]
-    public unsafe void ReadOnlyStructCanBeModifiedInCtor()
-    {
-        TestStruct testStruct = new([4444, 7878, 5656, 1212]);
-
-        Assert.AreEqual(4444, testStruct.Value1);
-        Assert.AreEqual(7878, testStruct.Value2);
-        Assert.AreEqual(5656, testStruct.Value3);
-        Assert.AreEqual(1212, testStruct.Value4);
-    }
-
-
-
-    private readonly struct TestStruct
-    {
-        public readonly int Value1;
-        public readonly int Value2;
-        public readonly int Value3;
-        public readonly int Value4;
-
-        public TestStruct(List<int> list)
-        {
-            CollectionsMarshal.AsSpan(list).CopyTo(MemoryMarshal.CreateSpan(ref Unsafe.As<TestStruct, int>(ref this), 4));
-        }
-    }
-
-    private readonly struct BuildVersion
-    {
-        public readonly ushort Build;
-        public readonly ushort Patch;
-        public readonly ushort Minor;
-        public readonly ushort Major;
-    }
 }

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

@@ -1,20 +1,20 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFrameworks>net8.0</TargetFrameworks>
+    <TargetFramework>net7.0</TargetFramework>
     <ImplicitUsings>disable</ImplicitUsings>
     <Nullable>enable</Nullable>
     <IsPackable>false</IsPackable>
     <IsTestProject>true</IsTestProject>
     <AllowUnsafeBlocks>True</AllowUnsafeBlocks>
-    <Configurations>Debug;Release</Configurations>
+    <Configurations>Debug;Release;Debug As Fake Elevated</Configurations>
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="8.0.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.9.0" />
-    <PackageReference Include="MSTest.TestAdapter" Version="3.2.1" />
-    <PackageReference Include="MSTest.TestFramework" Version="3.2.1" />
+    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="7.0.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.7.2" />
+    <PackageReference Include="MSTest.TestAdapter" Version="3.1.1" />
+    <PackageReference Include="MSTest.TestFramework" Version="3.1.1" />
     <PackageReference Include="coverlet.collector" Version="6.0.0">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>

src/Snap.Hutao/Snap.Hutao.Win32/NativeMethods.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://raw.githubusercontent.com/microsoft/CsWin32/main/src/Microsoft.Windows.CsWin32/settings.schema.json",
+  "allowMarshaling": true,
+  "useSafeHandles": false
+}

src/Snap.Hutao/Snap.Hutao.Win32/NativeMethods.txt

@@ -0,0 +1,74 @@
+// COMCTL32
+DefSubclassProc
+RemoveWindowSubclass
+SetWindowSubclass
+
+// DWMAPI
+DwmSetWindowAttribute
+
+// GDI32
+GetDeviceCaps
+
+// KERNEL32
+CloseHandle
+CreateEventW
+CreateRemoteThread
+GetModuleHandleW
+GetProcAddress
+K32EnumProcessModules
+K32GetModuleBaseNameW
+K32GetModuleInformation
+ReadProcessMemory
+SetEvent
+VirtualAlloc
+VirtualAllocEx
+VirtualFree
+VirtualFreeEx
+WaitForSingleObject
+WriteProcessMemory
+
+// OLE32
+CoWaitForMultipleObjects
+
+// USER32
+AttachThreadInput
+FindWindowExW
+GetCursorPos
+GetDC
+GetDpiForWindow
+GetForegroundWindow
+GetWindowPlacement
+GetWindowThreadProcessId
+ReleaseDC
+RegisterHotKey
+SendInput
+SetForegroundWindow
+UnregisterHotKey
+
+// COM
+IPersistFile
+IShellLinkW
+ShellLink
+SHELL_LINK_DATA_FLAGS
+
+// WinRT
+IMemoryBufferByteAccess
+
+// Const value
+INFINITE
+WM_GETMINMAXINFO
+WM_HOTKEY
+WM_NCRBUTTONDOWN
+WM_NCRBUTTONUP
+WM_NULL
+
+// Type & Enum definition
+
+// System.Threading
+LPTHREAD_START_ROUTINE
+
+// UI.WindowsAndMessaging
+MINMAXINFO
+
+// System.Com
+CWMO_FLAGS

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

@@ -0,0 +1,25 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net7.0-windows10.0.19041.0</TargetFramework>
+    <ImplicitUsings>disable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <None Remove="NativeMethods.json" />
+    <None Remove="NativeMethods.txt" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <AdditionalFiles Include="NativeMethods.json" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Windows.CsWin32" Version="0.3.46-beta">
+      <PrivateAssets>all</PrivateAssets>
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+    </PackageReference>
+  </ItemGroup>
+
+</Project>

src/Snap.Hutao/Snap.Hutao.Win32/StructMarshal.cs

@@ -0,0 +1,36 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using System.Runtime.CompilerServices;
+using Windows.Win32.UI.WindowsAndMessaging;
+
+[assembly: InternalsVisibleTo("Snap.Hutao")]
+
+namespace Snap.Hutao.Win32;
+
+/// <summary>
+/// 结构体封送
+/// </summary>
+internal static class StructMarshal
+{
+    /// <summary>
+    /// 构造一个新的 <see cref="Windows.Win32.UI.WindowsAndMessaging.WINDOWPLACEMENT"/>
+    /// </summary>
+    /// <returns>新的实例</returns>
+    public static unsafe WINDOWPLACEMENT WINDOWPLACEMENT()
+    {
+        return new() { length = SizeOf<WINDOWPLACEMENT>() };
+    }
+
+    /// <summary>
+    /// 获取结构的大小
+    /// </summary>
+    /// <typeparam name="TStruct">结构类型</typeparam>
+    /// <returns>结构的大小</returns>
+    [MethodImpl(MethodImplOptions.AggressiveInlining)]
+    public static unsafe uint SizeOf<TStruct>()
+        where TStruct : unmanaged
+    {
+        return unchecked((uint)sizeof(TStruct));
+    }
+}

src/Snap.Hutao/Snap.Hutao.Win32/WinRTCustomMarshaler.cs

@@ -0,0 +1,72 @@
+using System;
+using System.Reflection;
+using System.Runtime.InteropServices;
+
+namespace Windows.Win32.CsWin32.InteropServices;
+
+internal class WinRTCustomMarshaler : ICustomMarshaler
+{
+    private static readonly string? AssemblyFullName = typeof(Windows.Foundation.IMemoryBuffer).Assembly.FullName;
+
+    private readonly string className;
+    private bool lookedForFromAbi;
+    private MethodInfo? fromAbiMethod;
+
+    private WinRTCustomMarshaler(string className)
+    {
+        this.className = className;
+    }
+
+    public static ICustomMarshaler GetInstance(string cookie)
+    {
+        return new WinRTCustomMarshaler(cookie);
+    }
+
+    public void CleanUpManagedData(object ManagedObj)
+    {
+    }
+
+    public void CleanUpNativeData(nint pNativeData)
+    {
+        Marshal.Release(pNativeData);
+    }
+
+    public int GetNativeDataSize()
+    {
+        throw new NotSupportedException();
+    }
+
+    public nint MarshalManagedToNative(object ManagedObj)
+    {
+        throw new NotSupportedException();
+    }
+
+    public object MarshalNativeToManaged(nint thisPtr)
+    {
+        return className switch
+        {
+            "Windows.System.DispatcherQueueController" => Windows.System.DispatcherQueueController.FromAbi(thisPtr),
+            _ => MarshalNativeToManagedSlow(thisPtr),
+        };
+    }
+
+    private object MarshalNativeToManagedSlow(nint pNativeData)
+    {
+        if (!lookedForFromAbi)
+        {
+            Type? type = Type.GetType($"{className}, {AssemblyFullName}");
+
+            fromAbiMethod = type?.GetMethod("FromAbi");
+            lookedForFromAbi = true;
+        }
+
+        if (fromAbiMethod is not null)
+        {
+            return fromAbiMethod.Invoke(default, new object[] { pNativeData })!;
+        }
+        else
+        {
+            return Marshal.GetObjectForIUnknown(pNativeData);
+        }
+    }
+}

src/Snap.Hutao/Snap.Hutao.sln

@@ -8,11 +8,14 @@ EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{9A95A964-04B1-477A-BDE7-505525B3CAD8}"
 	ProjectSection(SolutionItems) = preProject
 		.editorconfig = .editorconfig
-		.vsconfig = .vsconfig
 	EndProjectSection
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Snap.Hutao.SourceGeneration", "Snap.Hutao.SourceGeneration\Snap.Hutao.SourceGeneration.csproj", "{8B96721E-5604-47D2-9B72-06FEBAD0CE00}"
+EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Snap.Hutao.Test", "Snap.Hutao.Test\Snap.Hutao.Test.csproj", "{D691BA9F-904C-4229-87A5-E14F2EFF2F64}"
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Snap.Hutao.Win32", "Snap.Hutao.Win32\Snap.Hutao.Win32.csproj", "{0F7ABEB2-5107-4037-B9DC-84D288FB0801}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -49,6 +52,22 @@ Global
 		{AAAB7CF0-F299-49B8-BDB4-4C320B3EC2C7}.Release|x86.ActiveCfg = Release|x86
 		{AAAB7CF0-F299-49B8-BDB4-4C320B3EC2C7}.Release|x86.Build.0 = Release|x86
 		{AAAB7CF0-F299-49B8-BDB4-4C320B3EC2C7}.Release|x86.Deploy.0 = Release|x86
+		{8B96721E-5604-47D2-9B72-06FEBAD0CE00}.Debug|Any CPU.ActiveCfg = Debug|x64
+		{8B96721E-5604-47D2-9B72-06FEBAD0CE00}.Debug|Any CPU.Build.0 = Debug|x64
+		{8B96721E-5604-47D2-9B72-06FEBAD0CE00}.Debug|arm64.ActiveCfg = Debug|Any CPU
+		{8B96721E-5604-47D2-9B72-06FEBAD0CE00}.Debug|arm64.Build.0 = Debug|Any CPU
+		{8B96721E-5604-47D2-9B72-06FEBAD0CE00}.Debug|x64.ActiveCfg = Debug|x64
+		{8B96721E-5604-47D2-9B72-06FEBAD0CE00}.Debug|x64.Build.0 = Debug|x64
+		{8B96721E-5604-47D2-9B72-06FEBAD0CE00}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{8B96721E-5604-47D2-9B72-06FEBAD0CE00}.Debug|x86.Build.0 = Debug|Any CPU
+		{8B96721E-5604-47D2-9B72-06FEBAD0CE00}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{8B96721E-5604-47D2-9B72-06FEBAD0CE00}.Release|Any CPU.Build.0 = Release|Any CPU
+		{8B96721E-5604-47D2-9B72-06FEBAD0CE00}.Release|arm64.ActiveCfg = Release|Any CPU
+		{8B96721E-5604-47D2-9B72-06FEBAD0CE00}.Release|arm64.Build.0 = Release|Any CPU
+		{8B96721E-5604-47D2-9B72-06FEBAD0CE00}.Release|x64.ActiveCfg = Release|x64
+		{8B96721E-5604-47D2-9B72-06FEBAD0CE00}.Release|x64.Build.0 = Release|x64
+		{8B96721E-5604-47D2-9B72-06FEBAD0CE00}.Release|x86.ActiveCfg = Release|Any CPU
+		{8B96721E-5604-47D2-9B72-06FEBAD0CE00}.Release|x86.Build.0 = Release|Any CPU
 		{D691BA9F-904C-4229-87A5-E14F2EFF2F64}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{D691BA9F-904C-4229-87A5-E14F2EFF2F64}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{D691BA9F-904C-4229-87A5-E14F2EFF2F64}.Debug|arm64.ActiveCfg = Debug|Any CPU
@@ -65,16 +84,32 @@ Global
 		{D691BA9F-904C-4229-87A5-E14F2EFF2F64}.Release|x64.Build.0 = Release|Any CPU
 		{D691BA9F-904C-4229-87A5-E14F2EFF2F64}.Release|x86.ActiveCfg = Release|Any CPU
 		{D691BA9F-904C-4229-87A5-E14F2EFF2F64}.Release|x86.Build.0 = Release|Any CPU
+		{0F7ABEB2-5107-4037-B9DC-84D288FB0801}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{0F7ABEB2-5107-4037-B9DC-84D288FB0801}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{0F7ABEB2-5107-4037-B9DC-84D288FB0801}.Debug|arm64.ActiveCfg = Debug|Any CPU
+		{0F7ABEB2-5107-4037-B9DC-84D288FB0801}.Debug|arm64.Build.0 = Debug|Any CPU
+		{0F7ABEB2-5107-4037-B9DC-84D288FB0801}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{0F7ABEB2-5107-4037-B9DC-84D288FB0801}.Debug|x64.Build.0 = Debug|Any CPU
+		{0F7ABEB2-5107-4037-B9DC-84D288FB0801}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{0F7ABEB2-5107-4037-B9DC-84D288FB0801}.Debug|x86.Build.0 = Debug|Any CPU
+		{0F7ABEB2-5107-4037-B9DC-84D288FB0801}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{0F7ABEB2-5107-4037-B9DC-84D288FB0801}.Release|Any CPU.Build.0 = Release|Any CPU
+		{0F7ABEB2-5107-4037-B9DC-84D288FB0801}.Release|arm64.ActiveCfg = Release|Any CPU
+		{0F7ABEB2-5107-4037-B9DC-84D288FB0801}.Release|arm64.Build.0 = Release|Any CPU
+		{0F7ABEB2-5107-4037-B9DC-84D288FB0801}.Release|x64.ActiveCfg = Release|Any CPU
+		{0F7ABEB2-5107-4037-B9DC-84D288FB0801}.Release|x64.Build.0 = Release|Any CPU
+		{0F7ABEB2-5107-4037-B9DC-84D288FB0801}.Release|x86.ActiveCfg = Release|Any CPU
+		{0F7ABEB2-5107-4037-B9DC-84D288FB0801}.Release|x86.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
-		RESX_AutoApplyExistingTranslations = False
-		RESX_NeutralResourcesLanguage = zh-CN
-		SolutionGuid = {E4449B1C-0E6A-4D19-955E-1CA491656ABA}
-		RESX_SortFileContentOnSave = True
-		RESX_ShowErrorsInErrorList = False
 		RESX_Rules = {"EnabledRules":["StringFormat","WhiteSpaceLead","WhiteSpaceTail","PunctuationLead"]}
+		RESX_ShowErrorsInErrorList = False
+		RESX_SortFileContentOnSave = True
+		SolutionGuid = {E4449B1C-0E6A-4D19-955E-1CA491656ABA}
+		RESX_NeutralResourcesLanguage = zh-CN
+		RESX_AutoApplyExistingTranslations = False
 	EndGlobalSection
 EndGlobal

src/Snap.Hutao/Snap.Hutao/.filenesting.json

@@ -4,18 +4,12 @@
     "add": {
       "extensionToExtension": {
         "add": {
-          ".json": [
-            ".txt"
-          ]
+          ".json": [ ".txt" ]
         }
       },
       "pathSegment": {
         "add": {
-          ".*": [
-            ".cs",
-            ".resx",
-            ".appxmanifest"
-          ]
+          ".*": [ ".cs", ".resx" ]
         }
       },
       "fileSuffixToExtension": {
@@ -25,24 +19,12 @@
       },
       "fileToFile": {
         "add": {
-          ".filenesting.json": [
-            "App.xaml.cs"
-          ],
-          "app.manifest": [
-            "App.xaml.cs"
-          ],
-          "Package.appxmanifest": [
-            "App.xaml"
-          ],
-          "Package.StoreAssociation.xml": [
-            "App.xaml"
-          ],
-          ".editorconfig": [
-            "Program.cs"
-          ],
-          "GlobalUsing.cs": [
-            "Program.cs"
-          ]
+          ".filenesting.json": [ "App.xaml.cs" ],
+          "app.manifest": [ "App.xaml.cs" ],
+          "Package.appxmanifest": [ "App.xaml" ],
+          "Package.StoreAssociation.xml": [ "App.xaml" ],
+          ".editorconfig": [ "Program.cs" ],
+          "GlobalUsing.cs": [ "Program.cs" ]
         }
       }
     }

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

@@ -10,10 +10,8 @@
                 <ResourceDictionary Source="ms-appx:///Control/Image/CachedImage.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Theme/Card.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Theme/Color.xaml"/>
-                <ResourceDictionary Source="ms-appx:///Control/Theme/ComboBox.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Theme/Converter.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Theme/CornerRadius.xaml"/>
-                <ResourceDictionary Source="ms-appx:///Control/Theme/FlyoutStyle.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Theme/FontStyle.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Theme/Glyph.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Theme/InfoBarOverride.xaml"/>
@@ -21,9 +19,7 @@
                 <ResourceDictionary Source="ms-appx:///Control/Theme/NumericValue.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Theme/PageOverride.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Theme/PivotOverride.xaml"/>
-                <ResourceDictionary Source="ms-appx:///Control/Theme/ScrollViewer.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Theme/SettingsStyle.xaml"/>
-                <ResourceDictionary Source="ms-appx:///Control/Theme/Thickness.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Theme/TransitionCollection.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Theme/Uri.xaml"/>
                 <ResourceDictionary Source="ms-appx:///Control/Theme/WindowOverride.xaml"/>
@@ -33,7 +29,6 @@
                 x:Key="LargeGridViewItemStyle"
                 BasedOn="{StaticResource DefaultGridViewItemStyle}"
                 TargetType="GridViewItem">
-                <Setter Property="HorizontalContentAlignment" Value="Stretch"/>
                 <Setter Property="Margin" Value="0,0,12,12"/>
             </Style>
             <Style

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

@@ -6,7 +6,6 @@ using Microsoft.Windows.AppLifecycle;
 using Snap.Hutao.Core;
 using Snap.Hutao.Core.ExceptionService;
 using Snap.Hutao.Core.LifeCycle;
-using Snap.Hutao.Core.LifeCycle.InterProcess;
 using Snap.Hutao.Core.Shell;
 using System.Diagnostics;
 
@@ -21,22 +20,7 @@ namespace Snap.Hutao;
 [SuppressMessage("", "SH001")]
 public sealed partial class App : Application
 {
-    private const string ConsoleBanner = """
-        ----------------------------------------------------------------
-          _____                         _    _         _                
-         / ____|                       | |  | |       | |               
-        | (___   _ __    __ _  _ __    | |__| | _   _ | |_  __ _   ___  
-         \___ \ | '_ \  / _` || '_ \   |  __  || | | || __|/ _` | / _ \ 
-         ____) || | | || (_| || |_) |_ | |  | || |_| || |_| (_| || (_) |
-        |_____/ |_| |_| \__,_|| .__/(_)|_|  |_| \__,_| \__|\__,_| \___/ 
-                              | |                                       
-                              |_| 
-                              
-        Snap.Hutao is a open source software developed by DGP Studio.
-        Copyright (C) 2022 - 2024 DGP Studio, All Rights Reserved.
-        ----------------------------------------------------------------
-        """;
-
+    private const string AppInstanceKey = "main";
     private readonly IServiceProvider serviceProvider;
     private readonly IActivation activation;
     private readonly ILogger<App> logger;
@@ -49,6 +33,7 @@ public sealed partial class App : Application
     {
         // Load app resource
         InitializeComponent();
+
         activation = serviceProvider.GetRequiredService<IActivation>();
         logger = serviceProvider.GetRequiredService<ILogger<App>>();
         serviceProvider.GetRequiredService<ExceptionRecorder>().Record(this);
@@ -62,21 +47,23 @@ public sealed partial class App : Application
         try
         {
             AppActivationArguments activatedEventArgs = AppInstance.GetCurrent().GetActivatedEventArgs();
+            AppInstance firstInstance = AppInstance.FindOrRegisterForKey(AppInstanceKey);
 
-            if (serviceProvider.GetRequiredService<PrivateNamedPipeClient>().TryRedirectActivationTo(activatedEventArgs))
+            if (firstInstance.IsCurrent)
             {
-                Exit();
-                return;
+                // manually invoke
+                activation.InitializeWith(firstInstance);
+                activation.NonRedirectToActivate(firstInstance, activatedEventArgs);
+
+                LogDiagnosticInformation();
+                serviceProvider.GetRequiredService<IJumpListInterop>().ConfigureAsync().SafeForget();
+            }
+            else
+            {
+                // Redirect the activation (and args) to the "main" instance, and exit.
+                firstInstance.RedirectActivationTo(activatedEventArgs);
+                Process.GetCurrentProcess().Kill();
             }
-
-            logger.LogInformation(ConsoleBanner);
-            LogDiagnosticInformation();
-
-            // manually invoke
-            activation.Activate(HutaoActivationArguments.FromAppActivationArguments(activatedEventArgs));
-            activation.Initialize();
-
-            serviceProvider.GetRequiredService<IJumpListInterop>().ConfigureAsync().SafeForget();
         }
         catch
         {

src/Snap.Hutao/Snap.Hutao/Control/Animation/AnimationDurations.cs

@@ -0,0 +1,26 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Control.Animation;
+
+/// <summary>
+/// 动画时长
+/// </summary>
+[HighQuality]
+internal static class AnimationDurations
+{
+    /// <summary>
+    /// 图片缩放动画
+    /// </summary>
+    public static readonly TimeSpan ImageZoom = TimeSpan.FromSeconds(0.5);
+
+    /// <summary>
+    /// 图像淡入
+    /// </summary>
+    public static readonly TimeSpan ImageFadeIn = TimeSpan.FromSeconds(0.3);
+
+    /// <summary>
+    /// 图像淡出
+    /// </summary>
+    public static readonly TimeSpan ImageFadeOut = TimeSpan.FromSeconds(0.2);
+}

src/Snap.Hutao/Snap.Hutao/Control/Animation/ControlAnimationConstants.cs

@@ -1,34 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-namespace Snap.Hutao.Control.Animation;
-
-internal static class ControlAnimationConstants
-{
-    /// <summary>
-    /// 1
-    /// </summary>
-    public const string One = "1";
-
-    /// <summary>
-    /// 1.1
-    /// </summary>
-    public const string OnePointOne = "1.1";
-
-    /// <summary>
-    /// 图片缩放动画
-    /// </summary>
-    public static readonly TimeSpan ImageZoom = TimeSpan.FromSeconds(0.5);
-
-    /// <summary>
-    /// 图像淡入
-    /// </summary>
-    public static readonly TimeSpan ImageScaleFadeIn = TimeSpan.FromSeconds(0.3);
-
-    /// <summary>
-    /// 图像淡出
-    /// </summary>
-    public static readonly TimeSpan ImageScaleFadeOut = TimeSpan.FromSeconds(0.2);
-
-    public static readonly TimeSpan ImageOpacityFadeInOut = TimeSpan.FromSeconds(1);
-}

src/Snap.Hutao/Snap.Hutao/Control/Animation/ImageZoomInAnimation.cs

@@ -19,10 +19,10 @@ internal sealed class ImageZoomInAnimation : ImplicitAnimation<string, Vector3>
     /// </summary>
     public ImageZoomInAnimation()
     {
-        Duration = ControlAnimationConstants.ImageZoom;
+        Duration = AnimationDurations.ImageZoom;
         EasingMode = Microsoft.UI.Xaml.Media.Animation.EasingMode.EaseOut;
         EasingType = CommunityToolkit.WinUI.Animations.EasingType.Circle;
-        To = ControlAnimationConstants.OnePointOne;
+        To = Core.StringLiterals.OnePointOne;
     }
 
     /// <inheritdoc/>

src/Snap.Hutao/Snap.Hutao/Control/Animation/ImageZoomOutAnimation.cs

@@ -19,10 +19,10 @@ internal sealed class ImageZoomOutAnimation : ImplicitAnimation<string, Vector3>
     /// </summary>
     public ImageZoomOutAnimation()
     {
-        Duration = ControlAnimationConstants.ImageZoom;
+        Duration = AnimationDurations.ImageZoom;
         EasingMode = Microsoft.UI.Xaml.Media.Animation.EasingMode.EaseOut;
         EasingType = CommunityToolkit.WinUI.Animations.EasingType.Circle;
-        To = ControlAnimationConstants.One;
+        To = Core.StringLiterals.One;
     }
 
     /// <inheritdoc/>

src/Snap.Hutao/Snap.Hutao/Control/Behavior/InvokeCommandOnLoadedBehavior.cs

@@ -35,11 +35,6 @@ internal sealed partial class InvokeCommandOnLoadedBehavior : BehaviorBase<UIEle
 
     private void TryExecuteCommand()
     {
-        if (AssociatedObject is null)
-        {
-            return;
-        }
-
         if (executed)
         {
             return;

src/Snap.Hutao/Snap.Hutao/Control/Behavior/MarqueeTextBehavior.cs

@@ -1,46 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using CommunityToolkit.Labs.WinUI.MarqueeTextRns;
-using CommunityToolkit.WinUI.Behaviors;
-using Microsoft.UI.Xaml.Input;
-
-namespace Snap.Hutao.Control.Behavior;
-
-internal sealed class MarqueeTextBehavior : BehaviorBase<MarqueeText>
-{
-    private readonly PointerEventHandler pointerEnteredEventHandler;
-    private readonly PointerEventHandler pointerExitedEventHandler;
-
-    public MarqueeTextBehavior()
-    {
-        pointerEnteredEventHandler = OnPointerEntered;
-        pointerExitedEventHandler = OnPointerExited;
-    }
-
-    protected override bool Initialize()
-    {
-        AssociatedObject.PointerEntered += pointerEnteredEventHandler;
-        AssociatedObject.PointerExited += pointerExitedEventHandler;
-
-        return true;
-    }
-
-    protected override bool Uninitialize()
-    {
-        AssociatedObject.PointerEntered -= pointerEnteredEventHandler;
-        AssociatedObject.PointerExited -= pointerExitedEventHandler;
-
-        return true;
-    }
-
-    private void OnPointerEntered(object sender, PointerRoutedEventArgs e)
-    {
-        AssociatedObject.StartMarquee();
-    }
-
-    private void OnPointerExited(object sender, PointerRoutedEventArgs e)
-    {
-        AssociatedObject.StopMarquee();
-    }
-}

src/Snap.Hutao/Snap.Hutao/Control/Behavior/OpenAttachedFlyoutAction.cs

@@ -11,17 +11,12 @@ namespace Snap.Hutao.Control.Behavior;
 /// 打开附着的浮出控件操作
 /// </summary>
 [HighQuality]
-internal sealed class ShowAttachedFlyoutAction : DependencyObject, IAction
+internal sealed class OpenAttachedFlyoutAction : DependencyObject, IAction
 {
     /// <inheritdoc/>
-    public object? Execute(object sender, object parameter)
+    public object Execute(object sender, object parameter)
     {
-        if (sender is null)
-        {
-            return default;
-        }
-
         FlyoutBase.ShowAttachedFlyout(sender as FrameworkElement);
-        return default;
+        return default!;
     }
 }

src/Snap.Hutao/Snap.Hutao/Control/Behavior/PeriodicInvokeCommandOrOnActualThemeChangedBehavior.cs

@@ -1,89 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using CommunityToolkit.WinUI.Behaviors;
-using Microsoft.UI.Xaml;
-
-namespace Snap.Hutao.Control.Behavior;
-
-[DependencyProperty("Period", typeof(TimeSpan))]
-[DependencyProperty("Command", typeof(ICommand))]
-[DependencyProperty("CommandParameter", typeof(object))]
-internal sealed partial class PeriodicInvokeCommandOrOnActualThemeChangedBehavior : BehaviorBase<FrameworkElement>, IDisposable
-{
-    private TaskCompletionSource acutalThemeChangedTaskCompletionSource = new();
-    private CancellationTokenSource periodicTimerCancellationTokenSource = new();
-
-    public void Dispose()
-    {
-        periodicTimerCancellationTokenSource.Dispose();
-    }
-
-    protected override bool Initialize()
-    {
-        AssociatedObject.ActualThemeChanged += OnActualThemeChanged;
-        return true;
-    }
-
-    protected override void OnAssociatedObjectLoaded()
-    {
-        RunCoreAsync().SafeForget();
-    }
-
-    protected override bool Uninitialize()
-    {
-        AssociatedObject.ActualThemeChanged -= OnActualThemeChanged;
-        return true;
-    }
-
-    private void OnActualThemeChanged(FrameworkElement sender, object args)
-    {
-        acutalThemeChangedTaskCompletionSource.TrySetResult();
-        periodicTimerCancellationTokenSource.Cancel();
-    }
-
-    private void TryExecuteCommand()
-    {
-        if (AssociatedObject is null)
-        {
-            return;
-        }
-
-        if (Command is not null && Command.CanExecute(CommandParameter))
-        {
-            Command.Execute(CommandParameter);
-        }
-    }
-
-    private async ValueTask RunCoreAsync()
-    {
-        using (PeriodicTimer timer = new(Period))
-        {
-            do
-            {
-                if (!IsAttached)
-                {
-                    break;
-                }
-
-                ITaskContext taskContext = Ioc.Default.GetRequiredService<ITaskContext>();
-                await taskContext.SwitchToMainThreadAsync();
-                TryExecuteCommand();
-
-                await taskContext.SwitchToBackgroundAsync();
-                try
-                {
-                    Task nextTickTask = timer.WaitForNextTickAsync(periodicTimerCancellationTokenSource.Token).AsTask();
-                    await Task.WhenAny(nextTickTask, acutalThemeChangedTaskCompletionSource.Task).ConfigureAwait(false);
-                }
-                catch (OperationCanceledException)
-                {
-                }
-
-                acutalThemeChangedTaskCompletionSource = new();
-                periodicTimerCancellationTokenSource = new();
-            }
-            while (true);
-        }
-    }
-}

src/Snap.Hutao/Snap.Hutao/Control/Behavior/StartAnimationActionNoThrow.cs

@@ -1,31 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using CommunityToolkit.WinUI.Animations;
-using Microsoft.UI.Xaml;
-using Microsoft.Xaml.Interactivity;
-
-namespace Snap.Hutao.Control.Behavior;
-
-[DependencyProperty("Animation", typeof(AnimationSet))]
-[DependencyProperty("TargetObject", typeof(UIElement))]
-internal sealed partial class StartAnimationActionNoThrow : DependencyObject, IAction
-{
-    /// <inheritdoc/>
-    public object Execute(object sender, object parameter)
-    {
-        if (Animation is not null)
-        {
-            if (TargetObject is not null)
-            {
-                Animation.Start(TargetObject);
-            }
-            else
-            {
-                Animation.Start(sender as UIElement);
-            }
-        }
-
-        return default!;
-    }
-}

src/Snap.Hutao/Snap.Hutao/Control/BoxedValues.cs

@@ -0,0 +1,21 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Control;
+
+/// <summary>
+/// 封装的值
+/// </summary>
+[HighQuality]
+internal static class BoxedValues
+{
+    /// <summary>
+    /// <see cref="true"/>
+    /// </summary>
+    public static readonly object True = true;
+
+    /// <summary>
+    /// <see cref="false"/>
+    /// </summary>
+    public static readonly object False = false;
+}

src/Snap.Hutao/Snap.Hutao/Control/Brush/ColorSegmentCollection.cs

@@ -1,8 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-namespace Snap.Hutao.Control.Brush;
-
-internal sealed class ColorSegmentCollection : List<IColorSegment>
-{
-}

src/Snap.Hutao/Snap.Hutao/Control/Brush/IColorSegment.cs

@@ -9,5 +9,5 @@ internal interface IColorSegment
 {
     Color Color { get; }
 
-    double Value { get; set; }
+    double Value { get; }
 }

src/Snap.Hutao/Snap.Hutao/Control/Brush/SegmentedBar.cs

@@ -9,48 +9,36 @@ using System.Runtime.InteropServices;
 
 namespace Snap.Hutao.Control.Brush;
 
-[DependencyProperty("Source", typeof(ColorSegmentCollection), default!, nameof(OnSourceChanged))]
+[DependencyProperty("Source", typeof(List<IColorSegment>), default!, nameof(OnSourceChanged))]
 internal sealed partial class SegmentedBar : ContentControl
 {
     private readonly LinearGradientBrush brush = new() { StartPoint = new(0, 0), EndPoint = new(1, 0), };
 
     public SegmentedBar()
     {
-        HorizontalContentAlignment = HorizontalAlignment.Stretch;
-        VerticalContentAlignment = VerticalAlignment.Stretch;
-
         Content = new Rectangle()
         {
             Fill = brush,
-            HorizontalAlignment = HorizontalAlignment.Stretch,
-            VerticalAlignment = VerticalAlignment.Stretch,
         };
     }
 
     private static void OnSourceChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
     {
-        UpdateLinearGradientBrush((SegmentedBar)obj);
-    }
+        SegmentedBar segmentedBar = (SegmentedBar)obj;
 
-    private static void UpdateLinearGradientBrush(SegmentedBar segmentedBar)
-    {
         GradientStopCollection collection = segmentedBar.brush.GradientStops;
         collection.Clear();
 
-        ColorSegmentCollection segmentCollection = segmentedBar.Source;
-
-        double total = segmentCollection.Sum(seg => seg.Value);
-        if (total is 0D)
+        if (args.NewValue as List<IColorSegment> is [_, ..] list)
         {
-            return;
-        }
-
-        double offset = 0;
-        foreach (ref readonly IColorSegment segment in CollectionsMarshal.AsSpan(segmentCollection))
-        {
-            collection.Add(new() { Color = segment.Color, Offset = offset, });
-            offset += segment.Value / total;
-            collection.Add(new() { Color = segment.Color, Offset = offset, });
+            double total = list.Sum(seg => seg.Value);
+            double offset = 0;
+            foreach (ref readonly IColorSegment segment in CollectionsMarshal.AsSpan(list))
+            {
+                collection.Add(new GradientStop() { Color = segment.Color, Offset = offset, });
+                offset += segment.Value / total;
+                collection.Add(new GradientStop() { Color = segment.Color, Offset = offset, });
+            }
         }
     }
 }

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

@@ -1,763 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using CommunityToolkit.WinUI.Collections;
-using CommunityToolkit.WinUI.Helpers;
-using Microsoft.UI.Xaml.Data;
-using System.Collections;
-using System.Collections.ObjectModel;
-using System.Collections.Specialized;
-using System.Reflection;
-using System.Runtime.CompilerServices;
-using Windows.Foundation;
-using Windows.Foundation.Collections;
-using NotifyCollectionChangedAction = System.Collections.Specialized.NotifyCollectionChangedAction;
-
-namespace Snap.Hutao.Control.Collection.AdvancedCollectionView;
-
-internal sealed class AdvancedCollectionView<T> : IAdvancedCollectionView<T>, INotifyPropertyChanged, ISupportIncrementalLoading, IComparer<object>
-    where T : class
-{
-    private readonly List<T> view;
-    private readonly ObservableCollection<SortDescription> sortDescriptions;
-    private readonly Dictionary<string, PropertyInfo?> sortProperties;
-    private readonly bool liveShapingEnabled;
-    private readonly HashSet<string?> observedFilterProperties = [];
-
-    private IList<T> source;
-    private Predicate<T>? filter;
-    private int deferCounter;
-    private WeakEventListener<AdvancedCollectionView<T>, object?, NotifyCollectionChangedEventArgs>? sourceWeakEventListener;
-
-    public AdvancedCollectionView()
-        : this(new List<T>(0))
-    {
-    }
-
-    public AdvancedCollectionView(IList<T> source, bool isLiveShaping = false)
-    {
-        liveShapingEnabled = isLiveShaping;
-        view = [];
-        sortDescriptions = [];
-        sortDescriptions.CollectionChanged += SortDescriptionsCollectionChanged;
-        sortProperties = [];
-        Source = source;
-    }
-
-    public event EventHandler<object>? CurrentChanged;
-
-    public event CurrentChangingEventHandler? CurrentChanging;
-
-    public event PropertyChangedEventHandler? PropertyChanged;
-
-    public event VectorChangedEventHandler<object>? VectorChanged;
-
-    public IList<T> Source
-    {
-        get => source;
-
-        [MemberNotNull(nameof(source))]
-        set
-        {
-            if (ReferenceEquals(source, value))
-            {
-                return;
-            }
-
-            if (source is not null)
-            {
-                DetachPropertyChangedHandler(source);
-            }
-
-            source = value;
-            AttachPropertyChangedHandler(source);
-
-            sourceWeakEventListener?.Detach();
-
-            if (source is INotifyCollectionChanged sourceNotifyCollectionChanged)
-            {
-                sourceWeakEventListener = new WeakEventListener<AdvancedCollectionView<T>, object?, NotifyCollectionChangedEventArgs>(this)
-                {
-                    // Call the actual collection changed event
-                    OnEventAction = (source, changed, arg3) => SourceNotifyCollectionChangedCollectionChanged(source, arg3),
-
-                    // The source doesn't exist anymore
-                    OnDetachAction = (listener) =>
-                    {
-                        ArgumentNullException.ThrowIfNull(sourceWeakEventListener);
-                        sourceNotifyCollectionChanged.CollectionChanged -= sourceWeakEventListener.OnEvent;
-                    },
-                };
-                sourceNotifyCollectionChanged.CollectionChanged += sourceWeakEventListener.OnEvent;
-            }
-
-            HandleSourceChanged();
-            OnPropertyChanged();
-        }
-    }
-
-    public int Count
-    {
-        get => view.Count;
-    }
-
-    public bool IsReadOnly
-    {
-        get => source is null || source.IsReadOnly;
-    }
-
-    public IObservableVector<object> CollectionGroups
-    {
-        get => default!;
-    }
-
-    public T? CurrentItem
-    {
-        get => CurrentPosition > -1 && CurrentPosition < view.Count ? view[CurrentPosition] : default;
-        set => MoveCurrentTo(value);
-    }
-
-    public int CurrentPosition { get; private set; }
-
-    public bool HasMoreItems
-    {
-        get => source is ISupportIncrementalLoading { HasMoreItems: true };
-    }
-
-    public bool IsCurrentAfterLast
-    {
-        get => CurrentPosition >= view.Count;
-    }
-
-    public bool IsCurrentBeforeFirst
-    {
-        get => CurrentPosition < 0;
-    }
-
-    public bool CanFilter
-    {
-        get => true;
-    }
-
-    public Predicate<T>? Filter
-    {
-        get => filter;
-        set
-        {
-            if (filter == value)
-            {
-                return;
-            }
-
-            filter = value;
-            HandleFilterChanged();
-        }
-    }
-
-    public bool CanSort
-    {
-        get => true;
-    }
-
-    public IList<SortDescription> SortDescriptions
-    {
-        get => sortDescriptions;
-    }
-
-    public IEnumerable<T> SourceCollection
-    {
-        get => source;
-    }
-
-    public IReadOnlyList<T> View
-    {
-        get => view;
-    }
-
-    public T this[int index]
-    {
-        get => view[index];
-        set => view[index] = value;
-    }
-
-    public void Refresh()
-    {
-        HandleSourceChanged();
-    }
-
-    public void RefreshFilter()
-    {
-        HandleFilterChanged();
-    }
-
-    public void RefreshSorting()
-    {
-        HandleSortChanged();
-    }
-
-    public IEnumerator<T> GetEnumerator()
-    {
-        return view.GetEnumerator();
-    }
-
-    IEnumerator IEnumerable.GetEnumerator()
-    {
-        return view.GetEnumerator();
-    }
-
-    public void Add(T item)
-    {
-        source.Add(item);
-    }
-
-    public void Clear()
-    {
-        source.Clear();
-    }
-
-    public bool Contains(T item)
-    {
-        return view.Contains(item);
-    }
-
-    public void CopyTo(T[] array, int arrayIndex)
-    {
-        view.CopyTo(array, arrayIndex);
-    }
-
-    public bool Remove(T item)
-    {
-        source.Remove(item);
-        return true;
-    }
-
-    [SuppressMessage("", "SH007")]
-    public int IndexOf(T? item)
-    {
-        return view.IndexOf(item!);
-    }
-
-    public void Insert(int index, T item)
-    {
-        source.Insert(index, item);
-    }
-
-    public void RemoveAt(int index)
-    {
-        Remove(view[index]);
-    }
-
-    public bool MoveCurrentTo(T? item)
-    {
-        return (item is not null && item.Equals(CurrentItem)) || MoveCurrentToIndex(IndexOf(item));
-    }
-
-    public bool MoveCurrentToPosition(int index)
-    {
-        return MoveCurrentToIndex(index);
-    }
-
-    public bool MoveCurrentToFirst()
-    {
-        return MoveCurrentToIndex(0);
-    }
-
-    public bool MoveCurrentToLast()
-    {
-        return MoveCurrentToIndex(view.Count - 1);
-    }
-
-    public bool MoveCurrentToNext()
-    {
-        return MoveCurrentToIndex(CurrentPosition + 1);
-    }
-
-    public bool MoveCurrentToPrevious()
-    {
-        return MoveCurrentToIndex(CurrentPosition - 1);
-    }
-
-    public IAsyncOperation<LoadMoreItemsResult>? LoadMoreItemsAsync(uint count)
-    {
-        return (source as ISupportIncrementalLoading)?.LoadMoreItemsAsync(count);
-    }
-
-    public void ObserveFilterProperty(string propertyName)
-    {
-        observedFilterProperties.Add(propertyName);
-    }
-
-    public void ClearObservedFilterProperties()
-    {
-        observedFilterProperties.Clear();
-    }
-
-    public IDisposable DeferRefresh()
-    {
-        return new NotificationDeferrer(this);
-    }
-
-    int IComparer<object>.Compare(object? x, object? y)
-    {
-        if (sortProperties.Count <= 0)
-        {
-            Type listType = source.GetType();
-            Type? type;
-
-            if (listType.IsGenericType)
-            {
-                type = listType.GetGenericArguments()[0];
-            }
-            else
-            {
-                type = x?.GetType();
-            }
-
-            foreach (SortDescription sd in sortDescriptions)
-            {
-                if (!string.IsNullOrEmpty(sd.PropertyName))
-                {
-                    sortProperties[sd.PropertyName] = type?.GetProperty(sd.PropertyName);
-                }
-            }
-        }
-
-        foreach (SortDescription sd in sortDescriptions)
-        {
-            object? cx, cy;
-
-            if (string.IsNullOrEmpty(sd.PropertyName))
-            {
-                cx = x;
-                cy = y;
-            }
-            else
-            {
-                PropertyInfo? pi = sortProperties[sd.PropertyName];
-
-                cx = pi?.GetValue(x);
-                cy = pi?.GetValue(y);
-            }
-
-            int cmp = sd.Comparer.Compare(cx, cy);
-
-            if (cmp is not 0)
-            {
-                return sd.Direction is SortDirection.Ascending ? +cmp : -cmp;
-            }
-        }
-
-        return 0;
-    }
-
-    internal void OnPropertyChanged([CallerMemberName] string propertyName = default!)
-    {
-        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
-    }
-
-    private void ItemOnPropertyChanged(object? item, PropertyChangedEventArgs e)
-    {
-        if (!liveShapingEnabled)
-        {
-            return;
-        }
-
-        ArgumentNullException.ThrowIfNull(item);
-        T typedItem = (T)item;
-
-        bool? filterResult = filter?.Invoke(typedItem);
-
-        if (filterResult.HasValue && observedFilterProperties.Contains(e.PropertyName))
-        {
-            int viewIndex = view.IndexOf(typedItem);
-            if (viewIndex != -1 && !filterResult.Value)
-            {
-                RemoveFromView(viewIndex, typedItem);
-            }
-            else if (viewIndex == -1 && filterResult.Value)
-            {
-                int index = source.IndexOf(typedItem);
-                HandleItemAdded(index, typedItem);
-            }
-        }
-
-        if ((filterResult ?? true) && SortDescriptions.Any(sd => sd.PropertyName == e.PropertyName))
-        {
-            int oldIndex = view.IndexOf(typedItem);
-
-            // Check if item is in view:
-            if (oldIndex < 0)
-            {
-                return;
-            }
-
-            view.RemoveAt(oldIndex);
-            int targetIndex = view.BinarySearch(typedItem, this);
-            if (targetIndex < 0)
-            {
-                targetIndex = ~targetIndex;
-            }
-
-            // Only trigger expensive UI updates if the index really changed:
-            if (targetIndex != oldIndex)
-            {
-                OnVectorChanged(new VectorChangedEventArgs(CollectionChange.ItemRemoved, oldIndex, typedItem));
-
-                view.Insert(targetIndex, typedItem);
-
-                OnVectorChanged(new VectorChangedEventArgs(CollectionChange.ItemInserted, targetIndex, typedItem));
-            }
-            else
-            {
-                view.Insert(targetIndex, typedItem);
-            }
-        }
-        else if (string.IsNullOrEmpty(e.PropertyName))
-        {
-            HandleSourceChanged();
-        }
-    }
-
-    private void AttachPropertyChangedHandler(IEnumerable items)
-    {
-        if (!liveShapingEnabled || items is null)
-        {
-            return;
-        }
-
-        foreach (object item in items)
-        {
-            if (item is INotifyPropertyChanged notifyPropertyChanged)
-            {
-                notifyPropertyChanged.PropertyChanged += ItemOnPropertyChanged;
-            }
-        }
-    }
-
-    private void DetachPropertyChangedHandler(IEnumerable items)
-    {
-        if (!liveShapingEnabled || items is null)
-        {
-            return;
-        }
-
-        foreach (object item in items)
-        {
-            if (item is INotifyPropertyChanged notifyPropertyChanged)
-            {
-                notifyPropertyChanged.PropertyChanged -= ItemOnPropertyChanged;
-            }
-        }
-    }
-
-    private void HandleSortChanged()
-    {
-        sortProperties.Clear();
-        view.Sort(this);
-        sortProperties.Clear();
-        OnVectorChanged(new VectorChangedEventArgs(CollectionChange.Reset));
-    }
-
-    private void HandleFilterChanged()
-    {
-        if (filter is not null)
-        {
-            for (int index = 0; index < view.Count; index++)
-            {
-                T item = view[index];
-                if (filter(item))
-                {
-                    continue;
-                }
-
-                RemoveFromView(index, item);
-                index--;
-            }
-        }
-
-        HashSet<T> viewHash = new(view);
-        int viewIndex = 0;
-        for (int index = 0; index < source.Count; index++)
-        {
-            T item = source[index];
-            if (viewHash.Contains(item))
-            {
-                viewIndex++;
-                continue;
-            }
-
-            if (HandleItemAdded(index, item, viewIndex))
-            {
-                viewIndex++;
-            }
-        }
-    }
-
-    private void HandleSourceChanged()
-    {
-        sortProperties.Clear();
-        T? currentItem = CurrentItem;
-        view.Clear();
-        foreach (T item in Source)
-        {
-            if (filter is not null && !filter(item))
-            {
-                continue;
-            }
-
-            if (sortDescriptions.Count > 0)
-            {
-                int targetIndex = view.BinarySearch(item, this);
-                if (targetIndex < 0)
-                {
-                    targetIndex = ~targetIndex;
-                }
-
-                view.Insert(targetIndex, item);
-            }
-            else
-            {
-                view.Add(item);
-            }
-        }
-
-        sortProperties.Clear();
-        OnVectorChanged(new VectorChangedEventArgs(CollectionChange.Reset));
-        MoveCurrentTo(currentItem);
-    }
-
-    private void SourceNotifyCollectionChangedCollectionChanged(object sender, NotifyCollectionChangedEventArgs e)
-    {
-        switch (e.Action)
-        {
-            case NotifyCollectionChangedAction.Add:
-                ArgumentNullException.ThrowIfNull(e.NewItems);
-                AttachPropertyChangedHandler(e.NewItems);
-                if (deferCounter <= 0)
-                {
-                    if (e.NewItems?.Count == 1)
-                    {
-                        object? newItem = e.NewItems[0];
-                        ArgumentNullException.ThrowIfNull(newItem);
-                        HandleItemAdded(e.NewStartingIndex, (T)newItem);
-                    }
-                    else
-                    {
-                        HandleSourceChanged();
-                    }
-                }
-
-                break;
-            case NotifyCollectionChangedAction.Remove:
-                ArgumentNullException.ThrowIfNull(e.OldItems);
-                DetachPropertyChangedHandler(e.OldItems);
-                if (deferCounter <= 0)
-                {
-                    if (e.OldItems?.Count == 1)
-                    {
-                        object? oldItem = e.OldItems[0];
-                        ArgumentNullException.ThrowIfNull(oldItem);
-                        HandleItemRemoved(e.OldStartingIndex, (T)oldItem);
-                    }
-                    else
-                    {
-                        HandleSourceChanged();
-                    }
-                }
-
-                break;
-            case NotifyCollectionChangedAction.Move:
-            case NotifyCollectionChangedAction.Replace:
-            case NotifyCollectionChangedAction.Reset:
-                if (deferCounter <= 0)
-                {
-                    HandleSourceChanged();
-                }
-
-                break;
-        }
-    }
-
-    private bool HandleItemAdded(int newStartingIndex, T newItem, int? viewIndex = null)
-    {
-        if (filter is not null && !filter(newItem))
-        {
-            return false;
-        }
-
-        int newViewIndex = view.Count;
-
-        if (sortDescriptions.Count > 0)
-        {
-            sortProperties.Clear();
-            newViewIndex = view.BinarySearch(newItem, this);
-            if (newViewIndex < 0)
-            {
-                newViewIndex = ~newViewIndex;
-            }
-        }
-        else if (filter is not null)
-        {
-            if (source is null)
-            {
-                HandleSourceChanged();
-                return false;
-            }
-
-            if (newStartingIndex == 0 || view.Count == 0)
-            {
-                newViewIndex = 0;
-            }
-            else if (newStartingIndex == source.Count - 1)
-            {
-                newViewIndex = view.Count;
-            }
-            else if (viewIndex.HasValue)
-            {
-                newViewIndex = viewIndex.Value;
-            }
-            else
-            {
-                for (int i = 0, j = 0; i < source.Count; i++)
-                {
-                    if (i == newStartingIndex)
-                    {
-                        newViewIndex = j;
-                        break;
-                    }
-
-                    if (Equals(view[j], source[i]))
-                    {
-                        j++;
-                    }
-                }
-            }
-        }
-
-        view.Insert(newViewIndex, newItem);
-        if (newViewIndex <= CurrentPosition)
-        {
-            CurrentPosition++;
-        }
-
-        OnVectorChanged(new VectorChangedEventArgs(CollectionChange.ItemInserted, newViewIndex, newItem));
-        return true;
-    }
-
-    private void HandleItemRemoved(int oldStartingIndex, T oldItem)
-    {
-        if (filter is not null && !filter(oldItem))
-        {
-            return;
-        }
-
-        if (oldStartingIndex < 0 || oldStartingIndex >= view.Count || !Equals(view[oldStartingIndex], oldItem))
-        {
-            oldStartingIndex = view.IndexOf(oldItem);
-        }
-
-        if (oldStartingIndex < 0)
-        {
-            return;
-        }
-
-        RemoveFromView(oldStartingIndex, oldItem);
-    }
-
-    private void RemoveFromView(int itemIndex, T item)
-    {
-        view.RemoveAt(itemIndex);
-        if (itemIndex <= CurrentPosition)
-        {
-            CurrentPosition--;
-        }
-
-        OnVectorChanged(new VectorChangedEventArgs(CollectionChange.ItemRemoved, itemIndex, item));
-    }
-
-    private void SortDescriptionsCollectionChanged(object? sender, NotifyCollectionChangedEventArgs e)
-    {
-        if (deferCounter > 0)
-        {
-            return;
-        }
-
-        HandleSortChanged();
-    }
-
-    private bool MoveCurrentToIndex(int i)
-    {
-        if (i < -1 || i >= view.Count)
-        {
-            return false;
-        }
-
-        if (i == CurrentPosition)
-        {
-            return false;
-        }
-
-        CurrentChangingEventArgs e = new();
-        OnCurrentChanging(e);
-        if (e.Cancel)
-        {
-            return false;
-        }
-
-        CurrentPosition = i;
-        OnCurrentChanged(default!);
-        return true;
-    }
-
-    private void OnCurrentChanging(CurrentChangingEventArgs e)
-    {
-        if (deferCounter > 0)
-        {
-            return;
-        }
-
-        CurrentChanging?.Invoke(this, e);
-    }
-
-    private void OnCurrentChanged(object e)
-    {
-        if (deferCounter > 0)
-        {
-            return;
-        }
-
-        CurrentChanged?.Invoke(this, e);
-        OnPropertyChanged(nameof(CurrentItem));
-    }
-
-    private void OnVectorChanged(IVectorChangedEventArgs e)
-    {
-        if (deferCounter > 0)
-        {
-            return;
-        }
-
-        VectorChanged?.Invoke(this, e);
-        OnPropertyChanged(nameof(Count));
-    }
-
-    internal sealed class NotificationDeferrer : IDisposable
-    {
-        private readonly AdvancedCollectionView<T> advancedCollectionView;
-        private readonly T? currentItem;
-
-        public NotificationDeferrer(AdvancedCollectionView<T> acvs)
-        {
-            advancedCollectionView = acvs;
-            currentItem = advancedCollectionView.CurrentItem;
-            advancedCollectionView.deferCounter++;
-        }
-
-        public void Dispose()
-        {
-            advancedCollectionView.MoveCurrentTo(currentItem);
-            advancedCollectionView.deferCounter--;
-            advancedCollectionView.Refresh();
-        }
-    }
-}

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

@@ -1,105 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using CommunityToolkit.WinUI.Collections;
-using Microsoft.UI.Xaml.Data;
-using System.Collections;
-
-namespace Snap.Hutao.Control.Collection.AdvancedCollectionView;
-
-internal interface IAdvancedCollectionView<T> : ICollectionView, IEnumerable
-    where T : class
-{
-    bool CanFilter { get; }
-
-    bool CanSort { get; }
-
-    object? ICollectionView.CurrentItem
-    {
-        get => CurrentItem;
-    }
-
-    new T? CurrentItem { get; }
-
-    Predicate<T>? Filter { get; set; }
-
-    IList<SortDescription> SortDescriptions { get; }
-
-    IEnumerable<T> SourceCollection { get; }
-
-    object IList<object>.this[int index]
-    {
-        get => this[index];
-        set => this[index] = (T)value;
-    }
-
-    new T this[int index] { get; set; }
-
-    void ICollection<object>.Add(object item)
-    {
-        Add((T)item);
-    }
-
-    void Add(T item);
-
-    void ClearObservedFilterProperties();
-
-    bool ICollection<object>.Contains(object item)
-    {
-        return Contains((T)item);
-    }
-
-    bool Contains(T item);
-
-    void ICollection<object>.CopyTo(object[] array, int arrayIndex)
-    {
-        CopyTo((T[])array, arrayIndex);
-    }
-
-    void CopyTo(T[] array, int arrayIndex);
-
-    IDisposable DeferRefresh();
-
-    IEnumerator<object> IEnumerable<object>.GetEnumerator()
-    {
-        return GetEnumerator();
-    }
-
-    new IEnumerator<T> GetEnumerator();
-
-    int IList<object>.IndexOf(object item)
-    {
-        return IndexOf((T)item);
-    }
-
-    int IndexOf(T item);
-
-    void IList<object>.Insert(int index, object item)
-    {
-        Insert(index, (T)item);
-    }
-
-    void Insert(int index, T item);
-
-    bool ICollectionView.MoveCurrentTo(object item)
-    {
-        return MoveCurrentTo((T)item);
-    }
-
-    bool MoveCurrentTo(T item);
-
-    void ObserveFilterProperty(string propertyName);
-
-    void Refresh();
-
-    void RefreshFilter();
-
-    void RefreshSorting();
-
-    bool ICollection<object>.Remove(object item)
-    {
-        return Remove((T)item);
-    }
-
-    bool Remove(T item);
-}

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

@@ -1,19 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Windows.Foundation.Collections;
-
-namespace Snap.Hutao.Control.Collection.AdvancedCollectionView;
-
-internal sealed class VectorChangedEventArgs : IVectorChangedEventArgs
-{
-    public VectorChangedEventArgs(CollectionChange cc, int index = -1, object item = null!)
-    {
-        CollectionChange = cc;
-        Index = (uint)index;
-    }
-
-    public CollectionChange CollectionChange { get; }
-
-    public uint Index { get; }
-}

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

@@ -16,7 +16,22 @@ internal abstract class DependencyValueConverter<TFrom, TTo> : DependencyObject,
     /// <inheritdoc/>
     public object? Convert(object value, Type targetType, object parameter, string language)
     {
+#if DEBUG
+        try
+        {
+            return Convert((TFrom)value);
+        }
+        catch (Exception ex)
+        {
+            Ioc.Default
+                .GetRequiredService<ILogger<ValueConverter<TFrom, TTo>>>()
+                .LogError(ex, "值转换器异常");
+        }
+
+        return null;
+#else
         return Convert((TFrom)value);
+#endif
     }
 
     /// <inheritdoc/>

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

@@ -24,7 +24,7 @@ internal struct ContentDialogHideToken : IDisposable, IAsyncDisposable
         if (!disposed && !disposing)
         {
             disposing = true;
-            taskContext.InvokeOnMainThread(contentDialog.Hide);
+            taskContext.InvokeOnMainThread(contentDialog.Hide); // Hide() must be called on main thread.
             disposing = false;
             disposed = true;
         }

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

@@ -1,39 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using CommunityToolkit.WinUI;
-using Microsoft.UI.Xaml;
-using Microsoft.UI.Xaml.Controls;
-
-namespace Snap.Hutao.Control.Helper;
-
-[SuppressMessage("", "SH001")]
-[DependencyProperty("PaneCornerRadius", typeof(CornerRadius), default, nameof(OnPaneCornerRadiusChanged), IsAttached = true, AttachedType = typeof(NavigationView))]
-public sealed partial class NavigationViewHelper
-{
-    private static void OnPaneCornerRadiusChanged(DependencyObject dp, DependencyPropertyChangedEventArgs args)
-    {
-        NavigationView navigationView = (NavigationView)dp;
-        CornerRadius newValue = (CornerRadius)args.NewValue;
-
-        if (navigationView.IsLoaded)
-        {
-            SetNavigationViewPaneCornerRadius(navigationView, newValue);
-            return;
-        }
-
-        navigationView.Loaded += (s, e) =>
-        {
-            NavigationView loadedNavigationView = (NavigationView)s;
-            SetNavigationViewPaneCornerRadius(loadedNavigationView, newValue);
-        };
-    }
-
-    private static void SetNavigationViewPaneCornerRadius(NavigationView navigationView, CornerRadius value)
-    {
-        if (navigationView.FindDescendant("RootSplitView") is SplitView splitView)
-        {
-            splitView.CornerRadius = value;
-        }
-    }
-}

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

@@ -1,13 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Microsoft.UI.Xaml;
-using Microsoft.UI.Xaml.Controls;
-
-namespace Snap.Hutao.Control.Helper;
-
-[SuppressMessage("", "SH001")]
-[DependencyProperty("RightPanel", typeof(UIElement), IsAttached = true, AttachedType = typeof(ScrollViewer))]
-public sealed partial class ScrollViewerHelper
-{
-}

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

@@ -1,23 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using CommunityToolkit.WinUI.Controls;
-using Microsoft.UI.Xaml;
-
-namespace Snap.Hutao.Control.Helper;
-
-[SuppressMessage("", "SH001")]
-[DependencyProperty("IsItemsEnabled", typeof(bool), true, nameof(OnIsItemsEnabledChanged), IsAttached = true, AttachedType = typeof(SettingsExpander))]
-public sealed partial class SettingsExpanderHelper
-{
-    private static void OnIsItemsEnabledChanged(DependencyObject dp, DependencyPropertyChangedEventArgs e)
-    {
-        foreach (object item in ((SettingsExpander)dp).Items)
-        {
-            if (item is Microsoft.UI.Xaml.Controls.Control control)
-            {
-                control.IsEnabled = (bool)e.NewValue;
-            }
-        }
-    }
-}

src/Snap.Hutao/Snap.Hutao/Control/IScopedPageScopeReferenceTracker.cs

@@ -1,9 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-namespace Snap.Hutao.Control;
-
-internal interface IScopedPageScopeReferenceTracker : IDisposable
-{
-    IServiceScope CreateScope();
-}

src/Snap.Hutao/Snap.Hutao/Control/IXamlElementAccessor.cs

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

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

@@ -20,7 +20,7 @@ internal sealed class CachedImage : Implementation.ImageEx
     public CachedImage()
     {
         IsCacheEnabled = true;
-        EnableLazyLoading = false;
+        EnableLazyLoading = true;
     }
 
     /// <inheritdoc/>
@@ -40,7 +40,12 @@ internal sealed class CachedImage : Implementation.ImageEx
         {
             // The image is corrupted, remove it.
             imageCache.Remove(imageUri);
-            return default;
+            return null;
+        }
+        catch (OperationCanceledException)
+        {
+            // task was explicitly canceled
+            return null;
         }
     }
 }

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

@@ -17,9 +17,9 @@
                         CornerRadius="{TemplateBinding CornerRadius}">
                         <Image
                             Name="PlaceholderImage"
-                            Margin="{TemplateBinding PlaceholderMargin}"
                             HorizontalAlignment="{TemplateBinding HorizontalAlignment}"
                             VerticalAlignment="{TemplateBinding VerticalAlignment}"
+                            Opacity="1.0"
                             Source="{TemplateBinding PlaceholderSource}"
                             Stretch="{TemplateBinding PlaceholderStretch}"/>
                         <Image
@@ -27,6 +27,7 @@
                             HorizontalAlignment="{TemplateBinding HorizontalAlignment}"
                             VerticalAlignment="{TemplateBinding VerticalAlignment}"
                             NineGrid="{TemplateBinding NineGrid}"
+                            Opacity="0.0"
                             Stretch="{TemplateBinding Stretch}"/>
                         <VisualStateManager.VisualStateGroups>
                             <VisualStateGroup x:Name="CommonStates">

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

@@ -30,6 +30,7 @@ internal abstract partial class CompositionImage : Microsoft.UI.Xaml.Controls.Co
 
     private readonly IServiceProvider serviceProvider;
 
+    private readonly RoutedEventHandler unloadEventHandler;
     private readonly SizeChangedEventHandler sizeChangedEventHandler;
     private readonly TypedEventHandler<LoadedImageSurface, LoadedImageSourceLoadCompletedEventArgs> loadedImageSourceLoadCompletedEventHandler;
 
@@ -45,6 +46,9 @@ internal abstract partial class CompositionImage : Microsoft.UI.Xaml.Controls.Co
         serviceProvider = this.ServiceProvider();
         this.DisableInteraction();
 
+        unloadEventHandler = OnUnload;
+        Unloaded += unloadEventHandler;
+
         sizeChangedEventHandler = OnSizeChanged;
         SizeChanged += sizeChangedEventHandler;
 
@@ -63,6 +67,10 @@ internal abstract partial class CompositionImage : Microsoft.UI.Xaml.Controls.Co
     {
     }
 
+    protected virtual void Unloading()
+    {
+    }
+
     /// <summary>
     /// 更新视觉对象
     /// </summary>
@@ -80,23 +88,20 @@ internal abstract partial class CompositionImage : Microsoft.UI.Xaml.Controls.Co
         ILogger<CompositionImage> logger = serviceProvider.GetRequiredService<ILogger<CompositionImage>>();
 
         // source is valid
-        if (arg.NewValue is Uri inner)
+        if (arg.NewValue is Uri inner && !string.IsNullOrEmpty(inner.OriginalString))
         {
-            if (!string.IsNullOrEmpty(inner.OriginalString))
+            // value is different from old one
+            if (inner != (arg.OldValue as Uri))
             {
-                // value is different from old one
-                if (inner != (arg.OldValue as Uri))
-                {
-                    image
-                        .ApplyImageAsync(inner, token)
-                        .SafeForget(logger, ex => OnApplyImageFailed(serviceProvider, inner, ex));
-                }
-            }
-            else
-            {
-                image.HideAsync(token).SafeForget(logger);
+                image
+                    .ApplyImageAsync(inner, token)
+                    .SafeForget(logger, ex => OnApplyImageFailed(serviceProvider, inner, ex));
             }
         }
+        else
+        {
+            image.HideAsync(token).SafeForget(logger);
+        }
     }
 
     private static void OnApplyImageFailed(IServiceProvider serviceProvider, Uri? uri, Exception exception)
@@ -105,7 +110,7 @@ internal abstract partial class CompositionImage : Microsoft.UI.Xaml.Controls.Co
 
         if (exception is HttpRequestException httpRequestException)
         {
-            infoBarService.Error(httpRequestException, SH.FormatControlImageCompositionImageHttpRequest(uri));
+            infoBarService.Error(httpRequestException, SH.ControlImageCompositionImageHttpRequest.Format(uri));
         }
         else
         {
@@ -133,9 +138,8 @@ internal abstract partial class CompositionImage : Microsoft.UI.Xaml.Controls.Co
             {
                 imageSurface = await LoadImageSurfaceAsync(file, token).ConfigureAwait(true);
             }
-            catch (COMException ex)
+            catch (COMException)
             {
-                _ = ex;
                 imageCache.Remove(uri);
             }
             catch (IOException)
@@ -167,7 +171,7 @@ internal abstract partial class CompositionImage : Microsoft.UI.Xaml.Controls.Co
             surface.LoadCompleted += loadedImageSourceLoadCompletedEventHandler;
             if (surface.DecodedPhysicalSize.Size() <= 0D)
             {
-                await Task.WhenAny(surfaceLoadTaskCompletionSource.Task, Task.Delay(5000, token)).ConfigureAwait(true);
+                await surfaceLoadTaskCompletionSource.Task.ConfigureAwait(true);
             }
 
             LoadImageSurfaceCompleted(surface);
@@ -192,7 +196,7 @@ internal abstract partial class CompositionImage : Microsoft.UI.Xaml.Controls.Co
             {
                 await AnimationBuilder
                     .Create()
-                    .Opacity(from: 0D, to: 1D, duration: ControlAnimationConstants.ImageScaleFadeIn)
+                    .Opacity(from: 0D, to: 1D, duration: AnimationDurations.ImageFadeIn)
                     .StartAsync(this, token)
                     .ConfigureAwait(true);
             }
@@ -213,7 +217,7 @@ internal abstract partial class CompositionImage : Microsoft.UI.Xaml.Controls.Co
             {
                 await AnimationBuilder
                     .Create()
-                    .Opacity(from: 1D, to: 0D, duration: ControlAnimationConstants.ImageScaleFadeOut)
+                    .Opacity(from: 1D, to: 0D, duration: AnimationDurations.ImageFadeOut)
                     .StartAsync(this, token)
                     .ConfigureAwait(true);
             }
@@ -236,4 +240,14 @@ internal abstract partial class CompositionImage : Microsoft.UI.Xaml.Controls.Co
             UpdateVisual(spriteVisual);
         }
     }
+
+    private void OnUnload(object sender, RoutedEventArgs e)
+    {
+        Unloading();
+        spriteVisual?.Dispose();
+        spriteVisual = null;
+
+        SizeChanged -= sizeChangedEventHandler;
+        Unloaded -= unloadEventHandler;
+    }
 }

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

@@ -11,6 +11,10 @@ using Windows.Foundation;
 
 namespace Snap.Hutao.Control.Image.Implementation;
 
+internal delegate void ImageExFailedEventHandler(object sender, ImageExFailedEventArgs e);
+
+internal delegate void ImageExOpenedEventHandler(object sender, ImageExOpenedEventArgs e);
+
 [SuppressMessage("", "CA1001")]
 [SuppressMessage("", "SH003")]
 [TemplateVisualState(Name = LoadingState, GroupName = CommonGroup)]
@@ -18,34 +22,98 @@ namespace Snap.Hutao.Control.Image.Implementation;
 [TemplateVisualState(Name = UnloadedState, GroupName = CommonGroup)]
 [TemplateVisualState(Name = FailedState, GroupName = CommonGroup)]
 [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))]
-[DependencyProperty("Source", typeof(object), default(object), nameof(SourceChanged))]
-internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control, IAlphaMaskProvider
+internal abstract class ImageExBase : Microsoft.UI.Xaml.Controls.Control, IAlphaMaskProvider
 {
     protected const string PartImage = "Image";
-    protected const string PartPlaceholderImage = "PlaceholderImage";
     protected const string CommonGroup = "CommonStates";
     protected const string LoadingState = "Loading";
     protected const string LoadedState = "Loaded";
     protected const string UnloadedState = "Unloaded";
     protected const string FailedState = "Failed";
 
+    private static readonly DependencyProperty StretchProperty = DependencyProperty.Register(nameof(Stretch), typeof(Stretch), typeof(ImageExBase), new PropertyMetadata(Stretch.Uniform));
+    private static readonly DependencyProperty DecodePixelHeightProperty = DependencyProperty.Register(nameof(DecodePixelHeight), typeof(int), typeof(ImageExBase), new PropertyMetadata(0));
+    private static readonly DependencyProperty DecodePixelTypeProperty = DependencyProperty.Register(nameof(DecodePixelType), typeof(int), typeof(ImageExBase), new PropertyMetadata(DecodePixelType.Physical));
+    private static readonly DependencyProperty DecodePixelWidthProperty = DependencyProperty.Register(nameof(DecodePixelWidth), typeof(int), typeof(ImageExBase), new PropertyMetadata(0));
+    private static readonly DependencyProperty IsCacheEnabledProperty = DependencyProperty.Register(nameof(IsCacheEnabled), typeof(bool), typeof(ImageExBase), new PropertyMetadata(false));
+    private static readonly DependencyProperty EnableLazyLoadingProperty = DependencyProperty.Register(nameof(EnableLazyLoading), typeof(bool), typeof(ImageExBase), new PropertyMetadata(false, EnableLazyLoadingChanged));
+    private static readonly DependencyProperty LazyLoadingThresholdProperty = DependencyProperty.Register(nameof(LazyLoadingThreshold), typeof(double), typeof(ImageExBase), new PropertyMetadata(default(double), LazyLoadingThresholdChanged));
+    private static readonly DependencyProperty PlaceholderSourceProperty = DependencyProperty.Register(nameof(PlaceholderSource), typeof(ImageSource), typeof(ImageExBase), new PropertyMetadata(default(ImageSource), PlaceholderSourceChanged));
+    private static readonly DependencyProperty PlaceholderStretchProperty = DependencyProperty.Register(nameof(PlaceholderStretch), typeof(Stretch), typeof(ImageExBase), new PropertyMetadata(default(Stretch)));
+    private static readonly DependencyProperty SourceProperty = DependencyProperty.Register(nameof(Source), typeof(object), typeof(ImageExBase), new PropertyMetadata(null, SourceChanged));
+
     private CancellationTokenSource? tokenSource;
     private object? lazyLoadingSource;
     private bool isInViewport;
 
+    public event ImageExFailedEventHandler? ImageExFailed;
+
+    public event ImageExOpenedEventHandler? ImageExOpened;
+
+    public event EventHandler? ImageExInitialized;
+
     public bool IsInitialized { get; private set; }
 
+    public int DecodePixelHeight
+    {
+        get => (int)GetValue(DecodePixelHeightProperty);
+        set => SetValue(DecodePixelHeightProperty, value);
+    }
+
+    public DecodePixelType DecodePixelType
+    {
+        get => (DecodePixelType)GetValue(DecodePixelTypeProperty);
+        set => SetValue(DecodePixelTypeProperty, value);
+    }
+
+    public int DecodePixelWidth
+    {
+        get => (int)GetValue(DecodePixelWidthProperty);
+        set => SetValue(DecodePixelWidthProperty, value);
+    }
+
+    public Stretch Stretch
+    {
+        get => (Stretch)GetValue(StretchProperty);
+        set => SetValue(StretchProperty, value);
+    }
+
+    public bool IsCacheEnabled
+    {
+        get => (bool)GetValue(IsCacheEnabledProperty);
+        set => SetValue(IsCacheEnabledProperty, value);
+    }
+
+    public bool EnableLazyLoading
+    {
+        get => (bool)GetValue(EnableLazyLoadingProperty);
+        set => SetValue(EnableLazyLoadingProperty, value);
+    }
+
+    public double LazyLoadingThreshold
+    {
+        get => (double)GetValue(LazyLoadingThresholdProperty);
+        set => SetValue(LazyLoadingThresholdProperty, value);
+    }
+
+    public ImageSource PlaceholderSource
+    {
+        get => (ImageSource)GetValue(PlaceholderSourceProperty);
+        set => SetValue(PlaceholderSourceProperty, value);
+    }
+
+    public Stretch PlaceholderStretch
+    {
+        get => (Stretch)GetValue(PlaceholderStretchProperty);
+        set => SetValue(PlaceholderStretchProperty, value);
+    }
+
+    public object Source
+    {
+        get => GetValue(SourceProperty);
+        set => SetValue(SourceProperty, value);
+    }
+
     public bool WaitUntilLoaded
     {
         get => true;
@@ -53,10 +121,12 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
 
     protected object? Image { get; private set; }
 
-    protected object? PlaceholderImage { get; private set; }
-
     public abstract CompositionBrush GetAlphaMask();
 
+    protected virtual void OnPlaceholderSourceChanged(DependencyPropertyChangedEventArgs e)
+    {
+    }
+
     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.
@@ -66,11 +136,61 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
     protected virtual void OnImageOpened(object sender, RoutedEventArgs e)
     {
         VisualStateManager.GoToState(this, LoadedState, true);
+        ImageExOpened?.Invoke(this, new ImageExOpenedEventArgs());
     }
 
     protected virtual void OnImageFailed(object sender, ExceptionRoutedEventArgs e)
     {
         VisualStateManager.GoToState(this, FailedState, true);
+        ImageExFailed?.Invoke(this, new ImageExFailedEventArgs(new FileNotFoundException(e.ErrorMessage)));
+    }
+
+    protected void AttachImageOpened(RoutedEventHandler handler)
+    {
+        if (Image is Microsoft.UI.Xaml.Controls.Image image)
+        {
+            image.ImageOpened += handler;
+        }
+        else if (Image is ImageBrush brush)
+        {
+            brush.ImageOpened += handler;
+        }
+    }
+
+    protected void RemoveImageOpened(RoutedEventHandler handler)
+    {
+        if (Image is Microsoft.UI.Xaml.Controls.Image image)
+        {
+            image.ImageOpened -= handler;
+        }
+        else if (Image is ImageBrush brush)
+        {
+            brush.ImageOpened -= handler;
+        }
+    }
+
+    protected void AttachImageFailed(ExceptionRoutedEventHandler handler)
+    {
+        if (Image is Microsoft.UI.Xaml.Controls.Image image)
+        {
+            image.ImageFailed += handler;
+        }
+        else if (Image is ImageBrush brush)
+        {
+            brush.ImageFailed += handler;
+        }
+    }
+
+    protected void RemoveImageFailed(ExceptionRoutedEventHandler handler)
+    {
+        if (Image is Microsoft.UI.Xaml.Controls.Image image)
+        {
+            image.ImageFailed -= handler;
+        }
+        else if (Image is ImageBrush brush)
+        {
+            brush.ImageFailed -= handler;
+        }
     }
 
     protected override void OnApplyTemplate()
@@ -79,10 +199,11 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         RemoveImageFailed(OnImageFailed);
 
         Image = GetTemplateChild(PartImage);
-        PlaceholderImage = GetTemplateChild(PartPlaceholderImage);
 
         IsInitialized = true;
 
+        ImageExInitialized?.Invoke(this, EventArgs.Empty);
+
         if (Source is null || !EnableLazyLoading || isInViewport)
         {
             lazyLoadingSource = null;
@@ -97,73 +218,23 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         AttachImageFailed(OnImageFailed);
 
         base.OnApplyTemplate();
-
-        void AttachImageOpened(RoutedEventHandler handler)
-        {
-            if (Image is Microsoft.UI.Xaml.Controls.Image image)
-            {
-                image.ImageOpened += handler;
-            }
-            else if (Image is ImageBrush brush)
-            {
-                brush.ImageOpened += handler;
-            }
-        }
-
-        void AttachImageFailed(ExceptionRoutedEventHandler handler)
-        {
-            if (Image is Microsoft.UI.Xaml.Controls.Image image)
-            {
-                image.ImageFailed += handler;
-            }
-            else if (Image is ImageBrush brush)
-            {
-                brush.ImageFailed += handler;
-            }
-        }
-
-        void RemoveImageOpened(RoutedEventHandler handler)
-        {
-            if (Image is Microsoft.UI.Xaml.Controls.Image image)
-            {
-                image.ImageOpened -= handler;
-            }
-            else if (Image is ImageBrush brush)
-            {
-                brush.ImageOpened -= handler;
-            }
-        }
-
-        void RemoveImageFailed(ExceptionRoutedEventHandler handler)
-        {
-            if (Image is Microsoft.UI.Xaml.Controls.Image image)
-            {
-                image.ImageFailed -= handler;
-            }
-            else if (Image is ImageBrush brush)
-            {
-                brush.ImageFailed -= handler;
-            }
-        }
     }
 
     private static void EnableLazyLoadingChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
     {
-        if (d is not ImageExBase control)
+        if (d is ImageExBase control)
         {
-            return;
-        }
+            bool value = (bool)e.NewValue;
+            if (value)
+            {
+                control.LayoutUpdated += control.ImageExBase_LayoutUpdated;
 
-        bool value = (bool)e.NewValue;
-        if (value)
-        {
-            control.LayoutUpdated += control.OnImageExBaseLayoutUpdated;
-
-            control.InvalidateLazyLoading();
-        }
-        else
-        {
-            control.LayoutUpdated -= control.OnImageExBaseLayoutUpdated;
+                control.InvalidateLazyLoading();
+            }
+            else
+            {
+                control.LayoutUpdated -= control.ImageExBase_LayoutUpdated;
+            }
         }
     }
 
@@ -175,6 +246,14 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         }
     }
 
+    private static void PlaceholderSourceChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
+    {
+        if (d is ImageExBase control)
+        {
+            control.OnPlaceholderSourceChanged(e);
+        }
+    }
+
     private static void SourceChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
     {
         if (d is not ImageExBase control)
@@ -182,19 +261,17 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
             return;
         }
 
-        if (e.OldValue is not null && e.NewValue is not null && e.OldValue.Equals(e.NewValue))
+        if (e.OldValue is null || e.NewValue is null || !e.OldValue.Equals(e.NewValue))
         {
-            return;
-        }
-
-        if (e.NewValue is null || !control.EnableLazyLoading || control.isInViewport)
-        {
-            control.lazyLoadingSource = null;
-            control.SetSource(e.NewValue);
-        }
-        else
-        {
-            control.lazyLoadingSource = e.NewValue;
+            if (e.NewValue is null || !control.EnableLazyLoading || control.isInViewport)
+            {
+                control.lazyLoadingSource = null;
+                control.SetSource(e.NewValue);
+            }
+            else
+            {
+                control.lazyLoadingSource = e.NewValue;
+            }
         }
     }
 
@@ -224,24 +301,11 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         else if (source is BitmapSource { PixelHeight: > 0, PixelWidth: > 0 })
         {
             VisualStateManager.GoToState(this, LoadedState, true);
+            ImageExOpened?.Invoke(this, new ImageExOpenedEventArgs());
         }
     }
 
-    private void AttachPlaceholderSource(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 (PlaceholderImage is Microsoft.UI.Xaml.Controls.Image image)
-        {
-            image.Source = source;
-        }
-        else if (PlaceholderImage is ImageBrush brush)
-        {
-            brush.ImageSource = source;
-        }
-    }
-
+    [SuppressMessage("", "IDE0019")]
     private async void SetSource(object? source)
     {
         if (!IsInitialized)
@@ -262,19 +326,22 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
 
         VisualStateManager.GoToState(this, LoadingState, true);
 
-        if (source as ImageSource is { } imageSource)
+        ImageSource? imageSource = source as ImageSource;
+        if (imageSource is not null)
         {
             AttachSource(imageSource);
 
             return;
         }
 
-        if (source as Uri is not { } uri)
+        Uri? uri = source as Uri;
+        if (uri is null)
         {
             string? url = source as string ?? source.ToString();
             if (!Uri.TryCreate(url, UriKind.RelativeOrAbsolute, out uri))
             {
                 VisualStateManager.GoToState(this, FailedState, true);
+                ImageExFailed?.Invoke(this, new ImageExFailedEventArgs(new UriFormatException("Invalid uri specified.")));
                 return;
             }
         }
@@ -288,131 +355,61 @@ internal abstract partial class ImageExBase : Microsoft.UI.Xaml.Controls.Control
         {
             await LoadImageAsync(uri, tokenSource.Token).ConfigureAwait(true);
         }
-        catch (Exception ex)
-        {
-            SetPlaceholderSource(PlaceholderSource);
-
-            if (ex is OperationCanceledException)
-            {
-                // nothing to do as cancellation has been requested.
-            }
-            else
-            {
-                VisualStateManager.GoToState(this, FailedState, true);
-            }
-        }
-    }
-
-    private async void SetPlaceholderSource(object? source)
-    {
-        if (!IsInitialized)
-        {
-            return;
-        }
-
-        tokenSource?.Cancel();
-
-        tokenSource = new CancellationTokenSource();
-
-        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();
-            if (!Uri.TryCreate(url, UriKind.RelativeOrAbsolute, out uri))
-            {
-                return;
-            }
-        }
-
-        if (!IsHttpUri(uri) && !uri.IsAbsoluteUri)
-        {
-            uri = new Uri("ms-appx:///" + uri.OriginalString.TrimStart('/'));
-        }
-
-        try
-        {
-            if (uri is null)
-            {
-                return;
-            }
-
-            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(img);
-            }
-        }
         catch (OperationCanceledException)
         {
             // nothing to do as cancellation has been requested.
         }
-        catch
+        catch (Exception e)
         {
+            VisualStateManager.GoToState(this, FailedState, true);
+            ImageExFailed?.Invoke(this, new ImageExFailedEventArgs(e));
         }
     }
 
     private async Task LoadImageAsync(Uri imageUri, CancellationToken token)
     {
-        if (imageUri is null)
+        if (imageUri is not null)
         {
-            return;
-        }
-
-        if (IsCacheEnabled)
-        {
-            ImageSource? img = await ProvideCachedResourceAsync(imageUri, token).ConfigureAwait(true);
-
-            ArgumentNullException.ThrowIfNull(tokenSource);
-            if (!tokenSource.IsCancellationRequested)
+            if (IsCacheEnabled)
             {
-                // 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());
+                ImageSource? img = await ProvideCachedResourceAsync(imageUri, token).ConfigureAwait(true);
 
                 ArgumentNullException.ThrowIfNull(tokenSource);
                 if (!tokenSource.IsCancellationRequested)
                 {
-                    AttachSource(bitmap);
+                    // Only attach our image if we still have a valid request.
+                    AttachSource(img);
                 }
             }
-        }
-        else
-        {
-            AttachSource(new BitmapImage(imageUri)
+            else if (string.Equals(imageUri.Scheme, "data", StringComparison.OrdinalIgnoreCase))
             {
-                CreateOptions = BitmapCreateOptions.IgnoreImageCache,
-            });
+                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)
+    private void ImageExBase_LayoutUpdated(object? sender, object e)
     {
         InvalidateLazyLoading();
     }

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

@@ -0,0 +1,17 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Control.Image.Implementation;
+
+internal sealed class ImageExFailedEventArgs : EventArgs
+{
+    public ImageExFailedEventArgs(Exception errorException)
+    {
+        ErrorMessage = ErrorException?.Message;
+        ErrorException = errorException;
+    }
+
+    public Exception? ErrorException { get; private set; }
+
+    public string? ErrorMessage { get; private set; }
+}

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

@@ -0,0 +1,8 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Control.Image.Implementation;
+
+internal sealed class ImageExOpenedEventArgs : EventArgs
+{
+}

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

@@ -45,6 +45,16 @@ internal sealed class MonoChrome : CompositionImage
         return compositor.CompositeSpriteVisual(alphaMaskEffectBrush);
     }
 
+    protected override void Unloading()
+    {
+        ActualThemeChanged -= actualThemeChangedEventHandler;
+
+        backgroundBrush?.Dispose();
+        backgroundBrush = null;
+
+        base.Unloading();
+    }
+
     private void OnActualThemeChanged(FrameworkElement sender, object args)
     {
         if (backgroundBrush is not null)

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

@@ -1,151 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Microsoft.UI.Composition;
-using Microsoft.UI.Xaml.Controls;
-using Microsoft.UI.Xaml.Hosting;
-using System.Numerics;
-using Windows.Foundation;
-
-namespace Snap.Hutao.Control.Layout;
-
-internal sealed class DefaultItemCollectionTransitionProvider : ItemCollectionTransitionProvider
-{
-    private const double DefaultAnimationDurationInMs = 300.0;
-
-    static DefaultItemCollectionTransitionProvider()
-    {
-        AnimationSlowdownFactor = 1.0;
-    }
-
-    public static double AnimationSlowdownFactor { get; set; }
-
-    protected override bool ShouldAnimateCore(ItemCollectionTransition transition)
-    {
-        return true;
-    }
-
-    protected override void StartTransitions(IList<ItemCollectionTransition> transitions)
-    {
-        List<ItemCollectionTransition> addTransitions = [];
-        List<ItemCollectionTransition> removeTransitions = [];
-        List<ItemCollectionTransition> moveTransitions = [];
-
-        foreach (ItemCollectionTransition transition in addTransitions)
-        {
-            switch (transition.Operation)
-            {
-                case ItemCollectionTransitionOperation.Add:
-                    addTransitions.Add(transition);
-                    break;
-                case ItemCollectionTransitionOperation.Remove:
-                    removeTransitions.Add(transition);
-                    break;
-                case ItemCollectionTransitionOperation.Move:
-                    moveTransitions.Add(transition);
-                    break;
-            }
-        }
-
-        StartAddTransitions(addTransitions, removeTransitions.Count > 0, moveTransitions.Count > 0);
-        StartRemoveTransitions(removeTransitions);
-        StartMoveTransitions(moveTransitions, removeTransitions.Count > 0);
-    }
-
-    private static void StartAddTransitions(IList<ItemCollectionTransition> transitions, bool hasRemoveTransitions, bool hasMoveTransitions)
-    {
-        foreach (ItemCollectionTransition transition in transitions)
-        {
-            ItemCollectionTransitionProgress progress = transition.Start();
-            Visual visual = ElementCompositionPreview.GetElementVisual(progress.Element);
-            Compositor compositor = visual.Compositor;
-
-            ScalarKeyFrameAnimation fadeInAnimation = compositor.CreateScalarKeyFrameAnimation();
-            fadeInAnimation.InsertKeyFrame(0.0f, 0.0f);
-
-            if (hasMoveTransitions && hasRemoveTransitions)
-            {
-                fadeInAnimation.InsertKeyFrame(0.66f, 0.0f);
-            }
-            else if (hasMoveTransitions || hasRemoveTransitions)
-            {
-                fadeInAnimation.InsertKeyFrame(0.5f, 0.0f);
-            }
-
-            fadeInAnimation.InsertKeyFrame(1.0f, 1.0f);
-            fadeInAnimation.Duration = TimeSpan.FromMilliseconds(
-                DefaultAnimationDurationInMs * ((hasRemoveTransitions ? 1 : 0) + (hasMoveTransitions ? 1 : 0) + 1) * AnimationSlowdownFactor);
-
-            CompositionScopedBatch batch = compositor.CreateScopedBatch(CompositionBatchTypes.Animation);
-            visual.StartAnimation("Opacity", fadeInAnimation);
-            batch.End();
-            batch.Completed += (_, _) => progress.Complete();
-        }
-    }
-
-    private static void StartRemoveTransitions(IList<ItemCollectionTransition> transitions)
-    {
-        foreach (ItemCollectionTransition transition in transitions)
-        {
-            ItemCollectionTransitionProgress progress = transition.Start();
-            Visual visual = ElementCompositionPreview.GetElementVisual(progress.Element);
-            Compositor compositor = visual.Compositor;
-
-            ScalarKeyFrameAnimation fadeOutAnimation = compositor.CreateScalarKeyFrameAnimation();
-            fadeOutAnimation.InsertExpressionKeyFrame(0.0f, "this.CurrentValue");
-            fadeOutAnimation.InsertKeyFrame(1.0f, 0.0f);
-            fadeOutAnimation.Duration = TimeSpan.FromMilliseconds(DefaultAnimationDurationInMs * AnimationSlowdownFactor);
-
-            CompositionScopedBatch batch = compositor.CreateScopedBatch(CompositionBatchTypes.Animation);
-            visual.StartAnimation(nameof(Visual.Opacity), fadeOutAnimation);
-            batch.End();
-            batch.Completed += (_, _) =>
-            {
-                visual.Opacity = 1.0f;
-                progress.Complete();
-            };
-        }
-    }
-
-    private static void StartMoveTransitions(IList<ItemCollectionTransition> transitions, bool hasRemoveAnimations)
-    {
-        foreach (ItemCollectionTransition transition in transitions)
-        {
-            ItemCollectionTransitionProgress progress = transition.Start();
-            Visual visual = ElementCompositionPreview.GetElementVisual(progress.Element);
-            Compositor compositor = visual.Compositor;
-            CompositionScopedBatch batch = compositor.CreateScopedBatch(CompositionBatchTypes.Animation);
-
-            // Animate offset.
-            if (transition.OldBounds.X != transition.NewBounds.X ||
-                transition.OldBounds.Y != transition.NewBounds.Y)
-            {
-                AnimateOffset(visual, compositor, transition.OldBounds, transition.NewBounds, hasRemoveAnimations);
-            }
-
-            batch.End();
-            batch.Completed += (_, _) => progress.Complete();
-        }
-    }
-
-    private static void AnimateOffset(Visual visual, Compositor compositor, Rect oldBounds, Rect newBounds, bool hasRemoveAnimations)
-    {
-        Vector2KeyFrameAnimation offsetAnimation = compositor.CreateVector2KeyFrameAnimation();
-
-        offsetAnimation.SetVector2Parameter("delta", new Vector2(
-            (float)(oldBounds.X - newBounds.X),
-            (float)(oldBounds.Y - newBounds.Y)));
-        offsetAnimation.SetVector2Parameter("final", default);
-        offsetAnimation.InsertExpressionKeyFrame(0.0f, "this.CurrentValue + delta");
-        if (hasRemoveAnimations)
-        {
-            offsetAnimation.InsertExpressionKeyFrame(0.5f, "delta");
-        }
-
-        offsetAnimation.InsertExpressionKeyFrame(1.0f, "final");
-        offsetAnimation.Duration = TimeSpan.FromMilliseconds(
-            DefaultAnimationDurationInMs * ((hasRemoveAnimations ? 1 : 0) + 1) * AnimationSlowdownFactor);
-
-        visual.StartAnimation("TransformMatrix._41_42", offsetAnimation);
-    }
-}

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

@@ -1,24 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using System.Diagnostics;
-
-namespace Snap.Hutao.Control.Layout;
-
-[DebuggerDisplay("Count = {Count}, Height = {Height}")]
-internal class UniformStaggeredColumnLayout : List<UniformStaggeredItem>
-{
-    public double Height { get; private set; }
-
-    public new void Add(UniformStaggeredItem item)
-    {
-        Height = item.Top + item.Height;
-        base.Add(item);
-    }
-
-    public new void Clear()
-    {
-        Height = 0;
-        base.Clear();
-    }
-}