0.5.12

插件市场UI优化

LanAirApp/README.md

@@ -1,27 +1,21 @@
 # LanAirApp
 
-`LanAirApp` 是阑山桌面插件生态的对外发布工作区。
+## 中文
 
-这里集中放置：
-- 插件开发标准
-- 插件打包与构建工具
-- 插件开发与打包文档
-- 示例插件
+`LanAirApp` 是阑山桌面插件生态的对外工作区。这个目录是宿主仓库中的镜像副本，权威版本以独立 `LanAirApp` 仓库为准。
 
-目录结构：
-- `docs/`：插件开发文档、打包文档
-- `plugins/`：第一方插件项目，例如插件市场插件
-- `releases/`：已经打包完成、可直接分享与安装的 `.laapp` 插件包
-- `samples/`：示例插件，其中 `LanMountainDesktop.SamplePlugin` 是示例开发插件
-- `standards/`：插件标准文件与模板
-- `tools/`：插件打包与构建工具
+### 目录说明
 
-面向用户的安装流程：
-1. 将插件构建或打包为 `.laapp` 文件。
-2. 打开 `设置 -> 插件`。
-3. 点击 `打开 .laapp 插件包`。
-4. 选择插件包完成安装。
+- `docs/`：插件开发与打包文档。
+- `samples/`：示例插件与参考项目。
+- `standards/`：插件清单和目录结构约定。
+- `tools/`：插件打包与辅助工具。
 
-宿主侧的插件加载、安装、发现、解析与设置页接入逻辑，保留在 `LanMountainDesktop/plugins/`。
+### 与宿主的关系
 
-`LanMountainDesktop.PluginSdk` 仅作为插件开发 SDK 使用，提供 `IPlugin`、`IPluginContext`、清单模型与扩展注册接口。
+- 宿主程序只连接独立 `LanAirApp` 仓库中的官方市场索引。
+- 每个插件项目应在仓库根目录提供 `.laapp` 和 `README.md`。
+
+## English
+
+`LanAirApp` is the external-facing workspace for the LanMountainDesktop plugin ecosystem. This copy is only a mirror inside the host repository; the standalone `LanAirApp` repository remains the source of truth.

LanAirApp/docs/PLUGIN_DEVELOPMENT.md

@@ -1,41 +1,16 @@
-# 插件开发文档
+# 插件开发指南
 
-LanMountainDesktop 插件基于 `LanMountainDesktop.PluginSdk` 开发。
+## 中文
 
-`LanAirApp/` 负责对外发布插件开发标准、示例插件和打包工具；宿主应用内部的插件加载与解析逻辑位于 `LanMountainDesktop/plugins/`。
-`LanMountainDesktop.PluginSdk` 只提供插件作者需要依赖的开发契约，不再承载宿主侧运行时加载实现。
+使用 `LanMountainDesktop.PluginSdk` 开发插件时，至少需要准备：
 
-## 必需文件
 - `plugin.json`
-- `plugin.json` 中声明的入口程序集
-- 使用插件入口特性标记的入口类型
+- 插件入口程序集
+- 入口类
+- 本地化资源
 
-## 推荐开发流程
-1. 以 `LanAirApp/samples/LanMountainDesktop.SamplePlugin` 为起点。
-2. 修改 `plugin.json`，填写你自己的插件 `id`、名称、作者、版本和入口程序集。
-3. 实现 `IPlugin` 或继承 `PluginBase`。
-4. 通过 `IPluginContext` 注册服务、设置页和桌面组件。
-5. 将输出内容打包为 `.laapp` 文件。
+推荐从示例插件开始，先完成清单、入口、设置页和桌面组件，再逐步扩展业务逻辑。
 
-## 运行时能力
-- 插件可以注册自己的设置页。
-- 插件可以注册自己的桌面组件。
-- 插件可以注册自己的服务，并通过插件消息总线进行通信。
-- 宿主优先加载 `.laapp` 包，其次才是散装清单。
+## English
 
-## 多语言建议
-- 插件应当内置 `Localization/zh-CN.json` 与 `Localization/en-US.json`。
-- 插件界面文案、组件文案、状态文案建议统一通过插件本地化层读取。
-- 建议优先读取宿主传入的语言代码，再回退到插件默认语言。
-
-## 目录建议
-一个标准插件项目建议至少包含：
-- `plugin.json`
-- `Localization/zh-CN.json`
-- `Localization/en-US.json`
-- 插件程序集与依赖文件
-
-## 示例项目与工具
-- 示例插件：`LanAirApp/samples/LanMountainDesktop.SamplePlugin`
-- 打包工具：`LanAirApp/tools/LanMountainDesktop.PluginPackager`
-- 标准模板：`LanAirApp/standards/plugin.template.json`
+To build a plugin with `LanMountainDesktop.PluginSdk`, prepare the manifest, plugin assembly, entrance class, and localization resources first.

LanAirApp/docs/PLUGIN_PACKAGING.md

@@ -1,34 +1,14 @@
-# 插件打包文档
+# 插件打包指南
 
-LanMountainDesktop 插件的安装包格式固定为 `.laapp`。
+## 中文
 
-`LanAirApp/` 负责提供打包标准与打包工具；`.laapp` 的安装、发现和运行时加载由 `LanMountainDesktop/plugins/` 负责。
+阑山桌面插件的标准安装格式为 `.laapp`。插件项目应在仓库根目录提供：
 
-## `.laapp` 格式说明
-- 本质上是一个标准 zip 压缩包
-- 包根目录必须包含 `plugin.json`
-- 包根目录还必须包含入口程序集及其依赖
+- `.laapp` 安装包
+- `README.md`
 
-## 建议打包内容
-- `plugin.json`
-- `YourPlugin.dll`
-- 依赖程序集
-- `Localization/zh-CN.json`
-- `Localization/en-US.json`
-- 插件运行所需的其他资源文件
+官方市场索引只负责记录链接和校验信息。
 
-## 使用打包工具
-```powershell
-dotnet run --project .\LanAirApp\tools\LanMountainDesktop.PluginPackager -- --input .\path\to\plugin-output --output .\artifacts\YourPlugin.laapp --overwrite
-```
+## English
 
-## 应用内安装流程
-1. 打开 `设置 -> 插件`
-2. 点击 `打开 .laapp 插件包`
-3. 选择要安装的插件包
-4. 如果插件注册了设置页或组件，安装后重启应用
-
-## 注意事项
-- `plugin.json` 中的 `entranceAssembly` 必须能在包内找到。
-- 包内应尽量避免无关开发产物。
-- `.laapp` 是标准安装格式，建议不要对外分发散装目录。
+The standard package format is `.laapp`. Plugin repositories should keep the package and `README.md` in the repository root, while the official market index stores metadata and validation data.

LanAirApp/plugins/LanMountainDesktop.PluginMarketplace/AirAppMarketCacheService.cs

@@ -1,41 +0,0 @@
-namespace LanMountainDesktop.PluginMarketplace;
-
-internal sealed class AirAppMarketCacheService
-{
-    private readonly string _cacheDirectory;
-
-    public AirAppMarketCacheService(string dataDirectory)
-    {
-        ArgumentException.ThrowIfNullOrWhiteSpace(dataDirectory);
-        _cacheDirectory = Path.Combine(dataDirectory, "cache");
-    }
-
-    public string CacheFilePath => Path.Combine(_cacheDirectory, "index.json");
-
-    public void SaveIndexJson(string json)
-    {
-        ArgumentException.ThrowIfNullOrWhiteSpace(json);
-        Directory.CreateDirectory(_cacheDirectory);
-        File.WriteAllText(CacheFilePath, json);
-    }
-
-    public bool TryReadIndexJson(out string json)
-    {
-        try
-        {
-            if (!File.Exists(CacheFilePath))
-            {
-                json = string.Empty;
-                return false;
-            }
-
-            json = File.ReadAllText(CacheFilePath);
-            return !string.IsNullOrWhiteSpace(json);
-        }
-        catch
-        {
-            json = string.Empty;
-            return false;
-        }
-    }
-}

LanAirApp/plugins/LanMountainDesktop.PluginMarketplace/AirAppMarketIndexService.cs

@@ -1,77 +0,0 @@
-using System.Net.Http.Headers;
-
-namespace LanMountainDesktop.PluginMarketplace;
-
-internal sealed class AirAppMarketIndexService : IDisposable
-{
-    private readonly AirAppMarketCacheService _cacheService;
-    private readonly HttpClient _httpClient;
-
-    public AirAppMarketIndexService(AirAppMarketCacheService cacheService)
-    {
-        _cacheService = cacheService;
-        _httpClient = new HttpClient
-        {
-            Timeout = TimeSpan.FromSeconds(20)
-        };
-        _httpClient.DefaultRequestHeaders.UserAgent.ParseAdd("LanMountainDesktop-PluginMarketplace/1.0");
-        _httpClient.DefaultRequestHeaders.Accept.Add(
-            new MediaTypeWithQualityHeaderValue("application/json"));
-    }
-
-    public async Task<AirAppMarketLoadResult> LoadAsync(CancellationToken cancellationToken = default)
-    {
-        Exception? networkError = null;
-
-        try
-        {
-            using var response = await _httpClient.GetAsync(
-                AirAppMarketDefaults.DefaultIndexUrl,
-                cancellationToken);
-            var json = await response.Content.ReadAsStringAsync(cancellationToken);
-            response.EnsureSuccessStatusCode();
-
-            var document = AirAppMarketIndexDocument.Load(json, AirAppMarketDefaults.DefaultIndexUrl);
-            _cacheService.SaveIndexJson(json);
-            return new AirAppMarketLoadResult(true, document, AirAppMarketLoadSource.Network, null, null);
-        }
-        catch (OperationCanceledException)
-        {
-            throw;
-        }
-        catch (Exception ex)
-        {
-            networkError = ex;
-        }
-
-        if (_cacheService.TryReadIndexJson(out var cachedJson))
-        {
-            try
-            {
-                var cachedDocument = AirAppMarketIndexDocument.Load(cachedJson, _cacheService.CacheFilePath);
-                return new AirAppMarketLoadResult(
-                    true,
-                    cachedDocument,
-                    AirAppMarketLoadSource.Cache,
-                    networkError?.Message,
-                    null);
-            }
-            catch (Exception cacheEx)
-            {
-                return new AirAppMarketLoadResult(
-                    false,
-                    null,
-                    null,
-                    null,
-                    $"{networkError?.Message ?? "Unknown network error"} | Cached index invalid: {cacheEx.Message}");
-            }
-        }
-
-        return new AirAppMarketLoadResult(false, null, null, null, networkError?.Message ?? "Unknown network error");
-    }
-
-    public void Dispose()
-    {
-        _httpClient.Dispose();
-    }
-}

LanAirApp/plugins/LanMountainDesktop.PluginMarketplace/AirAppMarketInstallService.cs

@@ -1,83 +0,0 @@
-using System.Security.Cryptography;
-using LanMountainDesktop.PluginSdk;
-
-namespace LanMountainDesktop.PluginMarketplace;
-
-internal sealed class AirAppMarketInstallService : IDisposable
-{
-    private readonly IPluginPackageManager _packageManager;
-    private readonly HttpClient _httpClient;
-    private readonly string _downloadsDirectory;
-
-    public AirAppMarketInstallService(IPluginPackageManager packageManager, string dataDirectory)
-    {
-        _packageManager = packageManager;
-        _downloadsDirectory = Path.Combine(dataDirectory, "downloads");
-        _httpClient = new HttpClient
-        {
-            Timeout = TimeSpan.FromMinutes(2)
-        };
-        _httpClient.DefaultRequestHeaders.UserAgent.ParseAdd("LanMountainDesktop-PluginMarketplace/1.0");
-    }
-
-    public async Task<AirAppMarketInstallResult> InstallAsync(
-        AirAppMarketPluginEntry plugin,
-        CancellationToken cancellationToken = default)
-    {
-        ArgumentNullException.ThrowIfNull(plugin);
-
-        Directory.CreateDirectory(_downloadsDirectory);
-        var downloadPath = Path.Combine(
-            _downloadsDirectory,
-            $"{SanitizeFileName(plugin.Id)}-{SanitizeFileName(plugin.Version)}.laapp");
-
-        try
-        {
-            using var response = await _httpClient.GetAsync(
-                plugin.DownloadUrl,
-                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);
-            }
-
-            await using var hashStream = File.OpenRead(downloadPath);
-            var hashBytes = await SHA256.HashDataAsync(hashStream, cancellationToken);
-            var actualHash = Convert.ToHexString(hashBytes).ToLowerInvariant();
-            if (!string.Equals(actualHash, plugin.Sha256, StringComparison.OrdinalIgnoreCase))
-            {
-                File.Delete(downloadPath);
-                return new AirAppMarketInstallResult(
-                    false,
-                    null,
-                    $"SHA-256 mismatch. Expected {plugin.Sha256}, actual {actualHash}.");
-            }
-
-            var installResult = _packageManager.InstallPackage(downloadPath);
-            return new AirAppMarketInstallResult(true, installResult, null);
-        }
-        catch (OperationCanceledException)
-        {
-            throw;
-        }
-        catch (Exception ex)
-        {
-            return new AirAppMarketInstallResult(false, null, ex.Message);
-        }
-    }
-
-    public void Dispose()
-    {
-        _httpClient.Dispose();
-    }
-
-    private static string SanitizeFileName(string value)
-    {
-        var invalidChars = Path.GetInvalidFileNameChars();
-        return new string(value.Select(ch => invalidChars.Contains(ch) ? '_' : ch).ToArray());
-    }
-}

LanAirApp/plugins/LanMountainDesktop.PluginMarketplace/AirAppMarketModels.cs

@@ -1,299 +0,0 @@
-using System.Globalization;
-using System.Text.Json;
-using LanMountainDesktop.PluginSdk;
-
-namespace LanMountainDesktop.PluginMarketplace;
-
-internal static class AirAppMarketDefaults
-{
-    public const string DefaultIndexUrl =
-        "https://raw.githubusercontent.com/wwiinnddyy/LanMountainDesktop/main/airappmarket/index.json";
-}
-
-internal enum AirAppMarketLoadSource
-{
-    Network = 0,
-    Cache = 1
-}
-
-internal enum AirAppMarketInstallState
-{
-    NotInstalled = 0,
-    UpdateAvailable = 1,
-    Installed = 2
-}
-
-internal sealed record AirAppMarketLoadResult(
-    bool Success,
-    AirAppMarketIndexDocument? Document,
-    AirAppMarketLoadSource? Source,
-    string? WarningMessage,
-    string? ErrorMessage);
-
-internal sealed record AirAppMarketInstallResult(
-    bool Success,
-    PluginPackageInstallResult? InstallResult,
-    string? ErrorMessage);
-
-internal sealed class AirAppMarketIndexDocument
-{
-    private static readonly JsonSerializerOptions SerializerOptions = new()
-    {
-        PropertyNameCaseInsensitive = true,
-        ReadCommentHandling = JsonCommentHandling.Skip,
-        AllowTrailingCommas = true
-    };
-
-    public string SchemaVersion { get; init; } = string.Empty;
-
-    public string SourceId { get; init; } = string.Empty;
-
-    public string SourceName { get; init; } = string.Empty;
-
-    public DateTimeOffset GeneratedAt { get; init; }
-
-    public List<AirAppMarketPluginEntry> Plugins { get; init; } = [];
-
-    public static AirAppMarketIndexDocument Load(string json, string sourceName)
-    {
-        ArgumentException.ThrowIfNullOrWhiteSpace(json);
-        ArgumentException.ThrowIfNullOrWhiteSpace(sourceName);
-
-        var document = JsonSerializer.Deserialize<AirAppMarketIndexDocument>(
-            json.TrimStart('\uFEFF'),
-            SerializerOptions);
-
-        if (document is null)
-        {
-            throw new InvalidOperationException($"Failed to parse market index '{sourceName}'.");
-        }
-
-        return document.ValidateAndNormalize(sourceName);
-    }
-
-    private AirAppMarketIndexDocument ValidateAndNormalize(string sourceName)
-    {
-        var plugins = Plugins ?? [];
-        var normalizedPlugins = new List<AirAppMarketPluginEntry>(plugins.Count);
-        var seenIds = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
-
-        foreach (var plugin in plugins)
-        {
-            var normalizedPlugin = plugin.ValidateAndNormalize(sourceName);
-            if (!seenIds.Add(normalizedPlugin.Id))
-            {
-                throw new InvalidOperationException(
-                    $"Market index '{sourceName}' contains duplicate plugin id '{normalizedPlugin.Id}'.");
-            }
-
-            normalizedPlugins.Add(normalizedPlugin);
-        }
-
-        return new AirAppMarketIndexDocument
-        {
-            SchemaVersion = RequireValue(SchemaVersion, nameof(SchemaVersion), sourceName),
-            SourceId = RequireValue(SourceId, nameof(SourceId), sourceName),
-            SourceName = RequireValue(SourceName, nameof(SourceName), sourceName),
-            GeneratedAt = GeneratedAt == default
-                ? throw new InvalidOperationException($"Market index '{sourceName}' is missing a valid generatedAt timestamp.")
-                : GeneratedAt,
-            Plugins = normalizedPlugins
-                .OrderBy(plugin => plugin.Name, StringComparer.OrdinalIgnoreCase)
-                .ToList()
-        };
-    }
-
-    private static string RequireValue(string? value, string propertyName, string sourceName)
-    {
-        var normalized = NormalizeValue(value);
-        if (string.IsNullOrWhiteSpace(normalized))
-        {
-            throw new InvalidOperationException($"Market index '{sourceName}' is missing required property '{propertyName}'.");
-        }
-
-        return normalized;
-    }
-
-    internal static string? NormalizeValue(string? value)
-    {
-        return string.IsNullOrWhiteSpace(value) ? null : value.Trim();
-    }
-
-    internal static string NormalizeVersion(string? value, string propertyName, string sourceName)
-    {
-        var normalized = RequireValue(value, propertyName, sourceName);
-        if (!TryParseVersion(normalized, out _))
-        {
-            throw new InvalidOperationException(
-                $"Market index '{sourceName}' declares invalid version '{normalized}' for '{propertyName}'.");
-        }
-
-        return normalized;
-    }
-
-    internal static void EnsureUrl(string url, string propertyName, string sourceName)
-    {
-        if (!Uri.TryCreate(url, UriKind.Absolute, out var uri) ||
-            (uri.Scheme != Uri.UriSchemeHttp && uri.Scheme != Uri.UriSchemeHttps))
-        {
-            throw new InvalidOperationException(
-                $"Market index '{sourceName}' declares invalid URL '{url}' for '{propertyName}'.");
-        }
-    }
-
-    internal static bool TryParseVersion(string? value, out Version? version)
-    {
-        version = null;
-        var normalized = NormalizeValue(value);
-        if (string.IsNullOrWhiteSpace(normalized))
-        {
-            return false;
-        }
-
-        if (normalized.StartsWith("v", StringComparison.OrdinalIgnoreCase))
-        {
-            normalized = normalized[1..];
-        }
-
-        var separatorIndex = normalized.IndexOfAny(['-', '+', ' ']);
-        if (separatorIndex > 0)
-        {
-            normalized = normalized[..separatorIndex];
-        }
-
-        if (!Version.TryParse(normalized, out var parsed))
-        {
-            return false;
-        }
-
-        version = new Version(
-            Math.Max(0, parsed.Major),
-            Math.Max(0, parsed.Minor),
-            Math.Max(0, parsed.Build));
-        return true;
-    }
-}
-
-internal sealed class AirAppMarketPluginEntry
-{
-    public string Id { get; init; } = string.Empty;
-
-    public string Name { get; init; } = string.Empty;
-
-    public string Description { get; init; } = string.Empty;
-
-    public string Author { get; init; } = string.Empty;
-
-    public string Version { get; init; } = string.Empty;
-
-    public string ApiVersion { get; init; } = string.Empty;
-
-    public string MinHostVersion { get; init; } = string.Empty;
-
-    public string DownloadUrl { get; init; } = string.Empty;
-
-    public string Sha256 { get; init; } = string.Empty;
-
-    public long PackageSizeBytes { get; init; }
-
-    public string IconUrl { get; init; } = string.Empty;
-
-    public string HomepageUrl { get; init; } = string.Empty;
-
-    public string RepositoryUrl { get; init; } = string.Empty;
-
-    public List<string> Tags { get; init; } = [];
-
-    public DateTimeOffset PublishedAt { get; init; }
-
-    public DateTimeOffset UpdatedAt { get; init; }
-
-    public string ReleaseNotes { get; init; } = string.Empty;
-
-    public AirAppMarketPluginEntry ValidateAndNormalize(string sourceName)
-    {
-        var normalizedTags = (Tags ?? [])
-            .Select(tag => AirAppMarketIndexDocument.NormalizeValue(tag))
-            .Where(tag => !string.IsNullOrWhiteSpace(tag))
-            .Select(tag => tag!)
-            .Distinct(StringComparer.OrdinalIgnoreCase)
-            .OrderBy(tag => tag, StringComparer.OrdinalIgnoreCase)
-            .ToList();
-
-        var normalizedSha = AirAppMarketIndexDocument.NormalizeValue(Sha256)?.ToLowerInvariant()
-            ?? throw new InvalidOperationException(
-                $"Market index '{sourceName}' is missing required property '{nameof(Sha256)}'.");
-
-        if (normalizedSha.Length != 64 || normalizedSha.Any(ch => !Uri.IsHexDigit(ch)))
-        {
-            throw new InvalidOperationException(
-                $"Market index '{sourceName}' declares invalid SHA-256 '{normalizedSha}' for plugin '{Id}'.");
-        }
-
-        var normalizedDownloadUrl = AirAppMarketIndexDocument.NormalizeValue(DownloadUrl)
-            ?? throw new InvalidOperationException(
-                $"Market index '{sourceName}' is missing required property '{nameof(DownloadUrl)}'.");
-        var normalizedIconUrl = AirAppMarketIndexDocument.NormalizeValue(IconUrl)
-            ?? throw new InvalidOperationException(
-                $"Market index '{sourceName}' is missing required property '{nameof(IconUrl)}'.");
-        var normalizedHomepageUrl = AirAppMarketIndexDocument.NormalizeValue(HomepageUrl)
-            ?? throw new InvalidOperationException(
-                $"Market index '{sourceName}' is missing required property '{nameof(HomepageUrl)}'.");
-        var normalizedRepositoryUrl = AirAppMarketIndexDocument.NormalizeValue(RepositoryUrl)
-            ?? throw new InvalidOperationException(
-                $"Market index '{sourceName}' is missing required property '{nameof(RepositoryUrl)}'.");
-
-        AirAppMarketIndexDocument.EnsureUrl(normalizedDownloadUrl, nameof(DownloadUrl), sourceName);
-        AirAppMarketIndexDocument.EnsureUrl(normalizedIconUrl, nameof(IconUrl), sourceName);
-        AirAppMarketIndexDocument.EnsureUrl(normalizedHomepageUrl, nameof(HomepageUrl), sourceName);
-        AirAppMarketIndexDocument.EnsureUrl(normalizedRepositoryUrl, nameof(RepositoryUrl), sourceName);
-
-        if (PackageSizeBytes <= 0)
-        {
-            throw new InvalidOperationException(
-                $"Market index '{sourceName}' declares invalid packageSizeBytes '{PackageSizeBytes}' for plugin '{Id}'.");
-        }
-
-        if (PublishedAt == default || UpdatedAt == default)
-        {
-            throw new InvalidOperationException(
-                $"Market index '{sourceName}' is missing valid publish timestamps for plugin '{Id}'.");
-        }
-
-        return new AirAppMarketPluginEntry
-        {
-            Id = AirAppMarketIndexDocument.NormalizeValue(Id)
-                ?? throw new InvalidOperationException($"Market index '{sourceName}' is missing plugin id."),
-            Name = AirAppMarketIndexDocument.NormalizeValue(Name)
-                ?? throw new InvalidOperationException($"Market index '{sourceName}' is missing plugin name."),
-            Description = AirAppMarketIndexDocument.NormalizeValue(Description)
-                ?? throw new InvalidOperationException($"Market index '{sourceName}' is missing plugin description."),
-            Author = AirAppMarketIndexDocument.NormalizeValue(Author)
-                ?? throw new InvalidOperationException($"Market index '{sourceName}' is missing plugin author."),
-            Version = AirAppMarketIndexDocument.NormalizeVersion(Version, nameof(Version), sourceName),
-            ApiVersion = AirAppMarketIndexDocument.NormalizeVersion(ApiVersion, nameof(ApiVersion), sourceName),
-            MinHostVersion = AirAppMarketIndexDocument.NormalizeVersion(MinHostVersion, nameof(MinHostVersion), sourceName),
-            DownloadUrl = normalizedDownloadUrl,
-            Sha256 = normalizedSha,
-            PackageSizeBytes = PackageSizeBytes,
-            IconUrl = normalizedIconUrl,
-            HomepageUrl = normalizedHomepageUrl,
-            RepositoryUrl = normalizedRepositoryUrl,
-            Tags = normalizedTags,
-            PublishedAt = PublishedAt,
-            UpdatedAt = UpdatedAt,
-            ReleaseNotes = AirAppMarketIndexDocument.NormalizeValue(ReleaseNotes)
-                ?? throw new InvalidOperationException($"Market index '{sourceName}' is missing release notes for plugin '{Id}'.")
-        };
-    }
-
-    public string GetVersionSummary()
-    {
-        return string.Format(
-            CultureInfo.InvariantCulture,
-            "v{0} | API {1} | Host >= {2}",
-            Version,
-            ApiVersion,
-            MinHostVersion);
-    }
-}

LanAirApp/plugins/LanMountainDesktop.PluginMarketplace/LanMountainDesktop.PluginMarketplace.csproj

@@ -1,35 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-
-  <PropertyGroup>
-    <TargetFramework>net10.0</TargetFramework>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <Version>1.0.0</Version>
-    <EnableDynamicLoading>true</EnableDynamicLoading>
-    <OutputPath>bin\$(Configuration)\$(TargetFramework)\content\</OutputPath>
-    <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
-    <AppendRuntimeIdentifierToOutputPath>false</AppendRuntimeIdentifierToOutputPath>
-    <PluginPackageOutputDirectory>..\..\..\LanMountainDesktop\bin\$(Configuration)\$(TargetFramework)\Extensions\Plugins\</PluginPackageOutputDirectory>
-    <PluginPackagePath>$(PluginPackageOutputDirectory)$(AssemblyName).laapp</PluginPackagePath>
-    <PluginReleaseOutputDirectory>..\..\releases\</PluginReleaseOutputDirectory>
-    <PluginReleasePackagePath>$(PluginReleaseOutputDirectory)$(AssemblyName).$(Version).laapp</PluginReleasePackagePath>
-    <LegacyLoosePluginOutputDirectory>..\..\..\LanMountainDesktop\bin\$(Configuration)\$(TargetFramework)\Extensions\Plugins\PluginMarketplace\</LegacyLoosePluginOutputDirectory>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\LanMountainDesktop.PluginSdk\LanMountainDesktop.PluginSdk.csproj" Private="false" />
-    <None Include="plugin.json" CopyToOutputDirectory="PreserveNewest" />
-    <None Include="Localization\*.json" CopyToOutputDirectory="PreserveNewest" />
-  </ItemGroup>
-
-  <Target Name="CreateLaappPackage" AfterTargets="Build">
-    <MakeDir Directories="$(PluginPackageOutputDirectory)" />
-    <MakeDir Directories="$(PluginReleaseOutputDirectory)" />
-    <RemoveDir Directories="$(LegacyLoosePluginOutputDirectory)" />
-    <Delete Files="$(PluginPackagePath)" TreatErrorsAsWarnings="true" />
-    <Delete Files="$(PluginReleasePackagePath)" TreatErrorsAsWarnings="true" />
-    <ZipDirectory SourceDirectory="$(OutputPath)" DestinationFile="$(PluginPackagePath)" />
-    <Copy SourceFiles="$(PluginPackagePath)" DestinationFiles="$(PluginReleasePackagePath)" />
-  </Target>
-
-</Project>

LanAirApp/plugins/LanMountainDesktop.PluginMarketplace/Localization/en-US.json

@@ -1,37 +0,0 @@
-{
-  "market.page_title": "Plugin Marketplace",
-  "market.toolbar.search_placeholder": "Search plugins",
-  "market.toolbar.refresh": "Refresh",
-  "market.status.loading": "Loading the official plugin marketplace...",
-  "market.status.loaded_network_format": "Loaded {0} plugin(s) from the official source.",
-  "market.status.loaded_cache_format": "Official source unavailable. Loaded {0} plugin(s) from cache. Reason: {1}",
-  "market.status.load_failed_format": "Failed to load plugin marketplace: {0}",
-  "market.status.installing_format": "Downloading and staging plugin '{0}'...",
-  "market.status.install_success_format": "Plugin '{0}' has been staged. Restart the app to apply it.",
-  "market.status.install_failed_format": "Failed to install plugin: {0}",
-  "market.status.host_incompatible_format": "This host is too old. Version {0} or newer is required.",
-  "market.list.empty": "The plugin marketplace has not been loaded yet.",
-  "market.list.no_results": "No plugins match the current search.",
-  "market.card.subtitle_format": "{0} · v{1}",
-  "market.card.loaded": "Loaded",
-  "market.card.pending_restart": "Restart required",
-  "market.detail.placeholder": "Select a plugin from the left to inspect details.",
-  "market.detail.author": "Author",
-  "market.detail.version": "Version",
-  "market.detail.api_version": "API Version",
-  "market.detail.min_host_version": "Minimum Host Version",
-  "market.detail.installed_version": "Installed Version",
-  "market.detail.not_installed": "Not installed",
-  "market.detail.market_source": "Market Source",
-  "market.detail.homepage": "Homepage",
-  "market.detail.repository": "Repository",
-  "market.detail.release_notes": "Release Notes",
-  "market.detail.state.not_installed": "Not installed",
-  "market.detail.state.update_available": "Update available",
-  "market.detail.state.installed": "Installed",
-  "market.detail.unknown": "Unknown",
-  "market.button.install": "Install",
-  "market.button.update": "Update",
-  "market.button.installed": "Installed",
-  "market.button.installing": "Installing..."
-}

LanAirApp/plugins/LanMountainDesktop.PluginMarketplace/Localization/zh-CN.json

@@ -1,37 +0,0 @@
-{
-  "market.page_title": "插件市场",
-  "market.toolbar.search_placeholder": "搜索插件",
-  "market.toolbar.refresh": "刷新",
-  "market.status.loading": "正在加载官方插件市场…",
-  "market.status.loaded_network_format": "已从官方源加载 {0} 个插件。",
-  "market.status.loaded_cache_format": "官方源不可用，已从缓存加载 {0} 个插件。原因：{1}",
-  "market.status.load_failed_format": "加载插件市场失败：{0}",
-  "market.status.installing_format": "正在下载并暂存插件“{0}”…",
-  "market.status.install_success_format": "插件“{0}”已暂存完成，重启应用后生效。",
-  "market.status.install_failed_format": "安装插件失败：{0}",
-  "market.status.host_incompatible_format": "当前宿主版本过低，至少需要 {0}。",
-  "market.list.empty": "插件市场尚未加载。",
-  "market.list.no_results": "没有匹配的插件。",
-  "market.card.subtitle_format": "{0} · v{1}",
-  "market.card.loaded": "已加载",
-  "market.card.pending_restart": "需重启",
-  "market.detail.placeholder": "从左侧选择一个插件以查看详情。",
-  "market.detail.author": "作者",
-  "market.detail.version": "版本",
-  "market.detail.api_version": "API 版本",
-  "market.detail.min_host_version": "最低宿主版本",
-  "market.detail.installed_version": "当前已安装版本",
-  "market.detail.not_installed": "未安装",
-  "market.detail.market_source": "市场源",
-  "market.detail.homepage": "主页",
-  "market.detail.repository": "仓库",
-  "market.detail.release_notes": "发布说明",
-  "market.detail.state.not_installed": "未安装",
-  "market.detail.state.update_available": "可更新",
-  "market.detail.state.installed": "已安装",
-  "market.detail.unknown": "未知",
-  "market.button.install": "安装",
-  "market.button.update": "更新",
-  "market.button.installed": "已安装",
-  "market.button.installing": "安装中…"
-}

LanAirApp/plugins/LanMountainDesktop.PluginMarketplace/PluginMarketplacePlugin.cs

@@ -1,47 +0,0 @@
-using LanMountainDesktop.PluginSdk;
-
-namespace LanMountainDesktop.PluginMarketplace;
-
-[PluginEntrance]
-public sealed class PluginMarketplacePlugin : PluginBase, IDisposable
-{
-    private AirAppMarketIndexService? _indexService;
-    private AirAppMarketInstallService? _installService;
-
-    public override void Initialize(IPluginContext context)
-    {
-        Directory.CreateDirectory(context.DataDirectory);
-
-        var localizer = PluginLocalizer.Create(context);
-        var packageManager = context.GetService<IPluginPackageManager>()
-            ?? throw new InvalidOperationException(
-                "The host does not expose IPluginPackageManager. LanMountainDesktop.PluginMarketplace requires a newer host build.");
-
-        var cacheService = new AirAppMarketCacheService(context.DataDirectory);
-        _indexService = new AirAppMarketIndexService(cacheService);
-        _installService = new AirAppMarketInstallService(packageManager, context.DataDirectory);
-
-        context.RegisterService(cacheService);
-        context.RegisterService(_indexService);
-        context.RegisterService(_installService);
-
-        context.RegisterSettingsPage(new PluginSettingsPageRegistration(
-            "marketplace",
-            localizer.GetString("market.page_title", "插件市场"),
-            () => new PluginMarketplaceSettingsView(
-                context,
-                localizer,
-                packageManager,
-                _indexService,
-                _installService),
-            sortOrder: -100));
-    }
-
-    public void Dispose()
-    {
-        _installService?.Dispose();
-        _indexService?.Dispose();
-        _installService = null;
-        _indexService = null;
-    }
-}

LanAirApp/plugins/LanMountainDesktop.PluginMarketplace/PluginMarketplaceSettingsView.cs

