0.5.10

多线程
2026-06-22 17:24:27 +08:00 · 2026-03-10 14:56:05 +08:00
parent 85f7a18cbc
commit 4df740e3df
30 changed files with 1134 additions and 1548 deletions
--- a/LanMountainDesktop/Localization/en-US.json
+++ b/LanMountainDesktop/Localization/en-US.json
@@ -338,10 +338,10 @@
    "settings.plugins.source_manifest":  "Loose manifest",
    "settings.plugins.subtitle_format":  "{0} | {1} | {2}",
    "settings.plugins.detail_format":  "Settings pages: {0} | Widgets: {1}",
-    "settings.plugins.market_header":  "Official Market",
-    "settings.plugins.market_desc":  "Browse plugins from the official LanAirApp source and stage installs.",
-    "settings.plugins.market_hint":  "Use the official market source hosted in LanAirApp to discover and stage plugin installs.",
-    "settings.plugins.market_unavailable":  "Plugin runtime is not available, so the official market cannot be opened right now.",
+    "settings.nav.plugin_market":  "Plugin Market",
+    "settings.plugin_market.title":  "Plugin Market",
+    "settings.plugin_market.subtitle":  "Browse plugins from the official LanAirApp source and stage installs.",
+    "settings.plugin_market.unavailable":  "Plugin runtime is not available, so the official market cannot be opened right now.",
    "market.toolbar.search_placeholder":  "Search plugins",
    "market.toolbar.refresh":  "Refresh",
    "market.status.loading":  "Loading the official plugin market...",
--- a/LanMountainDesktop/Localization/zh-CN.json
+++ b/LanMountainDesktop/Localization/zh-CN.json
@@ -338,10 +338,10 @@
    "settings.plugins.source_manifest":  "散装清单",
    "settings.plugins.subtitle_format":  "{0} | {1} | {2}",
    "settings.plugins.detail_format":  "设置页：{0} | 组件：{1}",
-    "settings.plugins.market_header":  "官方市场",
-    "settings.plugins.market_desc":  "浏览来自 LanAirApp 官方源的插件，并将安装暂存到本地。",
-    "settings.plugins.market_hint":  "这里使用托管在 LanAirApp 仓库中的官方市场索引来发现插件并暂存安装。",
-    "settings.plugins.market_unavailable":  "插件运行时不可用，暂时无法打开官方市场。",
+    "settings.nav.plugin_market":  "插件市场",
+    "settings.plugin_market.title":  "插件市场",
+    "settings.plugin_market.subtitle":  "浏览来自 LanAirApp 官方源的插件，并将安装暂存到本地。",
+    "settings.plugin_market.unavailable":  "插件运行时不可用，暂时无法打开官方市场。",
    "market.toolbar.search_placeholder":  "搜索插件",
    "market.toolbar.refresh":  "刷新",
    "market.status.loading":  "正在加载官方插件市场...",
--- a/LanMountainDesktop/Services/GitHubReleaseUpdateService.cs
+++ b/LanMountainDesktop/Services/GitHubReleaseUpdateService.cs
@@ -45,6 +45,7 @@ public sealed class GitHubReleaseUpdateService : IDisposable
    private readonly string _owner;
    private readonly string _repo;
    private readonly HttpClient _httpClient;
+    private readonly ResumableDownloadService _downloadService;
    private readonly bool _ownsHttpClient;

    public GitHubReleaseUpdateService(
@@ -69,6 +70,8 @@ public sealed class GitHubReleaseUpdateService : IDisposable
            _ownsHttpClient = false;
        }

+        _downloadService = new ResumableDownloadService(_httpClient);
+
        if (!_httpClient.DefaultRequestHeaders.UserAgent.Any())
        {
            _httpClient.DefaultRequestHeaders.UserAgent.ParseAdd("LanMountainDesktop-Updater/1.0");
@@ -187,59 +190,20 @@ public sealed class GitHubReleaseUpdateService : IDisposable
            return new UpdateDownloadResult(false, null, "Destination file path is empty.");
        }

