Merge pull request #8 from jayfunc/dev

add multiple online lyrics providers; add desktop mode; improve blur/shadow/scrolling effect performance; fix bugs

.gitignore

@@ -404,4 +404,5 @@ FodyWeavers.xsd
 *.msp
 
 # JetBrains Rider
-*.sln.iml
+*.sln.iml
+/BetterLyrics.WinUI3/BetterLyrics.WinUI3 (Package)/BetterLyrics.WinUI3 (Package)_TemporaryKey.pfx

BetterLyrics.WinUI3/BetterLyrics.WinUI3 (Package)/BetterLyrics.WinUI3 (Package).wapproj

@@ -40,15 +40,16 @@
     <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
     <AssetTargetFallback>net8.0-windows$(TargetPlatformVersion);$(AssetTargetFallback)</AssetTargetFallback>
     <DefaultLanguage>zh-CN</DefaultLanguage>
-    <AppxPackageSigningEnabled>false</AppxPackageSigningEnabled>
+    <AppxPackageSigningEnabled>True</AppxPackageSigningEnabled>
     <EntryPointProjectUniqueName>..\BetterLyrics.WinUI3\BetterLyrics.WinUI3.csproj</EntryPointProjectUniqueName>
     <GenerateAppInstallerFile>False</GenerateAppInstallerFile>
     <AppxPackageSigningTimestampDigestAlgorithm>SHA256</AppxPackageSigningTimestampDigestAlgorithm>
-    <AppxAutoIncrementPackageRevision>True</AppxAutoIncrementPackageRevision>
+    <AppxAutoIncrementPackageRevision>False</AppxAutoIncrementPackageRevision>
     <GenerateTestArtifacts>True</GenerateTestArtifacts>
-    <AppxBundlePlatforms>x86|x64|arm64</AppxBundlePlatforms>
+    <AppxBundlePlatforms>x86|x64</AppxBundlePlatforms>
     <GenerateTemporaryStoreCertificate>True</GenerateTemporaryStoreCertificate>
     <HoursBetweenUpdateChecks>0</HoursBetweenUpdateChecks>
+    <PackageCertificateKeyFile>BetterLyrics.WinUI3 %28Package%29_TemporaryKey.pfx</PackageCertificateKeyFile>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">
     <AppxBundle>Always</AppxBundle>
@@ -80,6 +81,7 @@
     </AppxManifest>
   </ItemGroup>
   <ItemGroup>
+    <None Include="BetterLyrics.WinUI3 %28Package%29_TemporaryKey.pfx" />
     <Content Include="Images\LargeTile.scale-100.png" />
     <Content Include="Images\LargeTile.scale-125.png" />
     <Content Include="Images\LargeTile.scale-150.png" />

BetterLyrics.WinUI3/BetterLyrics.WinUI3 (Package)/Package.appxmanifest

@@ -5,12 +5,13 @@
   xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
   xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
   xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
-  IgnorableNamespaces="uap rescap">
+  xmlns:uap18="http://schemas.microsoft.com/appx/manifest/uap/windows10/18"
+  IgnorableNamespaces="uap rescap uap18">
 
   <Identity
     Name="37412.BetterLyrics"
     Publisher="CN=E1428B0E-DC1D-4EA4-ACB1-4556569D5BA9"
-    Version="1.0.1.0" />
+    Version="1.0.6.0" />
 
   <mp:PhoneIdentity PhoneProductId="ca4a4830-fc19-40d9-b823-53e2bff3d816" PhonePublisherId="00000000-0000-0000-0000-000000000000"/>
 
@@ -26,7 +27,11 @@
   </Dependencies>
 
   <Resources>
-    <Resource Language="x-generate"/>
+	  <Resource Language="en-US"/>
+	  <Resource Language="zh-CN"/>
+	  <Resource Language="zh-TW"/>
+	  <Resource Language="ja-JP"/>
+	  <Resource Language="ko-KR"/>
   </Resources>
 
   <Applications>

BetterLyrics.WinUI3/BetterLyrics.WinUI3/App.xaml

@@ -5,7 +5,8 @@
     xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
     xmlns:converter="using:BetterLyrics.WinUI3.Converter"
     xmlns:converters="using:CommunityToolkit.WinUI.Converters"
-    xmlns:local="using:BetterLyrics.WinUI3">
+    xmlns:local="using:BetterLyrics.WinUI3"
+    xmlns:media="using:CommunityToolkit.WinUI.Media">
     <Application.Resources>
         <ResourceDictionary>
             <ResourceDictionary.MergedDictionaries>
@@ -16,12 +17,8 @@
 
             <!--  Theme  -->
             <ResourceDictionary.ThemeDictionaries>
-                <ResourceDictionary x:Key="Light">
-                    <Color x:Key="SemiTransparentSystemBaseHighColor">#80000000</Color>
-                </ResourceDictionary>
-                <ResourceDictionary x:Key="Dark">
-                    <Color x:Key="SemiTransparentSystemBaseHighColor">#80FFFFFF</Color>
-                </ResourceDictionary>
+                <ResourceDictionary x:Key="Light" />
+                <ResourceDictionary x:Key="Dark" />
             </ResourceDictionary.ThemeDictionaries>
 
             <!--  Brush  -->
@@ -44,10 +41,15 @@
             <ExponentialEase x:Key="EaseIn" EasingMode="EaseIn" />
 
             <!--  Converter  -->
-            <converter:ThemeTypeToElementThemeConverter x:Key="ThemeTypeToElementThemeConverter" />
+            <converter:EnumToIntConverter x:Key="EnumToIntConverter" />
             <converter:ColorToBrushConverter x:Key="ColorToBrushConverter" />
+            <converter:MatchedLocalFilesPathToVisibilityConverter x:Key="MatchedLocalFilesPathToVisibilityConverter" />
+            <converter:IntToCornerRadius x:Key="IntToCornerRadius" />
+            <converter:CornerRadiusToDoubleConverter x:Key="CornerRadiusToDoubleConverter" />
+            <converter:LyricsSearchProviderToDisplayNameConverter x:Key="LyricsSearchProviderToDisplayNameConverter" />
             <converters:BoolToVisibilityConverter x:Key="BoolToVisibilityConverter" />
             <converters:BoolNegationConverter x:Key="BoolNegationConverter" />
+            <converters:ColorToDisplayNameConverter x:Key="ColorToDisplayNameConverter" />
 
             <x:Double x:Key="SettingsCardSpacing">4</x:Double>
 
@@ -60,6 +62,34 @@
                     <Setter Property="Margin" Value="1,30,0,6" />
                 </Style.Setters>
             </Style>
+            <Style x:Key="TitleBarButtonStyle" TargetType="Button">
+                <Setter Property="VerticalAlignment" Value="Stretch" />
+                <Setter Property="CornerRadius" Value="4" />
+                <Setter Property="BorderThickness" Value="0" />
+                <Setter Property="Padding" Value="16,0" />
+                <Setter Property="Background" Value="Transparent" />
+            </Style>
+            <Style x:Key="GhostButtonStyle" TargetType="Button">
+                <Setter Property="VerticalAlignment" Value="Stretch" />
+                <Setter Property="CornerRadius" Value="4" />
+                <Setter Property="BorderThickness" Value="0" />
+                <Setter Property="Background" Value="Transparent" />
+            </Style>
+            <Style x:Key="TitleBarToggleButtonStyle" TargetType="ToggleButton">
+                <Setter Property="CornerRadius" Value="4" />
+                <Setter Property="VerticalAlignment" Value="Stretch" />
+                <Setter Property="BorderThickness" Value="0" />
+                <Setter Property="Padding" Value="16,0" />
+                <Setter Property="Background" Value="Transparent" />
+            </Style>
+            <Style x:Key="GhostToggleButtonStyle" TargetType="ToggleButton">
+                <Setter Property="CornerRadius" Value="4" />
+                <Setter Property="VerticalAlignment" Value="Stretch" />
+                <Setter Property="BorderThickness" Value="0" />
+                <Setter Property="Background" Value="Transparent" />
+            </Style>
+
+            <!--  Dimensions  -->
 
         </ResourceDictionary>
     </Application.Resources>

BetterLyrics.WinUI3/BetterLyrics.WinUI3/App.xaml.cs

@@ -1,63 +1,192 @@
-using BetterLyrics.WinUI3.Services.Database;
-using BetterLyrics.WinUI3.Services.Settings;
+// 2025/6/23 by Zhe Fang
+
+using System;
+using System.Text;
+using System.Threading.Tasks;
+using BetterInAppLyrics.WinUI3.ViewModels;
+using BetterLyrics.WinUI3.Helper;
+using BetterLyrics.WinUI3.Services;
+using BetterLyrics.WinUI3.Services.BetterLyrics.WinUI3.Services;
 using BetterLyrics.WinUI3.ViewModels;
-using BetterLyrics.WinUI3.Views;
 using CommunityToolkit.Mvvm.DependencyInjection;
 using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Logging;
 using Microsoft.UI.Dispatching;
 using Microsoft.UI.Xaml;
 using Microsoft.Windows.ApplicationModel.Resources;
-using System.Text;
+using Serilog;
 
 // To learn more about WinUI, the WinUI project structure,
 // and more about our project templates, see: http://aka.ms/winui-project-info.
 