@@ -1,727 +0,0 @@
-using System.Globalization;
-using Avalonia;
-using Avalonia.Controls;
-using Avalonia.Interactivity;
-using Avalonia.Layout;
-using Avalonia.Media;
-using LanMountainDesktop.PluginSdk;
-
-namespace LanMountainDesktop.PluginMarketplace;
-
-internal sealed class PluginMarketplaceSettingsView : UserControl
-{
-    private static readonly IBrush SurfaceBrush = new SolidColorBrush(Color.Parse("#14000000"));
-    private static readonly IBrush SelectedSurfaceBrush = new SolidColorBrush(Color.Parse("#1F0EA5E9"));
-    private static readonly IBrush SuccessBrush = new SolidColorBrush(Color.Parse("#FF0F766E"));
-    private static readonly IBrush WarningBrush = new SolidColorBrush(Color.Parse("#FF9A6700"));
-    private static readonly IBrush ErrorBrush = new SolidColorBrush(Color.Parse("#FFC42B1C"));
-
-    private readonly PluginLocalizer _localizer;
-    private readonly IPluginPackageManager _packageManager;
-    private readonly AirAppMarketIndexService _indexService;
-    private readonly AirAppMarketInstallService _installService;
-    private readonly Version? _hostVersion;
-
-    private readonly TextBox _searchTextBox;
-    private readonly Button _refreshButton;
-    private readonly TextBlock _statusTextBlock;
-    private readonly StackPanel _pluginListHost;
-    private readonly Border _detailBorder;
-
-    private AirAppMarketIndexDocument? _document;
-    private AirAppMarketPluginEntry? _selectedPlugin;
-    private Dictionary<string, InstalledPluginInfo> _installedPlugins = new(StringComparer.OrdinalIgnoreCase);
-    private bool _isRefreshing;
-    private bool _isInstalling;
-    private bool _hasLoadedOnce;
-
-    public PluginMarketplaceSettingsView(
-        IPluginContext context,
-        PluginLocalizer localizer,
-        IPluginPackageManager packageManager,
-        AirAppMarketIndexService indexService,
-        AirAppMarketInstallService installService)
-    {
-        _localizer = localizer;
-        _packageManager = packageManager;
-        _indexService = indexService;
-        _installService = installService;
-        _hostVersion = context.TryGetProperty<string>(PluginHostPropertyKeys.HostVersion, out var hostVersionText) &&
-                       AirAppMarketIndexDocument.TryParseVersion(hostVersionText, out var parsedHostVersion)
-            ? parsedHostVersion
-            : null;
-
-        _searchTextBox = new TextBox
-        {
-            MinWidth = 240,
-            Watermark = T("market.toolbar.search_placeholder", "搜索插件")
-        };
-        _searchTextBox.PropertyChanged += (_, e) =>
-        {
-            if (e.Property == TextBox.TextProperty)
-            {
-                RebuildSurface();
-            }
-        };
-
-        _refreshButton = new Button
-        {
-            Content = T("market.toolbar.refresh", "刷新"),
-            HorizontalAlignment = HorizontalAlignment.Left
-        };
-        _refreshButton.Click += OnRefreshClick;
-
-        _statusTextBlock = new TextBlock
-        {
-            Text = T("market.status.loading", "正在加载官方插件市场…"),
-            TextWrapping = TextWrapping.Wrap,
-            Foreground = WarningBrush
-        };
-
-        _pluginListHost = new StackPanel
-        {
-            Spacing = 10
-        };
-
-        _detailBorder = CreatePanelShell();
-
-        Content = BuildLayout();
-        AttachedToVisualTree += async (_, _) =>
-        {
-            if (_hasLoadedOnce)
-            {
-                return;
-            }
-
-            _hasLoadedOnce = true;
-            await RefreshAsync();
-        };
-    }
-
-    private Control BuildLayout()
-    {
-        var root = new Grid
-        {
-            RowDefinitions = new RowDefinitions("Auto,*"),
-            RowSpacing = 16
-        };
-
-        var toolbar = new Grid
-        {
-            ColumnDefinitions = new ColumnDefinitions("*,Auto"),
-            ColumnSpacing = 12
-        };
-
-        toolbar.Children.Add(new StackPanel
-        {
-            Spacing = 8,
-            Children =
-            {
-                new StackPanel
-                {
-                    Orientation = Orientation.Horizontal,
-                    Spacing = 10,
-                    Children =
-                    {
-                        _searchTextBox,
-                        _refreshButton
-                    }
-                },
-                _statusTextBlock
-            }
-        });
-
-        var contentGrid = new Grid
-        {
-            ColumnDefinitions = new ColumnDefinitions("360,*"),
-            ColumnSpacing = 16
-        };
-
-        var listShell = CreatePanelShell();
-        listShell.Child = new ScrollViewer
-        {
-            Content = _pluginListHost
-        };
-
-        contentGrid.Children.Add(listShell);
-        contentGrid.Children.Add(_detailBorder);
-        Grid.SetColumn(_detailBorder, 1);
-
-        root.Children.Add(toolbar);
-        root.Children.Add(contentGrid);
-        Grid.SetRow(contentGrid, 1);
-
-        return root;
-    }
-
-    private async void OnRefreshClick(object? sender, RoutedEventArgs e)
-    {
-        await RefreshAsync();
-    }
-
-    private async Task RefreshAsync()
-    {
-        if (_isRefreshing)
-        {
-            return;
-        }
-
-        _isRefreshing = true;
-        _refreshButton.IsEnabled = false;
-        SetStatus(T("market.status.loading", "正在加载官方插件市场…"), WarningBrush);
-
-        try
-        {
-            _installedPlugins = _packageManager
-                .GetInstalledPlugins()
-                .ToDictionary(plugin => plugin.Manifest.Id, StringComparer.OrdinalIgnoreCase);
-
-            var result = await _indexService.LoadAsync();
-            if (!result.Success || result.Document is null)
-            {
-                _document = null;
-                _selectedPlugin = null;
-                SetStatus(
-                    F("market.status.load_failed_format", "加载插件市场失败：{0}", result.ErrorMessage ?? T("market.detail.unknown", "未知错误")),
-                    ErrorBrush);
-                RebuildSurface();
-                return;
-            }
-
-            _document = result.Document;
-            _selectedPlugin = ResolveSelectedPlugin(_selectedPlugin?.Id, result.Document.Plugins);
-
-            var statusMessage = result.Source == AirAppMarketLoadSource.Cache
-                ? F(
-                    "market.status.loaded_cache_format",
-                    "官方源不可用，已从缓存加载 {0} 个插件。原因：{1}",
-                    result.Document.Plugins.Count,
-                    result.WarningMessage ?? T("market.detail.unknown", "未知错误"))
-                : F(
-                    "market.status.loaded_network_format",
-                    "已从官方源加载 {0} 个插件。",
-                    result.Document.Plugins.Count);
-
-            SetStatus(statusMessage, result.Source == AirAppMarketLoadSource.Cache ? WarningBrush : SuccessBrush);
-            RebuildSurface();
-        }
-        finally
-        {
-            _isRefreshing = false;
-            _refreshButton.IsEnabled = true;
-        }
-    }
-
-    private void RebuildSurface()
-    {
-        var filteredPlugins = GetFilteredPlugins();
-        if (filteredPlugins.Count > 0)
-        {
-            _selectedPlugin = ResolveSelectedPlugin(_selectedPlugin?.Id, filteredPlugins);
-        }
-        else
-        {
-            _selectedPlugin = null;
-        }
-
-        BuildPluginList(filteredPlugins);
-        BuildDetailPanel();
-    }
-
-    private List<AirAppMarketPluginEntry> GetFilteredPlugins()
-    {
-        if (_document is null)
-        {
-            return [];
-        }
-
-        var query = (_searchTextBox.Text ?? string.Empty).Trim();
-        var source = _document.Plugins;
-        if (string.IsNullOrWhiteSpace(query))
-        {
-            return source.ToList();
-        }
-
-        return source
-            .Where(plugin =>
-                plugin.Name.Contains(query, StringComparison.OrdinalIgnoreCase) ||
-                plugin.Description.Contains(query, StringComparison.OrdinalIgnoreCase) ||
-                plugin.Author.Contains(query, StringComparison.OrdinalIgnoreCase) ||
-                plugin.Id.Contains(query, StringComparison.OrdinalIgnoreCase) ||
-                plugin.Tags.Any(tag => tag.Contains(query, StringComparison.OrdinalIgnoreCase)))
-            .ToList();
-    }
-
-    private void BuildPluginList(IReadOnlyList<AirAppMarketPluginEntry> plugins)
-    {
-        _pluginListHost.Children.Clear();
-
-        if (_document is null)
-        {
-            _pluginListHost.Children.Add(CreateEmptyState(T("market.list.empty", "插件市场尚未加载。")));
-            return;
-        }
-
-        if (plugins.Count == 0)
-        {
-            _pluginListHost.Children.Add(CreateEmptyState(T("market.list.no_results", "没有匹配的插件。")));
-            return;
-        }
-
-        foreach (var plugin in plugins)
-        {
-            _pluginListHost.Children.Add(CreatePluginCard(plugin));
-        }
-    }
-
-    private Control CreatePluginCard(AirAppMarketPluginEntry plugin)
-    {
-        var installState = ResolveInstallState(plugin, out var installedPlugin);
-        var isSelected = string.Equals(_selectedPlugin?.Id, plugin.Id, StringComparison.OrdinalIgnoreCase);
-
-        var button = new Button
-        {
-            HorizontalContentAlignment = HorizontalAlignment.Stretch,
-            Padding = new Thickness(0),
-            Background = Brushes.Transparent,
-            BorderThickness = new Thickness(0),
-            Content = new Border
-            {
-                Background = isSelected ? SelectedSurfaceBrush : SurfaceBrush,
-                CornerRadius = new CornerRadius(16),
-                Padding = new Thickness(14),
-                Child = new StackPanel
-                {
-                    Spacing = 10,
-                    Children =
-                    {
-                        new Grid
-                        {
-                            ColumnDefinitions = new ColumnDefinitions("Auto,*"),
-                            ColumnSpacing = 12,
-                            Children =
-                            {
-                                CreateMonogramIcon(plugin.Name, 42),
-                                new StackPanel
-                                {
-                                    Spacing = 4,
-                                    Children =
-                                    {
-                                        new TextBlock
-                                        {
-                                            Text = plugin.Name,
-                                            FontSize = 16,
-                                            FontWeight = FontWeight.SemiBold,
-                                            TextWrapping = TextWrapping.Wrap
-                                        },
-                                        new TextBlock
-                                        {
-                                            Text = F("market.card.subtitle_format", "{0} · v{1}", plugin.Author, plugin.Version),
-                                            Foreground = Brushes.Gray,
-                                            TextWrapping = TextWrapping.Wrap
-                                        }
-                                    }
-                                }
-                            }
-                        },
-                        new TextBlock
-                        {
-                            Text = plugin.Description,
-                            TextWrapping = TextWrapping.Wrap,
-                            MaxHeight = 56
-                        },
-                        new StackPanel
-                        {
-                            Orientation = Orientation.Horizontal,
-                            Spacing = 8,
-                            Children =
-                            {
-                                CreateStateChip(T(StateKey(installState), StateFallback(installState))),
-                                CreateStateChip(installedPlugin?.IsLoaded == true
-                                    ? T("market.card.loaded", "已加载")
-                                    : T("market.card.pending_restart", "需重启")),
-                                new TextBlock
-                                {
-                                    Text = string.Join("  ", plugin.Tags.Take(3)),
-                                    VerticalAlignment = VerticalAlignment.Center,
-                                    Foreground = Brushes.Gray
-                                }
-                            }
-                        }
-                    }
-                }
-            }
-        };
-
-        button.Click += (_, _) =>
-        {
-            _selectedPlugin = plugin;
-            RebuildSurface();
-        };
-
-        return button;
-    }
-
-    private void BuildDetailPanel()
-    {
-        if (_selectedPlugin is null)
-        {
-            _detailBorder.Child = CreateEmptyState(T("market.detail.placeholder", "从左侧选择一个插件以查看详情。"));
-            return;
-        }
-
-        var plugin = _selectedPlugin;
-        var installState = ResolveInstallState(plugin, out var installedPlugin);
-        var isCompatible = IsCompatibleWithHost(plugin);
-        var installButton = new Button
-        {
-            Content = _isInstalling
-                ? T("market.button.installing", "安装中…")
-                : T(ButtonKey(installState), ButtonFallback(installState)),
-            IsEnabled = !_isInstalling && isCompatible && installState != AirAppMarketInstallState.Installed,
-            HorizontalAlignment = HorizontalAlignment.Left,
-            MinWidth = 120
-        };
-        installButton.Click += async (_, _) => await InstallSelectedPluginAsync(plugin);
-
-        var detailPanel = new StackPanel
-        {
-            Spacing = 14,
-            Children =
-            {
-                new Grid
-                {
-                    ColumnDefinitions = new ColumnDefinitions("Auto,*"),
-                    ColumnSpacing = 14,
-                    Children =
-                    {
-                        CreateMonogramIcon(plugin.Name, 64),
-                        new StackPanel
-                        {
-                            Spacing = 4,
-                            Children =
-                            {
-                                new TextBlock
-                                {
-                                    Text = plugin.Name,
-                                    FontSize = 24,
-                                    FontWeight = FontWeight.SemiBold,
-                                    TextWrapping = TextWrapping.Wrap
-                                },
-                                new TextBlock
-                                {
-                                    Text = plugin.Description,
-                                    TextWrapping = TextWrapping.Wrap
-                                }
-                            }
-                        }
-                    }
-                },
-                new StackPanel
-                {
-                    Orientation = Orientation.Horizontal,
-                    Spacing = 8,
-                    Children =
-                    {
-                        CreateStateChip(T(StateKey(installState), StateFallback(installState))),
-                        CreateStateChip(plugin.GetVersionSummary()),
-                        CreateStateChip(string.Join(", ", plugin.Tags))
-                    }
-                },
-                installButton,
-                CreateInfoRow(T("market.detail.author", "作者"), plugin.Author),
-                CreateInfoRow(T("market.detail.version", "版本"), plugin.Version),
-                CreateInfoRow(T("market.detail.api_version", "API 版本"), plugin.ApiVersion),
-                CreateInfoRow(T("market.detail.min_host_version", "最低宿主版本"), plugin.MinHostVersion),
-                CreateInfoRow(T("market.detail.installed_version", "当前已安装版本"), installedPlugin?.Manifest.Version ?? T("market.detail.not_installed", "未安装")),
-                CreateInfoRow(T("market.detail.market_source", "市场源"), AirAppMarketDefaults.DefaultIndexUrl),
-                CreateInfoRow(T("market.detail.homepage", "主页"), plugin.HomepageUrl),
-                CreateInfoRow(T("market.detail.repository", "仓库"), plugin.RepositoryUrl),
-                new TextBlock
-                {
-                    Text = T("market.detail.release_notes", "发布说明"),
-                    FontSize = 18,
-                    FontWeight = FontWeight.SemiBold
-                },
-                new Border
-                {
-                    Background = SurfaceBrush,
-                    CornerRadius = new CornerRadius(16),
-                    Padding = new Thickness(14),
-                    Child = new TextBlock
-                    {
-                        Text = plugin.ReleaseNotes,
-                        TextWrapping = TextWrapping.Wrap
-                    }
-                }
-            }
-        };
-
-        if (!isCompatible)
-        {
-            detailPanel.Children.Insert(
-                3,
-                new TextBlock
-                {
-                    Text = F(
-                        "market.status.host_incompatible_format",
-                        "当前宿主版本过低，至少需要 {0}。",
-                        plugin.MinHostVersion),
-                    Foreground = ErrorBrush,
-                    TextWrapping = TextWrapping.Wrap
-                });
-        }
-
-        _detailBorder.Child = new ScrollViewer
-        {
-            Content = detailPanel
-        };
-    }
-
-    private async Task InstallSelectedPluginAsync(AirAppMarketPluginEntry plugin)
-    {
-        if (_isInstalling)
-        {
-            return;
-        }
-
-        _isInstalling = true;
-        BuildDetailPanel();
-        SetStatus(
-            F("market.status.installing_format", "正在下载并暂存插件“{0}”…", plugin.Name),
-            WarningBrush);
-
-        try
-        {
-            var result = await _installService.InstallAsync(plugin);
-            if (!result.Success || result.InstallResult is null)
-            {
-                SetStatus(
-                    F(
-                        "market.status.install_failed_format",
-                        "安装插件失败：{0}",
-                        result.ErrorMessage ?? T("market.detail.unknown", "未知错误")),
-                    ErrorBrush);
-                return;
-            }
-
-            _installedPlugins = _packageManager
-                .GetInstalledPlugins()
-                .ToDictionary(item => item.Manifest.Id, StringComparer.OrdinalIgnoreCase);
-            SetStatus(
-                F(
-                    "market.status.install_success_format",
-                    "插件“{0}”已暂存完成，重启应用后生效。",
-                    result.InstallResult.Manifest.Name),
-                SuccessBrush);
-            RebuildSurface();
-        }
-        finally
-        {
-            _isInstalling = false;
-            BuildDetailPanel();
-        }
-    }
-
-    private AirAppMarketPluginEntry? ResolveSelectedPlugin(
-        string? selectedPluginId,
-        IReadOnlyList<AirAppMarketPluginEntry> plugins)
-    {
-        if (plugins.Count == 0)
-        {
-            return null;
-        }
-
-        if (!string.IsNullOrWhiteSpace(selectedPluginId))
-        {
-            var existing = plugins.FirstOrDefault(plugin =>
-                string.Equals(plugin.Id, selectedPluginId, StringComparison.OrdinalIgnoreCase));
-            if (existing is not null)
-            {
-                return existing;
-            }
-        }
-
-        return plugins[0];
-    }
-
-    private AirAppMarketInstallState ResolveInstallState(
-        AirAppMarketPluginEntry plugin,
-        out InstalledPluginInfo? installedPlugin)
-    {
-        if (!_installedPlugins.TryGetValue(plugin.Id, out installedPlugin))
-        {
-            return AirAppMarketInstallState.NotInstalled;
-        }
-
-        return CompareVersions(plugin.Version, installedPlugin.Manifest.Version) > 0
-            ? AirAppMarketInstallState.UpdateAvailable
-            : AirAppMarketInstallState.Installed;
-    }
-
-    private bool IsCompatibleWithHost(AirAppMarketPluginEntry plugin)
-    {
-        if (_hostVersion is null ||
-            !AirAppMarketIndexDocument.TryParseVersion(plugin.MinHostVersion, out var minHostVersion) ||
-            minHostVersion is null)
-        {
-            return true;
-        }
-
-        return _hostVersion >= minHostVersion;
-    }
-
-    private void SetStatus(string message, IBrush foreground)
-    {
-        _statusTextBlock.Text = message;
-        _statusTextBlock.Foreground = foreground;
-    }
-
-    private static int CompareVersions(string? left, string? right)
-    {
-        if (!AirAppMarketIndexDocument.TryParseVersion(left, out var leftVersion))
-        {
-            leftVersion = new Version(0, 0, 0);
-        }
-
-        if (!AirAppMarketIndexDocument.TryParseVersion(right, out var rightVersion))
-        {
-            rightVersion = new Version(0, 0, 0);
-        }
-
-        return (leftVersion ?? new Version(0, 0, 0)).CompareTo(rightVersion ?? new Version(0, 0, 0));
-    }
-
-    private Border CreatePanelShell()
-    {
-        return new Border
-        {
-            Background = SurfaceBrush,
-            CornerRadius = new CornerRadius(18),
-            Padding = new Thickness(16)
-        };
-    }
-
-    private Control CreateEmptyState(string text)
-    {
-        return new Border
-        {
-            Background = SurfaceBrush,
-            CornerRadius = new CornerRadius(16),
-            Padding = new Thickness(18),
-            Child = new TextBlock
-            {
-                Text = text,
-                TextWrapping = TextWrapping.Wrap
-            }
-        };
-    }
-
-    private Border CreateMonogramIcon(string text, double size)
-    {
-        var glyph = string.IsNullOrWhiteSpace(text) ? "?" : text.Trim()[0].ToString().ToUpperInvariant();
-        return new Border
-        {
-            Width = size,
-            Height = size,
-            CornerRadius = new CornerRadius(size / 2),
-            Background = new SolidColorBrush(Color.Parse("#FF0EA5E9")),
-            Child = new TextBlock
-            {
-                Text = glyph,
-                FontSize = Math.Max(16, size * 0.36),
-                FontWeight = FontWeight.Bold,
-                HorizontalAlignment = HorizontalAlignment.Center,
-                VerticalAlignment = VerticalAlignment.Center,
-                TextAlignment = TextAlignment.Center
-            }
-        };
-    }
-
-    private Border CreateStateChip(string text)
-    {
-        return new Border
-        {
-            Background = new SolidColorBrush(Color.Parse("#22000000")),
-            CornerRadius = new CornerRadius(999),
-            Padding = new Thickness(10, 4),
-            Child = new TextBlock
-            {
-                Text = text,
-                FontSize = 12
-            }
-        };
-    }
-
-    private Control CreateInfoRow(string label, string value)
-    {
-        return new StackPanel
-        {
-            Spacing = 4,
-            Children =
-            {
-                new TextBlock
-                {
-                    Text = label,
-                    FontSize = 12,
-                    Foreground = Brushes.Gray
-                },
-                new TextBlock
-                {
-                    Text = string.IsNullOrWhiteSpace(value) ? T("market.detail.unknown", "未知") : value,
-                    TextWrapping = TextWrapping.Wrap
-                }
-            }
-        };
-    }
-
-    private string T(string key, string fallback)
-    {
-        return _localizer.GetString(key, fallback);
-    }
-
-    private string F(string key, string fallback, params object[] args)
-    {
-        return string.Format(CultureInfo.CurrentCulture, T(key, fallback), args);
-    }
-
-    private static string StateKey(AirAppMarketInstallState state)
-    {
-        return state switch
-        {
-            AirAppMarketInstallState.UpdateAvailable => "market.detail.state.update_available",
-            AirAppMarketInstallState.Installed => "market.detail.state.installed",
-            _ => "market.detail.state.not_installed"
-        };
-    }
-
-    private static string StateFallback(AirAppMarketInstallState state)
-    {
-        return state switch
-        {
-            AirAppMarketInstallState.UpdateAvailable => "可更新",
-            AirAppMarketInstallState.Installed => "已安装",
-            _ => "未安装"
-        };
-    }
-
-    private static string ButtonKey(AirAppMarketInstallState state)
-    {
-        return state switch
-        {
-            AirAppMarketInstallState.UpdateAvailable => "market.button.update",
-            AirAppMarketInstallState.Installed => "market.button.installed",
-            _ => "market.button.install"
-        };
-    }
-
-    private static string ButtonFallback(AirAppMarketInstallState state)
-    {
-        return state switch
-        {
-            AirAppMarketInstallState.UpdateAvailable => "更新",
-            AirAppMarketInstallState.Installed => "已安装",
-            _ => "安装"
-        };
-    }
-}

LanAirApp/plugins/LanMountainDesktop.PluginMarketplace/plugin.json

@@ -1,9 +0,0 @@
-{
-  "id": "LanMountainDesktop.PluginMarketplace",
-  "name": "LanMountain Plugin Marketplace",
-  "description": "Official plugin marketplace for browsing and installing LanMountainDesktop plugins.",
-  "author": "LanMountainDesktop",
-  "version": "1.0.0",
-  "apiVersion": "1.0.0",
-  "entranceAssembly": "LanMountainDesktop.PluginMarketplace.dll"
-}

LanAirApp/samples/LanMountainDesktop.SamplePlugin/README.md

@@ -1,16 +1,9 @@
 # LanMountainDesktop.SamplePlugin
 
-这是阑山桌面的**示例开发插件**。
+## 中文
 
-它用于演示以下能力：
-- 插件入口与 `plugin.json` 清单
-- 插件服务注册
-- 插件设置页注册
-- 插件桌面组件注册
-- 插件内通信与状态更新
-- `.laapp` 打包与安装流程
-- 插件多语言资源组织方式
+这是阑山桌面的标准示例插件，用于演示插件清单、设置页、桌面组件、服务注册、本地化和 `.laapp` 打包流程。
 
-如果你要开发自己的插件，建议以这个目录为模板开始。
+## English
 
-这个目录仅用于示例开发与打包发布，不承载宿主应用内部的插件加载逻辑。
+This is the standard sample plugin used to demonstrate manifests, settings pages, desktop components, service registration, localization, and `.laapp` packaging.

LanAirApp/samples/README.md

@@ -1,11 +1,11 @@
-# 示例插件
+# 示例插件目录
 
-本目录用于存放阑山桌面的示例开发插件。
+## 中文
 
-当前示例：
-- `LanMountainDesktop.SamplePlugin`
+本目录用于存放阑山桌面的示例插件和参考实现。
 
-说明：
-- 这个插件是**示例开发插件**，用于演示插件项目结构、服务注册、设置页注册、桌面组件注册、`.laapp` 打包与安装流程。
-- 开发新插件时，建议直接从这个示例插件复制一份再修改。
-- 示例插件属于 `LanAirApp/` 对外开发工作区；宿主应用里的插件运行时与解析实现位于 `LanMountainDesktop/plugins/`。
+当前标准示例为 `LanMountainDesktop.SamplePlugin`。
+
+## English
+
+This directory stores sample plugins and reference implementations. The current standard sample is `LanMountainDesktop.SamplePlugin`.

LanAirApp/standards/README.md

@@ -1,11 +1,9 @@
-# 插件标准文件
+# 插件标准说明
 
-这里存放 LanMountainDesktop 插件开发所使用的标准模板与约定文件。
+## 中文
 
-当前标准：
-- 安装包扩展名：`.laapp`
-- 插件清单文件名：`plugin.json`
-- 多语言资源目录：`Localization/`
-- 建议内置语言文件：`zh-CN.json`、`en-US.json`
+本目录存放插件开发需要遵循的基础约定，包括 `.laapp`、`plugin.json`、`Localization/` 以及仓库根目录 README 和安装包等要求。
 
-创建新插件时，建议优先参考本目录中的模板文件。
+## English
+
+This directory stores the baseline conventions for plugin development, including `.laapp`, `plugin.json`, `Localization/`, and repository-root deliverables.

LanMountainDesktop/App.axaml

@@ -16,23 +16,6 @@
         <local:ViewLocator/>
     </Application.DataTemplates>
 
-    <TrayIcon.Icons>
-        <TrayIcons>
-            <TrayIcon Icon="/Assets/avalonia-logo.ico"
-                      ToolTipText="LanMountainDesktop">
-                <TrayIcon.Menu>
-                    <NativeMenu>
-                        <NativeMenuItem Header="设置" Click="OnTraySettingsClick" />
-                        <NativeMenuItemSeparator />
-                        <NativeMenuItem Header="重启应用" Click="OnTrayRestartClick" />
-                        <NativeMenuItemSeparator />
-                        <NativeMenuItem Header="退出应用" Click="OnTrayExitClick" />
-                    </NativeMenu>
-                </TrayIcon.Menu>
-            </TrayIcon>
-        </TrayIcons>
-    </TrayIcon.Icons>
-  
     <Application.Styles>
         <sty:FluentAvaloniaTheme />
         <mi:MaterialIconStyles />

LanMountainDesktop/App.axaml.cs

@@ -1,11 +1,12 @@
-using Avalonia;
+using Avalonia;
+using Avalonia.Controls;
 using Avalonia.Controls.ApplicationLifetimes;
 using Avalonia.Data.Core;
 using Avalonia.Data.Core.Plugins;
 using System;
-using System.Diagnostics;
 using System.Linq;
 using Avalonia.Markup.Xaml;
+using Avalonia.Platform;
 using Avalonia.Threading;
 using LanMountainDesktop.Services;
 using LanMountainDesktop.ViewModels;
@@ -16,13 +17,18 @@ namespace LanMountainDesktop;
 
 public partial class App : Application
 {
+    private readonly AppSettingsService _appSettingsService = new();
+    private readonly LocalizationService _localizationService = new();
+
     private SettingsWindow? _traySettingsWindow;
+    private TrayIcons? _trayIcons;
     private PluginRuntimeService? _pluginRuntimeService;
 
     public PluginRuntimeService? PluginRuntimeService => _pluginRuntimeService;
 
     public override void Initialize()
     {
+        AppLogger.Info("App", "Initializing application resources.");
         ConfigureWebViewUserDataFolder();
         AvaloniaWebViewBuilder.Initialize(default);
         AvaloniaXamlLoader.Load(this);
@@ -30,19 +36,29 @@ public partial class App : Application
 
     public override void OnFrameworkInitializationCompleted()
     {
+        AppLogger.Info("App", "Framework initialization completed.");
         LinuxDesktopEntryInstaller.EnsureInstalled();
         InitializePluginRuntime();
+        AppSettingsService.SettingsSaved += OnAppSettingsSaved;
+        InitializeTrayIcon();
 
         if (ApplicationLifetime is IClassicDesktopStyleApplicationLifetime desktop)
         {
-            // Avoid duplicate validations from both Avalonia and the CommunityToolkit. 
+            // Avoid duplicate validations from both Avalonia and the CommunityToolkit.
             // More info: https://docs.avaloniaui.net/docs/guides/development-guides/data-validation#manage-validationplugins
             DisableAvaloniaDataAnnotationValidation();
             desktop.ShutdownMode = Avalonia.Controls.ShutdownMode.OnExplicitShutdown;
+            desktop.Exit += (_, _) =>
+            {
+                AppLogger.Info("App", "Desktop lifetime exit triggered.");
+                AppSettingsService.SettingsSaved -= OnAppSettingsSaved;
+                DisposeTrayIcon();
+            };
             desktop.MainWindow = new MainWindow
             {
                 DataContext = new MainWindowViewModel(),
             };
+            AppLogger.Info("App", $"Main window created. LogFile={AppLogger.LogFilePath}");
         }
 
         base.OnFrameworkInitializationCompleted();
@@ -50,6 +66,8 @@ public partial class App : Application
 
     private void OnTrayExitClick(object? sender, EventArgs e)
     {
+        DisposeTrayIcon();
+
         if (ApplicationLifetime is IClassicDesktopStyleApplicationLifetime desktop)
         {
             desktop.Shutdown();
@@ -89,7 +107,7 @@ public partial class App : Application
             }
             catch (Exception ex)
             {
-                Debug.WriteLine($"[TraySettings] Failed to open settings window: {ex}");
+                AppLogger.Warn("TraySettings", "Failed to open settings window.", ex);
             }
         }, DispatcherPriority.Normal);
     }
@@ -99,6 +117,17 @@ public partial class App : Application
         AppRestartService.TryRestartApplication();
     }
 
+    private void OnAppSettingsSaved(string _)
+    {
+        Dispatcher.UIThread.Post(() =>
+        {
+            if (_trayIcons is not null)
+            {
+                InitializeTrayIcon();
+            }
+        }, DispatcherPriority.Background);
+    }
+
     private void DisableAvaloniaDataAnnotationValidation()
     {
         // Get an array of plugins to remove
@@ -133,9 +162,10 @@ public partial class App : Application
                 userDataFolder,
                 EnvironmentVariableTarget.Process);
         }
-        catch
+        catch (Exception ex)
         {
             // Keep startup resilient if user profile folders are unavailable.
+            AppLogger.Warn("WebView2", "Failed to configure WebView2 user data folder.", ex);
         }
     }
 
@@ -149,7 +179,77 @@ public partial class App : Application
         }
         catch (Exception ex)
         {
-            Debug.WriteLine($"[PluginRuntime] Failed to initialize plugin runtime: {ex}");
+            AppLogger.Warn("PluginRuntime", "Failed to initialize plugin runtime.", ex);
         }
     }
+
+    private void InitializeTrayIcon()
+    {
+        try
+        {
+            DisposeTrayIcon();
+
+            using var iconStream = AssetLoader.Open(new Uri("avares://LanMountainDesktop/Assets/avalonia-logo.ico"));
+            var trayIcon = new TrayIcon
+            {
+                Icon = new WindowIcon(iconStream),
+                ToolTipText = L("tray.tooltip", "LanMountainDesktop"),
+                Menu = BuildTrayMenu(),
+                IsVisible = true
+            };
+
+            _trayIcons = [trayIcon];
+            TrayIcon.SetIcons(this, _trayIcons);
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("TrayIcon", "Failed to initialize tray icon.", ex);
+        }
+    }
+
+    private NativeMenu BuildTrayMenu()
+    {
+        var menu = new NativeMenu();
+
+        var settingsItem = new NativeMenuItem(L("tray.menu.settings", "设置"));
+        settingsItem.Click += OnTraySettingsClick;
+        menu.Items.Add(settingsItem);
+
+        menu.Items.Add(new NativeMenuItemSeparator());
+
+        var restartItem = new NativeMenuItem(L("tray.menu.restart", "重启应用"));
+        restartItem.Click += OnTrayRestartClick;
+        menu.Items.Add(restartItem);
+
+        menu.Items.Add(new NativeMenuItemSeparator());
+
+        var exitItem = new NativeMenuItem(L("tray.menu.exit", "退出应用"));
+        exitItem.Click += OnTrayExitClick;
+        menu.Items.Add(exitItem);
+
+        return menu;
+    }
+
+    private void DisposeTrayIcon()
+    {
+        if (_trayIcons is null)
+        {
+            return;
+        }
+
+        TrayIcon.SetIcons(this, null);
+        foreach (var trayIcon in _trayIcons)
+        {
+            trayIcon.Dispose();
+        }
+
+        _trayIcons = null;
+    }
+
+    private string L(string key, string fallback)
+    {
+        var snapshot = _appSettingsService.Load();
+        var languageCode = _localizationService.NormalizeLanguageCode(snapshot.LanguageCode);
+        return _localizationService.GetString(languageCode, key, fallback);
+    }
 }

LanMountainDesktop/Assets/Fonts/MiSans-NOTICE.md

@@ -1,22 +1,35 @@
-# MiSans Font Notice
+# MiSans 字体说明
 
-This app bundles MiSans fonts for consistent cross-device rendering.
+## 中文
 
-## Included files
+本项目内置 MiSans 字体，用于在不同设备上保持相对一致的文字渲染效果。
+
+### 包含文件
 
 - `MiSans-Regular.ttf`
 - `MiSans-Semibold.ttf`
 - `MiSans-Bold.ttf`
 
-## Source
+### 来源
+
+- 上游仓库：https://github.com/dsrkafuu/misans
+- 上游所引用的小米字体页面：https://hyperos.mi.com/font/zh/
+
+### 许可与使用说明
+
+- 上游脚本或打包仓库使用 Apache-2.0 许可。
+- MiSans 字体本身的版权和补充使用条款以小米官方说明为准：
+  - https://hyperos.mi.com/font-download/MiSans%E5%AD%97%E4%BD%93%E7%9F%A5%E8%AF%86%E4%BA%A7%E6%9D%83%E8%AE%B8%E5%8F%AF%E5%8D%8F%E8%AE%AE.pdf
+
+在重新分发本项目时，请自行确认并遵守 MiSans 字体的相关条款。
+
+## English
+
+This project bundles MiSans fonts for more consistent cross-device rendering.
+
+### Sources
 
 - Upstream package repository: https://github.com/dsrkafuu/misans
-- Original font source referenced by upstream: https://hyperos.mi.com/font/zh/
+- Xiaomi font source page: https://hyperos.mi.com/font/zh/
 
-## License and usage notes
-
-- Script/package license in upstream repository: Apache-2.0
-- MiSans font copyright and additional usage terms:
-  https://hyperos.mi.com/font-download/MiSans%E5%AD%97%E4%BD%93%E7%9F%A5%E8%AF%86%E4%BA%A7%E6%9D%83%E8%AE%B8%E5%8F%AF%E5%8D%8F%E8%AE%AE.pdf
-
-Please review and comply with the MiSans font terms when distributing this app.
+Please review and comply with the MiSans font terms before redistributing this application.

LanMountainDesktop/Assets/Weather/ATTRIBUTION.md

@@ -1,9 +1,12 @@
-# Weather Background Assets
+# 天气背景资源署名
 
-Weather card background images are sourced from **Pexels** and used under the Pexels license:
-https://www.pexels.com/license/
+## 中文
 
-## Sources
+本目录中的天气背景图像主要来自 **Pexels**，并按 Pexels License 使用：
+
+- License: https://www.pexels.com/license/
+
+### 原始来源
 
 - `clear_sky.jpg`
   - https://www.pexels.com/photo/a-clear-blue-sky-with-few-clouds-on-a-sunny-day-29390199/
@@ -14,16 +17,24 @@ https://www.pexels.com/license/
 - `storm.jpg`
   - https://www.pexels.com/photo/sea-under-a-stormy-sky-4609228/
 
-## Derived Variants (for widget scene mapping)
+### 派生资源
 
-The following files are generated from the above base assets by color grading/brightness adjustments to match the ColorOS-like weather card style:
+以下文件由上述基础图片经过色彩、亮度或风格调整后生成，用于适配阑山桌面的天气组件视觉：
 
-- `clear_day.jpg` (from `clear_sky.jpg`)
-- `clear_night.jpg` (from `clear_sky.jpg`)
-- `cloudy_day.jpg` (from `clear_sky.jpg`)
-- `cloudy_night.jpg` (from `clear_sky.jpg`)
-- `rain_light.jpg` (from `rain.jpg`)
-- `rain_heavy.jpg` (from `rain.jpg`)
-- `storm_dark.jpg` (from `storm.jpg`)
-- `fog_haze.jpg` (from `storm.jpg`)
-- `snow_soft.jpg` (from `snow.jpg`)
+- `clear_day.jpg`
+- `clear_night.jpg`
+- `cloudy_day.jpg`
+- `cloudy_night.jpg`
+- `rain_light.jpg`
+- `rain_heavy.jpg`
+- `storm_dark.jpg`
+- `fog_haze.jpg`
+- `snow_soft.jpg`
+
+## English
+
+The weather background images in this directory are primarily sourced from **Pexels** and used under the Pexels License:
+
+- License: https://www.pexels.com/license/
+
+Derived variants in this repository are adjusted from the listed base assets for widget presentation.

LanMountainDesktop/Assets/Weather/HyperOS3/ATTRIBUTION.md

@@ -1,45 +1,23 @@
-# HyperOS3 Weather Assets (Official Xiaomi Package)
+# HyperOS3 天气资源署名
+
+## 中文
+
+本目录中的 HyperOS3 风格天气资源来自用户提供的 Xiaomi Weather 安装包提取内容，以及基于该视觉方向制作的项目内派生资源。
+
+### 提取来源
 
-These assets were extracted from the official Xiaomi Weather APK provided by the user:
 - Source APK: `c:\Program Files\Netease\GameViewer\Download\MI SKY 12.apk`
-- Package: `com.miui.weather2` (Mi Weather)
-- Extraction date: 2026-03-03
+- Package: `com.miui.weather2`
+- Extraction date: `2026-03-03`
 
-Extracted source paths inside APK:
-- `assets/map_custom/particle/sun_0.png` -> `hyper_sun_core.png`
-- `assets/map_custom/particle/sun_1.png` -> `hyper_sun_ring.png`
-- `assets/map_custom/particle/fog.png` -> `hyper_fog.png`
-- `assets/map_custom/particle/haze.png` -> `hyper_haze.png`
-- `assets/map_custom/particle/rain.png` -> `hyper_rain_drop.png`
-- `assets/map_custom/particle/snow.png` -> `hyper_snow_flake.png`
-- `assets/map_custom/skybox/top.png` -> `hyper_sky_top.png`
-- `assets/map_custom/skybox/back.png` -> `hyper_sky_back.png`
-- `assets/map_custom/skybox/front.png` -> `hyper_sky_front.png`
-- `assets/map_custom/skybox/left.png` -> `hyper_sky_left.png`
-- `assets/map_custom/skybox/right.png` -> `hyper_sky_right.png`
-- `assets/map_custom/skybox/bottom.png` -> `hyper_sky_bottom.png`
-- `assets/map_assets/VM3DRes/cross_sky_day.png` -> `hyper_cross_sky_day.png`
-- `assets/map_assets/VM3DRes/cross_sky_night.png` -> `hyper_cross_sky_night.png`
+### 用途说明
 
-Extracted weather icon paths inside APK (`res/*.webp`):
-- `res/aO.webp` -> `Icons/icon_sunny_day.webp`
-- `res/k2.webp` -> `Icons/icon_moon_clear.webp`
-- `res/Ip.webp` -> `Icons/icon_partly_cloudy_day.webp`
-- `res/HI.webp` -> `Icons/icon_partly_cloudy_night.webp`
-- `res/E4.webp` -> `Icons/icon_cloudy.webp`
-- `res/5f.webp` -> `Icons/icon_rain_light.webp`
-- `res/fO.webp` -> `Icons/icon_rain_heavy.webp`
-- `res/lV1.webp` -> `Icons/icon_thunder.webp`
-- `res/mH1.webp` -> `Icons/icon_snow.webp`
-- `res/jB.webp` -> `Icons/icon_sleet.webp`
-- `res/Wl.webp` -> `Icons/icon_haze.webp`
-- `res/Mg.webp` -> `Icons/icon_windy.webp`
+- 这些资源仅用于项目内部视觉研究、原型还原和界面适配。
+- 使用时应遵守小米相关许可与使用条款。
 
-Use only according to Xiaomi's applicable license and usage terms.
+### 额外派生资源
 
-## Soft Widget Icon Set (2026-03-05)
-
-To better match the Xiaomi weather time-card visual hierarchy, an additional local icon set was generated for this project:
+以下文件为项目内基于上述视觉方向制作的派生素材：
 
 - `Icons/icon_hero_sun_soft.png`
 - `Icons/icon_hero_moon_soft.png`
@@ -52,4 +30,8 @@ To better match the Xiaomi weather time-card visual hierarchy, an additional loc
 - `Icons/icon_mini_snow_soft.png`
 - `Icons/icon_mini_fog_soft.png`
 
-These files are original derivative assets generated in-repo with local tooling, using the extracted Xiaomi package visual direction as reference (soft glow hero icon + lightweight forecast icons).
+## English
+
+The HyperOS3-style weather assets in this directory were extracted from a Xiaomi Weather APK provided by the user, together with additional derivative assets created in-repo to match the same visual direction.
+
+Use these resources only in accordance with Xiaomi's applicable license and usage terms.

LanMountainDesktop/ComponentSystem/README.md

@@ -1,77 +1,38 @@
-# 组件系统模块（Component System Module）
+# 组件系统说明
 
-本目录提供组件系统的模块化基础，用于支持内置组件管理与第三方扩展接入。  
-This directory provides the modular foundation for built-in component management and third-party extension integration.
+## 中文
 
-## 核心文件职责（Core Files）
-- `BuiltInComponentIds.cs`：内置组件 ID 常量（例如 `Clock`）。  
-  Built-in component ID constants (for example `Clock`).
-- `DesktopComponentDefinition.cs`：组件元数据定义（名称、类别、最小尺寸、可放置区域等）。  
-  Component metadata model (name, category, minimum size, placement permissions).
-- `ComponentPlacementRules.cs`：组件放置规则（最小尺寸、状态栏高度限制、网格边界约束）。  
-  Placement rules (minimum size, status-bar height rule, grid clamping).
-- `ComponentRegistry.cs`：组件注册中心，负责内置组件与扩展组件合并。  
-  Registry that merges built-in and extension components.
-- `Extensions/IComponentExtensionProvider.cs`：扩展提供者接口契约。  
-  Extension provider interface contract.
-- `Extensions/JsonComponentExtensionProvider.cs`：基于 JSON 的扩展加载器。  
-  JSON-based extension loader.
+`ComponentSystem/` 提供阑山桌面组件定义、注册和扩展的基础能力。
 
-## 第三方扩展契约（Extension Contract）
-- 第三方可通过实现 `IComponentExtensionProvider` 提供组件定义。  
-  Third parties can provide component definitions via `IComponentExtensionProvider`.
-- 当前内置了 JSON 提供者，运行时扫描目录：  
-  Built-in JSON provider scans at runtime:
-  - `Extensions/Components/*.json`（相对应用输出目录）  
-    `Extensions/Components/*.json` (relative to app output directory)
+### 主要职责
 