-        try
-        {
-            var directory = Path.GetDirectoryName(destinationFilePath);
-            if (!string.IsNullOrWhiteSpace(directory))
-            {
-                Directory.CreateDirectory(directory);
-            }
+        var progressAdapter = progress is null
+            ? null
+            : new Progress<DownloadProgressInfo>(info => progress.Report(info.Progress));

-            using var response = await _httpClient.GetAsync(
-                asset.BrowserDownloadUrl,
-                HttpCompletionOption.ResponseHeadersRead,
-                cancellationToken);
+        var result = await _downloadService.DownloadAsync(
+            asset.BrowserDownloadUrl,
+            destinationFilePath,
+            new DownloadOptions(ExpectedSizeBytes: asset.SizeBytes > 0 ? asset.SizeBytes : null),
+            progressAdapter,
+            cancellationToken);

-            if (!response.IsSuccessStatusCode)
-            {
-                return new UpdateDownloadResult(
-                    false,
-                    null,
-                    $"HTTP {(int)response.StatusCode}: {response.ReasonPhrase}");
-            }
-
-            var contentLength = response.Content.Headers.ContentLength ??
-                                (asset.SizeBytes > 0 ? asset.SizeBytes : -1);
-
-            await using var sourceStream = await response.Content.ReadAsStreamAsync(cancellationToken);
-            await using var destinationStream = File.Create(destinationFilePath);
-
-            var buffer = new byte[81920];
-            long totalRead = 0;
-            int read;
-            while ((read = await sourceStream.ReadAsync(buffer, cancellationToken)) > 0)
-            {
-                await destinationStream.WriteAsync(buffer.AsMemory(0, read), cancellationToken);
-                totalRead += read;
-
-                if (contentLength > 0)
-                {
-                    progress?.Report(Math.Clamp(totalRead / (double)contentLength, 0d, 1d));
-                }
-            }
-
-            progress?.Report(1d);
-
-            return new UpdateDownloadResult(true, destinationFilePath, null);
-        }
-        catch (OperationCanceledException)
-        {
-            throw;
-        }
-        catch (Exception ex)
-        {
-            return new UpdateDownloadResult(false, null, ex.Message);
-        }
+        return result.Success
+            ? new UpdateDownloadResult(true, result.FilePath ?? destinationFilePath, null)
+            : new UpdateDownloadResult(false, null, result.ErrorMessage);
    }

    public async Task<GitHubReleaseInfo?> GetReleaseByTagAsync(
--- a/LanMountainDesktop/Services/ResumableDownloadService.cs
+++ b/LanMountainDesktop/Services/ResumableDownloadService.cs
@@ -0,0 +1,940 @@
+using System;
+using System.Buffers;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Net;
+using System.Net.Http;
+using System.Net.Http.Headers;
+using System.Text.Json;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace LanMountainDesktop.Services;
+
+public sealed record DownloadProgressInfo(
+    long DownloadedBytes,
+    long? TotalBytes,
+    double Progress,
+    bool IsResuming,
+    bool IsParallel);
+
+public sealed record DownloadOptions(
+    long? ExpectedSizeBytes = null,
+    int MaxParallelSegments = 4,
+    int ParallelThresholdBytes = 8 * 1024 * 1024,
+    int BufferSize = 128 * 1024);
+
+public sealed record DownloadResult(
+    bool Success,
+    string? FilePath,
+    string? ErrorMessage,
+    bool UsedResume,
+    bool UsedParallelDownload);
+
+public sealed class ResumableDownloadService
+{
+    private static readonly JsonSerializerOptions MetadataSerializerOptions = new()
+    {
+        WriteIndented = false
+    };
+
+    private readonly HttpClient _httpClient;
+
+    public ResumableDownloadService(HttpClient httpClient)
+    {
+        _httpClient = httpClient ?? throw new ArgumentNullException(nameof(httpClient));
+    }
+
+    public async Task<DownloadResult> DownloadAsync(
+        string source,
+        string destinationFilePath,
+        DownloadOptions? options = null,
+        IProgress<DownloadProgressInfo>? progress = null,
+        CancellationToken cancellationToken = default)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(source);
+        ArgumentException.ThrowIfNullOrWhiteSpace(destinationFilePath);
+
+        var normalizedOptions = NormalizeOptions(options);
+        try
+        {
+            if (File.Exists(source))
+            {
+                return await CopyLocalFileAsync(
+                    source,
+                    destinationFilePath,
+                    normalizedOptions,
+                    progress,
+                    cancellationToken);
+            }
+
+            if (!Uri.TryCreate(source, UriKind.Absolute, out var sourceUri) ||
+                (sourceUri.Scheme != Uri.UriSchemeHttp && sourceUri.Scheme != Uri.UriSchemeHttps))
+            {
+                return new DownloadResult(false, null, $"Unsupported download source '{source}'.", false, false);
+            }
+
+            return await DownloadRemoteFileAsync(
+                sourceUri,
+                destinationFilePath,
+                normalizedOptions,
+                progress,
+                cancellationToken);
+        }
+        catch (OperationCanceledException)
+        {
+            throw;
+        }
+        catch (Exception ex)
+        {
+            return new DownloadResult(false, null, ex.Message, false, false);
+        }
+    }
+
+    private async Task<DownloadResult> CopyLocalFileAsync(
+        string sourceFilePath,
+        string destinationFilePath,
+        DownloadOptions options,
+        IProgress<DownloadProgressInfo>? progress,
+        CancellationToken cancellationToken)
+    {
+        var fullSourcePath = Path.GetFullPath(sourceFilePath);
+        var fullDestinationPath = Path.GetFullPath(destinationFilePath);
+        var totalBytes = new FileInfo(fullSourcePath).Length;
+
+        var tempFilePath = BuildTempFilePath(fullDestinationPath);
+        var metadataFilePath = BuildMetadataFilePath(fullDestinationPath);
+        PrepareDestination(fullDestinationPath);
+
+        if (CanReuseCompletedDestination(fullDestinationPath, totalBytes))
+        {
+            progress?.Report(new DownloadProgressInfo(totalBytes, totalBytes, 1d, false, false));
+            CleanupPartialArtifacts(tempFilePath, metadataFilePath);
+            return new DownloadResult(true, fullDestinationPath, null, false, false);
+        }
+
+        long existingBytes = 0;
+        if (File.Exists(tempFilePath))
+        {
+            existingBytes = new FileInfo(tempFilePath).Length;
+            if (existingBytes > totalBytes)
+            {
+                ResetPartialArtifacts(tempFilePath, metadataFilePath);
+                existingBytes = 0;
+            }
+        }
+
+        if (!File.Exists(tempFilePath))
+        {
+            await using var tempCreateStream = new FileStream(
+                tempFilePath,
+                FileMode.Create,
+                FileAccess.Write,
+                FileShare.Read,
+                options.BufferSize,
+                FileOptions.Asynchronous | FileOptions.SequentialScan);
+        }
+
+        if (existingBytes >= totalBytes)
+        {
+            CompleteDownload(tempFilePath, fullDestinationPath, metadataFilePath);
+            progress?.Report(new DownloadProgressInfo(totalBytes, totalBytes, 1d, existingBytes > 0, false));
+            return new DownloadResult(true, fullDestinationPath, null, existingBytes > 0, false);
+        }
+
+        await using var sourceStream = new FileStream(
+            fullSourcePath,
+            FileMode.Open,
+            FileAccess.Read,
+            FileShare.Read,
+            options.BufferSize,
+            FileOptions.Asynchronous | FileOptions.SequentialScan);
+        await using var destinationStream = new FileStream(
+            tempFilePath,
+            FileMode.Open,
+            FileAccess.Write,
+            FileShare.Read,
+            options.BufferSize,
+            FileOptions.Asynchronous | FileOptions.SequentialScan);
+
+        if (existingBytes > 0)
+        {
+            sourceStream.Seek(existingBytes, SeekOrigin.Begin);
+            destinationStream.Seek(existingBytes, SeekOrigin.Begin);
+        }
+
+        await CopyStreamAsync(
+            sourceStream,
+            destinationStream,
+            existingBytes,
+            totalBytes,
+            isResuming: existingBytes > 0,
+            isParallel: false,
+            options.BufferSize,
+            progress,
+            cancellationToken);
+
+        CompleteDownload(tempFilePath, fullDestinationPath, metadataFilePath);
+        return new DownloadResult(true, fullDestinationPath, null, existingBytes > 0, false);
+    }
+
+    private async Task<DownloadResult> DownloadRemoteFileAsync(
+        Uri sourceUri,
+        string destinationFilePath,
+        DownloadOptions options,
+        IProgress<DownloadProgressInfo>? progress,
+        CancellationToken cancellationToken)
+    {
+        var fullDestinationPath = Path.GetFullPath(destinationFilePath);
+        var tempFilePath = BuildTempFilePath(fullDestinationPath);
+        var metadataFilePath = BuildMetadataFilePath(fullDestinationPath);
+        PrepareDestination(fullDestinationPath);
+
+        var probe = await ProbeRemoteFileAsync(sourceUri, cancellationToken);
+        var totalBytes = probe.TotalBytes ?? options.ExpectedSizeBytes;
+        if (CanReuseCompletedDestination(fullDestinationPath, totalBytes))
+        {
+            progress?.Report(new DownloadProgressInfo(
+                totalBytes ?? new FileInfo(fullDestinationPath).Length,
+                totalBytes,
+                1d,
+                false,
+                false));
+            CleanupPartialArtifacts(tempFilePath, metadataFilePath);
+            return new DownloadResult(true, fullDestinationPath, null, false, false);
+        }
+
+        var canUseParallel = probe.SupportsRanges &&
+                             totalBytes is > 0 &&
+                             totalBytes.Value >= options.ParallelThresholdBytes &&
+                             options.MaxParallelSegments > 1;
+
+        try
+        {
+            var result = canUseParallel
+                ? await DownloadRemoteInParallelAsync(
+                    sourceUri,
+                    fullDestinationPath,
+                    tempFilePath,
+                    metadataFilePath,
+                    totalBytes!.Value,
+                    options,
+                    progress,
+                    cancellationToken)
+                : await DownloadRemoteSequentiallyAsync(
+                    sourceUri,
+                    fullDestinationPath,
+                    tempFilePath,
+                    metadataFilePath,
+                    totalBytes,
+                    probe.SupportsRanges,
+                    options,
+                    progress,
+                    cancellationToken);
+
+            return result;
+        }
+        catch (RangeRequestNotSupportedException)
+        {
+            ResetPartialArtifacts(tempFilePath, metadataFilePath);
+            return await DownloadRemoteSequentiallyAsync(
+                sourceUri,
+                fullDestinationPath,
+                tempFilePath,
+                metadataFilePath,
+                totalBytes,
+                allowResume: false,
+                options,
+                progress,
+                cancellationToken);
+        }
+    }
+
+    private async Task<DownloadResult> DownloadRemoteSequentiallyAsync(
+        Uri sourceUri,
+        string destinationFilePath,
+        string tempFilePath,
+        string metadataFilePath,
+        long? totalBytes,
+        bool allowResume,
+        DownloadOptions options,
+        IProgress<DownloadProgressInfo>? progress,
+        CancellationToken cancellationToken)
+    {
+        long existingBytes = 0;
+        if (File.Exists(tempFilePath))
+        {
+            existingBytes = new FileInfo(tempFilePath).Length;
+            if (totalBytes is > 0 && existingBytes > totalBytes.Value)
+            {
+                ResetPartialArtifacts(tempFilePath, metadataFilePath);
+                existingBytes = 0;
+            }
+        }
+
+        if (!allowResume && existingBytes > 0)
+        {
+            ResetPartialArtifacts(tempFilePath, metadataFilePath);
+            existingBytes = 0;
+        }
+
+        if (totalBytes is > 0 && existingBytes >= totalBytes.Value)
+        {
+            CompleteDownload(tempFilePath, destinationFilePath, metadataFilePath);
+            progress?.Report(new DownloadProgressInfo(totalBytes.Value, totalBytes, 1d, existingBytes > 0, false));
+            return new DownloadResult(true, destinationFilePath, null, existingBytes > 0, false);
+        }
+
+        using var request = new HttpRequestMessage(HttpMethod.Get, sourceUri);
+        if (allowResume && existingBytes > 0)
+        {
+            request.Headers.Range = new RangeHeaderValue(existingBytes, null);
+        }
+
+        using var response = await _httpClient.SendAsync(
+            request,
+            HttpCompletionOption.ResponseHeadersRead,
+            cancellationToken);
+
+        if (allowResume && existingBytes > 0)
+        {
+            if (response.StatusCode == HttpStatusCode.RequestedRangeNotSatisfiable && totalBytes is > 0 && existingBytes == totalBytes)
+            {
+                CompleteDownload(tempFilePath, destinationFilePath, metadataFilePath);
+                progress?.Report(new DownloadProgressInfo(totalBytes.Value, totalBytes, 1d, true, false));
+                return new DownloadResult(true, destinationFilePath, null, true, false);
+            }
+
+            if (response.StatusCode != HttpStatusCode.PartialContent)
+            {
+                throw new RangeRequestNotSupportedException("The server did not honor the resume range request.");
+            }
+        }
+
+        response.EnsureSuccessStatusCode();
+
+        await using var sourceStream = await response.Content.ReadAsStreamAsync(cancellationToken);
+        await using var destinationStream = new FileStream(
+            tempFilePath,
+            existingBytes > 0 ? FileMode.Open : FileMode.Create,
+            FileAccess.Write,
+            FileShare.Read,
+            options.BufferSize,
+            FileOptions.Asynchronous | FileOptions.SequentialScan);
+
+        if (existingBytes > 0)
+        {
+            destinationStream.Seek(existingBytes, SeekOrigin.Begin);
+        }
+
+        var effectiveTotalBytes = totalBytes;
+        if (effectiveTotalBytes is null && response.Content.Headers.ContentLength is > 0)
+        {
+            effectiveTotalBytes = existingBytes + response.Content.Headers.ContentLength.Value;
+        }
+
+        await CopyStreamAsync(
+            sourceStream,
+            destinationStream,
+            existingBytes,
+            effectiveTotalBytes,
+            isResuming: existingBytes > 0,
+            isParallel: false,
+            options.BufferSize,
+            progress,
+            cancellationToken);
+
+        CompleteDownload(tempFilePath, destinationFilePath, metadataFilePath);
+        return new DownloadResult(true, destinationFilePath, null, existingBytes > 0, false);
+    }
+
+    private async Task<DownloadResult> DownloadRemoteInParallelAsync(
+        Uri sourceUri,
+        string destinationFilePath,
+        string tempFilePath,
+        string metadataFilePath,
+        long totalBytes,
+        DownloadOptions options,
+        IProgress<DownloadProgressInfo>? progress,
+        CancellationToken cancellationToken)
+    {
+        var requestedSegments = Math.Min(options.MaxParallelSegments, CalculateRecommendedSegments(totalBytes));
+        var metadata = await LoadOrCreateMetadataAsync(
+            sourceUri,
+            tempFilePath,
+            metadataFilePath,
+            totalBytes,
+            requestedSegments,
+            cancellationToken);
+
+        await using (var tempStream = new FileStream(
+                         tempFilePath,
+                         FileMode.OpenOrCreate,
+                         FileAccess.Write,
+                         FileShare.ReadWrite,
+                         options.BufferSize,
+                         FileOptions.Asynchronous | FileOptions.RandomAccess))
+        {
+            if (tempStream.Length != totalBytes)
+            {
+                tempStream.SetLength(totalBytes);
+            }
+        }
+
+        var initialDownloadedBytes = metadata.Segments.Sum(segment => segment.CompletedBytes);
+        ReportProgress(progress, initialDownloadedBytes, totalBytes, initialDownloadedBytes > 0, true);
+
+        if (initialDownloadedBytes >= totalBytes)
+        {
+            CompleteDownload(tempFilePath, destinationFilePath, metadataFilePath);
+            return new DownloadResult(true, destinationFilePath, null, initialDownloadedBytes > 0, true);
+        }
+
+        long downloadedBytes = initialDownloadedBytes;
+        var metadataWriter = new MetadataWriter(metadataFilePath, metadata);
+
+        try
+        {
+            var tasks = metadata.Segments
+                .Where(segment => segment.CompletedBytes < segment.Length)
+                .Select(segment => DownloadSegmentAsync(
+                    sourceUri,
+                    tempFilePath,
+                    segment,
+                    options.BufferSize,
+                    delta =>
+                    {
+                        var currentDownloaded = Interlocked.Add(ref downloadedBytes, delta);
+                        ReportProgress(progress, currentDownloaded, totalBytes, initialDownloadedBytes > 0, true);
+                    },
+                    metadataWriter,
+                    cancellationToken))
+                .ToArray();
+
+            await Task.WhenAll(tasks);
+            await metadataWriter.FlushAsync(cancellationToken);
+        }
+        catch
+        {
+            await metadataWriter.FlushAsync(cancellationToken);
+            throw;
+        }
+
+        CompleteDownload(tempFilePath, destinationFilePath, metadataFilePath);
+        ReportProgress(progress, totalBytes, totalBytes, initialDownloadedBytes > 0, true);
+        return new DownloadResult(true, destinationFilePath, null, initialDownloadedBytes > 0, true);
+    }
+
+    private async Task DownloadSegmentAsync(
+        Uri sourceUri,
+        string tempFilePath,
+        DownloadSegmentState segment,
+        int bufferSize,
+        Action<int> reportDownloadedBytes,
+        MetadataWriter metadataWriter,
+        CancellationToken cancellationToken)
+    {
+        var rangeStart = segment.Start + segment.CompletedBytes;
+        if (rangeStart > segment.EndInclusive)
+        {
+            return;
+        }
+
+        using var request = new HttpRequestMessage(HttpMethod.Get, sourceUri);
+        request.Headers.Range = new RangeHeaderValue(rangeStart, segment.EndInclusive);
+
+        using var response = await _httpClient.SendAsync(
+            request,
+            HttpCompletionOption.ResponseHeadersRead,
+            cancellationToken);
+
+        if (response.StatusCode != HttpStatusCode.PartialContent)
+        {
+            throw new RangeRequestNotSupportedException(
+                $"The server returned HTTP {(int)response.StatusCode} for range {rangeStart}-{segment.EndInclusive}.");
+        }
+
+        response.EnsureSuccessStatusCode();
+
+        var contentRange = response.Content.Headers.ContentRange;
+        if (contentRange?.From != rangeStart || contentRange.To != segment.EndInclusive)
+        {
+            throw new RangeRequestNotSupportedException("The server returned an unexpected content range.");
+        }
+
+        await using var sourceStream = await response.Content.ReadAsStreamAsync(cancellationToken);
+        await using var destinationStream = new FileStream(
+            tempFilePath,
+            FileMode.Open,
+            FileAccess.Write,
+            FileShare.ReadWrite,
+            bufferSize,
+            FileOptions.Asynchronous | FileOptions.RandomAccess);
+        destinationStream.Seek(rangeStart, SeekOrigin.Begin);
+
+        var buffer = ArrayPool<byte>.Shared.Rent(bufferSize);
+        try
+        {
+            while (segment.CompletedBytes < segment.Length)
+            {
+                var remainingBytes = segment.Length - segment.CompletedBytes;
+                var readSize = (int)Math.Min(buffer.Length, remainingBytes);
+                var read = await sourceStream.ReadAsync(buffer.AsMemory(0, readSize), cancellationToken);
+                if (read <= 0)
+                {
+                    throw new EndOfStreamException(
+                        $"Unexpected end of stream while downloading range {segment.Start}-{segment.EndInclusive}.");
+                }
+
+                await destinationStream.WriteAsync(buffer.AsMemory(0, read), cancellationToken);
+                segment.CompletedBytes += read;
+                reportDownloadedBytes(read);
+                metadataWriter.MarkDirty();
+            }
+        }
+        finally
+        {
+            ArrayPool<byte>.Shared.Return(buffer);
+        }
+    }
+
+    private async Task<RemoteProbeResult> ProbeRemoteFileAsync(Uri sourceUri, CancellationToken cancellationToken)
+    {
+        long? totalBytes = null;
+        var supportsRanges = false;
+
+        try
+        {
+            using var headRequest = new HttpRequestMessage(HttpMethod.Head, sourceUri);
+            using var headResponse = await _httpClient.SendAsync(
+                headRequest,
+                HttpCompletionOption.ResponseHeadersRead,
+                cancellationToken);
+
+            if (headResponse.IsSuccessStatusCode)
+            {
+                totalBytes = headResponse.Content.Headers.ContentLength;
+                supportsRanges = headResponse.Headers.AcceptRanges.Any(
+                    value => string.Equals(value, "bytes", StringComparison.OrdinalIgnoreCase));
+            }
+        }
+        catch
+        {
+            // Fall back to a small range probe when HEAD is unsupported or blocked.
+        }
+
+        if (supportsRanges && totalBytes is > 0)
+        {
+            return new RemoteProbeResult(totalBytes, true);
+        }
+
+        using var rangeRequest = new HttpRequestMessage(HttpMethod.Get, sourceUri);
+        rangeRequest.Headers.Range = new RangeHeaderValue(0, 0);
+
+        using var rangeResponse = await _httpClient.SendAsync(
+            rangeRequest,
+            HttpCompletionOption.ResponseHeadersRead,
+            cancellationToken);
+
+        if (rangeResponse.StatusCode == HttpStatusCode.PartialContent)
+        {
+            totalBytes = rangeResponse.Content.Headers.ContentRange?.Length ?? totalBytes;
+            return new RemoteProbeResult(totalBytes, true);
+        }
+
+        rangeResponse.EnsureSuccessStatusCode();
+        totalBytes ??= rangeResponse.Content.Headers.ContentLength;
+        return new RemoteProbeResult(totalBytes, false);
+    }
+
+    private static async Task CopyStreamAsync(
+        Stream sourceStream,
+        Stream destinationStream,
+        long initialDownloadedBytes,
+        long? totalBytes,
+        bool isResuming,
+        bool isParallel,
+        int bufferSize,
+        IProgress<DownloadProgressInfo>? progress,
+        CancellationToken cancellationToken)
+    {
+        var buffer = ArrayPool<byte>.Shared.Rent(bufferSize);
+        var downloadedBytes = initialDownloadedBytes;
+        try
+        {
+            ReportProgress(progress, downloadedBytes, totalBytes, isResuming, isParallel);
+            while (true)
+            {
+                var read = await sourceStream.ReadAsync(buffer.AsMemory(0, buffer.Length), cancellationToken);
+                if (read <= 0)
+                {
+                    break;
+                }
+
+                await destinationStream.WriteAsync(buffer.AsMemory(0, read), cancellationToken);
+                downloadedBytes += read;
+                ReportProgress(progress, downloadedBytes, totalBytes, isResuming, isParallel);
+            }
+
+            await destinationStream.FlushAsync(cancellationToken);
+            ReportProgress(progress, downloadedBytes, totalBytes, isResuming, isParallel);
+        }
+        finally
+        {
+            ArrayPool<byte>.Shared.Return(buffer);
+        }
+    }
+
+    private static void ReportProgress(
+        IProgress<DownloadProgressInfo>? progress,
+        long downloadedBytes,
+        long? totalBytes,
+        bool isResuming,
+        bool isParallel)
+    {
+        if (progress is null)
+        {
+            return;
+        }
+
+        double normalizedProgress;
+        if (totalBytes is > 0)
+        {
+            normalizedProgress = Math.Clamp(downloadedBytes / (double)totalBytes.Value, 0d, 1d);
+        }
+        else
+        {
+            normalizedProgress = 0d;
+        }
+
+        progress.Report(new DownloadProgressInfo(
+            downloadedBytes,
+            totalBytes,
+            normalizedProgress,
+            isResuming,
+            isParallel));
+    }
+
+    private static async Task<DownloadMetadata> LoadOrCreateMetadataAsync(
+        Uri sourceUri,
+        string tempFilePath,
+        string metadataFilePath,
+        long totalBytes,
+        int segmentCount,
+        CancellationToken cancellationToken)
+    {
+        if (File.Exists(metadataFilePath))
+        {
+            try
+            {
+                var json = await File.ReadAllTextAsync(metadataFilePath, cancellationToken);
+                var metadata = JsonSerializer.Deserialize<SerializableDownloadMetadata>(json);
+                if (metadata is not null)
+                {
+                    var normalizedMetadata = metadata.ToRuntime();
+                    if (string.Equals(normalizedMetadata.Source, sourceUri.ToString(), StringComparison.OrdinalIgnoreCase) &&
+                        normalizedMetadata.TotalBytes == totalBytes &&
+                        normalizedMetadata.Segments.Count > 0)
+                    {
+                        return normalizedMetadata.Normalize();
+                    }
+                }
+            }
+            catch
+            {
+                // Reset invalid metadata below.
+            }
+        }
+
+        ResetPartialArtifacts(tempFilePath, metadataFilePath);
+        var createdMetadata = DownloadMetadata.Create(sourceUri.ToString(), totalBytes, segmentCount);
+        var serialized = JsonSerializer.Serialize(createdMetadata.ToSerializable(), MetadataSerializerOptions);
+        await File.WriteAllTextAsync(metadataFilePath, serialized, cancellationToken);
+        return createdMetadata;
+    }
+
+    private static DownloadOptions NormalizeOptions(DownloadOptions? options)
+    {
+        var normalized = options ?? new DownloadOptions();
+        var maxParallelSegments = Math.Clamp(normalized.MaxParallelSegments, 1, 8);
+        var parallelThresholdBytes = Math.Max(1_048_576, normalized.ParallelThresholdBytes);
+        var bufferSize = Math.Max(16 * 1024, normalized.BufferSize);
+        return normalized with
+        {
+            MaxParallelSegments = maxParallelSegments,
+            ParallelThresholdBytes = parallelThresholdBytes,
+            BufferSize = bufferSize
+        };
+    }
+
+    private static int CalculateRecommendedSegments(long totalBytes)
+    {
+        if (totalBytes < 16 * 1024 * 1024)
+        {
+            return 2;
+        }
+
+        if (totalBytes < 64 * 1024 * 1024)
+        {
+            return 4;
+        }
+
+        return 6;
+    }
+
+    private static bool CanReuseCompletedDestination(string destinationFilePath, long? expectedSizeBytes)
+    {
+        if (!File.Exists(destinationFilePath))
+        {
+            return false;
+        }
+
+        if (expectedSizeBytes is not > 0)
+        {
+            return false;
+        }
+
+        return new FileInfo(destinationFilePath).Length == expectedSizeBytes.Value;
+    }
+
+    private static void PrepareDestination(string destinationFilePath)
+    {
+        var directory = Path.GetDirectoryName(destinationFilePath);
+        if (!string.IsNullOrWhiteSpace(directory))
+        {
+            Directory.CreateDirectory(directory);
+        }
+    }
+
+    private static void CompleteDownload(string tempFilePath, string destinationFilePath, string metadataFilePath)
+    {
+        if (!File.Exists(tempFilePath))
+        {
+            return;
+        }
+
+        File.Move(tempFilePath, destinationFilePath, overwrite: true);
+        if (File.Exists(metadataFilePath))
+        {
+            File.Delete(metadataFilePath);
+        }
+    }
+
+    private static void CleanupPartialArtifacts(string tempFilePath, string metadataFilePath)
+    {
+        if (File.Exists(tempFilePath))
+        {
+            File.Delete(tempFilePath);
+        }
+
+        if (File.Exists(metadataFilePath))
+        {
+            File.Delete(metadataFilePath);
+        }
+    }
+
+    private static void ResetPartialArtifacts(string tempFilePath, string metadataFilePath)
+    {
+        CleanupPartialArtifacts(tempFilePath, metadataFilePath);
+    }
+
+    private static string BuildTempFilePath(string destinationFilePath) => destinationFilePath + ".part";
+
+    private static string BuildMetadataFilePath(string destinationFilePath) => destinationFilePath + ".part.json";
+
+    private sealed record RemoteProbeResult(long? TotalBytes, bool SupportsRanges);
+
+    private sealed class RangeRequestNotSupportedException : InvalidOperationException
+    {
+        public RangeRequestNotSupportedException(string message)
+            : base(message)
+        {
+        }
+    }
+
+    private sealed class MetadataWriter
+    {
+        private readonly string _metadataFilePath;
+        private readonly DownloadMetadata _metadata;
+        private readonly SemaphoreSlim _writeGate = new(1, 1);
+        private long _lastPersistedTickCount;
+        private int _dirty;
+
+        public MetadataWriter(string metadataFilePath, DownloadMetadata metadata)
+        {
+            _metadataFilePath = metadataFilePath;
+            _metadata = metadata;
+            _lastPersistedTickCount = Environment.TickCount64;
+        }
+
+        public void MarkDirty()
+        {
+            Interlocked.Exchange(ref _dirty, 1);
+            var now = Environment.TickCount64;
+            if (now - Interlocked.Read(ref _lastPersistedTickCount) < 750)
+            {
+                return;
+            }
+
+            _ = Task.Run(async () =>
+            {
+                try
+                {
+                    await FlushAsync(CancellationToken.None);
+                }
+                catch
+                {
+                    // The final flush still runs on completion/cancellation.
+                }
+            });
+        }
+
+        public async Task FlushAsync(CancellationToken cancellationToken)
+        {
+            if (Interlocked.Exchange(ref _dirty, 0) == 0 && File.Exists(_metadataFilePath))
+            {
+                return;
+            }
+
+            await _writeGate.WaitAsync(cancellationToken);
+            try
+            {
+                var json = JsonSerializer.Serialize(_metadata.ToSerializable(), MetadataSerializerOptions);
+                await File.WriteAllTextAsync(_metadataFilePath, json, cancellationToken);
+                Interlocked.Exchange(ref _lastPersistedTickCount, Environment.TickCount64);
+            }
+            finally
+            {
+                _writeGate.Release();
+            }
+        }
+    }
+
+    private sealed class DownloadMetadata
+    {
+        public string Source { get; init; } = string.Empty;
+
+        public long TotalBytes { get; init; }
+
+        public List<DownloadSegmentState> Segments { get; init; } = [];
+
+        public static DownloadMetadata Create(string source, long totalBytes, int segmentCount)
+        {
+            var segments = SplitIntoSegments(totalBytes, segmentCount)
+                .Select(range => new DownloadSegmentState(range.Start, range.EndInclusive, 0))
+                .ToList();
+
+            return new DownloadMetadata
+            {
+                Source = source,
+                TotalBytes = totalBytes,
+                Segments = segments
+            };
+        }
+
+        public DownloadMetadata Normalize()
+        {
+            foreach (var segment in Segments)
+            {
+                segment.CompletedBytes = Math.Clamp(segment.CompletedBytes, 0, segment.Length);
+            }
+
+            return this;
+        }
+
+        public SerializableDownloadMetadata ToSerializable()
+        {
+            return new SerializableDownloadMetadata
+            {
+                Source = Source,
+                TotalBytes = TotalBytes,
+                Segments = Segments
+                    .Select(segment => new SerializableDownloadSegment
+                    {
+                        Start = segment.Start,
+                        EndInclusive = segment.EndInclusive,
+                        CompletedBytes = segment.CompletedBytes
+                    })
+                    .ToList()
+            };
+        }
+    }
+
+    private sealed class DownloadSegmentState
+    {
+        public DownloadSegmentState(long start, long endInclusive, long completedBytes)
+        {
+            Start = start;
+            EndInclusive = endInclusive;
+            CompletedBytes = completedBytes;
+        }
+
+        public long Start { get; }
+
+        public long EndInclusive { get; }
+
+        public long Length => EndInclusive - Start + 1;
+
+        public long CompletedBytes { get; set; }
+    }
+
+    private sealed class SerializableDownloadMetadata
+    {
+        public string Source { get; init; } = string.Empty;
+
+        public long TotalBytes { get; init; }
+
+        public List<SerializableDownloadSegment> Segments { get; init; } = [];
+
+        public DownloadMetadata ToRuntime()
+        {
+            return new DownloadMetadata
+            {
+                Source = Source,
+                TotalBytes = TotalBytes,
+                Segments = Segments
+                    .Select(segment => new DownloadSegmentState(
+                        segment.Start,
+                        segment.EndInclusive,
+                        segment.CompletedBytes))
+                    .ToList()
+            };
+        }
+    }
+
+    private sealed class SerializableDownloadSegment
+    {
+        public long Start { get; init; }
+
+        public long EndInclusive { get; init; }
+
+        public long CompletedBytes { get; init; }
+    }
+
+    private static IEnumerable<(long Start, long EndInclusive)> SplitIntoSegments(long totalBytes, int segmentCount)
+    {
+        if (totalBytes <= 0)
+        {
+            yield break;
+        }
+
+        var normalizedSegmentCount = Math.Max(1, segmentCount);
+        var segmentSize = totalBytes / normalizedSegmentCount;
+        var remainder = totalBytes % normalizedSegmentCount;
+        long start = 0;
+
+        for (var index = 0; index < normalizedSegmentCount; index++)
+        {
+            var currentSegmentSize = segmentSize + (index < remainder ? 1 : 0);
+            if (currentSegmentSize <= 0)
+            {
+                continue;
+            }
+
+            var endInclusive = start + currentSegmentSize - 1;
+            yield return (start, endInclusive);
+            start = endInclusive + 1;
+        }
+    }
+}
--- a/LanMountainDesktop/Views/MainWindow.Localization.cs
+++ b/LanMountainDesktop/Views/MainWindow.Localization.cs
@@ -119,6 +119,7 @@ public partial class MainWindow
        SettingsNavUpdateItem.Content = L("settings.nav.update", "Update");
        SettingsNavLauncherItem.Content = L("settings.nav.launcher", "App Launcher");
        SettingsNavPluginsItem.Content = L("settings.nav.plugins", "Plugins");
