Merge pull request #1788 from DGP-Studio/develop

fix #1633

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

@@ -18,29 +18,29 @@ body:
       options:
         - label: 我已阅读 Snap Hutao 文档中的[常见问题](https://hut.ao/advanced/FAQ.html)和[常见程序异常](https://hut.ao/advanced/exceptions.html)，我的问题没有在文档中得到解答
           required: true
-          
-        - label: 我知道文档站的导航栏中有**搜索功能**，且已经搜索过相关关键词
+
+        - label: 我知道[文档站](https://hut.ao/zh/menu.html)的导航栏中有**搜索功能**，且已经搜索过相关关键词
           required: true
 
-        - 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)的问题也不是一个别人已发布的**重复的**问题
+        - 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)的问题也不是一个别人已发布的**重复的**问题
           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: 在应用标题，应用程序的设置界面中靠下的位置可以找到
-      placeholder: 例：1.4.15.0
+      description: 在应用标题，应用程序的反馈中心界面中可以找到
+      placeholder: 例：1.9.9.0
     validations:
       required: true
 
@@ -48,10 +48,10 @@ body:
     id: deviceid
     attributes:
       label: 设备 ID
-      description: | 
-        在胡桃工具箱的设置界面，你可以找到并复制你的设备 ID
+      description: |
+        在胡桃工具箱的反馈中心界面，你可以找到并复制你的设备 ID
         如果你的问题涉及程序崩溃，请填写该项，这将有助于我们定位问题