-## 加载流程（Load Flow）
-1. `ComponentRegistry.CreateDefault()` 先注册内置组件。  
-   Register built-in components first via `ComponentRegistry.CreateDefault()`.
-2. 调用 `.RegisterExtensions(...)` 合并扩展组件。  
-   Merge extension components via `.RegisterExtensions(...)`.
-3. 主窗口通过注册中心校验组件合法性与放置权限。  
-   Main window validates component identity and placement permission through the registry.
+- 管理内置组件 ID 和元数据
+- 约束组件最小尺寸与可放置区域
+- 合并内置组件与扩展组件
+- 通过 JSON 或扩展提供者接入第三方组件
 
-## JSON 清单格式（Manifest Schema）
-JSON 文件为数组，每一项代表一个组件定义。  
-The JSON file is an array, where each item represents one component definition.
+### 关键文件
 
-```json
-[
-  {
-    "id": "Weather",
-    "displayName": "Weather",
-    "iconKey": "WeatherSunny",
-    "category": "Status",
-    "minWidthCells": 1,
-    "minHeightCells": 1,
-    "allowStatusBarPlacement": true,
-    "allowDesktopPlacement": true
-  }
-]
-```
+- `BuiltInComponentIds.cs`：内置组件 ID 常量
+- `DesktopComponentDefinition.cs`：组件元数据模型
+- `ComponentPlacementRules.cs`：放置规则
+- `ComponentRegistry.cs`：组件注册中心
+- `Extensions/IComponentExtensionProvider.cs`：扩展提供者接口
+- `Extensions/JsonComponentExtensionProvider.cs`：JSON 扩展加载器
 
-字段说明（Field notes）：
-- `id`：组件唯一 ID（建议英文、稳定不变）。  
-  Unique component ID (prefer stable English key).
-- `displayName`：显示名。  
-  Display name.
-- `iconKey`：图标键（由上层 UI 解释）。  
-  Icon key resolved by UI layer.
-- `category`：组件分类。  
-  Component category.
-- `minWidthCells` / `minHeightCells`：最小占格，必须满足 `>= 1`。  
-  Minimum cell size, must satisfy `>= 1`.
-- `allowStatusBarPlacement`：是否允许放到顶部状态栏。  
-  Whether placing in top status bar is allowed.
-- `allowDesktopPlacement`：是否允许放到桌面区域。  
-  Whether placing in desktop area is allowed.
+### 扩展方式
 
-## 放置规则摘要（Placement Rules Summary）
-- 最小尺寸约束：`minWidthCells >= 1` 且 `minHeightCells >= 1`。  
-  Minimum size constraint: `minWidthCells >= 1` and `minHeightCells >= 1`.
-- 状态栏约束：状态栏组件高度必须为 `1` 格。  
-  Status bar constraint: component height must be exactly `1` cell.
-- 越界约束：所有组件坐标会被网格边界钳制（clamp）。  
-  Out-of-bounds constraint: component coordinates are clamped to grid bounds.
+- 当前默认扫描 `Extensions/Components/*.json`
+- 组件清单定义显示名、分类、最小尺寸和可放置区域
+- 主程序通过注册中心统一验证组件是否合法
+
+## English
+
+`ComponentSystem/` contains the foundation for component definition, registration, and extension in LanMountainDesktop.
+
+### Responsibilities
+
+- manage built-in component IDs and metadata
+- enforce placement rules
+- merge built-in and extension components
+- support third-party registration through JSON or provider contracts

LanMountainDesktop/LanMountainDesktop.csproj

@@ -40,6 +40,7 @@
     </PackageReference>
     <PackageReference Include="CommunityToolkit.Mvvm" Version="8.2.1" />
     <PackageReference Include="DotNetCampus.AvaloniaInkCanvas" Version="1.0.1" />
+    <PackageReference Include="Downloader" Version="4.1.1" />
     <PackageReference Include="FluentAvaloniaUI" Version="2.5.0" />
     <PackageReference Include="FluentIcons.Avalonia" Version="2.0.319" />
     <PackageReference Include="FluentIcons.Avalonia.Fluent" Version="2.0.319" />

LanMountainDesktop/Localization/en-US.json

@@ -1,5 +1,9 @@
 {
     "app.title":  "LanMountainDesktop",
+    "tray.tooltip":  "LanMountainDesktop",
+    "tray.menu.settings":  "Settings",
+    "tray.menu.restart":  "Restart App",
+    "tray.menu.exit":  "Exit App",
     "button.back_to_windows":  "Back to Windows",
     "tooltip.back_to_windows":  "Back to Windows",
     "tooltip.open_settings":  "Settings",
@@ -302,15 +306,17 @@
     "settings.launcher.hidden_empty":  "No hidden items.",
     "settings.launcher.hidden_type_folder":  "Folder",
     "settings.launcher.hidden_type_shortcut":  "Shortcut",
-    "settings.launcher.restore_button":  "Show Again",
+    "settings.launcher.restore_button":  "Unhide",
     "settings.plugins.title":  "Plugins",
     "settings.plugins.runtime_header":  "Plugin Runtime",
     "settings.plugins.runtime_desc":  "Review plugin runtime state and load results.",
     "settings.plugins.runtime_hint":  "This page shows discovery status, load results, and runtime diagnostics for installed plugins.",
     "settings.plugins.runtime_status":  "Plugin runtime status will appear here after plugin discovery completes.",
     "settings.plugins.installed_header":  "Installed Plugins",
-    "settings.plugins.installed_desc":  "Enable or disable plugins here. Detailed plugin settings appear as separate settings pages.",
-    "settings.plugins.restart_hint":  "Plugin enable state changes take effect after restarting the app.",
+    "settings.plugins.installed_desc":  "Review installed plugins and remove them here.",
+    "settings.plugins.import_header":  "Install From Package",
+    "settings.plugins.import_desc":  "Open a .laapp package and stage it into the local plugin directory.",
+    "settings.plugins.restart_hint":  "Plugin installation and deletion changes take effect after restarting the app.",
     "settings.plugins.empty":  "No plugins found.",
     "settings.plugins.runtime_unavailable":  "Plugin runtime is not available.",
     "settings.plugins.summary_format":  "Detected {0} plugin(s); enabled {1}; loaded {2}; settings pages {3}; widgets {4}; failures {5}.",
@@ -325,6 +331,7 @@
     "settings.plugins.toggle_result_format":  "Plugin '{0}' was {1} for the next launch. Restart the app to apply page and widget changes.",
     "settings.plugins.toggle_state_enabled":  "enabled",
     "settings.plugins.toggle_state_disabled":  "disabled",
+    "settings.plugins.toggle_failed_detail_format":  "Failed to update plugin '{0}': {1}",
     "settings.plugins.install_button":  "Open .laapp package",
     "settings.plugins.install_unavailable":  "Plugin runtime is unavailable, so .laapp packages cannot be installed right now.",
     "settings.plugins.install_hint_format":  "Open a .laapp package to install it into: {0}",
@@ -334,14 +341,20 @@
     "settings.plugins.install_copy_failed":  "Failed to copy the selected .laapp package.",
     "settings.plugins.install_success_format":  "Installed plugin '{0}'. Restart the app to apply newly added settings pages and widgets.",
     "settings.plugins.install_failed_format":  "Failed to install plugin package: {0}",
+    "settings.plugins.delete_button":  "Delete plugin",
+    "settings.plugins.delete_success_format":  "Plugin '{0}' was staged for deletion. Restart the app to finish removing it.",
+    "settings.plugins.delete_failed_format":  "Failed to delete plugin: {0}",
+    "settings.plugins.delete_failed_detail_format":  "Failed to delete plugin '{0}': {1}",
+    "settings.plugins.publisher_format":  "Publisher: {0}",
+    "settings.plugins.publisher_unknown":  "Unknown publisher",
     "settings.plugins.source_package":  ".laapp package",
     "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...",
@@ -364,6 +377,15 @@
     "market.detail.min_host_version":  "Minimum Host Version",
     "market.detail.installed_version":  "Installed Version",
     "market.detail.not_installed":  "Not installed",
+    "market.detail.readme":  "README",
+    "market.detail.plugin_information":  "Plugin Information",
+    "market.detail.author_subtitle_format":  "By {0}",
+    "market.detail.package_size":  "Package Size",
+    "market.detail.published_at":  "Published At",
+    "market.detail.updated_at":  "Updated At",
+    "market.detail.tags":  "Tags",
+    "market.detail.project":  "Project",
+    "market.detail.state":  "Install State",
     "market.detail.market_source":  "Market Source",
     "market.detail.homepage":  "Homepage",
     "market.detail.repository":  "Repository",

LanMountainDesktop/Localization/zh-CN.json

@@ -1,5 +1,9 @@
 {
     "app.title":  "LanMountainDesktop",
+    "tray.tooltip":  "LanMountainDesktop",
+    "tray.menu.settings":  "设置",
+    "tray.menu.restart":  "重启应用",
+    "tray.menu.exit":  "退出应用",
     "button.back_to_windows":  "回到Windows",
     "tooltip.back_to_windows":  "回到Windows",
     "tooltip.open_settings":  "设置",
@@ -302,15 +306,17 @@
     "settings.launcher.hidden_empty":  "暂无隐藏项目。",
     "settings.launcher.hidden_type_folder":  "文件夹",
     "settings.launcher.hidden_type_shortcut":  "快捷方式",
-    "settings.launcher.restore_button":  "重新显示",
+    "settings.launcher.restore_button":  "取消隐藏",
     "settings.plugins.title":  "插件",
     "settings.plugins.runtime_header":  "插件运行时",
     "settings.plugins.runtime_desc":  "查看插件运行时状态、加载结果与诊断信息。",
     "settings.plugins.runtime_hint":  "这里展示已安装插件的发现结果、加载状态和运行时诊断信息。",
     "settings.plugins.runtime_status":  "插件扫描完成后，运行时状态会显示在这里。",
     "settings.plugins.installed_header":  "已安装插件",
-    "settings.plugins.installed_desc":  "在这里启用或禁用插件。插件自己的详细设置会作为独立设置页出现。",
-    "settings.plugins.restart_hint":  "插件启用状态变更会在重启应用后生效。",
+    "settings.plugins.installed_desc":  "在这里查看和删除已安装的插件。",
+    "settings.plugins.import_header":  "从安装包导入",
+    "settings.plugins.import_desc":  "打开一个 .laapp 插件包，并将其暂存到本地插件目录。",
+    "settings.plugins.restart_hint":  "插件安装和删除变更会在重启应用后生效。",
     "settings.plugins.empty":  "未找到插件。",
     "settings.plugins.runtime_unavailable":  "插件运行时不可用。",
     "settings.plugins.summary_format":  "共检测到 {0} 个插件；已启用 {1} 个；已加载 {2} 个；设置页 {3} 个；组件 {4} 个；失败 {5} 个。",
@@ -325,6 +331,7 @@
     "settings.plugins.toggle_result_format":  "插件“{0}”已在下次启动时设为{1}。重启应用后，设置页和组件变更才会生效。",
     "settings.plugins.toggle_state_enabled":  "启用",
     "settings.plugins.toggle_state_disabled":  "禁用",
+    "settings.plugins.toggle_failed_detail_format":  "更新插件“{0}”状态失败：{1}",
     "settings.plugins.install_button":  "打开 .laapp 插件包",
     "settings.plugins.install_unavailable":  "插件运行时不可用，暂时无法安装 .laapp 插件包。",
     "settings.plugins.install_hint_format":  "打开一个 .laapp 插件包，安装到：{0}",
@@ -334,14 +341,20 @@
     "settings.plugins.install_copy_failed":  "复制所选 .laapp 插件包失败。",
     "settings.plugins.install_success_format":  "插件“{0}”安装完成。重启应用后，新增的设置页和组件才会生效。",
     "settings.plugins.install_failed_format":  "安装插件包失败：{0}",
+    "settings.plugins.delete_button":  "删除插件",
+    "settings.plugins.delete_success_format":  "插件“{0}”已暂存删除。重启应用后会完成移除。",
+    "settings.plugins.delete_failed_format":  "删除插件失败：{0}",
+    "settings.plugins.delete_failed_detail_format":  "删除插件“{0}”失败：{1}",
+    "settings.plugins.publisher_format":  "发布者：{0}",
+    "settings.plugins.publisher_unknown":  "未知发布者",
     "settings.plugins.source_package":  ".laapp 包",
     "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":  "正在加载官方插件市场...",
@@ -364,6 +377,15 @@
     "market.detail.min_host_version":  "最低宿主版本",
     "market.detail.installed_version":  "已安装版本",
     "market.detail.not_installed":  "未安装",
+    "market.detail.readme":  "README",
+    "market.detail.plugin_information":  "插件信息",
+    "market.detail.author_subtitle_format":  "作者：{0}",
+    "market.detail.package_size":  "包大小",
+    "market.detail.published_at":  "首次发布",
+    "market.detail.updated_at":  "最近更新",
+    "market.detail.tags":  "标签",
+    "market.detail.project":  "项目",
+    "market.detail.state":  "安装状态",
     "market.detail.market_source":  "市场源",
     "market.detail.homepage":  "主页",
     "market.detail.repository":  "仓库",

LanMountainDesktop/PACKAGING.md

@@ -1,75 +1,51 @@
-# Desktop Packaging Guide
+# 桌面端打包指南
 
-## Prerequisites
-- Install `.NET SDK 10`
-- Windows installer build only:
-  - Install `Inno Setup 6` (`ISCC.exe`)
+## 中文
 
-## Local packaging commands
+本指南说明阑山桌面的本地打包和 CI 打包流程。
+
+### 前置条件
+
+- 安装 .NET SDK 10
+- Windows 安装包需要 Inno Setup 6（`ISCC.exe`）
+
+### 本地打包命令
+
+#### Windows 安装包
 
-### Windows installer (`win-x64`)
 ```powershell
 .\scripts\package.ps1 -RuntimeIdentifier win-x64 -Version 1.0.1
 ```
 
-Output:
-- Published files: `artifacts/publish/win-x64`
-- Installer: `artifacts/installer`
+#### Linux 包
 
-### Linux package (`linux-x64`)
 ```powershell
 pwsh ./scripts/package.ps1 -RuntimeIdentifier linux-x64 -Version 1.0.1
 ```
 
-Output:
-- Published files: `artifacts/publish/linux-x64`
-- Zip package: `artifacts/packages/LanMountainDesktop-1.0.1-linux-x64.zip`
+#### macOS 包
 
-### macOS package (`osx-x64`)
 ```powershell
 pwsh ./scripts/package.ps1 -RuntimeIdentifier osx-x64 -Version 1.0.1
 ```
 
-Output:
-- Published files: `artifacts/publish/osx-x64`
-- Zip package: `artifacts/packages/LanMountainDesktop-1.0.1-osx-x64.zip`
+### 产物位置
 
-## Optional script flags
-```powershell
-# Publish only (skip Windows installer step)
-.\scripts\package.ps1 -RuntimeIdentifier win-x64 -SkipInstaller
+- 发布目录：`artifacts/publish/<rid>`
+- 安装包或压缩包：`artifacts/installer` 或 `artifacts/packages`
 
-# Publish only (skip Linux/macOS zip package step)
-pwsh ./scripts/package.ps1 -RuntimeIdentifier linux-x64 -SkipArchive
-```
+### CI 流程
 
-## Runtime dependency notes
-- Linux build does not bundle a native `libvlc` package from NuGet.
-  - Install VLC runtime on target machine, for example:
-    - Ubuntu/Debian: `sudo apt install vlc libvlc-dev`
-- macOS packaging target in CI is currently `osx-x64`.
+- 工作流文件：`.github/workflows/windows-ci.yml`
+- 日常构建会验证桌面端可编译
+- 手动触发或 `v*` 标签可生成正式包并上传到 Release
 
-## CI workflow
-- Workflow file: `.github/workflows/windows-ci.yml`
-- Workflow name: `Desktop CI`
+## English
 
-Jobs:
-- `Validate Build (Windows)` runs on every push and pull request.
-- Package flow runs on manual trigger or `v*` tag push:
-  - `Resolve Package Version` (single shared version source)
-  - `Package (Windows)` (`win-x64` installer)
-  - `Package (Linux)` (`linux-x64` zip)
-  - `Package (macOS)` (`osx-x64` zip)
-- On `v*` tags, `Attach Artifacts to GitHub Release` uploads Windows/Linux/macOS packages to the release.
+This guide covers local packaging and CI packaging for LanMountainDesktop.
 
-### Trigger manual packaging
-1. Open GitHub Actions.
-2. Choose `Desktop CI`.
-3. Click `Run workflow`.
-4. Optional: set `version` input, for example `1.0.1`.
+### Key points
 
-### Trigger by tag
-```powershell
-git tag v1.0.1
-git push origin v1.0.1
-```
+- use `scripts/package.ps1` with the target runtime identifier
+- Windows installer requires Inno Setup
+- CI can publish artifacts and attach them to GitHub Releases

LanMountainDesktop/Program.cs

@@ -2,6 +2,7 @@ using Avalonia;
 using Avalonia.WebView.Desktop;
 using LanMountainDesktop.Services;
 using System;
+using System.Threading.Tasks;
 
 namespace LanMountainDesktop;
 
@@ -11,8 +12,27 @@ sealed class Program
     // SynchronizationContext-reliant code before AppMain is called: things aren't initialized
     // yet and stuff might break.
     [STAThread]
-    public static void Main(string[] args) => BuildAvaloniaApp(LoadConfiguredRenderMode())
-        .StartWithClassicDesktopLifetime(args);
+    public static void Main(string[] args)
+    {
+        AppLogger.Initialize();
+        RegisterGlobalExceptionLogging();
+
+        var diagnostics = StartupDiagnosticsService.Run(args);
+        StartupDiagnosticsService.ShowLegacyExecutableWarningIfNeeded(diagnostics);
+
+        try
+        {
+            var renderMode = LoadConfiguredRenderMode();
+            AppLogger.Info("Startup", $"Resolved render mode '{renderMode}'.");
+            BuildAvaloniaApp(renderMode).StartWithClassicDesktopLifetime(args);
+            AppLogger.Info("Startup", "Application exited normally.");
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Critical("Startup", "Application terminated during startup.", ex);
+            throw;
+        }
+    }
 
     // Avalonia configuration, don't remove; also used by visual designer.
     public static AppBuilder BuildAvaloniaApp(string renderMode = AppRenderingModeHelper.Default)
@@ -44,9 +64,26 @@ sealed class Program
         {
             return AppRenderingModeHelper.Normalize(new AppSettingsService().Load().AppRenderMode);
         }
-        catch
+        catch (Exception ex)
         {
+            AppLogger.Warn("Startup", "Failed to load configured render mode. Falling back to default.", ex);
             return AppRenderingModeHelper.Default;
         }
     }
+
+    private static void RegisterGlobalExceptionLogging()
+    {
+        AppDomain.CurrentDomain.UnhandledException += (_, eventArgs) =>
+        {
+            AppLogger.Critical(
+                "UnhandledException",
+                $"Unhandled exception. IsTerminating={eventArgs.IsTerminating}",
+                eventArgs.ExceptionObject as Exception);
+        };
+
+        TaskScheduler.UnobservedTaskException += (_, eventArgs) =>
+        {
+            AppLogger.Error("TaskScheduler", "Unobserved task exception.", eventArgs.Exception);
+        };
+    }
 }

LanMountainDesktop/Services/AppLogger.cs

@@ -0,0 +1,169 @@
+using System;
+using System.Diagnostics;
+using System.IO;
+using System.Text;
+
+namespace LanMountainDesktop.Services;
+
+public static class AppLogger
+{
+    private static readonly object SyncRoot = new();
+    private static bool _initialized;
+    private static string _logDirectory = string.Empty;
+    private static string _logFilePath = string.Empty;
+
+    public static string LogDirectory
+    {
+        get
+        {
+            EnsureInitialized();
+            return _logDirectory;
+        }
+    }
+
+    public static string LogFilePath
+    {
+        get
+        {
+            EnsureInitialized();
+            return _logFilePath;
+        }
+    }
+
+    public static void Initialize()
+    {
+        lock (SyncRoot)
+        {
+            if (_initialized)
+            {
+                return;
+            }
+
+            var preferredDirectory = Path.Combine(AppContext.BaseDirectory, "log");
+            var fallbackDirectory = Path.Combine(
+                Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData),
+                "LanMountainDesktop",
+                "log");
+
+            var preferredReady = TryPrepareDirectory(preferredDirectory, out var preferredError);
+            var fallbackReady = false;
+            string? fallbackError = null;
+
+            if (preferredReady)
+            {
+                _logDirectory = preferredDirectory;
+            }
+            else
+            {
+                fallbackReady = TryPrepareDirectory(fallbackDirectory, out fallbackError);
+                _logDirectory = fallbackReady ? fallbackDirectory : preferredDirectory;
+            }
+
+            _logFilePath = Path.Combine(_logDirectory, $"app-{DateTime.Now:yyyyMMdd}.log");
+            _initialized = true;
+
+            WriteCore(
+                "INFO",
+                "Logger",
+                $"Initialized. Directory={_logDirectory}; File={_logFilePath}; PreferredDirectory={preferredDirectory}");
+
+            if (!preferredReady && !string.IsNullOrWhiteSpace(preferredError))
+            {
+                WriteCore(
+                    "WARN",
+                    "Logger",
+                    $"Failed to use program log directory '{preferredDirectory}'. Falling back to '{_logDirectory}'. Reason: {preferredError}");
+            }
+
+            if (!preferredReady && !fallbackReady && !string.IsNullOrWhiteSpace(fallbackError))
+            {
+                Trace.WriteLine(
+                    $"[LanMountainDesktop][Logger][ERROR] Failed to initialize fallback log directory '{fallbackDirectory}': {fallbackError}");
+            }
+        }
+    }
+
+    public static void Info(string category, string message)
+    {
+        Write("INFO", category, message, null);
+    }
+
+    public static void Warn(string category, string message, Exception? exception = null)
+    {
+        Write("WARN", category, message, exception);
+    }
+
+    public static void Error(string category, string message, Exception? exception = null)
+    {
+        Write("ERROR", category, message, exception);
+    }
+
+    public static void Critical(string category, string message, Exception? exception = null)
+    {
+        Write("CRITICAL", category, message, exception);
+    }
+
+    private static void Write(string level, string category, string message, Exception? exception)
+    {
+        EnsureInitialized();
+
+        var payload = exception is null
+            ? message
+            : $"{message}{Environment.NewLine}{exception}";
+        WriteCore(level, category, payload);
+    }
+
+    private static void EnsureInitialized()
+    {
+        if (_initialized)
+        {
+            return;
+        }
+
+        Initialize();
+    }
+
+    private static void WriteCore(string level, string category, string message)
+    {
+        var timestamp = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss.fff");
+        var line = $"[{timestamp}] [{level}] [{category}] {message}";
+
+        lock (SyncRoot)
+        {
+            try
+            {
+                var directory = Path.GetDirectoryName(_logFilePath);
+                if (!string.IsNullOrWhiteSpace(directory))
+                {
+                    Directory.CreateDirectory(directory);
+                }
+
+                File.AppendAllText(_logFilePath, line + Environment.NewLine, Encoding.UTF8);
+            }
+            catch (Exception ex)
+            {
+                Trace.WriteLine($"[LanMountainDesktop][Logger][ERROR] {ex}");
+            }
+        }
+
+        Trace.WriteLine(line);
+    }
+
+    private static bool TryPrepareDirectory(string directory, out string? error)
+    {
+        try
+        {
+            Directory.CreateDirectory(directory);
+            var probePath = Path.Combine(directory, $".probe-{Guid.NewGuid():N}.tmp");
+            File.WriteAllText(probePath, "probe");
+            File.Delete(probePath);
+            error = null;
+            return true;
+        }
+        catch (Exception ex)
+        {
+            error = ex.Message;
+            return false;
+        }
+    }
+}

LanMountainDesktop/Services/AppSettingsService.cs

@@ -63,8 +63,9 @@ public sealed class AppSettingsService
                 return loadedSnapshot.Clone();
             }
         }
-        catch
+        catch (Exception ex)
         {
+            AppLogger.Warn("AppSettings", $"Failed to load settings from '{_settingsPath}'.", ex);
             return new AppSettingsSnapshot();
         }
     }
@@ -95,9 +96,9 @@ public sealed class AppSettingsService
 
             SettingsSaved?.Invoke(InstanceId);
         }
-        catch
+        catch (Exception ex)
         {
-            // Swallow persistence errors to keep UI interactions uninterrupted.
+            AppLogger.Warn("AppSettings", $"Failed to save settings to '{_settingsPath}'.", ex);
         }
     }
 
@@ -136,8 +137,9 @@ public sealed class AppSettingsService
             var json = File.ReadAllText(_settingsPath);
             return JsonSerializer.Deserialize<AppSettingsSnapshot>(json, SerializerOptions) ?? new AppSettingsSnapshot();
         }
-        catch
+        catch (Exception ex)
         {
+            AppLogger.Warn("AppSettings", $"Failed to deserialize settings from '{_settingsPath}'.", ex);
             return new AppSettingsSnapshot();
         }
     }

LanMountainDesktop/Services/ComponentSettingsService.cs

@@ -51,8 +51,9 @@ public sealed class ComponentSettingsService : IComponentInstanceSettingsStore
                 return document.DefaultSettings.Clone();
             }
         }
-        catch
+        catch (Exception ex)
         {
+            AppLogger.Warn("ComponentSettings", $"Failed to load component settings from '{_settingsPath}'.", ex);
             return new ComponentSettingsSnapshot();
         }
     }
@@ -76,9 +77,9 @@ public sealed class ComponentSettingsService : IComponentInstanceSettingsStore
                 PersistDocumentLocked(document);
             }
         }
-        catch
+        catch (Exception ex)
         {
-            // Swallow persistence errors to keep UI interactions uninterrupted.
+            AppLogger.Warn("ComponentSettings", $"Failed to save default component settings to '{_settingsPath}'.", ex);
         }
     }
 
@@ -99,8 +100,12 @@ public sealed class ComponentSettingsService : IComponentInstanceSettingsStore
                 return document.DefaultSettings.Clone();
             }
         }
-        catch
+        catch (Exception ex)
         {
+            AppLogger.Warn(
+                "ComponentSettings",
+                $"Failed to load component settings. ComponentId={componentId}; PlacementId={placementId}; Path={_settingsPath}",
+                ex);
             return new ComponentSettingsSnapshot();
         }
     }
@@ -124,9 +129,12 @@ public sealed class ComponentSettingsService : IComponentInstanceSettingsStore
                 PersistDocumentLocked(document);
             }
         }
-        catch
+        catch (Exception ex)
         {
-            // Swallow persistence errors to keep UI interactions uninterrupted.
+            AppLogger.Warn(
+                "ComponentSettings",
+                $"Failed to save component settings. ComponentId={componentId}; PlacementId={placementId}; Path={_settingsPath}",
+                ex);
         }
     }
 
@@ -151,9 +159,12 @@ public sealed class ComponentSettingsService : IComponentInstanceSettingsStore
                 }
             }
         }
-        catch
+        catch (Exception ex)
         {
-            // Swallow persistence errors to keep UI interactions uninterrupted.
+            AppLogger.Warn(
+                "ComponentSettings",
+                $"Failed to delete component settings. ComponentId={componentId}; PlacementId={placementId}; Path={_settingsPath}",
+                ex);
         }
     }
 
@@ -174,8 +185,12 @@ public sealed class ComponentSettingsService : IComponentInstanceSettingsStore
                 return JsonSerializer.Deserialize<T>(settingsElement.GetRawText(), SerializerOptions) ?? new T();
             }
         }
-        catch
+        catch (Exception ex)
         {
+            AppLogger.Warn(
+                "ComponentSettings",
+                $"Failed to load plugin settings. ComponentId={componentId}; PlacementId={placementId}; Path={_settingsPath}",
+                ex);
             return new T();
         }
     }
@@ -197,9 +212,12 @@ public sealed class ComponentSettingsService : IComponentInstanceSettingsStore
                 PersistDocumentLocked(document);
             }
         }
-        catch
+        catch (Exception ex)
         {
-            // Swallow persistence errors to keep UI interactions uninterrupted.
+            AppLogger.Warn(
+                "ComponentSettings",
+                $"Failed to save plugin settings. ComponentId={componentId}; PlacementId={placementId}; Path={_settingsPath}",
+                ex);
         }
     }
 
@@ -222,9 +240,12 @@ public sealed class ComponentSettingsService : IComponentInstanceSettingsStore
                 }
             }
         }
-        catch
+        catch (Exception ex)
         {
-            // Swallow persistence errors to keep UI interactions uninterrupted.
+            AppLogger.Warn(
+                "ComponentSettings",
+                $"Failed to delete plugin settings. ComponentId={componentId}; PlacementId={placementId}; Path={_settingsPath}",
+                ex);
         }
     }
 
@@ -373,8 +394,9 @@ public sealed class ComponentSettingsService : IComponentInstanceSettingsStore
                 DefaultSettings = NormalizeSnapshot(legacySnapshot)
             };
         }
-        catch
+        catch (Exception ex)
         {
+            AppLogger.Warn("ComponentSettings", $"Failed to deserialize component settings from '{_settingsPath}'.", ex);
             return new ComponentSettingsDocumentSnapshot();
         }
     }
@@ -428,8 +450,9 @@ public sealed class ComponentSettingsService : IComponentInstanceSettingsStore
 
             return true;
         }
-        catch
+        catch (Exception ex)
         {
+            AppLogger.Warn("ComponentSettings", $"Failed to migrate legacy component settings from '{_legacyAppSettingsPath}'.", ex);
             return false;
         }
     }

LanMountainDesktop/Services/DesktopLayoutSettingsService.cs

@@ -80,8 +80,9 @@ public sealed class DesktopLayoutSettingsService
                 return normalizedSnapshot.Clone();
             }
         }
-        catch
+        catch (Exception ex)
         {
+            AppLogger.Warn("DesktopLayout", $"Failed to load desktop layout settings from '{_settingsPath}'.", ex);
             return new DesktopLayoutSettingsSnapshot();
         }
     }
@@ -99,9 +100,9 @@ public sealed class DesktopLayoutSettingsService
                 UpdateCache(snapshotToPersist, writeTimeUtc, DateTime.UtcNow);
             }
         }
-        catch
+        catch (Exception ex)
         {
-            // Swallow persistence errors to keep UI interactions uninterrupted.
+            AppLogger.Warn("DesktopLayout", $"Failed to save desktop layout settings to '{_settingsPath}'.", ex);
         }
     }
 
@@ -141,8 +142,9 @@ public sealed class DesktopLayoutSettingsService
             var snapshot = JsonSerializer.Deserialize<DesktopLayoutSettingsSnapshot>(json, SerializerOptions);
             return NormalizeSnapshot(snapshot);
         }
-        catch
+        catch (Exception ex)
         {
+            AppLogger.Warn("DesktopLayout", $"Failed to deserialize desktop layout settings from '{_settingsPath}'.", ex);
             return new DesktopLayoutSettingsSnapshot();
         }
     }
@@ -174,8 +176,9 @@ public sealed class DesktopLayoutSettingsService
 
             return true;
         }
-        catch
+        catch (Exception ex)
         {
+            AppLogger.Warn("DesktopLayout", $"Failed to migrate legacy desktop layout settings from '{_legacyAppSettingsPath}'.", ex);
             return false;
         }
     }

LanMountainDesktop/Services/FileOperationRetryHelper.cs

@@ -0,0 +1,98 @@
+using System;
+using System.IO;
+using System.Threading;
+
+namespace LanMountainDesktop.Services;
+
+internal static class FileOperationRetryHelper
+{
+    private static readonly TimeSpan[] RetryDelays =
+    [
+        TimeSpan.FromMilliseconds(120),
+        TimeSpan.FromMilliseconds(250),
+        TimeSpan.FromMilliseconds(500)
+    ];
+
+    public static void CopyWithRetry(string sourceFilePath, string destinationFilePath, bool overwrite, string category)
+    {
+        Retry(
+            () => File.Copy(sourceFilePath, destinationFilePath, overwrite),
+            category,
+            $"Copy '{sourceFilePath}' -> '{destinationFilePath}'");
+    }
+
+    public static void MoveWithOverwriteRetry(string sourceFilePath, string destinationFilePath, string category)
+    {
+        Retry(
+            () => File.Move(sourceFilePath, destinationFilePath, overwrite: true),
+            category,
+            $"Move '{sourceFilePath}' -> '{destinationFilePath}'");
+    }
+
+    public static void DeleteFileWithRetry(string filePath, string category)
+    {
+        Retry(
+            () =>
+            {
+                if (File.Exists(filePath))
+                {
+                    File.Delete(filePath);
+                }
+            },
+            category,
+            $"Delete file '{filePath}'");
+    }
+
+    public static void DeleteDirectoryWithRetry(string directoryPath, bool recursive, string category)
+    {
+        Retry(
+            () =>
+            {
+                if (Directory.Exists(directoryPath))
+                {
+                    Directory.Delete(directoryPath, recursive);
+                }
+            },
+            category,
+            $"Delete directory '{directoryPath}'");
+    }
+
+    private static void Retry(Action action, string category, string operationDescription)
+    {
+        Exception? lastException = null;
+
+        for (var attempt = 0; attempt <= RetryDelays.Length; attempt++)
+        {
+            try
+            {
+                action();
+                return;
+            }
+            catch (Exception ex) when (IsRetriable(ex))
+            {
+                lastException = ex;
+                if (attempt >= RetryDelays.Length)
+                {
+                    break;
+                }
+
+                var delay = RetryDelays[attempt];
+                AppLogger.Warn(
+                    category,
+                    $"{operationDescription} failed on attempt {attempt + 1}. Retrying after {delay.TotalMilliseconds:0} ms.",
+                    ex);
+                Thread.Sleep(delay);
+            }
+        }
+
+        if (lastException is not null)
+        {
+            throw lastException;
+        }
+    }
+
+    private static bool IsRetriable(Exception exception)
+    {
+        return exception is IOException or UnauthorizedAccessException;
+    }
+}

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,37 @@ public sealed class GitHubReleaseUpdateService : IDisposable
             return new UpdateDownloadResult(false, null, "Destination file path is empty.");
         }
 
-        try
+        var progressAdapter = progress is null
+            ? null
+            : new Progress<DownloadProgressInfo>(info => progress.Report(info.Progress));
+
+        var result = await _downloadService.DownloadAsync(
+            asset.BrowserDownloadUrl,
+            destinationFilePath,
+            new DownloadOptions(ExpectedSizeBytes: asset.SizeBytes > 0 ? asset.SizeBytes : null),
+            progressAdapter,
+            cancellationToken);
+
+        return result.Success
+            ? new UpdateDownloadResult(true, result.FilePath ?? destinationFilePath, null)
+            : new UpdateDownloadResult(false, null, result.ErrorMessage);
+    }
+
+    public async Task<GitHubReleaseInfo?> GetReleaseByTagAsync(
+        string tagName,
+        CancellationToken cancellationToken = default)
+    {
+        if (string.IsNullOrWhiteSpace(tagName))
         {
-            var directory = Path.GetDirectoryName(destinationFilePath);
-            if (!string.IsNullOrWhiteSpace(directory))
-            {
-                Directory.CreateDirectory(directory);
-            }
-
-            using var response = await _httpClient.GetAsync(
-                asset.BrowserDownloadUrl,
-                HttpCompletionOption.ResponseHeadersRead,
-                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 null;
         }
+
+        var url =
+            $"https://api.github.com/repos/{_owner}/{_repo}/releases/tags/{Uri.EscapeDataString(tagName.Trim())}";
+        var responseText = await GetResponseTextAsync(url, cancellationToken);
+
+        using var document = JsonDocument.Parse(responseText);
+        return ParseRelease(document.RootElement);
     }
 
     private async Task<GitHubReleaseInfo?> GetLatestStableReleaseAsync(CancellationToken cancellationToken)

LanMountainDesktop/Services/LauncherSettingsService.cs

@@ -85,8 +85,9 @@ public sealed class LauncherSettingsService
                 return normalizedSnapshot.Clone();
             }
         }
-        catch
+        catch (Exception ex)
         {
+            AppLogger.Warn("LauncherSettings", $"Failed to load launcher settings from '{_settingsPath}'.", ex);
             return new LauncherSettingsSnapshot();
         }
     }
@@ -106,9 +107,9 @@ public sealed class LauncherSettingsService
 
             SettingsSaved?.Invoke(InstanceId);
         }
-        catch
+        catch (Exception ex)
         {
-            // Swallow persistence errors to keep UI interactions uninterrupted.
+            AppLogger.Warn("LauncherSettings", $"Failed to save launcher settings to '{_settingsPath}'.", ex);
         }
     }
 
@@ -148,8 +149,9 @@ public sealed class LauncherSettingsService
             var snapshot = JsonSerializer.Deserialize<LauncherSettingsSnapshot>(json, SerializerOptions);
             return NormalizeSnapshot(snapshot);
         }
-        catch
+        catch (Exception ex)
         {
+            AppLogger.Warn("LauncherSettings", $"Failed to deserialize launcher settings from '{_settingsPath}'.", ex);
             return new LauncherSettingsSnapshot();
         }
     }
@@ -180,8 +182,9 @@ public sealed class LauncherSettingsService
 
             return true;
         }
-        catch
+        catch (Exception ex)
         {
+            AppLogger.Warn("LauncherSettings", $"Failed to migrate legacy launcher settings from '{_legacyAppSettingsPath}'.", ex);
             return false;
         }
     }

LanMountainDesktop/Services/ResumableDownloadService.cs