+        SettingsNavPluginMarketItem.Content = L("settings.nav.plugin_market", "Plugin Market");

        WallpaperPanelTitleTextBlock.Text = L("settings.wallpaper.title", "Personalize your wallpaper");
        WallpaperPlacementSettingsExpander.Header = L("settings.wallpaper.placement_label", "Placement");
@@ -283,6 +284,7 @@ public partial class MainWindow
        LauncherHiddenItemsEmptyTextBlock.Text = L("settings.launcher.hidden_empty", "No hidden items.");

        ApplyPluginSettingsLocalization();
+        ApplyPluginMarketSettingsLocalization();

        SettingsNavAboutItem.Content = L("settings.nav.about", "About");
        AboutPanelTitleTextBlock.Text = L("settings.about.title", "About");
--- a/LanMountainDesktop/Views/MainWindow.Settings.cs
+++ b/LanMountainDesktop/Views/MainWindow.Settings.cs
@@ -115,7 +115,8 @@ public partial class MainWindow
            UpdateSettingsPanel is null ||
            LauncherSettingsPanel is null ||
            AboutSettingsPanel is null ||
-            PluginSettingsPanel is null)
+            PluginSettingsPanel is null ||
+            PluginMarketSettingsPanel is null)
        {
            return;
        }
@@ -133,6 +134,7 @@ public partial class MainWindow
        AboutSettingsPanel.IsVisible = tag == "About";
        LauncherSettingsPanel.IsVisible = tag == "Launcher";
        PluginSettingsPanel.IsVisible = tag == "Plugins";