-namespace BetterLyrics.WinUI3 {
+// To learn more about WinUI, the WinUI project structure,
+// and more about our project templates, see: http://aka.ms/winui-project-info.
+
+namespace BetterLyrics.WinUI3
+{
     /// <summary>
-    /// Provides application-specific behavior to supplement the default Application class.
+    /// Provides application-specific behavior to supplement the default Application class
     /// </summary>
-    public partial class App : Application {
-        public static App Current => (App)Application.Current;
-        public MainWindow? MainWindow { get; private set; }
-        public MainWindow? SettingsWindow { get; set; }
-
-        public static ResourceLoader ResourceLoader = new();
-
-        public static DispatcherQueue DispatcherQueue => DispatcherQueue.GetForCurrentThread();
+    public partial class App : Application
+    {
+        #region Fields
 
         /// <summary>
-        /// Initializes the singleton application object.  This is the first line of authored code
-        /// executed, and as such is the logical equivalent of main() or WinMain().
+        /// Defines the _logger
         /// </summary>
-        public App() {
+        private readonly ILogger<App> _logger;
+
+        #endregion
+
+        #region Constructors
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="App"/> class.
+        /// </summary>
+        public App()
+        {
             this.InitializeComponent();
+
+            DispatcherQueue = DispatcherQueue.GetForCurrentThread();
+            DispatcherQueueTimer = DispatcherQueue.CreateTimer();
+            ResourceLoader = new ResourceLoader();
+
+            Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);
+            AppInfo.EnsureDirectories();
+            ConfigureServices();
+
+            _logger = Ioc.Default.GetService<ILogger<App>>()!;
+
+            UnhandledException += App_UnhandledException;
+            AppDomain.CurrentDomain.UnhandledException += CurrentDomain_UnhandledException;
+            AppDomain.CurrentDomain.FirstChanceException += CurrentDomain_FirstChanceException;
+            TaskScheduler.UnobservedTaskException += TaskScheduler_UnobservedTaskException;
+        }
+
+        #endregion
+
+        #region Properties
+
+        /// <summary>
+        /// Gets the Current
+        /// </summary>
+        public static new App Current => (App)Application.Current;
+
+        /// <summary>
+        /// Gets the DispatcherQueue
+        /// </summary>
+        public static DispatcherQueue? DispatcherQueue { get; private set; }
+
+        /// <summary>
+        /// Gets the DispatcherQueueTimer
+        /// </summary>
+        public static DispatcherQueueTimer? DispatcherQueueTimer { get; private set; }
+
+        /// <summary>
+        /// Gets the ResourceLoader
+        /// </summary>
+        public static ResourceLoader? ResourceLoader { get; private set; }
+
+        #endregion
+
+        #region Methods
+
+        /// <summary>
+        /// Invoked when the application is launched
+        /// </summary>
+        /// <param name="args">Details about the launch request and process</param>
+        protected override void OnLaunched(LaunchActivatedEventArgs args)
+        {
+            WindowHelper.OpenLyricsWindow();
         }
 
         /// <summary>
-        /// Invoked when the application is launched.
+        /// The ConfigureServices
         /// </summary>
-        /// <param name="args">Details about the launch request and process.</param>
-        protected override void OnLaunched(Microsoft.UI.Xaml.LaunchActivatedEventArgs args) {
+        private static void ConfigureServices()
+        {
+            Log.Logger = new LoggerConfiguration()
+                .MinimumLevel.Debug()
+                .WriteTo.File(AppInfo.LogFilePattern, rollingInterval: RollingInterval.Day)
+                .CreateLogger();
 
             // Register services
             Ioc.Default.ConfigureServices(
                 new ServiceCollection()
-                .AddSingleton(DispatcherQueue.GetForCurrentThread())
-                // Services
-                .AddSingleton<SettingsService>()
-                .AddSingleton<DatabaseService>()
-                // ViewModels
-                .AddSingleton<MainViewModel>()
-                .AddSingleton<SettingsViewModel>()
-                .BuildServiceProvider());
-
-            Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);
-
-            // Activate the window
-            MainWindow = new MainWindow();
-            MainWindow!.Navigate(typeof(MainPage));
-            MainWindow.Activate();
+                    .AddLogging(loggingBuilder =>
+                    {
+                        loggingBuilder.ClearProviders();
+                        loggingBuilder.AddSerilog();
+                    })
+                    // Services
+                    .AddSingleton<ISettingsService, SettingsService>()
+                    .AddSingleton<IPlaybackService, PlaybackService>()
+                    .AddSingleton<IMusicSearchService, MusicSearchService>()
+                    .AddSingleton<ILibWatcherService, LibWatcherService>()
+                    // ViewModels
+                    .AddTransient<HostWindowViewModel>()
+                    .AddSingleton<SystemTrayViewModel>()
+                    .AddSingleton<SettingsViewModel>()
+                    .AddSingleton<LyricsPageViewModel>()
+                    .AddSingleton<LyricsRendererViewModel>()
+                    .AddSingleton<LyricsSettingsControlViewModel>()
+                    .BuildServiceProvider()
+            );
         }
 
+        /// <summary>
+        /// The App_UnhandledException
+        /// </summary>
+        /// <param name="sender">The sender<see cref="object"/></param>
+        /// <param name="e">The e<see cref="Microsoft.UI.Xaml.UnhandledExceptionEventArgs"/></param>
+        private void App_UnhandledException(
+            object sender,
+            Microsoft.UI.Xaml.UnhandledExceptionEventArgs e
+        )
+        {
+            _logger.LogError(e.Exception, "App_UnhandledException");
+            e.Handled = true;
+        }
+
+        /// <summary>
+        /// The CurrentDomain_FirstChanceException
+        /// </summary>
+        /// <param name="sender">The sender<see cref="object?"/></param>
+        /// <param name="e">The e<see cref="System.Runtime.ExceptionServices.FirstChanceExceptionEventArgs"/></param>
+        private void CurrentDomain_FirstChanceException(
+            object? sender,
+            System.Runtime.ExceptionServices.FirstChanceExceptionEventArgs e
+        )
+        {
+            _logger.LogError(e.Exception, "TaskScheduler_UnobservedTaskException");
+        }
+
+        /// <summary>
+        /// The CurrentDomain_UnhandledException
+        /// </summary>
+        /// <param name="sender">The sender<see cref="object"/></param>
+        /// <param name="e">The e<see cref="System.UnhandledExceptionEventArgs"/></param>
+        private void CurrentDomain_UnhandledException(
+            object sender,
+            System.UnhandledExceptionEventArgs e
+        )
+        {
+            _logger.LogError(e.ExceptionObject.ToString(), "CurrentDomain_UnhandledException");
+        }
+
+        /// <summary>
+        /// The TaskScheduler_UnobservedTaskException
+        /// </summary>
+        /// <param name="sender">The sender<see cref="object?"/></param>
+        /// <param name="e">The e<see cref="UnobservedTaskExceptionEventArgs"/></param>
+        private void TaskScheduler_UnobservedTaskException(
+            object? sender,
+            UnobservedTaskExceptionEventArgs e
+        )
+        {
+            //_logger.LogError(e.Exception, "TaskScheduler_UnobservedTaskException");
+        }
+
+        #endregion
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/BetterLyrics.WinUI3.csproj

@@ -2,42 +2,91 @@
   <PropertyGroup>
     <OutputType>WinExe</OutputType>
     <TargetFramework>net8.0-windows10.0.26100.0</TargetFramework>
-    <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
+    <TargetPlatformMinVersion>10.0.19041.0</TargetPlatformMinVersion>
     <RootNamespace>BetterLyrics.WinUI3</RootNamespace>
-    <ApplicationManifest>app.manifest</ApplicationManifest>
     <Platforms>x86;x64;ARM64</Platforms>
     <RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>
     <UseWinUI>true</UseWinUI>
     <Nullable>enable</Nullable>
+    <LangVersion>preview</LangVersion>
   </PropertyGroup>
-
+  <ItemGroup>
+    <Compile Remove="ViewModels\Lyrics\**" />
+    <Content Remove="ViewModels\Lyrics\**" />
+    <EmbeddedResource Remove="ViewModels\Lyrics\**" />
+    <None Remove="ViewModels\Lyrics\**" />
+    <Page Remove="ViewModels\Lyrics\**" />
+    <PRIResource Remove="ViewModels\Lyrics\**" />
+  </ItemGroup>
+  <ItemGroup>
+    <None Remove="Controls\DependenciesSettingsExpander.xaml" />
+    <None Remove="Controls\SystemTray.xaml" />
+  </ItemGroup>
+  <ItemGroup>
+    <Content Include="Logo.ico" />
+  </ItemGroup>
   <ItemGroup>
     <Manifest Include="$(ApplicationManifest)" />
   </ItemGroup>
-
   <ItemGroup>
     <PackageReference Include="CommunityToolkit.Labs.WinUI.MarqueeText" Version="0.1.230830" />
     <PackageReference Include="CommunityToolkit.Labs.WinUI.OpacityMaskView" Version="0.1.250513-build.2126" />
     <PackageReference Include="CommunityToolkit.Mvvm" Version="8.4.0" />
     <PackageReference Include="CommunityToolkit.WinUI.Behaviors" Version="8.2.250402" />
+    <PackageReference Include="CommunityToolkit.WinUI.Controls.Primitives" Version="8.2.250402" />
+    <PackageReference Include="CommunityToolkit.WinUI.Controls.Segmented" Version="8.2.250402" />
     <PackageReference Include="CommunityToolkit.WinUI.Controls.SettingsControls" Version="8.2.250402" />
     <PackageReference Include="CommunityToolkit.WinUI.Converters" Version="8.2.250402" />
     <PackageReference Include="CommunityToolkit.WinUI.Extensions" Version="8.2.250402" />
+    <PackageReference Include="CommunityToolkit.WinUI.Helpers" Version="8.2.250402" />
     <PackageReference Include="CommunityToolkit.WinUI.Media" Version="8.2.250402" />
-    <PackageReference Include="DevWinUI" Version="8.2.0" />
-    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="9.0.5" />
+    <PackageReference Include="H.NotifyIcon.WinUI" Version="2.3.0" />
+    <PackageReference Include="Lyricify.Lyrics.Helper-NativeAot" Version="0.1.4-alpha.5" />
+    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="9.0.6" />
+    <PackageReference Include="Microsoft.Extensions.Logging" Version="9.0.6" />
     <PackageReference Include="Microsoft.Graphics.Win2D" Version="1.3.2" />
     <PackageReference Include="Microsoft.Windows.SDK.BuildTools" Version="10.0.26100.4188" />
-    <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.7.250513003" />
+    <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.7.250606001" />
     <PackageReference Include="Microsoft.Xaml.Behaviors.WinUI.Managed" Version="3.0.0" />
-    <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
-    <PackageReference Include="sqlite-net-pcl" Version="1.9.172" />
-    <PackageReference Include="System.Text.Encoding.CodePages" Version="9.0.5" />
+    <PackageReference Include="Serilog.Extensions.Logging" Version="9.0.2" />
+    <PackageReference Include="Serilog.Sinks.File" Version="7.0.0" />
+    <PackageReference Include="System.Drawing.Common" Version="9.0.6" />
+    <PackageReference Include="System.Text.Encoding.CodePages" Version="9.0.6" />
+    <PackageReference Include="TagLibSharp" Version="2.3.0" />
     <PackageReference Include="Ude.NetStandard" Version="1.2.0" />
-    <PackageReference Include="z440.atl.core" Version="6.24.0" />
+    <PackageReference Include="WinUIEx" Version="2.6.0" />
+    <PackageReference Include="z440.atl.core" Version="6.26.0" />
   </ItemGroup>
-
-    <!-- Publish Properties -->
+  <ItemGroup>
+    <Content Update="Assets\AI - 甜度爆表.mp3">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </Content>
+  </ItemGroup>
+  <ItemGroup>
+    <Page Update="Rendering\InAppLyricsRenderer.xaml">
+      <Generator>MSBuild:Compile</Generator>
+    </Page>
+  </ItemGroup>
+  <ItemGroup>
+    <Page Update="Rendering\DesktopLyricsRenderer.xaml">
+      <Generator>MSBuild:Compile</Generator>
+    </Page>
+  </ItemGroup>
+  <!--Disable Trimming for Specific Packages-->
+  <ItemGroup>
+    <TrimmerRootAssembly Include="TagLibSharp" />
+  </ItemGroup>
+  <ItemGroup>
+    <Page Update="Controls\SystemTray.xaml">
+      <Generator>MSBuild:Compile</Generator>
+    </Page>
+  </ItemGroup>
+  <ItemGroup>
+    <Page Update="Controls\DependenciesSettingsExpander.xaml">
+      <Generator>MSBuild:Compile</Generator>
+    </Page>
+  </ItemGroup>
+  <!-- Publish Properties -->
   <PropertyGroup>
     <PublishReadyToRun Condition="'$(Configuration)' == 'Debug'">False</PublishReadyToRun>
     <PublishReadyToRun Condition="'$(Configuration)' != 'Debug'">True</PublishReadyToRun>
@@ -45,4 +94,22 @@
     <PublishTrimmed Condition="'$(Configuration)' != 'Debug'">True</PublishTrimmed>
     <SupportedOSPlatformVersion>10.0.19041.0</SupportedOSPlatformVersion>
   </PropertyGroup>
-</Project>
+  <PropertyGroup>
+    <DefineConstants>$(DefineConstants)</DefineConstants>
+    <ApplicationManifest>app.manifest</ApplicationManifest>
+    <ApplicationIcon>Logo.ico</ApplicationIcon>
+    <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
+    <ShouldCreateLogs>True</ShouldCreateLogs>
+    <AdvancedSettingsExpanded>True</AdvancedSettingsExpanded>
+    <UpdateAssemblyVersion>False</UpdateAssemblyVersion>
+    <UpdateAssemblyFileVersion>False</UpdateAssemblyFileVersion>
+    <UpdateAssemblyInfoVersion>False</UpdateAssemblyInfoVersion>
+    <UpdatePackageVersion>True</UpdatePackageVersion>
+    <AssemblyInfoVersionType>SettingsVersion</AssemblyInfoVersionType>
+    <InheritWinAppVersionFrom>AssemblyVersion</InheritWinAppVersionFrom>
+    <PackageVersionSettings>AssemblyVersion.None.None</PackageVersionSettings>
+    <Version>2025.6.0</Version>
+    <AssemblyVersion>2025.6.18.0110</AssemblyVersion>
+    <FileVersion>2025.6.18.0110</FileVersion>
+  </PropertyGroup>
+</Project>

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Controls/DependenciesSettingsExpander.xaml

@@ -0,0 +1,156 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<UserControl
+    x:Class="BetterLyrics.WinUI3.Controls.DependenciesSettingsExpander"
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+    xmlns:controls="using:CommunityToolkit.WinUI.Controls"
+    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
+    xmlns:local="using:BetterLyrics.WinUI3.Controls"
+    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+    xmlns:ui="using:CommunityToolkit.WinUI"
+    mc:Ignorable="d">
+
+    <controls:SettingsExpander
+        x:Uid="DependenciesSettingsExpander"
+        HeaderIcon="{ui:FontIcon Glyph=&#xE7B8;}"
+        IsExpanded="True">
+        <controls:SettingsExpander.Items>
+            <controls:SettingsCard Header="CommunityToolkit.Labs.WinUI.MarqueeText">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/CommunityToolkit.Labs.WinUI.MarqueeText" NavigateUri="https://www.nuget.org/packages/CommunityToolkit.Labs.WinUI.MarqueeText" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="CommunityToolkit.Labs.WinUI.OpacityMaskView">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/CommunityToolkit.Labs.WinUI.OpacityMaskView" NavigateUri="https://www.nuget.org/packages/CommunityToolkit.Labs.WinUI.OpacityMaskView" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="CommunityToolkit.Mvvm">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/CommunityToolkit.Mvvm" NavigateUri="https://www.nuget.org/packages/CommunityToolkit.Mvvm" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="CommunityToolkit.WinUI.Behaviors">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/CommunityToolkit.WinUI.Behaviors" NavigateUri="https://www.nuget.org/packages/CommunityToolkit.WinUI.Behaviors" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="CommunityToolkit.WinUI.Controls.Primitives">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/CommunityToolkit.WinUI.Controls.Primitives" NavigateUri="https://www.nuget.org/packages/CommunityToolkit.WinUI.Controls.Primitives" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="CommunityToolkit.WinUI.Controls.Segmented">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/CommunityToolkit.WinUI.Controls.Segmented" NavigateUri="https://www.nuget.org/packages/CommunityToolkit.WinUI.Controls.Segmented" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="CommunityToolkit.WinUI.Controls.SettingsControls">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/CommunityToolkit.WinUI.Controls.SettingsControls" NavigateUri="https://www.nuget.org/packages/CommunityToolkit.WinUI.Controls.SettingsControls" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="CommunityToolkit.WinUI.Converters">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/CommunityToolkit.WinUI.Converters" NavigateUri="https://www.nuget.org/packages/CommunityToolkit.WinUI.Converters" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="CommunityToolkit.WinUI.Extensions">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/CommunityToolkit.WinUI.Extensions" NavigateUri="https://www.nuget.org/packages/CommunityToolkit.WinUI.Extensions" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="CommunityToolkit.WinUI.Helpers">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/CommunityToolkit.WinUI.Helpers" NavigateUri="https://www.nuget.org/packages/CommunityToolkit.WinUI.Helpers" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="CommunityToolkit.WinUI.Media">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/CommunityToolkit.WinUI.Media" NavigateUri="https://www.nuget.org/packages/CommunityToolkit.WinUI.Media" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="H.NotifyIcon.WinUI">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/H.NotifyIcon.WinUI" NavigateUri="https://www.nuget.org/packages/H.NotifyIcon.WinUI" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="Lyricify.Lyrics.Helper-NativeAot">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/Lyricify.Lyrics.Helper-NativeAot" NavigateUri="https://www.nuget.org/packages/Lyricify.Lyrics.Helper-NativeAot" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="Microsoft.Extensions.DependencyInjection">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/Microsoft.Extensions.DependencyInjection" NavigateUri="https://www.nuget.org/packages/Microsoft.Extensions.DependencyInjection" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="Microsoft.Extensions.Logging">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/Microsoft.Extensions.Logging" NavigateUri="https://www.nuget.org/packages/Microsoft.Extensions.Logging" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="Microsoft.Graphics.Win2D">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/Microsoft.Graphics.Win2D" NavigateUri="https://www.nuget.org/packages/Microsoft.Graphics.Win2D" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="Microsoft.Windows.SDK.BuildTools">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/Microsoft.Windows.SDK.BuildTools" NavigateUri="https://www.nuget.org/packages/Microsoft.Windows.SDK.BuildTools" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="Microsoft.WindowsAppSDK">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/Microsoft.WindowsAppSDK" NavigateUri="https://www.nuget.org/packages/Microsoft.WindowsAppSDK" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="Microsoft.Xaml.Behaviors.WinUI.Managed">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/Microsoft.Xaml.Behaviors.WinUI.Managed" NavigateUri="https://www.nuget.org/packages/Microsoft.Xaml.Behaviors.WinUI.Managed" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="Serilog.Extensions.Logging">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/Serilog.Extensions.Logging" NavigateUri="https://www.nuget.org/packages/Serilog.Extensions.Logging" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="Serilog.Sinks.File">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/Serilog.Sinks.File" NavigateUri="https://www.nuget.org/packages/Serilog.Sinks.File" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="System.Drawing.Common">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/System.Drawing.Common" NavigateUri="https://www.nuget.org/packages/System.Drawing.Common" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="System.Text.Encoding.CodePages">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/System.Text.Encoding.CodePages" NavigateUri="https://www.nuget.org/packages/System.Text.Encoding.CodePages" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="TagLibSharp">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/TagLibSharp" NavigateUri="https://www.nuget.org/packages/TagLibSharp" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="Ude.NetStandard">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/Ude.NetStandard" NavigateUri="https://www.nuget.org/packages/Ude.NetStandard" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="WinUIEx">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/WinUIEx" NavigateUri="https://www.nuget.org/packages/WinUIEx" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+            <controls:SettingsCard Header="z440.atl.core">
+                <controls:SettingsCard.Description>
+                    <HyperlinkButton Content="https://www.nuget.org/packages/z440.atl.core" NavigateUri="https://www.nuget.org/packages/z440.atl.core" />
+                </controls:SettingsCard.Description>
+            </controls:SettingsCard>
+        </controls:SettingsExpander.Items>
+    </controls:SettingsExpander>
+
+</UserControl>

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Controls/DependenciesSettingsExpander.xaml.cs

@@ -0,0 +1,28 @@
+using Microsoft.UI.Xaml;
+using Microsoft.UI.Xaml.Controls;
+using Microsoft.UI.Xaml.Controls.Primitives;
+using Microsoft.UI.Xaml.Data;
+using Microsoft.UI.Xaml.Input;
+using Microsoft.UI.Xaml.Media;
+using Microsoft.UI.Xaml.Navigation;
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Runtime.InteropServices.WindowsRuntime;
+using Windows.Foundation;
+using Windows.Foundation.Collections;
+
+// To learn more about WinUI, the WinUI project structure,
+// and more about our project templates, see: http://aka.ms/winui-project-info.
+
+namespace BetterLyrics.WinUI3.Controls
+{
+    public sealed partial class DependenciesSettingsExpander : UserControl
+    {
+        public DependenciesSettingsExpander()
+        {
+            InitializeComponent();
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Controls/SystemTray.xaml

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<UserControl
+    x:Class="BetterLyrics.WinUI3.Controls.SystemTray"
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
+    xmlns:local="using:BetterLyrics.WinUI3.Controls"
+    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+    xmlns:tb="using:H.NotifyIcon"
+    xmlns:ui="using:CommunityToolkit.WinUI"
+    mc:Ignorable="d">
+
+    <tb:TaskbarIcon
+        x:Name="TrayIcon"
+        x:FieldModifier="public"
+        ContextMenuMode="SecondWindow"
+        IconSource="ms-appx:///Assets/Logo.ico"
+        NoLeftClickDelay="True"
+        ToolTipText="{x:Bind ViewModel.ToolTipText, Mode=OneWay}">
+        <tb:TaskbarIcon.ContextFlyout>
+            <MenuFlyout
+                AreOpenCloseAnimationsEnabled="True"
+                LightDismissOverlayMode="On"
+                ShowMode="TransientWithDismissOnPointerMoveAway">
+                <MenuFlyoutItem x:Uid="SystemTraySettings" Command="{x:Bind ViewModel.OpenSettingsCommand}" />
+                <MenuFlyoutItem x:Uid="SystemTrayExit" Command="{x:Bind ViewModel.ExitAppCommand}" />
+                <MenuFlyoutItem
+                    x:Uid="SystemTrayUnlock"
+                    Command="{x:Bind ViewModel.UnlockWindowCommand}"
+                    Visibility="{x:Bind ViewModel.IsLyricsWindowLocked, Mode=OneWay, Converter={StaticResource BoolToVisibilityConverter}}" />
+            </MenuFlyout>
+        </tb:TaskbarIcon.ContextFlyout>
+    </tb:TaskbarIcon>
+</UserControl>

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Controls/SystemTray.xaml.cs

@@ -0,0 +1,33 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Runtime.InteropServices.WindowsRuntime;
+using BetterLyrics.WinUI3.ViewModels;
+using CommunityToolkit.Mvvm.DependencyInjection;
+using Microsoft.UI.Xaml;
+using Microsoft.UI.Xaml.Controls;
+using Microsoft.UI.Xaml.Controls.Primitives;
+using Microsoft.UI.Xaml.Data;
+using Microsoft.UI.Xaml.Input;
+using Microsoft.UI.Xaml.Media;
+using Microsoft.UI.Xaml.Navigation;
+using Windows.Foundation;
+using Windows.Foundation.Collections;
+
+// To learn more about WinUI, the WinUI project structure,
+// and more about our project templates, see: http://aka.ms/winui-project-info.
+
+namespace BetterLyrics.WinUI3.Controls
+{
+    public sealed partial class SystemTray : UserControl
+    {
+        public SystemTrayViewModel ViewModel => (SystemTrayViewModel)DataContext;
+
+        public SystemTray()
+        {
+            InitializeComponent();
+            DataContext = Ioc.Default.GetService<SystemTrayViewModel>();
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Converter/ColorToBrushConverter.cs

@@ -1,23 +1,49 @@
-using Microsoft.UI.Xaml.Data;
-using Microsoft.UI.Xaml.Media;
+// 2025/6/23 by Zhe Fang
+
 using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
+using Microsoft.UI.Xaml.Data;
+using Microsoft.UI.Xaml.Media;
 using Windows.UI;
 
-namespace BetterLyrics.WinUI3.Converter {
-    public class ColorToBrushConverter : IValueConverter {
-        public object Convert(object value, Type targetType, object parameter, string language) {
-            if (value is Color color) {
+namespace BetterLyrics.WinUI3.Converter
+{
+    /// <summary>
+    /// Defines the <see cref="ColorToBrushConverter" />
+    /// </summary>
+    public partial class ColorToBrushConverter : IValueConverter
+    {
+        #region Methods
+
+        /// <summary>
+        /// The Convert
+        /// </summary>
+        /// <param name="value">The value<see cref="object"/></param>
+        /// <param name="targetType">The targetType<see cref="Type"/></param>
+        /// <param name="parameter">The parameter<see cref="object"/></param>
+        /// <param name="language">The language<see cref="string"/></param>
+        /// <returns>The <see cref="object"/></returns>
+        public object Convert(object value, Type targetType, object parameter, string language)
+        {
+            if (value is Color color)
+            {
                 return new SolidColorBrush(color);
             }
             return new SolidColorBrush();
         }
 
-        public object ConvertBack(object value, Type targetType, object parameter, string language) {
+        /// <summary>
+        /// The ConvertBack
+        /// </summary>
+        /// <param name="value">The value<see cref="object"/></param>
+        /// <param name="targetType">The targetType<see cref="Type"/></param>
+        /// <param name="parameter">The parameter<see cref="object"/></param>
+        /// <param name="language">The language<see cref="string"/></param>
+        /// <returns>The <see cref="object"/></returns>
+        public object ConvertBack(object value, Type targetType, object parameter, string language)
+        {
             throw new NotImplementedException();
         }
+
+        #endregion
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Converter/CornerRadiusToDoubleConverter.cs

@@ -0,0 +1,27 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using Microsoft.UI.Xaml.Data;
+
+namespace BetterLyrics.WinUI3.Converter
+{
+    internal partial class CornerRadiusToDoubleConverter : IValueConverter
+    {
+        public object Convert(object value, Type targetType, object parameter, string language)
+        {
+            if (value is Microsoft.UI.Xaml.CornerRadius cornerRadius)
+            {
+                // Convert CornerRadius to an integer value, e.g., using the top-left radius
+                return (double)cornerRadius.TopLeft;
+            }
+            return .0; // or handle the case where value is not a CornerRadius
+        }
+
+        public object ConvertBack(object value, Type targetType, object parameter, string language)
+        {
+            throw new NotImplementedException();
+        }
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Converter/EnumToIntConverter.cs

@@ -0,0 +1,51 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using Microsoft.UI.Xaml.Data;
+
+namespace BetterLyrics.WinUI3.Converter
+{
+    /// <summary>
+    /// Defines the <see cref="EnumToIntConverter" />
+    /// </summary>
+    internal partial class EnumToIntConverter : IValueConverter
+    {
+        #region Methods
+
+        /// <summary>
+        /// The Convert
+        /// </summary>
+        /// <param name="value">The value<see cref="object"/></param>
+        /// <param name="targetType">The targetType<see cref="Type"/></param>
+        /// <param name="parameter">The parameter<see cref="object"/></param>
+        /// <param name="language">The language<see cref="string"/></param>
+        /// <returns>The <see cref="object"/></returns>
+        public object Convert(object value, Type targetType, object parameter, string language)
+        {
+            if (value is Enum)
+            {
+                return System.Convert.ToInt32(value);
+            }
+            return 0;
+        }
+
+        /// <summary>
+        /// The ConvertBack
+        /// </summary>
+        /// <param name="value">The value<see cref="object"/></param>
+        /// <param name="targetType">The targetType<see cref="Type"/></param>
+        /// <param name="parameter">The parameter<see cref="object"/></param>
+        /// <param name="language">The language<see cref="string"/></param>
+        /// <returns>The <see cref="object"/></returns>
+        public object ConvertBack(object value, Type targetType, object parameter, string language)
+        {
+            if (value is int && targetType.IsEnum)
+            {
+                return Enum.ToObject(targetType, value);
+            }
+            return Enum.ToObject(targetType, 0);
+        }
+
+        #endregion
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Converter/IntToCornerRadius.cs

@@ -0,0 +1,47 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using Microsoft.UI.Xaml.Data;
+
+namespace BetterLyrics.WinUI3.Converter
+{
+    /// <summary>
+    /// Defines the <see cref="IntToCornerRadius" />
+    /// </summary>
+    public partial class IntToCornerRadius : IValueConverter
+    {
+        #region Methods
+
+        /// <summary>
+        /// The Convert
+        /// </summary>
+        /// <param name="value">The value<see cref="object"/></param>
+        /// <param name="targetType">The targetType<see cref="Type"/></param>
+        /// <param name="parameter">The parameter<see cref="object"/></param>
+        /// <param name="language">The language<see cref="string"/></param>
+        /// <returns>The <see cref="object"/></returns>
+        public object Convert(object value, Type targetType, object parameter, string language)
+        {
+            if (value is int intValue && parameter is double controlHeight)
+            {
+                return new Microsoft.UI.Xaml.CornerRadius(intValue / 100f * controlHeight / 2);
+            }
+            return new Microsoft.UI.Xaml.CornerRadius(0);
+        }
+
+        /// <summary>
+        /// The ConvertBack
+        /// </summary>
+        /// <param name="value">The value<see cref="object"/></param>
+        /// <param name="targetType">The targetType<see cref="Type"/></param>
+        /// <param name="parameter">The parameter<see cref="object"/></param>
+        /// <param name="language">The language<see cref="string"/></param>
+        /// <returns>The <see cref="object"/></returns>
+        public object ConvertBack(object value, Type targetType, object parameter, string language)
+        {
+            throw new NotImplementedException();
+        }
+
+        #endregion
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Converter/LyricsSearchProviderToDisplayNameConverter.cs

@@ -0,0 +1,78 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using BetterLyrics.WinUI3.Enums;
+using Microsoft.UI.Xaml.Data;
+
+namespace BetterLyrics.WinUI3.Converter
+{
+    /// <summary>
+    /// Defines the <see cref="LyricsSearchProviderToDisplayNameConverter" />
+    /// </summary>
+    public partial class LyricsSearchProviderToDisplayNameConverter : IValueConverter
+    {
+        #region Methods
+
+        /// <summary>
+        /// The Convert
+        /// </summary>
+        /// <param name="value">The value<see cref="object"/></param>
+        /// <param name="targetType">The targetType<see cref="Type"/></param>
+        /// <param name="parameter">The parameter<see cref="object"/></param>
+        /// <param name="language">The language<see cref="string"/></param>
+        /// <returns>The <see cref="object"/></returns>
+        public object Convert(object value, Type targetType, object parameter, string language)
+        {
+            if (value is LyricsSearchProvider provider)
+            {
+                return provider switch
+                {
+                    LyricsSearchProvider.LrcLib => App.ResourceLoader!.GetString(
+                        "LyricsSearchProviderLrcLib"
+                    ),
+                    LyricsSearchProvider.QQ => App.ResourceLoader!.GetString(
+                        "LyricsSearchProviderQQ"
+                    ),
+                    LyricsSearchProvider.Netease => App.ResourceLoader!.GetString(
+                        "LyricsSearchProviderNetease"
+                    ),
+                    LyricsSearchProvider.Kugou => App.ResourceLoader!.GetString(
+                        "LyricsSearchProviderKugou"
+                    ),
+                    LyricsSearchProvider.AmllTtmlDb => App.ResourceLoader!.GetString(
+                        "LyricsSearchProviderAmllTtmlDb"
+                    ),
+                    LyricsSearchProvider.LocalLrcFile => App.ResourceLoader!.GetString(
+                        "LyricsSearchProviderLocalLrcFile"
+                    ),
+                    LyricsSearchProvider.LocalMusicFile => App.ResourceLoader!.GetString(
+                        "LyricsSearchProviderLocalMusicFile"
+                    ),
+                    LyricsSearchProvider.LocalEslrcFile => App.ResourceLoader!.GetString(
+                        "LyricsSearchProviderEslrcFile"
+                    ),
+                    LyricsSearchProvider.LocalTtmlFile => App.ResourceLoader!.GetString(
+                        "LyricsSearchProviderTtmlFile"
+                    ),
+                    _ => "",
+                };
+            }
+            return "";
+        }
+
+        /// <summary>
+        /// The ConvertBack
+        /// </summary>
+        /// <param name="value">The value<see cref="object"/></param>
+        /// <param name="targetType">The targetType<see cref="Type"/></param>
+        /// <param name="parameter">The parameter<see cref="object"/></param>
+        /// <param name="language">The language<see cref="string"/></param>
+        /// <returns>The <see cref="object"/></returns>
+        public object ConvertBack(object value, Type targetType, object parameter, string language)
+        {
+            throw new NotImplementedException();
+        }
+
+        #endregion
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Converter/MatchedLocalFilesPathToVisibilityConverter.cs

@@ -0,0 +1,55 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using Microsoft.UI.Xaml;
+using Microsoft.UI.Xaml.Data;
+
+namespace BetterLyrics.WinUI3.Converter
+{
+    /// <summary>
+    /// Defines the <see cref="MatchedLocalFilesPathToVisibilityConverter" />
+    /// </summary>
+    public partial class MatchedLocalFilesPathToVisibilityConverter : IValueConverter
+    {
+        #region Methods
+
+        /// <summary>
+        /// The Convert
+        /// </summary>
+        /// <param name="value">The value<see cref="object"/></param>
+        /// <param name="targetType">The targetType<see cref="Type"/></param>
+        /// <param name="parameter">The parameter<see cref="object"/></param>
+        /// <param name="language">The language<see cref="string"/></param>
+        /// <returns>The <see cref="object"/></returns>
+        public object Convert(object value, Type targetType, object parameter, string language)
+        {
+            if (value is string path)
+            {
+                if (path == App.ResourceLoader!.GetString("MainPageNoLocalFilesMatched"))
+                {
+                    return Visibility.Collapsed;
+                }
+                else
+                {
+                    return Visibility.Visible;
+                }
+            }
+            return Visibility.Collapsed;
+        }
+
+        /// <summary>
+        /// The ConvertBack
+        /// </summary>
+        /// <param name="value">The value<see cref="object"/></param>
+        /// <param name="targetType">The targetType<see cref="Type"/></param>
+        /// <param name="parameter">The parameter<see cref="object"/></param>
+        /// <param name="language">The language<see cref="string"/></param>
+        /// <returns>The <see cref="object"/></returns>
+        public object ConvertBack(object value, Type targetType, object parameter, string language)
+        {
+            throw new NotImplementedException();
+        }
+
+        #endregion
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Converter/ThemeTypeToElementThemeConverter.cs

@@ -1,22 +0,0 @@
-using Microsoft.UI.Xaml;
-using Microsoft.UI.Xaml.Data;
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace BetterLyrics.WinUI3.Converter {
-    internal class ThemeTypeToElementThemeConverter : IValueConverter {
-        public object Convert(object value, Type targetType, object parameter, string language) {
-            if (value is int themeType) {
-                return (ElementTheme)themeType;
-            }
-            return ElementTheme.Default;
-        }
-
-        public object ConvertBack(object value, Type targetType, object parameter, string language) {
-            return 0;
-        }
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/AutoStartWindowType.cs

@@ -0,0 +1,24 @@
+// 2025/6/23 by Zhe Fang
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    #region Enums
+
+    /// <summary>
+    /// Defines the AutoStartWindowType
+    /// </summary>
+    public enum AutoStartWindowType
+    {
+        /// <summary>
+        /// Defines the StandardMode
+        /// </summary>
+        StandardMode,
+
+        /// <summary>
+        /// Defines the DockMode
+        /// </summary>
+        DockMode,
+    }
+
+    #endregion
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/BackdropType.cs

@@ -0,0 +1,45 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    #region Enums
+
+    /// <summary>
+    /// Defines the BackdropType
+    /// </summary>
+    public enum BackdropType
+    {
+        /// <summary>
+        /// Defines the None
+        /// </summary>
+        None = 0,
+
+        /// <summary>
+        /// Defines the Mica
+        /// </summary>
+        Mica = 1,
+
+        /// <summary>
+        /// Defines the MicaAlt
+        /// </summary>
+        MicaAlt = 2,
+
+        /// <summary>
+        /// Defines the DesktopAcrylic
+        /// </summary>
+        DesktopAcrylic = 3,
+
+        /// <summary>
+        /// Defines the Transparent
+        /// </summary>
+        Transparent = 4,
+    }
+
+    #endregion
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/EasingType.cs

@@ -0,0 +1,39 @@
+// 2025/6/23 by Zhe Fang
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    #region Enums
+
+    /// <summary>
+    /// Defines the EasingType
+    /// </summary>
+    public enum EasingType
+    {
+        /// <summary>
+        /// Defines the EaseInOutQuad
+        /// </summary>
+        EaseInOutQuad,
+
+        /// <summary>
+        /// Defines the EaseInQuad
+        /// </summary>
+        EaseInQuad,
+
+        /// <summary>
+        /// Defines the EaseOutQuad
+        /// </summary>
+        EaseOutQuad,
+
+        /// <summary>
+        /// Defines the Linear
+        /// </summary>
+        Linear,
+
+        /// <summary>
+        /// Defines the SmootherStep
+        /// </summary>
+        SmootherStep,
+    }
+
+    #endregion
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/Language.cs

@@ -0,0 +1,50 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    #region Enums
+
+    /// <summary>
+    /// Defines the Language
+    /// </summary>
+    public enum Language
+    {
+        /// <summary>
+        /// Defines the FollowSystem
+        /// </summary>
+        FollowSystem,
+
+        /// <summary>
+        /// Defines the English
+        /// </summary>
+        English,
+
+        /// <summary>
+        /// Defines the SimplifiedChinese
+        /// </summary>
+        SimplifiedChinese,
+
+        /// <summary>
+        /// Defines the TraditionalChinese
+        /// </summary>
+        TraditionalChinese,
+
+        /// <summary>
+        /// Defines the Japanese
+        /// </summary>
+        Japanese,
+
+        /// <summary>
+        /// Defines the Korean
+        /// </summary>
+        Korean,
+    }
+
+    #endregion
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LineMaskType.cs

@@ -4,10 +4,11 @@ using System.Linq;
 using System.Text;
 using System.Threading.Tasks;
 
-namespace BetterLyrics.WinUI3.Models {
-    public enum LyricsAlignmentType {
-        Left,
-        Center,
-        Right,
+namespace BetterLyrics.WinUI3.Enums
+{
+    public enum LineMaskType
+    {
+        Glow,
+        Highlight,
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LineRenderingType.cs

@@ -0,0 +1,21 @@
+// 2025/6/23 by Zhe Fang
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    #region Enums
+
+    /// <summary>
+    /// Defines the LineMaskType
+    /// </summary>
+    public enum LineRenderingType
+    {
+        UntilCurrentChar,
+
+        /// <summary>
+        /// Current char only
+        /// </summary>
+        CurrentCharOnly,
+    }
+
+    #endregion
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LocalSearchTargetProps.cs

@@ -0,0 +1,30 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    #region Enums
+
+    /// <summary>
+    /// Defines the LocalSearchTargetProps
+    /// </summary>
+    public enum LocalSearchTargetProps
+    {
+        /// <summary>
+        /// Defines the LyricsOnly
+        /// </summary>
+        LyricsOnly,
+
+        /// <summary>
+        /// Defines the LyricsAndAlbumArt
+        /// </summary>
+        LyricsAndAlbumArt,
+    }
+
+    #endregion
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LyricsAlignmentType.cs

@@ -0,0 +1,35 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    #region Enums
+
+    /// <summary>
+    /// Defines the LyricsAlignmentType
+    /// </summary>
+    public enum LyricsAlignmentType
+    {
+        /// <summary>
+        /// Defines the Left
+        /// </summary>
+        Left,
+
+        /// <summary>
+        /// Defines the Center
+        /// </summary>
+        Center,
+
+        /// <summary>
+        /// Defines the Right
+        /// </summary>
+        Right,
+    }
+
+    #endregion
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LyricsDisplayType.cs

@@ -0,0 +1,34 @@
+// 2025/6/23 by Zhe Fang
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    #region Enums
+
+    /// <summary>
+    /// Defines the LyricsDisplayType
+    /// </summary>
+    public enum LyricsDisplayType
+    {
+        /// <summary>
+        /// Defines the AlbumArtOnly
+        /// </summary>
+        AlbumArtOnly,
+
+        /// <summary>
+        /// Defines the LyricsOnly
+        /// </summary>
+        LyricsOnly,
+
+        /// <summary>
+        /// Defines the SplitView
+        /// </summary>
+        SplitView,
+
+        /// <summary>
+        /// Defines the PlaceholderOnly
+        /// </summary>
+        PlaceholderOnly,
+    }
+
+    #endregion
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LyricsFontColorType.cs

@@ -0,0 +1,30 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    #region Enums
+
+    /// <summary>
+    /// Defines the LyricsFontColorType
+    /// </summary>
+    public enum LyricsFontColorType
+    {
+        /// <summary>
+        /// Defines the Default
+        /// </summary>
+        Default,
+
+        /// <summary>
+        /// Defines the Dominant
+        /// </summary>
+        Dominant,
+    }
+
+    #endregion
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LyricsFontWeight.cs

@@ -0,0 +1,115 @@
+// 2025/6/23 by Zhe Fang
+
+using Microsoft.UI.Text;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using Windows.UI.Text;
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    #region Enums
+
+    /// <summary>
+    /// Defines the LyricsFontWeight
+    /// </summary>
+    public enum LyricsFontWeight
+    {
+        /// <summary>
+        /// Defines the Thin
+        /// </summary>
+        Thin,
+
+        /// <summary>
+        /// Defines the ExtraLight
+        /// </summary>
+        ExtraLight,
+
+        /// <summary>
+        /// Defines the Light
+        /// </summary>
+        Light,
+
+        /// <summary>
+        /// Defines the SemiLight
+        /// </summary>
+        SemiLight,
+
+        /// <summary>
+        /// Defines the Normal
+        /// </summary>
+        Normal,
+
+        /// <summary>
+        /// Defines the Medium
+        /// </summary>
+        Medium,
+
+        /// <summary>
+        /// Defines the SemiBold
+        /// </summary>
+        SemiBold,
+
+        /// <summary>
+        /// Defines the Bold
+        /// </summary>
+        Bold,
+
+        /// <summary>
+        /// Defines the ExtraBold
+        /// </summary>
+        ExtraBold,
+
+        /// <summary>
+        /// Defines the Black
+        /// </summary>
+        Black,
+
+        /// <summary>
+        /// Defines the ExtraBlack
+        /// </summary>
+        ExtraBlack,
+    }
+
+    #endregion
+
+    /// <summary>
+    /// Defines the <see cref="LyricsFontWeightExtensions" />
+    /// </summary>
+    public static class LyricsFontWeightExtensions
+    {
+        #region Methods
+
+        /// <summary>
+        /// The ToFontWeight
+        /// </summary>
+        /// <param name="weight">The weight<see cref="LyricsFontWeight"/></param>
+        /// <returns>The <see cref="FontWeight"/></returns>
+        public static FontWeight ToFontWeight(this LyricsFontWeight weight)
+        {
+            return weight switch
+            {
+                LyricsFontWeight.Thin => FontWeights.Thin,
+                LyricsFontWeight.ExtraLight => FontWeights.ExtraLight,
+                LyricsFontWeight.Light => FontWeights.Light,
+                LyricsFontWeight.SemiLight => FontWeights.SemiLight,
+                LyricsFontWeight.Normal => FontWeights.Normal,
+                LyricsFontWeight.Medium => FontWeights.Medium,
+                LyricsFontWeight.SemiBold => FontWeights.SemiBold,
+                LyricsFontWeight.Bold => FontWeights.Bold,
+                LyricsFontWeight.ExtraBold => FontWeights.ExtraBold,
+                LyricsFontWeight.Black => FontWeights.Black,
+                LyricsFontWeight.ExtraBlack => FontWeights.ExtraBlack,
+                LyricsFontWeight _ => throw new ArgumentOutOfRangeException(
+                    nameof(weight),
+                    weight,
+                    null
+                ),
+            };
+        }
+
+        #endregion
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LyricsFormat.cs

@@ -0,0 +1,97 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    #region Enums
+
+    /// <summary>
+    /// Defines the LyricsFormat
+    /// </summary>
+    public enum LyricsFormat
+    {
+        /// <summary>
+        /// Defines the Lrc
+        /// </summary>
+        Lrc,
+
+        /// <summary>
+        /// Defines the Eslrc
+        /// </summary>
+        Eslrc,
+
+        /// <summary>
+        /// Defines the Ttml
+        /// </summary>
+        Ttml,
+        Qrc,
+        Krc,
+        NotSpecified,
+    }
+
+    #endregion
+
+    /// <summary>
+    /// Defines the <see cref="LyricsFormatExtensions" />
+    /// </summary>
+    public static class LyricsFormatExtensions
+    {
+        #region Methods
+
+        /// <summary>
+        /// The Detect
+        /// </summary>
+        /// <param name="content">The content<see cref="string"/></param>
+        /// <returns>The <see cref="LyricsFormat?"/></returns>
+        public static LyricsFormat? DetectFormat(this string content)
+        {
+            if (
+                content.StartsWith("<?xml")
+                && System.Text.RegularExpressions.Regex.IsMatch(content, @"<tt(:\w+)?\b")
+            )
+            {
+                return LyricsFormat.Ttml;
+            }
+            // 检测标准LRC和增强型LRC
+            else if (
+                System.Text.RegularExpressions.Regex.IsMatch(content, @"\[\d{1,2}:\d{2}")
+                || System.Text.RegularExpressions.Regex.IsMatch(
+                    content,
+                    @"<\d{1,2}:\d{2}\.\d{2,3}>"
+                )
+            )
+            {
+                return LyricsFormat.Lrc;
+            }
+            else
+            {
+                return null;
+            }
+        }
+
+        /// <summary>
+        /// The ToFileExtension
+        /// </summary>
+        /// <param name="format">The format<see cref="LyricsFormat"/></param>
+        /// <returns>The <see cref="string"/></returns>
+        public static string ToFileExtension(this LyricsFormat format)
+        {
+            return format switch
+            {
+                LyricsFormat.Lrc => ".lrc",
+                LyricsFormat.Qrc => ".qrc",
+                LyricsFormat.Krc => ".krc",
+                LyricsFormat.Eslrc => ".eslrc",
+                LyricsFormat.Ttml => ".ttml",
+                _ => ".*",
+            };
+        }
+
+        #endregion
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LyricsPlayingState.cs

@@ -0,0 +1,35 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    #region Enums
+
+    /// <summary>
+    /// Defines the LyricsPlayingState
+    /// </summary>
+    public enum LyricsPlayingState
+    {
+        /// <summary>
+        /// Defines the NotPlayed
+        /// </summary>
+        NotPlayed,
+
+        /// <summary>
+        /// Defines the Playing
+        /// </summary>
+        Playing,
+
+        /// <summary>
+        /// Defines the Played
+        /// </summary>
+        Played,
+    }
+
+    #endregion
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LyricsSearchProvider.cs

@@ -0,0 +1,94 @@
+// 2025/6/23 by Zhe Fang
+
+using BetterLyrics.WinUI3.Helper;
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    #region Enums
+
+    /// <summary>
+    /// Defines the LyricsSearchProvider
+    /// </summary>
+    public enum LyricsSearchProvider
+    {
+        QQ,
+        Kugou,
+        Netease,
+        LrcLib,
+
+        AmllTtmlDb,
+
+        /// <summary>
+        /// Defines the LocalMusicFile
+        /// </summary>
+        LocalMusicFile,
+
+        /// <summary>
+        /// Defines the LocalLrcFile
+        /// </summary>
+        LocalLrcFile,
+
+        /// <summary>
+        /// Defines the LocalEslrcFile
+        /// </summary>
+        LocalEslrcFile,
+
+        /// <summary>
+        /// Defines the LocalTtmlFile
+        /// </summary>
+        LocalTtmlFile,
+    }
+
+    public static class LyricsSearchProviderExtensions
+    {
+        /// <summary>
+        /// The IsLocal
+        /// </summary>
+        /// <param name="provider">The provider<see cref="LyricsSearchProvider"/></param>
+        /// <returns>The <see cref="bool"/></returns>
+        public static bool IsLocal(this LyricsSearchProvider provider)
+        {
+            return provider
+                is LyricsSearchProvider.LocalMusicFile
+                    or LyricsSearchProvider.LocalLrcFile
+                    or LyricsSearchProvider.LocalEslrcFile
+                    or LyricsSearchProvider.LocalTtmlFile;
+        }
+
+        public static bool IsRemote(this LyricsSearchProvider provider)
+        {
+            return !provider.IsLocal();
+        }
+
+        public static string GetCacheDirectory(this LyricsSearchProvider provider)
+        {
+            return provider switch
+            {
+                LyricsSearchProvider.LrcLib => AppInfo.LrcLibLyricsCacheDirectory,
+                LyricsSearchProvider.QQ => AppInfo.QQLyricsCacheDirectory,
+                LyricsSearchProvider.Netease => AppInfo.NeteaseLyricsCacheDirectory,
+                LyricsSearchProvider.Kugou => AppInfo.KugouLyricsCacheDirectory,
+                LyricsSearchProvider.AmllTtmlDb => AppInfo.AmllTtmlDbLyricsCacheDirectory,
+                _ => throw new System.ArgumentOutOfRangeException(nameof(provider)),
+            };
+        }
+
+        public static LyricsFormat GetLyricsFormat(this LyricsSearchProvider provider)
+        {
+            return provider switch
+            {
+                LyricsSearchProvider.LrcLib => LyricsFormat.Lrc,
+                LyricsSearchProvider.QQ => LyricsFormat.Qrc,
+                LyricsSearchProvider.Kugou => LyricsFormat.Krc,
+                LyricsSearchProvider.Netease => LyricsFormat.Lrc,
+                LyricsSearchProvider.AmllTtmlDb => LyricsFormat.Ttml,
+                LyricsSearchProvider.LocalLrcFile => LyricsFormat.Lrc,
+                LyricsSearchProvider.LocalEslrcFile => LyricsFormat.Eslrc,
+                LyricsSearchProvider.LocalTtmlFile => LyricsFormat.Ttml,
+                _ => LyricsFormat.NotSpecified,
+            };
+        }
+    }
+
+    #endregion
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LyricsStatus.cs

@@ -0,0 +1,35 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    #region Enums
+
+    /// <summary>
+    /// Defines the LyricsStatus
+    /// </summary>
+    public enum LyricsStatus
+    {
+        /// <summary>
+        /// Defines the NotFound
+        /// </summary>
+        NotFound,
+
+        /// <summary>
+        /// Defines the Found
+        /// </summary>
+        Found,
+
+        /// <summary>
+        /// Defines the Loading
+        /// </summary>
+        Loading,
+    }
+
+    #endregion
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/LyricsType.cs

@@ -0,0 +1,30 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    #region Enums
+
+    /// <summary>
+    /// Defines the LyricsType
+    /// </summary>
+    public enum LyricsType
+    {
+        /// <summary>
+        /// Defines the InAppLyrics
+        /// </summary>
+        InAppLyrics,
+
+        /// <summary>
+        /// Defines the DesktopLyrics
+        /// </summary>
+        DesktopLyrics,
+    }
+
+    #endregion
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/MusicSearchMatchMode.cs

@@ -0,0 +1,24 @@
+// 2025/6/23 by Zhe Fang
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    #region Enums
+
+    /// <summary>
+    /// Defines the MusicSearchMatchMode
+    /// </summary>
+    public enum MusicSearchMatchMode
+    {
+        /// <summary>
+        /// Defines the TitleAndArtist
+        /// </summary>
+        TitleAndArtist,
+
+        /// <summary>
+        /// Defines the TitleArtistAlbumAndDuration
+        /// </summary>
+        TitleArtistAlbumAndDuration,
+    }
+
+    #endregion
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Enums/TitleBarType.cs

@@ -0,0 +1,59 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Enums
+{
+    #region Enums
+
+    /// <summary>
+    /// Defines the TitleBarType
+    /// </summary>
+    public enum TitleBarType
+    {
+        /// <summary>
+        /// Defines the Compact
+        /// </summary>
+        Compact,
+
+        /// <summary>
+        /// Defines the Extended
+        /// </summary>
+        Extended,
+    }
+
+    #endregion
+
+    /// <summary>
+    /// Defines the <see cref="TitleBarTypeExtensions" />
+    /// </summary>
+    public static class TitleBarTypeExtensions
+    {
+        #region Methods
+
+        /// <summary>
+        /// The GetHeight
+        /// </summary>
+        /// <param name="titleBarType">The titleBarType<see cref="TitleBarType"/></param>
+        /// <returns>The <see cref="double"/></returns>
+        public static double GetHeight(this TitleBarType titleBarType)
+        {
+            return titleBarType switch
+            {
+                TitleBarType.Compact => 32.0,
+                TitleBarType.Extended => 48.0,
+                _ => throw new ArgumentOutOfRangeException(
+                    nameof(titleBarType),
+                    titleBarType,
+                    null
+                ),
+            };
+        }
+
+        #endregion
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Events/IsPlayingChangedEventArgs.cs

@@ -0,0 +1,21 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+
+namespace BetterLyrics.WinUI3.Events
+{
+    /// <summary>
+    /// Defines the <see cref="IsPlayingChangedEventArgs" />
+    /// </summary>
+    public class IsPlayingChangedEventArgs(bool isPlaying) : EventArgs
+    {
+        #region Properties
+
+        /// <summary>
+        /// Gets or sets a value indicating whether IsPlaying
+        /// </summary>
+        public bool IsPlaying { get; set; } = isPlaying;
+
+        #endregion
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Events/LibChangedEventArgs.cs

@@ -0,0 +1,53 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Events
+{
+    /// <summary>
+    /// Defines the <see cref="LibChangedEventArgs" />
+    /// </summary>
+    public class LibChangedEventArgs : EventArgs
+    {
+        #region Constructors
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="LibChangedEventArgs"/> class.
+        /// </summary>
+        /// <param name="folder">The folder<see cref="string"/></param>
+        /// <param name="filePath">The filePath<see cref="string"/></param>
+        /// <param name="changeType">The changeType<see cref="WatcherChangeTypes"/></param>
+        public LibChangedEventArgs(string folder, string filePath, WatcherChangeTypes changeType)
+        {
+            Folder = folder;
+            FilePath = filePath;
+            ChangeType = changeType;
+        }
+
+        #endregion
+
+        #region Properties
+
+        /// <summary>
+        /// Gets the ChangeType
+        /// </summary>
+        public WatcherChangeTypes ChangeType { get; }
+
+        /// <summary>
+        /// Gets the FilePath
+        /// </summary>
+        public string FilePath { get; }
+
+        /// <summary>
+        /// Gets the Folder
+        /// </summary>
+        public string Folder { get; }
+
+        #endregion
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Events/PositionChangedEventArgs.cs

@@ -0,0 +1,21 @@
+// 2025/6/23 by Zhe Fang
+
+using System;
+
+namespace BetterLyrics.WinUI3.Events
+{
+    /// <summary>
+    /// Defines the <see cref="PositionChangedEventArgs" />
+    /// </summary>
+    public class PositionChangedEventArgs(TimeSpan position) : EventArgs()
+    {
+        #region Properties
+
+        /// <summary>
+        /// Gets or sets the Position
+        /// </summary>
+        public TimeSpan Position { get; set; } = position;
+
+        #endregion
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Events/SongInfoChangedEventArgs.cs

@@ -0,0 +1,26 @@
+// 2025/6/23 by Zhe Fang
+
+using BetterLyrics.WinUI3.Models;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace BetterLyrics.WinUI3.Events
+{
+    /// <summary>
+    /// Defines the <see cref="SongInfoChangedEventArgs" />
+    /// </summary>
+    public class SongInfoChangedEventArgs(SongInfo? songInfo) : EventArgs
+    {
+        #region Properties
+
+        /// <summary>
+        /// Gets or sets the SongInfo
+        /// </summary>
+        public SongInfo? SongInfo { get; set; } = songInfo;
+
+        #endregion
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/AnimationHelper.cs

@@ -1,44 +1,239 @@
-using Microsoft.UI.Xaml;
-using Microsoft.UI.Xaml.Media.Animation;
+// 2025/6/23 by Zhe Fang
+
 using System;
+using BetterLyrics.WinUI3.Enums;
 
-namespace BetterLyrics.WinUI3.Helper {
-
+namespace BetterLyrics.WinUI3.Helper
+{
     /// <summary>
-    /// Edited based on: https://stackoverflow.com/a/25236507/11048731
+    /// Defines the <see cref="AnimationHelper" />
     /// </summary>
-    public class AnimationHelper : DependencyObject {
-        public static int GetAnimationDuration(DependencyObject obj) {
-            return (int)obj.GetValue(AnimationDurationProperty);
-        }
+    public class AnimationHelper
+    {
+        #region Constants
 
-        public static void SetAnimationDuration(DependencyObject obj, int value) {
-            obj.SetValue(AnimationDurationProperty, value);
-        }
+        /// <summary>
+        /// Defines the DebounceDefaultDuration
+        /// </summary>
+        public const int DebounceDefaultDuration = 200;
 
-        // Using a DependencyProperty as the backing store for AnimationDuration.
-        // This enables animation, styling, binding, etc...
-        public static readonly DependencyProperty AnimationDurationProperty =
-            DependencyProperty.RegisterAttached("AnimationDuration", typeof(int),
-            typeof(AnimationHelper), new PropertyMetadata(0,
-            OnAnimationDurationChanged));
+        /// <summary>
+        /// Defines the StackedNotificationsShowingDuration
+        /// </summary>
+        public const int StackedNotificationsShowingDuration = 3900;
 
-        private static void OnAnimationDurationChanged(DependencyObject d,
-            DependencyPropertyChangedEventArgs e) {
-            FrameworkElement element = d as FrameworkElement;
+        /// <summary>
+        /// Defines the StoryboardDefaultDuration
+        /// </summary>
+        public const int StoryboardDefaultDuration = 200;
 
-            var ms = (int)e.NewValue;
-
-            if (ms < 0) return;
-
-            var key = "LyricsLineCharGradientInTextBlock";
-            foreach (var timeline in (element.Resources[key] as Storyboard).Children) {
-                foreach (var keyFrame in (timeline as DoubleAnimationUsingKeyFrames).KeyFrames) {
-                    (keyFrame as LinearDoubleKeyFrame).KeyTime =
-                        KeyTime.FromTimeSpan(TimeSpan.FromMilliseconds(ms));
-                }
-            }
-        }
+        #endregion
     }
 
+    /// <summary>
+    /// Defines the <see cref="ValueTransition{T}" />
+    /// </summary>
+    /// <typeparam name="T"></typeparam>
+    public class ValueTransition<T>
+        where T : struct
+    {
+        #region Fields
+
+        /// <summary>
+        /// Defines the _currentValue
+        /// </summary>
+        private T _currentValue;
+
+        /// <summary>
+        /// Defines the _durationSeconds
+        /// </summary>
+        private float _durationSeconds;
+
+        /// <summary>
+        /// Defines the _interpolator
+        /// </summary>
+        private Func<T, T, float, T> _interpolator;
+
+        /// <summary>
+        /// Defines the _isTransitioning
+        /// </summary>
+        private bool _isTransitioning;
+
+        /// <summary>
+        /// Defines the _progress
+        /// </summary>
+        private float _progress;
+
+        /// <summary>
+        /// Defines the _startValue
+        /// </summary>
+        private T _startValue;
+
+        /// <summary>
+        /// Defines the _targetValue
+        /// </summary>
+        private T _targetValue;
+
+        private EasingType? _easingType;
+
+        #endregion
+
+        #region Constructors
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ValueTransition{T}"/> class.
+        /// </summary>
+        /// <param name="initialValue">The initialValue<see cref="T"/></param>
+        /// <param name="durationSeconds">The durationSeconds<see cref="float"/></param>
+        /// <param name="interpolator">The interpolator<see cref="Func{T, T, float, T}"/></param>
+        public ValueTransition(
+            T initialValue,
+            float durationSeconds,
+            Func<T, T, float, T>? interpolator = null,
+            EasingType? easingType = null
+        )
+        {
+            _currentValue = initialValue;
+            _startValue = initialValue;
+            _targetValue = initialValue;
+            _durationSeconds = durationSeconds;
+            _progress = 1f;
+            _isTransitioning = false;
+
+            if (interpolator != null)
+            {
+                _interpolator = interpolator;
+                _easingType = null;
+            }
+            else if (easingType.HasValue)
+            {
+                _easingType = easingType;
+                _interpolator = GetInterpolatorByEasingType(easingType.Value);
+            }
+            else
+            {
+                _interpolator = GetInterpolatorByEasingType(EasingType.Linear);
+                _easingType = EasingType.Linear;
+            }
+        }
+
+        #endregion
+
+        #region Properties
+
+        /// <summary>
+        /// Gets a value indicating whether IsTransitioning
+        /// </summary>
+        public bool IsTransitioning => _isTransitioning;
+
+        /// <summary>
+        /// Gets the Value
+        /// </summary>
+        public T Value => _currentValue;
+
+        #endregion
+
+        #region Methods
+
+        private Func<T, T, float, T> GetInterpolatorByEasingType(EasingType type)
+        {
+            // 这里只以float为例，实际可根据T类型扩展
+            if (typeof(T) == typeof(float))
+            {
+                return (start, end, progress) =>
+                {
+                    float s = (float)(object)start;
+                    float e = (float)(object)end;
+                    float t = progress;
+                    switch (type)
+                    {
+                        case EasingType.EaseInOutQuad:
+                            t = EasingHelper.EaseInOutQuad(t);
+                            break;
+                        case EasingType.EaseInQuad:
+                            t = EasingHelper.EaseInQuad(t);
+                            break;
+                        case EasingType.EaseOutQuad:
+                            t = EasingHelper.EaseOutQuad(t);
+                            break;
+                        case EasingType.Linear:
+                            t = EasingHelper.Linear(t);
+                            break;
+                        case EasingType.SmootherStep:
+                            t = EasingHelper.SmootherStep(t);
+                            break;
+                        default:
+                            break;
+                    }
+                    return (T)(object)(s + (e - s) * t);
+                };
+            }
+            throw new NotSupportedException("当前类型未实现默认缓动插值");
+        }
+
+        /// <summary>
+        /// The Reset
+        /// </summary>
+        /// <param name="value">The value<see cref="T"/></param>
+        public void Reset(T value)
+        {
+            _currentValue = value;
+            _startValue = value;
+            _targetValue = value;
+            _progress = 0f;
+            _isTransitioning = false;
+        }
+
+        /// <summary>
+        /// The StartTransition
+        /// </summary>
+        /// <param name="targetValue">The targetValue<see cref="T"/></param>
+        public void StartTransition(T targetValue)
+        {
+            if (!targetValue.Equals(_currentValue))
+            {
+                _startValue = _currentValue;
+                _targetValue = targetValue;
+                _progress = 0f;
+                _isTransitioning = true;
+            }
+        }
+
+        /// <summary>
+        /// 立即跳转到指定值，无动画
+        /// </summary>
+        /// <param name="value">目标值</param>
+        public void JumpTo(T value)
+        {
+            _currentValue = value;
+            _startValue = value;
+            _targetValue = value;
+            _progress = 1f;
+            _isTransitioning = false;
+        }
+
+        /// <summary>
+        /// The Update
+        /// </summary>
+        /// <param name="elapsedTime">The elapsedTime<see cref="TimeSpan"/></param>
+        public void Update(TimeSpan elapsedTime)
+        {
+            if (!_isTransitioning)
+                return;
+
+            _progress += (float)elapsedTime.TotalSeconds / _durationSeconds;
+            if (_progress >= 1f)
+            {
+                _progress = 1f;
+                _currentValue = _targetValue;
+                _isTransitioning = false;
+            }
+            else
+            {
+                _currentValue = _interpolator(_startValue, _targetValue, _progress);
+            }
+        }
+
+        #endregion
+    }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/AppInfo.cs

@@ -0,0 +1,131 @@
+// 2025/6/23 by Zhe Fang
+
+namespace BetterLyrics.WinUI3.Helper
+{
+    using System.IO;
+    using Windows.ApplicationModel;
+    using Windows.Storage;
+
+    /// <summary>
+    /// Defines the <see cref="AppInfo" />
+    /// </summary>
+    public static class AppInfo
+    {
+        #region Constants
+
+        /// <summary>
+        /// Defines the AppAuthor
+        /// </summary>
+        public const string AppAuthor = "Zhe Fang";
+
+        /// <summary>
+        /// Defines the AppDisplayName
+        /// </summary>
+        public const string AppDisplayName = "Better Lyrics";
+
+        // App Metadata
+
+        /// <summary>
+        /// Defines the AppName
+        /// </summary>
+        public const string AppName = "BetterLyrics";
+
+        /// <summary>
+        /// Defines the GithubUrl
+        /// </summary>
+        public const string GithubUrl = "https://github.com/jayfunc/BetterLyrics";
+
+        #endregion
+
+        #region Properties
+
+        /// <summary>
+        /// Gets the AppVersion
+        /// </summary>
+        public static string AppVersion
+        {
+            get
+            {
+                var version = Package.Current.Id.Version;
+                return $"{version.Major}.{version.Minor}.{version.Build}.{version.Revision}";
+            }
+        }
+
+        /// <summary>
+        /// Gets the AssetsFolder
+        /// </summary>
+        public static string AssetsFolder => Path.Combine(Package.Current.InstalledPath, "Assets");
+
+        /// <summary>
+        /// Gets the CacheFolder
+        /// </summary>
+        public static string CacheFolder => ApplicationData.Current.LocalCacheFolder.Path;
+
+        // Environment Info
+
+        // Data Files
+
+        /// <summary>
+        /// Gets the LogDirectory
+        /// </summary>
+        public static string LogDirectory => Path.Combine(CacheFolder, "logs");
+
+        /// <summary>
+        /// Gets the LogFilePattern
+        /// </summary>
+        public static string LogFilePattern => Path.Combine(LogDirectory, "log-.txt");
+
+        /// <summary>
+        /// Gets the OnlineLyricsCacheDirectory
+        /// </summary>
+        public static string LrcLibLyricsCacheDirectory =>
+            Path.Combine(CacheFolder, "lrclib-lyrics");
+
+        public static string AmllTtmlDbLyricsCacheDirectory =>
+            Path.Combine(CacheFolder, "amll-ttml-db-lyrics");
+        public static string QQLyricsCacheDirectory => Path.Combine(CacheFolder, "qq-lyrics");
+        public static string KugouLyricsCacheDirectory => Path.Combine(CacheFolder, "kugou-lyrics");
+        public static string NeteaseLyricsCacheDirectory =>
+            Path.Combine(CacheFolder, "netease-lyrics");
+
+        public static string AmllTtmlDbIndexPath =>
+            Path.Combine(CacheFolder, "amll-ttml-db-index.json");
+
+        /// <summary>
+        /// Gets the TestMusicPath
+        /// </summary>
+        public static string TestMusicPath => Path.Combine(AssetsFolder, TestMusicFileName);
+
+        // Base Folders
+
+        /// <summary>
+        /// Gets the LocalFolder
+        /// </summary>
+        private static string LocalFolder => ApplicationData.Current.LocalFolder.Path;
+
+        /// <summary>
+        /// Gets the TestMusicFileName
+        /// </summary>
+        private static string TestMusicFileName => "AI - 甜度爆表.mp3";
+
+        #endregion
+
+        #region Methods
+
+        /// <summary>
+        /// The EnsureDirectories
+        /// </summary>
+        public static void EnsureDirectories()
+        {
+            Directory.CreateDirectory(LocalFolder);
+            Directory.CreateDirectory(LogDirectory);
+            Directory.CreateDirectory(LrcLibLyricsCacheDirectory);
+            Directory.CreateDirectory(QQLyricsCacheDirectory);
+            Directory.CreateDirectory(KugouLyricsCacheDirectory);
+            Directory.CreateDirectory(NeteaseLyricsCacheDirectory);
+            Directory.CreateDirectory(AmllTtmlDbLyricsCacheDirectory);
+        }
+
+        #endregion
+    }
+}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/CollectionHelper.cs

@@ -1,15 +1,34 @@
-using System;
+// 2025/6/23 by Zhe Fang
+
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Text;
 using System.Threading.Tasks;
 
-namespace BetterLyrics.WinUI3.Helper {
-    public static class CollectionHelper {
-        public static T? SafeGet<T>(this IList<T> list, int index) {
+namespace BetterLyrics.WinUI3.Helper
+{
+    /// <summary>
+    /// Defines the <see cref="CollectionHelper" />
+    /// </summary>
+    public static class CollectionHelper
+    {
+        #region Methods
+
+        /// <summary>
+        /// The SafeGet
+        /// </summary>
+        /// <typeparam name="T"></typeparam>
+        /// <param name="list">The list<see cref="IList{T}"/></param>
+        /// <param name="index">The index<see cref="int"/></param>
+        /// <returns>The <see cref="T?"/></returns>
+        public static T? SafeGet<T>(this IList<T> list, int index)
+        {
             if (list == null || index < 0 || index >= list.Count)
                 return default;
             return list[index];
         }
+
+        #endregion
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/ColorHelper.cs

@@ -1,12 +1,48 @@
-namespace BetterLyrics.WinUI3.Helper {
-    public class ColorHelper {
-        public static Windows.UI.Color LerpColor(Windows.UI.Color a, Windows.UI.Color b, double t) {
-            byte A = (byte)(a.A + (b.A - a.A) * t);
-            byte R = (byte)(a.R + (b.R - a.R) * t);
-            byte G = (byte)(a.G + (b.G - a.G) * t);
-            byte B = (byte)(a.B + (b.B - a.B) * t);
-            return Windows.UI.Color.FromArgb(A, R, G, B);
+// 2025/6/23 by Zhe Fang
+
+using Windows.UI;
+
+namespace BetterLyrics.WinUI3.Helper
+{
+    /// <summary>
+    /// Defines the <see cref="ColorHelper" />
+    /// </summary>
+    public static class ColorHelper
+    {
+        #region Methods
+
+        /// <summary>
+        /// The GetInterpolatedColor
+        /// </summary>
+        /// <param name="progress">The progress<see cref="float"/></param>
+        /// <param name="startColor">The startColor<see cref="Color"/></param>
+        /// <param name="targetColor">The targetColor<see cref="Color"/></param>
+        /// <returns>The <see cref="Color"/></returns>
+        public static Color GetInterpolatedColor(
+            float progress,
+            Color startColor,
+            Color targetColor
+        )
+        {
+            byte Lerp(byte a, byte b) => (byte)(a + (progress * (b - a)));
+            return Color.FromArgb(
+                Lerp(startColor.A, targetColor.A),
+                Lerp(startColor.R, targetColor.R),
+                Lerp(startColor.G, targetColor.G),
+                Lerp(startColor.B, targetColor.B)
+            );
         }
 
+        /// <summary>
+        /// The ToWindowsUIColor
+        /// </summary>
+        /// <param name="color">The color<see cref="System.Drawing.Color"/></param>
+        /// <returns>The <see cref="Windows.UI.Color"/></returns>
+        public static Windows.UI.Color ToWindowsUIColor(this System.Drawing.Color color)
+        {
+            return Windows.UI.Color.FromArgb(color.A, color.R, color.G, color.B);
+        }
+
+        #endregion
     }
 }

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/DatabaseHelper.cs

@@ -1,21 +0,0 @@
-using BetterLyrics.WinUI3.Models;
-using SQLite;
-using System;
-using System.Collections.Generic;
-using System.IO;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace BetterLyrics.WinUI3.Helper {
-    public class DatabaseHelper {
-        private static SQLiteConnection _database;
-
-        public static SQLiteConnection InitializeDatabase() {
-            string dbPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "MusicMetadataIndex.db");
-            _database = new SQLiteConnection(dbPath);
-            _database.CreateTable<MetadataIndex>(); // Create table if it doesn't exist
-            return _database;
-        }
-    }
-}

BetterLyrics.WinUI3/BetterLyrics.WinUI3/Helper/DesktopModeHelper.cs

@@ -0,0 +1,165 @@
+using System;
+using System.Collections.Generic;
+using System.Runtime.InteropServices;
+using Microsoft.UI.Xaml;
+using WinRT.Interop;
+using WinUIEx;
+
+namespace BetterLyrics.WinUI3.Helper
+{
+    public static class DesktopModeHelper
+    {
+        private static readonly Dictionary<IntPtr, WindowStyle> _originalWindowStyles = [];
+        private static readonly Dictionary<IntPtr, bool> _clickThroughStates = [];
+        private static readonly Dictionary<IntPtr, bool> _originalTopmostStates = [];
+        private static readonly Dictionary<
+            IntPtr,
+            (double X, double Y, double Width, double Height)
+        > _originalWindowBounds = [];
+
+        // <20><><EFBFBD>໯<EFBFBD><E0BBAF><EFBFBD><EFBFBD>
+        private delegate nint WndProcDelegate(nint hWnd, uint msg, nint wParam, nint lParam);
+
+        public static void Enable(Window window)
+        {
+            IntPtr hwnd = WindowNative.GetWindowHandle(window);
+
+            // <20><>¼ԭʼ<D4AD><CABC><EFBFBD><EFBFBD>λ<EFBFBD>úʹ<C3BA>С
+            var windowManager = WindowManager.Get(window);
+            if (!_originalWindowBounds.ContainsKey(hwnd))
+            {
+                _originalWindowBounds[hwnd] = (
+                    windowManager.AppWindow.Position.X,
+                    windowManager.AppWindow.Position.Y,
+                    windowManager.Width,
+                    windowManager.Height
+                );
+            }
+
+            // <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD>Ļ<EFBFBD><C4BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
+            var displayArea = Microsoft.UI.Windowing.DisplayArea.GetFromWindowId(
+                windowManager.AppWindow.Id,
+                Microsoft.UI.Windowing.DisplayAreaFallback.Primary
+            );
+            var workArea = displayArea.WorkArea;
+
+            // <20><><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD><EFBFBD><EFBFBD>ߺ<EFBFBD>λ<EFBFBD><CEBB>
+            int targetWidth = workArea.Width / 3;
+            int targetHeight = workArea.Height / 4;
+            int targetX = workArea.X + (workArea.Width - targetWidth) / 2; // <20><><EFBFBD><EFBFBD>
+            int targetY = workArea.Y + workArea.Height - targetHeight - 64;
+
+            // <20><><EFBFBD>ô<EFBFBD><C3B4>ڴ<EFBFBD>С<EFBFBD><D0A1>λ<EFBFBD><CEBB>
+            windowManager.AppWindow.MoveAndResize(
+                new Windows.Graphics.RectInt32(targetX, targetY, targetWidth, targetHeight)
+            );
+
+            // <20><><EFBFBD><EFBFBD>ԭ<EFBFBD><D4AD>ʽ
+            if (!_originalWindowStyles.ContainsKey(hwnd))
+                _originalWindowStyles[hwnd] = window.GetWindowStyle();
+
+            // <20><><EFBFBD><EFBFBD>ԭTopMost״̬
+            if (!_originalTopmostStates.ContainsKey(hwnd))
+                _originalTopmostStates[hwnd] = window.GetIsAlwaysOnTop();
+
+            // <20><><EFBFBD>ô<EFBFBD><C3B4><EFBFBD><EFBFBD>ö<EFBFBD>
+            window.SetIsAlwaysOnTop(true);
+
+            window.SetIsShownInSwitchers(false);
+        }
+
+        public static void Disable(Window window)
+        {
+            IntPtr hwnd = WindowNative.GetWindowHandle(window);
+
+            // <20>ָ<EFBFBD>TopMost״̬
+            if (_originalTopmostStates.TryGetValue(hwnd, out var wasTopMost))
+            {
+                window.SetIsAlwaysOnTop(wasTopMost);
+                _originalTopmostStates.Remove(hwnd);
+            }
+
+            // <20>ָ<EFBFBD><D6B8><EFBFBD><EFBFBD><EFBFBD>λ<EFBFBD>úʹ<C3BA>С
+            var windowManager = WindowManager.Get(window);
+            if (_originalWindowBounds.TryGetValue(hwnd, out var bounds))
+            {
+                windowManager.AppWindow.MoveAndResize(
+                    new Windows.Graphics.RectInt32(
+                        (int)bounds.X,
+                        (int)bounds.Y,
+                        (int)bounds.Width,
+                        (int)bounds.Height
+                    )
+                );
+                _originalWindowBounds.Remove(hwnd);
+            }
+
+            // <20>ָ<EFBFBD><D6B8><EFBFBD>ʽ
+            if (_originalWindowStyles.TryGetValue(hwnd, out var style))
+            {
+                window.SetWindowStyle(style);
+                _originalWindowStyles.Remove(hwnd);
+            }
+
+            window.SetIsShownInSwitchers(true);
+        }
+
+        public static void Lock(Window window)
+        {
+            IntPtr hwnd = WindowNative.GetWindowHandle(window);
+
+            // <20><><EFBFBD><EFBFBD><EFBFBD>ޱ߿<DEB1><DFBF><EFBFBD>͸<EFBFBD><CDB8>
+            window.SetWindowStyle(WindowStyle.Popup | WindowStyle.Visible);
+            window.ExtendsContentIntoTitleBar = false;
+
+            SetClickThrough(window, true);
+        }
+
+        public static void Unlock(Window window)
+        {
+            IntPtr hwnd = WindowNative.GetWindowHandle(window);
+
+            // <20>ָ<EFBFBD><D6B8><EFBFBD>ʽ<EFBFBD><CABD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ƴ<EFBFBD><C6B3><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʽ<EFBFBD><CABD>ֻ<EFBFBD><D6BB><EFBFBD><EFBFBD> Disable ʱ<><CAB1><EFBFBD>Ƴ<EFBFBD><C6B3><EFBFBD>
+            if (_originalWindowStyles.TryGetValue(hwnd, out var style))
+            {
+                window.SetWindowStyle(style);
+            }
+            window.ExtendsContentIntoTitleBar = true;
+
+            SetClickThrough(window, false);
+        }
+
+        /// <summary>
+        /// <20>л<EFBFBD><D0BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>͸״̬
+        /// </summary>
+        public static void SetClickThrough(Window window, bool enable)
+        {
+            IntPtr hwnd = WindowNative.GetWindowHandle(window);
+            int exStyle = GetWindowLong(hwnd, GWL_EXSTYLE);
+            if (enable)
+            {
+                SetWindowLong(hwnd, GWL_EXSTYLE, exStyle | WS_EX_TRANSPARENT | WS_EX_LAYERED);
+                _clickThroughStates[hwnd] = true;
+            }
+            else
+            {
+                SetWindowLong(hwnd, GWL_EXSTYLE, exStyle & ~WS_EX_TRANSPARENT);
+                _clickThroughStates[hwnd] = false;
+            }
+        }
+
+        #region Win32
+
+        private const int GWL_EXSTYLE = -20;
+        private const int WS_EX_TRANSPARENT = 0x00000020;
+        private const int WS_EX_LAYERED = 0x00080000;
+
+        [DllImport("user32.dll", SetLastError = true)]
+        private static extern int GetWindowLong(IntPtr hWnd, int nIndex);
+
+        [DllImport("user32.dll", SetLastError = true)]
+        private static extern int SetWindowLong(IntPtr hWnd, int nIndex, int dwNewLong);
+
+        #endregion
+    }
+}