@@ -0,0 +1,412 @@
+using System;
+using System.Collections.Concurrent;
+using System.IO;
+using System.Threading;
+using System.Threading.Tasks;
+using Downloader;
+
+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 ConcurrentDictionary<string, SemaphoreSlim> DestinationGates =
+        new(StringComparer.OrdinalIgnoreCase);
+
+    public ResumableDownloadService(System.Net.Http.HttpClient 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);
+        var fullDestinationPath = Path.GetFullPath(destinationFilePath);
+        var destinationGate = DestinationGates.GetOrAdd(
+            fullDestinationPath,
+            static _ => new SemaphoreSlim(1, 1));
+
+        await destinationGate.WaitAsync(cancellationToken);
+        try
+        {
+            if (File.Exists(source))
+            {
+                return await CopyLocalFileAsync(
+                    source,
+                    fullDestinationPath,
+                    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,
+                fullDestinationPath,
+                normalizedOptions,
+                progress,
+                cancellationToken);
+        }
+        catch (OperationCanceledException)
+        {
+            throw;
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn(
+                "Downloader",
+                $"Download failed. Source='{source}'; Destination='{fullDestinationPath}'.",
+                ex);
+            return new DownloadResult(false, null, ex.Message, false, false);
+        }
+        finally
+        {
+            destinationGate.Release();
+        }
+    }
+
+    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);
+        PrepareDestination(fullDestinationPath);
+
+        if (CanReuseCompletedDestination(fullDestinationPath, totalBytes))
+        {
+            progress?.Report(new DownloadProgressInfo(totalBytes, totalBytes, 1d, false, false));
+            CleanupLocalPartialArtifacts(tempFilePath);
+            return new DownloadResult(true, fullDestinationPath, null, false, false);
+        }
+
+        long existingBytes = 0;
+        if (File.Exists(tempFilePath))
+        {
+            existingBytes = new FileInfo(tempFilePath).Length;
+            if (existingBytes > totalBytes)
+            {
+                CleanupLocalPartialArtifacts(tempFilePath);
+                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)
+        {
+            CompleteLocalCopy(tempFilePath, fullDestinationPath);
+            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,
+            progress,
+            cancellationToken);
+
+        CompleteLocalCopy(tempFilePath, fullDestinationPath);
+        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)
+    {
+        PrepareDestination(destinationFilePath);
+
+        if (CanReuseCompletedDestination(destinationFilePath, options.ExpectedSizeBytes))
+        {
+            var existingLength = new FileInfo(destinationFilePath).Length;
+            progress?.Report(new DownloadProgressInfo(existingLength, options.ExpectedSizeBytes, 1d, false, false));
+            CleanupDownloaderArtifacts(destinationFilePath);
+            return new DownloadResult(true, destinationFilePath, null, false, false);
+        }
+
+        var usedResume = HasDownloaderResumeArtifacts(destinationFilePath);
+        var usedParallelDownload = ShouldUseParallelDownload(options);
+        var configuration = CreateConfiguration(options, usedParallelDownload);
+        using var downloader = new DownloadService(configuration);
+
+        downloader.DownloadProgressChanged += (_, args) =>
+        {
+            progress?.Report(MapProgress(args, options.ExpectedSizeBytes, usedResume, usedParallelDownload));
+        };
+
+        using var cancellationRegistration = cancellationToken.Register(() =>
+        {
+            try
+            {
+                downloader.CancelAsync();
+            }
+            catch (Exception ex)
+            {
+                AppLogger.Warn(
+                    "Downloader",
+                    $"Failed to cancel Downloader request for '{destinationFilePath}'.",
+                    ex);
+            }
+        });
+
+        AppLogger.Info(
+            "Downloader",
+            $"Starting remote download. Source='{sourceUri}'; Destination='{destinationFilePath}'; Parallel={usedParallelDownload}; ChunkCount={configuration.ChunkCount}; Resume={usedResume}.");
+
+        await downloader.DownloadFileTaskAsync(sourceUri.AbsoluteUri, destinationFilePath);
+
+        if (!File.Exists(destinationFilePath))
+        {
+            throw new FileNotFoundException(
+                $"Downloader completed without producing '{destinationFilePath}'.",
+                destinationFilePath);
+        }
+
+        var finalLength = new FileInfo(destinationFilePath).Length;
+        progress?.Report(new DownloadProgressInfo(
+            finalLength,
+            options.ExpectedSizeBytes ?? finalLength,
+            1d,
+            usedResume,
+            usedParallelDownload));
+
+        AppLogger.Info(
+            "Downloader",
+            $"Remote download completed. Source='{sourceUri}'; Destination='{destinationFilePath}'; Size={finalLength}; Parallel={usedParallelDownload}; Resume={usedResume}.");
+
+        return new DownloadResult(true, destinationFilePath, null, usedResume, usedParallelDownload);
+    }
+
+    private static async Task CopyStreamAsync(
+        Stream sourceStream,
+        Stream destinationStream,
+        long initialDownloadedBytes,
+        long totalBytes,
+        IProgress<DownloadProgressInfo>? progress,
+        CancellationToken cancellationToken)
+    {
+        var buffer = new byte[128 * 1024];
+        var downloadedBytes = initialDownloadedBytes;
+        progress?.Report(new DownloadProgressInfo(downloadedBytes, totalBytes, downloadedBytes / (double)totalBytes, initialDownloadedBytes > 0, false));
+
+        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;
+            progress?.Report(new DownloadProgressInfo(
+                downloadedBytes,
+                totalBytes,
+                Math.Clamp(downloadedBytes / (double)totalBytes, 0d, 1d),
+                initialDownloadedBytes > 0,
+                false));
+        }
+
+        await destinationStream.FlushAsync(cancellationToken);
+    }
+
+    private static DownloadConfiguration CreateConfiguration(DownloadOptions options, bool useParallelDownload)
+    {
+        return new DownloadConfiguration
+        {
+            BufferBlockSize = options.BufferSize,
+            ChunkCount = useParallelDownload ? options.MaxParallelSegments : 1,
+            ParallelCount = useParallelDownload ? options.MaxParallelSegments : 1,
+            ParallelDownload = useParallelDownload,
+            MinimumSizeOfChunking = options.ParallelThresholdBytes,
+            MaxTryAgainOnFailure = 3,
+            ResumeDownloadIfCan = true,
+            ClearPackageOnCompletionWithFailure = false,
+            FileExistPolicy = FileExistPolicy.Delete,
+            DownloadFileExtension = ".part"
+        };
+    }
+
+    private static DownloadProgressInfo MapProgress(
+        DownloadProgressChangedEventArgs args,
+        long? expectedSizeBytes,
+        bool isResuming,
+        bool isParallel)
+    {
+        var totalBytes = args.TotalBytesToReceive > 0
+            ? args.TotalBytesToReceive
+            : expectedSizeBytes;
+        var downloadedBytes = Math.Max(0L, args.ReceivedBytesSize);
+        var normalizedProgress = args.ProgressPercentage > 1d
+            ? args.ProgressPercentage / 100d
+            : args.ProgressPercentage;
+
+        if (totalBytes is > 0 && normalizedProgress <= 0d)
+        {
+            normalizedProgress = downloadedBytes / (double)totalBytes.Value;
+        }
+
+        return new DownloadProgressInfo(
+            downloadedBytes,
+            totalBytes,
+            Math.Clamp(normalizedProgress, 0d, 1d),
+            isResuming,
+            isParallel);
+    }
+
+    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 CleanupLocalPartialArtifacts(string tempFilePath)
+    {
+        if (File.Exists(tempFilePath))
+        {
+            FileOperationRetryHelper.DeleteFileWithRetry(tempFilePath, "Downloader");
+        }
+    }
+
+    private static void CompleteLocalCopy(string tempFilePath, string destinationFilePath)
+    {
+        if (!File.Exists(tempFilePath))
+        {
+            return;
+        }
+
+        FileOperationRetryHelper.MoveWithOverwriteRetry(tempFilePath, destinationFilePath, "Downloader");
+    }
+
+    private static void CleanupDownloaderArtifacts(string destinationFilePath)
+    {
+        var transientFilePath = BuildTempFilePath(destinationFilePath);
+        var metadataFilePath = BuildPackageFilePath(destinationFilePath);
+
+        if (File.Exists(transientFilePath))
+        {
+            FileOperationRetryHelper.DeleteFileWithRetry(transientFilePath, "Downloader");
+        }
+
+        if (File.Exists(metadataFilePath))
+        {
+            FileOperationRetryHelper.DeleteFileWithRetry(metadataFilePath, "Downloader");
+        }
+    }
+
+    private static bool HasDownloaderResumeArtifacts(string destinationFilePath)
+    {
+        return File.Exists(BuildTempFilePath(destinationFilePath)) ||
+               File.Exists(BuildPackageFilePath(destinationFilePath));
+    }
+
+    private static bool ShouldUseParallelDownload(DownloadOptions options)
+    {
+        return options.MaxParallelSegments > 1;
+    }
+
+    private static DownloadOptions NormalizeOptions(DownloadOptions? options)
+    {
+        var normalized = options ?? new DownloadOptions();
+        return normalized with
+        {
+            MaxParallelSegments = Math.Clamp(normalized.MaxParallelSegments, 1, 8),
+            ParallelThresholdBytes = Math.Max(1_048_576, normalized.ParallelThresholdBytes),
+            BufferSize = Math.Max(16 * 1024, normalized.BufferSize)
+        };
+    }
+
+    private static string BuildTempFilePath(string destinationFilePath) => destinationFilePath + ".part";
+
+    private static string BuildPackageFilePath(string destinationFilePath) => destinationFilePath + ".download";
+}

LanMountainDesktop/Services/StartupDiagnosticsService.cs

@@ -0,0 +1,193 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.IO;
+using System.Linq;
+using System.Reflection;
+
+namespace LanMountainDesktop.Services;
+
+public sealed class StartupDiagnosticsResult
+{
+    public string ExecutablePath { get; init; } = string.Empty;
+
+    public string BaseDirectory { get; init; } = string.Empty;
+
+    public string ExecutableName { get; init; } = string.Empty;
+
+    public bool IsLegacyExecutableLaunch { get; init; }
+
+    public IReadOnlyList<string> FoundLegacyArtifacts { get; init; } = Array.Empty<string>();
+
+    public IReadOnlyList<string> DeletedLegacyArtifacts { get; init; } = Array.Empty<string>();
+
+    public IReadOnlyList<string> FailedLegacyArtifacts { get; init; } = Array.Empty<string>();
+}
+
+public static class StartupDiagnosticsService
+{
+    private const string CurrentExecutableName = "LanMountainDesktop.exe";
+
+    private static readonly string[] LegacyArtifactNames =
+    [
+        "LanMontainDesktop.exe",
+        "LanMontainDesktop.dll",
+        "LanMontainDesktop.deps.json",
+        "LanMontainDesktop.runtimeconfig.json",
+        "LanMontainDesktop.pdb",
+        "LanMontainDesktop.exe.WebView2"
+    ];
+
+    public static StartupDiagnosticsResult Run(string[] args)
+    {
+        var executablePath = ResolveExecutablePath();
+        var baseDirectory = AppContext.BaseDirectory;
+        var executableName = Path.GetFileName(executablePath);
+        var assemblyVersion = Assembly.GetEntryAssembly()?.GetName().Version?.ToString() ?? "unknown";
+        var fileVersion = string.Empty;
+
+        try
+        {
+            if (!string.IsNullOrWhiteSpace(executablePath) && File.Exists(executablePath))
+            {
+                fileVersion = FileVersionInfo.GetVersionInfo(executablePath).FileVersion ?? string.Empty;
+            }
+        }
+        catch
+        {
+            // Keep diagnostics best-effort.
+        }
+
+        AppLogger.Info(
+            "Startup",
+            $"Application starting. ExecutablePath={executablePath}; BaseDirectory={baseDirectory}; ExecutableName={executableName}; AssemblyVersion={assemblyVersion}; FileVersion={fileVersion}; Args=[{string.Join(", ", args)}]");
+
+        var foundLegacyArtifacts = LegacyArtifactNames
+            .Select(name => Path.Combine(baseDirectory, name))
+            .Where(path => File.Exists(path) || Directory.Exists(path))
+            .OrderBy(path => path, StringComparer.OrdinalIgnoreCase)
+            .ToList();
+
+        var deletedLegacyArtifacts = new List<string>();
+        var failedLegacyArtifacts = new List<string>();
+        foreach (var legacyArtifact in foundLegacyArtifacts)
+        {
+            if (string.Equals(legacyArtifact, executablePath, StringComparison.OrdinalIgnoreCase))
+            {
+                continue;
+            }
+
+            if (TryDeleteLegacyArtifact(legacyArtifact, out var error))
+            {
+                deletedLegacyArtifacts.Add(legacyArtifact);
+            }
+            else if (!string.IsNullOrWhiteSpace(error))
+            {
+                failedLegacyArtifacts.Add($"{legacyArtifact} ({error})");
+            }
+        }
+
+        if (foundLegacyArtifacts.Count > 0)
+        {
+            AppLogger.Warn(
+                "StartupDiagnostics",
+                $"Found legacy artifacts: {string.Join("; ", foundLegacyArtifacts)}");
+        }
+
+        if (deletedLegacyArtifacts.Count > 0)
+        {
+            AppLogger.Info(
+                "StartupDiagnostics",
+                $"Deleted legacy artifacts: {string.Join("; ", deletedLegacyArtifacts)}");
+        }
+
+        if (failedLegacyArtifacts.Count > 0)
+        {
+            AppLogger.Warn(
+                "StartupDiagnostics",
+                $"Failed to delete legacy artifacts: {string.Join("; ", failedLegacyArtifacts)}");
+        }
+
+        var isLegacyExecutableLaunch = string.Equals(
+            executableName,
+            "LanMontainDesktop.exe",
+            StringComparison.OrdinalIgnoreCase);
+
+        if (isLegacyExecutableLaunch)
+        {
+            AppLogger.Warn(
+                "StartupDiagnostics",
+                $"Legacy executable launch detected. Current executable should be '{CurrentExecutableName}', but actual executable is '{executableName}'.");
+        }
+
+        return new StartupDiagnosticsResult
+        {
+            ExecutablePath = executablePath,
+            BaseDirectory = baseDirectory,
+            ExecutableName = executableName,
+            IsLegacyExecutableLaunch = isLegacyExecutableLaunch,
+            FoundLegacyArtifacts = foundLegacyArtifacts,
+            DeletedLegacyArtifacts = deletedLegacyArtifacts,
+            FailedLegacyArtifacts = failedLegacyArtifacts
+        };
+    }
+
+    public static void ShowLegacyExecutableWarningIfNeeded(StartupDiagnosticsResult diagnostics)
+    {
+        if (!diagnostics.IsLegacyExecutableLaunch)
+        {
+            return;
+        }
+
+        var message =
+            "检测到当前是从旧残留可执行文件启动的。\r\n\r\n" +
+            $"当前文件: {diagnostics.ExecutableName}\r\n" +
+            $"当前路径: {diagnostics.ExecutablePath}\r\n\r\n" +
+            $"请改用 {CurrentExecutableName} 启动，以免继续读取旧残留文件。\r\n" +
+            $"日志目录: {AppLogger.LogDirectory}";
+
+        WindowsNativeDialogService.ShowWarning("LanMountainDesktop 启动诊断", message);
+    }
+
+    private static string ResolveExecutablePath()
+    {
+        try
+        {
+            return Environment.ProcessPath ??
+                   Process.GetCurrentProcess().MainModule?.FileName ??
+                   string.Empty;
+        }
+        catch
+        {
+            return string.Empty;
+        }
+    }
+
+    private static bool TryDeleteLegacyArtifact(string path, out string? error)
+    {
+        try
+        {
+            if (File.Exists(path))
+            {
+                File.Delete(path);
+                error = null;
+                return true;
+            }
+
+            if (Directory.Exists(path))
+            {
+                Directory.Delete(path, recursive: true);
+                error = null;
+                return true;
+            }
+
+            error = null;
+            return false;
+        }
+        catch (Exception ex)
+        {
+            error = ex.Message;
+            return false;
+        }
+    }
+}

LanMountainDesktop/Services/WindowsNativeDialogService.cs

@@ -0,0 +1,30 @@
+using System;
+using System.Runtime.InteropServices;
+
+namespace LanMountainDesktop.Services;
+
+internal static class WindowsNativeDialogService
+{
+    private const uint Ok = 0x00000000;
+    private const uint IconWarning = 0x00000030;
+
+    public static void ShowWarning(string caption, string message)
+    {
+        if (!OperatingSystem.IsWindows())
+        {
+            return;
+        }
+
+        try
+        {
+            _ = MessageBoxW(IntPtr.Zero, message, caption, Ok | IconWarning);
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("StartupDiagnostics", "Failed to show legacy executable warning dialog.", ex);
+        }
+    }
+
+    [DllImport("user32.dll", EntryPoint = "MessageBoxW", CharSet = CharSet.Unicode, SetLastError = true)]
+    private static extern int MessageBoxW(IntPtr hWnd, string text, string caption, uint type);
+}

LanMountainDesktop/Services/WindowsStartupService.cs

@@ -30,8 +30,9 @@ public sealed class WindowsStartupService
             return runKey?.GetValue(ValueName) is string value &&
                    !string.IsNullOrWhiteSpace(value);
         }
-        catch
+        catch (Exception ex)
         {
+            AppLogger.Warn("WindowsStartup", "Failed to query startup registry state.", ex);
             return false;
         }
     }
@@ -67,8 +68,9 @@ public sealed class WindowsStartupService
 
             return IsEnabled() == enabled;
         }
-        catch
+        catch (Exception ex)
         {
+            AppLogger.Warn("WindowsStartup", $"Failed to set startup registry state. Enabled={enabled}", ex);
             return false;
         }
     }

LanMountainDesktop/Views/MainWindow.DesktopPaging.cs

@@ -13,6 +13,7 @@ using Avalonia.Media;
 using Avalonia.Media.Imaging;
 using Avalonia.Threading;
 using Avalonia.VisualTree;
+using FluentAvalonia.UI.Controls;
 using LanMountainDesktop.Models;
 using LanMountainDesktop.Services;
 
@@ -1069,12 +1070,12 @@ public partial class MainWindow
 
     private void RenderLauncherHiddenItemsList()
     {
-        if (LauncherHiddenItemsListPanel is null || LauncherHiddenItemsEmptyTextBlock is null)
+        if (LauncherHiddenItemsSettingsExpander is null || LauncherHiddenItemsEmptyTextBlock is null)
         {
             return;
         }
 
-        LauncherHiddenItemsListPanel.Children.Clear();
+        LauncherHiddenItemsSettingsExpander.Items.Clear();
         var hiddenItems = BuildLauncherHiddenItems();
         LauncherHiddenItemsEmptyTextBlock.IsVisible = hiddenItems.Count == 0;
         if (hiddenItems.Count == 0)
@@ -1084,7 +1085,7 @@ public partial class MainWindow
 
         foreach (var hiddenItem in hiddenItems)
         {
-            LauncherHiddenItemsListPanel.Children.Add(CreateLauncherHiddenItemRow(hiddenItem));
+            LauncherHiddenItemsSettingsExpander.Items.Add(CreateLauncherHiddenItemRow(hiddenItem));
         }
     }
 
@@ -1186,92 +1187,47 @@ public partial class MainWindow
             : fileName;
     }
 
-    private Control CreateLauncherHiddenItemRow(LauncherHiddenItemView hiddenItem)
+    private SettingsExpanderItem CreateLauncherHiddenItemRow(LauncherHiddenItemView hiddenItem)
     {
-        Control icon = hiddenItem.IconBitmap is not null
-            ? new Image
-            {
-                Source = hiddenItem.IconBitmap,
-                Width = 24,
-                Height = 24,
-                Stretch = Stretch.Uniform
-            }
-            : new Border
-            {
-                Width = 24,
-                Height = 24,
-                CornerRadius = new CornerRadius(999),
-                Background = GetThemeBrush("AdaptiveButtonBackgroundBrush"),
-                Child = new TextBlock
-                {
-                    Text = hiddenItem.Monogram,
-                    FontSize = 10,
-                    FontWeight = FontWeight.Bold,
-                    HorizontalAlignment = HorizontalAlignment.Center,
-                    VerticalAlignment = VerticalAlignment.Center
-                }
-            };
-
         var typeText = hiddenItem.Kind == LauncherEntryKind.Folder
             ? L("settings.launcher.hidden_type_folder", "Folder")
             : L("settings.launcher.hidden_type_shortcut", "Shortcut");
 
-        var infoPanel = new StackPanel
-        {
-            Orientation = Orientation.Horizontal,
-            Spacing = 10,
-            VerticalAlignment = VerticalAlignment.Center,
-            HorizontalAlignment = HorizontalAlignment.Stretch
-        };
-        infoPanel.Children.Add(icon);
-        infoPanel.Children.Add(new StackPanel
-        {
-            Spacing = 2,
-            VerticalAlignment = VerticalAlignment.Center,
-            HorizontalAlignment = HorizontalAlignment.Left,
-            Children =
-            {
-                new TextBlock
-                {
-                    Text = hiddenItem.DisplayName,
-                    TextTrimming = TextTrimming.CharacterEllipsis,
-                    MaxLines = 1
-                },
-                new TextBlock
-                {
-                    Text = typeText,
-                    FontSize = 11,
-                    Opacity = 0.7
-                }
-            }
-        });
-
         var restoreButton = new Button
         {
-            Content = L("settings.launcher.restore_button", "Show Again"),
+            Content = L("settings.launcher.restore_button", "Unhide"),
             MinWidth = 110,
             Padding = new Thickness(12, 6),
             Tag = new LauncherHiddenItemToken(hiddenItem.Kind, hiddenItem.Key)
         };
         restoreButton.Click += OnRestoreLauncherHiddenItemClick;
 
-        var row = new Grid
+        return new SettingsExpanderItem
         {
-            ColumnDefinitions = new ColumnDefinitions("*,Auto"),
-            ColumnSpacing = 10
+            Content = hiddenItem.DisplayName,
+            Description = typeText,
+            IconSource = CreateLauncherHiddenItemIconSource(hiddenItem),
+            IsClickEnabled = false,
+            Footer = restoreButton
         };
-        row.Children.Add(infoPanel);
-        Grid.SetColumn(infoPanel, 0);
-        row.Children.Add(restoreButton);
-        Grid.SetColumn(restoreButton, 1);
+    }
 
-        return new Border
+    private IconSource CreateLauncherHiddenItemIconSource(LauncherHiddenItemView hiddenItem)
+    {
+        if (hiddenItem.IconBitmap is not null)
         {
-            Classes = { "glass-panel" },
-            BorderThickness = new Thickness(0),
-            CornerRadius = new CornerRadius(14),
-            Padding = new Thickness(10, 8),
-            Child = row
+            return new ImageIconSource
+            {
+                Source = hiddenItem.IconBitmap
+            };
+        }
+
+        return new FluentIcons.Avalonia.Fluent.SymbolIconSource
+        {
+            Symbol = hiddenItem.Kind == LauncherEntryKind.Folder
+                ? FluentIcons.Common.Symbol.Folder
+                : FluentIcons.Common.Symbol.Apps,
+            IconVariant = FluentIcons.Common.IconVariant.Regular
         };
     }
 

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");

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();
@@ -2793,7 +2805,6 @@ public partial class MainWindow
     // --- LauncherSettingsPage ---
     internal TextBlock LauncherSettingsPanelTitleTextBlock => LauncherSettingsPanel.FindControl<TextBlock>("LauncherSettingsPanelTitleTextBlock")!;
     internal FluentAvalonia.UI.Controls.SettingsExpander LauncherHiddenItemsSettingsExpander => LauncherSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("LauncherHiddenItemsSettingsExpander")!;
-    internal StackPanel LauncherHiddenItemsListPanel => LauncherSettingsPanel.FindControl<StackPanel>("LauncherHiddenItemsListPanel")!;
     internal TextBlock LauncherHiddenItemsEmptyTextBlock => LauncherSettingsPanel.FindControl<TextBlock>("LauncherHiddenItemsEmptyTextBlock")!;
     internal TextBlock LauncherHiddenItemsDescriptionTextBlock => LauncherSettingsPanel.FindControl<TextBlock>("LauncherHiddenItemsDescriptionTextBlock")!;
 

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>

LanMountainDesktop/Views/SettingsPages/LauncherSettingsPage.axaml

@@ -31,12 +31,6 @@
                                    IsVisible="False"
                                    Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
                                    Text="No hidden items." />
-                        <ScrollViewer MaxHeight="420"
-                                      VerticalScrollBarVisibility="Auto"
-                                      HorizontalScrollBarVisibility="Disabled">
-                            <StackPanel x:Name="LauncherHiddenItemsListPanel"
-                                        Spacing="8" />
-                        </ScrollViewer>
                     </StackPanel>
                 </ui:SettingsExpander.Footer>
             </ui:SettingsExpander>

LanMountainDesktop/Views/SettingsWindow.Controls.cs

@@ -211,7 +211,6 @@ public partial class SettingsWindow
     // --- LauncherSettingsPage ---
     internal TextBlock LauncherSettingsPanelTitleTextBlock => LauncherSettingsPanel.FindControl<TextBlock>("LauncherSettingsPanelTitleTextBlock")!;
     internal FluentAvalonia.UI.Controls.SettingsExpander LauncherHiddenItemsSettingsExpander => LauncherSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("LauncherHiddenItemsSettingsExpander")!;
-    internal StackPanel LauncherHiddenItemsListPanel => LauncherSettingsPanel.FindControl<StackPanel>("LauncherHiddenItemsListPanel")!;
     internal TextBlock LauncherHiddenItemsEmptyTextBlock => LauncherSettingsPanel.FindControl<TextBlock>("LauncherHiddenItemsEmptyTextBlock")!;
     internal TextBlock LauncherHiddenItemsDescriptionTextBlock => LauncherSettingsPanel.FindControl<TextBlock>("LauncherHiddenItemsDescriptionTextBlock")!;
 

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();

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());

LanMountainDesktop/Views/SettingsWindow.WeatherLauncher.cs

@@ -11,6 +11,7 @@ using Avalonia.Layout;
 using Avalonia.Media;
 using Avalonia.Media.Imaging;
 using Avalonia.Threading;
+using FluentAvalonia.UI.Controls;
 using FluentIcons.Common;
 using LanMountainDesktop.Models;
 using LanMountainDesktop.Services;
@@ -626,18 +627,18 @@ public partial class SettingsWindow
         return string.Create(CultureInfo.InvariantCulture, $"{temperatureC:0.#}°C");
     }
 
-    private static Symbol ResolveWeatherPreviewSymbol(int? weatherCode, bool isNight)
+    private static FluentIcons.Common.Symbol ResolveWeatherPreviewSymbol(int? weatherCode, bool isNight)
     {
         return weatherCode switch
         {
-            0 => isNight ? Symbol.WeatherMoon : Symbol.WeatherSunny,
-            1 or 2 => isNight ? Symbol.WeatherPartlyCloudyNight : Symbol.WeatherPartlyCloudyDay,
-            3 or 7 => Symbol.WeatherRainShowersDay,
-            8 or 9 => Symbol.WeatherRain,
-            4 => Symbol.WeatherThunderstorm,
-            13 or 14 or 15 or 16 => Symbol.WeatherSnow,
-            18 or 32 => Symbol.WeatherFog,
-            _ => isNight ? Symbol.WeatherPartlyCloudyNight : Symbol.WeatherPartlyCloudyDay
+            0 => isNight ? FluentIcons.Common.Symbol.WeatherMoon : FluentIcons.Common.Symbol.WeatherSunny,
+            1 or 2 => isNight ? FluentIcons.Common.Symbol.WeatherPartlyCloudyNight : FluentIcons.Common.Symbol.WeatherPartlyCloudyDay,
+            3 or 7 => FluentIcons.Common.Symbol.WeatherRainShowersDay,
+            8 or 9 => FluentIcons.Common.Symbol.WeatherRain,
+            4 => FluentIcons.Common.Symbol.WeatherThunderstorm,
+            13 or 14 or 15 or 16 => FluentIcons.Common.Symbol.WeatherSnow,
+            18 or 32 => FluentIcons.Common.Symbol.WeatherFog,
+            _ => isNight ? FluentIcons.Common.Symbol.WeatherPartlyCloudyNight : FluentIcons.Common.Symbol.WeatherPartlyCloudyDay
         };
     }
 
@@ -782,7 +783,7 @@ public partial class SettingsWindow
 
     private void RenderLauncherHiddenItemsList()
     {
-        LauncherHiddenItemsListPanel.Children.Clear();
+        LauncherHiddenItemsSettingsExpander.Items.Clear();
         var hiddenItems = BuildLauncherHiddenItems();
         LauncherHiddenItemsEmptyTextBlock.IsVisible = hiddenItems.Count == 0;
         if (hiddenItems.Count == 0)
@@ -792,7 +793,7 @@ public partial class SettingsWindow
 
         foreach (var hiddenItem in hiddenItems)
         {
-            LauncherHiddenItemsListPanel.Children.Add(CreateLauncherHiddenItemRow(hiddenItem));
+            LauncherHiddenItemsSettingsExpander.Items.Add(CreateLauncherHiddenItemRow(hiddenItem));
         }
     }
 
@@ -864,82 +865,47 @@ public partial class SettingsWindow
         return string.IsNullOrWhiteSpace(fileName) ? key : fileName;
     }
 
-    private Control CreateLauncherHiddenItemRow(LauncherHiddenItemView hiddenItem)
+    private SettingsExpanderItem CreateLauncherHiddenItemRow(LauncherHiddenItemView hiddenItem)
     {
-        Control icon = hiddenItem.IconBitmap is not null
-            ? new Image
-            {
-                Source = hiddenItem.IconBitmap,
-                Width = 24,
-                Height = 24,
-                Stretch = Stretch.Uniform
-            }
-            : new Border
-            {
-                Width = 24,
-                Height = 24,
-                CornerRadius = new CornerRadius(999),
-                Background = GetThemeBrush("AdaptiveButtonBackgroundBrush"),
-                Child = new TextBlock
-                {
-                    Text = hiddenItem.Monogram,
-                    FontSize = 10,
-                    FontWeight = FontWeight.Bold,
-                    HorizontalAlignment = HorizontalAlignment.Center,
-                    VerticalAlignment = VerticalAlignment.Center
-                }
-            };
-
         var typeText = hiddenItem.Kind == LauncherEntryKind.Folder
             ? L("settings.launcher.hidden_type_folder", "Folder")
             : L("settings.launcher.hidden_type_shortcut", "Shortcut");
 
-        var infoPanel = new StackPanel
-        {
-            Orientation = Orientation.Horizontal,
-            Spacing = 10,
-            VerticalAlignment = VerticalAlignment.Center,
-            HorizontalAlignment = HorizontalAlignment.Stretch
-        };
-        infoPanel.Children.Add(icon);
-        infoPanel.Children.Add(new StackPanel
-        {
-            Spacing = 2,
-            VerticalAlignment = VerticalAlignment.Center,
-            HorizontalAlignment = HorizontalAlignment.Left,
-            Children =
-            {
-                new TextBlock { Text = hiddenItem.DisplayName, TextTrimming = TextTrimming.CharacterEllipsis, MaxLines = 1 },
-                new TextBlock { Text = typeText, FontSize = 11, Opacity = 0.7 }
-            }
-        });
-
         var restoreButton = new Button
         {
-            Content = L("settings.launcher.restore_button", "Show Again"),
+            Content = L("settings.launcher.restore_button", "Unhide"),
             MinWidth = 110,
             Padding = new Thickness(12, 6),
             Tag = new LauncherHiddenItemToken(hiddenItem.Kind, hiddenItem.Key)
         };
         restoreButton.Click += OnRestoreLauncherHiddenItemClick;
 
-        var row = new Grid
+        return new SettingsExpanderItem
         {
-            ColumnDefinitions = new ColumnDefinitions("*,Auto"),
-            ColumnSpacing = 10
+            Content = hiddenItem.DisplayName,
+            Description = typeText,
+            IconSource = CreateLauncherHiddenItemIconSource(hiddenItem),
+            IsClickEnabled = false,
+            Footer = restoreButton
         };
-        row.Children.Add(infoPanel);
-        Grid.SetColumn(infoPanel, 0);
-        row.Children.Add(restoreButton);
-        Grid.SetColumn(restoreButton, 1);
+    }
 
-        return new Border
+    private IconSource CreateLauncherHiddenItemIconSource(LauncherHiddenItemView hiddenItem)
+    {
+        if (hiddenItem.IconBitmap is not null)
         {
-            Classes = { "glass-panel" },
-            BorderThickness = new Thickness(0),
-            CornerRadius = new CornerRadius(14),
-            Padding = new Thickness(10, 8),
-            Child = row
+            return new ImageIconSource
+            {
+                Source = hiddenItem.IconBitmap
+            };
+        }
+
+        return new FluentIcons.Avalonia.Fluent.SymbolIconSource
+        {
+            Symbol = hiddenItem.Kind == LauncherEntryKind.Folder
+                ? FluentIcons.Common.Symbol.Folder
+                : FluentIcons.Common.Symbol.Apps,
+            IconVariant = FluentIcons.Common.IconVariant.Regular
         };
     }
 

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>

LanMountainDesktop/installer/ChineseSimplified.isl