+        PluginMarketSettingsPanel.IsVisible = tag == "PluginMarket";
        UpdatePluginSettingsPageVisibility(tag);

        if (tag == "Launcher")
@@ -140,6 +142,16 @@ public partial class MainWindow
            RenderLauncherHiddenItemsList();
        }

+        if (tag == "Plugins")
+        {
+            PluginSettingsPanel.RefreshFromRuntime();
+        }
+
+        if (tag == "PluginMarket")
+        {
+            PluginMarketSettingsPanel.RefreshFromRuntime();
+        }
+
        if (tag == "Grid")
        {
            UpdateGridPreviewLayout();
--- a/LanMountainDesktop/Views/MainWindow.axaml
+++ b/LanMountainDesktop/Views/MainWindow.axaml
@@ -436,6 +436,11 @@
                                        <ic:SymbolIconSource Symbol="PuzzlePiece" IconVariant="Regular" />
                                    </ui:NavigationViewItem.IconSource>
                                </ui:NavigationViewItem>
+                                <ui:NavigationViewItem x:Name="SettingsNavPluginMarketItem" Content="插件市场" Tag="PluginMarket" ToolTip.Tip="插件市场">
+                                    <ui:NavigationViewItem.IconSource>
+                                        <ic:SymbolIconSource Symbol="PuzzlePiece" IconVariant="Regular" />
+                                    </ui:NavigationViewItem.IconSource>
+                                </ui:NavigationViewItem>
                            </ui:NavigationView.MenuItems>

                            <ScrollViewer x:Name="SettingsContentScrollViewer"
@@ -459,6 +464,7 @@
                                    <pages:LauncherSettingsPage x:Name="LauncherSettingsPanel" IsVisible="False" />
                                    <pages:AboutSettingsPage x:Name="AboutSettingsPanel" IsVisible="False" />
                                    <pages:PluginSettingsPage x:Name="PluginSettingsPanel" IsVisible="False" />
+                                    <pages:PluginMarketSettingsPage x:Name="PluginMarketSettingsPanel" IsVisible="False" />
                                </Grid>
                            </ScrollViewer>
                        </ui:NavigationView>
--- a/LanMountainDesktop/Views/SettingsWindow.Core.cs
+++ b/LanMountainDesktop/Views/SettingsWindow.Core.cs
@@ -69,6 +69,7 @@ public partial class SettingsWindow
        AddSettingsNavItem(SettingsSecondaryNavHost, "Update", Symbol.ArrowSync, "Update");
        AddSettingsNavItem(SettingsSecondaryNavHost, "About", Symbol.Info, "About");
        AddSettingsNavItem(SettingsSecondaryNavHost, "Plugins", Symbol.PuzzlePiece, "Plugins");
+        AddSettingsNavItem(SettingsSecondaryNavHost, "PluginMarket", Symbol.PuzzlePiece, "Plugin Market");
    }

    private void OnSettingsNavItemClick(object? sender, RoutedEventArgs e)