-        如果你的程序已经无法启动，请下载并运行[此PowerShell脚本](https://github.com/DGP-Studio/ISSUE_TEMPLATES/releases/download/get_device_id/GetHutaoDeviceId.ps1)，它将显示你的设备 ID
+        如果你的程序已经无法启动，请下载并运行[诊断工具](https://github.com/DGP-Automation/ISSUE_TEMPLATES/releases/download/diagnosis_tools/Snap.Hutao.Diagnostic.Tooling.exe)，它将显示你的设备 ID
     validations:
       required: false
 
@@ -62,24 +62,23 @@ body:
       description: 请设置一个你认为合适的分类，这将帮助我们快速定位问题
       options:
         - 安装和环境
-        - 成就管理
-        - 角色信息面板
         - 游戏启动器
+        - 祈愿记录
+        - 成就管理
+        - 我的角色
         - 实时便笺
         - 养成计算
-        - 文件缓存
-        - 祈愿记录
-        - 玩家查询
-        - 胡桃数据库
-        - 用户界面
-        - 胡桃云
-        - 胡桃帐号
-        - 签到
+        - 深境螺旋/胡桃数据库
         - Wiki
+        - 米游社账号面板
+        - 每日签到奖励
+        - 胡桃通行证/胡桃云
+        - 用户界面
+        - 文件缓存
         - 公告
         - 其它
     validations:
-      required: true   
+      required: true
 
   - type: textarea
     id: what-happened
@@ -87,7 +86,7 @@ body:
       label: 发生了什么？
       description: |
         详细的描述问题发生前后的行为，以便我们解决问题。**如果你的问题涉及程序崩溃，你应当检查 Windows 事件查看器，并将相关的 `.Net 错误`详情附上**
-        如果你无法找到该日志，请下载并运行[此PowerShell脚本](https://github.com/DGP-Studio/ISSUE_TEMPLATES/releases/download/dump_log_script/dump_log_zh.ps1)，它将输出错误日志
+        如果你无法找到该日志，请下载并运行[诊断工具](https://github.com/DGP-Automation/ISSUE_TEMPLATES/releases/download/diagnosis_tools/Snap.Hutao.DiagTools.exe)，它将转储问题日志至工具运行目录中的 `Snap.Hutao Error Log.txt`
     validations:
       required: true
 
@@ -107,4 +106,3 @@ body:
       options:
         - label: 我认为上述的描述已经足以详细，以允许开发人员能复现该问题
           required: true
-      

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

@@ -1,9 +1,7 @@
-name: 功能请求 
+name: 功能请求
 description: 通过这个议题来向开发团队分享你的想法
 title: "[Feat]: 在这里填写一个合适的标题"
-labels: ["功能", "needs-triage", "priority:none"]
-assignees:
-  - Lightczx
+labels: ["feature request", "needs-triage", "priority:none"]
 body:
   - type: markdown
     attributes:
@@ -24,4 +22,4 @@ body:
       label: 想要实现或优化的功能
       description: 详细的描述一下你想要的功能，描述的越具体，采纳的可能性越高
     validations:
-      required: true
+      required: true

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

@@ -18,29 +18,29 @@ 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 [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
+        - 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
           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:
       label: Snap Hutao Version
       description: You can find the version in application's title bar
-      placeholder: e.g. 1.4.15.0
+      placeholder: e.g. 1.9.9.0
     validations:
       required: true
 
@@ -48,10 +48,10 @@ body:
     id: deviceid
     attributes:
       label: Device ID
-      description: | 
-        In Snap Hutao's settings page, you can find and copy your device ID
+      description: |
+        In Snap Hutao's Feedback Center, 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 [this PowerShell script](https://github.com/DGP-Studio/ISSUE_TEMPLATES/releases/download/get_device_id/GetHutaoDeviceId.ps1), it will shows your device ID.
+        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.
     validations:
       required: false
 
@@ -62,24 +62,23 @@ body:
       description: Please select the most associated category of your issue
       options:
         - Installation and Environment
+        - Game Launcher
+        - Wish Export
         - Achievement
         - My Character
-        - Game Launcher
         - Realtime Note
         - Develop Plan
-        - File Cache
-        - Wish Export
-        - Game Record
-        - Hutao Database
-        - User Interface
-        - Snap Hutao Cloud
-        - Snap Hutao Account
-        - Checkin        
+        - Spiral Abyss
         - Wiki
+        - MiHoYo Account Panel
+        - Daily Checkin Reward
+        - Hutao Passport/Hutao Cloud
+        - User Interface
+        - File Cache
         - Announcement
         - Other
     validations:
-      required: true   
+      required: true
 
   - type: textarea
     id: what-happened
@@ -87,7 +86,7 @@ body:
       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 [this PowerShell script](https://github.com/DGP-Studio/ISSUE_TEMPLATES/releases/download/dump_log_script/dump_log_en.ps1), it will dump the error log.
+        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.
     validations:
       required: true
 
@@ -107,4 +106,3 @@ 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,9 +1,7 @@
 name: Feature Request [English Form]
 description: Tell us about your thought
 title: "[Feat]: Place your title here"
-labels: ["功能", "needs-triage", "priority:none"]
-assignees:
-  - Lightczx
+labels: ["feature request", "needs-triage", "priority:none"]
 body:
   - type: markdown
     attributes:
@@ -22,6 +20,6 @@ body:
     id: req
     attributes:
       label: Detail of the Feature
-      description: Descripbe the feaure in detail. The more detailed and convincing the desciprtion the more likyly feature will be accepted. 
+      description: Descripbe the feaure in detail. The more detailed and convincing the desciprtion the more likyly feature will be accepted.
     validations:
-      required: true
+      required: true

.github/ISSUE_TEMPLATE/MGMT-publish.yml

@@ -12,50 +12,26 @@ body:
     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
           - [ ]  更新日志
           - [ ]  功能文档更新
-    
-      ## 发布版本 [半自动]
-      
-      - [ ] 在 GitHub 个人设置中更新 [Publish-Automate Beta PAT](https://github.com/settings/tokens?type=beta)，有效期需小于预计发版需要天数
-      - [ ] 将更新的 PAT 更新至 Publish-Automate 库的 [Actions Secrets](https://github.com/DGP-Studio/Publish-Automate/settings/secrets/actions) 中 
 
-      ***
+       ***
 
-      - [ ] 运行 [Auto Publish Action](https://github.com/DGP-Studio/Publish-Automate/actions/workflows/auto-publish.yml)
-      - [ ]  在 https://store.rg-adguard.net/ 下载新版本安装包
-          - [ ]  Store URL: https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52
-          - [ ]  命名格式为 `Snap.Hutao x.x.x.msix`
-      - [ ]  Merge 文档 PR
-      - [ ]  发布 Release
-          - [ ]  更新日志格式（以 1.6.2 版本为例）
-    
-      ```jsx
-      ## Update log
-      https://hut.ao/en/statements/update-log.html#_1-6-2
-    
-      ## 更新日志
-      [此处从文档复制]
-    
-      ## What's Changed
-      **Full Changelog**: https://github.com/DGP-Studio/Snap.Hutao/compare/1.6.0...1.6.2
-      ```
-    
-      - [ ]  通知用户
+      - [ ] 主分支合并入 release 分支
+      - [ ] 等待 Release 自动发布
+      - [ ] 检查极狐是否同步完成 Release
+      - [ ] 通知用户
 - type: checkboxes
   id: checklist-final
   attributes:
     label: Final Check
-    description: Understand what you are doing 
+    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   
+        required: true

.github/dependabot.yml

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

.github/pull_request_template.md

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

.github/workflows/alpha.yml

@@ -5,6 +5,18 @@ on:
     branches:
       - main
       - develop
+      - 'feat/*'
+    paths-ignore:
+      - '.gitattributes'
+      - '.github/**'
+      - '.gitignore'
+      - '.gitmodules'
+      - '**.md'
+      - 'LICENSE'
+      - '**.yml'
+  pull_request:
+    branches:
+      - develop
     paths-ignore:
       - '.gitattributes'
       - '.github/**'
@@ -12,16 +24,18 @@ on:
       - '.gitmodules'
       - '**.md'
       - 'LICENSE'
+      - '**.yml'
+      - '**.resx'
 
 jobs:
   build:
     runs-on: self-hosted
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.1.1
+        uses: actions/checkout@v4
 
       - name: Setup .NET
-        uses: actions/setup-dotnet@v4.0.0
+        uses: actions/setup-dotnet@v4
         with:
           dotnet-version: 8.0
 
@@ -31,22 +45,18 @@ jobs:
         run: dotnet tool restore && dotnet cake
         env:
           VERSION_API_TOKEN: ${{ secrets.VERSION_API_TOKEN }}
-
-      - name: Sign Msix
-        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
+          CERTIFICATE: ${{ secrets.CERTIFICATE }}
+          PW: ${{ secrets.PW }}
 
       - name: Upload signed msix
-        if: success()
-        uses: actions/upload-artifact@v3
+        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()
+        if: success() && github.event_name != 'pull_request'
         shell: pwsh
         run: |
           $summary = "
@@ -54,12 +64,55 @@ jobs:
           > 该版本是由 CI 程序自动打包生成的 `Alpha` 测试版本，**仅供开发者测试使用**
 
           > [!TIP]
-          > 普通用户请[点击这里](https://github.com/DGP-Studio/Snap.Hutao/releases/latest/)下载最新的稳定版本
+          > 普通用户请 [点击这里](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) 以安装测试版安装包
+          > 请先安装 **[DGP_Studio_CA.crt](https://github.com/DGP-Automation/Hutao-Auto-Release/releases/download/certificate-ca/DGP_Studio_CA.crt)** 到 **受信任的根证书颁发机构** 以安装测试版安装包
+          "
+
+          echo $summary >> $Env:GITHUB_STEP_SUMMARY
+  fallback_build:
+    runs-on: windows-latest
+    needs: build
+    if: failure()
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: 8.0
+
+      - name: Cake
+        id: cake
+        shell: pwsh
+        run: dotnet tool restore && dotnet cake
+        env:
+          VERSION_API_TOKEN: ${{ secrets.VERSION_API_TOKEN }}
+          CERTIFICATE: ${{ secrets.CERTIFICATE }}
+          PW: ${{ secrets.PW }}
+
+      - name: Upload signed msix
+        if: success() && github.event_name != 'pull_request'
+        uses: actions/upload-artifact@v4
+        with:
+          name: Snap.Hutao.Alpha-${{ steps.cake.outputs.version }}
+          path: ${{ github.workspace }}/src/output/Snap.Hutao.Alpha-${{ steps.cake.outputs.version }}.msix
+
+      - name: Add summary
+        if: success() && github.event_name != 'pull_request'
+        shell: pwsh
+        run: |
+          $summary = "
+          > [!WARNING]
+          > 该版本是由 CI 程序自动打包生成的 `Alpha` 测试版本，**仅供开发者测试使用**
+
+          > [!TIP]
+          > 普通用户请 [点击这里](https://github.com/DGP-Studio/Snap.Hutao/releases/latest/) 下载最新的稳定版本
+
+          > [!IMPORTANT]
+          > 请先安装 **[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

@@ -0,0 +1,16 @@
+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 7 days with no activity. Remove stale label or comment or this will be closed in 3 days.'
+          days-before-stale: 7
+          days-before-close: 3
+          close-issue-reason: not_planned

.github/workflows/issue_similarity.yml

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

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

.gitlab-ci.yml

@@ -0,0 +1,77 @@
+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,13 +4,15 @@
 
 ### Setup Snap.Hutao Project
 
-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
+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.
 
 ### Start Pull Request
 

README.md

@@ -1,19 +1,44 @@
-![Banner2-large](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/742129f4-f903-4d16-bf1e-3cbfad873ee4)
+![HutaoRepoBanner3-en](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/7289da68-59cf-409b-bd85-4b5a01d0c091)
 
 
-胡桃工具箱是一款以 MIT 协议开源的原神工具箱，专为现代化 Windows 平台设计，旨在改善桌面端玩家的游戏体验。通过将既有的官方资源与开发团队设计的全新 功能相结合，它提供了一套完整且实用的工具集，且无需依赖任何移动设备。它不对游戏客户端进行任何破坏性修改以确保工具箱的安全性
+胡桃工具箱是一款以 MIT 协议开源的原神工具箱，专为现代化 Windows 平台设计，旨在改善桌面端玩家的游戏体验。通过将既有的官方资源与开发团队设计的全新功能相结合，提供了一套完整且实用的工具集，且无需依赖任何移动设备。它不对游戏客户端进行任何破坏性修改以确保工具箱的安全性
 
 Snap Hutao is an open-source Genshin Impact toolkit under MIT license, designed for modern Windows platform to improve the gaming experience for desktop players. By combining existing official resources with new features designed by the development team, it provides a complete and useful set of tools without the need to rely on mobile devices. Snap Hutao does not take any destructive modification to the game client to ensure the security of the toolkit.
 
-## 下载使用 / Download
+## 安装 / Installation
 
-[<img src="https://get.microsoft.com/images/zh-cn%20light.svg"  width="30%" height="30%">](https://apps.microsoft.com/store/detail/snap-hutao/9PH4NXJ2JN52)
+![](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)]() 
+
+---
+
+你可以按照[快速开始](https://hut.ao/zh/quick-start.html)文档中提供的流程安装并设置 Snap Hutao。
+
+You can follow the instructions in the [Quick Start](https://hut.ao/en/quick-start.html) document to install and set up Snap Hutao.
+
+## 本地化翻译 / Localization
+
+[![zh-TW translation](https://img.shields.io/badge/dynamic/json?color=blue&label=zh-TW&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27zh-TW%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+[![en translation](https://img.shields.io/badge/dynamic/json?color=blue&label=en&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27en%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+[![fr translation](https://img.shields.io/badge/dynamic/json?color=blue&label=fr&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27fr%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+[![id translation](https://img.shields.io/badge/dynamic/json?color=blue&label=id&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27id%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+[![ja translation](https://img.shields.io/badge/dynamic/json?color=blue&label=ja&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27ja%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+[![ko translation](https://img.shields.io/badge/dynamic/json?color=blue&label=ko&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27ko%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+[![pt-PT translation](https://img.shields.io/badge/dynamic/json?color=blue&label=pt-PT&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27pt-PT%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+[![ru translation](https://img.shields.io/badge/dynamic/json?color=blue&label=ru&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27ru%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+[![vi translation](https://img.shields.io/badge/dynamic/json?color=blue&label=vi&style=flat&logo=crowdin&query=%24.progress[?(@.data.languageId==%27vi%27)].data.translationProgress&url=https%3A%2F%2Fbadges.awesome-crowdin.com%2Fstats-15670597-565845.json)](https://crowdin.com/project/snap-hutao)
+
+Snap Hutao 使用 [Crowdin](https://translate.hut.ao/) 作为客户端文本翻译平台，在该平台上你可以为你熟悉的语言提交翻译文本。我们感谢每一个为 Snap Hutao 做出贡献的社区成员，并且欢迎更多的朋友能参与到这个项目中。
+
+Snap Hutao uses [Crowdin](https://translate.hut.ao/) as a client text translation platform where you can submit translated text for languages you are familiar with. We are grateful to every community member who has contributed to Snap Hutao and welcome more friends to participate in this project.
+
+## 社区 / Community
+
+[![Discord](https://img.shields.io/discord/952488447753465916?color=5865f2&label=%20Discord)](https://discord.gg/CcH5XtDtvR) [![QQ](https://img.shields.io/badge/QQ-EB1923?logo=tencent-qq&logoColor=white&label=567908135)](https://qm.qq.com/q/WJKykrY9W)
 
 ## 贡献 / Contribute
 
-* [向我们提交 PR / Make Pull Requests](https://github.com/DGP-Studio/Snap.Hutao/pulls)
-* [在 Crowdin 上进行本地化 / Translate Project on Crowdin](https://translate.hut.ao/)
-* [为我们更新文档 / Enhance our Document ](https://github.com/DGP-Studio/Snap.Hutao.Docs)
+* [向我们提交 PR / Make Pull Requests](https://hut.ao/development/contribute.html)
+* [为我们更新文档 / Enhance our Document](https://github.com/DGP-Studio/Snap.Hutao.Docs)
 
 ## 特别感谢 / Special Thanks
 
@@ -22,23 +47,20 @@ Snap Hutao is an open-source Genshin Impact toolkit under MIT license, designed
 
 ### 特定的原神项目 / Specific Genshin-related Projects
 
-* [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)
+* [Scighost/Starward](https://github.com/Scighost/Starward)
 
 ### 使用的技术栈 / Tech Stack
 
 * [CommunityToolkit/dotnet](https://github.com/CommunityToolkit/dotnet)
 * [CommunityToolkit/Labs-Windows](https://github.com/CommunityToolkit/Labs-Windows)
 * [CommunityToolkit/Windows](https://github.com/CommunityToolkit/Windows)
-* [dahall/taskscheduler](https://github.com/dahall/taskscheduler)
 * [dotnet/efcore](https://github.com/dotnet/efcore)
 * [dotnet/runtime](https://github.com/dotnet/runtime)
 * [DotNetAnalyzers/StyleCopAnalyzers](https://github.com/DotNetAnalyzers/StyleCopAnalyzers)
-* [microsoft/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)
+* [quartznet/quartznet](https://github.com/quartznet/quartznet)
 
 ### 支撑项目 / Supporter Project
 
@@ -50,9 +72,9 @@ Snap Hutao is an open-source Genshin Impact toolkit under MIT license, designed
 Snap Hutao is currently using sponsored software from the following service providers.
 
 | [![](https://www.netlify.com/v3/img/components/netlify-light.svg)](https://www.netlify.com/) | [![](https://support.crowdin.com/assets/logos/core-logo/svg/crowdin-core-logo-cDark.svg)](https://crowdin.com/) | [![](https://gitlab.cn/images/icons/logos/logo-121-75.svg)](https://gitlab.cn/) |
-|:----------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------:|
-|              [![](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/73ae8b90-f3c7-4033-b2b7-f4126331ce66)](https://about.signpath.io)              |                        [![](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/49aed8ee-9f19-4a8a-998c-7b93ee286d65)](https://1password.com/)                         |  [![](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/ad121220-d2d3-4f49-b215-b6d063dc229d)](https://about.signpath.io)   |
-
+| :----------------------------------------------------------: | :----------------------------------------------------------: | :----------------------------------------------------------: |
+| [![](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/73ae8b90-f3c7-4033-b2b7-f4126331ce66)](https://about.signpath.io) | [![](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/49aed8ee-9f19-4a8a-998c-7b93ee286d65)](https://1password.com/) | [![](https://github.com/DGP-Studio/Snap.Hutao/assets/10614984/ad121220-d2d3-4f49-b215-b6d063dc229d)](https://www.digitalocean.com) |
+| [![ducalis](https://raw.githubusercontent.com/DGP-Studio/Snap.Hutao.Docs/main/docs/.vuepress/public/svg/ducalis.svg)](https://hi.ducalis.io/) | [![jetbrains](https://github.com/DGP-Studio/Snap.Hutao/assets/36357191/4105772a-728a-4a84-9c6e-d713a5698a20)](https://www.jetbrains.com/opensource/) |                                                              |
 
 - Netlify provides document and home page hosting service for Snap Hutao
 
@@ -66,6 +88,10 @@ Snap Hutao is currently using sponsored software from the following service prov
   
 - DigitalOcean provides reliable cloud database for Snap Hutao database backup
 
+- [Ducalis.io](https://hi.ducalis.io/) provides Snap Hutao project with a complete decision-making toolkit for project management
+
+- Jetbrains provides powerful IDE for Snap Hutao infrastructure services coding
+
 ## 开发 / Development
 
 ![Snap.Hutao](https://repobeats.axiom.co/api/embed/f029553fbe0c60689b1710476ec8512452163fc9.svg)

SECURITY.md

@@ -4,8 +4,8 @@
 
 | Version | Supported          |
 | ------- | ------------------ |
-| >=1.6.0   | :white_check_mark: |
-| <1.6.0   | :x:                |
+| >=1.9.0   | :white_check_mark: |
+| <1.9.0   | :x:                |
 
 ## Reporting a Vulnerability
 

azure-pipelines.yml

@@ -1,119 +0,0 @@
-# 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: none
-pr: none
-# 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'
-
-
-steps:
-- task: UseDotNet@2
-  displayName: Install dotNet
-  inputs:
-    packageType: 'sdk'
-    version: '8.x'
-    includePreviewVersions: true
-
-- task: CmdLine@2
-  displayName: dotnet cake
-  inputs:
-    script: dotnet tool restore && dotnet cake
-
-- task: MsixSigning@1
-  name: signMsix
-  displayName: Sign MSIX package
-  inputs:
-    package: '$(Build.ArtifactStagingDirectory)/Snap.Hutao.Alpha-$(version).msix'
-    certificate: 'DGP_Studio_CI.pfx'
-    passwordVariable: 'pw'
-  condition: succeeded()
-
-- task: DownloadSecureFile@1
-  name: cerFile
-  displayName: Download Root CA
-  inputs:
-    secureFile: 'Snap.Hutao.CI.cer'
-
-- task: PublishPipelineArtifact@1
-  inputs:
-    targetPath: '$(Build.ArtifactStagingDirectory)'
-    artifact: 'Snap.Hutao.Alpha-$(version).msix'
-    publishLocation: 'pipeline'
-
-#- task: GitHubRelease@1
-#  inputs:
-#    gitHubConnection: 'github.com_Masterain'
-#    repositoryName: 'DGP-Automation/Hutao-Auto-Release'
-#    action: 'create'
-#    target: '$(Build.SourceVersion)'
-#    tagSource: 'userSpecifiedTag'
-#    tag: '$(version)'
-#    title: '$(version)'
-#    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-$(version).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-$(version).msix downloadDGPCN:/releases/PR/'
-    configPath: 'C:\agent\_work\_tasks\rclone.conf'

build.cake

@@ -1,5 +1,5 @@
-#tool "nuget:?package=nuget.commandline&version=6.5.0"
-#addin nuget:?package=Cake.Http&version=3.0.2
+#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");
@@ -11,6 +11,18 @@ var version = "version";
 var repoDir = "repoDir";
 var outputPath = "outputPath";
 
+var pfxPath = "pfxPath";
+var pw = "pw";
+
+// Extension
+
+static ProcessArgumentBuilder AppendIf(this ProcessArgumentBuilder builder, string text, bool condition)
+{
+    return condition ? builder.Append(text) : builder;
+}
+
+// Properties
+
 string solution
 {
     get => System.IO.Path.Combine(repoDir, "src", "Snap.Hutao", "Snap.Hutao.sln");
@@ -28,43 +40,38 @@ string manifest
     get => System.IO.Path.Combine(repoDir, "src", "Snap.Hutao", "Snap.Hutao", "Package.appxmanifest");
 }
 
-if (AzurePipelines.IsRunningOnAzurePipelines)
-{
-    repoDir = AzurePipelines.Environment.Build.SourcesDirectory.FullPath;
-    outputPath = AzurePipelines.Environment.Build.ArtifactStagingDirectory.FullPath;
-
-    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}");
-
-    AzurePipelines.Commands.SetVariable("version", version);
-}
-else if (GitHubActions.IsRunningOnGitHubActions)
+if (GitHubActions.IsRunningOnGitHubActions)
 {
     repoDir = GitHubActions.Environment.Workflow.Workspace.FullPath;
     outputPath = System.IO.Path.Combine(repoDir, "src", "output");
 
-    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>
-                {
+    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}");
+                    }
+            }
+        );
+
+        var certificateBase64 = HasEnvironmentVariable("CERTIFICATE") ? EnvironmentVariable("CERTIFICATE") : throw new Exception("Cannot find CERTIFICATE");
+        pw = HasEnvironmentVariable("PW") ? EnvironmentVariable("PW") : throw new Exception("Cannot find PW");
+        pfxPath = System.IO.Path.Combine(repoDir, "temp.pfx");
+        System.IO.File.WriteAllBytes(pfxPath, System.Convert.FromBase64String(certificateBase64));
+
+        Information($"Version: {version}");
+    }
 
     GitHubActions.Commands.SetOutputParameter("version", version);
 }
@@ -79,11 +86,29 @@ else if (AppVeyor.IsRunningOnAppVeyor)
     })[..^2];
     Information($"Version: {version}");
 }
+else // Local
+{
+    repoDir = System.Environment.CurrentDirectory;
+    outputPath = System.IO.Path.Combine(repoDir, "src", "output");
+
+    version = System.DateTime.Now.ToString("yyyy.M.d.") + ((int)((System.DateTime.Now - System.DateTime.Today).TotalSeconds / 86400 * 65535)).ToString();
+
+    Information($"Version: {version}");
+}
+
+// Windows SDK
+var registry = new WindowsRegistry();
+var winsdkRegistry = registry.LocalMachine.OpenKey(@"SOFTWARE\Microsoft\Windows Kits\Installed Roots");
+var winsdkVersion = winsdkRegistry.GetSubKeyNames().MaxBy(key => int.Parse(key.Split(".")[2]));
+var winsdkPath = (string)winsdkRegistry.GetValue("KitsRoot10");
+var winsdkBinPath = System.IO.Path.Combine(winsdkPath, "bin", winsdkVersion, "x64");
+Information($"Windows SDK: {winsdkPath}");
 
 Task("Build")
     .IsDependentOn("Build binary package")
     .IsDependentOn("Copy files")
-    .IsDependentOn("Build MSIX");
+    .IsDependentOn("Build MSIX")
+    .IsDependentOn("Sign");
 
 Task("NuGet Restore")
     .Does(() =>
@@ -106,7 +131,7 @@ Task("Generate AppxManifest")
 
     var content = System.IO.File.ReadAllText(manifest);
 
-    if (AzurePipelines.IsRunningOnAzurePipelines || GitHubActions.IsRunningOnGitHubActions)
+    if (GitHubActions.IsRunningOnGitHubActions)
     {
         Information("Using CI configuraion");
         content = content
@@ -122,6 +147,17 @@ Task("Generate AppxManifest")
         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\"");
     }
+    else
+    {
+        Information("Using Local configuration.");
+        content = content
+            .Replace("Snap Hutao", "Snap Hutao Local")
+            .Replace("胡桃", "胡桃 Local")
+            .Replace("DGP Studio", "DGP Studio CI");
+        content = System.Text.RegularExpressions.Regex.Replace(content, "  Name=\"([^\"]*)\"", "  Name=\"E8B6E2B3-D2A0-4435-A81D-2A16AAF405C7\"");
+        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}\"");
+    }
 
     System.IO.File.WriteAllText(manifest, content);
 
@@ -147,6 +183,7 @@ Task("Build binary package")
                                             .Append("/p:AppxPackageSigningEnabled=false")
                                             .Append("/p:AppxBundle=Never")
                                             .Append("/p:AppxPackageOutput=" + outputPath)
+                                            .AppendIf("/p:AlphaConstants=IS_ALPHA_BUILD", !AppVeyor.IsRunningOnAppVeyor)
     };
 
     DotNetBuild(project, settings);
@@ -175,7 +212,7 @@ Task("Build MSIX")
     .Does(() =>
 {
     var arguments = "arguments";
-    if (AzurePipelines.IsRunningOnAzurePipelines || GitHubActions.IsRunningOnGitHubActions)
+    if (GitHubActions.IsRunningOnGitHubActions)
     {
         arguments = "pack /d " + binPath + " /p " + System.IO.Path.Combine(outputPath, $"Snap.Hutao.Alpha-{version}.msix");
     }
@@ -183,8 +220,15 @@ Task("Build MSIX")
     {
         arguments = "pack /d " + binPath + " /p " + System.IO.Path.Combine(outputPath, $"Snap.Hutao-{version}.msix");
     }
+    else
+    {
+        arguments = "pack /d " + binPath + " /p " + System.IO.Path.Combine(outputPath, $"Snap.Hutao.Local-{version}.msix");
+    }
+
+    var makeappxPath = System.IO.Path.Combine(winsdkBinPath, "makeappx.exe");
+
     var p = StartProcess(
-        "makeappx.exe",
+        makeappxPath,
         new ProcessSettings
         {
             Arguments = arguments
@@ -192,7 +236,46 @@ Task("Build MSIX")
     );
     if (p != 0)
     {
-        throw new InvalidOperationException("Build failed with exit code " + p);
+        throw new InvalidOperationException("Build MSIX failed with exit code " + p);
+    }
+});
+
+Task("Sign")
+    .IsDependentOn("Build MSIX")
+    .Does(() =>
+{
+    if (AppVeyor.IsRunningOnAppVeyor)
+    {
+        Information("Move to SignPath. Skip signing.");
+        return;
+    }
+    else if (GitHubActions.IsRunningOnGitHubActions)
+    {
+        if (GitHubActions.Environment.PullRequest.IsPullRequest)
+        {
+            Information("Is Pull Request. Skip signing.");
+            return;
+        }
+
+        var signPath = System.IO.Path.Combine(winsdkBinPath, "signtool.exe");
+        var arguments = $"sign /debug /v /a /fd SHA256 /f {pfxPath} /p {pw} {System.IO.Path.Combine(outputPath, $"Snap.Hutao.Alpha-{version}.msix")}";
+
+        var p = StartProcess(
+            signPath,
+            new ProcessSettings
+            {
+                Arguments = arguments
+            }
+        );
+        if (p != 0)
+        {
+            throw new InvalidOperationException("Sign failed with exit code " + p);
+        }
+    }
+    else
+    {
+        Information("Local configuration. Skip signing.");
+        return;
     }
 });
 

crowdin.yml

@@ -1,3 +1,5 @@
 files:
   - source: /src/Snap.Hutao/Snap.Hutao/Resource/Localization/SH.resx
     translation: /src/Snap.Hutao/Snap.Hutao/Resource/Localization/SH.%osx_locale%.resx
+  - source: /src/Snap.Hutao/Snap.Hutao/Resource/Localization/SHRegex.resx
+    translation: /src/Snap.Hutao/Snap.Hutao/Resource/Localization/SHRegex.%osx_locale%.resx

src/Snap.Hutao/.editorconfig

@@ -110,7 +110,6 @@ dotnet_diagnostic.SA1642.severity = none
 
 dotnet_diagnostic.IDE0005.severity = warning
 dotnet_diagnostic.IDE0060.severity = none
-dotnet_diagnostic.IDE0290.severity = none
 
 # SA1208: System using directives should be placed before other using directives
 dotnet_diagnostic.SA1208.severity = none
@@ -124,9 +123,6 @@ 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
@@ -324,8 +320,9 @@ dotnet_diagnostic.CA2227.severity = suggestion
 
 # CA2251: 使用 “string.Equals”
 dotnet_diagnostic.CA2251.severity = suggestion
-csharp_style_prefer_primary_constructors = true:suggestion
-dotnet_diagnostic.SA1010.severity = none
+
+csharp_style_prefer_primary_constructors = false:none
+dotnet_diagnostic.SA1124.severity = none
 
 [*.vb]
 #### 命名样式 ####

src/Snap.Hutao/.vsconfig

@@ -0,0 +1,11 @@
+{
+    "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.Test/BaseClassLibrary/HttpClientTest.cs

@@ -0,0 +1,31 @@
+using System.Net.Http;
+
+namespace Snap.Hutao.Test.BaseClassLibrary;
+
+[TestClass]
+public sealed class HttpClientTest
+{
+    [TestMethod]
+    public void RedirectionHeaderTest()
+    {
+        HttpClientHandler handler = new()
+        {
+            UseCookies = false,
+            AllowAutoRedirect = false,
+        };
+
+        using (handler)
+        {
+            using (HttpClient httpClient = new(handler))
+            {
+                using (HttpRequestMessage request = new(HttpMethod.Get, "https://api.snapgenshin.com/patch/hutao/download"))
+                {
+                    using (HttpResponseMessage response = httpClient.Send(request))
+                    {
+                        _ = 1;
+                    }
+                }
+            }
+        }
+    }
+}

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

@@ -13,19 +13,19 @@ public sealed class JsonSerializeTest
         NumberHandling = JsonNumberHandling.AllowReadingFromString,
     };
 
-    private const string SmapleObjectJson = """
+    private const string SampleObjectJson = """
         {
             "A" :1
         }
         """;
 
-    private const string SmapleEmptyStringObjectJson = """
+    private const string SampleEmptyStringObjectJson = """
         {
             "A" : ""
         }
         """;
 
-    private const string SmapleNumberKeyDictionaryJson = """
+    private const string SampleNumberKeyDictionaryJson = """
         {
             "111" : "12",
             "222" : "34"
@@ -35,7 +35,7 @@ public sealed class JsonSerializeTest
     [TestMethod]
     public void DelegatePropertyCanSerialize()
     {
-        SampleDelegatePropertyClass sample = JsonSerializer.Deserialize<SampleDelegatePropertyClass>(SmapleObjectJson)!;
+        SampleDelegatePropertyClass sample = JsonSerializer.Deserialize<SampleDelegatePropertyClass>(SampleObjectJson)!;
         Assert.AreEqual(sample.B, 1);
     }
 
@@ -43,14 +43,23 @@ public sealed class JsonSerializeTest
     [ExpectedException(typeof(JsonException))]
     public void EmptyStringCannotSerializeAsNumber()
     {
-        SampleStringReadWriteNumberPropertyClass sample = JsonSerializer.Deserialize<SampleStringReadWriteNumberPropertyClass>(SmapleEmptyStringObjectJson)!;
+        SampleStringReadWriteNumberPropertyClass sample = JsonSerializer.Deserialize<SampleStringReadWriteNumberPropertyClass>(SampleEmptyStringObjectJson)!;
         Assert.AreEqual(sample.A, 0);
     }
 
+    [TestMethod]
+    public void EmptyStringCanSerializeAsUri()
+    {
+        SampleEmptyUriClass sample = JsonSerializer.Deserialize<SampleEmptyUriClass>(SampleEmptyStringObjectJson)!;
+        Uri.TryCreate("", UriKind.RelativeOrAbsolute, out Uri? value);
+        Console.WriteLine(value);
+        Assert.AreEqual(sample.A, value);
+    }
+
     [TestMethod]
     public void NumberStringKeyCanSerializeAsKey()
     {
-        Dictionary<int, string> sample = JsonSerializer.Deserialize<Dictionary<int, string>>(SmapleNumberKeyDictionaryJson, AlowStringNumberOptions)!;
+        Dictionary<int, string> sample = JsonSerializer.Deserialize<Dictionary<int, string>>(SampleNumberKeyDictionaryJson, AlowStringNumberOptions)!;
         Assert.AreEqual(sample[111], "12");
     }
 
@@ -92,6 +101,11 @@ public sealed class JsonSerializeTest
         public int A { get; set; }
     }
 
+    private sealed class SampleEmptyUriClass
+    {
+        public Uri A { get; set; } = default!;
+    }
+
     private sealed class SampleByteArrayPropertyClass
     {
         public byte[]? Array { get; set; }

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

@@ -0,0 +1,14 @@
+using System.Collections.Generic;
+
+namespace Snap.Hutao.Test.BaseClassLibrary;
+
+[TestClass]
+public sealed class ListTest
+{
+    [TestMethod]
+    public void IndexOfNullIsNegativeOne()
+    {
+        List<object> list = [new()];
+        Assert.AreEqual(-1, list.IndexOf(default!));
+    }
+}

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

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

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

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

@@ -160,9 +160,39 @@ public sealed class GeniusInvokationDecoding
 
             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,
+                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);

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

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

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

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

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

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

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

@@ -1,4 +1,5 @@
-using System.Collections.Generic;
+using System;
+using System.Collections.Generic;
 using System.Runtime.CompilerServices;
 using System.Runtime.InteropServices;
 
@@ -46,7 +47,59 @@ public sealed class UnsafeRuntimeBehaviorTest
         Assert.AreEqual(1212, testStruct.Value4);
     }
 
+    [TestMethod]
+    public unsafe void UnsafeUtf8StringReference()
+    {
+        void* ptr = Unsafe.AsPointer(ref MemoryMarshal.GetReference("test"u8));
+        GC.Collect(GC.MaxGeneration);
+        ReadOnlySpan<byte> bytes = MemoryMarshal.CreateReadOnlySpanFromNullTerminated((byte*)ptr);
+        Console.WriteLine(System.Text.Encoding.UTF8.GetString(bytes));
+    }
 
+    [TestMethod]
+    public unsafe void UnsafeSizeInt32ToRectInt32Test()
+    {
+        RectInt32 rectInt32 = ToRectInt32(new(100, 200));
+        Assert.AreEqual(rectInt32.X, 0);
+        Assert.AreEqual(rectInt32.Y, 0);
+        Assert.AreEqual(rectInt32.Width, 100);
+        Assert.AreEqual(rectInt32.Height, 200);
+
+        unsafe RectInt32 ToRectInt32(SizeInt32 sizeInt32)
+        {
+            byte* pBytes = stackalloc byte[sizeof(RectInt32)];
+            *(SizeInt32*)(pBytes + 8) = sizeInt32;
+            return *(RectInt32*)pBytes;
+        }
+    }
+
+    private struct RectInt32
+    {
+        public int X;
+        public int Y;
+        public int Width;
+        public int Height;
+
+        public RectInt32(int x, int y, int width, int height)
+        {
+            X = x;
+            Y = y;
+            Width = width;
+            Height = height;
+        }
+    }
+
+    private struct SizeInt32
+    {
+        public int Width;
+        public int Height;
+
+        public SizeInt32(int width, int height)
+        {
+            Width = width;
+            Height = height;
+        }
+    }
 
     private readonly struct TestStruct
     {

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

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
     <TargetFrameworks>net8.0</TargetFrameworks>
@@ -12,10 +12,11 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="8.0.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.8.0" />
-    <PackageReference Include="MSTest.TestAdapter" Version="3.1.1" />
-    <PackageReference Include="MSTest.TestFramework" Version="3.1.1" />
-    <PackageReference Include="coverlet.collector" Version="6.0.0">
+    <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="8.0.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.10.0" />
+    <PackageReference Include="MSTest.TestAdapter" Version="3.4.3" />
+    <PackageReference Include="MSTest.TestFramework" Version="3.4.3" />
+    <PackageReference Include="coverlet.collector" Version="6.0.2">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>

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

@@ -1,11 +0,0 @@
-{
-  "$schema": "https://raw.githubusercontent.com/microsoft/CsWin32/main/src/Microsoft.Windows.CsWin32/settings.schema.json",
-  "allowMarshaling": true,
-  "useSafeHandles": false,
-  "comInterop": {
-    "preserveSigMethods": [
-      "IFileOpenDialog.Show",
-      "IFileSaveDialog.Show"
-    ]
-  }
-}

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

@@ -1,94 +0,0 @@
-// COMCTL32
-DefSubclassProc
-RemoveWindowSubclass
-SetWindowSubclass
-
-// DWMAPI
-DwmSetWindowAttribute
-
-// GDI32
-GetDeviceCaps
-
-// KERNEL32
-AllocConsole
-CloseHandle
-CreateEventW
-CreateRemoteThread
-FreeConsole
-GetConsoleMode
-GetModuleHandleW
-GetProcAddress
-GetStdHandle
-K32EnumProcessModules
-K32GetModuleBaseNameW
-K32GetModuleInformation
-ReadProcessMemory
-SetConsoleMode
-SetConsoleTitle
-SetEvent
-VirtualAlloc
-VirtualAllocEx
-VirtualFree
-VirtualFreeEx
-WaitForSingleObject
-WriteProcessMemory
-
-// OLE32
-CoCreateInstance
-CoWaitForMultipleObjects
-
-// SHELL32
-SHCreateItemFromParsingName
-
-// USER32
-AttachThreadInput
-FindWindowExW
-GetCursorPos
-GetDC
-GetDpiForWindow
-GetForegroundWindow
-GetWindowPlacement
-GetWindowThreadProcessId
-ReleaseDC
-RegisterHotKey
-SendInput
-SetForegroundWindow
-UnregisterHotKey
-
-// COM
-FileOpenDialog
-FileSaveDialog
-IFileOpenDialog
-IFileSaveDialog
-IPersistFile
-IShellLinkDataList
-IShellLinkW
-ShellLink
-SHELL_LINK_DATA_FLAGS
-
-// WinRT
-IMemoryBufferByteAccess
-
-// Const value
-E_FAIL
-INFINITE
-RPC_E_WRONG_THREAD
-MAX_PATH
-WM_GETMINMAXINFO
-WM_HOTKEY
-WM_NCRBUTTONDOWN
-WM_NCRBUTTONUP
-WM_NULL
-
-// Type & Enum definition
-HRESULT_FROM_WIN32
-SLGP_FLAGS
-
-// System.Threading
-LPTHREAD_START_ROUTINE
-
-// UI.WindowsAndMessaging
-MINMAXINFO
-
-// System.Com
-CWMO_FLAGS

src/Snap.Hutao/Snap.Hutao.Win32/PInvoke.cs

@@ -1,17 +0,0 @@
-using System;
-using Windows.Win32.Foundation;
-using Windows.Win32.System.Com;
-
-namespace Windows.Win32;
-
-internal static partial class PInvoke
-{
-    /// <inheritdoc cref="CoCreateInstance(Guid*, object, CLSCTX, Guid*, out object)"/>
-    internal static unsafe HRESULT CoCreateInstance<TClass, TInterface>(object? pUnkOuter, CLSCTX dwClsContext, out TInterface ppv)
-        where TInterface : class
-    {
-        HRESULT hr = CoCreateInstance(typeof(TClass).GUID, pUnkOuter, dwClsContext, typeof(TInterface).GUID, out object o);
-        ppv = (TInterface)o;
-        return hr;
-    }
-}

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

@@ -1,25 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-
-  <PropertyGroup>
-    <TargetFramework>net8.0-windows10.0.22621.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.49-beta">
-      <PrivateAssets>all</PrivateAssets>
-      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
-    </PackageReference>
-  </ItemGroup>
-
-</Project>

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

@@ -1,24 +0,0 @@
-// 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 = unchecked((uint)sizeof(WINDOWPLACEMENT)) };
-    }
-}

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

@@ -1,72 +0,0 @@
-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,12 +8,11 @@ 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.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
@@ -66,22 +65,6 @@ 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

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

@@ -6,47 +6,61 @@
         <ResourceDictionary>
             <ResourceDictionary.MergedDictionaries>
                 <XamlControlsResources/>
-                <ResourceDictionary Source="ms-appx:///Control/Loading.xaml"/>
-                <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"/>
-                <ResourceDictionary Source="ms-appx:///Control/Theme/ItemsPanelTemplate.xaml"/>
-                <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/TransitionCollection.xaml"/>
-                <ResourceDictionary Source="ms-appx:///Control/Theme/Uri.xaml"/>
-                <ResourceDictionary Source="ms-appx:///Control/Theme/WindowOverride.xaml"/>
+                <ResourceDictionary Source="ms-appx:///CommunityToolkit.WinUI.Controls.SettingsControls/SettingsCard/SettingsCard.xaml"/>
+                <ResourceDictionary Source="ms-appx:///CommunityToolkit.Labs.WinUI.TokenView/TokenItem/TokenItem.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Elevation.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/ItemIcon.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Loading.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/StandardView.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/AutoSuggestBox/AutoSuggestTokenBox.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Card/CardBlock.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Card/CardProgressBar.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Card/HorizontalCard.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Card/VerticalCard.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Image/CachedImage.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/TextBlock/RateDeltaTextBlock.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/Card.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/Color.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/ComboBox.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/Converter.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/CornerRadius.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/FlyoutStyle.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/FontStyle.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/Glyph.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/InfoBarOverride.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/ItemsPanelTemplate.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/NumericValue.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/PageOverride.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/PivotOverride.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/ScrollViewer.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/SegmentedOverride.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/SettingsStyle.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/Thickness.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/TransitionCollection.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/Uri.xaml"/>
+                <ResourceDictionary Source="ms-appx:///UI/Xaml/Control/Theme/WindowOverride.xaml"/>
             </ResourceDictionary.MergedDictionaries>
 
             <Style
                 x:Key="LargeGridViewItemStyle"
                 BasedOn="{StaticResource DefaultGridViewItemStyle}"
                 TargetType="GridViewItem">
+                <Setter Property="HorizontalContentAlignment" Value="Stretch"/>
                 <Setter Property="Margin" Value="0,0,12,12"/>
             </Style>
             <Style
                 x:Name="NoneSelectionListViewItemStyle"
                 BasedOn="{StaticResource DefaultListViewItemStyle}"
                 TargetType="ListViewItem">
-                <Setter Property="Padding" Value="0"/>
                 <Setter Property="Margin" Value="0,4,0,0"/>
+                <Setter Property="Padding" Value="0"/>
             </Style>
             <Style
                 x:Name="NoneSelectionGridViewItemStyle"
                 BasedOn="{StaticResource DefaultGridViewItemStyle}"
                 TargetType="GridViewItem">
-                <Setter Property="Padding" Value="0"/>
                 <Setter Property="Margin" Value="0,0,2,4"/>
+                <Setter Property="Padding" Value="0"/>
             </Style>
         </ResourceDictionary>
     </Application.Resources>

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

@@ -3,10 +3,13 @@
 
 using Microsoft.UI.Xaml;
 using Microsoft.Windows.AppLifecycle;
+using Microsoft.Windows.AppNotifications;
 using Snap.Hutao.Core;
 using Snap.Hutao.Core.ExceptionService;
 using Snap.Hutao.Core.LifeCycle;
-using Snap.Hutao.Core.Shell;
+using Snap.Hutao.Core.LifeCycle.InterProcess;
+using Snap.Hutao.Core.Logging;
+using Snap.Hutao.UI.Xaml;
 using System.Diagnostics;
 
 namespace Snap.Hutao;
@@ -20,26 +23,24 @@ namespace Snap.Hutao;
 [SuppressMessage("", "SH001")]
 public sealed partial class App : Application
 {
-    private const string ConsoleBanner = """
+    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 IAppActivation activation;
     private readonly ILogger<App> logger;
 
     /// <summary>
@@ -50,43 +51,47 @@ public sealed partial class App : Application
     {
         // Load app resource
         InitializeComponent();
-
-        activation = serviceProvider.GetRequiredService<IActivation>();
+        activation = serviceProvider.GetRequiredService<IAppActivation>();
         logger = serviceProvider.GetRequiredService<ILogger<App>>();
         serviceProvider.GetRequiredService<ExceptionRecorder>().Record(this);
 
         this.serviceProvider = serviceProvider;
     }
 
+    public new void Exit()
+    {
+        XamlApplicationLifetime.Exiting = true;
+        base.Exit();
+    }
+
     /// <inheritdoc/>
     protected override void OnLaunched(LaunchActivatedEventArgs args)
     {
         try
         {
+            // Important: You must call AppNotificationManager::Default().Register
+            // before calling AppInstance.GetCurrent.GetActivatedEventArgs.
+            AppNotificationManager.Default.NotificationInvoked += activation.NotificationInvoked;
+            AppNotificationManager.Default.Register();
             AppActivationArguments activatedEventArgs = AppInstance.GetCurrent().GetActivatedEventArgs();
-            AppInstance firstInstance = AppInstance.FindOrRegisterForKey(AppInstanceKey);
 
-            if (firstInstance.IsCurrent)
+            if (serviceProvider.GetRequiredService<PrivateNamedPipeClient>().TryRedirectActivationTo(activatedEventArgs))
             {
-                logger.LogInformation(ConsoleBanner);
-
-                // manually invoke
-                activation.NonRedirectToActivate(firstInstance, activatedEventArgs);
-                activation.InitializeWith(firstInstance);
-
-                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.LogDebug("Application exiting on RedirectActivationTo");
+                Exit();
+                return;
             }
+
+            logger.LogColorizedInformation((ConsoleBanner, ConsoleColor.DarkYellow));
+            LogDiagnosticInformation();
+
+            // Manually invoke
+            activation.Activate(HutaoActivationArguments.FromAppActivationArguments(activatedEventArgs));
+            activation.PostInitialization();
         }
-        catch
+        catch (Exception ex)
         {
-            // AppInstance.GetCurrent() calls failed
+            logger.LogError(ex, "Application failed in App.OnLaunched");
             Process.GetCurrentProcess().Kill();
         }
     }
@@ -95,8 +100,8 @@ public sealed partial class App : Application
     {
         RuntimeOptions runtimeOptions = serviceProvider.GetRequiredService<RuntimeOptions>();
 
-        logger.LogInformation("FamilyName: {name}", runtimeOptions.FamilyName);
-        logger.LogInformation("Version: {version}", runtimeOptions.Version);
-        logger.LogInformation("LocalCache: {folder}", runtimeOptions.LocalCache);
+        logger.LogColorizedInformation(("FamilyName: {Name}", ConsoleColor.Blue), (runtimeOptions.FamilyName, ConsoleColor.Cyan));
+        logger.LogColorizedInformation(("Version: {Version}", ConsoleColor.Blue), (runtimeOptions.Version, ConsoleColor.Cyan));
+        logger.LogColorizedInformation(("LocalCache: {Path}", ConsoleColor.Blue), (runtimeOptions.LocalCache, ConsoleColor.Cyan));
     }
 }

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/Brush/ColorSegment.cs

@@ -1,19 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Windows.UI;
-
-namespace Snap.Hutao.Control.Brush;
-
-internal sealed class ColorSegment : IColorSegment
-{
-    public ColorSegment(Color color, double value)
-    {
-        Color = color;
-        Value = value;
-    }
-
-    public Color Color { get; set; }
-
-    public double Value { get; set; }
-}

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

@@ -1,13 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Windows.UI;
-
-namespace Snap.Hutao.Control.Brush;
-
-internal interface IColorSegment
-{
-    Color Color { get; }
-
-    double Value { get; }
-}

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

@@ -1,44 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Microsoft.UI.Xaml;
-using Microsoft.UI.Xaml.Controls;
-using Microsoft.UI.Xaml.Media;
-using Microsoft.UI.Xaml.Shapes;
-using System.Runtime.InteropServices;
-
-namespace Snap.Hutao.Control.Brush;
-
-[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()
-    {
-        Content = new Rectangle()
-        {
-            Fill = brush,
-        };
-    }
-
-    private static void OnSourceChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
-    {
-        SegmentedBar segmentedBar = (SegmentedBar)obj;
-
-        GradientStopCollection collection = segmentedBar.brush.GradientStops;
-        collection.Clear();
-
-        if (args.NewValue as List<IColorSegment> is [_, ..] list)
-        {
-            double total = list.Sum(seg => seg.Value);
-            double offset = 0;
-            foreach (ref readonly IColorSegment segment in CollectionsMarshal.AsSpan(list))
-            {
-                collection.Add(new() { Color = segment.Color, Offset = offset, });
-                offset += segment.Value / total;
-                collection.Add(new() { Color = segment.Color, Offset = offset, });
-            }
-        }
-    }
-}

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

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

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

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

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

@@ -1,51 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Microsoft.UI.Xaml.Media;
-using Microsoft.UI.Xaml.Media.Imaging;
-using Snap.Hutao.Core.Caching;
-using System.Runtime.InteropServices;
-
-namespace Snap.Hutao.Control.Image;
-
-/// <summary>
-/// 缓存图像
-/// </summary>
-[HighQuality]
-internal sealed class CachedImage : Implementation.ImageEx
-{
-    /// <summary>
-    /// 构造一个新的缓存图像
-    /// </summary>
-    public CachedImage()
-    {
-        IsCacheEnabled = true;
-        EnableLazyLoading = false;
-    }
-
-    /// <inheritdoc/>
-    protected override async Task<ImageSource?> ProvideCachedResourceAsync(Uri imageUri, CancellationToken token)
-    {
-        // We can only use Ioc to retrieve IImageCache, no IServiceProvider is available.
-        IImageCache imageCache = Ioc.Default.GetRequiredService<IImageCache>();
-
-        try
-        {
-            Verify.Operation(!string.IsNullOrEmpty(imageUri.Host), SH.ControlImageCachedImageInvalidResourceUri);
-            string file = await imageCache.GetFileFromCacheAsync(imageUri).ConfigureAwait(true); // BitmapImage need to be created by main thread.
-            token.ThrowIfCancellationRequested(); // check token state to determine whether the operation should be canceled.
-            return new BitmapImage(file.ToUri()); // BitmapImage initialize with a uri will increase image quality and loading speed.
-        }
-        catch (COMException)
-        {
-            // The image is corrupted, remove it.
-            imageCache.Remove(imageUri);
-            return null;
-        }
-        catch (OperationCanceledException)
-        {
-            // task was explicitly canceled
-            return null;
-        }
-    }
-}

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

@@ -1,44 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Microsoft.UI.Composition;
-using Microsoft.UI.Xaml;
-using Windows.Media.Casting;
-
-namespace Snap.Hutao.Control.Image.Implementation;
-
-internal class ImageEx : ImageExBase
-{
-    private static readonly DependencyProperty NineGridProperty = DependencyProperty.Register(nameof(NineGrid), typeof(Thickness), typeof(ImageEx), new PropertyMetadata(default(Thickness)));
-
-    public ImageEx()
-        : base()
-    {
-    }
-
-    public Thickness NineGrid
-    {
-        get => (Thickness)GetValue(NineGridProperty);
-        set => SetValue(NineGridProperty, value);
-    }
-
-    public override CompositionBrush GetAlphaMask()
-    {
-        if (IsInitialized && Image is Microsoft.UI.Xaml.Controls.Image image)
-        {
-            return image.GetAlphaMask();
-        }
-
-        return default!;
-    }
-
-    public CastingSource GetAsCastingSource()
-    {
-        if (IsInitialized && Image is Microsoft.UI.Xaml.Controls.Image image)
-        {
-            return image.GetAsCastingSource();
-        }
-
-        return default!;
-    }
-}

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

@@ -1,468 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using CommunityToolkit.WinUI;
-using Microsoft.UI.Composition;
-using Microsoft.UI.Xaml;
-using Microsoft.UI.Xaml.Media;
-using Microsoft.UI.Xaml.Media.Imaging;
-using System.IO;
-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)]
-[TemplateVisualState(Name = LoadedState, GroupName = CommonGroup)]
-[TemplateVisualState(Name = UnloadedState, GroupName = CommonGroup)]
-[TemplateVisualState(Name = FailedState, GroupName = CommonGroup)]
-[TemplatePart(Name = PartImage, Type = typeof(object))]
-internal abstract class ImageExBase : Microsoft.UI.Xaml.Controls.Control, IAlphaMaskProvider
-{
-    protected const string PartImage = "Image";
-    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;
-    }
-
-    protected object? Image { 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.
-        return Task.FromResult<ImageSource?>(new BitmapImage(imageUri));
-    }
-
-    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()
-    {
-        RemoveImageOpened(OnImageOpened);
-        RemoveImageFailed(OnImageFailed);
-
-        Image = GetTemplateChild(PartImage);
-
-        IsInitialized = true;
-
-        ImageExInitialized?.Invoke(this, EventArgs.Empty);
-
-        if (Source is null || !EnableLazyLoading || isInViewport)
-        {
-            lazyLoadingSource = null;
-            SetSource(Source);
-        }
-        else
-        {
-            lazyLoadingSource = Source;
-        }
-
-        AttachImageOpened(OnImageOpened);
-        AttachImageFailed(OnImageFailed);
-
-        base.OnApplyTemplate();
-    }
-
-    private static void EnableLazyLoadingChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
-    {
-        if (d is ImageExBase control)
-        {
-            bool value = (bool)e.NewValue;
-            if (value)
-            {
-                control.LayoutUpdated += control.ImageExBase_LayoutUpdated;
-
-                control.InvalidateLazyLoading();
-            }
-            else
-            {
-                control.LayoutUpdated -= control.ImageExBase_LayoutUpdated;
-            }
-        }
-    }
-
-    private static void LazyLoadingThresholdChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
-    {
-        if (d is ImageExBase control && control.EnableLazyLoading)
-        {
-            control.InvalidateLazyLoading();
-        }
-    }
-
-    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)
-        {
-            return;
-        }
-
-        if (e.OldValue is null || e.NewValue is null || !e.OldValue.Equals(e.NewValue))
-        {
-            if (e.NewValue is null || !control.EnableLazyLoading || control.isInViewport)
-            {
-                control.lazyLoadingSource = null;
-                control.SetSource(e.NewValue);
-            }
-            else
-            {
-                control.lazyLoadingSource = e.NewValue;
-            }
-        }
-    }
-
-    private static bool IsHttpUri(Uri uri)
-    {
-        return uri.IsAbsoluteUri && (uri.Scheme == "http" || uri.Scheme == "https");
-    }
-
-    private void AttachSource(ImageSource? source)
-    {
-        // Setting the source at this point should call ImageExOpened/VisualStateManager.GoToState
-        // as we register to both the ImageOpened/ImageFailed events of the underlying control.
-        // We only need to call those methods if we fail in other cases before we get here.
-        if (Image is Microsoft.UI.Xaml.Controls.Image image)
-        {
-            image.Source = source;
-        }
-        else if (Image is ImageBrush brush)
-        {
-            brush.ImageSource = source;
-        }
-
-        if (source is null)
-        {
-            VisualStateManager.GoToState(this, UnloadedState, true);
-        }
-        else if (source is BitmapSource { PixelHeight: > 0, PixelWidth: > 0 })
-        {
-            VisualStateManager.GoToState(this, LoadedState, true);
-            ImageExOpened?.Invoke(this, new ImageExOpenedEventArgs());
-        }
-    }
-
-    [SuppressMessage("", "IDE0019")]
-    private async void SetSource(object? source)
-    {
-        if (!IsInitialized)
-        {
-            return;
-        }
-
-        tokenSource?.Cancel();
-
-        tokenSource = new CancellationTokenSource();
-
-        AttachSource(null);
-
-        if (source is null)
-        {
-            return;
-        }
-
-        VisualStateManager.GoToState(this, LoadingState, true);
-
-        ImageSource? imageSource = source as ImageSource;
-        if (imageSource is not null)
-        {
-            AttachSource(imageSource);
-
-            return;
-        }
-
-        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;
-            }
-        }
-
-        if (!IsHttpUri(uri) && !uri.IsAbsoluteUri)
-        {
-            uri = new Uri("ms-appx:///" + uri.OriginalString.TrimStart('/'));
-        }
-
-        try
-        {
-            await LoadImageAsync(uri, tokenSource.Token).ConfigureAwait(true);
-        }
-        catch (OperationCanceledException)
-        {
-            // nothing to do as cancellation has been requested.
-        }
-        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 not null)
-        {
-            if (IsCacheEnabled)
-            {
-                ImageSource? img = await ProvideCachedResourceAsync(imageUri, token).ConfigureAwait(true);
-
-                ArgumentNullException.ThrowIfNull(tokenSource);
-                if (!tokenSource.IsCancellationRequested)
-                {
-                    // Only attach our image if we still have a valid request.
-                    AttachSource(img);
-                }
-            }
-            else if (string.Equals(imageUri.Scheme, "data", StringComparison.OrdinalIgnoreCase))
-            {
-                string source = imageUri.OriginalString;
-                const string base64Head = "base64,";
-                int index = source.IndexOf(base64Head, StringComparison.Ordinal);
-                if (index >= 0)
-                {
-                    byte[] bytes = Convert.FromBase64String(source[(index + base64Head.Length)..]);
-                    BitmapImage bitmap = new();
-                    await bitmap.SetSourceAsync(new MemoryStream(bytes).AsRandomAccessStream());
-
-                    ArgumentNullException.ThrowIfNull(tokenSource);
-                    if (!tokenSource.IsCancellationRequested)
-                    {
-                        AttachSource(bitmap);
-                    }
-                }
-            }
-            else
-            {
-                AttachSource(new BitmapImage(imageUri)
-                {
-                    CreateOptions = BitmapCreateOptions.IgnoreImageCache,
-                });
-            }
-        }
-    }
-
-    private void ImageExBase_LayoutUpdated(object? sender, object e)
-    {
-        InvalidateLazyLoading();
-    }
-
-    private void InvalidateLazyLoading()
-    {
-        if (!IsLoaded)
-        {
-            isInViewport = false;
-            return;
-        }
-
-        // Find the first ascendant ScrollViewer, if not found, use the root element.
-        FrameworkElement? hostElement = default;
-        IEnumerable<FrameworkElement> ascendants = this.FindAscendants().OfType<FrameworkElement>();
-        foreach (FrameworkElement ascendant in ascendants)
-        {
-            hostElement = ascendant;
-            if (hostElement is Microsoft.UI.Xaml.Controls.ScrollViewer)
-            {
-                break;
-            }
-        }
-
-        if (hostElement is null)
-        {
-            isInViewport = false;
-            return;
-        }
-
-        Rect controlRect = TransformToVisual(hostElement)
-            .TransformBounds(new Rect(0, 0, ActualWidth, ActualHeight));
-        double lazyLoadingThreshold = LazyLoadingThreshold;
-        Rect hostRect = new(
-            0 - lazyLoadingThreshold,
-            0 - lazyLoadingThreshold,
-            hostElement.ActualWidth + (2 * lazyLoadingThreshold),
-            hostElement.ActualHeight + (2 * lazyLoadingThreshold));
-
-        if (controlRect.IntersectsWith(hostRect))
-        {
-            isInViewport = true;
-
-            if (lazyLoadingSource is not null)
-            {
-                object source = lazyLoadingSource;
-                lazyLoadingSource = null;
-                SetSource(source);
-            }
-        }
-        else
-        {
-            isInViewport = false;
-        }
-    }
-}

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

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

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

@@ -1,67 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Microsoft.Graphics.Canvas.Effects;
-using Microsoft.UI;
-using Microsoft.UI.Composition;
-using Microsoft.UI.Xaml;
-using Microsoft.UI.Xaml.Media;
-using Snap.Hutao.Control.Theme;
-using Windows.Foundation;
-
-namespace Snap.Hutao.Control.Image;
-
-/// <summary>
-/// 支持单色的图像
-/// </summary>
-[HighQuality]
-internal sealed class MonoChrome : CompositionImage
-{
-    private readonly TypedEventHandler<FrameworkElement, object> actualThemeChangedEventHandler;
-
-    private CompositionColorBrush? backgroundBrush;
-
-    /// <summary>
-    /// 构造一个新的单色图像
-    /// </summary>
-    public MonoChrome()
-    {
-        actualThemeChangedEventHandler = OnActualThemeChanged;
-        ActualThemeChanged += actualThemeChangedEventHandler;
-    }
-
-    /// <inheritdoc/>
-    protected override SpriteVisual CompositeSpriteVisual(Compositor compositor, LoadedImageSurface imageSurface)
-    {
-        CompositionColorBrush blackLayerBrush = compositor.CreateColorBrush(Colors.Black);
-        CompositionSurfaceBrush imageSurfaceBrush = compositor.CompositeSurfaceBrush(imageSurface, stretch: CompositionStretch.Uniform, vRatio: 0f);
-        CompositionEffectBrush overlayBrush = compositor.CompositeBlendEffectBrush(blackLayerBrush, imageSurfaceBrush, BlendEffectMode.Overlay);
-        CompositionEffectBrush opacityBrush = compositor.CompositeLuminanceToAlphaEffectBrush(overlayBrush);
-
-        backgroundBrush = compositor.CreateColorBrush();
-        SetBackgroundColor(backgroundBrush);
-        CompositionEffectBrush alphaMaskEffectBrush = compositor.CompositeAlphaMaskEffectBrush(backgroundBrush, opacityBrush);
-
-        return compositor.CompositeSpriteVisual(alphaMaskEffectBrush);
-    }
-
-    private void OnActualThemeChanged(FrameworkElement sender, object args)
-    {
-        if (backgroundBrush is not null)
-        {
-            SetBackgroundColor(backgroundBrush);
-        }
-    }
-
-    private void SetBackgroundColor(CompositionColorBrush backgroundBrush)
-    {
-        ApplicationTheme theme = ThemeHelper.ElementToApplication(ActualTheme);
-
-        backgroundBrush.Color = theme switch
-        {
-            ApplicationTheme.Light => Colors.Black,
-            ApplicationTheme.Dark => Colors.White,
-            _ => Colors.Transparent,
-        };
-    }
-}

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

@@ -1,47 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using System.Buffers.Binary;
-using System.Runtime.CompilerServices;
-using Windows.UI;
-
-namespace Snap.Hutao.Control.Media;
-
-/// <summary>
-/// BGRA 结构
-/// </summary>
-[HighQuality]
-internal struct Bgra32
-{
-    /// <summary>
-    /// B
-    /// </summary>
-    public byte B;
-
-    /// <summary>
-    /// G
-    /// </summary>
-    public byte G;
-
-    /// <summary>
-    /// R
-    /// </summary>
-    public byte R;
-
-    /// <summary>
-    /// A
-    /// </summary>
-    public byte A;
-
-    /// <summary>
-    /// 从 Color 转换
-    /// </summary>
-    /// <param name="color">颜色</param>
-    /// <returns>新的 BGRA8 结构</returns>
-    public static unsafe implicit operator Bgra32(Color color)
-    {
-        Unsafe.SkipInit(out Bgra32 bgra8);
-        *(uint*)&bgra8 = BinaryPrimitives.ReverseEndianness(*(uint*)&color);
-        return bgra8;
-    }
-}

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

@@ -1,32 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-// Some part of this file came from:
-// https://github.com/xunkong/desktop/tree/main/src/Desktop/Desktop/Pages/CharacterInfoPage.xaml.cs
-
-namespace Snap.Hutao.Control.Media;
-
-/// <summary>
-/// Defines a color in Hue/Saturation/Lightness (HSL) space.
-/// </summary>
-internal struct Hsl32
-{
-    /// <summary>
-    /// The Hue in 0..360 range.
-    /// </summary>
-    public double H;
-
-    /// <summary>
-    /// The Saturation in 0..1 range.
-    /// </summary>
-    public double S;
-
-    /// <summary>
-    /// The Lightness in 0..1 range.
-    /// </summary>
-    public double L;
-
-    /// <summary>
-    /// The Alpha/opacity in 0..1 range.
-    /// </summary>
-    public double A;
-}

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

@@ -1,184 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-// Some part of this file came from:
-// https://github.com/xunkong/desktop/tree/main/src/Desktop/Desktop/Pages/CharacterInfoPage.xaml.cs
-
-using System.Buffers.Binary;
-using Windows.UI;
-
-namespace Snap.Hutao.Control.Media;
-
-/// <summary>
-/// RGBA 颜色
-/// </summary>
-[HighQuality]
-internal struct Rgba32
-{
-    /// <summary>
-    /// R
-    /// </summary>
-    public byte R;
-
-    /// <summary>
-    /// G
-    /// </summary>
-    public byte G;
-
-    /// <summary>
-    /// B
-    /// </summary>
-    public byte B;
-
-    /// <summary>
-    /// A
-    /// </summary>
-    public byte A;
-
-    /// <summary>
-    /// 构造一个新的 RGBA8 颜色
-    /// </summary>
-    /// <param name="hex">色值字符串</param>
-    public Rgba32(string hex)
-        : this(hex.Length == 6 ? Convert.ToUInt32($"{hex}FF", 16) : Convert.ToUInt32(hex, 16))
-    {
-    }
-
-    /// <summary>
-    /// 使用 RGBA 代码初始化新的结构
-    /// </summary>
-    /// <param name="code">RGBA 代码</param>
-    public unsafe Rgba32(uint code)
-    {
-        // RRGGBBAA -> AABBGGRR
-        fixed (Rgba32* pSelf = &this)
-        {
-            *(uint*)pSelf = BinaryPrimitives.ReverseEndianness(code);
-        }
-    }
-
-    private Rgba32(byte r, byte g, byte b, byte a)
-    {
-        R = r;
-        G = g;
-        B = b;
-        A = a;
-    }
-
-    public static unsafe implicit operator Color(Rgba32 hexColor)
-    {
-        // AABBGGRR -> BBGGRRAA
-        // AABBGGRR -> 000000AA
-        uint a = (*(uint*)&hexColor) >> 24;
-
-        // AABBGGRR -> BBGGRR00
-        uint rgb = (*(uint*)&hexColor) << 8;
-
-        // BBGGRR00 + 000000AA
-        uint rgba = rgb + a;
-
-        return *(Color*)&rgba;
-    }
-
-    /// <summary>
-    /// 从 HSL 颜色转换
-    /// </summary>
-    /// <param name="hsl">HSL 颜色</param>
-    /// <returns>RGBA8颜色</returns>
-    public static Rgba32 FromHsl(Hsl32 hsl)
-    {
-        double chroma = (1 - Math.Abs((2 * hsl.L) - 1)) * hsl.S;
-        double h1 = hsl.H / 60;
-        double x = chroma * (1 - Math.Abs((h1 % 2) - 1));
-        double m = hsl.L - (0.5 * chroma);
-        double r1, g1, b1;
-
-        if (h1 < 1)
-        {
-            r1 = chroma;
-            g1 = x;
-            b1 = 0;
-        }
-        else if (h1 < 2)
-        {
-            r1 = x;
-            g1 = chroma;
-            b1 = 0;
-        }
-        else if (h1 < 3)
-        {
-            r1 = 0;
-            g1 = chroma;
-            b1 = x;
-        }
-        else if (h1 < 4)
-        {
-            r1 = 0;
-            g1 = x;
-            b1 = chroma;
-        }
-        else if (h1 < 5)
-        {
-            r1 = x;
-            g1 = 0;
-            b1 = chroma;
-        }
-        else
-        {
-            r1 = chroma;
-            g1 = 0;
-            b1 = x;
-        }
-
-        byte r = (byte)(255 * (r1 + m));
-        byte g = (byte)(255 * (g1 + m));
-        byte b = (byte)(255 * (b1 + m));
-        byte a = (byte)(255 * hsl.A);
-
-        return new(r, g, b, a);
-    }
-
-    /// <summary>
-    /// 转换到 HSL 颜色
-    /// </summary>
-    /// <returns>HSL 颜色</returns>
-    public readonly Hsl32 ToHsl()
-    {
-        const double toDouble = 1.0 / 255;
-        double r = toDouble * R;
-        double g = toDouble * G;
-        double b = toDouble * B;
-        double max = Math.Max(Math.Max(r, g), b);
-        double min = Math.Min(Math.Min(r, g), b);
-        double chroma = max - min;
-        double h1;
-
-        if (chroma == 0)
-        {
-            h1 = 0;
-        }
-        else if (max == r)
-        {
-            // The % operator doesn't do proper modulo on negative
-            // numbers, so we'll add 6 before using it
-            h1 = (((g - b) / chroma) + 6) % 6;
-        }
-        else if (max == g)
-        {
-            h1 = 2 + ((b - r) / chroma);
-        }
-        else
-        {
-            h1 = 4 + ((r - g) / chroma);
-        }
-
-        double lightness = 0.5 * (max + min);
-        double saturation = chroma == 0 ? 0 : chroma / (1 - Math.Abs((2 * lightness) - 1));
-
-        Hsl32 ret;
-        ret.H = 60 * h1;
-        ret.S = saturation;
-        ret.L = lightness;
-        ret.A = toDouble * A;
-        return ret;
-    }
-}

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

@@ -1,43 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Windows.Foundation;
-using Windows.Graphics.Imaging;
-using Windows.Win32;
-using Windows.Win32.System.WinRT;
-using WinRT;
-
-namespace Snap.Hutao.Control.Media;
-
-/// <summary>
-/// 软件位图拓展
-/// </summary>
-[HighQuality]
-internal static class SoftwareBitmapExtension
-{
-    /// <summary>
-    /// 混合模式 正常
-    /// </summary>
-    /// <param name="softwareBitmap">软件位图</param>
-    /// <param name="tint">底色</param>
-    public static unsafe void NormalBlend(this SoftwareBitmap softwareBitmap, Bgra32 tint)
-    {
-        using (BitmapBuffer buffer = softwareBitmap.LockBuffer(BitmapBufferAccessMode.ReadWrite))
-        {
-            using (IMemoryBufferReference reference = buffer.CreateReference())
-            {
-                reference.As<IMemoryBufferByteAccess>().GetBuffer(out byte* data, out uint length);
-                Span<Bgra32> bytes = new(data, unchecked((int)length / sizeof(Bgra32)));
-                foreach (ref Bgra32 pixel in bytes)
-                {
-                    byte baseAlpha = pixel.A;
-                    int opposite = 0xFF - baseAlpha;
-                    pixel.B = (byte)(((pixel.B * baseAlpha) + (tint.B * opposite)) / 0xFF);
-                    pixel.G = (byte)(((pixel.G * baseAlpha) + (tint.G * opposite)) / 0xFF);
-                    pixel.R = (byte)(((pixel.R * baseAlpha) + (tint.R * opposite)) / 0xFF);
-                    pixel.A = 0xFF;
-                }
-            }
-        }
-    }
-}

src/Snap.Hutao/Snap.Hutao/Control/Panel/PanelSelector.xaml

@@ -1,20 +0,0 @@
-<cwc:Segmented
-    x:Class="Snap.Hutao.Control.Panel.PanelSelector"
-    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
-    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
-    xmlns:cwc="using:CommunityToolkit.WinUI.Controls"
-    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
-    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
-    xmlns:shcm="using:Snap.Hutao.Control.Markup"
-    mc:Ignorable="d">
-
-    <cwc:SegmentedItem
-        Icon="{shcm:FontIcon Glyph={StaticResource FontIconContentBulletedList}}"
-        Tag="List"
-        ToolTipService.ToolTip="{shcm:ResourceString Name=ControlPanelPanelSelectorDropdownListName}"/>
-    <cwc:SegmentedItem
-        Icon="{shcm:FontIcon Glyph={StaticResource FontIconContentGridView}}"
-        Tag="Grid"
-        ToolTipService.ToolTip="{shcm:ResourceString Name=ControlPanelPanelSelectorDropdownGridName}"/>
-
-</cwc:Segmented>

src/Snap.Hutao/Snap.Hutao/Control/Text/DescriptionTextBlock.cs

@@ -1,162 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Microsoft.UI.Xaml;
-using Microsoft.UI.Xaml.Controls;
-using Microsoft.UI.Xaml.Documents;
-using Microsoft.UI.Xaml.Media;
-using Snap.Hutao.Control.Extension;
-using Snap.Hutao.Control.Media;
-using Snap.Hutao.Control.Theme;
-using Windows.Foundation;
-using Windows.UI;
-
-namespace Snap.Hutao.Control.Text;
-
-/// <summary>
-/// 专用于呈现描述文本的文本块
-/// Some part of this file came from:
-/// https://github.com/xunkong/desktop/tree/main/src/Desktop/Desktop/Pages/CharacterInfoPage.xaml.cs
-/// </summary>
-[HighQuality]
-[DependencyProperty("Description", typeof(string), "", nameof(OnDescriptionChanged))]
-[DependencyProperty("TextStyle", typeof(Style), default(Style), nameof(OnTextStyleChanged))]
-internal sealed partial class DescriptionTextBlock : ContentControl
-{
-    private static readonly int ColorTagFullLength = "<color=#FFFFFFFF></color>".Length;
-    private static readonly int ColorTagLeftLength = "<color=#FFFFFFFF>".Length;
-
-    private static readonly int ItalicTagFullLength = "<i></i>".Length;
-    private static readonly int ItalicTagLeftLength = "<i>".Length;
-
-    private readonly TypedEventHandler<FrameworkElement, object> actualThemeChangedEventHandler;
-
-    /// <summary>
-    /// 构造一个新的呈现描述文本的文本块
-    /// </summary>
-    public DescriptionTextBlock()
-    {
-        this.DisableInteraction();
-
-        Content = new TextBlock()
-        {
-            TextWrapping = TextWrapping.Wrap,
-            Style = TextStyle,
-        };
-
-        actualThemeChangedEventHandler = OnActualThemeChanged;
-        ActualThemeChanged += actualThemeChangedEventHandler;
-    }
-
-    private static void OnDescriptionChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
-    {
-        TextBlock textBlock = (TextBlock)((DescriptionTextBlock)d).Content;
-        ReadOnlySpan<char> description = (string)e.NewValue;
-
-        UpdateDescription(textBlock, description);
-    }
-
-    private static void OnTextStyleChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
-    {
-        TextBlock textBlock = (TextBlock)((DescriptionTextBlock)d).Content;
-        textBlock.Style = (Style)e.NewValue;
-    }
-
-    private static void UpdateDescription(TextBlock textBlock, in ReadOnlySpan<char> description)
-    {
-        textBlock.Inlines.Clear();
-
-        int last = 0;
-        for (int i = 0; i < description.Length;)
-        {
-            // newline
-            if (description[i..].StartsWith(@"\n"))
-            {
-                AppendText(textBlock, description[last..i]);
-                AppendLineBreak(textBlock);
-                i += 2;
-                last = i;
-            }
-
-            // color tag
-            else if (description[i..].StartsWith("<c"))
-            {
-                AppendText(textBlock, description[last..i]);
-                Rgba32 color = new(description.Slice(i + 8, 8).ToString());
-                int length = description[(i + ColorTagLeftLength)..].IndexOf('<');
-                AppendColorText(textBlock, description.Slice(i + ColorTagLeftLength, length), color);
-
-                i += length + ColorTagFullLength;
-                last = i;
-            }
-
-            // italic
-            else if (description[i..].StartsWith("<i"))
-            {
-                AppendText(textBlock, description[last..i]);
-
-                int length = description[(i + ItalicTagLeftLength)..].IndexOf('<');
-                AppendItalicText(textBlock, description.Slice(i + ItalicTagLeftLength, length));
-
-                i += length + ItalicTagFullLength;
-                last = i;
-            }
-            else
-            {
-                i += 1;
-            }
-
-            if (i == description.Length - 1)
-            {
-                AppendText(textBlock, description[last..(i + 1)]);
-            }
-        }
-    }
-
-    private static void AppendText(TextBlock text, in ReadOnlySpan<char> slice)
-    {
-        text.Inlines.Add(new Run { Text = slice.ToString() });
-    }
-
-    private static void AppendColorText(TextBlock text, in ReadOnlySpan<char> slice, Rgba32 color)
-    {
-        Color targetColor;
-        if (ThemeHelper.IsDarkMode(text.ActualTheme))
-        {
-            targetColor = color;
-        }
-        else
-        {
-            // Make lighter in light mode
-            Hsl32 hsl = color.ToHsl();
-            hsl.L *= 0.3;
-            targetColor = Rgba32.FromHsl(hsl);
-        }
-
-        text.Inlines.Add(new Run
-        {
-            Text = slice.ToString(),
-            Foreground = new SolidColorBrush(targetColor),
-        });
-    }
-
-    private static void AppendItalicText(TextBlock text, in ReadOnlySpan<char> slice)
-    {
-        text.Inlines.Add(new Run
-        {
-            Text = slice.ToString(),
-            FontStyle = Windows.UI.Text.FontStyle.Italic,
-        });
-    }
-
-    private static void AppendLineBreak(TextBlock text)
-    {
-        text.Inlines.Add(new LineBreak());
-    }
-
-    private void OnActualThemeChanged(FrameworkElement sender, object args)
-    {
-        // Simply re-apply texts
-        UpdateDescription((TextBlock)Content, Description);
-    }
-}

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

@@ -1,33 +0,0 @@
-<ResourceDictionary
-    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
-    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
-    xmlns:cwm="using:CommunityToolkit.WinUI.Media">
-    <ResourceDictionary.ThemeDictionaries>
-        <ResourceDictionary x:Key="Light">
-            <cwm:AttachedCardShadow
-                x:Key="CompatCardShadow"
-                BlurRadius="8"
-                Opacity="0.14"
-                Offset="0,4,0"/>
-        </ResourceDictionary>
-        <ResourceDictionary x:Key="Dark">
-            <cwm:AttachedCardShadow
-                x:Key="CompatCardShadow"
-                BlurRadius="8"
-                Opacity="0.28"
-                Offset="0,4,0"/>
-        </ResourceDictionary>
-    </ResourceDictionary.ThemeDictionaries>
-    <Style x:Key="BorderCardStyle" TargetType="Border">
-        <Setter Property="Background" Value="{ThemeResource CardBackgroundFillColorDefaultBrush}"/>
-        <Setter Property="BorderBrush" Value="{ThemeResource CardStrokeColorDefaultBrush}"/>
-        <Setter Property="BorderThickness" Value="1"/>
-        <Setter Property="CornerRadius" Value="{ThemeResource ControlCornerRadius}"/>
-    </Style>
-    <Style x:Key="GridCardStyle" TargetType="Grid">
-        <Setter Property="Background" Value="{ThemeResource CardBackgroundFillColorDefaultBrush}"/>
-        <Setter Property="BorderBrush" Value="{ThemeResource CardStrokeColorDefaultBrush}"/>
-        <Setter Property="BorderThickness" Value="1"/>
-        <Setter Property="CornerRadius" Value="{ThemeResource ControlCornerRadius}"/>
-    </Style>
-</ResourceDictionary>

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

@@ -1,5 +0,0 @@
-<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
-    <x:Double x:Key="PivotHeaderItemFontSize">16</x:Double>
-    <Thickness x:Key="PivotHeaderItemMargin">16,0,0,0</Thickness>
-    <Thickness x:Key="PivotItemMargin">0</Thickness>
-</ResourceDictionary>

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

@@ -1,44 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Microsoft.UI.Xaml.Data;
-
-namespace Snap.Hutao.Control;
-
-/// <summary>
-/// 值转换器
-/// </summary>
-/// <typeparam name="TFrom">源类型</typeparam>
-/// <typeparam name="TTo">目标类型</typeparam>
-internal abstract class ValueConverter<TFrom, TTo> : IValueConverter
-{
-    /// <inheritdoc/>
-    public object? Convert(object value, Type targetType, object parameter, string language)
-    {
-        return Convert((TFrom)value);
-    }
-
-    /// <inheritdoc/>
-    public object? ConvertBack(object value, Type targetType, object parameter, string language)
-    {
-        return ConvertBack((TTo)value);
-    }
-
-    /// <summary>
-    /// 从源类型转换到目标类型
-    /// </summary>
-    /// <param name="from">源</param>
-    /// <returns>目标</returns>
-    public abstract TTo Convert(TFrom from);
-
-    /// <summary>
-    /// 从目标类型转换到源类型
-    /// 重写时请勿调用基类方法
-    /// </summary>
-    /// <param name="to">目标</param>
-    /// <returns>源</returns>
-    public virtual TFrom ConvertBack(TTo to)
-    {
-        throw Must.NeverHappen();
-    }
-}

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

@@ -1,10 +1,9 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
-using Snap.Hutao.Web.Request.Builder.Abstraction;
 using System.Diagnostics;
 
-namespace Snap.Hutao.Web.Request.Builder;
+namespace Snap.Hutao.Core.Abstraction;
 
 internal static class BuilderExtension
 {

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

@@ -1,8 +1,6 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
-namespace Snap.Hutao.Service.Inventroy;
+namespace Snap.Hutao.Core.Abstraction;
 
-internal interface IInventoryService
-{
-}
+internal interface IBuilder;

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

@@ -1,18 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-namespace Snap.Hutao.Core.Abstraction;
-
-/// <summary>
-/// 可克隆
-/// </summary>
-/// <typeparam name="TSelf">自身类型</typeparam>
-[HighQuality]
-internal interface ICloneable<out TSelf>
-{
-    /// <summary>
-    /// 克隆
-    /// </summary>
-    /// <returns>新的克隆</returns>
-    TSelf Clone();
-}

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

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

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

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

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

@@ -1,7 +1,7 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
-using Snap.Hutao.Core.DependencyInjection.Abstraction;
+using Microsoft.UI.Xaml;
 using Snap.Hutao.Core.IO;
 
 namespace Snap.Hutao.Core.Caching;
@@ -10,29 +10,13 @@ namespace Snap.Hutao.Core.Caching;
 /// 为图像缓存提供抽象
 /// </summary>
 [HighQuality]
-internal interface IImageCache : ICastService
+internal interface IImageCache
 {
-    /// <summary>
-    /// Gets the file path containing cached item for given Uri
-    /// </summary>
-    /// <param name="uri">Uri of the item.</param>
-    /// <returns>a string path</returns>
     ValueTask<ValueFile> GetFileFromCacheAsync(Uri uri);
 
-    /// <summary>
-    /// Removed items based on uri list passed
-    /// </summary>
-    /// <param name="uriForCachedItems">Enumerable uri list</param>
+    ValueTask<ValueFile> GetFileFromCacheAsync(Uri uri, ElementTheme theme);
+
     void Remove(in ReadOnlySpan<Uri> uriForCachedItems);
 
-    /// <summary>
-    /// Removed item based on uri passed
-    /// </summary>
-    /// <param name="uriForCachedItem">uri</param>
     void Remove(Uri uriForCachedItem);
-
-    /// <summary>
-    /// Removes invalid cached files
-    /// </summary>
-    void RemoveInvalid();
 }

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

@@ -1,22 +1,31 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
+using Microsoft.Extensions.Caching.Memory;
+using Microsoft.UI.Xaml;
 using Snap.Hutao.Core.DependencyInjection.Annotation.HttpClient;
+using Snap.Hutao.Core.ExceptionService;
 using Snap.Hutao.Core.IO;
+using Snap.Hutao.Core.IO.Hashing;
+using Snap.Hutao.Core.Logging;
+using Snap.Hutao.UI;
+using Snap.Hutao.ViewModel.Guide;
+using Snap.Hutao.Web;
+using Snap.Hutao.Web.Request.Builder;
+using Snap.Hutao.Web.Request.Builder.Abstraction;
+using Snap.Hutao.Win32.System.WinRT;
 using System.Collections.Concurrent;
 using System.Collections.Frozen;
+using System.Diagnostics;
 using System.IO;
 using System.Net;
 using System.Net.Http;
-using System.Security.Cryptography;
-using System.Text;
+using Windows.Foundation;
+using Windows.Graphics.Imaging;
+using WinRT;
 
 namespace Snap.Hutao.Core.Caching;
 
-/// <summary>
-/// Provides methods and tools to cache files in a folder
-/// The class's name will become the cache folder's name
-/// </summary>
 [HighQuality]
 [ConstructorGenerated]
 [Injection(InjectAs.Singleton, typeof(IImageCache))]
@@ -24,37 +33,42 @@ namespace Snap.Hutao.Core.Caching;
 [PrimaryHttpMessageHandler(MaxConnectionsPerServer = 8)]
 internal sealed partial class ImageCache : IImageCache, IImageCacheFilePathOperation
 {
-    private const string CacheFolderName = nameof(ImageCache);
+    private const string CacheFailedDownloadTasksName = $"{nameof(ImageCache)}.FailedDownloadTasks";
 
-    private readonly FrozenDictionary<int, TimeSpan> retryCountToDelay = new Dictionary<int, TimeSpan>()
-    {
-        [0] = TimeSpan.FromSeconds(4),
-        [1] = TimeSpan.FromSeconds(16),
-        [2] = TimeSpan.FromSeconds(64),
-    }.ToFrozenDictionary();
+    private static readonly FrozenDictionary<int, TimeSpan> DelayFromRetryCount = FrozenDictionary.ToFrozenDictionary(
+    [
+        KeyValuePair.Create(0, TimeSpan.FromSeconds(4)),
+        KeyValuePair.Create(1, TimeSpan.FromSeconds(16)),
+        KeyValuePair.Create(2, TimeSpan.FromSeconds(64)),
+    ]);
 
-    private readonly ConcurrentDictionary<string, Task> concurrentTasks = new();
+    private readonly ConcurrentDictionary<ElementThemeValueFile, Task> themefileTasks = [];
+    private readonly ConcurrentDictionary<string, Task> downloadTasks = [];
 
+    private readonly IHttpRequestMessageBuilderFactory httpRequestMessageBuilderFactory;
     private readonly IHttpClientFactory httpClientFactory;
     private readonly IServiceProvider serviceProvider;
     private readonly ILogger<ImageCache> logger;
+    private readonly IMemoryCache memoryCache;
 
-    private string? baseFolder;
     private string? cacheFolder;
 
-    /// <inheritdoc/>
-    public void RemoveInvalid()
+    private string CacheFolder
     {
-        RemoveInternal(Directory.GetFiles(GetCacheFolder()).Where(file => IsFileInvalid(file, false)));
+        get => LazyInitializer.EnsureInitialized(ref cacheFolder, () =>
+        {
+            string folder = serviceProvider.GetRequiredService<RuntimeOptions>().GetLocalCacheImageCacheFolder();
+            Directory.CreateDirectory(Path.Combine(folder, "Light"));
+            Directory.CreateDirectory(Path.Combine(folder, "Dark"));
+            return folder;
+        });
     }
 
-    /// <inheritdoc/>
     public void Remove(Uri uriForCachedItem)
     {
         Remove([uriForCachedItem]);
     }
 
-    /// <inheritdoc/>
     public void Remove(in ReadOnlySpan<Uri> uriForCachedItems)
     {
         if (uriForCachedItems.Length <= 0)
@@ -62,7 +76,7 @@ internal sealed partial class ImageCache : IImageCache, IImageCacheFilePathOpera
             return;
         }
 
-        string folder = GetCacheFolder();
+        string folder = CacheFolder;
         string[] files = Directory.GetFiles(folder);
 
         List<string> filesToDelete = [];
@@ -75,55 +89,96 @@ internal sealed partial class ImageCache : IImageCache, IImageCacheFilePathOpera
             }
         }
 
-        RemoveInternal(filesToDelete);
+        RemoveCore(filesToDelete);
     }
 
-    /// <inheritdoc/>
-    public async ValueTask<ValueFile> GetFileFromCacheAsync(Uri uri)
+    public ValueTask<ValueFile> GetFileFromCacheAsync(Uri uri)
+    {
+        return GetFileFromCacheAsync(uri, ElementTheme.Default);
+    }
+
+    public async ValueTask<ValueFile> GetFileFromCacheAsync(Uri uri, ElementTheme theme)
     {
         string fileName = GetCacheFileName(uri);
-        string filePath = Path.Combine(GetCacheFolder(), fileName);
+        string defaultFilePath = Path.Combine(CacheFolder, fileName);
+        string themeOrDefaultFilePath = theme is ElementTheme.Dark or ElementTheme.Light
+            ? Path.Combine(CacheFolder, $"{theme}", fileName)
+            : defaultFilePath;
 
-        if (File.Exists(filePath) && new FileInfo(filePath).Length != 0)
+        if (!IsFileInvalid(themeOrDefaultFilePath))
         {
-            return filePath;
+            return themeOrDefaultFilePath;
         }
 
-        TaskCompletionSource taskCompletionSource = new();
-        try
+        ElementThemeValueFile key = new(fileName, theme);
+
+        // To prevent re-entrancy, always try add first, and if add failed, we try to get the task
+        TaskCompletionSource themeFileTcs = new();
+        if (themefileTasks.TryAdd(key, themeFileTcs.Task))
         {
-            if (concurrentTasks.TryAdd(fileName, taskCompletionSource.Task))
+            try
             {
-                await DownloadFileAsync(uri, filePath).ConfigureAwait(false);
+                if (!IsFileInvalid(defaultFilePath))
+                {
+                    await ConvertAndSaveFileToMonoChromeAsync(defaultFilePath, themeOrDefaultFilePath, theme).ConfigureAwait(false);
+                    return themeOrDefaultFilePath;
+                }
+
+                TaskCompletionSource downloadTcs = new();
+                if (downloadTasks.TryAdd(fileName, downloadTcs.Task))
+                {
+                    try
+                    {
+                        logger.LogColorizedInformation("Begin to download file from '{Uri}' to '{File}'", (uri, ConsoleColor.Cyan), (defaultFilePath, ConsoleColor.Cyan));
+                        await DownloadFileAsync(uri, defaultFilePath).ConfigureAwait(false);
+                    }
+                    finally
+                    {
+                        downloadTcs.TrySetResult();
+                        downloadTasks.TryRemove(fileName, out _);
+                    }
+                }
+                else if (downloadTasks.TryGetValue(fileName, out Task? task))
+                {
+                    logger.LogDebug("Waiting for a queued image download task to complete for '{Uri}'", (uri, ConsoleColor.Cyan));
+                    await task.ConfigureAwait(false);
+                }
+
+                if (!IsFileInvalid(defaultFilePath))
+                {
+                    await ConvertAndSaveFileToMonoChromeAsync(defaultFilePath, themeOrDefaultFilePath, theme).ConfigureAwait(false);
+                    return themeOrDefaultFilePath;
+                }
+
+                return themeOrDefaultFilePath;
             }
-            else if (concurrentTasks.TryGetValue(fileName, out Task? task))
+            finally
             {
-                await task.ConfigureAwait(false);
+                themeFileTcs.TrySetResult();
+                themefileTasks.TryRemove(key, out _);
             }
-
-            concurrentTasks.TryRemove(fileName, out _);
         }
-        finally
+        else if (themefileTasks.TryGetValue(key, out Task? themeTask))
         {
-            taskCompletionSource.TrySetResult();
+            await themeTask.ConfigureAwait(false);
+            return themeOrDefaultFilePath;
+        }
+        else
+        {
+            throw HutaoException.NotSupported("The task should not be null.");
         }
-
-        return filePath;
     }
 
     /// <inheritdoc/>
     public ValueFile GetFileFromCategoryAndName(string category, string fileName)
     {
-        Uri dummyUri = Web.HutaoEndpoints.StaticRaw(category, fileName).ToUri();
-        return Path.Combine(GetCacheFolder(), GetCacheFileName(dummyUri));
+        Uri dummyUri = HutaoEndpoints.StaticRaw(category, fileName).ToUri();
+        return Path.Combine(CacheFolder, GetCacheFileName(dummyUri));
     }
 
     private static string GetCacheFileName(Uri uri)
     {
-        string url = uri.ToString();
-        byte[] chars = Encoding.UTF8.GetBytes(url);
-        byte[] hash = SHA1.HashData(chars);
-        return System.Convert.ToHexString(hash);
+        return Hash.SHA1HexString(uri.ToString());
     }
 
     private static bool IsFileInvalid(string file, bool treatNullFileAsInvalid = true)
@@ -133,21 +188,65 @@ internal sealed partial class ImageCache : IImageCache, IImageCacheFilePathOpera
             return treatNullFileAsInvalid;
         }
 
-        FileInfo fileInfo = new(file);
-        return fileInfo.Length == 0;
+        return new FileInfo(file).Length == 0;
     }
 
-    private void RemoveInternal(IEnumerable<string> filePaths)
+    private static async ValueTask ConvertAndSaveFileToMonoChromeAsync(string sourceFile, string themeFile, ElementTheme theme)
+    {
+        if (string.Equals(sourceFile, themeFile, StringComparison.OrdinalIgnoreCase))
+        {
+            return;
+        }
+
+        using (FileStream sourceStream = File.OpenRead(sourceFile))
+        {
+            BitmapDecoder decoder = await BitmapDecoder.CreateAsync(sourceStream.AsRandomAccessStream());
+
+            // Always premultiplied to prevent some channels have a non-zero value when the alpha channel is zero
+            using (SoftwareBitmap sourceBitmap = await decoder.GetSoftwareBitmapAsync(BitmapPixelFormat.Rgba8, BitmapAlphaMode.Premultiplied))
+            {
+                using (BitmapBuffer sourceBuffer = sourceBitmap.LockBuffer(BitmapBufferAccessMode.ReadWrite))
+                {
+                    using (IMemoryBufferReference reference = sourceBuffer.CreateReference())
+                    {
+                        IMemoryBufferByteAccess byteAccess = reference.As<IMemoryBufferByteAccess>();
+                        byte value = theme is ElementTheme.Light ? (byte)0x00 : (byte)0xFF;
+                        ConvertToMonoChrome(byteAccess, value);
+                    }
+                }
+
+                using (FileStream themeStream = File.Create(themeFile))
+                {
+                    BitmapEncoder encoder = await BitmapEncoder.CreateAsync(BitmapEncoder.PngEncoderId, themeStream.AsRandomAccessStream());
+                    encoder.SetSoftwareBitmap(sourceBitmap);
+                    await encoder.FlushAsync();
+                }
+            }
+        }
+
+        static void ConvertToMonoChrome(IMemoryBufferByteAccess byteAccess, byte background)
+        {
+            byteAccess.GetBuffer(out Span<Rgba32> span);
+            foreach (ref Rgba32 pixel in span)
+            {
+                pixel.A = (byte)pixel.Luminance255;
+                pixel.R = pixel.G = pixel.B = background;
+            }
+        }
+    }
+
+    private void RemoveCore(IEnumerable<string> filePaths)
     {
         foreach (string filePath in filePaths)
         {
             try
             {
                 File.Delete(filePath);
+                logger.LogInformation("Remove cached image succeed:{File}", filePath);
             }
             catch (Exception ex)
             {
-                logger.LogWarning(ex, "Remove Cache Image Failed:{File}", filePath);
+                logger.LogWarning(ex, "Remove cached image failed:{File}", filePath);
             }
         }
     }
@@ -155,55 +254,93 @@ internal sealed partial class ImageCache : IImageCache, IImageCacheFilePathOpera
     [SuppressMessage("", "SH003")]
     private async Task DownloadFileAsync(Uri uri, string baseFile)
     {
-        logger.LogInformation("Begin downloading for {Uri}", uri);
-
-        int retryCount = 0;
-        HttpClient httpClient = httpClientFactory.CreateClient(nameof(ImageCache));
-        while (retryCount < 3)
+        using (HttpClient httpClient = httpClientFactory.CreateClient(nameof(ImageCache)))
         {
-            using (HttpResponseMessage message = await httpClient.GetAsync(uri, HttpCompletionOption.ResponseHeadersRead).ConfigureAwait(false))
+            int retryCount = 0;
+
+            HttpRequestMessageBuilder requestMessageBuilder = httpRequestMessageBuilderFactory
+                .Create()
+                .SetRequestUri(uri)
+                .SetStaticResourceControlHeadersIf(uri.Host.Contains("api.snapgenshin.com", StringComparison.OrdinalIgnoreCase)) // These headers are only available for our own api
+                .Get();
+
+            while (retryCount < 3)
             {
-                if (message.IsSuccessStatusCode)
+                requestMessageBuilder.Resurrect();
+
+                using (HttpRequestMessage requestMessage = requestMessageBuilder.HttpRequestMessage)
                 {
-                    using (Stream httpStream = await message.Content.ReadAsStreamAsync().ConfigureAwait(false))
+                    using (HttpResponseMessage responseMessage = await httpClient.SendAsync(requestMessage, HttpCompletionOption.ResponseHeadersRead).ConfigureAwait(false))
                     {
-                        using (FileStream fileStream = File.Create(baseFile))
+                        // Redirect detection
+                        if (responseMessage.RequestMessage is { RequestUri: { } target } && target != uri)
                         {
-                            await httpStream.CopyToAsync(fileStream).ConfigureAwait(false);
-                            return;
+                            logger.LogDebug("The Request '{Source}' has been redirected to '{Target}'", uri, target);
+                        }
+
+                        if (responseMessage.IsSuccessStatusCode)
+                        {
+                            if (responseMessage.Content.Headers.ContentType?.MediaType is "application/json")
+                            {
+                                DebugTrackFailedUri(uri);
+                                string raw = await responseMessage.Content.ReadAsStringAsync().ConfigureAwait(false);
+                                logger.LogColorizedCritical("Failed to download '{Uri}' with unexpected body '{Raw}'", (uri, ConsoleColor.Red), (raw, ConsoleColor.DarkYellow));
+                                return;
+                            }
+
+                            using (Stream httpStream = await responseMessage.Content.ReadAsStreamAsync().ConfigureAwait(false))
+                            {
+                                using (FileStream fileStream = File.Create(baseFile))
+                                {
+                                    await httpStream.CopyToAsync(fileStream).ConfigureAwait(false);
+                                    return;
+                                }
+                            }
+                        }
+
+                        switch (responseMessage.StatusCode)
+                        {
+                            case HttpStatusCode.TooManyRequests:
+                                {
+                                    retryCount++;
+                                    TimeSpan delay = responseMessage.Headers.RetryAfter?.Delta ?? DelayFromRetryCount[retryCount];
+                                    logger.LogInformation("Retry download '{Uri}' after {Delay}.", uri, delay);
+                                    await Task.Delay(delay).ConfigureAwait(false);
+                                    break;
+                                }
+
+                            default:
+                                DebugTrackFailedUri(uri);
+                                logger.LogColorizedCritical("Failed to download '{Uri}' with status code '{StatusCode}'", (uri, ConsoleColor.Red), (responseMessage.StatusCode, ConsoleColor.DarkYellow));
+                                return;
                         }
                     }
                 }
-
-                switch (message.StatusCode)
-                {
-                    case HttpStatusCode.TooManyRequests:
-                        {
-                            retryCount++;
-                            TimeSpan delay = message.Headers.RetryAfter?.Delta ?? retryCountToDelay[retryCount];
-                            logger.LogInformation("Retry {Uri} after {Delay}.", uri, delay);
-                            await Task.Delay(delay).ConfigureAwait(false);
-                            break;
-                        }
-
-                    default:
-                        return;
-                }
             }
         }
     }
 
-    private string GetCacheFolder()
+    [Conditional("DEBUG")]
+    private void DebugTrackFailedUri(Uri uri)
     {
-        if (cacheFolder is not null)
+        HashSet<string>? set = memoryCache.GetOrCreate(CacheFailedDownloadTasksName, entry => new HashSet<string>());
+        set?.Add(uri.ToString());
+    }
+
+    private readonly struct ElementThemeValueFile
+    {
+        public readonly ValueFile File;
+        public readonly ElementTheme Theme;
+
+        public ElementThemeValueFile(ValueFile file, ElementTheme theme)
         {
-            return cacheFolder;
+            File = file;
+            Theme = theme;
         }
 
-        baseFolder ??= serviceProvider.GetRequiredService<RuntimeOptions>().LocalCache;
-        DirectoryInfo info = Directory.CreateDirectory(Path.Combine(baseFolder, CacheFolderName));
-        cacheFolder = info.FullName;
-
-        return cacheFolder;
+        public override int GetHashCode()
+        {
+            return HashCode.Combine(File, Theme);
+        }
     }
 }

src/Snap.Hutao/Snap.Hutao/Core/Collection/TwoEnumerbleEnumerator.cs

@@ -0,0 +1,32 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Snap.Hutao.Core.Collection;
+
+internal sealed class TwoEnumerbleEnumerator<TFirst, TSecond> : IDisposable
+{
+    private readonly IEnumerator<TFirst> firstEnumerator;
+    private readonly IEnumerator<TSecond> secondEnumerator;
+
+    public TwoEnumerbleEnumerator(IEnumerable<TFirst> firstEnumerable, IEnumerable<TSecond> secondEnumerable)
+    {
+        firstEnumerator = firstEnumerable.GetEnumerator();
+        secondEnumerator = secondEnumerable.GetEnumerator();
+    }
+
+    public (TFirst First, TSecond Second) Current { get => (firstEnumerator.Current, secondEnumerator.Current); }
+
+    public bool MoveNext(ref bool moveFirst, ref bool moveSecond)
+    {
+        moveFirst = moveFirst && firstEnumerator.MoveNext();
+        moveSecond = moveSecond && secondEnumerator.MoveNext();
+
+        return moveFirst || moveSecond;
+    }
+
+    public void Dispose()
+    {
+        firstEnumerator.Dispose();
+        secondEnumerator.Dispose();
+    }
+}

src/Snap.Hutao/Snap.Hutao/Core/CommandLineBuilder.cs

@@ -18,11 +18,11 @@ internal sealed class CommandLineBuilder
     /// <summary>
     /// 当符合条件时添加参数
     /// </summary>
-    /// <param name="name">参数名称</param>
     /// <param name="condition">条件</param>
+    /// <param name="name">参数名称</param>
     /// <param name="value">值</param>
     /// <returns>命令行建造器</returns>
-    public CommandLineBuilder AppendIf(string name, bool condition, object? value = null)
+    public CommandLineBuilder AppendIf(bool condition, string name, object? value = null)
     {
         return condition ? Append(name, value) : this;
     }
@@ -35,7 +35,7 @@ internal sealed class CommandLineBuilder
     /// <returns>命令行建造器</returns>
     public CommandLineBuilder AppendIfNotNull(string name, object? value = null)
     {
-        return AppendIf(name, value is not null, value);
+        return AppendIf(value is not null, name, value);
     }
 
     /// <summary>

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

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

src/Snap.Hutao/Snap.Hutao/Core/DataTransfer/ClipboardProvider.cs

@@ -4,7 +4,7 @@
 using Windows.ApplicationModel.DataTransfer;
 using Windows.Storage.Streams;
 
-namespace Snap.Hutao.Core.IO.DataTransfer;
+namespace Snap.Hutao.Core.DataTransfer;
 
 [ConstructorGenerated]
 [Injection(InjectAs.Transient, typeof(IClipboardProvider))]
@@ -13,7 +13,6 @@ internal sealed partial class ClipboardProvider : IClipboardProvider
     private readonly JsonSerializerOptions options;
     private readonly ITaskContext taskContext;
 
-    /// <inheritdoc/>
     public async ValueTask<T?> DeserializeFromJsonAsync<T>()
         where T : class
     {
@@ -31,7 +30,6 @@ internal sealed partial class ClipboardProvider : IClipboardProvider
         return JsonSerializer.Deserialize<T>(json, options);
     }
 
-    /// <inheritdoc/>
     public bool SetText(string text)
     {
         try
@@ -48,7 +46,23 @@ internal sealed partial class ClipboardProvider : IClipboardProvider
         }
     }
 
-    /// <inheritdoc/>
+    public async ValueTask<bool> SetTextAsync(string text)
+    {
+        try
+        {
+            await taskContext.SwitchToMainThreadAsync();
+            DataPackage content = new() { RequestedOperation = DataPackageOperation.Copy };
+            content.SetText(text);
+            Clipboard.SetContent(content);
+            Clipboard.Flush();
+            return true;
+        }
+        catch
+        {
+            return false;
+        }
+    }
+
     public bool SetBitmap(IRandomAccessStream stream)
     {
         try
@@ -65,4 +79,22 @@ internal sealed partial class ClipboardProvider : IClipboardProvider
             return false;
         }
     }
+
+    public async ValueTask<bool> SetBitmapAsync(IRandomAccessStream stream)
+    {
+        try
+        {
+            await taskContext.SwitchToMainThreadAsync();
+            RandomAccessStreamReference reference = RandomAccessStreamReference.CreateFromStream(stream);
+            DataPackage content = new() { RequestedOperation = DataPackageOperation.Copy };
+            content.SetBitmap(reference);
+            Clipboard.SetContent(content);
+            Clipboard.Flush();
+            return true;
+        }
+        catch
+        {
+            return false;
+        }
+    }
 }

src/Snap.Hutao/Snap.Hutao/Core/DataTransfer/IClipboardProvider.cs

@@ -0,0 +1,20 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Windows.Storage.Streams;
+
+namespace Snap.Hutao.Core.DataTransfer;
+
+internal interface IClipboardProvider
+{
+    ValueTask<T?> DeserializeFromJsonAsync<T>()
+        where T : class;
+
+    bool SetBitmap(IRandomAccessStream stream);
+
+    ValueTask<bool> SetBitmapAsync(IRandomAccessStream stream);
+
+    bool SetText(string text);
+
+    ValueTask<bool> SetTextAsync(string text);
+}

src/Snap.Hutao/Snap.Hutao/Core/Database/Abstraction/IReorderable.cs

@@ -1,7 +1,7 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
-namespace Snap.Hutao.Core.Database;
+namespace Snap.Hutao.Core.Database.Abstraction;
 
 internal interface IReorderable
 {

src/Snap.Hutao/Snap.Hutao/Core/Database/Abstraction/ISelectable.cs

@@ -0,0 +1,11 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.Model.Entity.Abstraction;
+
+namespace Snap.Hutao.Core.Database.Abstraction;
+
+internal interface ISelectable : IAppDbEntity
+{
+    bool IsSelected { get; set; }
+}

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

@@ -0,0 +1,142 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.EntityFrameworkCore;
+using Snap.Hutao.Core.Database.Abstraction;
+using Snap.Hutao.Model;
+using Snap.Hutao.Model.Entity.Database;
+using Snap.Hutao.UI.Xaml.Data;
+
+namespace Snap.Hutao.Core.Database;
+
+// The scope of the view follows the scope of the service provider.
+internal sealed class AdvancedDbCollectionView<TEntity> : AdvancedCollectionView<TEntity>, IAdvancedDbCollectionView<TEntity>
+    where TEntity : class, IAdvancedCollectionViewItem, ISelectable
+{
+    private readonly IServiceProvider serviceProvider;
+
+    private bool savingToDatabase = true;
+
+    public AdvancedDbCollectionView(IList<TEntity> source, IServiceProvider serviceProvider)
+        : base(source, true)
+    {
+        this.serviceProvider = serviceProvider;
+    }
+
+    public IDisposable SuppressChangeCurrentItem()
+    {
+        return new CurrentItemSuppression(this);
+    }
+
+    protected override void OnCurrentChangedOverride()
+    {
+        if (serviceProvider is null || !savingToDatabase)
+        {
+            return;
+        }
+
+        TEntity? currentItem = CurrentItem;
+
+        foreach (TEntity item in Source)
+        {
+            item.IsSelected = ReferenceEquals(item, currentItem);
+        }
+
+        using (IServiceScope scope = serviceProvider.CreateScope())
+        {
+            AppDbContext dbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
+            dbContext.Set<TEntity>().ExecuteUpdate(update => update.SetProperty(entity => entity.IsSelected, false));
+
+            if (currentItem is not null)
+            {
+                dbContext.Set<TEntity>().UpdateAndSave(currentItem);
+            }
+        }
+    }
+
+    private sealed class CurrentItemSuppression : IDisposable
+    {
+        private readonly AdvancedDbCollectionView<TEntity> view;
+        private readonly TEntity? currentItem;
+
+        public CurrentItemSuppression(AdvancedDbCollectionView<TEntity> view)
+        {
+            this.view = view;
+            currentItem = view.CurrentItem;
+            view.savingToDatabase = false;
+        }
+
+        public void Dispose()
+        {
+            view.MoveCurrentTo(currentItem);
+            view.savingToDatabase = true;
+        }
+    }
+}
+
+// The scope of the view follows the scope of the service provider.
+[SuppressMessage("", "SA1402")]
+internal sealed class AdvancedDbCollectionView<TEntityAccess, TEntity> : AdvancedCollectionView<TEntityAccess>, IAdvancedDbCollectionView<TEntityAccess>
+    where TEntityAccess : class, IEntityAccess<TEntity>, IAdvancedCollectionViewItem
+    where TEntity : class, ISelectable
+{
+    private readonly IServiceProvider serviceProvider;
+
+    private bool savingToDatabase = true;
+
+    public AdvancedDbCollectionView(IList<TEntityAccess> source, IServiceProvider serviceProvider)
+        : base(source, true)
+    {
+        this.serviceProvider = serviceProvider;
+    }
+
+    public IDisposable SuppressChangeCurrentItem()
+    {
+        return new CurrentItemSuppression(this);
+    }
+
+    protected override void OnCurrentChangedOverride()
+    {
+        if (serviceProvider is null || !savingToDatabase)
+        {
+            return;
+        }
+
+        TEntityAccess? currentItem = CurrentItem;
+
+        foreach (TEntityAccess item in Source)
+        {
+            item.Entity.IsSelected = ReferenceEquals(item, currentItem);
+        }
+
+        using (IServiceScope scope = serviceProvider.CreateScope())
+        {
+            AppDbContext dbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
+            dbContext.Set<TEntity>().ExecuteUpdate(update => update.SetProperty(entity => entity.IsSelected, false));
+
+            if (currentItem is not null)
+            {
+                dbContext.Set<TEntity>().UpdateAndSave(currentItem.Entity);
+            }
+        }
+    }
+
+    private sealed class CurrentItemSuppression : IDisposable
+    {
+        private readonly AdvancedDbCollectionView<TEntityAccess, TEntity> view;
+        private readonly TEntityAccess? currentItem;
+
+        public CurrentItemSuppression(AdvancedDbCollectionView<TEntityAccess, TEntity> view)
+        {
+            this.view = view;
+            currentItem = view.CurrentItem;
+            view.savingToDatabase = false;
+        }
+
+        public void Dispose()
+        {
+            view.MoveCurrentTo(currentItem);
+            view.savingToDatabase = true;
+        }
+    }
+}

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

@@ -13,13 +13,6 @@ namespace Snap.Hutao.Core.Database;
 [HighQuality]
 internal static class DbSetExtension
 {
-    /// <summary>
-    /// 添加并保存
-    /// </summary>
-    /// <typeparam name="TEntity">实体类型</typeparam>
-    /// <param name="dbSet">数据库集</param>
-    /// <param name="entity">实体</param>
-    /// <returns>影响条数</returns>
     public static int AddAndSave<TEntity>(this DbSet<TEntity> dbSet, TEntity entity)
         where TEntity : class
     {
@@ -27,27 +20,6 @@ internal static class DbSetExtension
         return dbSet.SaveChangesAndClearChangeTracker();
     }
 
-    /// <summary>
-    /// 异步添加并保存
-    /// </summary>
-    /// <typeparam name="TEntity">实体类型</typeparam>
-    /// <param name="dbSet">数据库集</param>
-    /// <param name="entity">实体</param>
-    /// <returns>影响条数</returns>
-    public static ValueTask<int> AddAndSaveAsync<TEntity>(this DbSet<TEntity> dbSet, TEntity entity)
-        where TEntity : class
-    {
-        dbSet.Add(entity);
-        return dbSet.SaveChangesAndClearChangeTrackerAsync();
-    }
-
-    /// <summary>
-    /// 添加列表并保存
-    /// </summary>
-    /// <typeparam name="TEntity">实体类型</typeparam>
-    /// <param name="dbSet">数据库集</param>
-    /// <param name="entities">实体</param>
-    /// <returns>影响条数</returns>
     public static int AddRangeAndSave<TEntity>(this DbSet<TEntity> dbSet, IEnumerable<TEntity> entities)
         where TEntity : class
     {
@@ -55,27 +27,6 @@ internal static class DbSetExtension
         return dbSet.SaveChangesAndClearChangeTracker();
     }
 
-    /// <summary>
-    /// 异步添加列表并保存
-    /// </summary>
-    /// <typeparam name="TEntity">实体类型</typeparam>
-    /// <param name="dbSet">数据库集</param>
-    /// <param name="entities">实体</param>
-    /// <returns>影响条数</returns>
-    public static ValueTask<int> AddRangeAndSaveAsync<TEntity>(this DbSet<TEntity> dbSet, IEnumerable<TEntity> entities)
-        where TEntity : class
-    {
-        dbSet.AddRange(entities);
-        return dbSet.SaveChangesAndClearChangeTrackerAsync();
-    }
-
-    /// <summary>
-    /// 移除并保存
-    /// </summary>
-    /// <typeparam name="TEntity">实体类型</typeparam>
-    /// <param name="dbSet">数据库集</param>
-    /// <param name="entity">实体</param>
-    /// <returns>影响条数</returns>
     public static int RemoveAndSave<TEntity>(this DbSet<TEntity> dbSet, TEntity entity)
         where TEntity : class
     {
@@ -83,27 +34,6 @@ internal static class DbSetExtension
         return dbSet.SaveChangesAndClearChangeTracker();
     }
 
-    /// <summary>
-    /// 异步移除并保存
-    /// </summary>
-    /// <typeparam name="TEntity">实体类型</typeparam>
-    /// <param name="dbSet">数据库集</param>
-    /// <param name="entity">实体</param>
-    /// <returns>影响条数</returns>
-    public static ValueTask<int> RemoveAndSaveAsync<TEntity>(this DbSet<TEntity> dbSet, TEntity entity)
-        where TEntity : class
-    {
-        dbSet.Remove(entity);
-        return dbSet.SaveChangesAndClearChangeTrackerAsync();
-    }
-
-    /// <summary>
-    /// 更新并保存
-    /// </summary>
-    /// <typeparam name="TEntity">实体类型</typeparam>
-    /// <param name="dbSet">数据库集</param>
-    /// <param name="entity">实体</param>
-    /// <returns>影响条数</returns>
     public static int UpdateAndSave<TEntity>(this DbSet<TEntity> dbSet, TEntity entity)
         where TEntity : class
     {
@@ -111,20 +41,6 @@ internal static class DbSetExtension
         return dbSet.SaveChangesAndClearChangeTracker();
     }
 
-    /// <summary>
-    /// 异步更新并保存
-    /// </summary>
-    /// <typeparam name="TEntity">实体类型</typeparam>
-    /// <param name="dbSet">数据库集</param>
-    /// <param name="entity">实体</param>
-    /// <returns>影响条数</returns>
-    public static ValueTask<int> UpdateAndSaveAsync<TEntity>(this DbSet<TEntity> dbSet, TEntity entity)
-        where TEntity : class
-    {
-        dbSet.Update(entity);
-        return dbSet.SaveChangesAndClearChangeTrackerAsync();
-    }
-
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     private static int SaveChangesAndClearChangeTracker<TEntity>(this DbSet<TEntity> dbSet)
         where TEntity : class
@@ -135,16 +51,6 @@ internal static class DbSetExtension
         return count;
     }
 
-    [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    private static async ValueTask<int> SaveChangesAndClearChangeTrackerAsync<TEntity>(this DbSet<TEntity> dbSet)
-        where TEntity : class
-    {
-        DbContext dbContext = dbSet.Context();
-        int count = await dbContext.SaveChangesAsync().ConfigureAwait(false);
-        dbContext.ChangeTracker.Clear();
-        return count;
-    }
-
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     private static DbContext Context<TEntity>(this DbSet<TEntity> dbSet)
         where TEntity : class

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

@@ -0,0 +1,12 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.UI.Xaml.Data;
+
+namespace Snap.Hutao.Core.Database;
+
+internal interface IAdvancedDbCollectionView<TEntity> : IAdvancedCollectionView<TEntity>
+    where TEntity : class
+{
+    IDisposable SuppressChangeCurrentItem();
+}

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

@@ -1,23 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-namespace Snap.Hutao.Core.Database;
-
-/// <summary>
-/// 可选择的项
-/// 若要使用 <see cref="ScopedDbCurrent{TEntity, TMessage}"/>
-/// 必须实现该接口
-/// </summary>
-[HighQuality]
-internal interface ISelectable
-{
-    /// <summary>
-    /// 数据库内部Id
-    /// </summary>
-    Guid InnerId { get; }
-
-    /// <summary>
-    /// 获取或设置当前项的选中状态
-    /// </summary>
-    bool IsSelected { get; set; }
-}

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

@@ -2,22 +2,24 @@
 // Licensed under the MIT license.
 
 using Microsoft.EntityFrameworkCore;
+using Snap.Hutao.Core.Database.Abstraction;
+using Snap.Hutao.Model;
+using Snap.Hutao.Model.Entity.Database;
 using System.Collections.ObjectModel;
 using System.Collections.Specialized;
 using System.Runtime.InteropServices;
 
 namespace Snap.Hutao.Core.Database;
 
-internal sealed class ObservableReorderableDbCollection<T> : ObservableCollection<T>
-    where T : class, IReorderable
+internal sealed class ObservableReorderableDbCollection<TEntity> : ObservableCollection<TEntity>
+    where TEntity : class, IReorderable
 {
-    private readonly DbContext dbContext;
-    private bool previousChangeIsRemoved;
+    private readonly IServiceProvider serviceProvider;
 
-    public ObservableReorderableDbCollection(List<T> items, DbContext dbContext)
-        : base(AdjustIndex(items))
+    public ObservableReorderableDbCollection(List<TEntity> items, IServiceProvider serviceProvider)
+        : base(AdjustIndex(items.SortBy(x => x.Index)))
     {
-        this.dbContext = dbContext;
+        this.serviceProvider = serviceProvider;
     }
 
     protected override void OnCollectionChanged(NotifyCollectionChangedEventArgs e)
@@ -27,26 +29,18 @@ internal sealed class ObservableReorderableDbCollection<T> : ObservableCollectio
         switch (e.Action)
         {
             case NotifyCollectionChangedAction.Remove:
-                previousChangeIsRemoved = true;
-                break;
             case NotifyCollectionChangedAction.Add:
-                if (!previousChangeIsRemoved)
-                {
-                    return;
-                }
-
                 OnReorder();
-                previousChangeIsRemoved = false;
                 break;
         }
     }
 
-    private static List<T> AdjustIndex(List<T> list)
+    private static List<TEntity> AdjustIndex(List<TEntity> list)
     {
-        Span<T> span = CollectionsMarshal.AsSpan(list);
+        Span<TEntity> span = CollectionsMarshal.AsSpan(list);
         for (int i = 0; i < list.Count; i++)
         {
-            ref readonly T item = ref span[i];
+            ref readonly TEntity item = ref span[i];
             item.Index = i;
         }
 
@@ -55,12 +49,71 @@ internal sealed class ObservableReorderableDbCollection<T> : ObservableCollectio
 
     private void OnReorder()
     {
-        AdjustIndex((List<T>)Items);
+        AdjustIndex((List<TEntity>)Items);
 
-        DbSet<T> dbSet = dbContext.Set<T>();
-        foreach (ref readonly T item in CollectionsMarshal.AsSpan((List<T>)Items))
+        using (IServiceScope scope = serviceProvider.CreateScope())
         {
-            dbSet.UpdateAndSave(item);
+            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
+            DbSet<TEntity> dbSet = appDbContext.Set<TEntity>();
+            foreach (ref readonly TEntity item in CollectionsMarshal.AsSpan((List<TEntity>)Items))
+            {
+                dbSet.UpdateAndSave(item);
+            }
+        }
+    }
+}
+
+[SuppressMessage("", "SA1402")]
+internal sealed class ObservableReorderableDbCollection<TEntityAccess, TEntity> : ObservableCollection<TEntityAccess>
+    where TEntityAccess : class, IEntityAccess<TEntity>
+    where TEntity : class, IReorderable
+{
+    private readonly IServiceProvider serviceProvider;
+
+    public ObservableReorderableDbCollection(List<TEntityAccess> items, IServiceProvider serviceProvider)
+        : base(AdjustIndex(items.SortBy(x => x.Entity.Index)))
+    {
+        this.serviceProvider = serviceProvider;
+    }
+
+    protected override void OnCollectionChanged(NotifyCollectionChangedEventArgs e)
+    {
+        base.OnCollectionChanged(e);
+
+        switch (e.Action)
+        {
+            case NotifyCollectionChangedAction.Remove:
+            case NotifyCollectionChangedAction.Add:
+                OnReorder();
+                break;
+        }
+    }
+
+    private static List<TEntityAccess> AdjustIndex(List<TEntityAccess> list)
+    {
+        Span<TEntityAccess> span = CollectionsMarshal.AsSpan(list);
+        for (int i = 0; i < list.Count; i++)
+        {
+            ref readonly TEntityAccess item = ref span[i];
+            item.Entity.Index = i;
+        }
+
+        return list;
+    }
+
+    private void OnReorder()
+    {
+        AdjustIndex((List<TEntityAccess>)Items);
+
+        using (IServiceScope scope = serviceProvider.CreateScope())
+        {
+            AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
+
+            DbSet<TEntity> dbSet = appDbContext.Set<TEntity>();
+            foreach (ref readonly TEntityAccess item in CollectionsMarshal.AsSpan((List<TEntityAccess>)Items))
+            {
+                dbSet.UpdateAndSave(item.Entity);
+            }
         }
     }
 }

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

@@ -0,0 +1,30 @@
+// Copyright (c) DGP Studio. All rights reserved.
+// Licensed under the MIT license.
+
+using Snap.Hutao.Core.Database.Abstraction;
+using Snap.Hutao.Model;
+using System.Runtime.CompilerServices;
+
+namespace Snap.Hutao.Core.Database;
+
+internal static class ObservableReorderableDbCollectionExtension
+{
+    [MethodImpl(MethodImplOptions.AggressiveInlining)]
+    public static ObservableReorderableDbCollection<TEntity> ToObservableReorderableDbCollection<TEntity>(this IEnumerable<TEntity> source, IServiceProvider serviceProvider)
+        where TEntity : class, IReorderable
+    {
+        return source is List<TEntity> list
+            ? new ObservableReorderableDbCollection<TEntity>(list, serviceProvider)
+            : new ObservableReorderableDbCollection<TEntity>([.. source], serviceProvider);
+    }
+
+    [MethodImpl(MethodImplOptions.AggressiveInlining)]
+    public static ObservableReorderableDbCollection<TEntityOnly, TEntity> ToObservableReorderableDbCollection<TEntityOnly, TEntity>(this IEnumerable<TEntityOnly> source, IServiceProvider serviceProvider)
+        where TEntityOnly : class, IEntityAccess<TEntity>
+        where TEntity : class, IReorderable
+    {
+        return source is List<TEntityOnly> list
+            ? new ObservableReorderableDbCollection<TEntityOnly, TEntity>(list, serviceProvider)
+            : new ObservableReorderableDbCollection<TEntityOnly, TEntity>([.. source], serviceProvider);
+    }
+}

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

@@ -1,42 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using Microsoft.EntityFrameworkCore;
-using System.Linq.Expressions;
-using System.Runtime.CompilerServices;
-
-namespace Snap.Hutao.Core.Database;
-
-/// <summary>
-/// 可查询扩展
-/// </summary>
-[HighQuality]
-internal static class QueryableExtension
-{
-    /// <summary>
-    /// source.Where(predicate).ExecuteDelete()
-    /// </summary>
-    /// <typeparam name="TSource">源类型</typeparam>
-    /// <param name="source">源</param>
-    /// <param name="predicate">条件</param>
-    /// <returns>SQL返回个数</returns>
-    [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public static int ExecuteDeleteWhere<TSource>(this IQueryable<TSource> source, Expression<Func<TSource, bool>> predicate)
-    {
-        return source.Where(predicate).ExecuteDelete();
-    }
-
-    /// <summary>
-    /// source.Where(predicate).ExecuteDeleteAsync(token)
-    /// </summary>
-    /// <typeparam name="TSource">源类型</typeparam>
-    /// <param name="source">源</param>
-    /// <param name="predicate">条件</param>
-    /// <param name="token">取消令牌</param>
-    /// <returns>SQL返回个数</returns>
-    [MethodImpl(MethodImplOptions.AggressiveInlining)]
-    public static ValueTask<int> ExecuteDeleteWhereAsync<TSource>(this IQueryable<TSource> source, Expression<Func<TSource, bool>> predicate, CancellationToken token = default)
-    {
-        return source.Where(predicate).ExecuteDeleteAsync(token).AsValueTask();
-    }
-}

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

@@ -1,133 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-using CommunityToolkit.Mvvm.Messaging;
-using Microsoft.EntityFrameworkCore;
-using Snap.Hutao.Model;
-using Snap.Hutao.Model.Entity.Database;
-
-namespace Snap.Hutao.Core.Database;
-
-/// <summary>
-/// 范围化的数据库当前项
-/// 简化对数据库中选中项的管理
-/// </summary>
-/// <typeparam name="TEntity">实体的类型</typeparam>
-/// <typeparam name="TMessage">消息的类型</typeparam>
-[ConstructorGenerated]
-internal sealed partial class ScopedDbCurrent<TEntity, TMessage>
-    where TEntity : class, ISelectable
-    where TMessage : Message.ValueChangedMessage<TEntity>, new()
-{
-    private readonly IServiceProvider serviceProvider;
-    private readonly IMessenger messenger;
-
-    private TEntity? current;
-
-    /// <summary>
-    /// 当前选中的项
-    /// </summary>
-    public TEntity? Current
-    {
-        get => current;
-        set
-        {
-            // prevent useless sets
-            if (current == value)
-            {
-                return;
-            }
-
-            if (serviceProvider.IsDisposedSlow())
-            {
-                return;
-            }
-
-            using (IServiceScope scope = serviceProvider.CreateScope())
-            {
-                AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
-                DbSet<TEntity> dbSet = appDbContext.Set<TEntity>();
-
-                // only update when not processing a deletion
-                if (value is not null && current is not null)
-                {
-                    current.IsSelected = false;
-                    dbSet.UpdateAndSave(current);
-                }
-
-                TMessage message = new() { OldValue = current, NewValue = value };
-
-                current = value;
-
-                if (current is not null)
-                {
-                    current.IsSelected = true;
-                    dbSet.UpdateAndSave(current);
-                }
-
-                messenger.Send(message);
-            }
-        }
-    }
-}
-
-[ConstructorGenerated]
-internal sealed partial class ScopedDbCurrent<TEntityOnly, TEntity, TMessage>
-    where TEntityOnly : class, IEntityOnly<TEntity>
-    where TEntity : class, ISelectable
-    where TMessage : Message.ValueChangedMessage<TEntityOnly>, new()
-{
-    private readonly IServiceProvider serviceProvider;
-    private readonly IMessenger messenger;
-
-    private TEntityOnly? current;
-
-    /// <summary>
-    /// 当前选中的项
-    /// </summary>
-    public TEntityOnly? Current
-    {
-        get => current;
-        set
-        {
-            // prevent useless sets
-            if (current == value)
-            {
-                return;
-            }
-
-            if (serviceProvider.IsDisposedSlow())
-            {
-                return;
-            }
-
-            using (IServiceScope scope = serviceProvider.CreateScope())
-            {
-                AppDbContext appDbContext = scope.ServiceProvider.GetRequiredService<AppDbContext>();
-                DbSet<TEntity> dbSet = appDbContext.Set<TEntity>();
-
-                // only update when not processing a deletion
-                if (value is not null)
-                {
-                    if (current is not null)
-                    {
-                        current.Entity.IsSelected = false;
-                        dbSet.UpdateAndSave(current.Entity);
-                    }
-                }
-
-                TMessage message = new() { OldValue = current, NewValue = value };
-
-                current = value;
-
-                if (current is not null)
-                {
-                    current.Entity.IsSelected = true;
-                    dbSet.UpdateAndSave(current.Entity);
-                }
-
-                messenger.Send(message);
-            }
-        }
-    }
-}

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

@@ -1,6 +1,7 @@
 // Copyright (c) DGP Studio. All rights reserved.
 // Licensed under the MIT license.
 
+using Snap.Hutao.Core.Database.Abstraction;
 using System.Runtime.CompilerServices;
 
 namespace Snap.Hutao.Core.Database;
@@ -11,13 +12,6 @@ namespace Snap.Hutao.Core.Database;
 [HighQuality]
 internal static class SelectableExtension
 {
-    /// <summary>
-    /// 获取选中的值或默认值
-    /// </summary>
-    /// <typeparam name="TSource">源类型</typeparam>
-    /// <param name="source">源</param>
-    /// <returns>选中的值或默认值</returns>
-    /// <exception cref="InvalidOperationException">存在多个选中的值</exception>
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     public static TSource? SelectedOrDefault<TSource>(this IEnumerable<TSource> source)
         where TSource : ISelectable

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

@@ -1,11 +0,0 @@
-// Copyright (c) DGP Studio. All rights reserved.
-// Licensed under the MIT license.
-
-namespace Snap.Hutao.Core.DependencyInjection.Abstraction;
-
-/// <summary>
-/// 可转换类型服务
-/// </summary>
-internal interface ICastService
-{
-}