@@ -0,0 +1,418 @@
+; *** Inno Setup version 6.5.0+ Chinese Simplified messages ***
+;
+; To download user-contributed translations of this file, go to:
+;   https://jrsoftware.org/files/istrans/
+;
+; Note: When translating this text, do not add periods (.) to the end of
+; messages that didn't have them already, because on those messages Inno
+; Setup adds the periods automatically (appending a period would result in
+; two periods being displayed).
+;
+; Maintained by Zhenghan Yang
+; Email: 847320916@QQ.com
+; Translation based on network resource
+; The latest Translation is on https://github.com/kira-96/Inno-Setup-Chinese-Simplified-Translation
+;
+
+[LangOptions]
+; The following three entries are very important. Be sure to read and 
+; understand the '[LangOptions] section' topic in the help file.
+LanguageName=简体中文
+; If Language Name display incorrect, uncomment next line
+; LanguageName=<7B80><4F53><4E2D><6587>
+; About LanguageID, to reference link:
+; https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c
+LanguageID=$0804
+; About CodePage, to reference link:
+; https://docs.microsoft.com/en-us/windows/win32/intl/code-page-identifiers
+LanguageCodePage=936
+; If the language you are translating to requires special font faces or
+; sizes, uncomment any of the following entries and change them accordingly.
+;DialogFontName=
+;DialogFontSize=9
+;DialogFontBaseScaleWidth=7
+;DialogFontBaseScaleHeight=15
+;WelcomeFontName=Segoe UI
+;WelcomeFontSize=14
+
+[Messages]
+
+; *** 应用程序标题
+SetupAppTitle=安装
+SetupWindowTitle=安装 - %1
+UninstallAppTitle=卸载
+UninstallAppFullTitle=%1 卸载
+
+; *** Misc. common
+InformationTitle=信息
+ConfirmTitle=确认
+ErrorTitle=错误
+
+; *** SetupLdr messages
+SetupLdrStartupMessage=现在将安装 %1。您想要继续吗？
+LdrCannotCreateTemp=无法创建临时文件。安装程序已中止
+LdrCannotExecTemp=无法执行临时目录中的文件。安装程序已中止
+HelpTextNote=
+
+; *** 启动错误消息
+LastErrorMessage=%1。%n%n错误 %2: %3
+SetupFileMissing=安装目录中缺少文件 %1。请修正这个问题或者获取程序的新副本。
+SetupFileCorrupt=安装文件已损坏。请获取程序的新副本。
+SetupFileCorruptOrWrongVer=安装文件已损坏，或是与这个安装程序的版本不兼容。请修正这个问题或获取新的程序副本。
+InvalidParameter=无效的命令行参数：%n%n%1
+SetupAlreadyRunning=安装程序正在运行。
+WindowsVersionNotSupported=此程序不支持当前计算机运行的 Windows 版本。
+WindowsServicePackRequired=此程序需要 %1 服务包 %2 或更高版本。
+NotOnThisPlatform=此程序不能在 %1 上运行。
+OnlyOnThisPlatform=此程序只能在 %1 上运行。
+OnlyOnTheseArchitectures=此程序只能安装到为下列处理器架构设计的 Windows 版本中：%n%n%1
+WinVersionTooLowError=此程序需要 %1 版本 %2 或更高。
+WinVersionTooHighError=此程序不能安装于 %1 版本 %2 或更高。
+AdminPrivilegesRequired=在安装此程序时您必须以管理员身份登录。
+PowerUserPrivilegesRequired=在安装此程序时您必须以管理员身份或有权限的用户组身份登录。
+SetupAppRunningError=安装程序发现 %1 当前正在运行。%n%n请先关闭正在运行的程序，然后点击“确定”继续，或点击“取消”退出。
+UninstallAppRunningError=卸载程序发现 %1 当前正在运行。%n%n请先关闭正在运行的程序，然后点击“确定”继续，或点击“取消”退出。
+
+; *** 启动问题
+PrivilegesRequiredOverrideTitle=选择安装程序模式
+PrivilegesRequiredOverrideInstruction=选择安装模式
+PrivilegesRequiredOverrideText1=%1 可以为所有用户安装(需要管理员权限)，或仅为您安装。
+PrivilegesRequiredOverrideText2=%1 可以仅为您安装，或为所有用户安装(需要管理员权限)。
+PrivilegesRequiredOverrideAllUsers=为所有用户安装(&A)
+PrivilegesRequiredOverrideAllUsersRecommended=为所有用户安装(&A) (建议选项)
+PrivilegesRequiredOverrideCurrentUser=仅为我安装(&M)
+PrivilegesRequiredOverrideCurrentUserRecommended=仅为我安装(&M) (建议选项)
+
+; *** 其他错误
+ErrorCreatingDir=安装程序无法创建目录“%1”
+ErrorTooManyFilesInDir=无法在目录“%1”中创建文件，因为里面包含太多文件
+
+; *** 安装程序公共消息
+ExitSetupTitle=退出安装程序
+ExitSetupMessage=安装程序尚未完成。如果现在退出，将不会安装该程序。%n%n您之后可以再次运行安装程序完成安装。%n%n现在退出安装程序吗？
+AboutSetupMenuItem=关于安装程序(&A)...
+AboutSetupTitle=关于安装程序
+AboutSetupMessage=%1 版本 %2%n%3%n%n%1 主页：%n%4
+AboutSetupNote=
+TranslatorNote=简体中文翻译由Kira(847320916@qq.com)维护。项目地址：https://github.com/kira-96/Inno-Setup-Chinese-Simplified-Translation
+
+; *** 按钮
+ButtonBack=< 上一步(&B)
+ButtonNext=下一步(&N) >
+ButtonInstall=安装(&I)
+ButtonOK=确定
+ButtonCancel=取消
+ButtonYes=是(&Y)
+ButtonYesToAll=全是(&A)
+ButtonNo=否(&N)
+ButtonNoToAll=全否(&O)
+ButtonFinish=完成(&F)
+ButtonBrowse=浏览(&B)...
+ButtonWizardBrowse=浏览(&R)...
+ButtonNewFolder=新建文件夹(&M)
+
+; *** “选择语言”对话框消息
+SelectLanguageTitle=选择安装语言
+SelectLanguageLabel=选择安装时使用的语言。
+
+; *** 公共向导文字
+ClickNext=点击“下一步”继续，或点击“取消”退出安装程序。
+BeveledLabel=
+BrowseDialogTitle=浏览文件夹
+BrowseDialogLabel=在下面的列表中选择一个文件夹，然后点击“确定”。
+NewFolderName=新建文件夹
+
+; *** “欢迎”向导页
+WelcomeLabel1=欢迎使用 [name] 安装向导
+WelcomeLabel2=现在将安装 [name/ver] 到您的电脑中。%n%n建议您在继续安装前关闭所有其他应用程序。
+
+; *** “密码”向导页
+WizardPassword=密码
+PasswordLabel1=这个安装程序有密码保护。
+PasswordLabel3=请输入密码，然后点击“下一步”继续。密码区分大小写。
+PasswordEditLabel=密码(&P)：
+IncorrectPassword=您输入的密码不正确，请重新输入。
+
+; *** “许可协议”向导页
+WizardLicense=许可协议
+LicenseLabel=请在继续安装前阅读以下重要信息。
+LicenseLabel3=请仔细阅读下列许可协议。在继续安装前您必须同意这些协议条款。
+LicenseAccepted=我同意此协议(&A)
+LicenseNotAccepted=我不同意此协议(&D)
+
+; *** “信息”向导页
+WizardInfoBefore=信息
+InfoBeforeLabel=请在继续安装前阅读以下重要信息。
+InfoBeforeClickLabel=准备好继续安装后，点击“下一步”。
+WizardInfoAfter=信息
+InfoAfterLabel=请在继续安装前阅读以下重要信息。
+InfoAfterClickLabel=准备好继续安装后，点击“下一步”。
+
+; *** “用户信息”向导页
+WizardUserInfo=用户信息
+UserInfoDesc=请输入您的信息。
+UserInfoName=用户名(&U)：
+UserInfoOrg=组织(&O)：
+UserInfoSerial=序列号(&S)：
+UserInfoNameRequired=您必须输入用户名。
+
+; *** “选择目标目录”向导页
+WizardSelectDir=选择目标位置
+SelectDirDesc=您想将 [name] 安装在哪里？
+SelectDirLabel3=安装程序将安装 [name] 到下面的文件夹中。
+SelectDirBrowseLabel=点击“下一步”继续。如果您想选择其他文件夹，点击“浏览”。
+DiskSpaceGBLabel=至少需要有 [gb] GB 的可用磁盘空间。
+DiskSpaceMBLabel=至少需要有 [mb] MB 的可用磁盘空间。
+CannotInstallToNetworkDrive=安装程序无法安装到一个网络驱动器。
+CannotInstallToUNCPath=安装程序无法安装到一个 UNC 路径。
+InvalidPath=您必须输入一个带驱动器卷标的完整路径，例如：%n%nC:\APP%n%n或UNC路径：%n%n\\server\share
+InvalidDrive=您选定的驱动器或 UNC 共享不存在或不能访问。请选择其他位置。
+DiskSpaceWarningTitle=磁盘空间不足
+DiskSpaceWarning=安装程序至少需要 %1 KB 的可用空间才能安装，但选定驱动器只有 %2 KB 的可用空间。%n%n您一定要继续吗？
+DirNameTooLong=文件夹名称或路径太长。
+InvalidDirName=文件夹名称无效。
+BadDirName32=文件夹名称不能包含下列任何字符：%n%n%1
+DirExistsTitle=文件夹已存在
+DirExists=文件夹：%n%n%1%n%n已经存在。您一定要安装到这个文件夹中吗？
+DirDoesntExistTitle=文件夹不存在
+DirDoesntExist=文件夹：%n%n%1%n%n不存在。您想要创建此文件夹吗？
+
+; *** “选择组件”向导页
+WizardSelectComponents=选择组件
+SelectComponentsDesc=您想安装哪些程序组件？
+SelectComponentsLabel2=选中您想安装的组件；取消您不想安装的组件。然后点击“下一步”继续。
+FullInstallation=完全安装
+; if possible don't translate 'Compact' as 'Minimal' (I mean 'Minimal' in your language)
+CompactInstallation=简洁安装
+CustomInstallation=自定义安装
+NoUninstallWarningTitle=组件已存在
+NoUninstallWarning=安装程序检测到下列组件已安装在您的电脑中：%n%n%1%n%n取消选中这些组件不会卸载它们。%n%n确定要继续吗？
+ComponentSize1=%1 KB
+ComponentSize2=%1 MB
+ComponentsDiskSpaceGBLabel=当前选择的组件需要至少 [gb] GB 的磁盘空间。
+ComponentsDiskSpaceMBLabel=当前选择的组件需要至少 [mb] MB 的磁盘空间。
+
+; *** “选择附加任务”向导页
+WizardSelectTasks=选择附加任务
+SelectTasksDesc=您想要安装程序执行哪些附加任务？
+SelectTasksLabel2=选择您想要安装程序在安装 [name] 时执行的附加任务，然后点击“下一步”。
+
+; *** “选择开始菜单文件夹”向导页
+WizardSelectProgramGroup=选择开始菜单文件夹
+SelectStartMenuFolderDesc=安装程序应该在哪里放置程序的快捷方式？
+SelectStartMenuFolderLabel3=安装程序将在下列“开始”菜单文件夹中创建程序的快捷方式。
+SelectStartMenuFolderBrowseLabel=点击“下一步”继续。如果您想选择其他文件夹，点击“浏览”。
+MustEnterGroupName=您必须输入一个文件夹名。
+GroupNameTooLong=文件夹名或路径太长。
+InvalidGroupName=无效的文件夹名字。
+BadGroupName=文件夹名不能包含下列任何字符：%n%n%1
+NoProgramGroupCheck2=不创建开始菜单文件夹(&D)
+
+; *** “准备安装”向导页
+WizardReady=准备安装
+ReadyLabel1=安装程序准备就绪，现在可以开始安装 [name] 到您的电脑。
+ReadyLabel2a=点击“安装”继续此安装程序。如果您想重新考虑或修改任何设置，点击“上一步”。
+ReadyLabel2b=点击“安装”继续此安装程序。
+ReadyMemoUserInfo=用户信息：
+ReadyMemoDir=目标位置：
+ReadyMemoType=安装类型：
+ReadyMemoComponents=已选择组件：
+ReadyMemoGroup=开始菜单文件夹：
+ReadyMemoTasks=附加任务：
+
+; *** TExtractionWizardPage 向导页面与 ExtractArchive
+ExtractingLabel=正在解压文件...
+ButtonStopExtraction=停止解压(&S)
+StopExtraction=您确定要停止解压吗？
+ErrorExtractionAborted=解压已中止
+ErrorExtractionFailed=解压失败：%1
+
+; *** 压缩文件解压失败详情
+ArchiveIncorrectPassword=压缩文件密码不正确
+ArchiveIsCorrupted=压缩文件已损坏
+ArchiveUnsupportedFormat=不支持的压缩文件格式
+
+; *** TDownloadWizardPage 向导页面和 DownloadTemporaryFile
+DownloadingLabel2=正在下载文件...
+ButtonStopDownload=停止下载(&S)
+StopDownload=您确定要停止下载吗？
+ErrorDownloadAborted=下载已中止
+ErrorDownloadFailed=下载失败：%1 %2
+ErrorDownloadSizeFailed=获取下载大小失败：%1 %2
+ErrorProgress=无效的进度：%1 / %2
+ErrorFileSize=文件大小错误：预期 %1，实际 %2
+
+; *** “正在准备安装”向导页
+WizardPreparing=正在准备安装
+PreparingDesc=安装程序正在准备安装 [name] 到您的电脑。
+PreviousInstallNotCompleted=先前的程序安装或卸载未完成，您需要重启您的电脑以完成。%n%n在重启电脑后，再次运行安装程序以完成 [name] 的安装。
+CannotContinue=安装程序不能继续。请点击“取消”退出。
+ApplicationsFound=以下应用程序正在使用将由安装程序更新的文件。建议您允许安装程序自动关闭这些应用程序。
+ApplicationsFound2=以下应用程序正在使用将由安装程序更新的文件。建议您允许安装程序自动关闭这些应用程序。安装完成后，安装程序将尝试重新启动这些应用程序。
+CloseApplications=自动关闭应用程序(&A)
+DontCloseApplications=不要关闭应用程序(&D)
+ErrorCloseApplications=安装程序无法自动关闭所有应用程序。建议您在继续之前，关闭所有在使用需要由安装程序更新的文件的应用程序。
+PrepareToInstallNeedsRestart=安装程序必须重启您的计算机。计算机重启后，请再次运行安装程序以完成 [name] 的安装。%n%n是否立即重新启动？
+
+; *** “正在安装”向导页
+WizardInstalling=正在安装
+InstallingLabel=安装程序正在安装 [name] 到您的电脑，请稍候。
+
+; *** “安装完成”向导页
+FinishedHeadingLabel=[name] 安装完成
+FinishedLabelNoIcons=安装程序已在您的电脑中安装了 [name]。
+FinishedLabel=安装程序已在您的电脑中安装了 [name]。您可以通过已安装的快捷方式运行此应用程序。
+ClickFinish=点击“完成”退出安装程序。
+FinishedRestartLabel=为完成 [name] 的安装，安装程序必须重新启动您的电脑。要立即重启吗？
+FinishedRestartMessage=为完成 [name] 的安装，安装程序必须重新启动您的电脑。%n%n要立即重启吗？
+ShowReadmeCheck=是，我想查阅自述文件
+YesRadio=是，立即重启电脑(&Y)
+NoRadio=否，稍后重启电脑(&N)
+; used for example as 'Run MyProg.exe'
+RunEntryExec=运行 %1
+; used for example as 'View Readme.txt'
+RunEntryShellExec=查阅 %1
+
+; *** “安装程序需要下一张磁盘”提示
+ChangeDiskTitle=安装程序需要下一张磁盘
+SelectDiskLabel2=请插入磁盘 %1 并点击“确定”。%n%n如果这个磁盘中的文件可以在下列文件夹之外的文件夹中找到，请输入正确的路径或点击“浏览”。
+PathLabel=路径(&P)：
+FileNotInDir2=“%2”中找不到文件“%1”。请插入正确的磁盘或选择其他文件夹。
+SelectDirectoryLabel=请指定下一张磁盘的位置。
+
+; *** 安装阶段消息
+SetupAborted=安装程序未完成安装。%n%n请修正这个问题并重新运行安装程序。
+AbortRetryIgnoreSelectAction=选择操作
+AbortRetryIgnoreRetry=重试(&T)
+AbortRetryIgnoreIgnore=忽略错误并继续(&I)
+AbortRetryIgnoreCancel=关闭安装程序
+RetryCancelSelectAction=选择操作
+RetryCancelRetry=重试(&T)
+RetryCancelCancel=取消(&C)
+
+; *** 安装状态消息
+StatusClosingApplications=正在关闭应用程序...
+StatusCreateDirs=正在创建目录...
+StatusExtractFiles=正在提取文件...
+StatusDownloadFiles=正在下载文件...
+StatusCreateIcons=正在创建快捷方式...
+StatusCreateIniEntries=正在创建 INI 条目...
+StatusCreateRegistryEntries=正在创建注册表条目...
+StatusRegisterFiles=正在注册文件...
+StatusSavingUninstall=正在保存卸载信息...
+StatusRunProgram=正在完成安装...
+StatusRestartingApplications=正在重启应用程序...
+StatusRollback=正在撤销更改...
+
+; *** 其他错误
+ErrorInternal2=内部错误：%1
+ErrorFunctionFailedNoCode=%1 失败
+ErrorFunctionFailed=%1 失败；错误代码 %2
+ErrorFunctionFailedWithMessage=%1 失败；错误代码 %2.%n%3
+ErrorExecutingProgram=无法执行文件：%n%1
+
+; *** 注册表错误
+ErrorRegOpenKey=打开注册表项时出错：%n%1\%2
+ErrorRegCreateKey=创建注册表项时出错：%n%1\%2
+ErrorRegWriteKey=写入注册表项时出错：%n%1\%2
+
+; *** INI 错误
+ErrorIniEntry=在文件“%1”中创建 INI 条目时出错。
+
+; *** 文件复制错误
+FileAbortRetryIgnoreSkipNotRecommended=跳过此文件(&S) (不推荐)
+FileAbortRetryIgnoreIgnoreNotRecommended=忽略错误并继续(&I) (不推荐)
+SourceIsCorrupted=源文件已损坏
+SourceDoesntExist=源文件“%1”不存在
+SourceVerificationFailed=源文件验证失败: %1
+VerificationSignatureDoesntExist=签名文件“%1”不存在
+VerificationSignatureInvalid=签名文件“%1”无效
+VerificationKeyNotFound=签名文件“%1”使用了未知密钥
+VerificationFileNameIncorrect=文件名不正确
+VerificationFileTagIncorrect=文件标签不正确
+VerificationFileSizeIncorrect=文件大小不正确
+VerificationFileHashIncorrect=文件哈希值不正确
+ExistingFileReadOnly2=无法替换现有文件，它是只读的。
+ExistingFileReadOnlyRetry=移除只读属性并重试(&R)
+ExistingFileReadOnlyKeepExisting=保留现有文件(&K)
+ErrorReadingExistingDest=尝试读取现有文件时出错：
+FileExistsSelectAction=选择操作
+FileExists2=文件已经存在。
+FileExistsOverwriteExisting=覆盖已存在的文件(&O)
+FileExistsKeepExisting=保留现有的文件(&K)
+FileExistsOverwriteOrKeepAll=为所有冲突文件执行此操作(&D)
+ExistingFileNewerSelectAction=选择操作
+ExistingFileNewer2=现有的文件比安装程序将要安装的文件还要新。
+ExistingFileNewerOverwriteExisting=覆盖已存在的文件(&O)
+ExistingFileNewerKeepExisting=保留现有的文件(&K) (推荐)
+ExistingFileNewerOverwriteOrKeepAll=为所有冲突文件执行此操作(&D)
+ErrorChangingAttr=尝试更改下列现有文件的属性时出错：
+ErrorCreatingTemp=尝试在目标目录创建文件时出错：
+ErrorReadingSource=尝试读取下列源文件时出错：
+ErrorCopying=尝试复制下列文件时出错：
+ErrorDownloading=下载文件时出错：
+ErrorExtracting=解压压缩文件时出错：
+ErrorReplacingExistingFile=尝试替换现有文件时出错：
+ErrorRestartReplace=重启并替换失败：
+ErrorRenamingTemp=尝试重命名下列目标目录中的一个文件时出错：
+ErrorRegisterServer=无法注册 DLL/OCX：%1
+ErrorRegSvr32Failed=RegSvr32 失败；退出代码 %1
+ErrorRegisterTypeLib=无法注册类库：%1
+
+; *** 卸载显示名字标记
+; used for example as 'My Program (32-bit)'
+UninstallDisplayNameMark=%1 (%2)
+; used for example as 'My Program (32-bit, All users)'
+UninstallDisplayNameMarks=%1 (%2, %3)
+UninstallDisplayNameMark32Bit=32 位
+UninstallDisplayNameMark64Bit=64 位
+UninstallDisplayNameMarkAllUsers=所有用户
+UninstallDisplayNameMarkCurrentUser=当前用户
+
+; *** 安装后错误
+ErrorOpeningReadme=尝试打开自述文件时出错。
+ErrorRestartingComputer=安装程序无法重启电脑，请手动重启。
+
+; *** 卸载消息
+UninstallNotFound=文件“%1”不存在。无法卸载。
+UninstallOpenError=文件“%1”不能被打开。无法卸载。
+UninstallUnsupportedVer=此版本的卸载程序无法识别卸载日志文件“%1”的格式。无法卸载
+UninstallUnknownEntry=卸载日志中遇到一个未知条目 (%1)
+ConfirmUninstall=您确认要完全移除 %1 及其所有组件吗？
+UninstallOnlyOnWin64=仅允许在 64 位 Windows 中卸载此程序。
+OnlyAdminCanUninstall=仅使用管理员权限的用户能完成此卸载。
+UninstallStatusLabel=正在从您的电脑中移除 %1，请稍候。
+UninstalledAll=已顺利从您的电脑中移除 %1。
+UninstalledMost=%1 卸载完成。%n%n有部分内容未能被删除，但您可以手动删除它们。
+UninstalledAndNeedsRestart=为完成 %1 的卸载，需要重启您的电脑。%n%n立即重启电脑吗？
+UninstallDataCorrupted=文件“%1”已损坏。无法卸载
+
+; *** 卸载状态消息
+ConfirmDeleteSharedFileTitle=删除共享的文件吗？
+ConfirmDeleteSharedFile2=系统表示下列共享的文件已不有其他程序使用。您希望卸载程序删除这些共享的文件吗？%n%n如果删除这些文件，但仍有程序在使用这些文件，则这些程序可能出现异常。如果您不能确定，请选择“否”，在系统中保留这些文件以免引发问题。
+SharedFileNameLabel=文件名：
+SharedFileLocationLabel=位置：
+WizardUninstalling=卸载状态
+StatusUninstalling=正在卸载 %1...
+
+; *** Shutdown block reasons
+ShutdownBlockReasonInstallingApp=正在安装 %1。
+ShutdownBlockReasonUninstallingApp=正在卸载 %1。
+
+; The custom messages below aren't used by Setup itself, but if you make
+; use of them in your scripts, you'll want to translate them.
+
+[CustomMessages]
+
+NameAndVersion=%1 版本 %2
+AdditionalIcons=附加快捷方式：
+CreateDesktopIcon=创建桌面快捷方式(&D)
+CreateQuickLaunchIcon=创建快速启动栏快捷方式(&Q)
+ProgramOnTheWeb=%1 网站
+UninstallProgram=卸载 %1
+LaunchProgram=运行 %1
+AssocFileExtension=将 %2 文件扩展名与 %1 建立关联(&A)
+AssocingFileExtension=正在将 %2 文件扩展名与 %1 建立关联...
+AutoStartProgramGroupDescription=启动：
+AutoStartProgram=自动启动 %1
+AddonHostProgramNotFound=您选择的文件夹中无法找到 %1。%n%n您要继续吗？

LanMountainDesktop/installer/LanMountainDesktop.iss

@@ -1,6 +1,8 @@
-#define MyAppName "LanMountainDesktop"
+#define MyAppName "LanMountainDesktop"
 #define MyAppPublisher "LanMountainDesktop Team"
 #define MyAppExeName "LanMountainDesktop.exe"
+#define MyAppId "{{5A058B0D-F95D-4A18-B9A0-93F843655DDB}"
+#define MyAppRegistryId "{5A058B0D-F95D-4A18-B9A0-93F843655DDB}"
 
 #ifndef MyAppVersion
   #define MyAppVersion "0.0.0"
@@ -19,13 +21,16 @@
 #endif
 
 [Setup]