@@ -229,6 +230,7 @@ public partial class SettingsWindow
        AboutSettingsPanel.IsVisible = tag == "About";
        LauncherSettingsPanel.IsVisible = tag == "Launcher";
        PluginSettingsPanel.IsVisible = tag == "Plugins";
+        PluginMarketSettingsPanel.IsVisible = tag == "PluginMarket";
        UpdatePluginSettingsPageVisibility(tag);

        if (tag == "Launcher")
@@ -236,6 +238,16 @@ public partial class SettingsWindow
            RenderLauncherHiddenItemsList();
        }

+        if (tag == "Plugins")
+        {
+            PluginSettingsPanel.RefreshFromRuntime();
+        }
+
+        if (tag == "PluginMarket")
+        {
+            PluginMarketSettingsPanel.RefreshFromRuntime();
+        }
+
        if (tag == "Grid")
        {
            UpdateGridPreviewLayout();
--- a/LanMountainDesktop/Views/SettingsWindow.Localization.cs
+++ b/LanMountainDesktop/Views/SettingsWindow.Localization.cs
@@ -74,6 +74,7 @@ public partial class SettingsWindow
        SetSettingsNavItemLabel(GetSettingsNavItem("About"), L("settings.nav.about", "About"));
        SetSettingsNavItemLabel(GetSettingsNavItem("Launcher"), L("settings.nav.launcher", "App Launcher"));
        SetSettingsNavItemLabel(GetSettingsNavItem("Plugins"), L("settings.nav.plugins", "Plugins"));
+        SetSettingsNavItemLabel(GetSettingsNavItem("PluginMarket"), L("settings.nav.plugin_market", "Plugin Market"));

        WallpaperPanelTitleTextBlock.Text = L("settings.wallpaper.title", "Personalize your wallpaper");
        WallpaperPlacementSettingsExpander.Header = L("settings.wallpaper.placement_label", "Placement");
@@ -177,6 +178,7 @@ public partial class SettingsWindow
        LauncherHiddenItemsEmptyTextBlock.Text = L("settings.launcher.hidden_empty", "No hidden items.");

        ApplyPluginSettingsLocalization();
+        ApplyPluginMarketSettingsLocalization();

        AboutPanelTitleTextBlock.Text = L("settings.about.title", "About");
        VersionTextBlock.Text = Lf("settings.about.version_format", "Version: {0}", GetAppVersionText());
--- a/LanMountainDesktop/Views/SettingsWindow.axaml
+++ b/LanMountainDesktop/Views/SettingsWindow.axaml
@@ -253,6 +253,7 @@
                                    <pages:LauncherSettingsPage x:Name="LauncherSettingsPanel" IsVisible="False" />
                                    <pages:AboutSettingsPage x:Name="AboutSettingsPanel" IsVisible="False" />
                                    <pages:PluginSettingsPage x:Name="PluginSettingsPanel" IsVisible="False" />
+                                    <pages:PluginMarketSettingsPage x:Name="PluginMarketSettingsPanel" IsVisible="False" />
                                </Grid>
                            </ScrollViewer>
                        </Border>
--- a/LanMountainDesktop/plugins/MainWindow.PluginMarketSettingsLocalization.cs
+++ b/LanMountainDesktop/plugins/MainWindow.PluginMarketSettingsLocalization.cs
@@ -0,0 +1,9 @@
+namespace LanMountainDesktop.Views;
+
+public partial class MainWindow
+{
+    private void ApplyPluginMarketSettingsLocalization()
+    {
+        PluginMarketSettingsPanel.RefreshFromRuntime();
+    }
+}
--- a/LanMountainDesktop/plugins/MainWindow.PluginSettingsHost.cs
+++ b/LanMountainDesktop/plugins/MainWindow.PluginSettingsHost.cs
@@ -39,7 +39,7 @@ public partial class MainWindow
            .GroupBy(contribution => contribution.Plugin.Manifest.Id, StringComparer.OrdinalIgnoreCase)
            .ToDictionary(group => group.Key, group => group.Count(), StringComparer.OrdinalIgnoreCase);

-        var insertIndex = SettingsNavView.MenuItems.IndexOf(SettingsNavPluginsItem) + 1;
+        var insertIndex = SettingsNavView.MenuItems.IndexOf(SettingsNavPluginMarketItem) + 1;
        foreach (var contribution in contributions)
        {
            var tag = BuildPluginSettingsTag(contribution);
--- a/LanMountainDesktop/plugins/PluginMarketInstallService.cs
+++ b/LanMountainDesktop/plugins/PluginMarketInstallService.cs
@@ -14,6 +14,7 @@ internal sealed class AirAppMarketInstallService : IDisposable
 {
    private readonly PluginRuntimeService _runtime;
    private readonly HttpClient _httpClient;
+    private readonly ResumableDownloadService _downloadService;
    private readonly AirAppMarketReleaseResolverService _releaseResolverService;
    private readonly string _downloadsDirectory;

@@ -26,6 +27,7 @@ internal sealed class AirAppMarketInstallService : IDisposable
            Timeout = TimeSpan.FromMinutes(2)
        };
        _httpClient.DefaultRequestHeaders.UserAgent.ParseAdd("LanMountainDesktop-PluginMarketplace/1.0");
+        _downloadService = new ResumableDownloadService(_httpClient);
        _releaseResolverService = new AirAppMarketReleaseResolverService(_httpClient);
    }

@@ -46,21 +48,27 @@ internal sealed class AirAppMarketInstallService : IDisposable

            if (AirAppMarketDefaults.TryResolveWorkspaceFile(resolvedDownloadUrl, out var localPackagePath))
            {
-                await using var sourceStream = File.OpenRead(localPackagePath);
-                await using var destinationStream = File.Create(downloadPath);
-                await sourceStream.CopyToAsync(destinationStream, cancellationToken);
+                var localCopyResult = await _downloadService.DownloadAsync(
+                    localPackagePath,
+                    downloadPath,
+                    new DownloadOptions(ExpectedSizeBytes: plugin.PackageSizeBytes),
+                    cancellationToken: cancellationToken);
+                if (!localCopyResult.Success)
+                {
+                    return new AirAppMarketInstallResult(false, null, localCopyResult.ErrorMessage);
+                }
            }
            else
            {
-                using var response = await _httpClient.GetAsync(
+                var downloadResult = await _downloadService.DownloadAsync(
                    resolvedDownloadUrl,
-                    HttpCompletionOption.ResponseHeadersRead,
-                    cancellationToken);
-                response.EnsureSuccessStatusCode();
-
-                await using var responseStream = await response.Content.ReadAsStreamAsync(cancellationToken);
-                await using var destinationStream = File.Create(downloadPath);
-                await responseStream.CopyToAsync(destinationStream, cancellationToken);
+                    downloadPath,
+                    new DownloadOptions(ExpectedSizeBytes: plugin.PackageSizeBytes),
+                    cancellationToken: cancellationToken);
+                if (!downloadResult.Success)
+                {
+                    return new AirAppMarketInstallResult(false, null, downloadResult.ErrorMessage);
+                }
            }

            await using var hashStream = File.OpenRead(downloadPath);
--- a/LanMountainDesktop/plugins/PluginMarketSettingsPage.axaml
+++ b/LanMountainDesktop/plugins/PluginMarketSettingsPage.axaml
@@ -0,0 +1,25 @@
+<UserControl xmlns="https://github.com/avaloniaui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+             xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
+             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+             mc:Ignorable="d"
+             d:DesignWidth="960"
+             d:DesignHeight="1000"
+             x:Class="LanMountainDesktop.Views.SettingsPages.PluginMarketSettingsPage">
+
+    <StackPanel x:Name="PluginMarketPanel"
+                Spacing="16">
+        <TextBlock x:Name="PluginMarketPanelTitleTextBlock"
+                   FontSize="24"
+                   FontWeight="SemiBold"
+                   Foreground="{DynamicResource AdaptiveTextPrimaryBrush}"
+                   Text="Plugin Market" />
+
+        <TextBlock x:Name="PluginMarketPanelSubtitleTextBlock"
+                   Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
+                   TextWrapping="Wrap"
+                   Text="Browse plugins from the official LanAirApp source and stage installs." />
+
+        <ContentControl x:Name="PluginMarketContentHost" />
+    </StackPanel>
+</UserControl>
--- a/LanMountainDesktop/plugins/PluginMarketSettingsPage.axaml.cs
+++ b/LanMountainDesktop/plugins/PluginMarketSettingsPage.axaml.cs
@@ -0,0 +1,71 @@
+using Avalonia;
+using Avalonia.Controls;
+using Avalonia.Media;
+using LanMountainDesktop.Services;
+
+namespace LanMountainDesktop.Views.SettingsPages;
+
+public partial class PluginMarketSettingsPage : UserControl
+{
+    private readonly AppSettingsService _appSettingsService = new();
+    private readonly LocalizationService _localizationService = new();
+    private PluginMarketEmbeddedView? _pluginMarketView;
+
+    public PluginMarketSettingsPage()
+    {
+        InitializeComponent();
+        AttachedToVisualTree += (_, _) => RefreshFromRuntime();
+    }
+
+    public void RefreshFromRuntime()
+    {
+        PluginMarketPanelTitleTextBlock.Text = L("settings.plugin_market.title", "Plugin Market");
+        PluginMarketPanelSubtitleTextBlock.Text = L(
+            "settings.plugin_market.subtitle",
+            "Browse plugins from the official LanAirApp source and stage installs.");
+
+        var runtime = (Application.Current as App)?.PluginRuntimeService;
+        if (runtime is null)
+        {
+            PluginMarketContentHost.Content = CreateUnavailableState();
+            return;
+        }
+
+        if (_pluginMarketView is null)
+        {
+            _pluginMarketView = new PluginMarketEmbeddedView(runtime);
+        }
+
+        _pluginMarketView.RefreshLocalization();
+        _pluginMarketView.RefreshInstalledSnapshot();
+
+        if (!ReferenceEquals(PluginMarketContentHost.Content, _pluginMarketView))
+        {
+            PluginMarketContentHost.Content = _pluginMarketView;
+        }
+    }
+
+    private Control CreateUnavailableState()
+    {
+        return new Border
+        {
+            Background = new SolidColorBrush(Color.Parse("#14000000")),
+            CornerRadius = new CornerRadius(16),
+            Padding = new Thickness(16),
+            Child = new TextBlock
+            {
+                Text = L(
+                    "settings.plugin_market.unavailable",
+                    "Plugin runtime is not available, so the official market cannot be opened right now."),
+                TextWrapping = TextWrapping.Wrap,
+                Foreground = PluginMarketPanelSubtitleTextBlock.Foreground
+            }
+        };
+    }
+
+    private string L(string key, string fallback)
+    {
+        var snapshot = _appSettingsService.Load();
+        return _localizationService.GetString(snapshot.LanguageCode, key, fallback);
+    }
+}
--- a/LanMountainDesktop/plugins/PluginSettingsPage.Host.cs
+++ b/LanMountainDesktop/plugins/PluginSettingsPage.Host.cs
@@ -21,7 +21,6 @@ public partial class PluginSettingsPage : UserControl

    private readonly AppSettingsService _appSettingsService = new();
    private readonly LocalizationService _localizationService = new();
-    private PluginMarketEmbeddedView? _pluginMarketView;
    private string? _packageImportStatusMessage;
    private bool _packageImportStatusIsError;

@@ -34,13 +33,6 @@ public partial class PluginSettingsPage : UserControl
    public void RefreshFromRuntime()
    {
        var runtime = (Application.Current as App)?.PluginRuntimeService;
-        PluginMarketSettingsExpander.Header = L("settings.plugins.market_header", "Official Market");
-        PluginMarketSettingsExpander.Description = L(
-            "settings.plugins.market_desc",
-            "Browse plugins from the official LanAirApp source and stage installs.");
-        PluginMarketDescriptionTextBlock.Text = L(
-            "settings.plugins.market_hint",
-            "Use the official market source hosted in LanAirApp to discover and stage plugin installs.");
        UpdateInstallerUi(runtime);
        if (runtime is null)
        {
@@ -48,33 +40,13 @@ public partial class PluginSettingsPage : UserControl
            PluginRuntimeSummaryPanel.Children.Clear();
            PluginCatalogItemsHost.Children.Clear();
            PluginRestartHintTextBlock.IsVisible = false;
-            PluginMarketContentHost.Content = CreateSummaryLine(
-                L("settings.plugins.market_unavailable", "Plugin runtime is not available, so the official market cannot be opened right now."));
            return;
        }

-        EnsurePluginMarketView(runtime);
-        _pluginMarketView?.RefreshLocalization();
-        _pluginMarketView?.RefreshInstalledSnapshot();
        BuildRuntimeSummary(runtime);
        BuildPluginCatalog(runtime);
    }

-    private void EnsurePluginMarketView(PluginRuntimeService runtime)
-    {
-        if (_pluginMarketView is null)
-        {
-            _pluginMarketView = new PluginMarketEmbeddedView(runtime);
-            PluginMarketContentHost.Content = _pluginMarketView;
-            return;
-        }
-
-        if (!ReferenceEquals(PluginMarketContentHost.Content, _pluginMarketView))
-        {
-            PluginMarketContentHost.Content = _pluginMarketView;
-        }
-    }
-
    private void UpdateInstallerUi(PluginRuntimeService? runtime)
    {
        InstallPluginPackageButton.Content = L("settings.plugins.install_button", "Open .laapp package");
--- a/LanMountainDesktop/plugins/PluginSettingsPage.axaml
+++ b/LanMountainDesktop/plugins/PluginSettingsPage.axaml
@@ -83,24 +83,5 @@
            </ui:SettingsExpander>
        </Border>

-        <Border Classes="settings-expander-shell">
-            <ui:SettingsExpander x:Name="PluginMarketSettingsExpander"
-                                 Header="Official Market"
-                                 Description="Browse plugins from the official LanAirApp source and stage installs."
-                                 IsExpanded="True">
-                <ui:SettingsExpander.IconSource>
-                    <ui:FontIconSource Glyph="&#xe719;" FontFamily="{StaticResource SymbolThemeFontFamily}" />
-                </ui:SettingsExpander.IconSource>
-                <ui:SettingsExpander.Footer>
-                    <StackPanel Spacing="10">
-                        <TextBlock x:Name="PluginMarketDescriptionTextBlock"
-                                   Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
-                                   TextWrapping="Wrap"
-                                   Text="Use the official market source hosted in LanAirApp to discover and stage plugin installs." />
-                        <ContentControl x:Name="PluginMarketContentHost" />
-                    </StackPanel>
-                </ui:SettingsExpander.Footer>
-            </ui:SettingsExpander>
-        </Border>
    </StackPanel>
 </UserControl>
--- a/LanMountainDesktop/plugins/SettingsWindow.PluginMarketSettingsLocalization.cs
+++ b/LanMountainDesktop/plugins/SettingsWindow.PluginMarketSettingsLocalization.cs
@@ -0,0 +1,9 @@
+namespace LanMountainDesktop.Views;
+
+public partial class SettingsWindow
+{
+    private void ApplyPluginMarketSettingsLocalization()
+    {
+        PluginMarketSettingsPanel.RefreshFromRuntime();
+    }
+}