-AppId={{5A058B0D-F95D-4A18-B9A0-93F843655DDB}
+AppId={#MyAppId}
 AppName={#MyAppName}
 AppVersion={#MyAppVersion}
 AppPublisher={#MyAppPublisher}
 DefaultDirName={autopf}\{#MyAppName}
 DisableDirPage=no
 UsePreviousAppDir=no
+ShowLanguageDialog=yes
+UsePreviousLanguage=no
+LanguageDetectionMethod=uilanguage
 DefaultGroupName={#MyAppName}
 UninstallDisplayIcon={app}\{#MyAppExeName}
 OutputDir={#MyOutputDir}
@@ -34,6 +39,9 @@ Compression=lzma2/ultra64
 SolidCompression=yes
 WizardStyle=modern
 PrivilegesRequired=admin
+CloseApplications=yes
+CloseApplicationsFilter={#MyAppExeName}
+RestartApplications=no
 DisableProgramGroupPage=yes
 
 #if MyAppArch == "x64"
@@ -47,10 +55,55 @@ ArchitecturesAllowed=x86compatible
 
 [Languages]
 Name: "english"; MessagesFile: "compiler:Default.isl"
+Name: "chinesesimplified"; MessagesFile: "{#SourcePath}\ChineseSimplified.isl"
+
+[CustomMessages]
+english.StartupTaskDescription=Launch LanMountainDesktop when you sign in to Windows
+chinesesimplified.StartupTaskDescription=登录 Windows 时启动 LanMountainDesktop
+english.WebView2MissingMessage=Microsoft Edge WebView2 Runtime is required for the browser component.
+chinesesimplified.WebView2MissingMessage=浏览器组件需要 Microsoft Edge WebView2 Runtime。
+english.WebView2MissingAction=Click "Yes" to open the official download page. Install it first, then run this installer again.
+chinesesimplified.WebView2MissingAction=单击“是”打开官方下载页面。请先完成安装，然后重新运行此安装程序。
+english.WebView2OpenFailedMessage=Unable to open the download page automatically.
+chinesesimplified.WebView2OpenFailedMessage=无法自动打开下载页面。
+english.WebView2OpenFailedAction=Please open this URL manually:
+chinesesimplified.WebView2OpenFailedAction=请手动打开以下链接：
+english.UpgradePageCaption=Upgrade Existing Installation
+chinesesimplified.UpgradePageCaption=升级现有安装
+english.UpgradePageDescription=LanMountainDesktop is already installed on this computer. Choose how to upgrade it.
+chinesesimplified.UpgradePageDescription=此计算机上已安装 LanMountainDesktop。请选择升级方式。
+english.UpgradeDetectedVersionLabel=Detected version:
+chinesesimplified.UpgradeDetectedVersionLabel=检测到的版本：
+english.UpgradeCurrentLocationLabel=Current location:
+chinesesimplified.UpgradeCurrentLocationLabel=当前安装位置：
+english.UpgradePageSubCaption=Choose "Upgrade existing installation" to reuse the current location, or choose "Change installation location and migrate installation" to move the app without leaving a duplicate copy behind.
+chinesesimplified.UpgradePageSubCaption=选择“升级现有安装”可复用当前安装位置；选择“更改安装位置并迁移安装”可移动应用，同时避免留下重复安装。
+english.UpgradeOptionInPlace=Upgrade existing installation
+chinesesimplified.UpgradeOptionInPlace=升级现有安装
+english.UpgradeOptionRelocate=Change installation location and migrate installation
+chinesesimplified.UpgradeOptionRelocate=更改安装位置并迁移安装
+english.UpgradeUnknownVersion=Unknown
+chinesesimplified.UpgradeUnknownVersion=未知
+english.UpgradeCleanupMissingUninstaller=Setup found an existing installation, but its uninstaller is unavailable. Please uninstall the current version manually and run this installer again.
+chinesesimplified.UpgradeCleanupMissingUninstaller=安装程序发现了现有安装，但无法找到它的卸载程序。请先手动卸载当前版本，再重新运行此安装程序。
+english.UpgradeCleanupFailedPrefix=Setup could not remove the existing installation automatically. Error code:
+chinesesimplified.UpgradeCleanupFailedPrefix=安装程序无法自动移除现有安装。错误代码：
+english.UpgradeCleanupFailedSuffix=Please close LanMountainDesktop, uninstall the current version manually, and then run this installer again.
+chinesesimplified.UpgradeCleanupFailedSuffix=请关闭 LanMountainDesktop，手动卸载当前版本，然后重新运行此安装程序。
 
 [Tasks]
 Name: "desktopicon"; Description: "{cm:CreateDesktopIcon}"; GroupDescription: "{cm:AdditionalIcons}"
-Name: "startup"; Description: "Launch LanMountainDesktop when you sign in to Windows"; GroupDescription: "{cm:AdditionalIcons}"; Flags: unchecked
+Name: "startup"; Description: "{cm:StartupTaskDescription}"; GroupDescription: "{cm:AdditionalIcons}"; Flags: unchecked
+
+[Dirs]
+Name: "{app}\log"; Permissions: users-modify
+
+[InstallDelete]
+Type: files; Name: "{app}\LanMontainDesktop.exe"
+Type: files; Name: "{app}\LanMontainDesktop.dll"
+Type: files; Name: "{app}\LanMontainDesktop.deps.json"
+Type: files; Name: "{app}\LanMontainDesktop.runtimeconfig.json"
+Type: files; Name: "{app}\LanMontainDesktop.pdb"
 
 [Files]
 Source: "{#PublishDir}\*"; DestDir: "{app}"; Flags: ignoreversion recursesubdirs createallsubdirs
@@ -67,12 +120,309 @@ Filename: "{app}\{#MyAppExeName}"; Description: "{cm:LaunchProgram,{#StringChang
 
 [Code]
 const
+  UninstallRegSubkey = 'Software\Microsoft\Windows\CurrentVersion\Uninstall\{#MyAppRegistryId}_is1';
   WebView2RuntimeKeyPath = 'SOFTWARE\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}';
   WebView2RuntimeDownloadUrl = 'https://go.microsoft.com/fwlink/p/?LinkId=2124703';
+  UpgradeChoiceInPlace = 0;
+  UpgradeChoiceRelocate = 1;
+
+var
+  UpgradeModePage: TInputOptionWizardPage;
+  ExistingInstallFound: Boolean;
+  ExistingInstallPath: String;
+  ExistingInstallVersion: String;
+  ExistingUninstallCommand: String;
+  ExistingInstallWas64Bit: Boolean;
+  ExistingInstallIsPerUser: Boolean;
+  ExistingInstallRemoved: Boolean;
+
+function NormalizePathValue(const Value: String): String;
+begin
+  Result := RemoveBackslashUnlessRoot(Trim(Value));
+end;
+
+function CombinePath(const BasePath: String; const ChildName: String): String;
+begin
+  if BasePath = '' then
+  begin
+    Result := ChildName;
+  end
+  else
+  begin
+    Result := NormalizePathValue(BasePath) + '\' + ChildName;
+  end;
+end;
+
+function SamePath(const LeftPath: String; const RightPath: String): Boolean;
+begin
+  Result := CompareText(NormalizePathValue(LeftPath), NormalizePathValue(RightPath)) = 0;
+end;
+
+function ExtractExecutableFromCommand(const CommandLine: String): String;
+var
+  CommandText: String;
+  ClosingQuotePos: Integer;
+  ExePos: Integer;
+begin
+  Result := '';
+  CommandText := Trim(CommandLine);
+  if CommandText = '' then
+  begin
+    exit;
+  end;
+
+  if CommandText[1] = '"' then
+  begin
+    Delete(CommandText, 1, 1);
+    ClosingQuotePos := Pos('"', CommandText);
+    if ClosingQuotePos > 0 then
+    begin
+      Result := Copy(CommandText, 1, ClosingQuotePos - 1);
+    end
+    else
+    begin
+      Result := CommandText;
+    end;
+  end
+  else
+  begin
+    ExePos := Pos('.exe', LowerCase(CommandText));
+    if ExePos > 0 then
+    begin
+      Result := Copy(CommandText, 1, ExePos + 3);
+    end
+    else
+    begin
+      Result := CommandText;
+    end;
+  end;
+
+  Result := NormalizePathValue(RemoveQuotes(Result));
+end;
+
+function GetExistingExecutablePath(): String;
+begin
+  if ExistingInstallPath = '' then
+  begin
+    Result := '';
+  end
+  else
+  begin
+    Result := CombinePath(ExistingInstallPath, '{#MyAppExeName}');
+  end;
+end;
+
+function GetDefaultInstallPath(): String;
+begin
+  Result := NormalizePathValue(ExpandConstant('{autopf}\{#MyAppName}'));
+end;
+
+function GetExistingInstallVersionText(): String;
+begin
+  Result := Trim(ExistingInstallVersion);
+  if Result = '' then
+  begin
+    Result := CustomMessage('UpgradeUnknownVersion');
+  end;
+end;
+
+procedure ShowUpgradeCleanupError(const MessageText: String);
+begin
+  Log(MessageText);
+  if not WizardSilent then
+  begin
+    MsgBox(MessageText, mbError, MB_OK);
+  end;
+end;
+
+function TryLoadExistingInstallation(
+  const RootKey: Integer;
+  const Is64BitView: Boolean;
+  const IsPerUser: Boolean): Boolean;
+var
+  InstallLocation: String;
+  AppPath: String;
+  UninstallString: String;
+  DisplayVersion: String;
+  ResolvedPath: String;
+begin
+  Result := False;
+  InstallLocation := '';
+  AppPath := '';
+  UninstallString := '';
+  DisplayVersion := '';
+
+  if not RegKeyExists(RootKey, UninstallRegSubkey) then
+  begin
+    exit;
+  end;
+
+  RegQueryStringValue(RootKey, UninstallRegSubkey, 'InstallLocation', InstallLocation);
+  RegQueryStringValue(RootKey, UninstallRegSubkey, 'Inno Setup: App Path', AppPath);
+  RegQueryStringValue(RootKey, UninstallRegSubkey, 'UninstallString', UninstallString);
+  RegQueryStringValue(RootKey, UninstallRegSubkey, 'DisplayVersion', DisplayVersion);
+
+  ResolvedPath := NormalizePathValue(InstallLocation);
+  if ResolvedPath = '' then
+  begin
+    ResolvedPath := NormalizePathValue(AppPath);
+  end;
+  if (ResolvedPath = '') and (UninstallString <> '') then
+  begin
+    ResolvedPath := NormalizePathValue(ExtractFileDir(ExtractExecutableFromCommand(UninstallString)));
+  end;
+
+  if (ResolvedPath = '') or
+     (not DirExists(ResolvedPath)) or
+     (not FileExists(CombinePath(ResolvedPath, '{#MyAppExeName}'))) then
+  begin
+    exit;
+  end;
+
+  ExistingInstallFound := True;
+  ExistingInstallPath := ResolvedPath;
+  ExistingInstallVersion := Trim(DisplayVersion);
+  ExistingUninstallCommand := Trim(UninstallString);
+  ExistingInstallWas64Bit := Is64BitView;
+  ExistingInstallIsPerUser := IsPerUser;
+  Result := True;
+end;
+
+procedure DetectExistingInstallation;
+begin
+  ExistingInstallFound := False;
+  ExistingInstallPath := '';
+  ExistingInstallVersion := '';
+  ExistingUninstallCommand := '';
+  ExistingInstallWas64Bit := False;
+  ExistingInstallIsPerUser := False;
+  ExistingInstallRemoved := False;
+
+  if IsWin64 then
+  begin
+    if TryLoadExistingInstallation(HKLM64, True, False) then
+    begin
+      exit;
+    end;
+    if TryLoadExistingInstallation(HKCU64, True, True) then
+    begin
+      exit;
+    end;
+  end;
+
+  if TryLoadExistingInstallation(HKLM32, False, False) then
+  begin
+    exit;
+  end;
+
+  TryLoadExistingInstallation(HKCU32, False, True);
+end;
+
+function SelectedUpgradeChoice(): Integer;
+begin
+  if UpgradeModePage <> nil then
+  begin
+    Result := UpgradeModePage.SelectedValueIndex;
+  end
+  else
+  begin
+    Result := UpgradeChoiceInPlace;
+  end;
+end;
+
+procedure ApplySelectedInstallDirectory;
+var
+  CurrentDir: String;
+begin
+  if not ExistingInstallFound then
+  begin
+    exit;
+  end;
+
+  if SelectedUpgradeChoice() = UpgradeChoiceInPlace then
+  begin
+    WizardForm.DirEdit.Text := ExistingInstallPath;
+    exit;
+  end;
+
+  CurrentDir := NormalizePathValue(WizardDirValue);
+  if (CurrentDir = '') or SamePath(CurrentDir, GetDefaultInstallPath()) then
+  begin
+    WizardForm.DirEdit.Text := ExistingInstallPath;
+  end;
+end;
+
+function GetSelectedInstallPath(): String;
+begin
+  Result := NormalizePathValue(ExpandConstant('{app}'));
+  if Result = '' then
+  begin
+    Result := NormalizePathValue(WizardDirValue);
+  end;
+  if Result = '' then
+  begin
+    Result := ExistingInstallPath;
+  end;
+end;
+
+function ExistingInstallRequiresCleanup(): Boolean;
+var
+  TargetPath: String;
+begin
+  Result := False;
+  if not ExistingInstallFound or ExistingInstallRemoved then
+  begin
+    exit;
+  end;
+
+  TargetPath := GetSelectedInstallPath();
+  Result := ExistingInstallIsPerUser or
+            (not SamePath(TargetPath, ExistingInstallPath)) or
+            (ExistingInstallWas64Bit <> Is64BitInstallMode);
+end;
+
+function RemoveExistingInstallation(): Boolean;
+var
+  UninstallerPath: String;
+  ResultCode: Integer;
+begin
+  Result := True;
+
+  if not ExistingInstallRequiresCleanup() then
+  begin
+    exit;
+  end;
+
+  UninstallerPath := ExtractExecutableFromCommand(ExistingUninstallCommand);
+  if (UninstallerPath = '') or (not FileExists(UninstallerPath)) then
+  begin
+    ShowUpgradeCleanupError(CustomMessage('UpgradeCleanupMissingUninstaller'));
+    Result := False;
+    exit;
+  end;
+
+  ResultCode := -1;
+  if not Exec(
+    UninstallerPath,
+    '/VERYSILENT /SUPPRESSMSGBOXES /NORESTART',
+    ExtractFileDir(UninstallerPath),
+    SW_SHOWNORMAL,
+    ewWaitUntilTerminated,
+    ResultCode) or (ResultCode <> 0) then
+  begin
+    ShowUpgradeCleanupError(
+      CustomMessage('UpgradeCleanupFailedPrefix') + ' ' + IntToStr(ResultCode) + '. ' +
+      CustomMessage('UpgradeCleanupFailedSuffix'));
+    Result := False;
+    exit;
+  end;
+
+  ExistingInstallRemoved := True;
+end;
 
 function IsWebView2RuntimeInstalled(): Boolean;
 var
-  VersionValue: string;
+  VersionValue: String;
 begin
   Result :=
     RegQueryStringValue(HKLM64, WebView2RuntimeKeyPath, 'pv', VersionValue) or
@@ -92,16 +442,16 @@ begin
   end;
 
   if MsgBox(
-    'Microsoft Edge WebView2 Runtime is required for the browser component.'#13#10#13#10 +
-    'Click "Yes" to open the official download page. Install it first, then run this installer again.',
+    CustomMessage('WebView2MissingMessage') + #13#10#13#10 +
+    CustomMessage('WebView2MissingAction'),
     mbConfirmation,
     MB_YESNO) = IDYES then
   begin
     if not ShellExec('open', WebView2RuntimeDownloadUrl, '', '', SW_SHOWNORMAL, ewNoWait, ErrorCode) then
     begin
       MsgBox(
-        'Unable to open the download page automatically.'#13#10 +
-        'Please open this URL manually:'#13#10 + WebView2RuntimeDownloadUrl,
+        CustomMessage('WebView2OpenFailedMessage') + #13#10 +
+        CustomMessage('WebView2OpenFailedAction') + #13#10 + WebView2RuntimeDownloadUrl,
         mbError,
         MB_OK);
     end;
@@ -109,3 +459,84 @@ begin
 
   Result := False;
 end;
+
+procedure InitializeWizard;
+var
+  DetailsText: String;
+begin
+  DetectExistingInstallation;
+
+  if not ExistingInstallFound then
+  begin
+    exit;
+  end;
+
+  DetailsText :=
+    CustomMessage('UpgradeDetectedVersionLabel') + ' ' + GetExistingInstallVersionText() + #13#10 +
+    CustomMessage('UpgradeCurrentLocationLabel') + ' ' + ExistingInstallPath + #13#10#13#10 +
+    CustomMessage('UpgradePageSubCaption');
+
+  UpgradeModePage := CreateInputOptionPage(
+    wpWelcome,
+    CustomMessage('UpgradePageCaption'),
+    CustomMessage('UpgradePageDescription'),
+    DetailsText,
+    True,
+    False);
+  UpgradeModePage.Add(CustomMessage('UpgradeOptionInPlace'));
+  UpgradeModePage.Add(CustomMessage('UpgradeOptionRelocate'));
+  UpgradeModePage.SelectedValueIndex := UpgradeChoiceInPlace;
+end;
+
+function NextButtonClick(CurPageID: Integer): Boolean;
+begin
+  Result := True;
+
+  if (UpgradeModePage <> nil) and (CurPageID = UpgradeModePage.ID) then
+  begin
+    ApplySelectedInstallDirectory;
+  end;
+end;
+
+function ShouldSkipPage(PageID: Integer): Boolean;
+begin
+  Result := False;
+
+  if (UpgradeModePage <> nil) and (PageID = UpgradeModePage.ID) then
+  begin
+    Result := not ExistingInstallFound;
+    exit;
+  end;
+
+  if PageID = wpSelectDir then
+  begin
+    Result := ExistingInstallFound and (SelectedUpgradeChoice() = UpgradeChoiceInPlace);
+  end;
+end;
+
+procedure RegisterExtraCloseApplicationsResources;
+var
+  ExistingExecutablePath: String;
+begin
+  if not ExistingInstallFound then
+  begin
+    exit;
+  end;
+
+  ExistingExecutablePath := GetExistingExecutablePath();
+  if (ExistingExecutablePath <> '') and FileExists(ExistingExecutablePath) then
+  begin
+    RegisterExtraCloseApplicationsResource(False, ExistingExecutablePath);
+  end;
+end;
+
+procedure CurStepChanged(CurStep: TSetupStep);
+begin
+  if CurStep = ssInstall then
+  begin
+    if not RemoveExistingInstallation() then
+    begin
+      Abort;
+    end;
+  end;
+end;

LanMountainDesktop/plugins/MainWindow.PluginMarketSettingsLocalization.cs

@@ -0,0 +1,9 @@
+namespace LanMountainDesktop.Views;
+
+public partial class MainWindow
+{
+    private void ApplyPluginMarketSettingsLocalization()
+    {
+        PluginMarketSettingsPanel.RefreshFromRuntime();
+    }
+}

LanMountainDesktop/plugins/MainWindow.PluginSettingsControls.cs

@@ -9,6 +9,7 @@ public partial class MainWindow
     internal TextBlock PluginSystemDescriptionTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginSystemDescriptionTextBlock")!;
     internal TextBlock PluginSystemStatusTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginSystemStatusTextBlock")!;
     internal FluentAvalonia.UI.Controls.SettingsExpander InstalledPluginsSettingsExpander => PluginSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("InstalledPluginsSettingsExpander")!;
+    internal FluentAvalonia.UI.Controls.SettingsExpander ImportPluginPackageSettingsExpander => PluginSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("ImportPluginPackageSettingsExpander")!;
     internal TextBlock PluginRestartHintTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginRestartHintTextBlock")!;
     internal TextBlock PluginCatalogEmptyTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginCatalogEmptyTextBlock")!;
 }

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);

LanMountainDesktop/plugins/MainWindow.PluginSettingsLocalization.cs

@@ -18,10 +18,14 @@ public partial class MainWindow
         InstalledPluginsSettingsExpander.Header = L("settings.plugins.installed_header", "Installed Plugins");
         InstalledPluginsSettingsExpander.Description = L(
             "settings.plugins.installed_desc",
-            "Enable or disable plugins here. Detailed plugin settings appear as separate settings pages.");
+            "Review installed plugins and remove them here.");
+        ImportPluginPackageSettingsExpander.Header = L("settings.plugins.import_header", "Install From Package");
+        ImportPluginPackageSettingsExpander.Description = L(
+            "settings.plugins.import_desc",
+            "Open a .laapp package and stage it into the local plugin directory.");
         PluginRestartHintTextBlock.Text = L(
             "settings.plugins.restart_hint",
-            "Plugin enable state changes take effect after restarting the app.");
+            "Plugin installation and deletion changes take effect after restarting the app.");
         PluginCatalogEmptyTextBlock.Text = L("settings.plugins.empty", "No plugins found.");
         PluginSettingsPanel.RefreshFromRuntime();
     }

LanMountainDesktop/plugins/PluginLoader.cs

@@ -10,6 +10,7 @@ using System.Text;
 using System.Threading;
 using System.Threading.Tasks;
 
+using LanMountainDesktop.Services;
 using LanMountainDesktop.PluginSdk;
 
 namespace LanMountainDesktop.Plugins;
@@ -346,6 +347,9 @@ public sealed class PluginLoader
     private string ExtractPackage(string packagePath, string pluginsRootDirectory)
     {
         var extractionDirectory = GetPackageExtractionDirectory(pluginsRootDirectory, packagePath);
+        AppLogger.Info(
+            "PluginLoader",
+            $"Extracting package '{packagePath}' to '{extractionDirectory}'.");
         RecreateDirectory(extractionDirectory);
         ZipFile.ExtractToDirectory(packagePath, extractionDirectory, overwriteFiles: true);
         return extractionDirectory;
@@ -381,7 +385,7 @@ public sealed class PluginLoader
     {
         if (Directory.Exists(directoryPath))
         {
-            Directory.Delete(directoryPath, recursive: true);
+            FileOperationRetryHelper.DeleteDirectoryWithRetry(directoryPath, recursive: true, "PluginLoader");
         }
 
         Directory.CreateDirectory(directoryPath);

LanMountainDesktop/plugins/PluginMarketIconService.cs

@@ -0,0 +1,47 @@
+using System;
+using System.IO;
+using System.Net.Http;
+using System.Threading;
+using System.Threading.Tasks;
+using Avalonia.Media.Imaging;
+
+namespace LanMountainDesktop.Views.SettingsPages;
+
+internal sealed class AirAppMarketIconService : IDisposable
+{
+    private readonly HttpClient _httpClient;
+
+    public AirAppMarketIconService()
+    {
+        _httpClient = new HttpClient
+        {
+            Timeout = TimeSpan.FromSeconds(20)
+        };
+        _httpClient.DefaultRequestHeaders.UserAgent.ParseAdd("LanMountainDesktop-PluginMarketplace/1.0");
+    }
+
+    public async Task<Bitmap> LoadAsync(
+        AirAppMarketPluginEntry plugin,
+        CancellationToken cancellationToken = default)
+    {
+        ArgumentNullException.ThrowIfNull(plugin);
+
+        if (AirAppMarketDefaults.TryResolveWorkspaceFile(plugin.IconUrl, out var localIconPath))
+        {
+            return new Bitmap(localIconPath);
+        }
+
+        using var response = await _httpClient.GetAsync(plugin.IconUrl, cancellationToken);
+        response.EnsureSuccessStatusCode();
+        await using var stream = await response.Content.ReadAsStreamAsync(cancellationToken);
+        using var memory = new MemoryStream();
+        await stream.CopyToAsync(memory, cancellationToken);
+        memory.Position = 0;
+        return new Bitmap(memory);
+    }
+
+    public void Dispose()
+    {
+        _httpClient.Dispose();
+    }
+}

LanMountainDesktop/plugins/PluginMarketInstallService.cs

@@ -14,6 +14,8 @@ 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;
 
     public AirAppMarketInstallService(PluginRuntimeService runtime, string dataDirectory)
@@ -25,6 +27,8 @@ 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);
     }
 
     public async Task<AirAppMarketInstallResult> InstallAsync(
@@ -40,23 +44,37 @@ internal sealed class AirAppMarketInstallService : IDisposable
 
         try
         {
-            if (AirAppMarketDefaults.TryResolveWorkspaceFile(plugin.DownloadUrl, out var localPackagePath))
+            AppLogger.Info(
+                "PluginMarket",
+                $"Starting install. PluginId='{plugin.Id}'; Version='{plugin.Version}'; DownloadPath='{downloadPath}'.");
+            var resolvedDownloadUrl = await _releaseResolverService.ResolveDownloadUrlAsync(plugin, cancellationToken);
+            AppLogger.Info(
+                "PluginMarket",
+                $"Resolved download url for '{plugin.Id}' to '{resolvedDownloadUrl}'.");
+
+            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(
-                    plugin.DownloadUrl,
-                    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);
+                var downloadResult = await _downloadService.DownloadAsync(
+                    resolvedDownloadUrl,
+                    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);
@@ -72,14 +90,24 @@ internal sealed class AirAppMarketInstallService : IDisposable
             }
 
             var manifest = _runtime.InstallPluginPackage(downloadPath);
+            AppLogger.Info(
+                "PluginMarket",
+                $"Install staged successfully. PluginId='{manifest.Id}'; InstalledName='{manifest.Name}'; PackagePath='{downloadPath}'.");
             return new AirAppMarketInstallResult(true, manifest, null);
         }
         catch (OperationCanceledException)
         {
+            AppLogger.Warn(
+                "PluginMarket",
+                $"Install canceled. PluginId='{plugin.Id}'; Version='{plugin.Version}'; DownloadPath='{downloadPath}'.");
             throw;
         }
         catch (Exception ex)
         {
+            AppLogger.Error(
+                "PluginMarket",
+                $"Install failed. PluginId='{plugin.Id}'; Version='{plugin.Version}'; DownloadPath='{downloadPath}'.",
+                ex);
             return new AirAppMarketInstallResult(false, null, ex.Message);
         }
     }

LanMountainDesktop/plugins/PluginMarketModels.cs

@@ -13,11 +13,25 @@ internal static class AirAppMarketDefaults
     public const string DefaultIndexUrl =
         "https://raw.githubusercontent.com/wwiinnddyy/LanAirApp/main/airappmarket/index.json";
 
-    private const string RawGitHubLanAirAppPathPrefix = "/wwiinnddyy/LanAirApp/main/";
+    public static string BuildGitHubReleaseDownloadUrl(
+        string owner,
+        string repositoryName,
+        string releaseTag,
+        string assetName)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(owner);
+        ArgumentException.ThrowIfNullOrWhiteSpace(repositoryName);
+        ArgumentException.ThrowIfNullOrWhiteSpace(releaseTag);
+        ArgumentException.ThrowIfNullOrWhiteSpace(assetName);
+
+        return string.Create(
+            CultureInfo.InvariantCulture,
+            $"https://github.com/{owner.Trim()}/{repositoryName.Trim()}/releases/download/{Uri.EscapeDataString(releaseTag.Trim())}/{Uri.EscapeDataString(assetName.Trim())}");
+    }
 
     public static string? TryGetWorkspaceIndexPath()
     {
-        var repositoryRoot = TryGetWorkspaceLanAirAppRepositoryRoot();
+        var repositoryRoot = TryGetWorkspaceRepositoryRoot("LanAirApp");
         if (repositoryRoot is null)
         {
             return null;
@@ -31,17 +45,24 @@ internal static class AirAppMarketDefaults
     {
         localPath = string.Empty;
 
-        var repositoryRoot = TryGetWorkspaceLanAirAppRepositoryRoot();
-        if (repositoryRoot is null ||
-            !Uri.TryCreate(url, UriKind.Absolute, out var uri) ||
-            !string.Equals(uri.Host, "raw.githubusercontent.com", StringComparison.OrdinalIgnoreCase) ||
-            !uri.AbsolutePath.StartsWith(RawGitHubLanAirAppPathPrefix, StringComparison.OrdinalIgnoreCase))
+        string repositoryName;
+        string relativePath;
+
+        if (TryParseGitHubReleaseDownloadUrl(url, out repositoryName, out var releaseAssetName))
+        {
+            relativePath = releaseAssetName;
+        }
+        else if (!TryParseRawGitHubUrl(url, out repositoryName, out relativePath))
+        {
+            return false;
+        }
+
+        var repositoryRoot = TryGetWorkspaceRepositoryRoot(repositoryName);
+        if (repositoryRoot is null)
         {
             return false;
         }
 
-        var relativePath = Uri.UnescapeDataString(uri.AbsolutePath[RawGitHubLanAirAppPathPrefix.Length..])
-            .Replace('/', Path.DirectorySeparatorChar);
         var candidatePath = Path.GetFullPath(Path.Combine(repositoryRoot, relativePath));
         if (!File.Exists(candidatePath))
         {
@@ -52,13 +73,39 @@ internal static class AirAppMarketDefaults
         return true;
     }
 
-    private static string? TryGetWorkspaceLanAirAppRepositoryRoot()
+    public static bool TryParseGitHubRepositoryUrl(
+        string? url,
+        out string owner,
+        out string repositoryName)
+    {
+        owner = string.Empty;
+        repositoryName = string.Empty;
+
+        if (!Uri.TryCreate(url, UriKind.Absolute, out var uri) ||
+            !string.Equals(uri.Host, "github.com", StringComparison.OrdinalIgnoreCase))
+        {
+            return false;
+        }
+
+        var segments = uri.AbsolutePath
+            .Split('/', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
+        if (segments.Length != 2)
+        {
+            return false;
+        }
+
+        owner = segments[0];
+        repositoryName = segments[1];
+        return !string.IsNullOrWhiteSpace(owner) && !string.IsNullOrWhiteSpace(repositoryName);
+    }
+
+    private static string? TryGetWorkspaceRepositoryRoot(string repositoryName)
     {
         var current = new DirectoryInfo(AppContext.BaseDirectory);
         while (current is not null)
         {
-            var candidate = Path.Combine(current.FullName, "LanAirApp");
-            if (File.Exists(Path.Combine(candidate, "airappmarket", "index.json")))
+            var candidate = Path.Combine(current.FullName, repositoryName);
+            if (Directory.Exists(candidate))
             {
                 return candidate;
             }
@@ -68,6 +115,60 @@ internal static class AirAppMarketDefaults
 
         return null;
     }
+
+    private static bool TryParseRawGitHubUrl(
+        string url,
+        out string repositoryName,
+        out string relativePath)
+    {
+        repositoryName = string.Empty;
+        relativePath = string.Empty;
+
+        if (!Uri.TryCreate(url, UriKind.Absolute, out var uri) ||
+            !string.Equals(uri.Host, "raw.githubusercontent.com", StringComparison.OrdinalIgnoreCase))
+        {
+            return false;
+        }
+
+        var segments = uri.AbsolutePath
+            .Split('/', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
+        if (segments.Length < 4)
+        {
+            return false;
+        }
+
+        repositoryName = segments[1];
+        relativePath = Path.Combine(segments[3..]).Replace(Path.AltDirectorySeparatorChar, Path.DirectorySeparatorChar);
+        return !string.IsNullOrWhiteSpace(repositoryName) && !string.IsNullOrWhiteSpace(relativePath);
+    }
+
+    private static bool TryParseGitHubReleaseDownloadUrl(
+        string url,
+        out string repositoryName,
+        out string assetName)
+    {
+        repositoryName = string.Empty;
+        assetName = string.Empty;
+
+        if (!Uri.TryCreate(url, UriKind.Absolute, out var uri) ||
+            !string.Equals(uri.Host, "github.com", StringComparison.OrdinalIgnoreCase))
+        {
+            return false;
+        }
+
+        var segments = uri.AbsolutePath
+            .Split('/', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
+        if (segments.Length != 6 ||
+            !string.Equals(segments[2], "releases", StringComparison.OrdinalIgnoreCase) ||
+            !string.Equals(segments[3], "download", StringComparison.OrdinalIgnoreCase))
+        {
+            return false;
+        }
+
+        repositoryName = segments[1];
+        assetName = Uri.UnescapeDataString(segments[5]);
+        return !string.IsNullOrWhiteSpace(repositoryName) && !string.IsNullOrWhiteSpace(assetName);
+    }
 }
 
 internal enum AirAppMarketLoadSource
@@ -193,6 +294,24 @@ internal sealed class AirAppMarketIndexDocument
         return normalized;
     }
 
+    internal static string NormalizeReleaseTag(string? value, string propertyName, string sourceName)
+    {
+        var normalized = RequireValue(value, propertyName, sourceName);
+        if (!normalized.StartsWith("v", StringComparison.OrdinalIgnoreCase))
+        {
+            throw new InvalidOperationException(
+                $"Market index '{sourceName}' declares invalid release tag '{normalized}' for '{propertyName}'. Expected format 'v1.2.3'.");
+        }
+
+        if (!TryParseVersion(normalized[1..], out _))
+        {
+            throw new InvalidOperationException(
+                $"Market index '{sourceName}' declares invalid release tag '{normalized}' for '{propertyName}'.");
+        }
+
+        return normalized;
+    }
+
     internal static void EnsureUrl(string url, string propertyName, string sourceName)
     {
         if (!Uri.TryCreate(url, UriKind.Absolute, out var uri) ||
@@ -203,6 +322,24 @@ internal sealed class AirAppMarketIndexDocument
         }
     }
 
+    internal static string NormalizeGitHubRepositoryUrl(
+        string url,
+        string propertyName,
+        string sourceName)
+    {
+        EnsureUrl(url, propertyName, sourceName);
+
+        if (!AirAppMarketDefaults.TryParseGitHubRepositoryUrl(url, out var owner, out var repositoryName))
+        {
+            throw new InvalidOperationException(
+                $"Market index '{sourceName}' declares invalid GitHub repository url '{url}' for '{propertyName}'.");
+        }
+
+        return string.Create(
+            CultureInfo.InvariantCulture,
+            $"https://github.com/{owner}/{repositoryName}");
+    }
+
     internal static bool TryParseVersion(string? value, out Version? version)
     {
         version = null;
@@ -260,6 +397,14 @@ internal sealed class AirAppMarketPluginEntry
 
     public string IconUrl { get; init; } = string.Empty;
 
+    public string ReleaseTag { get; init; } = string.Empty;
+
+    public string ReleaseAssetName { get; init; } = string.Empty;
+
+    public string ProjectUrl { get; init; } = string.Empty;
+
+    public string ReadmeUrl { get; init; } = string.Empty;
+
     public string HomepageUrl { get; init; } = string.Empty;
 
     public string RepositoryUrl { get; init; } = string.Empty;
@@ -272,6 +417,10 @@ internal sealed class AirAppMarketPluginEntry
 
     public string ReleaseNotes { get; init; } = string.Empty;
 
+    public bool HasReleaseDownloadMetadata =>
+        !string.IsNullOrWhiteSpace(ReleaseTag) &&
+        !string.IsNullOrWhiteSpace(ReleaseAssetName);
+
     public AirAppMarketPluginEntry ValidateAndNormalize(string sourceName)
     {
         var normalizedTags = (Tags ?? [])
@@ -298,6 +447,14 @@ internal sealed class AirAppMarketPluginEntry
         var normalizedIconUrl = AirAppMarketIndexDocument.NormalizeValue(IconUrl)
             ?? throw new InvalidOperationException(
                 $"Market index '{sourceName}' is missing required property '{nameof(IconUrl)}'.");
+        var normalizedReleaseTag = AirAppMarketIndexDocument.NormalizeValue(ReleaseTag);
+        var normalizedReleaseAssetName = AirAppMarketIndexDocument.NormalizeValue(ReleaseAssetName);
+        var normalizedProjectUrl = AirAppMarketIndexDocument.NormalizeValue(ProjectUrl)
+            ?? throw new InvalidOperationException(
+                $"Market index '{sourceName}' is missing required property '{nameof(ProjectUrl)}'.");
+        var normalizedReadmeUrl = AirAppMarketIndexDocument.NormalizeValue(ReadmeUrl)
+            ?? throw new InvalidOperationException(
+                $"Market index '{sourceName}' is missing required property '{nameof(ReadmeUrl)}'.");
         var normalizedHomepageUrl = AirAppMarketIndexDocument.NormalizeValue(HomepageUrl)
             ?? throw new InvalidOperationException(
                 $"Market index '{sourceName}' is missing required property '{nameof(HomepageUrl)}'.");
@@ -307,8 +464,30 @@ internal sealed class AirAppMarketPluginEntry
 
         AirAppMarketIndexDocument.EnsureUrl(normalizedDownloadUrl, nameof(DownloadUrl), sourceName);
         AirAppMarketIndexDocument.EnsureUrl(normalizedIconUrl, nameof(IconUrl), sourceName);
+        normalizedProjectUrl = AirAppMarketIndexDocument.NormalizeGitHubRepositoryUrl(
+            normalizedProjectUrl,
+            nameof(ProjectUrl),
+            sourceName);
+        normalizedRepositoryUrl = AirAppMarketIndexDocument.NormalizeGitHubRepositoryUrl(
+            normalizedRepositoryUrl,
+            nameof(RepositoryUrl),
+            sourceName);
+        AirAppMarketIndexDocument.EnsureUrl(normalizedReadmeUrl, nameof(ReadmeUrl), sourceName);
         AirAppMarketIndexDocument.EnsureUrl(normalizedHomepageUrl, nameof(HomepageUrl), sourceName);
-        AirAppMarketIndexDocument.EnsureUrl(normalizedRepositoryUrl, nameof(RepositoryUrl), sourceName);
+
+        if (string.IsNullOrWhiteSpace(normalizedReleaseTag) != string.IsNullOrWhiteSpace(normalizedReleaseAssetName))
+        {
+            throw new InvalidOperationException(
+                $"Market index '{sourceName}' must declare both '{nameof(ReleaseTag)}' and '{nameof(ReleaseAssetName)}' together for plugin '{Id}'.");
+        }
+
+        if (!string.IsNullOrWhiteSpace(normalizedReleaseTag))
+        {
+            normalizedReleaseTag = AirAppMarketIndexDocument.NormalizeReleaseTag(
+                normalizedReleaseTag,
+                nameof(ReleaseTag),
+                sourceName);
+        }
 
         if (PackageSizeBytes <= 0)
         {
@@ -339,6 +518,10 @@ internal sealed class AirAppMarketPluginEntry
             Sha256 = normalizedSha,
             PackageSizeBytes = PackageSizeBytes,
             IconUrl = normalizedIconUrl,
+            ReleaseTag = normalizedReleaseTag ?? string.Empty,
+            ReleaseAssetName = normalizedReleaseAssetName ?? string.Empty,
+            ProjectUrl = normalizedProjectUrl,
+            ReadmeUrl = normalizedReadmeUrl,
             HomepageUrl = normalizedHomepageUrl,
             RepositoryUrl = normalizedRepositoryUrl,
             Tags = normalizedTags,

LanMountainDesktop/plugins/PluginMarketReadmeService.cs

@@ -0,0 +1,42 @@
+using System;
+using System.IO;
+using System.Net.Http;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace LanMountainDesktop.Views.SettingsPages;
+
+internal sealed class AirAppMarketReadmeService : IDisposable
+{
+    private readonly HttpClient _httpClient;
+
+    public AirAppMarketReadmeService()
+    {
+        _httpClient = new HttpClient
+        {
+            Timeout = TimeSpan.FromSeconds(20)
+        };
+        _httpClient.DefaultRequestHeaders.UserAgent.ParseAdd("LanMountainDesktop-PluginMarketplace/1.0");
+    }
+
+    public async Task<string> LoadAsync(
+        AirAppMarketPluginEntry plugin,
+        CancellationToken cancellationToken = default)
+    {
+        ArgumentNullException.ThrowIfNull(plugin);
+
+        if (AirAppMarketDefaults.TryResolveWorkspaceFile(plugin.ReadmeUrl, out var localReadmePath))
+        {
+            return await File.ReadAllTextAsync(localReadmePath, cancellationToken);
+        }
+
+        using var response = await _httpClient.GetAsync(plugin.ReadmeUrl, cancellationToken);
+        response.EnsureSuccessStatusCode();
+        return await response.Content.ReadAsStringAsync(cancellationToken);
+    }
+
+    public void Dispose()
+    {
+        _httpClient.Dispose();
+    }
+}

LanMountainDesktop/plugins/PluginMarketReleaseResolverService.cs

@@ -0,0 +1,72 @@
+using System;
+using System.Linq;
+using System.Net.Http;
+using System.Threading;
+using System.Threading.Tasks;
+using LanMountainDesktop.Services;
+
+namespace LanMountainDesktop.Views.SettingsPages;
+
+internal sealed class AirAppMarketReleaseResolverService
+{
+    private readonly HttpClient _httpClient;
+
+    public AirAppMarketReleaseResolverService(HttpClient httpClient)
+    {
+        _httpClient = httpClient ?? throw new ArgumentNullException(nameof(httpClient));
+    }
+
+    public async Task<string> ResolveDownloadUrlAsync(
+        AirAppMarketPluginEntry plugin,
+        CancellationToken cancellationToken = default)
+    {
+        ArgumentNullException.ThrowIfNull(plugin);
+
+        if (!plugin.HasReleaseDownloadMetadata)
+        {
+            return plugin.DownloadUrl;
+        }
+
+        if (!TryGetRepositoryIdentity(plugin, out var owner, out var repositoryName))
+        {
+            return plugin.DownloadUrl;
+        }
+
+        var releaseDownloadUrl = AirAppMarketDefaults.BuildGitHubReleaseDownloadUrl(
+            owner,
+            repositoryName,
+            plugin.ReleaseTag,
+            plugin.ReleaseAssetName);
+
+        if (AirAppMarketDefaults.TryResolveWorkspaceFile(releaseDownloadUrl, out _))
+        {
+            return releaseDownloadUrl;
+        }
+
+        try
+        {
+            using var updateService = new GitHubReleaseUpdateService(owner, repositoryName, _httpClient);
+            var release = await updateService.GetReleaseByTagAsync(plugin.ReleaseTag, cancellationToken);
+            var asset = release?.Assets.FirstOrDefault(candidate =>
+                string.Equals(candidate.Name, plugin.ReleaseAssetName, StringComparison.OrdinalIgnoreCase));
+
+            return asset?.BrowserDownloadUrl ?? plugin.DownloadUrl;
+        }
+        catch
+        {
+            return plugin.DownloadUrl;
+        }
+    }
+
+    private static bool TryGetRepositoryIdentity(
+        AirAppMarketPluginEntry plugin,
+        out string owner,
+        out string repositoryName)
+    {
+        owner = string.Empty;
+        repositoryName = string.Empty;
+
+        return AirAppMarketDefaults.TryParseGitHubRepositoryUrl(plugin.RepositoryUrl, out owner, out repositoryName) ||
+               AirAppMarketDefaults.TryParseGitHubRepositoryUrl(plugin.ProjectUrl, out owner, out repositoryName);
+    }
+}

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>

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);
+    }
+}

LanMountainDesktop/plugins/PluginRuntimeService.cs

@@ -5,6 +5,7 @@ using System.IO;
 using System.IO.Compression;
 using System.Linq;
 using System.Reflection;
+using System.Text.Json;
 using Avalonia;
 using Avalonia.Controls;
 using Avalonia.Markup.Xaml;
@@ -16,6 +17,8 @@ namespace LanMountainDesktop.Services;
 
 public sealed class PluginRuntimeService : IDisposable
 {
+    private const string PendingDeletionFileName = ".pending-plugin-deletions.json";
+
     private readonly PluginLoader _loader;
     private readonly AppSettingsService _appSettingsService = new();
     private readonly IServiceProvider _hostServices;
@@ -25,6 +28,7 @@ public sealed class PluginRuntimeService : IDisposable
     private readonly List<PluginCatalogEntry> _catalog = [];
     private readonly List<PluginSettingsPageContribution> _settingsPages = [];
     private readonly List<PluginDesktopComponentContribution> _desktopComponents = [];
+    private readonly object _packageMutationGate = new();
 
     public PluginRuntimeService()
     {
@@ -49,6 +53,7 @@ public sealed class PluginRuntimeService : IDisposable
     public void LoadInstalledPlugins()
     {
         Directory.CreateDirectory(PluginsDirectory);
+        ApplyPendingPluginDeletions();
         UnloadInstalledPlugins();
 
         var disabledPluginIds = GetDisabledPluginIds();
@@ -170,6 +175,7 @@ public sealed class PluginRuntimeService : IDisposable
             .OrderBy(id => id, StringComparer.OrdinalIgnoreCase)
             .ToList();
         _appSettingsService.Save(snapshot);
+        PendingRestartStateService.SetPending(PendingRestartStateService.PluginCatalogReason, true);
 
         for (var i = 0; i < _catalog.Count; i++)
         {
@@ -184,7 +190,50 @@ public sealed class PluginRuntimeService : IDisposable
 
     public PluginManifest InstallPluginPackage(string packagePath)
     {
-        return InstallPluginPackageCore(packagePath).Manifest;
+        lock (_packageMutationGate)
+        {
+            return InstallPluginPackageCore(packagePath).Manifest;
+        }
+    }
+
+    public bool DeleteInstalledPlugin(string pluginId)
+    {
+        lock (_packageMutationGate)
+        {
+            return DeleteInstalledPluginCore(pluginId);
+        }
+    }
+
+    private bool DeleteInstalledPluginCore(string pluginId)
+    {
+        if (string.IsNullOrWhiteSpace(pluginId))
+        {
+            return false;
+        }
+
+        var entry = _catalog.FirstOrDefault(candidate =>
+            string.Equals(candidate.Manifest.Id, pluginId, StringComparison.OrdinalIgnoreCase));
+        if (entry is null)
+        {
+            return false;
+        }
+
+        var targetPath = ResolvePluginRemovalTargetPath(entry);
+        if (string.IsNullOrWhiteSpace(targetPath))
+        {
+            return false;
+        }
+
+        var fullTargetPath = Path.GetFullPath(targetPath);
+        if (!TryDeletePluginTarget(fullTargetPath))
+        {
+            RegisterPendingPluginDeletion(fullTargetPath);
+        }
+
+        RemovePluginFromSnapshot(pluginId);
+        RemovePluginFromCatalog(pluginId);
+        PendingRestartStateService.SetPending(PendingRestartStateService.PluginCatalogReason, true);
+        return true;
     }
 
     internal IReadOnlyList<InstalledPluginInfo> GetInstalledPluginsSnapshot()
@@ -219,16 +268,22 @@ public sealed class PluginRuntimeService : IDisposable
         Directory.CreateDirectory(PluginsDirectory);
 
         var manifest = ReadManifestFromPackage(fullPackagePath);
+        AppLogger.Info(
+            "PluginRuntime",
+            $"Installing package. PluginId='{manifest.Id}'; Source='{fullPackagePath}'; PluginsDirectory='{PluginsDirectory}'.");
         var replacedExisting = RemoveExistingPluginPackages(manifest.Id, fullPackagePath);
 
         var destinationPath = Path.Combine(PluginsDirectory, BuildInstalledPackageFileName(manifest.Id));
         if (!string.Equals(fullPackagePath, Path.GetFullPath(destinationPath), StringComparison.OrdinalIgnoreCase))
         {
-            File.Copy(fullPackagePath, destinationPath, overwrite: true);
+            FileOperationRetryHelper.CopyWithRetry(fullPackagePath, destinationPath, overwrite: true, "PluginRuntime");
         }
 
         UpdateCatalogAfterPackageInstall(manifest, destinationPath);
         PendingRestartStateService.SetPending(PendingRestartStateService.PluginCatalogReason, true);
+        AppLogger.Info(
+            "PluginRuntime",
+            $"Package staged. PluginId='{manifest.Id}'; Destination='{destinationPath}'; ReplacedExisting={replacedExisting}.");
 
         return new PluginPackageInstallResult(manifest, replacedExisting, RestartRequired: true);
     }
@@ -349,7 +404,7 @@ public sealed class PluginRuntimeService : IDisposable
                     continue;
                 }
 
-                File.Delete(existingPackagePath);
+                FileOperationRetryHelper.DeleteFileWithRetry(existingPackagePath, "PluginRuntime");
                 replacedExisting = true;
             }
             catch
@@ -445,6 +500,150 @@ public sealed class PluginRuntimeService : IDisposable
         }
     }
 
+    private void ApplyPendingPluginDeletions()
+    {
+        var pendingPaths = ReadPendingPluginDeletions();
+        if (pendingPaths.Count == 0)
+        {
+            return;
+        }
+
+        var remainingPaths = new List<string>();
+        foreach (var path in pendingPaths)
+        {
+            if (!TryDeletePluginTarget(path))
+            {
+                remainingPaths.Add(path);
+            }
+        }
+
+        SavePendingPluginDeletions(remainingPaths);
+    }
+
+    private string ResolvePluginRemovalTargetPath(PluginCatalogEntry entry)
+    {
+        if (entry.IsPackage)
+        {
+            return entry.SourcePath;
+        }
+
+        var fullSourcePath = Path.GetFullPath(entry.SourcePath);
+        if (File.Exists(fullSourcePath) &&
+            string.Equals(Path.GetFileName(fullSourcePath), "plugin.json", StringComparison.OrdinalIgnoreCase))
+        {
+            return Path.GetDirectoryName(fullSourcePath) ?? fullSourcePath;
+        }
+
+        return fullSourcePath;
+    }
+
+    private static bool TryDeletePluginTarget(string targetPath)
+    {
+        try
+        {
+            if (File.Exists(targetPath))
+            {
+                File.Delete(targetPath);
+            }
+            else if (Directory.Exists(targetPath))
+            {
+                Directory.Delete(targetPath, recursive: true);
+            }
+
+            return !File.Exists(targetPath) && !Directory.Exists(targetPath);
+        }
+        catch
+        {
+            return false;
+        }
+    }
+
+    private void RegisterPendingPluginDeletion(string targetPath)
+    {
+        var pendingPaths = ReadPendingPluginDeletions();
+        if (pendingPaths.Contains(targetPath, StringComparer.OrdinalIgnoreCase))
+        {
+            return;
+        }
+
+        pendingPaths.Add(targetPath);
+        SavePendingPluginDeletions(pendingPaths);
+    }
+
+    private List<string> ReadPendingPluginDeletions()
+    {
+        var pendingDeletionFilePath = GetPendingDeletionFilePath();
+        if (!File.Exists(pendingDeletionFilePath))
+        {
+            return [];
+        }
+
+        try
+        {
+            var json = File.ReadAllText(pendingDeletionFilePath);
+            var paths = JsonSerializer.Deserialize<List<string>>(json);
+            return paths?
+                .Where(path => !string.IsNullOrWhiteSpace(path))
+                .Select(Path.GetFullPath)
+                .Distinct(StringComparer.OrdinalIgnoreCase)
+                .ToList() ?? [];
+        }
+        catch
+        {
+            return [];
+        }
+    }
+
+    private void SavePendingPluginDeletions(IEnumerable<string> pendingPaths)
+    {
+        var pendingDeletionFilePath = GetPendingDeletionFilePath();
+        var normalizedPaths = pendingPaths
+            .Where(path => !string.IsNullOrWhiteSpace(path))
+            .Select(Path.GetFullPath)
+            .Distinct(StringComparer.OrdinalIgnoreCase)
+            .OrderBy(path => path, StringComparer.OrdinalIgnoreCase)
+            .ToArray();
+
+        if (normalizedPaths.Length == 0)
+        {
+            if (File.Exists(pendingDeletionFilePath))
+            {
+                File.Delete(pendingDeletionFilePath);
+            }
+
+            return;
+        }
+
+        Directory.CreateDirectory(PluginsDirectory);
+        var json = JsonSerializer.Serialize(normalizedPaths, new JsonSerializerOptions
+        {
+            WriteIndented = true
+        });
+        File.WriteAllText(pendingDeletionFilePath, json);
+    }
+
+    private string GetPendingDeletionFilePath()
+    {
+        return Path.Combine(PluginsDirectory, PendingDeletionFileName);
+    }
+
+    private void RemovePluginFromSnapshot(string pluginId)
+    {
+        var snapshot = _appSettingsService.Load();
+        if (snapshot.DisabledPluginIds.RemoveAll(id => string.Equals(id, pluginId, StringComparison.OrdinalIgnoreCase)) > 0)
+        {
+            _appSettingsService.Save(snapshot);
+        }
+    }
+
+    private void RemovePluginFromCatalog(string pluginId)
+    {
+        _catalog.RemoveAll(entry => string.Equals(entry.Manifest.Id, pluginId, StringComparison.OrdinalIgnoreCase));
+        _settingsPages.RemoveAll(entry => string.Equals(entry.Plugin.Manifest.Id, pluginId, StringComparison.OrdinalIgnoreCase));
+        _desktopComponents.RemoveAll(entry => string.Equals(entry.Plugin.Manifest.Id, pluginId, StringComparison.OrdinalIgnoreCase));
+        _loadResults.RemoveAll(entry => string.Equals(entry.Manifest?.Id, pluginId, StringComparison.OrdinalIgnoreCase));
+    }
+
     private sealed record PluginCandidate(
         string SourcePath,
         PluginManifest Manifest,

LanMountainDesktop/plugins/PluginSettingsPage.Host.cs

@@ -8,6 +8,8 @@ using Avalonia.Controls;
 using Avalonia.Layout;
 using Avalonia.Media;
 using Avalonia.Platform.Storage;
+using FluentIcons.Avalonia.Fluent;
+using FluentIcons.Common;
 using FluentAvalonia.UI.Controls;
 using LanMountainDesktop.PluginSdk;
 using LanMountainDesktop.Services;
@@ -18,10 +20,10 @@ public partial class PluginSettingsPage : UserControl
 {
     private static readonly IBrush SuccessBrush = new SolidColorBrush(Color.Parse("#FF0F766E"));
     private static readonly IBrush ErrorBrush = new SolidColorBrush(Color.Parse("#FFC42B1C"));
+    private static readonly IBrush DestructiveBrush = new SolidColorBrush(Color.Parse("#FFF87171"));
 
     private readonly AppSettingsService _appSettingsService = new();
     private readonly LocalizationService _localizationService = new();
-    private PluginMarketEmbeddedView? _pluginMarketView;
     private string? _packageImportStatusMessage;
     private bool _packageImportStatusIsError;
 
@@ -34,47 +36,21 @@ 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)
         {
             PluginSystemStatusTextBlock.Text = L("settings.plugins.runtime_unavailable", "Plugin runtime is not available.");
             PluginRuntimeSummaryPanel.Children.Clear();
-            PluginCatalogItemsHost.Children.Clear();
+            InstalledPluginsSettingsExpander.Items.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."));
+            PluginCatalogEmptyTextBlock.IsVisible = false;
             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");
@@ -102,7 +78,7 @@ public partial class PluginSettingsPage : UserControl
             "Detected {0} plugin(s); enabled {1}; loaded {2}; settings pages {3}; widgets {4}; failures {5}.",
             runtime.Catalog.Count,
             enabledCount,
-            runtime.LoadedPlugins.Count,
+            runtime.Catalog.Count(entry => entry.IsLoaded),
             runtime.SettingsPages.Count,
             runtime.DesktopComponents.Count,
             failures.Length);
@@ -127,7 +103,7 @@ public partial class PluginSettingsPage : UserControl
 
     private void BuildPluginCatalog(PluginRuntimeService runtime)
     {
-        PluginCatalogItemsHost.Children.Clear();
+        InstalledPluginsSettingsExpander.Items.Clear();
 
         var plugins = runtime.Catalog
             .OrderBy(entry => entry.Manifest.Name, StringComparer.OrdinalIgnoreCase)
@@ -138,86 +114,20 @@ public partial class PluginSettingsPage : UserControl
 
         foreach (var plugin in plugins)
         {
-            PluginCatalogItemsHost.Children.Add(CreatePluginCatalogItem(runtime, plugin));
+            InstalledPluginsSettingsExpander.Items.Add(CreatePluginCatalogItem(runtime, plugin));
         }
     }
 
-    private Control CreatePluginCatalogItem(PluginRuntimeService runtime, PluginCatalogEntry entry)
+    private SettingsExpanderItem CreatePluginCatalogItem(PluginRuntimeService runtime, PluginCatalogEntry entry)
     {
-        var title = new TextBlock
+        return new SettingsExpanderItem
         {
-            Text = entry.Manifest.Name,
-            FontSize = 16,
-            FontWeight = FontWeight.SemiBold,
-            TextWrapping = TextWrapping.Wrap
+            Content = entry.Manifest.Name,
+            Description = BuildPluginSubtitle(entry),
+            IconSource = CreatePluginCatalogIconSource(),
+            IsClickEnabled = false,
+            Footer = CreatePluginCatalogActions(runtime, entry)
         };
-
-        var subtitle = new TextBlock
-        {
-            Text = BuildPluginSubtitle(entry),
-            Foreground = PluginSystemDescriptionTextBlock.Foreground,
-            TextWrapping = TextWrapping.Wrap
-        };
-
-        var enabledToggle = new ToggleSwitch
-        {
-            IsChecked = entry.IsEnabled,
-            OnContent = L("settings.plugins.toggle_on", "Enabled"),
-            OffContent = L("settings.plugins.toggle_off", "Disabled"),
-            HorizontalAlignment = HorizontalAlignment.Right,
-            VerticalAlignment = VerticalAlignment.Center
-        };
-
-        enabledToggle.IsCheckedChanged += (_, _) => OnPluginEnableChanged(runtime, entry, enabledToggle.IsChecked == true);
-
-        var header = new Grid
-        {
-            ColumnDefinitions = new ColumnDefinitions("*,Auto"),
-            ColumnSpacing = 12,
-            Children =
-            {
-                new StackPanel
-                {
-                    Spacing = 4,
-                    Children = { title, subtitle }
-                },
-                enabledToggle
-            }
-        };
-        Grid.SetColumn(enabledToggle, 1);
-
-        var details = new TextBlock
-        {
-            Text = BuildPluginDetails(entry),
-            Foreground = PluginSystemDescriptionTextBlock.Foreground,
-            TextWrapping = TextWrapping.Wrap
-        };
-
-        return new Border
-        {
-            Background = new SolidColorBrush(Color.Parse("#14000000")),
-            CornerRadius = new CornerRadius(16),
-            Padding = new Thickness(14),
-            Child = new StackPanel
-            {
-                Spacing = 10,
-                Children = { header, details }
-            }
-        };
-    }
-
-    private void OnPluginEnableChanged(PluginRuntimeService runtime, PluginCatalogEntry entry, bool isEnabled)
-    {
-        runtime.SetPluginEnabled(entry.Manifest.Id, isEnabled);
-        BuildRuntimeSummary(runtime);
-        BuildPluginCatalog(runtime);
-        PluginSystemStatusTextBlock.Text = F(
-            "settings.plugins.toggle_result_format",
-            "Plugin '{0}' was {1} for the next launch. Restart the app to apply page and widget changes.",
-            entry.Manifest.Name,
-            isEnabled
-                ? L("settings.plugins.toggle_state_enabled", "enabled")
-                : L("settings.plugins.toggle_state_disabled", "disabled"));
     }
 
     private async void OnInstallPluginPackageClick(object? sender, Avalonia.Interactivity.RoutedEventArgs e)
@@ -275,6 +185,7 @@ public partial class PluginSettingsPage : UserControl
 
             var manifest = runtime.InstallPluginPackage(temporaryPackagePath);
             RefreshFromRuntime();
+            RefreshPluginNavigation(TopLevel.GetTopLevel(this));
             SetPackageImportStatus(
                 F(
                     "settings.plugins.install_success_format",
@@ -307,6 +218,79 @@ public partial class PluginSettingsPage : UserControl
         }
     }
 
+    private void OnDeletePluginClick(PluginRuntimeService runtime, PluginCatalogEntry entry)
+    {
+        try
+        {
+            if (!runtime.DeleteInstalledPlugin(entry.Manifest.Id))
+            {
+                SetPackageImportStatus(
+                    F(
+                        "settings.plugins.delete_failed_format",
+                        "Failed to delete plugin: {0}",
+                        entry.Manifest.Name),
+                    isError: true);
+                return;
+            }
+
+            RefreshFromRuntime();
+            RefreshPluginNavigation(TopLevel.GetTopLevel(this));
+            PluginSystemStatusTextBlock.Text = F(
+                "settings.plugins.delete_success_format",
+                "Plugin '{0}' was staged for deletion. Restart the app to finish removing it.",
+                entry.Manifest.Name);
+            SetPackageImportStatus(
+                F(
+                    "settings.plugins.delete_success_format",
+                    "Plugin '{0}' was staged for deletion. Restart the app to finish removing it.",
+                    entry.Manifest.Name),
+                isError: false);
+        }
+        catch (Exception ex)
+        {
+            SetPackageImportStatus(
+                F(
+                    "settings.plugins.delete_failed_detail_format",
+                    "Failed to delete plugin '{0}': {1}",
+                    entry.Manifest.Name,
+                    ex.Message),
+                isError: true);
+        }
+    }
+
+    private void OnPluginEnabledChanged(PluginRuntimeService runtime, PluginCatalogEntry entry, bool isEnabled)
+    {
+        try
+        {
+            if (!runtime.SetPluginEnabled(entry.Manifest.Id, isEnabled))
+            {
+                return;
+            }
+
+            RefreshFromRuntime();
+            var toggleState = isEnabled
+                ? L("settings.plugins.toggle_state_enabled", "enabled")
+                : L("settings.plugins.toggle_state_disabled", "disabled");
+            SetPackageImportStatus(
+                F(
+                    "settings.plugins.toggle_result_format",
+                    "Plugin '{0}' was {1} for the next launch. Restart the app to apply page and widget changes.",
+                    entry.Manifest.Name,
+                    toggleState),
+                isError: false);
+        }
+        catch (Exception ex)
+        {
+            SetPackageImportStatus(
+                F(
+                    "settings.plugins.toggle_failed_detail_format",
+                    "Failed to update plugin '{0}': {1}",
+                    entry.Manifest.Name,
+                    ex.Message),
+                isError: true);
+        }
+    }
+
     private void RefreshPluginNavigation(TopLevel? topLevel)
     {
         switch (topLevel)
@@ -329,32 +313,13 @@ public partial class PluginSettingsPage : UserControl
 
     private string BuildPluginSubtitle(PluginCatalogEntry entry)
     {
-        var source = entry.IsPackage
-            ? L("settings.plugins.source_package", ".laapp package")
-            : L("settings.plugins.source_manifest", "Loose manifest");
-        var state = entry.IsEnabled
-            ? entry.IsLoaded
-                ? L("settings.plugins.state.loaded", "Loaded")
-                : L("settings.plugins.state.load_failed", "Load failed")
-            : L("settings.plugins.state.disabled", "Disabled");
+        var publisher = string.IsNullOrWhiteSpace(entry.Manifest.Author)
+            ? L("settings.plugins.publisher_unknown", "Unknown publisher")
+            : entry.Manifest.Author;
         return F(
-            "settings.plugins.subtitle_format",
-            "{0} | {1} | {2}",
-            state,
-            source,
-            entry.Manifest.Id);
-    }
-
-    private string BuildPluginDetails(PluginCatalogEntry entry)
-    {
-        var detail = F(
-            "settings.plugins.detail_format",
-            "Settings pages: {0} | Widgets: {1}",
-            entry.SettingsPageCount,
-            entry.WidgetCount);
-        return string.IsNullOrWhiteSpace(entry.ErrorMessage)
-            ? detail
-            : detail + Environment.NewLine + entry.ErrorMessage;
+            "settings.plugins.publisher_format",
+            "Publisher: {0}",
+            publisher);
     }
 
     private TextBlock CreateSummaryLine(string text)
@@ -378,6 +343,75 @@ public partial class PluginSettingsPage : UserControl
         return string.Format(CultureInfo.CurrentCulture, L(key, fallback), args);
     }
 
+    private FluentIcons.Avalonia.Fluent.SymbolIconSource CreatePluginCatalogIconSource()
+    {
+        return new FluentIcons.Avalonia.Fluent.SymbolIconSource
+        {
+            Symbol = FluentIcons.Common.Symbol.PuzzlePiece,
+            IconVariant = FluentIcons.Common.IconVariant.Regular
+        };
+    }
+
+    private Control CreatePluginCatalogActions(PluginRuntimeService runtime, PluginCatalogEntry entry)
+    {
+        return new StackPanel
+        {
+            Orientation = Orientation.Horizontal,
+            Spacing = 10,
+            HorizontalAlignment = HorizontalAlignment.Right,
+            VerticalAlignment = VerticalAlignment.Center,
+            Children =
+            {
+                CreateEnablePluginToggle(runtime, entry),
+                CreateDeletePluginButton(runtime, entry)
+            }
+        };
+    }
+
+    private ToggleSwitch CreateEnablePluginToggle(PluginRuntimeService runtime, PluginCatalogEntry entry)
+    {
+        var toggle = new ToggleSwitch
+        {
+            IsChecked = entry.IsEnabled,
+            VerticalAlignment = VerticalAlignment.Center
+        };
+
+        ToolTip.SetTip(
+            toggle,
+            entry.IsEnabled
+                ? L("settings.plugins.toggle_off", "Disable")
+                : L("settings.plugins.toggle_on", "Enable"));
+        toggle.IsCheckedChanged += (_, _) => OnPluginEnabledChanged(runtime, entry, toggle.IsChecked == true);
+        return toggle;
+    }
+
+    private Button CreateDeletePluginButton(PluginRuntimeService runtime, PluginCatalogEntry entry)
+    {
+        var button = new Button
+        {
+            Width = 36,
+            Height = 36,
+            Padding = new Thickness(0),
+            Background = Brushes.Transparent,
+            BorderThickness = new Thickness(0),
+            HorizontalAlignment = HorizontalAlignment.Right,
+            VerticalAlignment = VerticalAlignment.Center,
+            Content = new FluentIcons.Avalonia.Fluent.SymbolIcon
+            {
+                Symbol = FluentIcons.Common.Symbol.Delete,
+                IconVariant = FluentIcons.Common.IconVariant.Regular,
+                FontSize = 18,
+                Foreground = DestructiveBrush,
+                HorizontalAlignment = HorizontalAlignment.Center,
+                VerticalAlignment = VerticalAlignment.Center
+            }
+        };
+
+        ToolTip.SetTip(button, L("settings.plugins.delete_button", "Delete plugin"));
+        button.Click += (_, _) => OnDeletePluginClick(runtime, entry);
+        return button;
+    }
+
     private static async Task<string?> CopyPackageToTemporaryFileAsync(IStorageFile file)
     {
         try

LanMountainDesktop/plugins/PluginSettingsPage.axaml

@@ -44,31 +44,13 @@
         <Border Classes="settings-expander-shell">
             <ui:SettingsExpander x:Name="InstalledPluginsSettingsExpander"
                                  Header="Installed Plugins"
-                                 Description="Enable plugins here. Detailed settings appear as separate settings pages."
+                                 Description="Manage installed plugins here."
                                  IsExpanded="True">
                 <ui:SettingsExpander.IconSource>
                     <ui:FontIconSource Glyph="&#xe8fd;" FontFamily="{StaticResource SymbolThemeFontFamily}" />
                 </ui:SettingsExpander.IconSource>
                 <ui:SettingsExpander.Footer>
                     <StackPanel Spacing="10">
-                        <Border Background="{DynamicResource AdaptiveSurfaceRaisedBrush}"
-                                CornerRadius="{DynamicResource DesignCornerRadiusSm}"
-                                Padding="14">
-                            <StackPanel Spacing="10">
-                                <Button x:Name="InstallPluginPackageButton"
-                                        HorizontalAlignment="Left"
-                                        Click="OnInstallPluginPackageClick"
-                                        Content="Open .laapp package" />
-                                <TextBlock x:Name="PluginPackageImportHintTextBlock"
-                                           Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
-                                           TextWrapping="Wrap"
-                                           Text="Open a .laapp package to install it into the local plugin directory." />
-                                <TextBlock x:Name="PluginPackageImportStatusTextBlock"
-                                           Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
-                                           TextWrapping="Wrap"
-                                           IsVisible="False" />
-                            </StackPanel>
-                        </Border>
                         <TextBlock x:Name="PluginRestartHintTextBlock"
                                    Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
                                    TextWrapping="Wrap"
@@ -77,30 +59,37 @@
                                    Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
                                    Text="No plugins found."
                                    IsVisible="False" />
-                        <StackPanel x:Name="PluginCatalogItemsHost" Spacing="12" />
                     </StackPanel>
                 </ui:SettingsExpander.Footer>
             </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 x:Name="ImportPluginPackageSettingsExpander"
+                                 Header="Install From Package"
+                                 Description="Open a .laapp package and stage it into the local plugin directory."
+                                 IsExpanded="False">
                 <ui:SettingsExpander.IconSource>
-                    <ui:FontIconSource Glyph="&#xe719;" FontFamily="{StaticResource SymbolThemeFontFamily}" />
+                    <ui:FontIconSource Glyph="&#xe8b7;" FontFamily="{StaticResource SymbolThemeFontFamily}" />
                 </ui:SettingsExpander.IconSource>
                 <ui:SettingsExpander.Footer>
                     <StackPanel Spacing="10">
-                        <TextBlock x:Name="PluginMarketDescriptionTextBlock"
+                        <Button x:Name="InstallPluginPackageButton"
+                                HorizontalAlignment="Left"
+                                Click="OnInstallPluginPackageClick"
+                                Content="Open .laapp package" />
+                        <TextBlock x:Name="PluginPackageImportHintTextBlock"
                                    Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
                                    TextWrapping="Wrap"
-                                   Text="Use the official market source hosted in LanAirApp to discover and stage plugin installs." />
-                        <ContentControl x:Name="PluginMarketContentHost" />
+                                   Text="Open a .laapp package to install it into the local plugin directory." />
+                        <TextBlock x:Name="PluginPackageImportStatusTextBlock"
+                                   Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
+                                   TextWrapping="Wrap"
+                                   IsVisible="False" />
                     </StackPanel>
                 </ui:SettingsExpander.Footer>
             </ui:SettingsExpander>
         </Border>
+
     </StackPanel>
 </UserControl>

LanMountainDesktop/plugins/README.md

@@ -1,33 +1,57 @@
 # 宿主侧插件运行时
 
-这个目录用于归档阑山桌面宿主侧的插件相关实现。
+## 中文
 
-职责范围：
-- 已安装插件的发现
-- `.laapp` 安装包安装与替换
-- 插件运行时加载
-- 插件贡献的设置页与桌面组件接入
-- 宿主侧插件设置页的安装、显示与刷新
+本目录保存阑山桌面宿主程序中的插件运行时实现。
+
+### 主要职责
+
+- 发现已安装插件
+- 安装和替换 `.laapp` 插件包
+- 加载插件程序集
+- 接入插件贡献的设置页和桌面组件
+- 在宿主设置界面中展示插件与市场信息
+
+### 市场安装优先级
+
+1. 宿主先连接 `LanAirApp/airappmarket/index.json`。
+2. 当条目同时提供 `releaseTag` 和 `releaseAssetName` 时，宿主优先按精确标签读取插件仓库的 GitHub Release 资产。
+3. 如果 Release 不存在、资产缺失、GitHub API 失败，或当前是本地工作区测试但找不到远程资产，宿主会退回 `downloadUrl` 指向的仓库根目录 `.laapp`。
+4. 插件介绍始终读取仓库根目录 `README.md`。
+5. 安装完成后只做暂存，重启后生效，不在运行时热重载市场安装插件。
+
+### 核心文件
 
-当前宿主侧核心文件：
 - `PluginLoader.cs`
 - `PluginLoadContext.cs`
-- `PluginLoaderOptions.cs`
-- `PluginLoadResult.cs`
-- `LoadedPlugin.cs`
 - `PluginRuntimeService.cs`
-- `PluginContributions.cs`
 - `PluginCatalogEntry.cs`
 - `PluginSettingsPage.axaml`
 - `PluginSettingsPage.Host.cs`
-- `MainWindow.PluginSettingsHost.cs`
-- `SettingsWindow.PluginSettingsHost.cs`
-- `MainWindow.PluginSettingsLocalization.cs`
-- `SettingsWindow.PluginSettingsLocalization.cs`
-- `MainWindow.PluginSettingsControls.cs`
-- `SettingsWindow.PluginSettingsControls.cs`
+- `PluginMarketIndexService.cs`
+- `PluginMarketInstallService.cs`
 
-说明：
-- 插件开发标准、插件打包工具、示例插件与开发文档统一放在仓库根目录下的 `LanAirApp/`
-- 宿主本体的插件加载、解析、安装与插件设置页接入逻辑统一放在 `LanMountainDesktop/plugins/`
-- `LanMountainDesktop.PluginSdk` 只保留插件作者需要引用的契约、清单模型和扩展注册接口
+### 与 `LanAirApp` 的分工
+
+- `LanAirApp` 负责插件开发文档、示例、市场索引和校验工具。
+- 宿主目录负责运行时发现、安装、加载和界面接入。
+
+## English
+
+This directory contains the host-side plugin runtime for LanMountainDesktop.
+
+### Responsibilities
+
+- discover installed plugins
+- install and replace `.laapp` packages
+- load plugin assemblies
+- integrate plugin settings pages and desktop components
+- expose market and plugin management in the host UI
+
+### Market install order
+
+1. The host reads `LanAirApp/airappmarket/index.json`.
+2. If an entry declares both `releaseTag` and `releaseAssetName`, the host first resolves the exact GitHub Release asset.
+3. If Release resolution fails, the host falls back to the repository root `.laapp` from `downloadUrl`.
+4. Plugin details always come from the repository root `README.md`.
+5. Market installs are staged and take effect after restart.

LanMountainDesktop/plugins/SettingsWindow.PluginMarketSettingsLocalization.cs

@@ -0,0 +1,9 @@
+namespace LanMountainDesktop.Views;
+
+public partial class SettingsWindow
+{
+    private void ApplyPluginMarketSettingsLocalization()
+    {
+        PluginMarketSettingsPanel.RefreshFromRuntime();
+    }
+}

LanMountainDesktop/plugins/SettingsWindow.PluginSettingsControls.cs

@@ -9,6 +9,7 @@ public partial class SettingsWindow
     internal TextBlock PluginSystemDescriptionTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginSystemDescriptionTextBlock")!;
     internal TextBlock PluginSystemStatusTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginSystemStatusTextBlock")!;
     internal FluentAvalonia.UI.Controls.SettingsExpander InstalledPluginsSettingsExpander => PluginSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("InstalledPluginsSettingsExpander")!;
+    internal FluentAvalonia.UI.Controls.SettingsExpander ImportPluginPackageSettingsExpander => PluginSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("ImportPluginPackageSettingsExpander")!;
     internal TextBlock PluginRestartHintTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginRestartHintTextBlock")!;
     internal TextBlock PluginCatalogEmptyTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginCatalogEmptyTextBlock")!;
 }

LanMountainDesktop/plugins/SettingsWindow.PluginSettingsLocalization.cs

@@ -10,8 +10,10 @@ public partial class SettingsWindow
         PluginSystemDescriptionTextBlock.Text = L("settings.plugins.runtime_hint", "This page shows discovery status, load results, and runtime diagnostics for installed plugins.");
         PluginSystemStatusTextBlock.Text = L("settings.plugins.runtime_status", "Plugin runtime status will appear here after plugin discovery completes.");
         InstalledPluginsSettingsExpander.Header = L("settings.plugins.installed_header", "Installed Plugins");
-        InstalledPluginsSettingsExpander.Description = L("settings.plugins.installed_desc", "Enable or disable plugins here. Detailed plugin settings appear as separate settings pages.");
-        PluginRestartHintTextBlock.Text = L("settings.plugins.restart_hint", "Plugin enable state changes take effect after restarting the app.");
+        InstalledPluginsSettingsExpander.Description = L("settings.plugins.installed_desc", "Review installed plugins and remove them here.");
+        ImportPluginPackageSettingsExpander.Header = L("settings.plugins.import_header", "Install From Package");
+        ImportPluginPackageSettingsExpander.Description = L("settings.plugins.import_desc", "Open a .laapp package and stage it into the local plugin directory.");
+        PluginRestartHintTextBlock.Text = L("settings.plugins.restart_hint", "Plugin installation and deletion changes take effect after restarting the app.");
         PluginCatalogEmptyTextBlock.Text = L("settings.plugins.empty", "No plugins found.");
         PluginSettingsPanel.RefreshFromRuntime();
     }

LanMountainDesktop/scripts/package.ps1

@@ -141,6 +141,37 @@ function Create-PackageArchive {
     return $archivePath
 }
 
+function Clear-DirectoryContents {
+    param([Parameter(Mandatory = $true)][string]$TargetDirectory)
+
+    [System.IO.Directory]::CreateDirectory($TargetDirectory) | Out-Null
+    Get-ChildItem -LiteralPath $TargetDirectory -Force -ErrorAction SilentlyContinue | ForEach-Object {
+        Remove-Item -LiteralPath $_.FullName -Recurse -Force -ErrorAction Stop
+    }
+}
+
+function Remove-LegacyOutputArtifacts {
+    param([Parameter(Mandatory = $true)][string]$TargetDirectory)
+
+    $legacyArtifacts = @(
+        "LanMontainDesktop.exe",
+        "LanMontainDesktop.dll",
+        "LanMontainDesktop.deps.json",
+        "LanMontainDesktop.runtimeconfig.json",
+        "LanMontainDesktop.pdb"
+    )
+
+    foreach ($artifactName in $legacyArtifacts) {
+        $artifactPath = Join-Path $TargetDirectory $artifactName
+        if (-not (Test-Path -LiteralPath $artifactPath)) {
+            continue
+        }
+
+        Remove-Item -LiteralPath $artifactPath -Force -ErrorAction Stop
+        Write-Host "Removed legacy artifact: $artifactPath"
+    }
+}
+
 function Add-LinuxDesktopAssets {
     param(
         [Parameter(Mandatory = $true)][string]$PublishedDirectory,
@@ -187,7 +218,7 @@ if (-not $PublishDir) {
 if (-not [System.IO.Path]::IsPathRooted($PublishDir)) {
     $PublishDir = Join-Path $repoRoot $PublishDir
 }
-[System.IO.Directory]::CreateDirectory($PublishDir) | Out-Null
+Clear-DirectoryContents -TargetDirectory $PublishDir
 
 Write-Host "Publishing project..."
 $publishArgs = @(
@@ -210,6 +241,7 @@ if ($LASTEXITCODE -ne 0) {
 }
 
 Remove-LibVlcForOtherArch -PublishedDirectory $PublishDir -Rid $RuntimeIdentifier
+Remove-LegacyOutputArtifacts -TargetDirectory $PublishDir
 
 if ($RuntimeIdentifier -like "linux-*") {
     Add-LinuxDesktopAssets -PublishedDirectory $PublishDir -RepoRoot $repoRoot

README.md

@@ -1,47 +1,48 @@
-# LanMountainDesktop
+# 阑山桌面（LanMountainDesktop）
 
-> 你的桌面，不止一面。
+## 中文
 
-`LanMountainDesktop` 是一个基于 Avalonia 的桌面壳层项目，目标不是“做一个启动器”，而是把桌面变成可编排的信息与交互空间。
+阑山桌面是一个基于 Avalonia 的桌面壳层项目。它不是单纯的启动器，而是一个可编排、可扩展、可长期演进的桌面信息空间。
 
-> ⚠️ **注意**：该项目使用 Vibe Coding，介意勿用。
-## 项目定位
-- 以网格化布局组织桌面组件，支持多页桌面与组件自由摆放。
-- 提供顶部状态栏 + 底部任务栏的桌面框架，强调信息密度与可读性平衡。
-- 通过主题色、日夜模式、玻璃视觉与动画系统，形成统一的视觉语言。
-- 通过组件注册机制与 JSON 扩展入口，让桌面能力可持续扩展。
+### 核心目标
 
-## 核心能力
-- 桌面组件系统：天气、时钟、计时器、课程表、日历、白板、音乐控制、学习环境等组件可组合使用。
-- 壁纸系统：支持图片与视频壁纸，并可在设置中实时预览。
-- 主题系统：支持日夜模式、主题色与调色联动（Monet 风格色板）。
-- 个性化设置：网格密度、状态栏间距、任务栏布局、语言与时区等可持久化配置。
-- 本地化：内置 `zh-CN` 与 `en-US` 资源。
+- 通过网格化布局管理桌面组件。
+- 提供状态栏、任务栏和多页桌面的统一外壳。
+- 通过主题、玻璃效果和动效塑造统一体验。
+- 通过组件系统和插件系统持续扩展能力。
 
-## 工程结构
-- `LanMountainDesktop/`：桌面端主程序（Avalonia）。
-- `LanMountainDesktop.RecommendationBackend/`：推荐内容后端服务（ASP.NET Core Minimal API）。
-- `docs/`：视觉与圆角等规范文档。
-- `LanMountainDesktop/ComponentSystem/`：组件定义、注册、放置规则与扩展入口。
+### 当前工程结构
 
-## 技术栈
-- .NET 10（`net10.0`）
-- Avalonia 11
-- FluentAvalonia + FluentIcons.Avalonia
-- LibVLCSharp（用于视频相关能力）
-- WebView.Avalonia（嵌入式网页组件能力）
+- `LanMountainDesktop/`：桌面主程序。
+- `LanMountainDesktop.RecommendationBackend/`：推荐内容后端。
+- `LanMountainDesktop/ComponentSystem/`：组件定义与注册系统。
+- `LanMountainDesktop/plugins/`：宿主侧插件加载、安装和设置集成。
+- `docs/`：视觉与设计规范。
+- `LanAirApp/`：插件开发资料镜像，权威版本以独立 `LanAirApp` 仓库为准。
 
-## 扩展机制（摘要）
-- 组件系统通过 `ComponentRegistry` 合并内置组件与扩展组件。
-- 运行时会扫描 `Extensions/Components/*.json`（相对应用输出目录）加载第三方组件清单。
-- 扩展契约与字段说明见组件系统文档：`LanMountainDesktop/ComponentSystem/README.md`。
+### 生态关系
 
-## 当前状态
-- 项目包含桌面端与推荐后端两个子项目，并在同一 solution 中维护。
-- 通用应用配置默认写入本地：`%LOCALAPPDATA%\LanMountainDesktop\settings.json`。
-- 启动台与桌面布局已拆分到独立文件：`%LOCALAPPDATA%\LanMountainDesktop\launcher-settings.json`、`%LOCALAPPDATA%\LanMountainDesktop\desktop-layout-settings.json`。
-- 组件配置统一写入：`%LOCALAPPDATA%\LanMountainDesktop\component-settings.json`；同类组件按实例 `componentId::placementId` 隔离存储，同时预留插件专属配置区。
-- 当前体验以 Windows 为主要目标平台。
+- 宿主程序只连接 `LanAirApp` 仓库中的官方市场索引。
+- 官方市场索引返回插件列表以及各插件项目根目录链接。
+- 插件项目根目录提供 `.laapp` 安装包和 `README.md`。
 
-## 运行说明
-运行与环境准备已拆分到独立文档：[`run.md`](./run.md)
+### 当前状态
+
+- Windows 是当前主要目标平台。
+- 已提供组件系统、插件系统、主题系统和设置系统。
+- 中文为主语言，英文为附加扩展语言。
+
+### 运行说明
+
+运行方法见 [run.md](./run.md)。
+
+## English
+
+LanMountainDesktop is an Avalonia-based desktop shell. It is designed as a composable and extensible desktop environment rather than a simple launcher.
+
+### Main goals
+
+- manage desktop widgets with a grid-based layout
+- provide a unified shell with status bar, taskbar, and multi-page desktop support
+- build a consistent experience through themes, glass effects, and motion
+- extend capabilities through the component and plugin systems

airappmarket/README.md

@@ -1,23 +1,17 @@
-# AirAppMarket
+# AirApp Market 目录说明
 
-`airappmarket/` 是阑山桌面的官方插件市场源目录。
+## 中文
 
-当前阶段职责：
-- 提供官方插件市场索引 `index.json`
-- 提供索引 schema
-- 提供静态图标资产
-- 提供本地与 CI 使用的索引校验工具
+这个目录是阑山桌面仓库里遗留的市场原型目录，只用于历史参考，不再作为官方权威市场源。
 
-Bootstrap 方式：
-1. 用户先通过阑山桌面内置的 `设置 -> 插件 -> 打开 .laapp 插件包` 手动安装 `LanMountainDesktop.PluginMarketplace`。
-2. 市场插件启动后，会从这里的官方索引拉取插件列表。
-3. 后续插件安装与更新都通过市场插件完成。
+### 当前结论
 
-官方索引地址：
+- 官方市场源以独立 `LanAirApp` 仓库中的 `airappmarket/index.json` 为准
+- 阑山桌面程序应连接 `LanAirApp` 仓库，而不是以本目录为权威数据源
+- 如无特殊需要，不应继续向这里添加正式市场数据
 
-`https://raw.githubusercontent.com/wwiinnddyy/LanMountainDesktop/main/airappmarket/index.json`
+## English
 
-约束：
-- 这里只维护官方市场源，不做多源聚合。
-- 第一阶段不提供独立 GitHub Pages 页面。
-- 索引中的下载链接默认指向本仓库已提交的 `.laapp` 发布包。
+This directory is a legacy market prototype kept in the LanMountainDesktop repository for historical reference only.
+
+The authoritative market source now lives in the standalone `LanAirApp` repository.

airappmarket/assets/plugin-marketplace.svg

@@ -1,13 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" role="img" aria-label="Plugin Marketplace">
-  <defs>
-    <linearGradient id="marketBg" x1="0" x2="1" y1="0" y2="1">
-      <stop offset="0%" stop-color="#0EA5E9"/>
-      <stop offset="100%" stop-color="#22C55E"/>
-    </linearGradient>
-  </defs>
-  <rect x="8" y="8" width="112" height="112" rx="28" fill="url(#marketBg)"/>
-  <path d="M43 36h42c3.866 0 7 3.134 7 7v42c0 3.866-3.134 7-7 7H43c-3.866 0-7-3.134-7-7V43c0-3.866 3.134-7 7-7Z" fill="#FFFFFF" fill-opacity="0.16"/>
-  <path d="M52 52h24a12 12 0 0 1 0 24H52a8 8 0 0 1 0-16h4" fill="none" stroke="#FFFFFF" stroke-linecap="round" stroke-linejoin="round" stroke-width="10"/>
-  <circle cx="84" cy="84" r="14" fill="#FFFFFF"/>
-  <path d="M84 76v16M76 84h16" stroke="#0EA5E9" stroke-linecap="round" stroke-width="8"/>
-</svg>

airappmarket/index.json

@@ -2,31 +2,8 @@
   "schemaVersion": "1.0.0",
   "sourceId": "official.lanmountaindesktop",
   "sourceName": "LanMountainDesktop Official Market",
-  "generatedAt": "2026-03-10T01:30:00Z",
+  "generatedAt": "2026-03-10T11:10:00Z",
   "plugins": [
-    {
-      "id": "LanMountainDesktop.PluginMarketplace",
-      "name": "LanMountain Plugin Marketplace",
-      "description": "Official plugin marketplace for browsing and installing LanMountainDesktop plugins.",
-      "author": "LanMountainDesktop",
-      "version": "1.0.0",
-      "apiVersion": "1.0.0",
-      "minHostVersion": "1.0.0",
-      "downloadUrl": "https://raw.githubusercontent.com/wwiinnddyy/LanMountainDesktop/main/LanAirApp/releases/LanMountainDesktop.PluginMarketplace.1.0.0.laapp",
-      "sha256": "51e73bf834c4c3f8a32bc711e9db62b954e24a3577e580d6faa4c3986ce70e0b",
-      "packageSizeBytes": 1704353,
-      "iconUrl": "https://raw.githubusercontent.com/wwiinnddyy/LanMountainDesktop/main/airappmarket/assets/plugin-marketplace.svg",
-      "homepageUrl": "https://github.com/wwiinnddyy/LanMountainDesktop/tree/main/LanAirApp/plugins/LanMountainDesktop.PluginMarketplace",
-      "repositoryUrl": "https://github.com/wwiinnddyy/LanMountainDesktop/tree/main/LanAirApp/plugins/LanMountainDesktop.PluginMarketplace",
-      "tags": [
-        "official",
-        "market",
-        "settings"
-      ],
-      "publishedAt": "2026-03-10T01:30:00Z",
-      "updatedAt": "2026-03-10T01:30:00Z",
-      "releaseNotes": "Bootstrap plugin for the official LanMountainDesktop marketplace. Install it once from a local .laapp package, then use it to discover and stage future plugin installs and updates."
-    },
     {
       "id": "LanMountainDesktop.SamplePlugin",
       "name": "LanMountain Sample Plugin",

docs/CORNER_RADIUS_SPEC.md

@@ -1,177 +1,38 @@
-# 圆角设计规范 (Corner Radius Design System)
+# 圆角设计规范
 
-> 基于小米澎湃OS 3 (HyperOS) 设计语言
+## 中文
 
-## 设计理念
+本规范用于统一阑山桌面不同层级容器和控件的圆角尺度。
 
-澎湃OS 3 采用**"生命感美学"**设计语言，强调：
-- **全局圆角设计** - 所有界面元素均采用圆角
-- **视觉舒适统一** - 柔和、现代、细腻
-- **多级渲染** - 配合模糊混色与阴影
-- **层级分明** - 大容器使用大圆角，小元素使用小圆角
+### 基础层级
 
-## 圆角数值体系
+- Level 1：12px，小元素和图标容器
+- Level 2：16px，小型色块和紧凑控件
+- Level 3：20px，普通按钮
+- Level 4：24px，输入面板和小型容器
+- Level 5：28px，普通玻璃面板
+- Level 6：32px，强化容器
+- Level 7：36px，大容器、窗口、任务栏
 
-### 核心数值
+### 使用建议
 
-| 级别 | 圆角值 (px) | 用途 |
-|------|-------------|------|
-| **Level 0** | 0 | 特殊场景（无圆角需求） |
-| **Level 1** | 12 | 小元素、图标内边角、ListBoxItem |
-| **Level 2** | 16 | 色块按钮、小组件 |
-| **Level 3** | 20 | 普通按钮、组件预览 |
-| **Level 4** | 24 | 输入框、小型面板 |
-| **Level 5** | 28 | 面板/卡片 (glass-panel) |
-| **Level 6** | 32 | Mica 风格面板 (mica-strong) |
-| **Level 7** | 36 | 大容器 (glass-strong)、任务栏、窗口 |
+- 同层级元素保持相同圆角。
+- 大容器的圆角大于内部子面板。
+- 动态尺寸组件可按 `cellSize` 计算圆角，但仍要落在统一范围内。
 
-### 动态圆角
-
-动态圆角根据格子大小（cellSize）动态计算：
+### 动态圆角建议
 
 ```csharp
-// 小元素
-CornerRadius = Math.Clamp(cellSize * 0.35, 16, 28);
-
-// 小组件
-CornerRadius = Math.Clamp(cellSize * 0.45, 24, 44);
-
-// 大容器（任务栏/窗口）
-CornerRadius = Math.Clamp(cellSize * 0.45, 24, 44);
-```
-
-**系数参考**：
-- 系数范围：`0.35 - 0.45`
-- 最小值限制：`12 - 24 px`
-- 最大值限制：`28 - 44 px`
-
-## 组件圆角速查表
-
-### 基础控件
-
-| 控件 | 圆角值 | 代码位置 |
-|------|--------|---------|
-| Button | 20px | GlassModule.axaml |
-| ToggleSwitch | 继承系统 | - |
-| TextBox | 20px | glass-panel |
-| ComboBox | 20px | glass-panel |
-| NumberBox | 20px | glass-panel |
-
-### 容器样式类
-
-| 样式类 | 圆角值 | 说明 |
-|--------|--------|------|
-| `.glass-panel` | 28px | 普通玻璃面板 |
-| `.glass-strong` | 36px | 加强玻璃面板（任务栏） |
-| `.mica-strong` | 36px | Mica 风格面板（设置页） |
-| `.glass-overlay` | 0px | 覆盖层（无圆角） |
-
-### 特殊场景
-
-| 场景 | 圆角值 | 说明 |
-|------|--------|------|
-| 窗口整体 | 36px | 组件库/设置窗口 |
-| 窗口标题栏 | 36px | 仅顶部圆角 (`36,36,0,0`) |
-| 颜色选择器色块 | 12px | Monet 颜色/推荐色 |
-| 设置页 ListBoxItem | 12px | 导航项 |
-| 预览视口 | 12-16px | 壁纸/网格预览 |
-
-## 圆角层级视觉示例
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                                                                 │
-│   Level 7: 大容器 (36px)                                       │
-│   ┌───────────────────────────────────────────────────────────┐ │
-│   │                                                           │ │
-│   │   Level 6: Mica 面板 (36px)                              │ │
-│   │   ┌─────────────────────────────────────────────────────┐ │ │
-│   │   │                                                     │ │ │
-│   │   │   Level 5: 玻璃面板 (28px)                         │ │ │
-│   │   │   ┌─────────────────────────────────────────────┐  │ │ │
-│   │   │   │                                             │  │ │ │
-│   │   │   │   Level 4: 输入面板 (24px)                  │  │ │ │
-│   │   │   │   ┌─────────────────────────────────────┐   │  │ │ │
-│   │   │   │   │                                     │   │  │ │ │
-│   │   │   │   │   Level 3: 按钮 (20px)             │   │  │ │ │
-│   │   │   │   │   ┌─────────────────────────────┐   │   │  │ │ │
-│   │   │   │   │   │ Level 2: 色块 (16px)       │   │   │  │ │ │
-│   │   │   │   │   │ ┌─────────────────────┐   │   │   │  │ │ │
-│   │   │   │   │   │ │ Level 1: 小元素    │   │   │   │  │ │ │
-│   │   │   │   │   │ │      (12px)        │   │   │   │  │ │ │
-│   │   │   │   │   │ └─────────────────────┘   │   │   │  │ │ │
-│   │   │   │   │   └─────────────────────────────┘   │   │  │ │ │
-│   │   │   │   └─────────────────────────────────────┘   │  │ │ │
-│   │   │   └─────────────────────────────────────────────┘  │ │ │
-│   │   └─────────────────────────────────────────────────────┘ │ │
-│   └───────────────────────────────────────────────────────────┘   │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-## 在 XAML 中使用
-
-### 直接使用固定值
-
-```xml
-<Border Classes="glass-strong" CornerRadius="36">
-    <!-- 内容 -->
-</Border>
-
-<Button CornerRadius="20">点击</Button>
-```
-
-### 使用样式类
-
-```xml
-<!-- 使用预定义的 glass-panel 样式 -->
-<Border Classes="glass-panel">
-    <TextBlock Text="面板内容" />
-</Border>
-
-<!-- 组合多个样式类 -->
-<Border Classes="glass-strong mica-strong">
-    <!-- 内容 -->
-</Border>
-```
-
-### 动态圆角（Code-Behind）
-
-```csharp
-// 根据格子大小动态计算圆角
-var cellSize = 100; // 假设格子大小
 var cornerRadius = Math.Clamp(cellSize * 0.45, 24, 44);
-
-BottomTaskbarContainer.CornerRadius = new CornerRadius(cornerRadius);
 ```
 
-## 新增控件时的圆角规范
+## English
 
-1. **确定元素层级** - 根据容器大小选择合适的级别
-2. **遵循视觉一致性** - 同层级的元素使用相同圆角
-3. **考虑内容安全区** - 圆角不应遮挡重要内容
-4. **响应式适配** - 大屏幕使用较大圆角，小屏幕使用较小圆角
+This specification keeps corner radius usage consistent across containers and controls.
 
-### 快速参考
+### Reference levels
 
-```
-新控件圆角选择流程：
-
-1. 是窗口/大容器？        → Level 7 (36px)
-2. 是面板/卡片？          → Level 5-6 (28-36px)
-3. 是按钮/输入框？        → Level 3-4 (20-24px)
-4. 是小组件/色块？        → Level 2 (16px)
-5. 是图标/小元素？        → Level 1 (12px)
-```
-
-## 附录：修改历史
-
-| 日期 | 修改人 | 说明 |
-|------|--------|------|
-| 2026-03-02 | AI Assistant | 初始规范，基于澎湃OS 3 设计语言 |
-
-## 参考资料
-
-- 澎湃OS 生命感美学设计
-- Xiaomi HyperOS Design Guidelines
-- 小米小部件审核规范 (dev.mi.com)
+- 12px for small elements
+- 20px for common buttons
+- 28px for normal glass panels
+- 36px for large containers and windows

docs/VISUAL_SPEC.md

@@ -1,126 +1,42 @@
-# LanMountainDesktop 视觉规范（主题色 + 毛玻璃）
+# 视觉规范
 
-## 1. 主题色应用规范
+## 中文
 
-### 1.1 颜色角色定义
+本规范用于统一阑山桌面的主题色、玻璃效果和基础视觉语义。
 
-- `Primary`（主色）：品牌主导色，用于主要操作、关键状态提示。
-- `Secondary`（辅助色）：主色的低权重变体，用于次级强调、辅助信息。
-- `Accent`（强调色）：可被用户替换的动态主题色，用于选中态、激活态、聚焦态。
-- `OnAccent`：放在强调色背景上的文本/图标颜色。
-- `SurfaceBase` / `SurfaceRaised` / `SurfaceOverlay`：基础背景、抬升层、遮罩层。
-- `TextPrimary` / `TextSecondary` / `TextMuted` / `TextAccent`：文字语义层级。
+### 颜色角色
 
-### 1.2 UI 元素映射规则
+- `Primary`：品牌主色
+- `Secondary`：辅助色
+- `Accent`：强调色与选中态主色
+- `OnAccent`：强调色背景上的文字或图标
+- `SurfaceBase` / `SurfaceRaised` / `SurfaceOverlay`：背景层级
+- `TextPrimary` / `TextSecondary` / `TextMuted` / `TextAccent`：文本层级
 
-- 主按钮、主导航选中态：`Accent` + `OnAccent`
-- 次级按钮/输入控件：`AdaptiveButtonBackgroundBrush` + `TextPrimary`
-- 页头标题：`TextPrimary`
-- 说明/辅助文本：`TextSecondary` / `TextMuted`
-- 设置页导航激活项：`AdaptiveNavItemSelectedBackgroundBrush` + `AdaptiveNavSelectedTextBrush`
+### 使用规则
 
-### 1.3 统一资源键（单一真相源）
+- 主按钮和主要导航选中态使用 `Accent + OnAccent`
+- 次级操作和输入控件优先使用语义背景色，不直接写死颜色
+- 页面层只使用资源键和语义类名，不写业务颜色常量
 
-- 主题核心：
-  - `AdaptivePrimaryBrush`
-  - `AdaptiveSecondaryBrush`
-  - `AdaptiveAccentBrush`
-  - `AdaptiveOnAccentBrush`
-- 文本：
-  - `AdaptiveTextPrimaryBrush`
-  - `AdaptiveTextSecondaryBrush`
-  - `AdaptiveTextMutedBrush`
-  - `AdaptiveTextAccentBrush`
-- 表面：
-  - `AdaptiveSurfaceBaseBrush`
-  - `AdaptiveSurfaceRaisedBrush`
-  - `AdaptiveSurfaceOverlayBrush`
+### 玻璃效果层级
 
-## 2. 毛玻璃（Glassmorphism）统一实现方案
+- `glass-overlay`：最外层遮罩
+- `glass-strong`：主要大容器
+- `glass-panel`：子区域、小面板、卡片
 
-### 2.1 分层标准
+### 可访问性
 
-- `glass-overlay`：最高层遮罩（设置页背板）
-- `glass-strong`：主内容容器（设置页主体）
-- `glass-panel`：子功能区、组件容器（网格卡片、按钮容器）
+- 正文对比度目标不低于 `4.5:1`
+- 大号文字和重点文字不低于 `3.0:1`
+- 主题服务负责对前景色做自动对比度修正
 
-### 2.2 参数标准（模拟毛玻璃，跨平台稳定）
+## English
 
-- 描边：统一去除（`BorderThickness = 0`）
-- 模糊半径资源（供样式/扩展复用）：
-  - `AdaptiveGlassPanelBlurRadius`（日 18 / 夜 22）
-  - `AdaptiveGlassStrongBlurRadius`（日 24 / 夜 28）
-- 透明度资源：
-  - `AdaptiveGlassPanelOpacity`（日 0.88 / 夜 0.92）
-  - `AdaptiveGlassStrongOpacity`（日 0.92 / 夜 0.95）
-- 背景色：由 `GlassEffectService` 基于主题色动态混合，统一下发到：
-  - `AdaptiveGlassPanelBackgroundBrush`
-  - `AdaptiveGlassStrongBackgroundBrush`
-  - `AdaptiveGlassOverlayBackgroundBrush`
+This specification defines the visual language of LanMountainDesktop, including theme roles, glass layers, and semantic color usage.
 
-## 3. 视觉一致性策略
-
-- 全局样式入口：`Styles/GlassModule.axaml`
-- 全局主题入口：`ThemeColorSystemService` + `GlassEffectService`
-- 页面侧仅使用语义资源键和 `glass-*` 类，不写硬编码颜色
-- `MainWindow` 只负责编排：切换模式、选择主题色、触发资源重算
-
-## 4. 可访问性（WCAG）
-
-### 4.1 对比度目标
-
-- 正文文本：`>= 4.5:1`
-- 大号文本 / 强调文本：`>= 3.0:1`
-
-### 4.2 实现方式
-
-- `Theme/ColorMath.cs` 提供：
-  - 相对亮度计算
-  - 对比度计算
-  - `EnsureContrast(...)` 自动修正文本前景色
-- `ThemeColorSystemService` 在生成 `TextPrimary/TextSecondary/TextMuted/NavText` 时强制走对比度校正
-
-## 5. 跨尺寸与分辨率一致性
-
-- 启用像素对齐：`UseLayoutRounding="True"` + `SnapsToDevicePixels="True"`
-- 桌面网格布局通过统一计算函数输出 `row/col/cell`，主视图与预览共用算法
-- 预览区域按窗口实际宽高比缩放，保持 Win11 风格比例一致性
-- 关键尺寸自适应（字体、内边距、圆角）随 `cellSize` 动态计算
-
-## 6. 实现代码示例
-
-### 6.1 主题系统应用（C#）
-
-```csharp
-var context = new ThemeColorContext(
-    selectedAccent,
-    isLightBackground,
-    isLightNavBackground,
-    isNightMode);
-
-ThemeColorSystemService.ApplyThemeResources(Resources, context);
-GlassEffectService.ApplyGlassResources(Resources, context);
-```
-
-### 6.2 页面层使用语义资源（AXAML）
-
-```xml
-<Border Classes="glass-overlay" />
-
-<Border Classes="glass-strong" CornerRadius="16">
-    <Border Classes="glass-panel" CornerRadius="10" Padding="14">
-        <TextBlock Foreground="{DynamicResource AdaptiveTextPrimaryBrush}" />
-        <Button Background="{DynamicResource AdaptiveButtonBackgroundBrush}" />
-    </Border>
-</Border>
-```
-
-### 6.3 无描边层级区分原则（AXAML）
-
-```xml
-<Style Selector="Border.glass-panel">
-    <Setter Property="BorderThickness" Value="0" />
-    <Setter Property="Opacity" Value="{DynamicResource AdaptiveGlassPanelOpacity}" />
-</Style>
-```
+### Key rules
 
+- use semantic resource keys instead of hard-coded colors
+- keep glass layers visually distinct
+- maintain contrast targets for readability

noise.md

@@ -1,771 +1,67 @@
-# 噪音计算与评分技术文档
+# 噪音监测与评分说明
 
-噪音监测系统不仅仅是一个简单的分贝计，它内置了一个基于心理声学与专注力理论的评分引擎。该引擎旨在客观、多维度地量化环境噪音对学习心流的干扰程度。
+## 中文
 
-本文档详细解析了该系统的计算原理、核心指标定义、评分算法及完整的技术架构。
+本文档描述阑山桌面中噪音监测能力的基本设计目标、核心指标和实现边界。
 
-## 目录
+### 设计目标
 
-1. [核心理念](#1-核心理念)
-2. [系统架构](#2-系统架构)
-3. [数据采集层](#3-数据采集层)
-4. [数据聚合层](#4-数据聚合层)
-5. [评分算法核心](#5-评分算法核心)
-6. [数据存储层](#6-数据存储层)
-7. [历史报告生成](#7-历史报告生成)
-8. [流服务整合](#8-流服务整合)
-9. [配置参数体系](#9-配置参数体系)
-10. [类型定义](#10-类型定义)
+- 用尽量稳定的方式度量环境噪音。
+- 区分持续噪音、超阈值时长和高频打断。
+- 将结果反馈到实时界面、历史报表和专注场景中。
 
----
+### 核心指标
 
-## 1. 核心理念
+- `p50Dbfs`：持续噪音水平，反映环境底噪。
+- `overRatioDbfs`：超阈值时间占比，反映噪音覆盖时长。
+- `segmentCount`：独立噪音事件数，反映被打断频率。
 
-### 1.1 设计原则
+### 评分思路
 
-系统认为，并非所有"响声"都是一样的。对于专注力而言：
+评分从 100 分开始，依据三类惩罚项扣分：
 
-- **持续的嗡嗡声**（如嘈杂的人群）比**偶尔的掉笔声**更具破坏性
-- **频繁的打断**（如每分钟都有人说话）比**单次的大声喧哗**更让人烦躁
-- **评分与校准分离**：评分使用原始 DBFS 数据，校准仅影响显示分贝
+- 持续噪音惩罚
+- 超阈值时长惩罚
+- 打断频率惩罚
 
-因此，评分系统采用了 **多维度加权扣分制**，满分 100 分，根据环境表现进行扣分。
+常见固定参数：
 
-### 1.2 评分与校准分离
+- 帧间隔：50ms
+- 切片时长：30s
+- 评分阈值：`-50 dBFS`
+- 事件合并窗口：500ms
+- 每分钟最大容忍事件数：6
 
-项目通过"原始数据（用于评分）"与"显示数据（用于展示）"的**严格分层**，杜绝了校准值导致的评分偏差：
+### 数据流
 
-1. **评分只依赖原始 DBFS（设备输出的相对电平）**
-   - 评分的三项核心指标（`p50Dbfs`、`overRatioDbfs`、`segmentCount`）都来自原始 `dbfs` 统计
-   - "超阈时长占比"判定条件固定为：`dbfs > scoreThresholdDbfs`（阈值默认 `-50 dBFS`），与校准无关
-   - 这意味着即使用户把"显示分贝基准"调高/调低，评分侧的 `dbfs` 不会变化，因此得分与超阈时长也不会被"调参刷分"
+1. 麦克风采集音频。
+2. 计算 RMS 与 dBFS。
+3. 聚合为时间切片。
+4. 为每个切片计算统计值和评分。
+5. 写入本地历史数据。
+6. 在 UI 中展示实时状态与历史报告。
 
-2. **校准仅影响 Display dB（UI 展示口径），不进入评分链路**
-   - 校准（`baselineRms` / `baselineDb`）只用于将 `rms` 映射为 `displayDb`，用于实时显示与报告中的"噪音等级分布"等图表展示
-   - 这些展示口径变化不会反向影响评分输入，也不会改变切片摘要中的 `raw.*` 字段
+### 设计边界
 
-3. **统计报告中"超阈时长"取自 raw.overRatioDbfs**
-   - 报告里展示的"超阈时长"是对每个切片 `raw.overRatioDbfs` 按有效采样时长加权汇总得到，仍然完全基于 DBFS
-   - 相比之下，"噪音等级分布"使用的是 `display.avgDb`（校准后的显示分贝），因此它会随校准变化——这是为了更贴近用户直觉的 dB 区间划分
+- 评分使用原始统计口径，不应被显示层校准参数反向影响。
+- 历史数据只存统计值，不存原始音频。
+- 该系统用于环境质量评估，不作为专业声学测量工具。
 
----
+## English
 
-## 2. 系统架构
+This document summarizes the noise monitoring and scoring model used by LanMountainDesktop.
 
-### 2.1 整体架构图
+### Main metrics
 
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                        用户界面层                                  │
-│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐          │
-│  │ 实时监控组件  │  │ 噪音报告弹窗  │  │ 噪音历史列表  │          │
-│  └──────────────┘  └──────────────┘  └──────────────┘          │
-└─────────────────────────────────────────────────────────────────┘
-                              ↑
-                              │ 订阅/发布
-                              ↓
-┌─────────────────────────────────────────────────────────────────┐
-│                        流服务层                                   │
-│  ┌──────────────────────────────────────────────────────────┐   │
-│  │  噪音流服务 - 订阅管理、生命周期控制、设置热更新          │   │
-│  └──────────────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────────┘
-                              ↑
-                              │ 帧数据流
-                              ↓
-┌─────────────────────────────────────────────────────────────────┐
-│                        数据聚合层                                 │
-│  ┌──────────────────┐  ┌────────────────────────────────────┐  │
-│  │ 噪音帧处理器      │  │ 噪音切片聚合器                      │  │
-│  │ - RMS/dBFS 计算   │  │ - 切片聚合、统计指标、评分计算      │  │
-│  │ - 50ms/帧         │  │ - 30秒/切片                         │  │
-│  └──────────────────┘  └────────────────────────────────────┘  │
-│  ┌──────────────────────────────────────────────────────────┐   │
-│  │ 实时环形缓冲区 - 保留固定时长的实时数据                    │   │
-│  └──────────────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────────┘
-                              ↑
-                              │ 音频流
-                              ↓
-┌─────────────────────────────────────────────────────────────────┐
-│                        数据采集层                                 │
-│  ┌──────────────────────────────────────────────────────────┐   │
-│  │ 麦克风采集 - Web Audio API、滤波器、AnalyserNode         │   │
-│  └──────────────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────────┘
-                              ↑
-                              │ 物理音频
-                              ↓
-┌─────────────────────────────────────────────────────────────────┐
-│                        数据存储层                                 │
-│  ┌──────────────────────────────────────────────────────────┐   │
-│  │ 切片存储 - localStorage、时间清理、容量限制                │   │
-│  └──────────────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────────┘
-                              ↑
-                              │ 历史数据
-                              ↓
-┌─────────────────────────────────────────────────────────────────┐
-│                        历史报告层                                 │
-│  ┌──────────────────────────────────────────────────────────┐   │
-│  │ 历史构建 - 课表关联、加权平均评分、覆盖率计算                │   │
-│  └──────────────────────────────────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────────┘
-```
+- `p50Dbfs`: sustained noise level
+- `overRatioDbfs`: ratio of time above threshold
+- `segmentCount`: number of distinct interruption events
 
-### 2.2 模块说明
-
-| 模块 | 功能 |
-|------|------|
-| 类型定义 | 核心类型定义 |
-| 常量定义 | 分析参数常量、报告参数常量 |
-| 麦克风采集 | 音频采集 |
-| 帧处理器 | 帧处理 |
-| 切片聚合器 | 切片聚合 |
-| 环形缓冲区 | 实时数据 |
-| 流服务 | 流管理 |
-| 评分引擎 | 评分算法 |
-| 切片服务 | 存储服务 |
-| 历史构建 | 历史报告 |
-| 设置管理 | 设置管理 |
-
----
-
-## 3. 数据采集层
-
-### 3.1 麦克风采集
-
-#### 3.1.1 Web Audio API 使用
-
-系统使用 Web Audio API 获取麦克风输入，构建完整的音频处理链路：
-
-```
-麦克风 → MediaStream → MediaStreamAudioSourceNode 
-       → 高通滤波器 (80Hz) → 低通滤波器 (8000Hz) 
-       → AnalyserNode (FFT Size 2048)
-```
-
-#### 3.1.2 音频滤波器配置
-
-| 滤波器类型 | 截止频率 | 作用 |
-|-----------|---------|------|
-| 高通滤波器 | 80 Hz | 过滤低频噪音（如空调嗡嗡声） |
-| 低通滤波器 | 8000 Hz | 过滤高频噪音（如电子设备啸叫） |
-
-#### 3.1.3 AnalyserNode 配置
-
-```typescript
-analyser.fftSize = 2048;           // FFT 窗口大小
-analyser.smoothingTimeConstant = 0; // 无平滑，实时响应
-```
-
-#### 3.1.4 权限处理与错误处理
-
-```typescript
-// 麦克风权限请求配置
-{
-  audio: {
-    echoCancellation: false,    // 禁用回声消除
-    noiseSuppression: false,    // 禁用降噪
-    autoGainControl: false,     // 禁用自动增益
-  },
-  video: false
-}
-```
-
-**浏览器兼容性说明：**
-- 部分浏览器/设备可能忽略上述约束设置
-- 建议在 UI 中提示用户实际生效的约束
-- 需要测试矩阵验证：Chrome/Firefox/Safari/Edge/iOS Safari/Android WebView
-
-**错误处理：**
-- `NotAllowedError` / `SecurityError` → 权限拒绝
-- `AudioContext not supported` → 浏览器不支持
-
----
-
-### 3.2 帧处理器
-
-#### 3.2.1 采样频率
-
-- **帧间隔**：50ms（约 20 fps）
-- **数据来源**：AnalyserNode.getFloatTimeDomainData()
-
-#### 3.2.2 RMS（均方根）计算
-
-RMS 是衡量音频信号强度的标准方法：
-
-**公式：**
-$$ \text{RMS} = \sqrt{\frac{1}{N} \sum_{i=1}^{N} x_i^2} $$
-
-#### 3.2.3 dBFS（分贝满刻度）转换
-
-dBFS 是数字音频的标准分贝单位，范围 -100 到 0 dB：
-
-**公式：**
-$$ \text{dBFS} = 20 \times \log_{10}(\text{RMS}) $$
-
-**范围限制：**
-- 最小值：-100 dBFS（静音）
-- 最大值：0 dBFS（满刻度）
-
-#### 3.2.4 峰值检测
-
-峰值用于检测突发噪音，在 RMS 计算过程中同时记录峰值。
-
----
-
-## 4. 数据聚合层
-
-### 4.1 切片聚合器
-
-#### 4.1.1 切片时长
-
-- **默认切片时长**：30 秒
-- **可配置范围**：≥ 1 秒
-
-#### 4.1.2 统计指标计算
-
-切片聚合器为每个切片计算以下统计指标：
-
-| 指标 | 说明 | 计算方法 |
-|------|------|---------|
-| avgDbfs | 平均分贝 | 能量平均（线性域 RMS 平均后转回 dBFS） |
-| maxDbfs | 最大分贝 | 所有帧 dBFS 的最大值 |
-| p50Dbfs | 中位数分贝 | 线性域分位数（RMS 域计算后转回 dBFS） |
-| p95Dbfs | 95分位数分贝 | 线性域分位数（RMS 域计算后转回 dBFS） |
-| overRatioDbfs | 超阈值比例 | 超阈值时长 / 采样时长 |
-| segmentCount | 事件段数量 | 独立噪音事件次数 |
-| sampledDurationMs | 采样时长 | 有效采样时间（排除缺口） |
-| gapCount | 缺口数量 | 数据缺口次数 |
-| maxGapMs | 最大缺口时长 | 最长数据缺口时长 |
-
-#### 4.1.3 能量平均计算（avgDbfs）
-
-**公式：**
-$$ \text{avgDbfs} = 20 \times \log_{10}\left(\sqrt{\frac{1}{N} \sum_{i=1}^{N} 10^{\text{dBFS}_i / 10}}\right) $$
-
-**物理意义：** 在线性域（RMS）上做平均，符合能量守恒定律
-
-#### 4.1.4 线性域分位数计算
-
-**公式：**
-$$ \text{quantileDbfs} = 20 \times \log_{10}(Q_{\text{RMS}}(p)) $$
-
-其中 $Q_{\text{RMS}}(p)$ 是 RMS 域的分位数，使用线性插值计算：
-$$ Q_{\text{RMS}}(p) = x_{\lfloor i \rfloor} \times (1 - w) + x_{\lceil i \rceil} \times w $$
-
-- $i = (n-1) \times p$
-- $w = i - \lfloor i \rfloor$
-
-**物理意义：** 在线性域（RMS）上计算分位数，符合能量统计的严谨性
-
-#### 4.1.5 超阈值比例计算（时间加权）
-
-**公式：**
-$$ \text{overRatioDbfs} = \frac{\text{超阈值时长}}{\text{采样时长}} $$
-
-**物理意义：** 使用实际时长而非帧数计算比例，更精确
-
-#### 4.1.6 事件段检测与合并算法
-
-事件段检测用于识别独立的噪音事件：
-
-**合并规则：**
-- **合并窗口**：500ms（默认）
-- 如果两次超阈值事件间隔 ≤ 500ms，合并为同一事件段
-- 否则计为新的独立事件段
-
-**示例：**
-```
-时间轴：  0ms    200ms   400ms   600ms   800ms   1000ms
-状态：    [噪音] [噪音] [安静] [噪音] [噪音] [安静]
-合并后：  └─────── 事件段1 ───────┘  └── 事件段2 ──┘
-```
-
-#### 4.1.7 显示分贝映射（校准机制）
-
-显示分贝用于用户界面展示，支持校准：
-
-**公式（有校准）：**
-$$ \text{displayDb} = \text{baselineDb} + 20 \times \log_{10}\left(\frac{\text{rms}}{\text{baselineRms}}\right) $$
-
-**公式（无校准）：**
-$$ \text{displayDb} = 20 \times \log_{10}\left(\frac{\text{rms}}{10^{-3}}\right) + 60 $$
-
-**范围限制：** 20 dB ~ 100 dB
-
-**校准流程说明：**
-1. 使用标准声源（如 60 dB 的白噪音）
-2. 测量对应的 RMS 值
-3. 设置为 baselineRms
-4. 设置对应的显示分贝为 baselineDb
-
-#### 4.1.8 缺口检测与采样时长统计
-
-**缺口阈值：** `max(1000ms, frameMs × 5)` = **1000ms**（默认）
-
-当检测到数据缺口时，会触发切片完成并记录缺口信息。
-
-#### 4.1.9 无效帧过滤
-
-低于 -90 dBFS 的帧被视为静音/无效信号，不参与统计。
-
-**常量说明：**
-- `INVALID_DBFS_THRESHOLD = -90`：统计意义上的"静音"阈值
-- `DBFS_MIN_POSSIBLE = -100`：物理最小可表示值（用于 clamp）
-- `DBFS_MAX_POSSIBLE = 0`：物理最大可表示值（用于 clamp）
-
----
-
-### 4.2 实时环形缓冲区
-
-#### 4.2.1 数据结构设计
-
-环形缓冲区使用固定容量数组实现，通过起始索引和当前长度管理数据。
-
-#### 4.2.2 时间窗口裁剪策略
-
-**裁剪规则：** 移除时间戳早于 `当前时间 - retentionMs` 的数据点
-
----
-
-## 5. 评分算法核心
-
-### 5.1 三大核心指标
-
-评分引擎从以下三个维度对噪音数据进行分析：
-
-#### A. 持续噪音水平 (Sustained Level)
-
-- **定义**：剔除突发噪音后的环境"底噪"水平
-- **算法**：使用时段内所有帧的中位数电平 (`p50Dbfs`)
-- **意义**：反映环境本身是否安静。如果环境中有持续的风扇声或交谈声，该指标会升高
-
-#### B. 超阈值时长占比 (Over Threshold Ratio)
-
-- **定义**：原始 `DBFS` 超过评分阈值（`scoreThresholdDbfs`）的时间比例
-- **算法**：`超阈值时长 / 采样时长`（超标判定：`dbfs > scoreThresholdDbfs`）
-- **意义**：反映环境的"纯净度"。即使是 0.1 秒的尖叫也会被精确计入，无法被平均值掩盖
-
-> **提示**：评分阈值（`scoreThresholdDbfs`，单位 dBFS）与"界面报警/提示音"使用的显示分贝阈值（`maxLevelDb`，单位 dB）不是同一个概念；前者只用于评分，后者用于判定 noisy/quiet 与提示音触发。
-
-#### C. 打断次数密度 (Interruption Density)
-
-- **定义**：单位时间内（每分钟）发生的独立噪音事件次数
-- **智能合并算法**：
-  - 系统设有 **500ms** (默认) 的合并窗口
-  - 如果两次响声间隔小于该窗口（如拉椅子的一连串声音），会被合并为 **1 次打断**
-  - 只有间隔较长的响声才会被计为新的打断
-- **意义**：反映环境的干扰频率。频繁的打断（如断断续续的说话声）比连续的噪音更易打断心流
-
-### 5.2 评分引擎
-
-#### 5.2.1 三维度评分模型
-
-评分系统从三个维度对噪音进行评估：
-
-| 维度 | 权重 | 指标 | 满扣分条件 |
-|------|------|------|-----------|
-| **持续噪音** | 40% | p50Dbfs | 中位数超过阈值 6 dBFS |
-| **超阈时长** | 30% | overRatioDbfs | 超阈时间占比 30% |
-| **打断频次** | 30% | segmentCount | 6 次/分钟 |
-
-#### 5.2.2 评分公式
-
-**总惩罚系数：**
-$$ \text{TotalPenalty} = 0.40 \times P_{\text{sustained}} + 0.30 \times P_{\text{time}} + 0.30 \times P_{\text{segment}} $$
-
-**最终得分：**
-$$ \text{Score} = 100 \times (1 - \text{TotalPenalty}) $$
-
-#### 5.2.3 惩罚系数计算
-
-##### A. 持续噪音惩罚
-
-**公式：**
-$$ P_{\text{sustained}} = \text{clamp}_{[0,1]}\left(\frac{\text{p50Dbfs} - \text{threshold}}{6}\right) $$
-
-**满扣分条件：** `p50Dbfs - threshold ≥ 6 dBFS`
-
-##### B. 超阈时长惩罚
-
-**公式：**
-$$ P_{\text{time}} = \text{clamp}_{[0,1]}\left(\frac{\text{overRatioDbfs}}{0.3}\right) $$
-
-**满扣分条件：** `overRatioDbfs ≥ 30%`
-
-##### C. 打断频次惩罚
-
-**公式：**
-$$ P_{\text{segment}} = \text{clamp}_{[0,1]}\left(\frac{\text{segmentCount} / \text{minutes}}{\text{maxSegmentsPerMin}}\right) $$
-
-**满扣分条件：** `segmentsPerMin ≥ 6 次/分钟`
-
-#### 5.2.4 权重解读
-
-- **持续噪音 (40%)**：持续底噪仍会明显拉低分数
-- **超阈时长 (30%)**：只要大部分时间安静，偶尔的噪音仍可被容忍
-- **打断频次 (30%)**：强调"被频繁打断"对心流的破坏，提升对碎片化干扰的惩罚力度
-
-#### 5.2.5 边界条件处理
-
-- DBFS 范围限制：-100 到 0 dB
-- 惩罚系数范围限制：0 到 1
-- 评分范围限制：0 到 100 分
-
-#### 5.2.6 有效时长处理
-
-优先使用采样有效时长，不存在时回退到物理时长。
-
-#### 5.2.7 评分示例
-
-**场景 1：安静环境**
-- p50Dbfs = -60 dBFS, threshold = -50 dBFS
-- overRatioDbfs = 0.05 (5%)
-- segmentCount = 1, duration = 30s
-
-```
-sustainedPenalty = clamp01((-60 - (-50)) / 6) = clamp01(-10/6) = 0
-timePenalty = clamp01(0.05 / 0.3) = 0.167
-segmentPenalty = clamp01((1/0.5) / 6) = clamp01(2/6) = 0.333
-
-TotalPenalty = 0.4×0 + 0.3×0.167 + 0.3×0.333 = 0.15
-Score = 100 × (1 - 0.15) = 85 分
-```
-
-**场景 2：嘈杂环境**
-- p50Dbfs = -45 dBFS, threshold = -50 dBFS
-- overRatioDbfs = 0.40 (40%)
-- segmentCount = 8, duration = 30s
-
-```
-sustainedPenalty = clamp01((-45 - (-50)) / 6) = clamp01(5/6) = 0.833
-timePenalty = clamp01(0.40 / 0.3) = 1.0
-segmentPenalty = clamp01((8/0.5) / 6) = clamp01(16/6) = 1.0
-
-TotalPenalty = 0.4×0.833 + 0.3×1.0 + 0.3×1.0 = 0.933
-Score = 100 × (1 - 0.933) = 6.7 分
-```
-
----
-
-## 6. 数据存储层
-
-### 6.1 切片服务
-
-#### 6.1.1 localStorage 存储策略
-
-存储键：`noise-slices`
-
-**隐私说明：**
-- 存储内容：时间戳、噪音统计（不包含音频数据）
-- 风险：可能泄露位置/日程信息
-- 建议：在 UI 中提供"清除历史"功能
-
-#### 6.1.2 时间窗口清理
-
-**默认保留时长：** 14 天
-**可配置范围：** 1 ~ 365 天
-
-使用新切片的结束时间作为基准计算 cutoff，确保新切片不会被清理。
-
-#### 6.1.3 容量限制
-
-**容量上限：** 本地存储配额的 90%
-
-#### 6.1.4 数据规范化与校验
-
-**精度控制：**
-- dBFS：3 位小数
-- overRatioDbfs：4 位小数
-- 显示分贝：2 位小数
-- 评分：1 位小数
-
----
-
-## 7. 历史报告生成
-
-### 7.1 历史构建器
-
-#### 7.1.1 与课表关联逻辑
-
-**关联规则：**
-1. 按日期分组切片
-2. 对每个日期的每个课时，查找重叠的切片
-3. 计算该课时的平均评分
-
-#### 7.1.2 时段平均评分计算（加权平均）
-
-**公式：**
-$$ \text{avgScore} = \frac{\sum_{i} \text{score}_i \times \text{effectiveMs}_i}{\sum_{i} \text{effectiveMs}_i} $$
-
-其中：
-$$ \text{effectiveMs}_i = \text{sampledDurationMs}_i \times \frac{\text{overlapMs}_i}{\text{sliceMs}_i} $$
-
-#### 7.1.3 覆盖率计算
-
-**公式：**
-$$ \text{coverageRatio} = \frac{\text{totalMs}}{\text{periodMs}} $$
-
-**含义：** 课时内有效采样时长占课时总时长的比例
-
-#### 7.1.4 日期时间处理
-
-**时区说明：**
-- 使用本地时区
-- 内部存储使用 UTC 时间戳
-- 对外展示使用本地时间
-
-**日期格式：** `YYYY-MM-DD`
-**时间格式：** `HH:MM`
-
-#### 7.1.5 跨天课时处理
-
-如果结束时间 ≤ 开始时间，则课时跨越到次日。
-
-#### 7.1.6 报告中的图表
-
-在噪音统计报告中，您可以直观地看到这些数据：
-
-- **评分走势图**：展示了 `Score` 随时间的变化，帮助您回顾专注状态
-- **噪音等级分布**：将每一帧归类为安静/正常/吵闹/极吵，直观展示时间占比
-- **扣分归因**：直接显示上述三个维度的扣分比例，告诉您为什么分低（是因为一直吵，还是因为总被打断）
-- **打断次数密度**：展示每分钟被干扰的次数
-
----
-
-## 8. 流服务整合
-
-### 8.1 噪音流服务
-
-#### 8.1.1 订阅/发布模式
-
-**模式：** 观察者模式
-- 多个组件可同时订阅
-- 最后一个订阅者取消时自动停止采集
-
-#### 8.1.2 生命周期管理
-
-流服务支持启动、停止和重启操作，自动管理采集资源的生命周期。
-
-#### 8.1.3 预热帧处理
-
-**目的：** 丢弃麦克风启动后的不稳定数据（约 500ms）
-
-#### 8.1.4 设置热更新响应
-
-**需要重启的参数：**
-- frameMs
-- sliceSec
-- scoreThresholdDbfs
-- segmentMergeGapMs
-- maxSegmentsPerMin
-
-**无需重启的参数：**
-- maxLevelDb
-- showRealtimeDb
-- alertSoundEnabled
-- avgWindowSec
-- baselineDb
-
-#### 8.1.5 时间加权平均
-
-**公式：**
-$$ \text{avg} = \frac{\sum_{i} v_i \times (t_{i+1} - t_i)}{\sum_{i} (t_{i+1} - t_i)} $$
-
----
-
-## 9. 配置参数体系
-
-### 9.1 常量定义
-
-#### 9.1.1 分析参数
-
-```typescript
-NOISE_ANALYSIS_SLICE_SEC = 30;           // 切片时长 30 秒
-NOISE_ANALYSIS_FRAME_MS = 50;            // 帧间隔 50ms
-NOISE_SCORE_THRESHOLD_DBFS = -50;        // 评分阈值 -50dBFS
-NOISE_SCORE_SEGMENT_MERGE_GAP_MS = 500;  // 事件段合并间隔 500ms
-NOISE_SCORE_MAX_SEGMENTS_PER_MIN = 6;    // 每分钟最大事件段数 6
-NOISE_REALTIME_CHART_SLICE_COUNT = 1;     // 实时图表切片数 1
-```
-
-#### 9.1.2 报告参数
-
-```typescript
-DEFAULT_NOISE_REPORT_RETENTION_DAYS = 14;        // 默认保留 14 天
-MIN_NOISE_REPORT_RETENTION_DAYS = 1;             // 最小保留 1 天
-MAX_NOISE_REPORT_RETENTION_DAYS_FALLBACK = 365;  // 最大保留 365 天
-```
-
-### 9.2 设置管理
-
-#### 9.2.1 固定参数
-
-为保证评分口径稳定，避免用户通过调整参数"刷分"，以下参数固定为程序内常量：
-- sliceSec
-- frameMs
-- scoreThresholdDbfs
-- segmentMergeGapMs
-- maxSegmentsPerMin
-
-#### 9.2.2 可配置参数
-
-| 参数 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| maxLevelDb | number | 55 | 最大允许噪音级别（显示分贝） |
-| baselineDb | number | 40 | 手动基准显示分贝 |
-| showRealtimeDb | boolean | true | 是否显示实时分贝 |
-| avgWindowSec | number | 1 | 噪音平均时间窗（秒） |
-| alertSoundEnabled | boolean | false | 超阈值提示音开关 |
-
----
-
-## 10. 类型定义
-
-### 10.1 核心类型
-
-#### 10.1.1 噪音帧采样
-
-```typescript
-interface NoiseFrameSample {
-  t: number;        // 时间戳
-  rms: number;      // 均方根值
-  dbfs: number;     // 分贝值 (dBFS)
-  peak?: number;    // 峰值
-}
-```
-
-#### 10.1.2 噪音切片原始统计
-
-```typescript
-interface NoiseSliceRawStats {
-  avgDbfs: number;              // 平均分贝
-  maxDbfs: number;              // 最大分贝
-  p50Dbfs: number;             // 中位数分贝
-  p95Dbfs: number;             // 95分位数分贝
-  overRatioDbfs: number;        // 超阈值比例
-  segmentCount: number;         // 事件段数量
-  sampledDurationMs?: number;   // 采样时长
-  gapCount?: number;            // 缺口数量
-  maxGapMs?: number;            // 最大缺口时长
-}
-```
-
-#### 10.1.3 噪音切片显示统计
-
-```typescript
-interface NoiseSliceDisplayStats {
-  avgDb: number;    // 平均显示分贝
-  p95Db: number;    // 95分位数显示分贝
-}
-```
-
-#### 10.1.4 噪音评分明细
-
-```typescript
-interface NoiseScoreBreakdown {
-  sustainedPenalty: number;      // 持续噪音惩罚
-  timePenalty: number;           // 时间惩罚
-  segmentPenalty: number;        // 事件段惩罚
-  thresholdsUsed: {
-    scoreThresholdDbfs: number;      // 使用的评分阈值
-    segmentMergeGapMs: number;       // 使用的合并间隔
-    maxSegmentsPerMin: number;       // 使用的最大事件段数
-  };
-  sustainedLevelDbfs: number;    // 持续电平
-  overRatioDbfs: number;         // 超阈值比例
-  segmentCount: number;          // 事件段数量
-  minutes: number;               // 时长（分钟）
-  durationMs?: number;           // 物理时长
-  sampledDurationMs?: number;    // 采样时长
-  coverageRatio?: number;        // 覆盖率
-}
-```
-
-#### 10.1.5 噪音切片摘要
-
-```typescript
-interface NoiseSliceSummary {
-  start: number;                      // 开始时间戳
-  end: number;                        // 结束时间戳
-  frames: number;                     // 帧数
-  raw: NoiseSliceRawStats;            // 原始统计
-  display: NoiseSliceDisplayStats;    // 显示统计
-  score: number;                      // 评分
-  scoreDetail: NoiseScoreBreakdown;   // 评分明细
-}
-```
-
-#### 10.1.6 实时数据点
-
-```typescript
-interface NoiseRealtimePoint {
-  t: number;        // 时间戳
-  dbfs: number;     // 分贝值 (dBFS)
-  displayDb: number; // 显示分贝
-}
-```
-
-#### 10.1.7 噪音流快照
-
-```typescript
-interface NoiseStreamSnapshot {
-  status: NoiseStreamStatus;          // 流状态
-  realtimeDisplayDb: number;          // 实时显示分贝
-  realtimeDbfs: number;               // 实时分贝 (dBFS)
-  maxLevelDb: number;                 // 最大允许级别
-  showRealtimeDb: boolean;            // 是否显示实时分贝
-  alertSoundEnabled: boolean;         // 提示音开关
-  ringBuffer: NoiseRealtimePoint[];   // 环形缓冲区快照
-  latestSlice: NoiseSliceSummary | null; // 最新切片
-}
-```
-
-#### 10.1.8 噪音流状态
-
-```typescript
-type NoiseStreamStatus =
-  | "initializing"      // 初始化中
-  | "quiet"             // 安静
-  | "noisy"             // 嘈杂
-  | "permission-denied" // 权限拒绝
-  | "error";            // 错误
-```
-
----
-
-## 附录
-
-### A. 术语表
-
-| 术语 | 英文 | 说明 |
-|------|------|------|
-| 均方根 | RMS (Root Mean Square) | 衡量音频信号强度的标准方法 |
-| 分贝满刻度 | dBFS (Decibels relative to Full Scale) | 数字音频的标准分贝单位，范围 -100 到 0 dB |
-| 显示分贝 | Display dB | 用于用户界面展示的分贝值，范围 20 到 100 dB |
-| 切片 | Slice | 固定时间窗口（默认 30 秒）内的噪音数据聚合 |
-| 帧 | Frame | 单次音频采样（默认 50ms） |
-| 事件段 | Segment | 独立的噪音事件，通过合并窗口（500ms）合并 |
-
-### B. 参数固定策略
-
-为保证统计口径稳定，当前版本将"分析与评分"的高级参数固定为程序内常量：
-
-| 参数 | 值 | 说明 |
-|------|-----|------|
-| frameMs | 50ms | 约 20fps |
-| sliceSec | 30s | 切片时长 |
-| scoreThresholdDbfs | -50 dBFS | 评分阈值 |
-| segmentMergeGapMs | 500ms | 事件段合并间隔 |
-| maxSegmentsPerMin | 6 | 每分钟最大事件段数 |
-
-### C. 技术栈
-
-- **音频处理**：Web Audio API
-- **数据存储**：localStorage
-- **前端框架**：React 18
-- **构建工具**：Vite 5
-- **类型系统**：TypeScript 5.4
+### Pipeline
 
+1. capture microphone input
+2. compute RMS and dBFS
+3. aggregate frames into slices
+4. score each slice
+5. persist historical statistics
+6. present realtime and historical views

run.md

@@ -1,54 +1,55 @@
-# LanMountainDesktop 运行指南
+# 运行指南
 
-本文档只负责“怎么跑起来”。项目介绍请看 [README.md](./README.md)。
+## 中文
 
-## 1. 环境准备
-- 安装 .NET SDK 10（`net10.0`）。
-- 建议使用 Windows 运行桌面端（当前桌面体验以 Windows 为主）。
+本文档只说明如何在本地运行阑山桌面。
 
-## 2. 拉取依赖并构建
-在仓库根目录执行：
+### 环境准备
+
+- 安装 .NET SDK 10。
+- 桌面端建议在 Windows 上运行。
+
+### 构建
 
 ```bash
 dotnet restore
 dotnet build LanMountainDesktop.sln -c Debug
 ```
 
-## 3. 运行桌面端
+### 运行桌面端
+
 ```bash
 dotnet run --project LanMountainDesktop/LanMountainDesktop.csproj
 ```
 
-## 4. 推荐能力说明
-桌面端已内置推荐数据服务（每日诗词 / 每日名画），默认无需额外启动本地推荐后端。
+### 常见问题
 
-## 5. 常见问题
-- 启动失败提示 SDK 版本不匹配：确认 `dotnet --info` 中已安装 .NET 10 SDK。
-- 桌面端视频相关能力异常：优先在 Windows 环境下验证。
-- 配置重置：删除 `%LOCALAPPDATA%\LanMountainDesktop\settings.json` 后重启应用。
+- 如果提示 SDK 版本不匹配，先检查 `dotnet --info`。
+- 如果视频能力异常，优先在 Windows 环境验证。
+- 如果要重置配置，可删除 `%LOCALAPPDATA%\LanMountainDesktop\settings.json` 后重启。
 
-## 6. Linux 音频功能依赖
+### Linux 录音依赖
 
-如果在 Linux 上使用录音机组件或自习监测组件，需要安装以下音频库：
+如果在 Linux 上使用录音机或自习监测相关能力，需要安装音频库：
+
+- Debian/Ubuntu：`sudo apt install libportaudio2 libasound2`
+- Fedora/RHEL：`sudo dnf install portaudio-libs alsa-lib`
+- Arch Linux：`sudo pacman -S portaudio alsa-lib`
+- Alpine Linux：`sudo apk add portaudio alsa-lib`
+
+## English
+
+This guide explains how to run LanMountainDesktop locally.
+
+### Build
 
-### Debian/Ubuntu
 ```bash
-sudo apt install libportaudio2 libasound2
+dotnet restore
+dotnet build LanMountainDesktop.sln -c Debug
 ```
 
-### Fedora/RHEL
-```bash
-sudo dnf install portaudio-libs alsa-lib
-```
+### Run
 
-### Arch Linux
 ```bash
-sudo pacman -S portaudio alsa-lib
+dotnet run --project LanMountainDesktop/LanMountainDesktop.csproj
 ```
-
-### Alpine Linux
-```bash
-sudo apk add portaudio alsa-lib
-```
-
-> 注：如果未安装这些依赖，录音和自习监测功能将不可用，但应用其他功能可以正常运行。