0.5.10

多线程

.github/workflows/airappmarket-validate.yml

@@ -0,0 +1,27 @@
+name: AirAppMarket Validate
+
+on:
+  push:
+    paths:
+      - "airappmarket/**"
+      - ".github/workflows/airappmarket-validate.yml"
+  pull_request:
+    paths:
+      - "airappmarket/**"
+      - ".github/workflows/airappmarket-validate.yml"
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: "10.0.x"
+
+      - name: Validate AirAppMarket index
+        run: dotnet run --project airappmarket/tools/AirAppMarket.Validator -- airappmarket/index.json airappmarket/schema/airappmarket-index.schema.json

.gitignore

@@ -488,3 +488,7 @@ nul
 /_build_verify_plugin_tabs
 /_build_verify_sample_plugin
 /_build_verify_sample_plugin_capabilities
+/_build_verify_plugin_page_host
+/_build_verify_plugin_services
+/LanMountainDesktop.PluginSdk/_build_verify_*/
+/_build_obj

LanAirApp/README.md

@@ -0,0 +1,21 @@
+# LanAirApp
+
+## 中文
+
+`LanAirApp` 是阑山桌面插件生态的对外工作区。这个目录是宿主仓库中的镜像副本，权威版本以独立 `LanAirApp` 仓库为准。
+
+### 目录说明
+
+- `docs/`：插件开发与打包文档。
+- `samples/`：示例插件与参考项目。
+- `standards/`：插件清单和目录结构约定。
+- `tools/`：插件打包与辅助工具。
+
+### 与宿主的关系
+
+- 宿主程序只连接独立 `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

@@ -0,0 +1,16 @@
+# 插件开发指南
+
+## 中文
+
+使用 `LanMountainDesktop.PluginSdk` 开发插件时，至少需要准备：
+
+- `plugin.json`
+- 插件入口程序集
+- 入口类
+- 本地化资源
+
+推荐从示例插件开始，先完成清单、入口、设置页和桌面组件，再逐步扩展业务逻辑。
+
+## English
+
+To build a plugin with `LanMountainDesktop.PluginSdk`, prepare the manifest, plugin assembly, entrance class, and localization resources first.

LanAirApp/docs/PLUGIN_PACKAGING.md

@@ -0,0 +1,14 @@
+# 插件打包指南
+
+## 中文
+
+阑山桌面插件的标准安装格式为 `.laapp`。插件项目应在仓库根目录提供：
+
+- `.laapp` 安装包
+- `README.md`
+
+官方市场索引只负责记录链接和校验信息。
+
+## English
+
+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/samples/LanMountainDesktop.SamplePlugin/LanMountainDesktop.SamplePlugin.csproj

@@ -9,14 +9,15 @@
     <OutputPath>bin\$(Configuration)\$(TargetFramework)\content\</OutputPath>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
     <AppendRuntimeIdentifierToOutputPath>false</AppendRuntimeIdentifierToOutputPath>
-    <PluginPackageOutputDirectory>..\LanMountainDesktop\bin\$(Configuration)\$(TargetFramework)\Extensions\Plugins\</PluginPackageOutputDirectory>
+    <PluginPackageOutputDirectory>..\..\..\LanMountainDesktop\bin\$(Configuration)\$(TargetFramework)\Extensions\Plugins\</PluginPackageOutputDirectory>
     <PluginPackagePath>$(PluginPackageOutputDirectory)$(AssemblyName).laapp</PluginPackagePath>
-    <LegacyLoosePluginOutputDirectory>..\LanMountainDesktop\bin\$(Configuration)\$(TargetFramework)\Extensions\Plugins\SamplePlugin\</LegacyLoosePluginOutputDirectory>
+    <LegacyLoosePluginOutputDirectory>..\..\..\LanMountainDesktop\bin\$(Configuration)\$(TargetFramework)\Extensions\Plugins\SamplePlugin\</LegacyLoosePluginOutputDirectory>
   </PropertyGroup>
 
   <ItemGroup>
-    <ProjectReference Include="..\LanMountainDesktop.PluginSdk\LanMountainDesktop.PluginSdk.csproj" Private="false" />
+    <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">

LanAirApp/samples/LanMountainDesktop.SamplePlugin/Localization/en-US.json

@@ -0,0 +1,79 @@
+{
+  "settings.page_title": "Plugin Status",
+  "plugin.name": "LanMountain Sample Plugin",
+  "plugin.description": "Example plugin used to validate PluginSdk loading, services, communication, and localization.",
+  "widget.display_name": "Sample Plugin Status Clock",
+  "widget.category": "Plugins",
+  "settings.header.title": "Sample Plugin Capability Inspector",
+  "settings.section.info": "Plugin Info",
+  "settings.section.capabilities": "Accessible Capabilities",
+  "settings.section.status": "Live Runtime Status",
+  "settings.info.plugin_name": "Plugin Name",
+  "settings.info.plugin_id": "Plugin Id",
+  "settings.info.version": "Version",
+  "settings.info.author": "Author",
+  "settings.info.description": "Description",
+  "settings.info.plugin_directory": "Plugin Directory",
+  "settings.info.data_directory": "Data Directory",
+  "settings.info.host_application": "Host Application",
+  "settings.info.host_version": "Host Version",
+  "settings.info.sdk_api_version": "SDK API Version",
+  "settings.info.state_service_resolved": "State Service Resolved",
+  "settings.info.clock_service_resolved": "Clock Service Resolved",
+  "settings.info.message_bus_resolved": "Message Bus Resolved",
+  "settings.info.component_placed": "Component Placed",
+  "settings.info.placed_count": "Placed Count",
+  "settings.info.preview_count": "Preview Count",
+  "settings.info.placement_ids": "Placement Ids",
+  "settings.info.last_component_id": "Last Component Id",
+  "settings.info.last_cell_size": "Last Cell Size",
+  "settings.info.clock_service_time": "Clock Service Time",
+  "settings.status.updated_at": "Updated: {0}",
+  "status.frontend.title": "Frontend Status",
+  "status.component.title": "Component Status",
+  "status.backend.title": "Backend Status",
+  "status.service.title": "Clock Service",
+  "status.summary.pending": "Pending",
+  "status.summary.attached": "Attached",
+  "status.summary.healthy": "Healthy",
+  "status.summary.faulted": "Faulted",
+  "status.summary.placed": "Placed",
+  "status.summary.preview": "Preview",
+  "status.frontend.detail.pending": "Waiting for a plugin UI surface to connect.",
+  "status.frontend.detail.settings_connected": "Settings page is connected to plugin services and communication.",
+  "status.frontend.detail.widget_connected": "Widget surface is connected to plugin services and communication.",
+  "status.component.detail.pending": "No component instance has been created yet.",
+  "status.component.detail.none": "No component instance is active.",
+  "status.component.detail.preview": "Preview instances: {0}; no placed desktop instance is active yet.",
+  "status.component.detail.placed": "Placed count: {0}; preview count: {1}; placements: {2}",
+  "status.backend.detail.pending": "Plugin initialization is in progress.",
+  "status.backend.detail.log_written": "Initialization log written to: {0}",
+  "status.backend.detail.log_write_failed": "Initialization log write failed: {0}",
+  "status.service.detail.pending": "Clock service is not attached yet.",
+  "status.service.detail.attached": "Clock service was attached and is waiting for the first tick.",
+  "status.service.detail.running": "Clock service is running. Current service time: {0}",
+  "status.service.detail.write_failed": "Clock state write failed: {0}",
+  "capability.manifest.title": "IPluginContext.Manifest",
+  "capability.manifest.detail": "Readable. Current plugin id: {0}; version: {1}.",
+  "capability.directories.title": "IPluginContext.PluginDirectory / DataDirectory",
+  "capability.directories.detail": "Readable. Plugin directory: {0}; data directory: {1}.",
+  "capability.properties.title": "IPluginContext.Properties",
+  "capability.properties.detail": "Readable. Host properties currently exposed: {0}.",
+  "capability.get_service.title": "IPluginContext.GetService<T>()",
+  "capability.get_service.detail": "Callable. State service resolved: {0}; clock service resolved: {1}; message bus resolved: {2}.",
+  "capability.register_service.title": "IPluginContext.RegisterService<TService>()",
+  "capability.register_service.detail": "Callable during plugin initialization. This sample plugin registers SamplePluginRuntimeStateService and SamplePluginClockService into the plugin service container.",
+  "capability.message_bus.title": "Plugin Communication Bus",
+  "capability.message_bus.detail": "This sample plugin uses IPluginMessageBus to push clock ticks and state change notifications into plugin UI surfaces.",
+  "capability.widget_context.title": "PluginDesktopComponentContext",
+  "capability.widget_context.detail": "Widgets can read ComponentId, PlacementId, CellSize, and call GetService<T>() against the same plugin service container.",
+  "widget.subtitle.preview": "Preview surface | placed: {0}",
+  "widget.subtitle.placement": "Placement {0} | placed: {1}",
+  "common.dev": "dev",
+  "common.none": "(none)",
+  "common.unknown": "(unknown)",
+  "common.true": "true",
+  "common.false": "false",
+  "common.yes": "Yes",
+  "common.no": "No"
+}

LanAirApp/samples/LanMountainDesktop.SamplePlugin/Localization/zh-CN.json

@@ -0,0 +1,79 @@
+{
+  "settings.page_title": "插件状态",
+  "plugin.name": "阑山示例插件",
+  "plugin.description": "用于验证 PluginSdk 加载、服务、通信与本地化能力的示例插件。",
+  "widget.display_name": "示例插件状态时钟",
+  "widget.category": "插件",
+  "settings.header.title": "示例插件能力检查器",
+  "settings.section.info": "插件信息",
+  "settings.section.capabilities": "可访问能力",
+  "settings.section.status": "实时运行状态",
+  "settings.info.plugin_name": "插件名称",
+  "settings.info.plugin_id": "插件 Id",
+  "settings.info.version": "版本",
+  "settings.info.author": "作者",
+  "settings.info.description": "描述",
+  "settings.info.plugin_directory": "插件目录",
+  "settings.info.data_directory": "数据目录",
+  "settings.info.host_application": "宿主应用",
+  "settings.info.host_version": "宿主版本",
+  "settings.info.sdk_api_version": "SDK API 版本",
+  "settings.info.state_service_resolved": "状态服务已解析",
+  "settings.info.clock_service_resolved": "时钟服务已解析",
+  "settings.info.message_bus_resolved": "消息总线已解析",
+  "settings.info.component_placed": "组件是否已放置",
+  "settings.info.placed_count": "已放置数量",
+  "settings.info.preview_count": "预览数量",
+  "settings.info.placement_ids": "放置位置 Id",
+  "settings.info.last_component_id": "最近组件 Id",
+  "settings.info.last_cell_size": "最近单元尺寸",
+  "settings.info.clock_service_time": "时钟服务时间",
+  "settings.status.updated_at": "更新时间：{0}",
+  "status.frontend.title": "前端状态",
+  "status.component.title": "组件状态",
+  "status.backend.title": "后端状态",
+  "status.service.title": "时钟服务",
+  "status.summary.pending": "等待中",
+  "status.summary.attached": "已挂接",
+  "status.summary.healthy": "正常",
+  "status.summary.faulted": "异常",
+  "status.summary.placed": "已放置",
+  "status.summary.preview": "预览中",
+  "status.frontend.detail.pending": "等待插件界面接入。",
+  "status.frontend.detail.settings_connected": "设置页已接入插件服务与通信。",
+  "status.frontend.detail.widget_connected": "组件界面已接入插件服务与通信。",
+  "status.component.detail.pending": "当前还没有创建组件实例。",
+  "status.component.detail.none": "当前没有活动中的组件实例。",
+  "status.component.detail.preview": "当前预览实例数量：{0}；尚未有已放置的桌面实例。",
+  "status.component.detail.placed": "已放置数量：{0}；预览数量：{1}；放置位置：{2}",
+  "status.backend.detail.pending": "插件初始化进行中。",
+  "status.backend.detail.log_written": "初始化日志已写入：{0}",
+  "status.backend.detail.log_write_failed": "初始化日志写入失败：{0}",
+  "status.service.detail.pending": "时钟服务尚未挂接。",
+  "status.service.detail.attached": "时钟服务已挂接，正在等待第一次心跳。",
+  "status.service.detail.running": "时钟服务运行中，当前服务时间：{0}",
+  "status.service.detail.write_failed": "时钟状态写入失败：{0}",
+  "capability.manifest.title": "IPluginContext.Manifest",
+  "capability.manifest.detail": "可读取。当前插件 id：{0}；版本：{1}。",
+  "capability.directories.title": "IPluginContext.PluginDirectory / DataDirectory",
+  "capability.directories.detail": "可读取。插件目录：{0}；数据目录：{1}。",
+  "capability.properties.title": "IPluginContext.Properties",
+  "capability.properties.detail": "可读取。宿主当前暴露的属性：{0}。",
+  "capability.get_service.title": "IPluginContext.GetService<T>()",
+  "capability.get_service.detail": "可调用。状态服务已解析：{0}；时钟服务已解析：{1}；消息总线已解析：{2}。",
+  "capability.register_service.title": "IPluginContext.RegisterService<TService>()",
+  "capability.register_service.detail": "可在插件初始化阶段调用。这个示例插件会把 SamplePluginRuntimeStateService 和 SamplePluginClockService 注册进插件服务容器。",
+  "capability.message_bus.title": "插件通信总线",
+  "capability.message_bus.detail": "这个示例插件通过 IPluginMessageBus 向插件 UI 推送时钟心跳和状态变化通知。",
+  "capability.widget_context.title": "PluginDesktopComponentContext",
+  "capability.widget_context.detail": "组件可以读取 ComponentId、PlacementId、CellSize，并能在同一个插件服务容器上调用 GetService<T>()。",
+  "widget.subtitle.preview": "预览界面 | 已放置：{0}",
+  "widget.subtitle.placement": "位置 {0} | 已放置：{1}",
+  "common.dev": "开发版",
+  "common.none": "（无）",
+  "common.unknown": "（未知）",
+  "common.true": "是",
+  "common.false": "否",
+  "common.yes": "是",
+  "common.no": "否"
+}

LanAirApp/samples/LanMountainDesktop.SamplePlugin/README.md

@@ -0,0 +1,9 @@
+# LanMountainDesktop.SamplePlugin
+
+## 中文
+
+这是阑山桌面的标准示例插件，用于演示插件清单、设置页、桌面组件、服务注册、本地化和 `.laapp` 打包流程。
+
+## English
+
+This is the standard sample plugin used to demonstrate manifests, settings pages, desktop components, service registration, localization, and `.laapp` packaging.

LanAirApp/samples/LanMountainDesktop.SamplePlugin/SamplePlugin.cs

@@ -0,0 +1,92 @@
+using LanMountainDesktop.PluginSdk;
+
+namespace LanMountainDesktop.SamplePlugin;
+
+[PluginEntrance]
+public sealed class SamplePlugin : PluginBase, IDisposable
+{
+    private SamplePluginRuntimeStateService? _stateService;
+    private SamplePluginClockService? _clockService;
+
+    public override void Initialize(IPluginContext context)
+    {
+        Directory.CreateDirectory(context.DataDirectory);
+        var localizer = PluginLocalizer.Create(context);
+
+        var hostName = GetHostProperty(context, PluginHostPropertyKeys.HostApplicationName, "UnknownHost");
+        var hostVersion = GetHostProperty(context, PluginHostPropertyKeys.HostVersion, "UnknownVersion");
+        var sdkApiVersion = GetHostProperty(context, PluginHostPropertyKeys.PluginSdkApiVersion, "UnknownApiVersion");
+        var messageBus = context.GetService<IPluginMessageBus>()
+            ?? throw new InvalidOperationException("Plugin message bus is not available.");
+
+        _stateService = new SamplePluginRuntimeStateService(
+            context.Manifest,
+            context.PluginDirectory,
+            context.DataDirectory,
+            hostName,
+            hostVersion,
+            sdkApiVersion,
+            messageBus,
+            localizer);
+        context.RegisterService(_stateService);
+
+        _clockService = new SamplePluginClockService(context.DataDirectory, _stateService, messageBus, localizer);
+        context.RegisterService(_clockService);
+        _stateService.AttachClockService(_clockService);
+
+        var logPath = Path.Combine(context.DataDirectory, "sample-plugin.log");
+        var initMessage =
+            $"[{DateTimeOffset.UtcNow:O}] {context.Manifest.Name} initialized in {hostName} (plugin version {context.Manifest.Version ?? "dev"}).";
+
+        try
+        {
+            File.AppendAllText(logPath, initMessage + Environment.NewLine);
+            _stateService.MarkBackendReady(localizer.Format(
+                "status.backend.detail.log_written",
+                "初始化日志已写入：{0}",
+                logPath));
+        }
+        catch (Exception ex)
+        {
+            _stateService.MarkBackendFaulted(localizer.Format(
+                "status.backend.detail.log_write_failed",
+                "初始化日志写入失败：{0}",
+                ex.Message));
+            throw;
+        }
+
+        _clockService.Start();
+
+        context.RegisterSettingsPage(new PluginSettingsPageRegistration(
+            "status",
+            localizer.GetString("settings.page_title", "插件状态"),
+            () => new SamplePluginSettingsView(context)));
+
+        context.RegisterDesktopComponent(new PluginDesktopComponentRegistration(
+            "LanMountainDesktop.SamplePlugin.StatusClock",
+            localizer.GetString("widget.display_name", "示例插件状态时钟"),
+            widgetContext => new SamplePluginStatusClockWidget(widgetContext),
+            iconKey: "PuzzlePiece",
+            category: localizer.GetString("widget.category", "插件"),
+            minWidthCells: 4,
+            minHeightCells: 4,
+            allowDesktopPlacement: true,
+            allowStatusBarPlacement: false,
+            resizeMode: PluginDesktopComponentResizeMode.Proportional,
+            cornerRadiusResolver: cellSize => Math.Clamp(cellSize * 0.34, 18, 34)));
+    }
+
+    public void Dispose()
+    {
+        _clockService?.Dispose();
+        _clockService = null;
+        _stateService = null;
+    }
+
+    private static string GetHostProperty(IPluginContext context, string key, string fallback)
+    {
+        return context.TryGetProperty<string>(key, out var value) && !string.IsNullOrWhiteSpace(value)
+            ? value
+            : fallback;
+    }
+}

LanAirApp/samples/LanMountainDesktop.SamplePlugin/SamplePluginRuntimeStatus.cs

@@ -0,0 +1,524 @@
+using System.Globalization;
+using System.IO;
+using System.Linq;
+using System.Threading;
+using LanMountainDesktop.PluginSdk;
+
+namespace LanMountainDesktop.SamplePlugin;
+
+internal enum SamplePluginHealthState
+{
+    Healthy,
+    Pending,
+    Faulted
+}
+
+internal sealed record SamplePluginStatusEntry(
+    string Key,
+    string Title,
+    SamplePluginHealthState State,
+    string Summary,
+    string Detail,
+    DateTimeOffset UpdatedAt);
+
+internal sealed record SamplePluginCapabilityItem(
+    string Title,
+    string Detail);
+
+internal sealed record SamplePluginRuntimeSnapshot(
+    PluginManifest Manifest,
+    string PluginDirectory,
+    string DataDirectory,
+    string HostApplicationName,
+    string HostVersion,
+    string SdkApiVersion,
+    IReadOnlyList<SamplePluginStatusEntry> StatusEntries,
+    bool HasPlacedComponent,
+    int PlacedCount,
+    int PreviewCount,
+    IReadOnlyList<string> PlacementIds,
+    string? LastComponentId,
+    double LastCellSize,
+    DateTimeOffset? ServiceClockTime);
+
+internal sealed record SamplePluginClockTickMessage(DateTimeOffset CurrentTime);
+
+internal sealed record SamplePluginStateChangedMessage(string Reason);
+
+internal sealed record SamplePluginComponentInstance(
+    string ComponentId,
+    string? PlacementId,
+    double CellSize)
+{
+    public bool IsPlaced => !string.IsNullOrWhiteSpace(PlacementId);
+}
+
+internal sealed class SamplePluginRuntimeStateService
+{
+    private readonly object _gate = new();
+    private readonly IPluginMessageBus _messageBus;
+    private readonly Dictionary<string, SamplePluginComponentInstance> _componentInstances =
+        new(StringComparer.OrdinalIgnoreCase);
+
+    private readonly PluginManifest _manifest;
+    private readonly string _pluginDirectory;
+    private readonly string _dataDirectory;
+    private readonly string _hostApplicationName;
+    private readonly string _hostVersion;
+    private readonly string _sdkApiVersion;
+    private readonly PluginLocalizer _localizer;
+
+    private SamplePluginStatusEntry _frontend;
+    private SamplePluginStatusEntry _component;
+    private SamplePluginStatusEntry _backend;
+    private SamplePluginStatusEntry _service;
+    private string? _lastComponentId;
+    private double _lastCellSize;
+    private DateTimeOffset? _serviceClockTime;
+
+    public SamplePluginRuntimeStateService(
+        PluginManifest manifest,
+        string pluginDirectory,
+        string dataDirectory,
+        string hostApplicationName,
+        string hostVersion,
+        string sdkApiVersion,
+        IPluginMessageBus messageBus,
+        PluginLocalizer localizer)
+    {
+        _manifest = manifest;
+        _pluginDirectory = pluginDirectory;
+        _dataDirectory = dataDirectory;
+        _hostApplicationName = hostApplicationName;
+        _hostVersion = hostVersion;
+        _sdkApiVersion = sdkApiVersion;
+        _messageBus = messageBus;
+        _localizer = localizer;
+
+        _frontend = CreateEntry(
+            "frontend",
+            T("status.frontend.title", "前端状态"),
+            SamplePluginHealthState.Pending,
+            T("status.summary.pending", "等待中"),
+            T("status.frontend.detail.pending", "等待插件界面接入。"));
+
+        _component = CreateEntry(
+            "component",
+            T("status.component.title", "组件状态"),
+            SamplePluginHealthState.Pending,
+            T("status.summary.pending", "等待中"),
+            T("status.component.detail.pending", "当前还没有创建组件实例。"));
+
+        _backend = CreateEntry(
+            "backend",
+            T("status.backend.title", "后端状态"),
+            SamplePluginHealthState.Pending,
+            T("status.summary.pending", "等待中"),
+            T("status.backend.detail.pending", "插件初始化进行中。"));
+
+        _service = CreateEntry(
+            "service",
+            T("status.service.title", "时钟服务"),
+            SamplePluginHealthState.Pending,
+            T("status.summary.pending", "等待中"),
+            T("status.service.detail.pending", "时钟服务尚未挂接。"));
+    }
+
+    public void AttachClockService(SamplePluginClockService clockService)
+    {
+        ArgumentNullException.ThrowIfNull(clockService);
+
+        lock (_gate)
+        {
+            _serviceClockTime = clockService.CurrentTime;
+            _service = CreateEntry(
+                "service",
+                T("status.service.title", "时钟服务"),
+                SamplePluginHealthState.Pending,
+                T("status.summary.attached", "已挂接"),
+                T("status.service.detail.attached", "时钟服务已挂接，正在等待第一次心跳。"));
+        }
+
+        PublishStateChanged("Clock service attached");
+    }
+
+    public void MarkFrontendReady(string detail)
+    {
+        lock (_gate)
+        {
+            _frontend = CreateEntry(
+                "frontend",
+                T("status.frontend.title", "前端状态"),
+                SamplePluginHealthState.Healthy,
+                T("status.summary.healthy", "正常"),
+                detail);
+        }
+
+        PublishStateChanged("Frontend updated");
+    }
+
+    public void MarkBackendReady(string detail)
+    {
+        lock (_gate)
+        {
+            _backend = CreateEntry(
+                "backend",
+                T("status.backend.title", "后端状态"),
+                SamplePluginHealthState.Healthy,
+                T("status.summary.healthy", "正常"),
+                detail);
+        }
+
+        PublishStateChanged("Backend updated");
+    }
+
+    public void MarkBackendFaulted(string detail)
+    {
+        lock (_gate)
+        {
+            _backend = CreateEntry(
+                "backend",
+                T("status.backend.title", "后端状态"),
+                SamplePluginHealthState.Faulted,
+                T("status.summary.faulted", "异常"),
+                detail);
+        }
+
+        PublishStateChanged("Backend faulted");
+    }
+
+    public void MarkClockServiceTick(DateTimeOffset currentTime)
+    {
+        lock (_gate)
+        {
+            _serviceClockTime = currentTime;
+            _service = CreateEntry(
+                "service",
+                T("status.service.title", "时钟服务"),
+                SamplePluginHealthState.Healthy,
+                T("status.summary.healthy", "正常"),
+                Tf(
+                    "status.service.detail.running",
+                    "时钟服务运行中，当前服务时间：{0}",
+                    currentTime.LocalDateTime.ToString("HH:mm:ss")));
+        }
+
+        PublishStateChanged("Clock service tick");
+    }
+
+    public void MarkClockServiceFaulted(string detail)
+    {
+        lock (_gate)
+        {
+            _service = CreateEntry(
+                "service",
+                T("status.service.title", "时钟服务"),
+                SamplePluginHealthState.Faulted,
+                T("status.summary.faulted", "异常"),
+                detail);
+        }
+
+        PublishStateChanged("Clock service faulted");
+    }
+
+    public string RegisterComponentInstance(string componentId, string? placementId, double cellSize)
+    {
+        var instanceId = Guid.NewGuid().ToString("N");
+
+        lock (_gate)
+        {
+            _componentInstances[instanceId] = new SamplePluginComponentInstance(componentId, placementId, cellSize);
+            _lastComponentId = componentId;
+            _lastCellSize = cellSize;
+            UpdateComponentStatusNoLock();
+        }
+
+        PublishStateChanged("Component attached");
+        return instanceId;
+    }
+
+    public void UnregisterComponentInstance(string instanceId)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(instanceId);
+
+        var removed = false;
+        lock (_gate)
+        {
+            removed = _componentInstances.Remove(instanceId);
+            if (removed)
+            {
+                UpdateComponentStatusNoLock();
+            }
+        }
+
+        if (removed)
+        {
+            PublishStateChanged("Component detached");
+        }
+    }
+
+    public SamplePluginRuntimeSnapshot GetSnapshot()
+    {
+        lock (_gate)
+        {
+            var placementIds = _componentInstances.Values
+                .Where(instance => instance.IsPlaced)
+                .Select(instance => instance.PlacementId!)
+                .Distinct(StringComparer.OrdinalIgnoreCase)
+                .OrderBy(id => id, StringComparer.OrdinalIgnoreCase)
+                .ToArray();
+
+            var previewCount = _componentInstances.Values.Count(instance => !instance.IsPlaced);
+
+            return new SamplePluginRuntimeSnapshot(
+                _manifest,
+                _pluginDirectory,
+                _dataDirectory,
+                _hostApplicationName,
+                _hostVersion,
+                _sdkApiVersion,
+                [_frontend, _component, _backend, _service],
+                placementIds.Length > 0,
+                placementIds.Length,
+                previewCount,
+                placementIds,
+                _lastComponentId,
+                _lastCellSize,
+                _serviceClockTime);
+        }
+    }
+
+    public IReadOnlyList<SamplePluginCapabilityItem> GetCapabilities(
+        IPluginContext context,
+        bool hasStateService,
+        bool hasClockService,
+        bool hasMessageBus)
+    {
+        ArgumentNullException.ThrowIfNull(context);
+
+        var propertyNames = context.Properties.Count == 0
+            ? T("common.none", "（无）")
+            : string.Join(", ", context.Properties.Keys.OrderBy(key => key, StringComparer.OrdinalIgnoreCase));
+
+        return
+        [
+            new SamplePluginCapabilityItem(
+                T("capability.manifest.title", "IPluginContext.Manifest"),
+                Tf(
+                    "capability.manifest.detail",
+                    "可读取。当前插件 id：{0}；版本：{1}。",
+                    context.Manifest.Id,
+                    context.Manifest.Version ?? T("common.dev", "开发版"))),
+            new SamplePluginCapabilityItem(
+                T("capability.directories.title", "IPluginContext.PluginDirectory / DataDirectory"),
+                Tf(
+                    "capability.directories.detail",
+                    "可读取。插件目录：{0}；数据目录：{1}。",
+                    context.PluginDirectory,
+                    context.DataDirectory)),
+            new SamplePluginCapabilityItem(
+                T("capability.properties.title", "IPluginContext.Properties"),
+                Tf(
+                    "capability.properties.detail",
+                    "可读取。宿主当前暴露的属性：{0}。",
+                    propertyNames)),
+            new SamplePluginCapabilityItem(
+                T("capability.get_service.title", "IPluginContext.GetService<T>()"),
+                Tf(
+                    "capability.get_service.detail",
+                    "可调用。状态服务已解析：{0}；时钟服务已解析：{1}；消息总线已解析：{2}。",
+                    FormatBoolean(hasStateService),
+                    FormatBoolean(hasClockService),
+                    FormatBoolean(hasMessageBus))),
+            new SamplePluginCapabilityItem(
+                T("capability.register_service.title", "IPluginContext.RegisterService<TService>()"),
+                T(
+                    "capability.register_service.detail",
+                    "可在插件初始化阶段调用。这个示例插件会把 SamplePluginRuntimeStateService 和 SamplePluginClockService 注册进插件服务容器。")),
+            new SamplePluginCapabilityItem(
+                T("capability.message_bus.title", "插件通信总线"),
+                T(
+                    "capability.message_bus.detail",
+                    "这个示例插件通过 IPluginMessageBus 向插件 UI 推送时钟心跳和状态变化通知。")),
+            new SamplePluginCapabilityItem(
+                T("capability.widget_context.title", "PluginDesktopComponentContext"),
+                T(
+                    "capability.widget_context.detail",
+                    "组件可以读取 ComponentId、PlacementId、CellSize，并能在同一个插件服务容器上调用 GetService<T>()。"))
+        ];
+    }
+
+    private void UpdateComponentStatusNoLock()
+    {
+        var placementIds = _componentInstances.Values
+            .Where(instance => instance.IsPlaced)
+            .Select(instance => instance.PlacementId!)
+            .Distinct(StringComparer.OrdinalIgnoreCase)
+            .OrderBy(id => id, StringComparer.OrdinalIgnoreCase)
+            .ToArray();
+
+        var previewCount = _componentInstances.Values.Count(instance => !instance.IsPlaced);
+
+        if (placementIds.Length > 0)
+        {
+            _component = CreateEntry(
+                "component",
+                T("status.component.title", "组件状态"),
+                SamplePluginHealthState.Healthy,
+                T("status.summary.placed", "已放置"),
+                Tf(
+                    "status.component.detail.placed",
+                    "已放置数量：{0}；预览数量：{1}；放置位置：{2}",
+                    placementIds.Length,
+                    previewCount,
+                    string.Join(", ", placementIds)));
+            return;
+        }
+
+        if (previewCount > 0)
+        {
+            _component = CreateEntry(
+                "component",
+                T("status.component.title", "组件状态"),
+                SamplePluginHealthState.Healthy,
+                T("status.summary.preview", "预览中"),
+                Tf(
+                    "status.component.detail.preview",
+                    "当前预览实例数量：{0}；尚未有已放置的桌面实例。",
+                    previewCount));
+            return;
+        }
+
+        _component = CreateEntry(
+            "component",
+            T("status.component.title", "组件状态"),
+            SamplePluginHealthState.Pending,
+            T("status.summary.pending", "等待中"),
+            T("status.component.detail.none", "当前没有活动中的组件实例。"));
+    }
+
+    private void PublishStateChanged(string reason)
+    {
+        _messageBus.Publish(new SamplePluginStateChangedMessage(reason));
+    }
+
+    private static SamplePluginStatusEntry CreateEntry(
+        string key,
+        string title,
+        SamplePluginHealthState state,
+        string summary,
+        string detail)
+    {
+        return new SamplePluginStatusEntry(
+            key,
+            title,
+            state,
+            summary,
+            detail,
+            DateTimeOffset.Now);
+    }
+
+    private string T(string key, string fallback)
+    {
+        return _localizer.GetString(key, fallback);
+    }
+
+    private string Tf(string key, string fallback, params object[] args)
+    {
+        return _localizer.Format(key, fallback, args);
+    }
+
+    private string FormatBoolean(bool value)
+    {
+        return value
+            ? T("common.true", "是")
+            : T("common.false", "否");
+    }
+}
+
+internal sealed class SamplePluginClockService : IDisposable
+{
+    private readonly object _gate = new();
+    private readonly string _clockStateFilePath;
+    private readonly SamplePluginRuntimeStateService _stateService;
+    private readonly IPluginMessageBus _messageBus;
+    private readonly PluginLocalizer _localizer;
+    private readonly Timer _timer;
+    private DateTimeOffset _currentTime = DateTimeOffset.Now;
+    private int _disposed;
+
+    public SamplePluginClockService(
+        string dataDirectory,
+        SamplePluginRuntimeStateService stateService,
+        IPluginMessageBus messageBus,
+        PluginLocalizer localizer)
+    {
+        _clockStateFilePath = Path.Combine(dataDirectory, "clock-service.txt");
+        _stateService = stateService;
+        _messageBus = messageBus;
+        _localizer = localizer;
+        _timer = new Timer(OnTimerTick);
+    }
+
+    public DateTimeOffset CurrentTime
+    {
+        get
+        {
+            lock (_gate)
+            {
+                return _currentTime;
+            }
+        }
+    }
+
+    public void Start()
+    {
+        PublishTick();
+        _timer.Change(TimeSpan.FromSeconds(1), TimeSpan.FromSeconds(1));
+    }
+
+    public void Dispose()
+    {
+        if (Interlocked.Exchange(ref _disposed, 1) != 0)
+        {
+            return;
+        }
+
+        _timer.Dispose();
+    }
+
+    private void OnTimerTick(object? state)
+    {
+        PublishTick();
+    }
+
+    private void PublishTick()
+    {
+        if (Volatile.Read(ref _disposed) != 0)
+        {
+            return;
+        }
+
+        var now = DateTimeOffset.Now;
+        lock (_gate)
+        {
+            _currentTime = now;
+        }
+
+        try
+        {
+            File.WriteAllText(
+                _clockStateFilePath,
+                now.ToString("O", CultureInfo.InvariantCulture));
+            _stateService.MarkClockServiceTick(now);
+            _messageBus.Publish(new SamplePluginClockTickMessage(now));
+        }
+        catch (Exception ex)
+        {
+            _stateService.MarkClockServiceFaulted(_localizer.Format(
+                "status.service.detail.write_failed",
+                "时钟状态写入失败：{0}",
+                ex.Message));
+        }
+    }
+}

LanAirApp/samples/LanMountainDesktop.SamplePlugin/SamplePluginSettingsView.cs

@@ -0,0 +1,374 @@
+using Avalonia;
+using Avalonia.Controls;
+using Avalonia.Layout;
+using Avalonia.Media;
+using Avalonia.Threading;
+using LanMountainDesktop.PluginSdk;
+
+namespace LanMountainDesktop.SamplePlugin;
+
+internal sealed class SamplePluginSettingsView : UserControl
+{
+    private readonly IPluginContext _context;
+    private readonly PluginLocalizer _localizer;
+    private readonly SamplePluginRuntimeStateService _stateService;
+    private readonly SamplePluginClockService _clockService;
+    private readonly IPluginMessageBus _messageBus;
+    private readonly StackPanel _pluginInfoPanel = new() { Spacing = 8 };
+    private readonly StackPanel _capabilityPanel = new() { Spacing = 8 };
+    private readonly StackPanel _statusPanel = new() { Spacing = 10 };
+    private readonly List<IDisposable> _subscriptions = [];
+
+    public SamplePluginSettingsView(IPluginContext context)
+    {
+        _context = context;
+        _localizer = PluginLocalizer.Create(context);
+        _stateService = context.GetService<SamplePluginRuntimeStateService>()
+            ?? throw new InvalidOperationException("SamplePluginRuntimeStateService is not available.");
+        _clockService = context.GetService<SamplePluginClockService>()
+            ?? throw new InvalidOperationException("SamplePluginClockService is not available.");
+        _messageBus = context.GetService<IPluginMessageBus>()
+            ?? throw new InvalidOperationException("IPluginMessageBus is not available.");
+
+        _stateService.MarkFrontendReady(T(
+            "status.frontend.detail.settings_connected",
+            "设置页已接入插件服务与通信。"));
+
+        AttachedToVisualTree += OnAttachedToVisualTree;
+        DetachedFromVisualTree += OnDetachedFromVisualTree;
+
+        Content = new Border
+        {
+            Background = new LinearGradientBrush
+            {
+                StartPoint = new RelativePoint(0, 0, RelativeUnit.Relative),
+                EndPoint = new RelativePoint(1, 1, RelativeUnit.Relative),
+                GradientStops =
+                [
+                    new GradientStop(Color.Parse("#1F0B1120"), 0),
+                    new GradientStop(Color.Parse("#260C4A6E"), 1)
+                ]
+            },
+            BorderBrush = new SolidColorBrush(Color.Parse("#6628B2FF")),
+            BorderThickness = new Thickness(1),
+            CornerRadius = new CornerRadius(18),
+            Padding = new Thickness(18),
+            Child = new StackPanel
+            {
+                Spacing = 14,
+                Children =
+                {
+                    new TextBlock
+                    {
+                        Text = T("settings.header.title", "示例插件能力检查器"),
+                        FontSize = 22,
+                        FontWeight = FontWeight.SemiBold,
+                        Foreground = Brushes.White
+                    },
+                    CreateSection(T("settings.section.info", "插件信息"), _pluginInfoPanel),
+                    CreateSection(T("settings.section.capabilities", "可访问能力"), _capabilityPanel),
+                    CreateSection(T("settings.section.status", "实时运行状态"), _statusPanel)
+                }
+            }
+        };
+
+        RefreshView();
+    }
+
+    private void OnAttachedToVisualTree(object? sender, VisualTreeAttachmentEventArgs e)
+    {
+        SubscribeToPluginBus();
+        RefreshView();
+    }
+
+    private void OnDetachedFromVisualTree(object? sender, VisualTreeAttachmentEventArgs e)
+    {
+        foreach (var subscription in _subscriptions)
+        {
+            subscription.Dispose();
+        }
+
+        _subscriptions.Clear();
+    }
+
+    private void SubscribeToPluginBus()
+    {
+        if (_subscriptions.Count > 0)
+        {
+            return;
+        }
+
+        _subscriptions.Add(_messageBus.Subscribe<SamplePluginClockTickMessage>(_ =>
+            Dispatcher.UIThread.Post(RefreshView)));
+
+        _subscriptions.Add(_messageBus.Subscribe<SamplePluginStateChangedMessage>(_ =>
+            Dispatcher.UIThread.Post(RefreshView)));
+    }
+
+    private void RefreshView()
+    {
+        var snapshot = _stateService.GetSnapshot();
+        RefreshPluginInfo(snapshot);
+        RefreshCapabilities();
+        RefreshStatuses(snapshot);
+    }
+
+    private void RefreshPluginInfo(SamplePluginRuntimeSnapshot snapshot)
+    {
+        _pluginInfoPanel.Children.Clear();
+        _pluginInfoPanel.Children.Add(CreateInfoLine(
+            T("settings.info.plugin_name", "插件名称"),
+            T("plugin.name", snapshot.Manifest.Name)));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(T("settings.info.plugin_id", "插件 Id"), snapshot.Manifest.Id));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(T("settings.info.version", "版本"), snapshot.Manifest.Version ?? T("common.dev", "开发版")));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(T("settings.info.author", "作者"), snapshot.Manifest.Author ?? T("common.none", "（无）")));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(
+            T("settings.info.description", "描述"),
+            T("plugin.description", snapshot.Manifest.Description ?? T("common.none", "（无）"))));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(T("settings.info.plugin_directory", "插件目录"), snapshot.PluginDirectory));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(T("settings.info.data_directory", "数据目录"), snapshot.DataDirectory));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(T("settings.info.host_application", "宿主应用"), snapshot.HostApplicationName));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(T("settings.info.host_version", "宿主版本"), snapshot.HostVersion));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(T("settings.info.sdk_api_version", "SDK API 版本"), snapshot.SdkApiVersion));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(
+            T("settings.info.state_service_resolved", "状态服务已解析"),
+            FormatBoolean(_context.GetService<SamplePluginRuntimeStateService>() is not null)));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(
+            T("settings.info.clock_service_resolved", "时钟服务已解析"),
+            FormatBoolean(_context.GetService<SamplePluginClockService>() is not null)));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(
+            T("settings.info.message_bus_resolved", "消息总线已解析"),
+            FormatBoolean(_context.GetService<IPluginMessageBus>() is not null)));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(
+            T("settings.info.component_placed", "组件是否已放置"),
+            snapshot.HasPlacedComponent ? T("common.yes", "是") : T("common.no", "否")));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(T("settings.info.placed_count", "已放置数量"), snapshot.PlacedCount.ToString()));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(T("settings.info.preview_count", "预览数量"), snapshot.PreviewCount.ToString()));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(
+            T("settings.info.placement_ids", "放置位置 Id"),
+            snapshot.PlacementIds.Count == 0 ? T("common.none", "（无）") : string.Join(", ", snapshot.PlacementIds)));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(
+            T("settings.info.last_component_id", "最近组件 Id"),
+            snapshot.LastComponentId ?? T("common.none", "（无）")));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(
+            T("settings.info.last_cell_size", "最近单元尺寸"),
+            snapshot.LastCellSize > 0 ? $"{snapshot.LastCellSize:F0}px" : T("common.unknown", "（未知）")));
+        _pluginInfoPanel.Children.Add(CreateInfoLine(
+            T("settings.info.clock_service_time", "时钟服务时间"),
+            _clockService.CurrentTime.LocalDateTime.ToString("HH:mm:ss")));
+    }
+
+    private void RefreshCapabilities()
+    {
+        var capabilities = _stateService.GetCapabilities(
+            _context,
+            _context.GetService<SamplePluginRuntimeStateService>() is not null,
+            _context.GetService<SamplePluginClockService>() is not null,
+            _context.GetService<IPluginMessageBus>() is not null);
+
+        _capabilityPanel.Children.Clear();
+        foreach (var capability in capabilities)
+        {
+            _capabilityPanel.Children.Add(CreateCapabilityCard(capability));
+        }
+    }
+
+    private void RefreshStatuses(SamplePluginRuntimeSnapshot snapshot)
+    {
+        _statusPanel.Children.Clear();
+
+        foreach (var entry in snapshot.StatusEntries)
+        {
+            var palette = GetPalette(entry.State);
+            _statusPanel.Children.Add(new Border
+            {
+                Background = new SolidColorBrush(palette.Background),
+                BorderBrush = new SolidColorBrush(palette.Border),
+                BorderThickness = new Thickness(1),
+                CornerRadius = new CornerRadius(12),
+                Padding = new Thickness(12, 10),
+                Child = new StackPanel
+                {
+                    Spacing = 4,
+                    Children =
+                    {
+                        CreateStatusHeader(entry, palette),
+                        new TextBlock
+                        {
+                            Text = entry.Detail,
+                            Foreground = new SolidColorBrush(Color.Parse("#FFE0F2FE")),
+                            TextWrapping = TextWrapping.Wrap
+                        },
+                        new TextBlock
+                        {
+                            Text = Tf("settings.status.updated_at", "更新时间：{0}", entry.UpdatedAt.LocalDateTime.ToString("HH:mm:ss")),
+                            Foreground = new SolidColorBrush(Color.Parse("#FF93C5FD"))
+                        }
+                    }
+                }
+            });
+        }
+    }
+
+    private Border CreateSection(string title, Control content)
+    {
+        return new Border
+        {
+            Background = new SolidColorBrush(Color.Parse("#14000000")),
+            BorderBrush = new SolidColorBrush(Color.Parse("#3328B2FF")),
+            BorderThickness = new Thickness(1),
+            CornerRadius = new CornerRadius(14),
+            Padding = new Thickness(14),
+            Child = new StackPanel
+            {
+                Spacing = 12,
+                Children =
+                {
+                    new TextBlock
+                    {
+                        Text = title,
+                        FontSize = 16,
+                        FontWeight = FontWeight.SemiBold,
+                        Foreground = Brushes.White
+                    },
+                    content
+                }
+            }
+        };
+    }
+
+    private Control CreateInfoLine(string label, string value)
+    {
+        var grid = new Grid
+        {
+            ColumnDefinitions = new ColumnDefinitions("180,*"),
+            ColumnSpacing = 10
+        };
+
+        var labelText = new TextBlock
+        {
+            Text = label,
+            Foreground = new SolidColorBrush(Color.Parse("#FFBAE6FD")),
+            FontWeight = FontWeight.SemiBold,
+            TextWrapping = TextWrapping.Wrap
+        };
+        var valueText = new TextBlock
+        {
+            Text = value,
+            Foreground = Brushes.White,
+            TextWrapping = TextWrapping.Wrap
+        };
+
+        grid.Children.Add(labelText);
+        grid.Children.Add(valueText);
+        Grid.SetColumn(valueText, 1);
+        return grid;
+    }
+
+    private Control CreateCapabilityCard(SamplePluginCapabilityItem item)
+    {
+        return new Border
+        {
+            Background = new SolidColorBrush(Color.Parse("#0F082F49")),
+            BorderBrush = new SolidColorBrush(Color.Parse("#3338BDF8")),
+            BorderThickness = new Thickness(1),
+            CornerRadius = new CornerRadius(12),
+            Padding = new Thickness(12, 10),
+            Child = new StackPanel
+            {
+                Spacing = 4,
+                Children =
+                {
+                    new TextBlock
+                    {
+                        Text = item.Title,
+                        Foreground = Brushes.White,
+                        FontWeight = FontWeight.SemiBold
+                    },
+                    new TextBlock
+                    {
+                        Text = item.Detail,
+                        Foreground = new SolidColorBrush(Color.Parse("#FFE0F2FE")),
+                        TextWrapping = TextWrapping.Wrap
+                    }
+                }
+            }
+        };
+    }
+
+    private static Control CreateStatusHeader(
+        SamplePluginStatusEntry entry,
+        (Color Background, Color Border, Color Dot) palette)
+    {
+        var grid = new Grid
+        {
+            ColumnDefinitions = new ColumnDefinitions("Auto,*,Auto"),
+            ColumnSpacing = 8
+        };
+
+        var dot = new Border
+        {
+            Width = 10,
+            Height = 10,
+            CornerRadius = new CornerRadius(999),
+            Background = new SolidColorBrush(palette.Dot),
+            VerticalAlignment = VerticalAlignment.Center
+        };
+        var title = new TextBlock
+        {
+            Text = entry.Title,
+            FontSize = 15,
+            FontWeight = FontWeight.SemiBold,
+            Foreground = Brushes.White
+        };
+        var summary = new TextBlock
+        {
+            Text = entry.Summary,
+            Foreground = new SolidColorBrush(Color.Parse("#FFD7F2FF")),
+            HorizontalAlignment = HorizontalAlignment.Right
+        };
+
+        grid.Children.Add(dot);
+        grid.Children.Add(title);
+        grid.Children.Add(summary);
+        Grid.SetColumn(title, 1);
+        Grid.SetColumn(summary, 2);
+        return grid;
+    }
+
+    private static (Color Background, Color Border, Color Dot) GetPalette(SamplePluginHealthState state)
+    {
+        return state switch
+        {
+            SamplePluginHealthState.Healthy => (
+                Color.Parse("#1F115E59"),
+                Color.Parse("#665EEAD4"),
+                Color.Parse("#5EEAD4")),
+            SamplePluginHealthState.Faulted => (
+                Color.Parse("#291B1B"),
+                Color.Parse("#66F87171"),
+                Color.Parse("#F87171")),
+            _ => (
+                Color.Parse("#2B3A2A0D"),
+                Color.Parse("#66FBBF24"),
+                Color.Parse("#FBBF24"))
+        };
+    }
+
+    private string T(string key, string fallback)
+    {
+        return _localizer.GetString(key, fallback);
+    }
+
+    private string Tf(string key, string fallback, params object[] args)
+    {
+        return _localizer.Format(key, fallback, args);
+    }
+
+    private string FormatBoolean(bool value)
+    {
+        return value
+            ? T("common.true", "是")
+            : T("common.false", "否");
+    }
+}

LanAirApp/samples/LanMountainDesktop.SamplePlugin/SamplePluginStatusClockWidget.cs

@@ -9,35 +9,52 @@ namespace LanMountainDesktop.SamplePlugin;
 
 internal sealed class SamplePluginStatusClockWidget : Border
 {
-    private readonly DispatcherTimer _timer = new()
-    {
-        Interval = TimeSpan.FromSeconds(1)
-    };
-
     private readonly PluginDesktopComponentContext _context;
+    private readonly PluginLocalizer _localizer;
+    private readonly SamplePluginRuntimeStateService _stateService;
+    private readonly SamplePluginClockService _clockService;
+    private readonly IPluginMessageBus _messageBus;
     private readonly TextBlock _timeTextBlock;
-    private readonly TextBlock _titleTextBlock;
+    private readonly TextBlock _subtitleTextBlock;
     private readonly StackPanel _statusPanel;
+    private readonly Border _statusHost;
+    private readonly List<IDisposable> _subscriptions = [];
+    private string? _instanceId;
 
     public SamplePluginStatusClockWidget(PluginDesktopComponentContext context)
     {
         _context = context;
+        _localizer = PluginLocalizer.Create(context);
+        _stateService = context.GetService<SamplePluginRuntimeStateService>()
+            ?? throw new InvalidOperationException("SamplePluginRuntimeStateService is not available.");
+        _clockService = context.GetService<SamplePluginClockService>()
+            ?? throw new InvalidOperationException("SamplePluginClockService is not available.");
+        _messageBus = context.GetService<IPluginMessageBus>()
+            ?? throw new InvalidOperationException("IPluginMessageBus is not available.");
+
         _timeTextBlock = new TextBlock
         {
             Foreground = Brushes.White,
             FontWeight = FontWeight.Bold,
             HorizontalAlignment = HorizontalAlignment.Left
         };
-        _titleTextBlock = new TextBlock
+        _subtitleTextBlock = new TextBlock
         {
-            Text = "Plugin Status",
             Foreground = new SolidColorBrush(Color.Parse("#FFBFE9FF")),
-            HorizontalAlignment = HorizontalAlignment.Left
+            HorizontalAlignment = HorizontalAlignment.Left,
+            TextWrapping = TextWrapping.Wrap
         };
         _statusPanel = new StackPanel
         {
             Spacing = 8
         };
+        _statusHost = new Border
+        {
+            Background = new SolidColorBrush(Color.Parse("#1F082F49")),
+            BorderBrush = new SolidColorBrush(Color.Parse("#5538BDF8")),
+            BorderThickness = new Thickness(1),
+            Child = _statusPanel
+        };
 
         Background = new LinearGradientBrush
         {
@@ -67,55 +84,61 @@ internal sealed class SamplePluginStatusClockWidget : Border
                     Children =
                     {
                         _timeTextBlock,
-                        _titleTextBlock
+                        _subtitleTextBlock
                     }
                 },
-                new Border
-                {
-                    Background = new SolidColorBrush(Color.Parse("#1F082F49")),
-                    BorderBrush = new SolidColorBrush(Color.Parse("#5538BDF8")),
-                    BorderThickness = new Thickness(1),
-                    CornerRadius = new CornerRadius(18),
-                    Padding = new Thickness(12),
-                    Child = _statusPanel
-                }
+                _statusHost
             }
         };
 
         Grid.SetRow(((Grid)Child).Children[1], 1);
 
-        _timer.Tick += OnTimerTick;
         AttachedToVisualTree += OnAttachedToVisualTree;
         DetachedFromVisualTree += OnDetachedFromVisualTree;
         SizeChanged += OnSizeChanged;
 
-        var placementText = string.IsNullOrWhiteSpace(context.PlacementId)
-            ? "Preview instance created."
-            : $"Widget created for placement {context.PlacementId}.";
-        SamplePluginRuntimeStatus.MarkFrontendReady("Widget frontend surface rendered successfully.");
-        SamplePluginRuntimeStatus.MarkComponentCreated($"{placementText} Baseline footprint: 4x4.");
-
-        RefreshClock();
+        RefreshClock(_clockService.CurrentTime);
+        UpdateSubtitle();
         RefreshStatusPanel();
         ApplyScale();
     }
 
     private void OnAttachedToVisualTree(object? sender, VisualTreeAttachmentEventArgs e)
     {
-        RefreshClock();
+        if (string.IsNullOrWhiteSpace(_instanceId))
+        {
+            _instanceId = _stateService.RegisterComponentInstance(
+                _context.ComponentId,
+                _context.PlacementId,
+                _context.CellSize);
+        }
+
+        _stateService.MarkFrontendReady(T(
+            "status.frontend.detail.widget_connected",
+            "组件界面已接入插件服务与通信。"));
+        SubscribeToPluginBus();
+
+        RefreshClock(_clockService.CurrentTime);
+        UpdateSubtitle();
         RefreshStatusPanel();
-        _timer.Start();
     }
 
     private void OnDetachedFromVisualTree(object? sender, VisualTreeAttachmentEventArgs e)
     {
-        _timer.Stop();
-    }
+        foreach (var subscription in _subscriptions)
+        {
+            subscription.Dispose();
+        }
 
-    private void OnTimerTick(object? sender, EventArgs e)
-    {
-        RefreshClock();
-        RefreshStatusPanel();
+        _subscriptions.Clear();
+
+        if (string.IsNullOrWhiteSpace(_instanceId))
+        {
+            return;
+        }
+
+        _stateService.UnregisterComponentInstance(_instanceId);
+        _instanceId = null;
     }
 
     private void OnSizeChanged(object? sender, SizeChangedEventArgs e)
@@ -124,24 +147,49 @@ internal sealed class SamplePluginStatusClockWidget : Border
         RefreshStatusPanel();
     }
 
-    private void RefreshClock()
+    private void SubscribeToPluginBus()
     {
-        _timeTextBlock.Text = DateTime.Now.ToString("HH:mm:ss");
+        if (_subscriptions.Count > 0)
+        {
+            return;
+        }
+
+        _subscriptions.Add(_messageBus.Subscribe<SamplePluginClockTickMessage>(message =>
+            Dispatcher.UIThread.Post(() => RefreshClock(message.CurrentTime))));
+
+        _subscriptions.Add(_messageBus.Subscribe<SamplePluginStateChangedMessage>(_ =>
+            Dispatcher.UIThread.Post(() =>
+            {
+                UpdateSubtitle();
+                RefreshStatusPanel();
+            })));
+    }
+
+    private void RefreshClock(DateTimeOffset currentTime)
+    {
+        _timeTextBlock.Text = currentTime.LocalDateTime.ToString("HH:mm:ss");
+    }
+
+    private void UpdateSubtitle()
+    {
+        var snapshot = _stateService.GetSnapshot();
+        _subtitleTextBlock.Text = string.IsNullOrWhiteSpace(_context.PlacementId)
+            ? Tf("widget.subtitle.preview", "预览界面 | 已放置：{0}", snapshot.PlacedCount)
+            : Tf("widget.subtitle.placement", "位置 {0} | 已放置：{1}", _context.PlacementId!, snapshot.PlacedCount);
     }
 
     private void RefreshStatusPanel()
     {
         _statusPanel.Children.Clear();
 
+        var snapshot = _stateService.GetSnapshot();
         var basis = GetLayoutBasis();
-        var titleSize = Math.Clamp(basis * 0.072, 11, 16);
-        var detailSize = Math.Clamp(basis * 0.055, 10, 13);
+        var titleSize = Math.Clamp(basis * 0.068, 11, 16);
+        var detailSize = Math.Clamp(basis * 0.052, 9, 13);
 
-        foreach (var entry in SamplePluginRuntimeStatus.GetSnapshot())
+        foreach (var entry in snapshot.StatusEntries)
         {
             var palette = GetPalette(entry.State);
-            var summaryText = $"{entry.Summary} - {entry.UpdatedAt.LocalDateTime:HH:mm:ss}";
-
             _statusPanel.Children.Add(new Border
             {
                 Background = new SolidColorBrush(palette.Background),
@@ -151,6 +199,7 @@ internal sealed class SamplePluginStatusClockWidget : Border
                 Padding = new Thickness(10, 8),
                 Child = new Grid
                 {
+                    RowDefinitions = new RowDefinitions("Auto,Auto"),
                     ColumnDefinitions = new ColumnDefinitions("Auto,*,Auto"),
                     ColumnSpacing = 8,
                     Children =
@@ -173,12 +222,19 @@ internal sealed class SamplePluginStatusClockWidget : Border
                         },
                         new TextBlock
                         {
-                            Text = summaryText,
+                            Text = entry.Summary,
                             FontSize = detailSize,
                             Foreground = new SolidColorBrush(Color.Parse("#FFD7F2FF")),
                             HorizontalAlignment = HorizontalAlignment.Right,
                             TextAlignment = TextAlignment.Right,
                             VerticalAlignment = VerticalAlignment.Center
+                        },
+                        new TextBlock
+                        {
+                            Text = entry.Detail,
+                            FontSize = detailSize,
+                            Foreground = new SolidColorBrush(Color.Parse("#FFD7F2FF")),
+                            TextWrapping = TextWrapping.Wrap
                         }
                     }
                 }
@@ -187,6 +243,8 @@ internal sealed class SamplePluginStatusClockWidget : Border
             var row = (Grid)((Border)_statusPanel.Children[^1]).Child!;
             Grid.SetColumn(row.Children[1], 1);
             Grid.SetColumn(row.Children[2], 2);
+            Grid.SetColumnSpan(row.Children[3], 3);
+            Grid.SetRow(row.Children[3], 1);
         }
     }
 
@@ -196,7 +254,10 @@ internal sealed class SamplePluginStatusClockWidget : Border
         Padding = new Thickness(Math.Clamp(basis * 0.09, 16, 26));
         CornerRadius = new CornerRadius(Math.Clamp(basis * 0.14, 20, 34));
         _timeTextBlock.FontSize = Math.Clamp(basis * 0.22, 30, 58);
-        _titleTextBlock.FontSize = Math.Clamp(basis * 0.07, 12, 18);
+        _subtitleTextBlock.FontSize = Math.Clamp(basis * 0.062, 11, 17);
+        _statusHost.Padding = new Thickness(Math.Clamp(basis * 0.045, 10, 18));
+        _statusHost.CornerRadius = new CornerRadius(Math.Clamp(basis * 0.09, 14, 22));
+        _statusPanel.Spacing = Math.Clamp(basis * 0.024, 6, 10);
     }
 
     private double GetLayoutBasis()
@@ -224,4 +285,14 @@ internal sealed class SamplePluginStatusClockWidget : Border
                 Color.Parse("#FDBA74"))
         };
     }
+
+    private string T(string key, string fallback)
+    {
+        return _localizer.GetString(key, fallback);
+    }
+
+    private string Tf(string key, string fallback, params object[] args)
+    {
+        return _localizer.Format(key, fallback, args);
+    }
 }

LanAirApp/samples/README.md

@@ -0,0 +1,11 @@
+# 示例插件目录
+
+## 中文
+
+本目录用于存放阑山桌面的示例插件和参考实现。
+
+当前标准示例为 `LanMountainDesktop.SamplePlugin`。
+
+## English
+
+This directory stores sample plugins and reference implementations. The current standard sample is `LanMountainDesktop.SamplePlugin`.

LanAirApp/standards/README.md

@@ -0,0 +1,9 @@
+# 插件标准说明
+
+## 中文
+
+本目录存放插件开发需要遵循的基础约定，包括 `.laapp`、`plugin.json`、`Localization/` 以及仓库根目录 README 和安装包等要求。
+
+## English
+
+This directory stores the baseline conventions for plugin development, including `.laapp`, `plugin.json`, `Localization/`, and repository-root deliverables.

LanAirApp/standards/plugin.template.json

@@ -0,0 +1,9 @@
+{
+  "id": "LanMountainDesktop.YourPlugin",
+  "name": "Your Plugin",
+  "description": "Describe what your plugin adds to LanMountainDesktop.",
+  "author": "Your Name",
+  "version": "1.0.0",
+  "apiVersion": "1.0.0",
+  "entranceAssembly": "LanMountainDesktop.YourPlugin.dll"
+}

LanAirApp/tools/LanMountainDesktop.PluginPackager/LanMountainDesktop.PluginPackager.csproj

@@ -0,0 +1,15 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <Version>1.0.0</Version>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\..\LanMountainDesktop.PluginSdk\LanMountainDesktop.PluginSdk.csproj" />
+  </ItemGroup>
+
+</Project>

LanAirApp/tools/LanMountainDesktop.PluginPackager/Program.cs

@@ -0,0 +1,136 @@
+using System.IO.Compression;
+using LanMountainDesktop.PluginSdk;
+
+return await RunAsync(args);
+
+static async Task<int> RunAsync(string[] args)
+{
+    if (args.Length == 0 || args.Any(arg => string.Equals(arg, "--help", StringComparison.OrdinalIgnoreCase)))
+    {
+        PrintUsage();
+        return 0;
+    }
+
+    string? inputDirectory = null;
+    string? outputPath = null;
+    var overwrite = false;
+
+    for (var i = 0; i < args.Length; i++)
+    {
+        switch (args[i])
+        {
+            case "--input":
+                inputDirectory = ReadValue(args, ref i, "--input");
+                break;
+            case "--output":
+                outputPath = ReadValue(args, ref i, "--output");
+                break;
+            case "--overwrite":
+                overwrite = true;
+                break;
+            default:
+                throw new InvalidOperationException($"Unknown argument '{args[i]}'.");
+        }
+    }
+
+    if (string.IsNullOrWhiteSpace(inputDirectory))
+    {
+        throw new InvalidOperationException("Missing required argument '--input'.");
+    }
+
+    var fullInputDirectory = Path.GetFullPath(inputDirectory);
+    if (!Directory.Exists(fullInputDirectory))
+    {
+        throw new DirectoryNotFoundException($"Plugin build directory '{fullInputDirectory}' was not found.");
+    }
+
+    var manifestPath = Path.Combine(fullInputDirectory, PluginSdkInfo.ManifestFileName);
+    if (!File.Exists(manifestPath))
+    {
+        throw new FileNotFoundException(
+            $"Plugin build directory '{fullInputDirectory}' does not contain '{PluginSdkInfo.ManifestFileName}'.",
+            manifestPath);
+    }
+
+    var manifest = PluginManifest.Load(manifestPath);
+    var entranceAssemblyPath = manifest.ResolveEntranceAssemblyPath(manifestPath);
+    if (!File.Exists(entranceAssemblyPath))
+    {
+        throw new FileNotFoundException(
+            $"The entrance assembly declared by '{PluginSdkInfo.ManifestFileName}' was not found.",
+            entranceAssemblyPath);
+    }
+
+    outputPath ??= Path.Combine(
+        Path.GetDirectoryName(fullInputDirectory) ?? fullInputDirectory,
+        BuildPackageFileName(manifest.Id));
+
+    var fullOutputPath = Path.GetFullPath(outputPath);
+    var inputDirectoryWithSeparator = EnsureTrailingSeparator(fullInputDirectory);
+    if (fullOutputPath.StartsWith(inputDirectoryWithSeparator, StringComparison.OrdinalIgnoreCase))
+    {
+        throw new InvalidOperationException("The output .laapp path cannot be placed inside the source directory.");
+    }
+
+    var destinationDirectory = Path.GetDirectoryName(fullOutputPath);
+    if (string.IsNullOrWhiteSpace(destinationDirectory))
+    {
+        throw new InvalidOperationException("Failed to determine the output directory for the .laapp package.");
+    }
+
+    Directory.CreateDirectory(destinationDirectory);
+    if (File.Exists(fullOutputPath))
+    {
+        if (!overwrite)
+        {
+            throw new InvalidOperationException(
+                $"The output package '{fullOutputPath}' already exists. Pass '--overwrite' to replace it.");
+        }
+
+        File.Delete(fullOutputPath);
+    }
+
+    await Task.Run(() => ZipFile.CreateFromDirectory(
+        fullInputDirectory,
+        fullOutputPath,
+        CompressionLevel.Optimal,
+        includeBaseDirectory: false));
+
+    Console.WriteLine($"Packaged '{manifest.Name}' to '{fullOutputPath}'.");
+    return 0;
+}
+
+static string ReadValue(IReadOnlyList<string> args, ref int index, string optionName)
+{
+    var nextIndex = index + 1;
+    if (nextIndex >= args.Count)
+    {
+        throw new InvalidOperationException($"Missing value for '{optionName}'.");
+    }
+
+    index = nextIndex;
+    return args[nextIndex];
+}
+
+static string BuildPackageFileName(string pluginId)
+{
+    var invalidChars = Path.GetInvalidFileNameChars();
+    var safeName = new string(pluginId.Select(ch => invalidChars.Contains(ch) ? '_' : ch).ToArray());
+    return safeName + PluginSdkInfo.PackageFileExtension;
+}
+
+static string EnsureTrailingSeparator(string path)
+{
+    return path.EndsWith(Path.DirectorySeparatorChar.ToString(), StringComparison.Ordinal)
+        ? path
+        : path + Path.DirectorySeparatorChar;
+}
+
+static void PrintUsage()
+{
+    Console.WriteLine("LanMountainDesktop.PluginPackager");
+    Console.WriteLine("Usage:");
+    Console.WriteLine("  --input <plugin build directory>   Required");
+    Console.WriteLine("  --output <path to .laapp>          Optional");
+    Console.WriteLine("  --overwrite                        Optional");
+}

LanMountainDesktop.PluginSdk/IPluginContext.cs

@@ -18,6 +18,9 @@ public interface IPluginContext
 
     bool TryGetProperty<T>(string key, out T? value);
 
+    void RegisterService<TService>(TService service)
+        where TService : class;
+
     void RegisterSettingsPage(PluginSettingsPageRegistration registration);
 
     void RegisterDesktopComponent(PluginDesktopComponentRegistration registration);

LanMountainDesktop.PluginSdk/IPluginMessageBus.cs

@@ -0,0 +1,8 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public interface IPluginMessageBus
+{
+    IDisposable Subscribe<TMessage>(Action<TMessage> handler);
+
+    void Publish<TMessage>(TMessage message);
+}

LanMountainDesktop.PluginSdk/IPluginPackageManager.cs

@@ -0,0 +1,8 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public interface IPluginPackageManager
+{
+    IReadOnlyList<InstalledPluginInfo> GetInstalledPlugins();
+
+    PluginPackageInstallResult InstallPackage(string packagePath);
+}

LanMountainDesktop.PluginSdk/InstalledPluginInfo.cs

@@ -0,0 +1,8 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed record InstalledPluginInfo(
+    PluginManifest Manifest,
+    bool IsEnabled,
+    bool IsLoaded,
+    bool IsPackage,
+    string? ErrorMessage);

LanMountainDesktop.PluginSdk/LanMountainDesktop.PluginSdk.csproj

@@ -8,6 +8,7 @@
   </PropertyGroup>
 
   <ItemGroup>
+    <Compile Remove="_build_verify_*\**\*.cs" />
     <PackageReference Include="Avalonia" Version="11.3.12" />
   </ItemGroup>
 

LanMountainDesktop.PluginSdk/PluginHostPropertyKeys.cs

@@ -0,0 +1,9 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public static class PluginHostPropertyKeys
+{
+    public const string HostApplicationName = "HostApplicationName";
+    public const string HostVersion = "HostVersion";
+    public const string PluginSdkApiVersion = "PluginSdkApiVersion";
+    public const string HostLanguageCode = "HostLanguageCode";
+}

LanMountainDesktop.PluginSdk/PluginLocalizer.cs

@@ -0,0 +1,114 @@
+using System.Globalization;
+using System.Text.Json;
+
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed class PluginLocalizer
+{
+    private static readonly JsonSerializerOptions JsonOptions = new()
+    {
+        ReadCommentHandling = JsonCommentHandling.Skip,
+        AllowTrailingCommas = true
+    };
+
+    private readonly Dictionary<string, Dictionary<string, string>> _cache =
+        new(StringComparer.OrdinalIgnoreCase);
+
+    public PluginLocalizer(string pluginDirectory, string? languageCode)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(pluginDirectory);
+
+        PluginDirectory = pluginDirectory;
+        LanguageCode = NormalizeLanguageCode(languageCode);
+    }
+
+    public string PluginDirectory { get; }
+
+    public string LanguageCode { get; }
+
+    public static PluginLocalizer Create(IPluginContext context)
+    {
+        ArgumentNullException.ThrowIfNull(context);
+        return new PluginLocalizer(context.PluginDirectory, ResolveLanguageCode(context.Properties));
+    }
+
+    public static PluginLocalizer Create(PluginDesktopComponentContext context)
+    {
+        ArgumentNullException.ThrowIfNull(context);
+        return new PluginLocalizer(context.PluginDirectory, ResolveLanguageCode(context.Properties));
+    }
+
+    public string GetString(string key, string fallback)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(key);
+
+        var primaryTable = LoadLanguageTable(LanguageCode);
+        if (primaryTable.TryGetValue(key, out var value) && !string.IsNullOrWhiteSpace(value))
+        {
+            return value;
+        }
+
+        if (!string.Equals(LanguageCode, "en-US", StringComparison.OrdinalIgnoreCase))
+        {
+            var fallbackTable = LoadLanguageTable("en-US");
+            if (fallbackTable.TryGetValue(key, out value) && !string.IsNullOrWhiteSpace(value))
+            {
+                return value;
+            }
+        }
+
+        return fallback;
+    }
+
+    public string Format(string key, string fallback, params object[] args)
+    {
+        return string.Format(CultureInfo.CurrentCulture, GetString(key, fallback), args);
+    }
+
+    public static string NormalizeLanguageCode(string? languageCode)
+    {
+        return string.Equals(languageCode, "en-US", StringComparison.OrdinalIgnoreCase)
+            ? "en-US"
+            : "zh-CN";
+    }
+
+    public static string ResolveLanguageCode(IReadOnlyDictionary<string, object?> properties)
+    {
+        ArgumentNullException.ThrowIfNull(properties);
+
+        return properties.TryGetValue(PluginHostPropertyKeys.HostLanguageCode, out var rawValue) &&
+               rawValue is string languageCode
+            ? NormalizeLanguageCode(languageCode)
+            : NormalizeLanguageCode(CultureInfo.CurrentUICulture.Name);
+    }
+
+    private Dictionary<string, string> LoadLanguageTable(string languageCode)
+    {
+        if (_cache.TryGetValue(languageCode, out var table))
+        {
+            return table;
+        }
+
+        var result = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
+        try
+        {
+            var filePath = Path.Combine(PluginDirectory, "Localization", $"{languageCode}.json");
+            if (File.Exists(filePath))
+            {
+                var json = File.ReadAllText(filePath).TrimStart('\uFEFF');
+                var data = JsonSerializer.Deserialize<Dictionary<string, string>>(json, JsonOptions);
+                if (data is not null)
+                {
+                    result = new Dictionary<string, string>(data, StringComparer.OrdinalIgnoreCase);
+                }
+            }
+        }
+        catch
+        {
+            // Keep empty localization table for plugin resilience.
+        }
+
+        _cache[languageCode] = result;
+        return result;
+    }
+}

LanMountainDesktop.PluginSdk/PluginPackageInstallResult.cs

@@ -0,0 +1,6 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed record PluginPackageInstallResult(
+    PluginManifest Manifest,
+    bool ReplacedExisting,
+    bool RestartRequired);

LanMountainDesktop.SamplePlugin/SamplePlugin.cs

@@ -1,66 +0,0 @@
-using LanMountainDesktop.PluginSdk;
-
-namespace LanMountainDesktop.SamplePlugin;
-
-[PluginEntrance]
-public sealed class SamplePlugin : PluginBase, IDisposable
-{
-    private SamplePluginHeartbeatService? _heartbeatService;
-
-    public override void Initialize(IPluginContext context)
-    {
-        Directory.CreateDirectory(context.DataDirectory);
-
-        var hostName = context.TryGetProperty<string>("HostApplicationName", out var configuredHostName) &&
-                       !string.IsNullOrWhiteSpace(configuredHostName)
-            ? configuredHostName
-            : "UnknownHost";
-
-        var version = context.Manifest.Version ?? "dev";
-        SamplePluginRuntimeStatus.Reset(hostName, version, context.DataDirectory);
-
-        var message =
-            $"[{DateTimeOffset.UtcNow:O}] {context.Manifest.Name} initialized in {hostName} (plugin version {version}).";
-
-        try
-        {
-            File.AppendAllText(
-                Path.Combine(context.DataDirectory, "sample-plugin.log"),
-                message + Environment.NewLine);
-            SamplePluginRuntimeStatus.MarkBackendReady(
-                $"Plugin entry initialized successfully. Host: {hostName}; Version: {version}");
-        }
-        catch (Exception ex)
-        {
-            SamplePluginRuntimeStatus.MarkBackendFaulted($"Initialization log write failed: {ex.Message}");
-            throw;
-        }
-
-        _heartbeatService = new SamplePluginHeartbeatService(context.DataDirectory);
-        _heartbeatService.Start();
-
-        context.RegisterSettingsPage(new PluginSettingsPageRegistration(
-            "status",
-            "Plugin Status",
-            () => new SamplePluginSettingsView(context)));
-
-        context.RegisterDesktopComponent(new PluginDesktopComponentRegistration(
-            "LanMountainDesktop.SamplePlugin.StatusClock",
-            "Sample Plugin Status Clock",
-            widgetContext => new SamplePluginStatusClockWidget(widgetContext),
-            iconKey: "PuzzlePiece",
-            category: "Plugins",
-            minWidthCells: 4,
-            minHeightCells: 4,
-            allowDesktopPlacement: true,
-            allowStatusBarPlacement: false,
-            resizeMode: PluginDesktopComponentResizeMode.Proportional,
-            cornerRadiusResolver: cellSize => Math.Clamp(cellSize * 0.34, 18, 34)));
-    }
-
-    public void Dispose()
-    {
-        _heartbeatService?.Dispose();
-        _heartbeatService = null;
-    }
-}

LanMountainDesktop.SamplePlugin/SamplePluginRuntimeStatus.cs

@@ -1,251 +0,0 @@
-using System.Globalization;
-using System.IO;
-using System.Threading;
-
-namespace LanMountainDesktop.SamplePlugin;
-
-internal enum SamplePluginHealthState
-{
-    Healthy,
-    Pending,
-    Faulted
-}
-
-internal sealed record SamplePluginStatusEntry(
-    string Key,
-    string Title,
-    SamplePluginHealthState State,
-    string Summary,
-    string Detail,
-    DateTimeOffset UpdatedAt);
-
-internal static class SamplePluginRuntimeStatus
-{
-    private static readonly object Gate = new();
-
-    private static SamplePluginStatusEntry _frontend = CreateEntry(
-        "frontend",
-        "Frontend",
-        SamplePluginHealthState.Pending,
-        "Pending",
-        "Frontend surfaces have not been created yet.");
-
-    private static SamplePluginStatusEntry _component = CreateEntry(
-        "component",
-        "Component",
-        SamplePluginHealthState.Pending,
-        "Pending",
-        "The 4x4 component has not been created yet.");
-
-    private static SamplePluginStatusEntry _backend = CreateEntry(
-        "backend",
-        "Backend",
-        SamplePluginHealthState.Pending,
-        "Pending",
-        "Plugin initialization has not finished yet.");
-
-    private static SamplePluginStatusEntry _service = CreateEntry(
-        "service",
-        "Service",
-        SamplePluginHealthState.Pending,
-        "Pending",
-        "Heartbeat service has not started yet.");
-
-    public static void Reset(string hostName, string version, string dataDirectory)
-    {
-        lock (Gate)
-        {
-            _frontend = CreateEntry(
-                "frontend",
-                "Frontend",
-                SamplePluginHealthState.Pending,
-                "Pending",
-                "Waiting for the settings page or widget surface to render.");
-
-            _component = CreateEntry(
-                "component",
-                "Component",
-                SamplePluginHealthState.Pending,
-                "Pending",
-                "The 4x4 component has not been created yet.");
-
-            _backend = CreateEntry(
-                "backend",
-                "Backend",
-                SamplePluginHealthState.Healthy,
-                "Healthy",
-                $"Plugin initialized. Host: {hostName}; Version: {version}; Data: {dataDirectory}");
-
-            _service = CreateEntry(
-                "service",
-                "Service",
-                SamplePluginHealthState.Pending,
-                "Pending",
-                "Heartbeat service is starting.");
-        }
-    }
-
-    public static void MarkFrontendReady(string detail)
-    {
-        lock (Gate)
-        {
-            _frontend = CreateEntry(
-                "frontend",
-                "Frontend",
-                SamplePluginHealthState.Healthy,
-                "Healthy",
-                detail);
-        }
-    }
-
-    public static void MarkComponentCreated(string detail)
-    {
-        lock (Gate)
-        {
-            _component = CreateEntry(
-                "component",
-                "Component",
-                SamplePluginHealthState.Healthy,
-                "Created",
-                detail);
-        }
-    }
-
-    public static void MarkBackendReady(string detail)
-    {
-        lock (Gate)
-        {
-            _backend = CreateEntry(
-                "backend",
-                "Backend",
-                SamplePluginHealthState.Healthy,
-                "Healthy",
-                detail);
-        }
-    }
-
-    public static void MarkBackendFaulted(string detail)
-    {
-        lock (Gate)
-        {
-            _backend = CreateEntry(
-                "backend",
-                "Backend",
-                SamplePluginHealthState.Faulted,
-                "Faulted",
-                detail);
-        }
-    }
-
-    public static void MarkServiceHeartbeat(DateTimeOffset timestamp)
-    {
-        lock (Gate)
-        {
-            _service = CreateEntry(
-                "service",
-                "Service",
-                SamplePluginHealthState.Healthy,
-                "Healthy",
-                $"Heartbeat service is running. Last heartbeat: {timestamp.LocalDateTime:HH:mm:ss}");
-        }
-    }
-
-    public static void MarkServiceFaulted(string detail)
-    {
-        lock (Gate)
-        {
-            _service = CreateEntry(
-                "service",
-                "Service",
-                SamplePluginHealthState.Faulted,
-                "Faulted",
-                detail);
-        }
-    }
-
-    public static IReadOnlyList<SamplePluginStatusEntry> GetSnapshot()
-    {
-        lock (Gate)
-        {
-            return
-            [
-                _frontend,
-                _component,
-                _backend,
-                _service
-            ];
-        }
-    }
-
-    private static SamplePluginStatusEntry CreateEntry(
-        string key,
-        string title,
-        SamplePluginHealthState state,
-        string summary,
-        string detail)
-    {
-        return new SamplePluginStatusEntry(
-            key,
-            title,
-            state,
-            summary,
-            detail,
-            DateTimeOffset.Now);
-    }
-}
-
-internal sealed class SamplePluginHeartbeatService : IDisposable
-{
-    private readonly string _heartbeatFilePath;
-    private readonly Timer _timer;
-    private int _disposed;
-
-    public SamplePluginHeartbeatService(string dataDirectory)
-    {
-        Directory.CreateDirectory(dataDirectory);
-        _heartbeatFilePath = Path.Combine(dataDirectory, "service-heartbeat.txt");
-        _timer = new Timer(OnTimerTick);
-    }
-
-    public void Start()
-    {
-        PublishHeartbeat();
-        _timer.Change(TimeSpan.FromSeconds(5), TimeSpan.FromSeconds(5));
-    }
-
-    public void Dispose()
-    {
-        if (Interlocked.Exchange(ref _disposed, 1) != 0)
-        {
-            return;
-        }
-
-        _timer.Dispose();
-    }
-
-    private void OnTimerTick(object? state)
-    {
-        PublishHeartbeat();
-    }
-
-    private void PublishHeartbeat()
-    {
-        if (Volatile.Read(ref _disposed) != 0)
-        {
-            return;
-        }
-
-        var now = DateTimeOffset.Now;
-        try
-        {
-            File.WriteAllText(
-                _heartbeatFilePath,
-                now.ToString("O", CultureInfo.InvariantCulture));
-            SamplePluginRuntimeStatus.MarkServiceHeartbeat(now);
-        }
-        catch (Exception ex)
-        {
-            SamplePluginRuntimeStatus.MarkServiceFaulted($"Heartbeat write failed: {ex.Message}");
-        }
-    }
-}

LanMountainDesktop.SamplePlugin/SamplePluginSettingsView.cs

@@ -1,190 +0,0 @@
-using Avalonia;
-using Avalonia.Controls;
-using Avalonia.Layout;
-using Avalonia.Media;
-using Avalonia.Threading;
-using LanMountainDesktop.PluginSdk;
-
-namespace LanMountainDesktop.SamplePlugin;
-
-internal sealed class SamplePluginSettingsView : UserControl
-{
-    private readonly DispatcherTimer _refreshTimer = new()
-    {
-        Interval = TimeSpan.FromSeconds(1)
-    };
-
-    private readonly IPluginContext _context;
-    private readonly TextBlock _summaryTextBlock;
-    private readonly StackPanel _statusPanel;
-
-    public SamplePluginSettingsView(IPluginContext context)
-    {
-        _context = context;
-        _summaryTextBlock = new TextBlock
-        {
-            Foreground = new SolidColorBrush(Color.Parse("#FFBAE6FD")),
-            TextWrapping = TextWrapping.Wrap
-        };
-        _statusPanel = new StackPanel
-        {
-            Spacing = 10
-        };
-
-        SamplePluginRuntimeStatus.MarkFrontendReady("Settings page rendered successfully.");
-
-        _refreshTimer.Tick += OnRefreshTimerTick;
-        AttachedToVisualTree += OnAttachedToVisualTree;
-        DetachedFromVisualTree += OnDetachedFromVisualTree;
-
-        Content = new Border
-        {
-            Background = new LinearGradientBrush
-            {
-                StartPoint = new RelativePoint(0, 0, RelativeUnit.Relative),
-                EndPoint = new RelativePoint(1, 1, RelativeUnit.Relative),
-                GradientStops =
-                [
-                    new GradientStop(Color.Parse("#1F0B1120"), 0),
-                    new GradientStop(Color.Parse("#260C4A6E"), 1)
-                ]
-            },
-            BorderBrush = new SolidColorBrush(Color.Parse("#6628B2FF")),
-            BorderThickness = new Thickness(1),
-            CornerRadius = new CornerRadius(18),
-            Padding = new Thickness(18),
-            Child = new StackPanel
-            {
-                Spacing = 14,
-                Children =
-                {
-                    new TextBlock
-                    {
-                        Text = "Sample Plugin Runtime Status",
-                        FontSize = 22,
-                        FontWeight = FontWeight.SemiBold,
-                        Foreground = Brushes.White
-                    },
-                    _summaryTextBlock,
-                    new Border
-                    {
-                        Background = new SolidColorBrush(Color.Parse("#14000000")),
-                        BorderBrush = new SolidColorBrush(Color.Parse("#3328B2FF")),
-                        BorderThickness = new Thickness(1),
-                        CornerRadius = new CornerRadius(14),
-                        Padding = new Thickness(14),
-                        Child = _statusPanel
-                    }
-                }
-            }
-        };
-
-        RefreshStatuses();
-    }
-
-    private void OnAttachedToVisualTree(object? sender, VisualTreeAttachmentEventArgs e)
-    {
-        RefreshStatuses();
-        _refreshTimer.Start();
-    }
-
-    private void OnDetachedFromVisualTree(object? sender, VisualTreeAttachmentEventArgs e)
-    {
-        _refreshTimer.Stop();
-    }
-
-    private void OnRefreshTimerTick(object? sender, EventArgs e)
-    {
-        RefreshStatuses();
-    }
-
-    private void RefreshStatuses()
-    {
-        _summaryTextBlock.Text =
-            $"Plugin Id: {_context.Manifest.Id}\nVersion: {_context.Manifest.Version ?? "dev"}\nData Path: {_context.DataDirectory}";
-
-        _statusPanel.Children.Clear();
-        foreach (var entry in SamplePluginRuntimeStatus.GetSnapshot())
-        {
-            var palette = GetPalette(entry.State);
-            _statusPanel.Children.Add(new Border
-            {
-                Background = new SolidColorBrush(palette.Background),
-                BorderBrush = new SolidColorBrush(palette.Border),
-                BorderThickness = new Thickness(1),
-                CornerRadius = new CornerRadius(12),
-                Padding = new Thickness(12, 10),
-                Child = new StackPanel
-                {
-                    Spacing = 4,
-                    Children =
-                    {
-                        new Grid
-                        {
-                            ColumnDefinitions = new ColumnDefinitions("Auto,*,Auto"),
-                            ColumnSpacing = 8,
-                            Children =
-                            {
-                                new Border
-                                {
-                                    Width = 10,
-                                    Height = 10,
-                                    CornerRadius = new CornerRadius(999),
-                                    Background = new SolidColorBrush(palette.Dot),
-                                    VerticalAlignment = VerticalAlignment.Center
-                                },
-                                new TextBlock
-                                {
-                                    Text = entry.Title,
-                                    FontSize = 15,
-                                    FontWeight = FontWeight.SemiBold,
-                                    Foreground = Brushes.White
-                                },
-                                new TextBlock
-                                {
-                                    Text = entry.Summary,
-                                    Foreground = new SolidColorBrush(Color.Parse("#FFD7F2FF")),
-                                    HorizontalAlignment = HorizontalAlignment.Right
-                                }
-                            }
-                        },
-                        new TextBlock
-                        {
-                            Text = entry.Detail,
-                            Foreground = new SolidColorBrush(Color.Parse("#FFE0F2FE")),
-                            TextWrapping = TextWrapping.Wrap
-                        },
-                        new TextBlock
-                        {
-                            Text = $"Updated: {entry.UpdatedAt.LocalDateTime:HH:mm:ss}",
-                            Foreground = new SolidColorBrush(Color.Parse("#FF93C5FD"))
-                        }
-                    }
-                }
-            });
-
-            var row = (Grid)((StackPanel)((Border)_statusPanel.Children[^1]).Child!).Children[0];
-            Grid.SetColumn(row.Children[1], 1);
-            Grid.SetColumn(row.Children[2], 2);
-        }
-    }
-
-    private static (Color Background, Color Border, Color Dot) GetPalette(SamplePluginHealthState state)
-    {
-        return state switch
-        {
-            SamplePluginHealthState.Healthy => (
-                Color.Parse("#1F115E59"),
-                Color.Parse("#665EEAD4"),
-                Color.Parse("#5EEAD4")),
-            SamplePluginHealthState.Faulted => (
-                Color.Parse("#291B1B"),
-                Color.Parse("#66F87171"),
-                Color.Parse("#F87171")),
-            _ => (
-                Color.Parse("#2B3A2A0D"),
-                Color.Parse("#66FBBF24"),
-                Color.Parse("#FBBF24"))
-        };
-    }
-}

LanMountainDesktop.sln

@@ -5,7 +5,9 @@ VisualStudioVersion = 17.0.31903.59
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "LanMountainDesktop", "LanMountainDesktop\LanMountainDesktop.csproj", "{00000001-0000-0000-0000-000000000001}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "LanMountainDesktop.SamplePlugin", "LanMountainDesktop.SamplePlugin\LanMountainDesktop.SamplePlugin.csproj", "{BDCD028D-DB6E-4BD5-994A-65889DBDEE0C}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "LanMountainDesktop.SamplePlugin", "LanAirApp\samples\LanMountainDesktop.SamplePlugin\LanMountainDesktop.SamplePlugin.csproj", "{BDCD028D-DB6E-4BD5-994A-65889DBDEE0C}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "LanMountainDesktop.PluginPackager", "LanAirApp\tools\LanMountainDesktop.PluginPackager\LanMountainDesktop.PluginPackager.csproj", "{AAE8578B-1F9D-4D4F-8B2E-0A98C55B0C31}"
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "LanMountainDesktop.PluginSdk", "LanMountainDesktop.PluginSdk\LanMountainDesktop.PluginSdk.csproj", "{30A0F689-AACC-48C8-8BFE-BC7BFBA6CC55}"
 EndProject
@@ -23,6 +25,10 @@ Global
 		{BDCD028D-DB6E-4BD5-994A-65889DBDEE0C}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{BDCD028D-DB6E-4BD5-994A-65889DBDEE0C}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{BDCD028D-DB6E-4BD5-994A-65889DBDEE0C}.Release|Any CPU.Build.0 = Release|Any CPU
+		{AAE8578B-1F9D-4D4F-8B2E-0A98C55B0C31}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{AAE8578B-1F9D-4D4F-8B2E-0A98C55B0C31}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{AAE8578B-1F9D-4D4F-8B2E-0A98C55B0C31}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{AAE8578B-1F9D-4D4F-8B2E-0A98C55B0C31}.Release|Any CPU.Build.0 = Release|Any CPU
 		{30A0F689-AACC-48C8-8BFE-BC7BFBA6CC55}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{30A0F689-AACC-48C8-8BFE-BC7BFBA6CC55}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{30A0F689-AACC-48C8-8BFE-BC7BFBA6CC55}.Release|Any CPU.ActiveCfg = Release|Any CPU

LanMountainDesktop/App.axaml.cs

@@ -96,45 +96,7 @@ public partial class App : Application
 
     private void OnTrayRestartClick(object? sender, EventArgs e)
     {
-        if (ApplicationLifetime is not IClassicDesktopStyleApplicationLifetime desktop)
-        {
-            return;
-        }
-
-        if (TryStartCurrentProcess())
-        {
-            desktop.Shutdown();
-        }
-    }
-
-    private static bool TryStartCurrentProcess()
-    {
-        try
-        {
-            var args = Environment.GetCommandLineArgs();
-            if (args.Length == 0 || string.IsNullOrWhiteSpace(args[0]))
-            {
-                return false;
-            }
-
-            var startInfo = new ProcessStartInfo
-            {
-                FileName = args[0],
-                UseShellExecute = false
-            };
-
-            for (var i = 1; i < args.Length; i++)
-            {
-                startInfo.ArgumentList.Add(args[i]);
-            }
-
-            Process.Start(startInfo);
-            return true;
-        }
-        catch
-        {
-            return false;
-        }
+        AppRestartService.TryRestartApplication();
     }
 
     private void DisableAvaloniaDataAnnotationValidation()

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/Localization/en-US.json

@@ -4,8 +4,15 @@
     "tooltip.back_to_windows":  "Back to Windows",
     "tooltip.open_settings":  "Settings",
     "settings.title":  "Settings",
+    "settings.shell.title":  "Application Settings",
+    "settings.shell.subtitle":  "LanMountainDesktop standalone preferences",
+    "settings.shell.sidebar_hint":  "Choose a category to adjust application behavior, desktop layout, and appearance.",
+    "settings.shell.footer_hint":  "Tray-opened settings are managed in this standalone window.",
     "settings.back_to_desktop":  "Back to Desktop",
     "settings.nav_header":  "Settings",
+    "settings.nav.group_desktop":  "Desktop",
+    "settings.nav.group_system":  "System",
+    "settings.nav.group_extensions":  "Extensions",
     "settings.nav.wallpaper":  "Wallpaper",
     "settings.nav.grid":  "Grid",
     "settings.nav.color":  "Color",
@@ -109,6 +116,8 @@
     "settings.weather.preview_header":  "Connection Test",
     "settings.weather.preview_desc":  "Send one test request to verify current settings.",
     "settings.weather.preview_button":  "Test Fetch",
+    "settings.weather.preview_section":  "Weather Preview",
+    "settings.weather.settings_section":  "Settings",
     "settings.weather.preview_panel_header":  "Weather Preview",
     "settings.weather.preview_panel_desc":  "Refresh and verify current weather service status.",
     "settings.weather.refresh_button":  "Refresh",
@@ -129,6 +138,15 @@
     "settings.weather.status_city_empty":  "No city location is configured.",
     "settings.weather.status_city_format":  "Mode: {0} | {1} | Key: {2}",
     "settings.weather.status_coordinates_format":  "Mode: {0} | Lat {1:F4}, Lon {2:F4} | Key: {3}",
+    "settings.weather.city_selection_label":  "City Selection",
+    "settings.weather.coordinates_selection_label":  "Coordinate Location",
+    "settings.weather.location_city_summary_desc":  "Select the current city used for weather queries.",
+    "settings.weather.location_coordinates_summary_desc":  "Set latitude/longitude and optional location name used for weather queries.",
+    "settings.weather.location_not_selected":  "No location selected",
+    "settings.weather.alert_list_label":  "Exclude List",
+    "settings.weather.alert_list_desc":  "One exclusion rule per line.",
+    "settings.weather.no_tls_toggle":  "Allow non-TLS request fallback",
+    "settings.weather.footer_hint":  "Desktop weather widgets will reuse the location and alert exclusion settings configured here.",
     "settings.weather.location_header":  "Weather Location",
     "settings.weather.location_desc":  "Set the location used by weather widgets.",
     "settings.weather.location_placeholder":  "e.g. Beijing",
@@ -237,6 +255,25 @@
     "settings.about.startup_header":  "Windows Startup",
     "settings.about.startup_desc":  "Launch the app automatically when signing in to Windows.",
     "settings.about.startup_toggle":  "Launch at Windows sign-in",
+    "settings.about.render_mode_header":  "App Rendering Mode",
+    "settings.about.render_mode_desc":  "Choose the rendering backend. Restart the app after changing this option. Unsupported modes fall back to software.",
+    "settings.about.render_mode.default":  "Default",
+    "settings.about.render_mode.software":  "Software",
+    "settings.about.render_mode.angle_egl":  "angleEgl",
+    "settings.about.render_mode.wgl":  "WGL",
+    "settings.about.render_mode.vulkan":  "Vulkan",
+    "settings.about.render_mode.unknown":  "Unknown",
+    "settings.about.render_mode.current_label":  "Current actual backend",
+    "settings.about.render_mode.current_format":  "Current backend: {0}",
+    "settings.about.render_mode.impl_format":  "Runtime implementation: {0}",
+    "settings.about.render_mode.impl_unavailable":  "Runtime implementation details are unavailable.",
+    "settings.restart_dialog.title":  "Restart required",
+    "settings.restart_dialog.render_mode_message":  "Restart the app to switch the rendering mode from \"{0}\" to \"{1}\". Restart now?",
+    "settings.restart_dialog.restart":  "Restart now",
+    "settings.restart_dialog.cancel":  "Cancel",
+    "settings.restart_dock.title":  "Restart required",
+    "settings.restart_dock.description":  "Some changes will take effect after restarting the app.",
+    "settings.restart_dock.button":  "Restart app",
     "settings.footer":  "LanMountainDesktop Settings",
     "filepicker.title":  "Select wallpaper",
     "filepicker.image_files":  "Image files",
@@ -288,10 +325,57 @@
     "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.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}",
+    "settings.plugins.install_picker_title":  "Select plugin package",
+    "settings.plugins.install_file_type":  ".laapp plugin package",
+    "settings.plugins.install_picker_unavailable":  "Storage provider is unavailable.",
+    "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.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.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...",
+    "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 the plugin market: {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 market 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 on 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...",
     "button.component_library":  "Edit Desktop",
     "tooltip.component_library":  "Edit Desktop",
     "component_library.title":  "Widgets",

LanMountainDesktop/Localization/zh-CN.json

@@ -4,8 +4,15 @@
     "tooltip.back_to_windows":  "回到Windows",
     "tooltip.open_settings":  "设置",
     "settings.title":  "设置",
+    "settings.shell.title":  "应用设置",
+    "settings.shell.subtitle":  "LanMountainDesktop 独立设置窗口",
+    "settings.shell.sidebar_hint":  "选择一个分类以调整应用行为、桌面布局与外观。",
+    "settings.shell.footer_hint":  "托盘菜单打开的设置会统一在这个独立窗口中管理。",
     "settings.back_to_desktop":  "返回桌面",
     "settings.nav_header":  "设置选项",
+    "settings.nav.group_desktop":  "桌面",
+    "settings.nav.group_system":  "系统",
+    "settings.nav.group_extensions":  "扩展",
     "settings.nav.wallpaper":  "壁纸",
     "settings.nav.grid":  "网格",
     "settings.nav.color":  "颜色",
@@ -109,6 +116,8 @@
     "settings.weather.preview_header":  "连接测试",
     "settings.weather.preview_desc":  "发送一次测试请求，验证当前配置是否可用。",
     "settings.weather.preview_button":  "测试获取",
+    "settings.weather.preview_section":  "天气预览",
+    "settings.weather.settings_section":  "设置",
     "settings.weather.preview_panel_header":  "天气预览",
     "settings.weather.preview_panel_desc":  "刷新并验证当前天气服务状态。",
     "settings.weather.refresh_button":  "刷新",
@@ -129,6 +138,15 @@
     "settings.weather.status_city_empty":  "尚未配置城市位置。",
     "settings.weather.status_city_format":  "模式：{0}｜{1}｜Key：{2}",
     "settings.weather.status_coordinates_format":  "模式：{0}｜纬度 {1:F4}，经度 {2:F4}｜Key：{3}",
+    "settings.weather.city_selection_label":  "城市选择",
+    "settings.weather.coordinates_selection_label":  "坐标定位",
+    "settings.weather.location_city_summary_desc":  "选择当前所在的城市，用于天气查询。",
+    "settings.weather.location_coordinates_summary_desc":  "设置经纬度与可选的位置名称，用于天气查询。",
+    "settings.weather.location_not_selected":  "未选择位置",
+    "settings.weather.alert_list_label":  "排除列表",
+    "settings.weather.alert_list_desc":  "一行一条排除项。",
+    "settings.weather.no_tls_toggle":  "允许在兼容性较差的网络环境下回退到非 TLS 请求",
+    "settings.weather.footer_hint":  "桌面上的天气组件会共享这里配置的天气位置与预警排除规则。",
     "settings.weather.location_header":  "天气位置",
     "settings.weather.location_desc":  "设置天气组件使用的位置。",
     "settings.weather.location_placeholder":  "例如：北京",
@@ -237,6 +255,25 @@
     "settings.about.startup_header":  "Windows 自启动",
     "settings.about.startup_desc":  "在登录 Windows 时自动启动应用。",
     "settings.about.startup_toggle":  "登录 Windows 时启动",
+    "settings.about.render_mode_header":  "应用渲染模式",
+    "settings.about.render_mode_desc":  "选择应用渲染后端。更改后需要重启应用生效。不支持的模式会回退到软件渲染。",
+    "settings.about.render_mode.default":  "默认",
+    "settings.about.render_mode.software":  "软件",
+    "settings.about.render_mode.angle_egl":  "angleEgl",
+    "settings.about.render_mode.wgl":  "WGL",
+    "settings.about.render_mode.vulkan":  "Vulkan",
+    "settings.about.render_mode.unknown":  "未知",
+    "settings.about.render_mode.current_label":  "当前实际渲染后端",
+    "settings.about.render_mode.current_format":  "当前后端：{0}",
+    "settings.about.render_mode.impl_format":  "运行时实现：{0}",
+    "settings.about.render_mode.impl_unavailable":  "当前无法获取运行时实现信息。",
+    "settings.restart_dialog.title":  "需要重启应用",
+    "settings.restart_dialog.render_mode_message":  "需要重启应用，才能将渲染模式从“{0}”切换到“{1}”。是否现在重启？",
+    "settings.restart_dialog.restart":  "立即重启",
+    "settings.restart_dialog.cancel":  "取消",
+    "settings.restart_dock.title":  "需要重启应用",
+    "settings.restart_dock.description":  "部分更改需要在重启应用后才会生效。",
+    "settings.restart_dock.button":  "重启应用",
     "settings.footer":  "LanMountainDesktop 设置",
     "filepicker.title":  "选择壁纸",
     "filepicker.image_files":  "图片文件",
@@ -288,10 +325,57 @@
     "settings.plugins.toggle_result_format":  "插件“{0}”已在下次启动时设为{1}。重启应用后，设置页和组件变更才会生效。",
     "settings.plugins.toggle_state_enabled":  "启用",
     "settings.plugins.toggle_state_disabled":  "禁用",
+    "settings.plugins.install_button":  "打开 .laapp 插件包",
+    "settings.plugins.install_unavailable":  "插件运行时不可用，暂时无法安装 .laapp 插件包。",
+    "settings.plugins.install_hint_format":  "打开一个 .laapp 插件包，安装到：{0}",
+    "settings.plugins.install_picker_title":  "选择插件安装包",
+    "settings.plugins.install_file_type":  ".laapp 插件包",
+    "settings.plugins.install_picker_unavailable":  "文件存储提供程序不可用。",
+    "settings.plugins.install_copy_failed":  "复制所选 .laapp 插件包失败。",
+    "settings.plugins.install_success_format":  "插件“{0}”安装完成。重启应用后，新增的设置页和组件才会生效。",
+    "settings.plugins.install_failed_format":  "安装插件包失败：{0}",
     "settings.plugins.source_package":  ".laapp 包",
     "settings.plugins.source_manifest":  "散装清单",
     "settings.plugins.subtitle_format":  "{0} | {1} | {2}",
     "settings.plugins.detail_format":  "设置页：{0} | 组件：{1}",
+    "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":  "正在加载官方插件市场...",
+    "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":  "安装中...",
     "button.component_library":  "桌面编辑",
     "tooltip.component_library":  "桌面编辑",
     "component_library.title":  "桌面编辑",

LanMountainDesktop/Models/AppSettingsSnapshot.cs

@@ -48,6 +48,8 @@ public sealed class AppSettingsSnapshot
 
     public bool AutoStartWithWindows { get; set; }
 
+    public string AppRenderMode { get; set; } = "Default";
+
     public bool AutoCheckUpdates { get; set; } = true;
 
     public bool IncludePrereleaseUpdates { get; set; }

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

@@ -1,5 +1,6 @@
-using Avalonia;
+using Avalonia;
 using Avalonia.WebView.Desktop;
+using LanMountainDesktop.Services;
 using System;
 
 namespace LanMountainDesktop;
@@ -10,14 +11,42 @@ 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()
+    public static void Main(string[] args) => BuildAvaloniaApp(LoadConfiguredRenderMode())
         .StartWithClassicDesktopLifetime(args);
 
     // Avalonia configuration, don't remove; also used by visual designer.
-    public static AppBuilder BuildAvaloniaApp()
-        => AppBuilder.Configure<App>()
+    public static AppBuilder BuildAvaloniaApp(string renderMode = AppRenderingModeHelper.Default)
+    {
+        var builder = AppBuilder.Configure<App>()
             .UsePlatformDetect()
             .UseDesktopWebView()
             .WithInterFont()
             .LogToTrace();
+
+        if (OperatingSystem.IsWindows())
+        {
+            var configuredModes = AppRenderingModeHelper.GetWin32RenderingModes(renderMode);
+            if (configuredModes is { Length: > 0 })
+            {
+                builder = builder.With(new Win32PlatformOptions
+                {
+                    RenderingMode = configuredModes
+                });
+            }
+        }
+
+        return builder;
+    }
+
+    private static string LoadConfiguredRenderMode()
+    {
+        try
+        {
+            return AppRenderingModeHelper.Normalize(new AppSettingsService().Load().AppRenderMode);
+        }
+        catch
+        {
+            return AppRenderingModeHelper.Default;
+        }
+    }
 }

LanMountainDesktop/Services/AppRenderBackendDiagnostics.cs

@@ -0,0 +1,73 @@
+using System;
+using System.Reflection;
+using Avalonia;
+using Avalonia.Platform;
+
+namespace LanMountainDesktop.Services;
+
+public readonly record struct AppRenderBackendInfo(
+    string ActualBackend,
+    string? ImplementationTypeName);
+
+public static class AppRenderBackendDiagnostics
+{
+    public const string Unknown = "Unknown";
+
+    public static AppRenderBackendInfo Detect()
+    {
+        var platformGraphics = GetPlatformGraphics();
+        var implementationTypeName = platformGraphics?.GetType().FullName;
+        var actualBackend = DetectBackendFromImplementationType(implementationTypeName, platformGraphics is null);
+
+        return new AppRenderBackendInfo(actualBackend, implementationTypeName);
+    }
+
+    private static object? GetPlatformGraphics()
+    {
+        var currentResolver = typeof(AvaloniaLocator)
+            .GetProperty("Current", BindingFlags.Public | BindingFlags.Static)
+            ?.GetValue(null);
+
+        var getServiceMethod = currentResolver?
+            .GetType()
+            .GetMethod(
+                "GetService",
+                BindingFlags.Public | BindingFlags.Instance,
+                binder: null,
+                types: [typeof(Type)],
+                modifiers: null);
+
+        return getServiceMethod?.Invoke(currentResolver, [typeof(IPlatformGraphics)]);
+    }
+
+    private static string DetectBackendFromImplementationType(string? implementationTypeName, bool isSoftwareFallback)
+    {
+        if (isSoftwareFallback)
+        {
+            return AppRenderingModeHelper.Software;
+        }
+
+        if (string.IsNullOrWhiteSpace(implementationTypeName))
+        {
+            return Unknown;
+        }
+
+        if (implementationTypeName.Contains("Vulkan", StringComparison.OrdinalIgnoreCase))
+        {
+            return AppRenderingModeHelper.Vulkan;
+        }
+
+        if (implementationTypeName.Contains("Wgl", StringComparison.OrdinalIgnoreCase))
+        {
+            return AppRenderingModeHelper.Wgl;
+        }
+
+        if (implementationTypeName.Contains("Angle", StringComparison.OrdinalIgnoreCase) ||
+            implementationTypeName.Contains("Egl", StringComparison.OrdinalIgnoreCase))
+        {
+            return AppRenderingModeHelper.AngleEgl;
+        }
+
+        return Unknown;
+    }
+}

LanMountainDesktop/Services/AppRenderingModeHelper.cs

@@ -0,0 +1,42 @@
+using Avalonia;
+
+namespace LanMountainDesktop.Services;
+
+public static class AppRenderingModeHelper
+{
+    public const string Default = "Default";
+    public const string Software = "Software";
+    public const string AngleEgl = "AngleEgl";
+    public const string Wgl = "Wgl";
+    public const string Vulkan = "Vulkan";
+
+    public static string Normalize(string? value)
+    {
+        if (string.IsNullOrWhiteSpace(value))
+        {
+            return Default;
+        }
+
+        return value.Trim().ToUpperInvariant() switch
+        {
+            "SOFTWARE" => Software,
+            "ANGLEEGL" => AngleEgl,
+            "ANGLE_EGL" => AngleEgl,
+            "WGL" => Wgl,
+            "VULKAN" => Vulkan,
+            _ => Default
+        };
+    }
+
+    public static Win32RenderingMode[]? GetWin32RenderingModes(string? value)
+    {
+        return Normalize(value) switch
+        {
+            Software => [Win32RenderingMode.Software],
+            AngleEgl => [Win32RenderingMode.AngleEgl, Win32RenderingMode.Software],
+            Wgl => [Win32RenderingMode.Wgl, Win32RenderingMode.Software],
+            Vulkan => [Win32RenderingMode.Vulkan, Win32RenderingMode.Software],
+            _ => null
+        };
+    }
+}

LanMountainDesktop/Services/AppRestartService.cs

@@ -0,0 +1,171 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.IO;
+using System.Reflection;
+using Avalonia;
+using Avalonia.Controls.ApplicationLifetimes;
+
+namespace LanMountainDesktop.Services;
+
+public static class AppRestartService
+{
+    public static bool TryRestartApplication()
+    {
+        if (!TryRestartCurrentProcess())
+        {
+            return false;
+        }
+
+        if (Application.Current?.ApplicationLifetime is IClassicDesktopStyleApplicationLifetime desktop)
+        {
+            desktop.Shutdown();
+        }
+
+        return true;
+    }
+
+    public static bool TryRestartCurrentProcess()
+    {
+        try
+        {
+            var startInfo = CreateRestartStartInfo();
+            if (startInfo is null)
+            {
+                Debug.WriteLine("[AppRestart] Failed to resolve restart start info.");
+                return false;
+            }
+
+            Process.Start(startInfo);
+            return true;
+        }
+        catch (Exception ex)
+        {
+            Debug.WriteLine($"[AppRestart] Failed to restart app: {ex}");
+            return false;
+        }
+    }
+
+    public static ProcessStartInfo? CreateRestartStartInfo(
+        string[]? commandLineArgs = null,
+        string? processPath = null,
+        string? entryAssemblyLocation = null)
+    {
+        var args = commandLineArgs ?? Environment.GetCommandLineArgs();
+        var resolvedProcessPath = NormalizeExistingPath(processPath ?? Environment.ProcessPath);
+        var resolvedEntryAssemblyPath = NormalizeExistingPath(
+            entryAssemblyLocation ?? Assembly.GetEntryAssembly()?.Location);
+
+        if (IsDotnetHost(resolvedProcessPath))
+        {
+            return CreateDotnetStartInfo(
+                resolvedProcessPath!,
+                resolvedEntryAssemblyPath,
+                args);
+        }
+
+        if (!string.IsNullOrWhiteSpace(resolvedProcessPath))
+        {
+            return CreateExecutableStartInfo(
+                resolvedProcessPath,
+                resolvedEntryAssemblyPath,
+                args);
+        }
+
+        if (!string.IsNullOrWhiteSpace(resolvedEntryAssemblyPath) &&
+            string.Equals(Path.GetExtension(resolvedEntryAssemblyPath), ".dll", StringComparison.OrdinalIgnoreCase))
+        {
+            return CreateDotnetStartInfo(
+                "dotnet",
+                resolvedEntryAssemblyPath,
+                args);
+        }
+
+        return null;
+    }
+
+    private static ProcessStartInfo CreateExecutableStartInfo(
+        string executablePath,
+        string? entryAssemblyPath,
+        IReadOnlyList<string> commandLineArgs)
+    {
+        var startInfo = new ProcessStartInfo
+        {
+            FileName = executablePath,
+            UseShellExecute = false,
+            WorkingDirectory = ResolveWorkingDirectory(executablePath, entryAssemblyPath)
+        };
+
+        AppendArguments(startInfo, commandLineArgs);
+        return startInfo;
+    }
+
+    private static ProcessStartInfo? CreateDotnetStartInfo(
+        string dotnetHostPath,
+        string? entryAssemblyPath,
+        IReadOnlyList<string> commandLineArgs)
+    {
+        if (string.IsNullOrWhiteSpace(entryAssemblyPath))
+        {
+            return null;
+        }
+
+        var startInfo = new ProcessStartInfo
+        {
+            FileName = dotnetHostPath,
+            UseShellExecute = false,
+            WorkingDirectory = ResolveWorkingDirectory(dotnetHostPath, entryAssemblyPath)
+        };
+
+        startInfo.ArgumentList.Add(entryAssemblyPath);
+        AppendArguments(startInfo, commandLineArgs);
+        return startInfo;
+    }
+
+    private static void AppendArguments(ProcessStartInfo startInfo, IReadOnlyList<string> commandLineArgs)
+    {
+        for (var i = 1; i < commandLineArgs.Count; i++)
+        {
+            startInfo.ArgumentList.Add(commandLineArgs[i]);
+        }
+    }
+
+    private static string? NormalizeExistingPath(string? path)
+    {
+        if (string.IsNullOrWhiteSpace(path))
+        {
+            return null;
+        }
+
+        try
+        {
+            var fullPath = Path.GetFullPath(path);
+            return File.Exists(fullPath) ? fullPath : null;
+        }
+        catch
+        {
+            return null;
+        }
+    }
+
+    private static bool IsDotnetHost(string? processPath)
+    {
+        if (string.IsNullOrWhiteSpace(processPath))
+        {
+            return false;
+        }
+
+        var fileName = Path.GetFileName(processPath);
+        return string.Equals(fileName, "dotnet", StringComparison.OrdinalIgnoreCase) ||
+               string.Equals(fileName, "dotnet.exe", StringComparison.OrdinalIgnoreCase);
+    }
+
+    private static string ResolveWorkingDirectory(string launchPath, string? entryAssemblyPath)
+    {
+        var basePath = !string.IsNullOrWhiteSpace(entryAssemblyPath)
+            ? entryAssemblyPath
+            : launchPath;
+
+        return Path.GetDirectoryName(basePath) ?? AppContext.BaseDirectory;
+    }
+}

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/PendingRestartStateService.cs

@@ -0,0 +1,55 @@
+using System;
+using System.Collections.Generic;
+
+namespace LanMountainDesktop.Services;
+
+public static class PendingRestartStateService
+{
+    public const string RenderModeReason = "RenderMode";
+    public const string PluginCatalogReason = "PluginCatalog";
+
+    private static readonly object Gate = new();
+    private static readonly HashSet<string> PendingReasons = new(StringComparer.OrdinalIgnoreCase);
+
+    public static event Action? StateChanged;
+
+    public static bool HasPendingRestart
+    {
+        get
+        {
+            lock (Gate)
+            {
+                return PendingReasons.Count > 0;
+            }
+        }
+    }
+
+    public static bool HasPendingReason(string reason)
+    {
+        lock (Gate)
+        {
+            return PendingReasons.Contains(reason);
+        }
+    }
+
+    public static void SetPending(string reason, bool pending)
+    {
+        if (string.IsNullOrWhiteSpace(reason))
+        {
+            return;
+        }
+
+        var changed = false;
+        lock (Gate)
+        {
+            changed = pending
+                ? PendingReasons.Add(reason)
+                : PendingReasons.Remove(reason);
+        }
+
+        if (changed)
+        {
+            StateChanged?.Invoke();
+        }
+    }
+}

LanMountainDesktop/Services/ResumableDownloadService.cs

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

LanMountainDesktop/Views/MainWindow.Localization.cs

@@ -1,10 +1,12 @@
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using Avalonia.Controls;
 using Avalonia.Interactivity;
 using Avalonia.Layout;
 using FluentIcons.Avalonia;
 using FluentIcons.Common;
+using LanMountainDesktop.Services;
 
 namespace LanMountainDesktop.Views;
 
@@ -117,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");
@@ -178,6 +181,14 @@ public partial class MainWindow
         StatusBarSpacingCustomPanel.Content = L("settings.status_bar.spacing_custom_label", "Custom spacing (%)");
 
         WeatherPanelTitleTextBlock.Text = L("settings.weather.title", "Weather");
+        WeatherPreviewSectionTextBlock.Text = L("settings.weather.preview_section", "Weather Preview");
+        WeatherSettingsSectionTextBlock.Text = L("settings.weather.settings_section", "Settings");
+        WeatherPreviewSettingsExpander.Header = L("settings.weather.preview_panel_header", "Weather Preview");
+        WeatherPreviewSettingsExpander.Description = L(
+            "settings.weather.preview_panel_desc",
+            "Refresh and verify current weather service status.");
+        WeatherPreviewButton.Content = L("settings.weather.refresh_button", "Refresh");
+
         WeatherLocationSettingsExpander.Header = L("settings.weather.location_source_header", "Location Source");
         WeatherLocationSettingsExpander.Description = L(
             "settings.weather.location_source_desc",
@@ -187,6 +198,10 @@ public partial class MainWindow
         WeatherLocationModeCityChipItem.Content = L("settings.weather.mode_city_search", "City Search");
         WeatherLocationModeCoordinatesChipItem.Content = L("settings.weather.mode_coordinates", "Coordinates");
         WeatherAutoRefreshToggleSwitch.Content = L("settings.weather.auto_refresh", "Auto refresh location on startup");
+        WeatherLocationSelectionTitleTextBlock.Text = L("settings.weather.city_selection_label", "City Selection");
+        WeatherLocationSelectionDescriptionTextBlock.Text = L(
+            "settings.weather.location_city_summary_desc",
+            "Select the current city used for weather queries.");
 
         WeatherCitySearchSettingsExpander.Header = L("settings.weather.city_search_header", "City Search");
         WeatherCitySearchSettingsExpander.Description = L(
@@ -206,24 +221,12 @@ public partial class MainWindow
         WeatherLocationNameTextBox.Watermark = L("settings.weather.location_name_placeholder", "Display name (optional)");
         WeatherApplyCoordinatesButton.Content = L("settings.weather.apply_coordinates_button", "Apply Coordinates");
 
-        WeatherPreviewSettingsExpander.Header = L("settings.weather.preview_panel_header", "Weather Preview");
-        WeatherPreviewSettingsExpander.Description = L(
-            "settings.weather.preview_panel_desc",
-            "Refresh and verify current weather service status.");
-        WeatherPreviewButton.Content = L("settings.weather.refresh_button", "Refresh");
-
-        WeatherLocationSettingsExpander.Header = L("settings.weather.location_msg_header", "Location Source");
-        WeatherLocationSettingsExpander.Description = L(
-            "settings.weather.location_msg_desc",
-            "Choose how weather widgets resolve location.");
-        WeatherLocationModeCityChipItem.Content = L("settings.weather.mode_city", "City Search");
-        WeatherLocationModeCoordinatesChipItem.Content = L("settings.weather.mode_coordinates", "Coordinates");
-        WeatherAutoRefreshToggleSwitch.Content = L("settings.weather.auto_location_toggle", "Auto refresh location on startup");
-
         WeatherAlertFilterSettingsExpander.Header = L("settings.weather.alert_filter_header", "Excluded Alerts");
         WeatherAlertFilterSettingsExpander.Description = L(
             "settings.weather.alert_filter_desc",
             "Alerts containing these words will not be shown. One rule per line.");
+        WeatherAlertListTitleTextBlock.Text = L("settings.weather.alert_list_label", "Exclude List");
+        WeatherAlertListDescriptionTextBlock.Text = L("settings.weather.alert_list_desc", "One exclusion rule per line.");
         WeatherExcludedAlertsTextBox.Watermark = L("settings.weather.alert_filter_placeholder", "One keyword per line");
 
         WeatherIconPackSettingsExpander.Header = L("settings.weather.icon_style_header", "Weather Icon Style");
@@ -237,6 +240,10 @@ public partial class MainWindow
         WeatherNoTlsSettingsExpander.Description = L(
             "settings.weather.no_tls_desc",
             "Not recommended. Enable only for incompatible network environments.");
+        WeatherNoTlsToggleSwitch.Content = L("settings.weather.no_tls_toggle", "Allow non-TLS request fallback");
+        WeatherFooterHintTextBlock.Text = L(
+            "settings.weather.footer_hint",
+            "Desktop weather widgets will reuse the location and alert exclusion settings configured here.");
 
         if (string.IsNullOrWhiteSpace(_weatherSearchKeyword))
         {
@@ -276,26 +283,8 @@ public partial class MainWindow
             "Right-click an icon in launcher to hide it. Hidden entries appear here.");
         LauncherHiddenItemsEmptyTextBlock.Text = L("settings.launcher.hidden_empty", "No hidden items.");
 
-        PluginSettingsPanelTitleTextBlock.Text = L("settings.plugins.title", "Plugins");
-        PluginSystemSettingsExpander.Header = L("settings.plugins.runtime_header", "Plugin Runtime");
-        PluginSystemSettingsExpander.Description = L(
-            "settings.plugins.runtime_desc",
-            "Review plugin runtime state and load results.");
-        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.");
-        PluginCatalogEmptyTextBlock.Text = L("settings.plugins.empty", "No plugins found.");
-        PluginSettingsPanel.RefreshFromRuntime();
+        ApplyPluginSettingsLocalization();
+        ApplyPluginMarketSettingsLocalization();
 
         SettingsNavAboutItem.Content = L("settings.nav.about", "About");
         AboutPanelTitleTextBlock.Text = L("settings.about.title", "About");
@@ -315,6 +304,17 @@ public partial class MainWindow
         AboutStartupSettingsExpander.Description = L(
             "settings.about.startup_desc",
             "Launch the app automatically when signing in to Windows.");
+        AboutRenderModeSettingsExpander.Header = L("settings.about.render_mode_header", "Rendering Mode");
+        AboutRenderModeSettingsExpander.Description = L(
+            "settings.about.render_mode_desc",
+            "Choose the rendering backend. Restart the app after changing this option. Unsupported modes fall back to software.");
+        SetAppRenderModeComboItemContent(AppRenderingModeHelper.Default, L("settings.about.render_mode.default", "Default"));
+        SetAppRenderModeComboItemContent(AppRenderingModeHelper.Software, L("settings.about.render_mode.software", "Software"));
+        SetAppRenderModeComboItemContent(AppRenderingModeHelper.AngleEgl, L("settings.about.render_mode.angle_egl", "angleEgl"));
+        SetAppRenderModeComboItemContent(AppRenderingModeHelper.Wgl, L("settings.about.render_mode.wgl", "WGL"));
+        SetAppRenderModeComboItemContent(AppRenderingModeHelper.Vulkan, L("settings.about.render_mode.vulkan", "Vulkan"));
+        UpdateCurrentRenderBackendStatus();
+        UpdatePendingRestartDock();
 
         if (WallpaperPlacementComboBox?.ItemCount >= 5)
         {
@@ -341,6 +341,19 @@ public partial class MainWindow
         UpdateWallpaperDisplay();
     }
 
+    private void SetAppRenderModeComboItemContent(string tag, string content)
+    {
+        var item = AppRenderModeComboBox.Items
+            .OfType<ComboBoxItem>()
+            .FirstOrDefault(candidate =>
+                string.Equals(candidate.Tag?.ToString(), tag, StringComparison.OrdinalIgnoreCase));
+
+        if (item is not null)
+        {
+            item.Content = content;
+        }
+    }
+
     private string GetLocalizedTimeZoneDisplayName(TimeZoneInfo timeZone)
     {
         var offset = timeZone.GetUtcOffset(DateTime.UtcNow);
@@ -411,6 +424,7 @@ public partial class MainWindow
                 WeatherLocationStatusTextBlock.Text = L(
                     "settings.weather.status_city_empty",
                     "No city location is configured.");
+                UpdateWeatherLocationSummaryCard();
                 return;
             }
 
@@ -423,6 +437,7 @@ public partial class MainWindow
                 modeText,
                 locationName,
                 _weatherLocationKey);
+            UpdateWeatherLocationSummaryCard();
             return;
         }
 
@@ -435,6 +450,7 @@ public partial class MainWindow
             string.IsNullOrWhiteSpace(_weatherLocationKey)
                 ? BuildCoordinateLocationKey(_weatherLatitude, _weatherLongitude)
                 : _weatherLocationKey);
+        UpdateWeatherLocationSummaryCard();
     }
 }
 

LanMountainDesktop/Views/MainWindow.RenderBackend.cs

@@ -0,0 +1,42 @@
+using System;
+using LanMountainDesktop.Services;
+
+namespace LanMountainDesktop.Views;
+
+public partial class MainWindow
+{
+    private void UpdateCurrentRenderBackendStatus()
+    {
+        var backendInfo = AppRenderBackendDiagnostics.Detect();
+        var localizedBackend = GetLocalizedRenderBackendName(backendInfo.ActualBackend);
+
+        CurrentRenderBackendLabelTextBlock.Text = L(
+            "settings.about.render_mode.current_label",
+            "Current actual backend");
+        CurrentRenderBackendValueTextBlock.Text = Lf(
+            "settings.about.render_mode.current_format",
+            "Current backend: {0}",
+            localizedBackend);
+        CurrentRenderBackendImplementationTextBlock.Text = string.IsNullOrWhiteSpace(backendInfo.ImplementationTypeName)
+            ? L(
+                "settings.about.render_mode.impl_unavailable",
+                "Runtime implementation is unavailable.")
+            : Lf(
+                "settings.about.render_mode.impl_format",
+                "Runtime implementation: {0}",
+                backendInfo.ImplementationTypeName);
+    }
+
+    private string GetLocalizedRenderBackendName(string renderBackend)
+    {
+        return renderBackend switch
+        {
+            AppRenderingModeHelper.Default => L("settings.about.render_mode.default", "Default"),
+            AppRenderingModeHelper.Software => L("settings.about.render_mode.software", "Software"),
+            AppRenderingModeHelper.AngleEgl => L("settings.about.render_mode.angle_egl", "angleEgl"),
+            AppRenderingModeHelper.Wgl => L("settings.about.render_mode.wgl", "WGL"),
+            AppRenderingModeHelper.Vulkan => L("settings.about.render_mode.vulkan", "Vulkan"),
+            _ => L("settings.about.render_mode.unknown", "Unknown")
+        };
+    }
+}

LanMountainDesktop/Views/MainWindow.RestartPrompt.cs

@@ -0,0 +1,112 @@
+using System.Threading.Tasks;
+using Avalonia.Interactivity;
+using Avalonia.Threading;
+using FluentAvalonia.UI.Controls;
+using LanMountainDesktop.Services;
+
+namespace LanMountainDesktop.Views;
+
+public partial class MainWindow
+{
+    private bool _isRestartPromptVisible;
+
+    private void OnPendingRestartStateChanged()
+    {
+        if (Dispatcher.UIThread.CheckAccess())
+        {
+            UpdatePendingRestartDock();
+            return;
+        }
+
+        Dispatcher.UIThread.Post(UpdatePendingRestartDock);
+    }
+
+    private void UpdatePendingRestartDock()
+    {
+        PendingRestartDock.IsVisible = PendingRestartStateService.HasPendingRestart;
+        PendingRestartDockTitleTextBlock.Text = L("settings.restart_dock.title", "Restart required");
+        PendingRestartDockDescriptionTextBlock.Text = L(
+            "settings.restart_dock.description",
+            "Some changes will take effect after restarting the app.");
+        PendingRestartDockButtonTextBlock.Text = L("settings.restart_dock.button", "Restart app");
+    }
+
+    private async void OnPendingRestartDockButtonClick(object? sender, RoutedEventArgs e)
+    {
+        await ShowGenericRestartPromptAsync();
+    }
+
+    private Task ShowRenderModeRestartPromptAsync(string selectedMode)
+    {
+        var message = Lf(
+            "settings.restart_dialog.render_mode_message",
+            "Restart the app to switch the rendering mode from \"{0}\" to \"{1}\". Restart now?",
+            GetLocalizedAppRenderModeDisplayName(_runningAppRenderMode),
+            GetLocalizedAppRenderModeDisplayName(selectedMode));
+
+        return ShowRestartPromptCoreAsync(message);
+    }
+
+    private Task ShowGenericRestartPromptAsync()
+    {
+        return ShowRestartPromptCoreAsync(L(
+            "settings.restart_dock.description",
+            "Some changes will take effect after restarting the app."));
+    }
+
+    private async Task ShowRestartPromptCoreAsync(string message)
+    {
+        if (_isRestartPromptVisible)
+        {
+            return;
+        }
+
+        _isRestartPromptVisible = true;
+
+        try
+        {
+            var dialog = new ContentDialog
+            {
+                Title = L("settings.restart_dialog.title", "Restart required"),
+                Content = message,
+                PrimaryButtonText = L("settings.restart_dialog.restart", "Restart now"),
+                CloseButtonText = L("settings.restart_dialog.cancel", "Cancel"),
+                DefaultButton = ContentDialogButton.Primary
+            };
+
+            var result = await dialog.ShowAsync(this);
+            if (result == ContentDialogResult.Primary)
+            {
+                if (!AppRestartService.TryRestartApplication())
+                {
+                    UpdatePendingRestartDock();
+                }
+
+                return;
+            }
+
+            UpdatePendingRestartDock();
+        }
+        finally
+        {
+            _isRestartPromptVisible = false;
+        }
+    }
+
+    private string GetLocalizedAppRenderModeDisplayName(string renderMode)
+    {
+        if (renderMode == AppRenderBackendDiagnostics.Unknown)
+        {
+            return L("settings.about.render_mode.unknown", "Unknown");
+        }
+
+        return AppRenderingModeHelper.Normalize(renderMode) switch
+        {
+            AppRenderingModeHelper.Software => L("settings.about.render_mode.software", "Software"),
+            AppRenderingModeHelper.AngleEgl => L("settings.about.render_mode.angle_egl", "angleEgl"),
+            AppRenderingModeHelper.Wgl => L("settings.about.render_mode.wgl", "WGL"),
+            AppRenderingModeHelper.Vulkan => L("settings.about.render_mode.vulkan", "Vulkan"),
+            _ => L("settings.about.render_mode.default", "Default")
+        };
+    }
+}

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();
@@ -978,6 +990,7 @@ public partial class MainWindow
             InitializeWeatherSettings(snapshot);
             _ = _componentSettingsService.Load();
             InitializeAutoStartWithWindowsSetting(snapshot);
+            InitializeAppRenderModeSetting(snapshot);
             InitializeUpdateSettings(snapshot);
             InitializeDesktopSurfaceState(desktopLayoutSnapshot);
             InitializeLauncherVisibilitySettings(launcherSnapshot);
@@ -1040,6 +1053,7 @@ public partial class MainWindow
         snapshot.WeatherIconPackId = _weatherIconPackId;
         snapshot.WeatherNoTlsRequests = _weatherNoTlsRequests;
         snapshot.AutoStartWithWindows = _autoStartWithWindows;
+        snapshot.AppRenderMode = _selectedAppRenderMode;
         snapshot.AutoCheckUpdates = _autoCheckUpdates;
         snapshot.IncludePrereleaseUpdates = IncludePrereleaseUpdates;
         snapshot.UpdateChannel = IncludePrereleaseUpdates ? UpdateChannelPreview : UpdateChannelStable;
@@ -1220,6 +1234,61 @@ public partial class MainWindow
         }
     }
 
+    private void InitializeAppRenderModeSetting(AppSettingsSnapshot snapshot)
+    {
+        _selectedAppRenderMode = AppRenderingModeHelper.Normalize(snapshot.AppRenderMode);
+        _runningAppRenderMode = ResolveActiveAppRenderModeForUi(_selectedAppRenderMode);
+        var renderModeForUi = PendingRestartStateService.HasPendingReason(PendingRestartStateService.RenderModeReason)
+            ? _selectedAppRenderMode
+            : _runningAppRenderMode;
+
+        if (AppRenderModeComboBox is null)
+        {
+            return;
+        }
+
+        _suppressAppRenderModeSelectionEvents = true;
+        try
+        {
+            AppRenderModeComboBox.IsEnabled = OperatingSystem.IsWindows();
+            SelectAppRenderModeInUi(renderModeForUi);
+        }
+        finally
+        {
+            _suppressAppRenderModeSelectionEvents = false;
+        }
+    }
+
+    private void SelectAppRenderModeInUi(string renderMode)
+    {
+        if (AppRenderModeComboBox is null)
+        {
+            return;
+        }
+
+        AppRenderModeComboBox.SelectedIndex = GetAppRenderModeComboBoxIndex(renderMode);
+    }
+
+    private static int GetAppRenderModeComboBoxIndex(string renderMode)
+    {
+        return AppRenderingModeHelper.Normalize(renderMode) switch
+        {
+            AppRenderingModeHelper.Software => 1,
+            AppRenderingModeHelper.AngleEgl => 2,
+            AppRenderingModeHelper.Wgl => 3,
+            AppRenderingModeHelper.Vulkan => 4,
+            _ => 0
+        };
+    }
+
+    private static string ResolveActiveAppRenderModeForUi(string configuredRenderMode)
+    {
+        var detectedRenderMode = AppRenderBackendDiagnostics.Detect().ActualBackend;
+        return string.Equals(detectedRenderMode, AppRenderBackendDiagnostics.Unknown, StringComparison.Ordinal)
+            ? configuredRenderMode
+            : AppRenderingModeHelper.Normalize(detectedRenderMode);
+    }
+
     private static WeatherLocationMode ParseWeatherLocationMode(string? value)
     {
         return string.Equals(value, "Coordinates", StringComparison.OrdinalIgnoreCase)
@@ -1339,6 +1408,8 @@ public partial class MainWindow
         {
             WeatherCoordinateSettingsExpander.IsVisible = _weatherLocationMode == WeatherLocationMode.Coordinates;
         }
+
+        UpdateWeatherLocationSummaryCard();
     }
 
     private void OnWeatherLocationModeSelectionChanged(object? sender, SelectionChangedEventArgs e)
@@ -1487,6 +1558,33 @@ public partial class MainWindow
         PersistSettings();
     }
 
+    private void OnAppRenderModeSelectionChanged(object? sender, SelectionChangedEventArgs e)
+    {
+        if (_suppressAppRenderModeSelectionEvents || AppRenderModeComboBox is null)
+        {
+            return;
+        }
+
+        var selectedMode = AppRenderingModeHelper.Normalize(
+            TryGetSelectedComboBoxTag(AppRenderModeComboBox));
+
+        if (string.Equals(_selectedAppRenderMode, selectedMode, StringComparison.Ordinal))
+        {
+            return;
+        }
+
+        _selectedAppRenderMode = selectedMode;
+        PersistSettings();
+        var requiresRestart = !string.Equals(_runningAppRenderMode, selectedMode, StringComparison.Ordinal);
+        PendingRestartStateService.SetPending(PendingRestartStateService.RenderModeReason, requiresRestart);
+        UpdatePendingRestartDock();
+
+        if (requiresRestart)
+        {
+            _ = ShowRenderModeRestartPromptAsync(selectedMode);
+        }
+    }
+
     private async void OnSearchWeatherCityClick(object? sender, RoutedEventArgs e)
     {
         if (_isWeatherSearchInProgress || WeatherCitySearchTextBox is null || WeatherCityResultsComboBox is null)
@@ -1795,7 +1893,7 @@ public partial class MainWindow
             var weather = snapshot.Current.WeatherText ??
                           L("settings.weather.preview_unknown", "Unknown");
             var temperature = snapshot.Current.TemperatureC.HasValue
-                ? string.Create(CultureInfo.InvariantCulture, $"{snapshot.Current.TemperatureC.Value:F1} C")
+                ? FormatWeatherPreviewTemperature(snapshot.Current.TemperatureC.Value)
                 : "--";
             var updatedAt = snapshot.ObservationTime ?? snapshot.FetchedAt;
 
@@ -1838,6 +1936,14 @@ public partial class MainWindow
 
     private void UpdateWeatherPreviewSummary(int? weatherCode, string temperatureText, DateTimeOffset? updatedAt)
     {
+        if (WeatherPreviewIconImage is not null)
+        {
+            var kind = HyperOS3WeatherTheme.ResolveVisualKind(weatherCode, _isNightMode);
+            WeatherPreviewIconImage.Source = HyperOS3WeatherAssetLoader.LoadImage(
+                HyperOS3WeatherTheme.ResolveIconAsset(kind)) ??
+                HyperOS3WeatherAssetLoader.LoadImage(HyperOS3WeatherTheme.ResolveHeroIconAsset(kind));
+        }
+
         if (WeatherPreviewIconSymbol is not null)
         {
             WeatherPreviewIconSymbol.Symbol = ResolveWeatherPreviewSymbol(weatherCode, _isNightMode);
@@ -1857,10 +1963,15 @@ public partial class MainWindow
         }
 
         WeatherPreviewUpdatedTextBlock.Text = updatedAt.HasValue
-            ? Lf("weather.widget.updated_format", "Updated {0:HH:mm}", updatedAt.Value.LocalDateTime)
+            ? updatedAt.Value.LocalDateTime.ToString("yyyy/M/d HH:mm:ss", CultureInfo.InvariantCulture)
             : "-";
     }
 
+    private static string FormatWeatherPreviewTemperature(double temperatureC)
+    {
+        return string.Create(CultureInfo.InvariantCulture, $"{temperatureC:0.#}°C");
+    }
+
     private static Symbol ResolveWeatherPreviewSymbol(int? weatherCode, bool isNight)
     {
         return weatherCode switch
@@ -1876,6 +1987,38 @@ public partial class MainWindow
         };
     }
 
+    private void UpdateWeatherLocationSummaryCard()
+    {
+        if (WeatherLocationSelectionTitleTextBlock is null ||
+            WeatherLocationSelectionDescriptionTextBlock is null ||
+            WeatherLocationValueTextBlock is null)
+        {
+            return;
+        }
+
+        if (_weatherLocationMode == WeatherLocationMode.Coordinates)
+        {
+            WeatherLocationSelectionTitleTextBlock.Text = L("settings.weather.coordinates_selection_label", "Coordinate Location");
+            WeatherLocationSelectionDescriptionTextBlock.Text = L(
+                "settings.weather.location_coordinates_summary_desc",
+                "Set latitude/longitude and optional location name used for weather queries.");
+            WeatherLocationValueTextBlock.Text = string.IsNullOrWhiteSpace(_weatherLocationName)
+                ? string.Create(CultureInfo.InvariantCulture, $"{_weatherLatitude:F4}, {_weatherLongitude:F4}")
+                : _weatherLocationName;
+            return;
+        }
+
+        WeatherLocationSelectionTitleTextBlock.Text = L("settings.weather.city_selection_label", "City Selection");
+        WeatherLocationSelectionDescriptionTextBlock.Text = L(
+            "settings.weather.location_city_summary_desc",
+            "Select the current city used for weather queries.");
+        WeatherLocationValueTextBlock.Text = !string.IsNullOrWhiteSpace(_weatherLocationName)
+            ? _weatherLocationName
+            : !string.IsNullOrWhiteSpace(_weatherLocationKey)
+                ? _weatherLocationKey
+                : L("settings.weather.location_not_selected", "No location selected");
+    }
+
     private void SetWeatherSearchBusy(bool isBusy)
     {
         if (WeatherSearchButton is not null)
@@ -2577,6 +2720,8 @@ public partial class MainWindow
 
     // --- WeatherSettingsPage ---
     internal TextBlock WeatherPanelTitleTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherPanelTitleTextBlock")!;
+    internal TextBlock WeatherPreviewSectionTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherPreviewSectionTextBlock")!;
+    internal TextBlock WeatherSettingsSectionTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherSettingsSectionTextBlock")!;
     internal FluentAvalonia.UI.Controls.SettingsExpander WeatherPreviewSettingsExpander => WeatherSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("WeatherPreviewSettingsExpander")!;
     internal FluentAvalonia.UI.Controls.SettingsExpander WeatherLocationSettingsExpander => WeatherSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("WeatherLocationSettingsExpander")!;
     internal FluentAvalonia.UI.Controls.SettingsExpander WeatherCitySearchSettingsExpander => WeatherSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("WeatherCitySearchSettingsExpander")!;
@@ -2607,6 +2752,7 @@ public partial class MainWindow
     internal FluentAvalonia.UI.Controls.NumberBox WeatherLongitudeNumberBox => WeatherSettingsPanel.FindControl<FluentAvalonia.UI.Controls.NumberBox>("WeatherLongitudeNumberBox")!;
     internal TextBlock WeatherCoordinateStatusTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherCoordinateStatusTextBlock")!;
     internal TextBlock WeatherPreviewResultTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherPreviewResultTextBlock")!;
+    internal Image WeatherPreviewIconImage => WeatherSettingsPanel.FindControl<Image>("WeatherPreviewIconImage")!;
     internal FluentIcons.Avalonia.Fluent.SymbolIcon WeatherPreviewIconSymbol => WeatherSettingsPanel.FindControl<FluentIcons.Avalonia.Fluent.SymbolIcon>("WeatherPreviewIconSymbol")!;
     internal TextBlock WeatherPreviewTemperatureTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherPreviewTemperatureTextBlock")!;
     internal TextBlock WeatherPreviewUpdatedTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherPreviewUpdatedTextBlock")!;
@@ -2614,7 +2760,13 @@ public partial class MainWindow
     internal FluentAvalonia.UI.Controls.ProgressRing WeatherPreviewProgressRing => WeatherSettingsPanel.FindControl<FluentAvalonia.UI.Controls.ProgressRing>("WeatherPreviewProgressRing")!;
     internal ComboBoxItem WeatherIconPackFluentRegularItem => WeatherSettingsPanel.FindControl<ComboBoxItem>("WeatherIconPackFluentRegularItem")!;
     internal ComboBoxItem WeatherIconPackFluentFilledItem => WeatherSettingsPanel.FindControl<ComboBoxItem>("WeatherIconPackFluentFilledItem")!;
+    internal TextBlock WeatherLocationSelectionTitleTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherLocationSelectionTitleTextBlock")!;
+    internal TextBlock WeatherLocationSelectionDescriptionTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherLocationSelectionDescriptionTextBlock")!;
+    internal TextBlock WeatherLocationValueTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherLocationValueTextBlock")!;
     internal TextBlock WeatherLocationStatusTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherLocationStatusTextBlock")!;
+    internal TextBlock WeatherAlertListTitleTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherAlertListTitleTextBlock")!;
+    internal TextBlock WeatherAlertListDescriptionTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherAlertListDescriptionTextBlock")!;
+    internal TextBlock WeatherFooterHintTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherFooterHintTextBlock")!;
 
     // --- UpdateSettingsPage ---
     internal TextBlock UpdatePanelTitleTextBlock => UpdateSettingsPanel.FindControl<TextBlock>("UpdatePanelTitleTextBlock")!;
@@ -2640,7 +2792,12 @@ public partial class MainWindow
     // --- AboutSettingsPage ---
     internal TextBlock AboutPanelTitleTextBlock => AboutSettingsPanel.FindControl<TextBlock>("AboutPanelTitleTextBlock")!;
     internal FluentAvalonia.UI.Controls.SettingsExpander AboutStartupSettingsExpander => AboutSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("AboutStartupSettingsExpander")!;
+    internal FluentAvalonia.UI.Controls.SettingsExpander AboutRenderModeSettingsExpander => AboutSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("AboutRenderModeSettingsExpander")!;
     internal ToggleSwitch AutoStartWithWindowsToggleSwitch => AboutSettingsPanel.FindControl<ToggleSwitch>("AutoStartWithWindowsToggleSwitch")!;
+    internal ComboBox AppRenderModeComboBox => AboutSettingsPanel.FindControl<ComboBox>("AppRenderModeComboBox")!;
+    internal TextBlock CurrentRenderBackendLabelTextBlock => AboutSettingsPanel.FindControl<TextBlock>("CurrentRenderBackendLabelTextBlock")!;
+    internal TextBlock CurrentRenderBackendValueTextBlock => AboutSettingsPanel.FindControl<TextBlock>("CurrentRenderBackendValueTextBlock")!;
+    internal TextBlock CurrentRenderBackendImplementationTextBlock => AboutSettingsPanel.FindControl<TextBlock>("CurrentRenderBackendImplementationTextBlock")!;
     internal TextBlock VersionTextBlock => AboutSettingsPanel.FindControl<TextBlock>("VersionTextBlock")!;
     internal TextBlock CodeNameTextBlock => AboutSettingsPanel.FindControl<TextBlock>("CodeNameTextBlock")!;
     internal TextBlock FontInfoTextBlock => AboutSettingsPanel.FindControl<TextBlock>("FontInfoTextBlock")!;
@@ -2652,14 +2809,6 @@ public partial class MainWindow
     internal TextBlock LauncherHiddenItemsEmptyTextBlock => LauncherSettingsPanel.FindControl<TextBlock>("LauncherHiddenItemsEmptyTextBlock")!;
     internal TextBlock LauncherHiddenItemsDescriptionTextBlock => LauncherSettingsPanel.FindControl<TextBlock>("LauncherHiddenItemsDescriptionTextBlock")!;
 
-    // --- PluginSettingsPage (Added for completeness) ---
-    internal TextBlock PluginSettingsPanelTitleTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginSettingsPanelTitleTextBlock")!;
-    internal FluentAvalonia.UI.Controls.SettingsExpander PluginSystemSettingsExpander => PluginSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("PluginSystemSettingsExpander")!;
-    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 TextBlock PluginRestartHintTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginRestartHintTextBlock")!;
-    internal TextBlock PluginCatalogEmptyTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginCatalogEmptyTextBlock")!;
 }
 
 

LanMountainDesktop/Views/MainWindow.axaml

@@ -104,7 +104,7 @@
                                 ClipToBounds="True"
                                 BorderThickness="0"
                                 PointerWheelChanged="OnDesktopPagesPointerWheelChanged">
-                            <Grid x:Name="SettingsContentPagesHost">
+                            <Grid>
                                 <Grid x:Name="DesktopPagesHost"
                                       HorizontalAlignment="Left"
                                       VerticalAlignment="Top">
@@ -377,88 +377,144 @@
                 <Border Classes="mica-strong"
                         CornerRadius="{DynamicResource DesignCornerRadiusXl}"
                         Padding="18">
-                    <ui:NavigationView x:Name="SettingsNavView"
-                                       PaneDisplayMode="Left"
-                                       IsSettingsVisible="False"
-                                       OpenPaneLength="220"
-                                       SelectionChanged="OnSettingsNavSelectionChanged">
-                        <ui:NavigationView.MenuItems>
-                            <ui:NavigationViewItem x:Name="SettingsNavWallpaperItem" Content="壁纸" Tag="Wallpaper" ToolTip.Tip="壁纸">
-                                <ui:NavigationViewItem.IconSource>
-                                    <ic:SymbolIconSource Symbol="Wallpaper" IconVariant="Regular" />
-                                </ui:NavigationViewItem.IconSource>
-                            </ui:NavigationViewItem>
-                            <ui:NavigationViewItem x:Name="SettingsNavGridItem" Content="网格" Tag="Grid" ToolTip.Tip="网格">
-                                <ui:NavigationViewItem.IconSource>
-                                    <ic:SymbolIconSource Symbol="Grid" IconVariant="Regular" />
-                                </ui:NavigationViewItem.IconSource>
-                            </ui:NavigationViewItem>
-                            <ui:NavigationViewItem x:Name="SettingsNavColorItem" Content="颜色" Tag="Color" ToolTip.Tip="颜色">
-                                <ui:NavigationViewItem.IconSource>
-                                    <ic:SymbolIconSource Symbol="Color" IconVariant="Regular" />
-                                </ui:NavigationViewItem.IconSource>
-                            </ui:NavigationViewItem>
-                            <ui:NavigationViewItem x:Name="SettingsNavStatusBarItem" Content="状态栏" Tag="StatusBar" ToolTip.Tip="状态栏">
-                                <ui:NavigationViewItem.IconSource>
-                                    <ic:SymbolIconSource Symbol="Status" IconVariant="Regular" />
-                                </ui:NavigationViewItem.IconSource>
-                            </ui:NavigationViewItem>
-                            <ui:NavigationViewItem x:Name="SettingsNavWeatherItem" Content="天气" Tag="Weather" ToolTip.Tip="天气">
-                                <ui:NavigationViewItem.IconSource>
-                                    <ic:SymbolIconSource Symbol="WeatherSunny" IconVariant="Regular" />
-                                </ui:NavigationViewItem.IconSource>
-                            </ui:NavigationViewItem>
-                            <ui:NavigationViewItem x:Name="SettingsNavRegionItem" Content="地区" Tag="Region" ToolTip.Tip="地区">
-                                <ui:NavigationViewItem.IconSource>
-                                    <ic:SymbolIconSource Symbol="Globe" IconVariant="Regular" />
-                                </ui:NavigationViewItem.IconSource>
-                            </ui:NavigationViewItem>
-                            <ui:NavigationViewItem x:Name="SettingsNavUpdateItem" Content="更新" Tag="Update" ToolTip.Tip="更新">
-                                <ui:NavigationViewItem.IconSource>
-                                    <ic:SymbolIconSource Symbol="ArrowSync" IconVariant="Regular" />
-                                </ui:NavigationViewItem.IconSource>
-                            </ui:NavigationViewItem>
-                            <ui:NavigationViewItem x:Name="SettingsNavAboutItem" Content="关于" Tag="About" ToolTip.Tip="关于">
-                                <ui:NavigationViewItem.IconSource>
-                                    <ic:SymbolIconSource Symbol="Info" IconVariant="Regular" />
-                                </ui:NavigationViewItem.IconSource>
-                            </ui:NavigationViewItem>
-                            <ui:NavigationViewItem x:Name="SettingsNavLauncherItem" Content="应用启动台" Tag="Launcher" ToolTip.Tip="应用启动台">
-                                <ui:NavigationViewItem.IconSource>
-                                    <ic:SymbolIconSource Symbol="Apps" IconVariant="Regular" />
-                                </ui:NavigationViewItem.IconSource>
-                            </ui:NavigationViewItem>
-                            <ui:NavigationViewItem x:Name="SettingsNavPluginsItem" Content="插件" Tag="Plugins" ToolTip.Tip="插件">
-                                <ui:NavigationViewItem.IconSource>
-                                    <ic:SymbolIconSource Symbol="PuzzlePiece" IconVariant="Regular" />
-                                </ui:NavigationViewItem.IconSource>
-                            </ui:NavigationViewItem>
-                        </ui:NavigationView.MenuItems>
+                    <Grid RowDefinitions="*,Auto"
+                          RowSpacing="14">
+                        <ui:NavigationView x:Name="SettingsNavView"
+                                           Grid.Row="0"
+                                           PaneDisplayMode="Left"
+                                           IsSettingsVisible="False"
+                                           OpenPaneLength="220"
+                                           SelectionChanged="OnSettingsNavSelectionChanged">
+                            <ui:NavigationView.MenuItems>
+                                <ui:NavigationViewItem x:Name="SettingsNavWallpaperItem" Content="壁纸" Tag="Wallpaper" ToolTip.Tip="壁纸">
+                                    <ui:NavigationViewItem.IconSource>
+                                        <ic:SymbolIconSource Symbol="Wallpaper" IconVariant="Regular" />
+                                    </ui:NavigationViewItem.IconSource>
+                                </ui:NavigationViewItem>
+                                <ui:NavigationViewItem x:Name="SettingsNavGridItem" Content="网格" Tag="Grid" ToolTip.Tip="网格">
+                                    <ui:NavigationViewItem.IconSource>
+                                        <ic:SymbolIconSource Symbol="Grid" IconVariant="Regular" />
+                                    </ui:NavigationViewItem.IconSource>
+                                </ui:NavigationViewItem>
+                                <ui:NavigationViewItem x:Name="SettingsNavColorItem" Content="颜色" Tag="Color" ToolTip.Tip="颜色">
+                                    <ui:NavigationViewItem.IconSource>
+                                        <ic:SymbolIconSource Symbol="Color" IconVariant="Regular" />
+                                    </ui:NavigationViewItem.IconSource>
+                                </ui:NavigationViewItem>
+                                <ui:NavigationViewItem x:Name="SettingsNavStatusBarItem" Content="状态栏" Tag="StatusBar" ToolTip.Tip="状态栏">
+                                    <ui:NavigationViewItem.IconSource>
+                                        <ic:SymbolIconSource Symbol="Status" IconVariant="Regular" />
+                                    </ui:NavigationViewItem.IconSource>
+                                </ui:NavigationViewItem>
+                                <ui:NavigationViewItem x:Name="SettingsNavWeatherItem" Content="天气" Tag="Weather" ToolTip.Tip="天气">
+                                    <ui:NavigationViewItem.IconSource>
+                                        <ic:SymbolIconSource Symbol="WeatherSunny" IconVariant="Regular" />
+                                    </ui:NavigationViewItem.IconSource>
+                                </ui:NavigationViewItem>
+                                <ui:NavigationViewItem x:Name="SettingsNavRegionItem" Content="地区" Tag="Region" ToolTip.Tip="地区">
+                                    <ui:NavigationViewItem.IconSource>
+                                        <ic:SymbolIconSource Symbol="Globe" IconVariant="Regular" />
+                                    </ui:NavigationViewItem.IconSource>
+                                </ui:NavigationViewItem>
+                                <ui:NavigationViewItem x:Name="SettingsNavUpdateItem" Content="更新" Tag="Update" ToolTip.Tip="更新">
+                                    <ui:NavigationViewItem.IconSource>
+                                        <ic:SymbolIconSource Symbol="ArrowSync" IconVariant="Regular" />
+                                    </ui:NavigationViewItem.IconSource>
+                                </ui:NavigationViewItem>
+                                <ui:NavigationViewItem x:Name="SettingsNavAboutItem" Content="关于" Tag="About" ToolTip.Tip="关于">
+                                    <ui:NavigationViewItem.IconSource>
+                                        <ic:SymbolIconSource Symbol="Info" IconVariant="Regular" />
+                                    </ui:NavigationViewItem.IconSource>
+                                </ui:NavigationViewItem>
+                                <ui:NavigationViewItem x:Name="SettingsNavLauncherItem" Content="应用启动台" Tag="Launcher" ToolTip.Tip="应用启动台">
+                                    <ui:NavigationViewItem.IconSource>
+                                        <ic:SymbolIconSource Symbol="Apps" IconVariant="Regular" />
+                                    </ui:NavigationViewItem.IconSource>
+                                </ui:NavigationViewItem>
+                                <ui:NavigationViewItem x:Name="SettingsNavPluginsItem" Content="插件" Tag="Plugins" ToolTip.Tip="插件">
+                                    <ui:NavigationViewItem.IconSource>
+                                        <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"
-                                      Padding="0,0,16,0"
-                                      HorizontalScrollBarVisibility="Disabled"
-                                      VerticalScrollBarVisibility="Auto">
-                            <Grid>
-                                    <pages:WallpaperSettingsPage x:Name="WallpaperSettingsPanel" IsVisible="True" />
+                            <ScrollViewer x:Name="SettingsContentScrollViewer"
+                                          Padding="0,0,16,0"
+                                          HorizontalScrollBarVisibility="Disabled"
+                                          VerticalScrollBarVisibility="Auto">
+                                <Grid x:Name="SettingsContentPagesHost">
+                                        <pages:WallpaperSettingsPage x:Name="WallpaperSettingsPanel" IsVisible="True" />
 
-                                <pages:GridSettingsPage x:Name="GridSettingsPanel" IsVisible="False" />
+                                    <pages:GridSettingsPage x:Name="GridSettingsPanel" IsVisible="False" />
 
-                                <pages:ColorSettingsPage x:Name="ColorSettingsPanel" IsVisible="False" />
+                                    <pages:ColorSettingsPage x:Name="ColorSettingsPanel" IsVisible="False" />
 
-                                <pages:StatusBarSettingsPage x:Name="StatusBarSettingsPanel" IsVisible="False" />
-                                
-                                <pages:WeatherSettingsPage x:Name="WeatherSettingsPanel" IsVisible="False" />
-                                <pages:RegionSettingsPage x:Name="RegionSettingsPanel" IsVisible="False" />
+                                    <pages:StatusBarSettingsPage x:Name="StatusBarSettingsPanel" IsVisible="False" />
+                                    
+                                    <pages:WeatherSettingsPage x:Name="WeatherSettingsPanel" IsVisible="False" />
+                                    <pages:RegionSettingsPage x:Name="RegionSettingsPanel" IsVisible="False" />
 
-                                <pages:UpdateSettingsPage x:Name="UpdateSettingsPanel" IsVisible="False" />
+                                    <pages:UpdateSettingsPage x:Name="UpdateSettingsPanel" IsVisible="False" />
 
-                                <pages:LauncherSettingsPage x:Name="LauncherSettingsPanel" IsVisible="False" />
-                                <pages:AboutSettingsPage x:Name="AboutSettingsPanel" IsVisible="False" />
-                                <pages:PluginSettingsPage x:Name="PluginSettingsPanel" IsVisible="False" />
+                                    <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>
+
+                        <Border x:Name="PendingRestartDock"
+                                Grid.Row="1"
+                                IsVisible="False"
+                                Classes="glass-panel"
+                                CornerRadius="18"
+                                Padding="14,12">
+                            <Grid ColumnDefinitions="Auto,*,Auto"
+                                  ColumnSpacing="12">
+                                <Border Width="34"
+                                        Height="34"
+                                        CornerRadius="17"
+                                        Background="{DynamicResource AdaptiveAccentBrush}">
+                                    <fi:FluentIcon Icon="ArrowSync"
+                                                   IconVariant="Regular"
+                                                   FontSize="16"
+                                                   Foreground="White"
+                                                   HorizontalAlignment="Center"
+                                                   VerticalAlignment="Center" />
+                                </Border>
+                                <StackPanel Grid.Column="1"
+                                            Spacing="2"
+                                            VerticalAlignment="Center">
+                                    <TextBlock x:Name="PendingRestartDockTitleTextBlock"
+                                               FontSize="13"
+                                               FontWeight="SemiBold"
+                                               Text="Restart required" />
+                                    <TextBlock x:Name="PendingRestartDockDescriptionTextBlock"
+                                               TextWrapping="Wrap"
+                                               Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
+                                               Text="Your changes will apply after restarting the app." />
+                                </StackPanel>
+                                <Button x:Name="PendingRestartDockButton"
+                                        Grid.Column="2"
+                                        Padding="14,8"
+                                        Click="OnPendingRestartDockButtonClick">
+                                    <StackPanel Orientation="Horizontal" Spacing="8">
+                                        <fi:FluentIcon Icon="ArrowSync"
+                                                       IconVariant="Regular" />
+                                        <TextBlock x:Name="PendingRestartDockButtonTextBlock"
+                                                   VerticalAlignment="Center"
+                                                   Text="Restart app" />
+                                    </StackPanel>
+                                </Button>
                             </Grid>
-                        </ScrollViewer>
-                    </ui:NavigationView>
+                        </Border>
+                    </Grid>
                 </Border>
             </Border>
         </Grid>

LanMountainDesktop/Views/MainWindow.axaml.cs

@@ -167,6 +167,9 @@ public partial class MainWindow : Window
     private bool _weatherNoTlsRequests;
     private bool _autoStartWithWindows;
     private bool _suppressAutoStartToggleEvents;
+    private bool _suppressAppRenderModeSelectionEvents;
+    private string _selectedAppRenderMode = AppRenderingModeHelper.Default;
+    private string _runningAppRenderMode = AppRenderingModeHelper.Default;
     private string _weatherSearchKeyword = string.Empty;
     private bool _isWeatherSearchInProgress;
     private bool _isWeatherPreviewInProgress;
@@ -188,6 +191,7 @@ public partial class MainWindow : Window
         _fluentAvaloniaTheme = Application.Current?.Styles.OfType<FluentAvaloniaTheme>().FirstOrDefault();
         AppSettingsService.SettingsSaved += OnExternalAppSettingsSaved;
         LauncherSettingsService.SettingsSaved += OnExternalLauncherSettingsSaved;
+        PendingRestartStateService.StateChanged += OnPendingRestartStateChanged;
         PropertyChanged += OnWindowPropertyChanged;
         InitializeDesktopSurfaceSwipeHandlers();
         InitializeDesktopComponentDragHandlers();
@@ -201,8 +205,7 @@ public partial class MainWindow : Window
         GridEdgeInsetSlider.ValueChanged += OnGridEdgeInsetSliderChanged;
         ApplyGridButton.Click += OnApplyGridSizeClick;
 
-        NightModeToggleSwitch.Checked += OnNightModeChecked;
-        NightModeToggleSwitch.Unchecked += OnNightModeUnchecked;
+        NightModeToggleSwitch.IsCheckedChanged += OnNightModeIsCheckedChanged;
         RecommendedColorButton1.Click += OnRecommendedColorClick;
         RecommendedColorButton2.Click += OnRecommendedColorClick;
         RecommendedColorButton3.Click += OnRecommendedColorClick;
@@ -217,37 +220,65 @@ public partial class MainWindow : Window
         MonetColorButton5.Click += OnMonetColorClick;
         MonetColorButton6.Click += OnMonetColorClick;
 
-        StatusBarClockToggleSwitch.Checked += OnStatusBarClockChecked;
-        StatusBarClockToggleSwitch.Unchecked += OnStatusBarClockUnchecked;
-        ClockFormatHMSSRadio.Checked += OnClockFormatChanged;
-        ClockFormatHMRadio.Checked += OnClockFormatChanged;
+        StatusBarClockToggleSwitch.IsCheckedChanged += OnStatusBarClockIsCheckedChanged;
+        ClockFormatHMSSRadio.IsCheckedChanged += OnClockFormatChanged;
+        ClockFormatHMRadio.IsCheckedChanged += OnClockFormatChanged;
         StatusBarSpacingModeComboBox.SelectionChanged += OnStatusBarSpacingModeChanged;
         StatusBarSpacingSlider.ValueChanged += OnStatusBarSpacingSliderChanged;
 
         WeatherPreviewButton.Click += OnTestWeatherRequestClick;
         WeatherLocationModeComboBox.SelectionChanged += OnWeatherLocationModeSelectionChanged;
         WeatherLocationModeChipListBox.SelectionChanged += OnWeatherLocationModeChipSelectionChanged;
-        WeatherAutoRefreshToggleSwitch.Checked += OnWeatherAutoRefreshToggled;
-        WeatherAutoRefreshToggleSwitch.Unchecked += OnWeatherAutoRefreshToggled;
+        WeatherAutoRefreshToggleSwitch.IsCheckedChanged += OnWeatherAutoRefreshToggled;
         WeatherSearchButton.Click += OnSearchWeatherCityClick;
         WeatherApplyCityButton.Click += OnApplyWeatherCitySelectionClick;
         WeatherApplyCoordinatesButton.Click += OnApplyWeatherCoordinatesClick;
         WeatherExcludedAlertsTextBox.LostFocus += OnWeatherExcludedAlertsLostFocus;
         WeatherIconPackComboBox.SelectionChanged += OnWeatherIconPackSelectionChanged;
-        WeatherNoTlsToggleSwitch.Checked += OnWeatherNoTlsToggled;
-        WeatherNoTlsToggleSwitch.Unchecked += OnWeatherNoTlsToggled;
+        WeatherNoTlsToggleSwitch.IsCheckedChanged += OnWeatherNoTlsToggled;
 
         LanguageComboBox.SelectionChanged += OnLanguageSelectionChanged;
         TimeZoneComboBox.SelectionChanged += OnTimeZoneSelectionChanged;
 
-        AutoCheckUpdatesToggleSwitch.Checked += OnAutoCheckUpdatesToggled;
-        AutoCheckUpdatesToggleSwitch.Unchecked += OnAutoCheckUpdatesToggled;
+        AutoCheckUpdatesToggleSwitch.IsCheckedChanged += OnAutoCheckUpdatesToggled;
         UpdateChannelChipListBox.SelectionChanged += OnUpdateChannelSelectionChanged;
         CheckForUpdatesButton.Click += OnCheckForUpdatesClick;
         DownloadAndInstallUpdateButton.Click += OnDownloadAndInstallUpdateClick;
 
-        AutoStartWithWindowsToggleSwitch.Checked += OnAutoStartWithWindowsToggled;
-        AutoStartWithWindowsToggleSwitch.Unchecked += OnAutoStartWithWindowsToggled;
+        AutoStartWithWindowsToggleSwitch.IsCheckedChanged += OnAutoStartWithWindowsToggled;
+        AppRenderModeComboBox.SelectionChanged += OnAppRenderModeSelectionChanged;
+    }
+
+    private void OnNightModeIsCheckedChanged(object? sender, RoutedEventArgs e)
+    {
+        if (sender is not ToggleButton toggleButton)
+        {
+            return;
+        }
+
+        if (toggleButton.IsChecked == true)
+        {
+            OnNightModeChecked(sender, e);
+            return;
+        }
+
+        OnNightModeUnchecked(sender, e);
+    }
+
+    private void OnStatusBarClockIsCheckedChanged(object? sender, RoutedEventArgs e)
+    {
+        if (sender is not ToggleButton toggleButton)
+        {
+            return;
+        }
+
+        if (toggleButton.IsChecked == true)
+        {
+            OnStatusBarClockChecked(sender, e);
+            return;
+        }
+
+        OnStatusBarClockUnchecked(sender, e);
     }
 
     protected override void OnOpened(EventArgs e)
@@ -311,6 +342,7 @@ public partial class MainWindow : Window
         InitializeWeatherSettings(snapshot);
         _ = _componentSettingsService.Load();
         InitializeAutoStartWithWindowsSetting(snapshot);
+        InitializeAppRenderModeSetting(snapshot);
         InitializeUpdateSettings(snapshot);
         InitializeDesktopSurfaceState(desktopLayoutSnapshot);
         InitializeLauncherVisibilitySettings(launcherSnapshot);
@@ -376,6 +408,7 @@ public partial class MainWindow : Window
         _wallpaperBitmap = null;
         AppSettingsService.SettingsSaved -= OnExternalAppSettingsSaved;
         LauncherSettingsService.SettingsSaved -= OnExternalLauncherSettingsSaved;
+        PendingRestartStateService.StateChanged -= OnPendingRestartStateChanged;
         PropertyChanged -= OnWindowPropertyChanged;
         DesktopHost.SizeChanged -= OnDesktopHostSizeChanged;
         WallpaperPreviewHost.SizeChanged -= OnWallpaperPreviewHostSizeChanged;
@@ -780,6 +813,11 @@ public partial class MainWindow : Window
             return;
         }
 
+        if (radioButton.IsChecked != true)
+        {
+            return;
+        }
+
         _clockDisplayFormat = formatTag == "Hm" 
             ? ClockDisplayFormat.HourMinute 
             : ClockDisplayFormat.HourMinuteSecond;

LanMountainDesktop/Views/SettingsPages/AboutSettingsPage.axaml

@@ -34,5 +34,46 @@
                 </ui:SettingsExpander.Footer>
             </ui:SettingsExpander>
         </Border>
+
+        <Border Classes="settings-expander-shell">
+            <ui:SettingsExpander x:Name="AboutRenderModeSettingsExpander"
+                                 Header="Rendering Mode"
+                                 Description="Choose the rendering backend. Restart the app after changing this option. Unsupported modes fall back to software."
+                                 IsExpanded="True">
+                <ui:SettingsExpander.IconSource>
+                    <fi:SymbolIconSource Symbol="Window" />
+                </ui:SettingsExpander.IconSource>
+                <StackPanel Spacing="4"
+                            Margin="0,4,0,0">
+                    <TextBlock x:Name="CurrentRenderBackendLabelTextBlock"
+                               Text="Current actual backend"
+                               FontSize="12"
+                               FontWeight="SemiBold"
+                               Foreground="{DynamicResource AdaptiveTextPrimaryBrush}" />
+                    <TextBlock x:Name="CurrentRenderBackendValueTextBlock"
+                               Text="Current backend: Software"
+                               FontSize="13"
+                               TextWrapping="Wrap"
+                               Foreground="{DynamicResource AdaptiveTextPrimaryBrush}" />
+                    <TextBlock x:Name="CurrentRenderBackendImplementationTextBlock"
+                               Text="Runtime implementation is unavailable."
+                               FontSize="12"
+                               TextWrapping="Wrap"
+                               Foreground="{DynamicResource AdaptiveTextSecondaryBrush}" />
+                </StackPanel>
+                <ui:SettingsExpander.Footer>
+                    <ComboBox x:Name="AppRenderModeComboBox"
+                              MinWidth="180"
+                              SelectedIndex="0"
+                              HorizontalAlignment="Right">
+                        <ComboBoxItem Content="Default" Tag="Default" />
+                        <ComboBoxItem Content="Software" Tag="Software" />
+                        <ComboBoxItem Content="angleEgl" Tag="AngleEgl" />
+                        <ComboBoxItem Content="WGL" Tag="Wgl" />
+                        <ComboBoxItem Content="Vulkan" Tag="Vulkan" />
+                    </ComboBox>
+                </ui:SettingsExpander.Footer>
+            </ui:SettingsExpander>
+        </Border>
     </StackPanel>
 </UserControl>

LanMountainDesktop/Views/SettingsPages/WeatherSettingsPage.axaml

@@ -4,91 +4,116 @@
              xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
              xmlns:ui="using:FluentAvalonia.UI.Controls"
              xmlns:fi="using:FluentIcons.Avalonia.Fluent"
-             mc:Ignorable="d" d:DesignWidth="800" d:DesignHeight="1200"
+             mc:Ignorable="d" d:DesignWidth="860" d:DesignHeight="1200"
              x:Class="LanMountainDesktop.Views.SettingsPages.WeatherSettingsPage">
 
+    <UserControl.Styles>
+        <Style Selector="StackPanel.weather-settings-root TextBlock.section-eyebrow">
+            <Setter Property="FontSize" Value="13" />
+            <Setter Property="FontWeight" Value="SemiBold" />
+            <Setter Property="Foreground" Value="{DynamicResource AdaptiveTextSecondaryBrush}" />
+        </Style>
+
+        <Style Selector="StackPanel.weather-settings-root Border.preview-icon-shell">
+            <Setter Property="Width" Value="62" />
+            <Setter Property="Height" Value="62" />
+            <Setter Property="CornerRadius" Value="18" />
+            <Setter Property="Background" Value="{DynamicResource AdaptiveSurfaceRaisedBrush}" />
+            <Setter Property="BorderThickness" Value="1" />
+            <Setter Property="BorderBrush" Value="{DynamicResource AdaptiveButtonBorderBrush}" />
+            <Setter Property="Padding" Value="10" />
+        </Style>
+
+        <Style Selector="StackPanel.weather-settings-root Border.settings-note-shell">
+            <Setter Property="Background" Value="{DynamicResource AdaptiveSurfaceRaisedBrush}" />
+            <Setter Property="CornerRadius" Value="{DynamicResource DesignCornerRadiusSm}" />
+            <Setter Property="Padding" Value="14,12" />
+        </Style>
+
+        <Style Selector="StackPanel.weather-settings-root Border.settings-expander-shell">
+            <Setter Property="Margin" Value="0" />
+        </Style>
+    </UserControl.Styles>
+
     <StackPanel x:Name="WeatherSettingsContentPanel"
+                Classes="settings-animated-intro weather-settings-root"
                 Margin="0,0,8,0"
-                Spacing="16">
+                Spacing="12">
         <TextBlock x:Name="WeatherPanelTitleTextBlock"
-                   FontSize="24"
+                   FontSize="28"
                    FontWeight="SemiBold"
                    Foreground="{DynamicResource AdaptiveTextPrimaryBrush}"
                    Text="Weather" />
 
-        <!-- Weather Preview Card -->
-        <Border Classes="settings-expander-shell">
-            <ui:SettingsExpander x:Name="WeatherPreviewSettingsExpander"
-                                 Header="Weather Preview"
-                                 Description="Refresh and verify current weather service status."
-                                 IsExpanded="True">
-                <ui:SettingsExpander.IconSource>
-                    <fi:SymbolIconSource Symbol="WeatherSunny" />
-                </ui:SettingsExpander.IconSource>
-                <ui:SettingsExpander.Footer>
-                    <StackPanel Orientation="Horizontal" Spacing="8">
-                        <Button x:Name="WeatherPreviewButton"
-                                Padding="12,8"
-                                Content="Refresh" />
-                        <ui:ProgressRing x:Name="WeatherPreviewProgressRing"
-                                         Width="20"
-                                         Height="20"
-                                         IsActive="True"
-                                         IsVisible="False" />
-                    </StackPanel>
-                </ui:SettingsExpander.Footer>
-                
-                <ui:SettingsExpanderItem>
-                    <Grid ColumnDefinitions="Auto,*" ColumnSpacing="12">
-                        <Border Width="44"
-                                Height="44"
-                                CornerRadius="{DynamicResource DesignCornerRadiusXs}"
-                                BorderThickness="1"
-                                BorderBrush="{DynamicResource AdaptiveButtonBorderBrush}"
-                                Background="{DynamicResource AdaptiveButtonBackgroundBrush}">
-                            <fi:SymbolIcon x:Name="WeatherPreviewIconSymbol"
-                                           Symbol="WeatherSunny"
-                                           IconVariant="Regular"
-                                           FontSize="22"
-                                           HorizontalAlignment="Center"
-                                           VerticalAlignment="Center" />
+        <StackPanel Spacing="8">
+            <TextBlock x:Name="WeatherPreviewSectionTextBlock"
+                       Classes="section-eyebrow"
+                       Text="Weather Preview" />
+
+            <Border Classes="settings-expander-shell"
+                    Padding="18,16">
+                <Grid RowDefinitions="Auto,Auto"
+                      RowSpacing="10">
+                    <Grid ColumnDefinitions="Auto,*,Auto"
+                          ColumnSpacing="14">
+                        <Border Classes="preview-icon-shell">
+                            <Image x:Name="WeatherPreviewIconImage"
+                                   Stretch="Uniform" />
                         </Border>
+
                         <StackPanel Grid.Column="1"
                                     VerticalAlignment="Center"
-                                    Spacing="2">
+                                    Spacing="3">
                             <TextBlock x:Name="WeatherPreviewTemperatureTextBlock"
-                                       FontSize="22"
+                                       FontSize="34"
                                        FontWeight="SemiBold"
-                                       Text="--°" />
+                                       Text="--" />
                             <TextBlock x:Name="WeatherPreviewUpdatedTextBlock"
-                                       FontSize="12"
+                                       FontSize="13"
                                        Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
                                        Text="-" />
                         </StackPanel>
+
+                        <StackPanel Grid.Column="2"
+                                    Orientation="Horizontal"
+                                    Spacing="8"
+                                    VerticalAlignment="Center">
+                            <Button x:Name="WeatherPreviewButton"
+                                    Padding="16,8"
+                                    Content="Refresh" />
+                            <ui:ProgressRing x:Name="WeatherPreviewProgressRing"
+                                             Width="20"
+                                             Height="20"
+                                             IsActive="True"
+                                             IsVisible="False" />
+                        </StackPanel>
                     </Grid>
-                </ui:SettingsExpanderItem>
 
-                <ui:SettingsExpanderItem>
                     <TextBlock x:Name="WeatherPreviewResultTextBlock"
-                               Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
+                               Grid.Row="1"
                                TextWrapping="Wrap"
+                               Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
                                Text="Use refresh to verify your weather configuration." />
-                </ui:SettingsExpanderItem>
-            </ui:SettingsExpander>
-        </Border>
+                </Grid>
+            </Border>
+        </StackPanel>
+
+        <Border Background="{DynamicResource SurfaceStrokeColorDefaultBrush}"
+                Height="1" />
+
+        <TextBlock x:Name="WeatherSettingsSectionTextBlock"
+                   Classes="section-eyebrow"
+                   Text="Settings" />
 
-        <!-- Location Source Card -->
         <Border Classes="settings-expander-shell">
             <ui:SettingsExpander x:Name="WeatherLocationSettingsExpander"
                                  Header="Location Source"
                                  Description="Choose how weather widgets resolve location."
                                  IsExpanded="True">
-                <ui:SettingsExpander.IconSource>
-                    <fi:SymbolIconSource Symbol="Location" />
-                </ui:SettingsExpander.IconSource>
                 <ui:SettingsExpander.Footer>
                     <ListBox x:Name="WeatherLocationModeChipListBox"
                              Classes="settings-chip-list"
+                             HorizontalAlignment="Right"
                              SelectionMode="Single">
                         <ListBox.ItemsPanel>
                             <ItemsPanelTemplate>
@@ -104,6 +129,39 @@
                     </ListBox>
                 </ui:SettingsExpander.Footer>
 
+                <ui:SettingsExpanderItem>
+                    <Grid ColumnDefinitions="*,Auto"
+                          ColumnSpacing="18">
+                        <StackPanel Spacing="4">
+                            <TextBlock x:Name="WeatherLocationSelectionTitleTextBlock"
+                                       FontSize="17"
+                                       FontWeight="SemiBold"
+                                       Text="City Selection" />
+                            <TextBlock x:Name="WeatherLocationSelectionDescriptionTextBlock"
+                                       Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
+                                       TextWrapping="Wrap"
+                                       Text="Select the current city used for weather queries." />
+                        </StackPanel>
+
+                        <StackPanel Grid.Column="1"
+                                    MaxWidth="420"
+                                    HorizontalAlignment="Right"
+                                    Spacing="4">
+                            <TextBlock x:Name="WeatherLocationValueTextBlock"
+                                       FontSize="17"
+                                       FontWeight="SemiBold"
+                                       TextAlignment="Right"
+                                       TextWrapping="Wrap"
+                                       Text="No location selected" />
+                            <TextBlock x:Name="WeatherLocationStatusTextBlock"
+                                       FontSize="12"
+                                       TextAlignment="Right"
+                                       TextWrapping="Wrap"
+                                       Foreground="{DynamicResource AdaptiveTextSecondaryBrush}" />
+                        </StackPanel>
+                    </Grid>
+                </ui:SettingsExpanderItem>
+
                 <ui:SettingsExpanderItem>
                     <ui:SettingsExpanderItem.Footer>
                         <ToggleSwitch x:Name="WeatherAutoRefreshToggleSwitch"
@@ -111,16 +169,18 @@
                     </ui:SettingsExpanderItem.Footer>
                 </ui:SettingsExpanderItem>
 
-                <!-- ComboBox hidden as in original -->
                 <ComboBox x:Name="WeatherLocationModeComboBox"
                           IsVisible="False">
-                    <ComboBoxItem x:Name="WeatherLocationModeCityItem" Tag="CitySearch" Content="City Search" />
-                    <ComboBoxItem x:Name="WeatherLocationModeCoordinatesItem" Tag="Coordinates" Content="Coordinates" />
+                    <ComboBoxItem x:Name="WeatherLocationModeCityItem"
+                                  Tag="CitySearch"
+                                  Content="City Search" />
+                    <ComboBoxItem x:Name="WeatherLocationModeCoordinatesItem"
+                                  Tag="Coordinates"
+                                  Content="Coordinates" />
                 </ComboBox>
             </ui:SettingsExpander>
         </Border>
 
-        <!-- City Search Card -->
         <Border Classes="settings-expander-shell">
             <ui:SettingsExpander x:Name="WeatherCitySearchSettingsExpander"
                                  Header="City Search"
@@ -128,38 +188,42 @@
                                  IsExpanded="True">
                 <ui:SettingsExpander.Footer>
                     <Button x:Name="WeatherApplyCityButton"
-                            Padding="12,8"
+                            Padding="14,8"
                             Content="Apply City" />
                 </ui:SettingsExpander.Footer>
 
-                <ui:SettingsExpanderItem Content="Advanced Filters">
-                    <StackPanel Spacing="10">
-                        <Grid ColumnDefinitions="*,Auto,Auto" ColumnSpacing="8">
+                <ui:SettingsExpanderItem>
+                    <StackPanel Spacing="12">
+                        <Grid ColumnDefinitions="*,Auto,Auto"
+                              ColumnSpacing="10">
                             <TextBox x:Name="WeatherCitySearchTextBox"
                                      Watermark="e.g. Beijing" />
                             <ui:ProgressRing x:Name="WeatherSearchProgressRing"
                                              Grid.Column="1"
-                                             Width="24"
-                                             Height="24"
+                                             Width="22"
+                                             Height="22"
                                              IsActive="True"
                                              IsVisible="False" />
                             <Button x:Name="WeatherSearchButton"
                                     Grid.Column="2"
-                                    Padding="12,8"
+                                    Padding="14,8"
                                     Content="Search" />
                         </Grid>
+
                         <ComboBox x:Name="WeatherCityResultsComboBox"
-                                  Width="320" />
+                                  HorizontalAlignment="Stretch"
+                                  MinWidth="320" />
+
                         <TextBlock x:Name="WeatherSearchStatusTextBlock"
                                    FontSize="12"
                                    Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
+                                   TextWrapping="Wrap"
                                    Text="Search by city name and apply one location." />
                     </StackPanel>
                 </ui:SettingsExpanderItem>
             </ui:SettingsExpander>
         </Border>
 
-        <!-- Coordinates Card -->
         <Border Classes="settings-expander-shell">
             <ui:SettingsExpander x:Name="WeatherCoordinateSettingsExpander"
                                  Header="Coordinates"
@@ -168,13 +232,14 @@
                                  IsExpanded="True">
                 <ui:SettingsExpander.Footer>
                     <Button x:Name="WeatherApplyCoordinatesButton"
-                            Padding="12,8"
+                            Padding="14,8"
                             Content="Apply Coordinates" />
                 </ui:SettingsExpander.Footer>
 
                 <ui:SettingsExpanderItem>
                     <StackPanel Spacing="12">
-                        <Grid ColumnDefinitions="*,*" ColumnSpacing="10">
+                        <Grid ColumnDefinitions="*,*"
+                              ColumnSpacing="10">
                             <ui:NumberBox x:Name="WeatherLatitudeNumberBox"
                                           Grid.Column="0"
                                           Header="Latitude"
@@ -194,65 +259,96 @@
                                           LargeChange="1"
                                           Value="116.4074" />
                         </Grid>
+
                         <TextBox x:Name="WeatherLocationKeyTextBox"
                                  Watermark="Location key (optional)" />
                         <TextBox x:Name="WeatherLocationNameTextBox"
                                  Watermark="Display name (optional)" />
                         <TextBlock x:Name="WeatherCoordinateStatusTextBlock"
                                    FontSize="12"
-                                   Foreground="{DynamicResource AdaptiveTextSecondaryBrush}" />
+                                   Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
+                                   TextWrapping="Wrap" />
                     </StackPanel>
                 </ui:SettingsExpanderItem>
             </ui:SettingsExpander>
         </Border>
 
-        <!-- Excluded Alerts Card -->
         <Border Classes="settings-expander-shell">
             <ui:SettingsExpander x:Name="WeatherAlertFilterSettingsExpander"
                                  Header="Excluded Alerts"
                                  Description="Alerts containing these words will not be shown. One rule per line."
                                  IsExpanded="True">
                 <ui:SettingsExpanderItem>
-                    <TextBox x:Name="WeatherExcludedAlertsTextBox"
-                             MinHeight="96"
-                             MaxHeight="220"
-                             Width="360"
-                             TextWrapping="Wrap"
-                             AcceptsReturn="True" />
+                    <Grid ColumnDefinitions="Auto,*"
+                          ColumnSpacing="20">
+                        <StackPanel Width="220"
+                                    Spacing="4">
+                            <TextBlock x:Name="WeatherAlertListTitleTextBlock"
+                                       FontSize="17"
+                                       FontWeight="SemiBold"
+                                       Text="Exclude List" />
+                            <TextBlock x:Name="WeatherAlertListDescriptionTextBlock"
+                                       Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
+                                       TextWrapping="Wrap"
+                                       Text="One exclusion rule per line." />
+                        </StackPanel>
+
+                        <TextBox x:Name="WeatherExcludedAlertsTextBox"
+                                 Grid.Column="1"
+                                 MinHeight="96"
+                                 MaxHeight="220"
+                                 HorizontalAlignment="Stretch"
+                                 AcceptsReturn="True"
+                                 TextWrapping="Wrap"
+                                 Watermark="One keyword per line" />
+                    </Grid>
                 </ui:SettingsExpanderItem>
             </ui:SettingsExpander>
         </Border>
 
-        <!-- Weather Style Card -->
-        <Border Classes="settings-expander-shell">
-            <ui:SettingsExpander x:Name="WeatherIconPackSettingsExpander"
-                                 Header="Weather Icon Style"
-                                 Description="Choose Fluent Icon style for weather symbols."
-                                 IsExpanded="True">
-                <ui:SettingsExpander.Footer>
-                    <ComboBox x:Name="WeatherIconPackComboBox"
-                              Width="240">
-                        <ComboBoxItem x:Name="WeatherIconPackFluentRegularItem" Tag="FluentRegular" Content="Fluent Regular" />
-                        <ComboBoxItem x:Name="WeatherIconPackFluentFilledItem" Tag="FluentFilled" Content="Fluent Filled" />
-                    </ComboBox>
-                </ui:SettingsExpander.Footer>
-            </ui:SettingsExpander>
-        </Border>
-
-        <!-- No TLS Card -->
         <Border Classes="settings-expander-shell">
             <ui:SettingsExpander x:Name="WeatherNoTlsSettingsExpander"
                                  Header="No TLS Weather Request"
                                  Description="Not recommended. Enable only for incompatible network environments."
                                  IsExpanded="True">
                 <ui:SettingsExpander.Footer>
-                    <ToggleSwitch x:Name="WeatherNoTlsToggleSwitch" />
+                    <ToggleSwitch x:Name="WeatherNoTlsToggleSwitch"
+                                  Content="Allow non-TLS request fallback" />
                 </ui:SettingsExpander.Footer>
             </ui:SettingsExpander>
         </Border>
 
-        <TextBlock x:Name="WeatherLocationStatusTextBlock"
-                   Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
-                   Text="No city location is configured." />
+        <Border Classes="settings-note-shell">
+            <TextBlock x:Name="WeatherFooterHintTextBlock"
+                       TextWrapping="Wrap"
+                       Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
+                       Text="Desktop weather widgets will reuse the location and alert exclusion settings configured here." />
+        </Border>
+
+        <Grid IsVisible="False">
+            <ui:SettingsExpander x:Name="WeatherPreviewSettingsExpander"
+                                 Header="Weather Preview"
+                                 Description="Refresh and verify current weather service status." />
+            <fi:SymbolIcon x:Name="WeatherPreviewIconSymbol"
+                           Symbol="WeatherSunny"
+                           IconVariant="Regular" />
+            <Border Classes="settings-expander-shell">
+                <ui:SettingsExpander x:Name="WeatherIconPackSettingsExpander"
+                                     Header="Weather Icon Style"
+                                     Description="Choose Fluent Icon style for weather symbols.">
+                    <ui:SettingsExpander.Footer>
+                        <ComboBox x:Name="WeatherIconPackComboBox"
+                                  Width="220">
+                            <ComboBoxItem x:Name="WeatherIconPackFluentRegularItem"
+                                          Tag="FluentRegular"
+                                          Content="Fluent Regular" />
+                            <ComboBoxItem x:Name="WeatherIconPackFluentFilledItem"
+                                          Tag="FluentFilled"
+                                          Content="Fluent Filled" />
+                        </ComboBox>
+                    </ui:SettingsExpander.Footer>
+                </ui:SettingsExpander>
+            </Border>
+        </Grid>
     </StackPanel>
 </UserControl>

LanMountainDesktop/Views/SettingsWindow.Controls.cs

@@ -126,6 +126,8 @@ public partial class SettingsWindow
 
     // --- WeatherSettingsPage ---
     internal TextBlock WeatherPanelTitleTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherPanelTitleTextBlock")!;
+    internal TextBlock WeatherPreviewSectionTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherPreviewSectionTextBlock")!;
+    internal TextBlock WeatherSettingsSectionTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherSettingsSectionTextBlock")!;
     internal FluentAvalonia.UI.Controls.SettingsExpander WeatherPreviewSettingsExpander => WeatherSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("WeatherPreviewSettingsExpander")!;
     internal FluentAvalonia.UI.Controls.SettingsExpander WeatherLocationSettingsExpander => WeatherSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("WeatherLocationSettingsExpander")!;
     internal FluentAvalonia.UI.Controls.SettingsExpander WeatherCitySearchSettingsExpander => WeatherSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("WeatherCitySearchSettingsExpander")!;
@@ -156,6 +158,7 @@ public partial class SettingsWindow
     internal FluentAvalonia.UI.Controls.NumberBox WeatherLongitudeNumberBox => WeatherSettingsPanel.FindControl<FluentAvalonia.UI.Controls.NumberBox>("WeatherLongitudeNumberBox")!;
     internal TextBlock WeatherCoordinateStatusTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherCoordinateStatusTextBlock")!;
     internal TextBlock WeatherPreviewResultTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherPreviewResultTextBlock")!;
+    internal Image WeatherPreviewIconImage => WeatherSettingsPanel.FindControl<Image>("WeatherPreviewIconImage")!;
     internal FluentIcons.Avalonia.Fluent.SymbolIcon WeatherPreviewIconSymbol => WeatherSettingsPanel.FindControl<FluentIcons.Avalonia.Fluent.SymbolIcon>("WeatherPreviewIconSymbol")!;
     internal TextBlock WeatherPreviewTemperatureTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherPreviewTemperatureTextBlock")!;
     internal TextBlock WeatherPreviewUpdatedTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherPreviewUpdatedTextBlock")!;
@@ -163,7 +166,13 @@ public partial class SettingsWindow
     internal FluentAvalonia.UI.Controls.ProgressRing WeatherPreviewProgressRing => WeatherSettingsPanel.FindControl<FluentAvalonia.UI.Controls.ProgressRing>("WeatherPreviewProgressRing")!;
     internal ComboBoxItem WeatherIconPackFluentRegularItem => WeatherSettingsPanel.FindControl<ComboBoxItem>("WeatherIconPackFluentRegularItem")!;
     internal ComboBoxItem WeatherIconPackFluentFilledItem => WeatherSettingsPanel.FindControl<ComboBoxItem>("WeatherIconPackFluentFilledItem")!;
+    internal TextBlock WeatherLocationSelectionTitleTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherLocationSelectionTitleTextBlock")!;
+    internal TextBlock WeatherLocationSelectionDescriptionTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherLocationSelectionDescriptionTextBlock")!;
+    internal TextBlock WeatherLocationValueTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherLocationValueTextBlock")!;
     internal TextBlock WeatherLocationStatusTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherLocationStatusTextBlock")!;
+    internal TextBlock WeatherAlertListTitleTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherAlertListTitleTextBlock")!;
+    internal TextBlock WeatherAlertListDescriptionTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherAlertListDescriptionTextBlock")!;
+    internal TextBlock WeatherFooterHintTextBlock => WeatherSettingsPanel.FindControl<TextBlock>("WeatherFooterHintTextBlock")!;
 
     // --- UpdateSettingsPage ---
     internal TextBlock UpdatePanelTitleTextBlock => UpdateSettingsPanel.FindControl<TextBlock>("UpdatePanelTitleTextBlock")!;
@@ -189,7 +198,12 @@ public partial class SettingsWindow
     // --- AboutSettingsPage ---
     internal TextBlock AboutPanelTitleTextBlock => AboutSettingsPanel.FindControl<TextBlock>("AboutPanelTitleTextBlock")!;
     internal FluentAvalonia.UI.Controls.SettingsExpander AboutStartupSettingsExpander => AboutSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("AboutStartupSettingsExpander")!;
+    internal FluentAvalonia.UI.Controls.SettingsExpander AboutRenderModeSettingsExpander => AboutSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("AboutRenderModeSettingsExpander")!;
     internal ToggleSwitch AutoStartWithWindowsToggleSwitch => AboutSettingsPanel.FindControl<ToggleSwitch>("AutoStartWithWindowsToggleSwitch")!;
+    internal ComboBox AppRenderModeComboBox => AboutSettingsPanel.FindControl<ComboBox>("AppRenderModeComboBox")!;
+    internal TextBlock CurrentRenderBackendLabelTextBlock => AboutSettingsPanel.FindControl<TextBlock>("CurrentRenderBackendLabelTextBlock")!;
+    internal TextBlock CurrentRenderBackendValueTextBlock => AboutSettingsPanel.FindControl<TextBlock>("CurrentRenderBackendValueTextBlock")!;
+    internal TextBlock CurrentRenderBackendImplementationTextBlock => AboutSettingsPanel.FindControl<TextBlock>("CurrentRenderBackendImplementationTextBlock")!;
     internal TextBlock VersionTextBlock => AboutSettingsPanel.FindControl<TextBlock>("VersionTextBlock")!;
     internal TextBlock CodeNameTextBlock => AboutSettingsPanel.FindControl<TextBlock>("CodeNameTextBlock")!;
     internal TextBlock FontInfoTextBlock => AboutSettingsPanel.FindControl<TextBlock>("FontInfoTextBlock")!;
@@ -201,13 +215,5 @@ public partial class SettingsWindow
     internal TextBlock LauncherHiddenItemsEmptyTextBlock => LauncherSettingsPanel.FindControl<TextBlock>("LauncherHiddenItemsEmptyTextBlock")!;
     internal TextBlock LauncherHiddenItemsDescriptionTextBlock => LauncherSettingsPanel.FindControl<TextBlock>("LauncherHiddenItemsDescriptionTextBlock")!;
 
-    // --- PluginSettingsPage (Added for completeness) ---
-    internal TextBlock PluginSettingsPanelTitleTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginSettingsPanelTitleTextBlock")!;
-    internal FluentAvalonia.UI.Controls.SettingsExpander PluginSystemSettingsExpander => PluginSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("PluginSystemSettingsExpander")!;
-    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 TextBlock PluginRestartHintTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginRestartHintTextBlock")!;
-    internal TextBlock PluginCatalogEmptyTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginCatalogEmptyTextBlock")!;
 }
 

LanMountainDesktop/Views/SettingsWindow.Core.cs

@@ -12,6 +12,7 @@ using FluentIcons.Avalonia.Fluent;
 using FluentIcons.Common;
 using LanMountainDesktop.ComponentSystem;
 using LanMountainDesktop.Models;
+using LanMountainDesktop.Services;
 using LanMountainDesktop.Views.Components;
 
 namespace LanMountainDesktop.Views;
@@ -43,13 +44,171 @@ public partial class SettingsWindow
         }
 
         _launcherIconCache.Clear();
+        PendingRestartStateService.StateChanged -= OnPendingRestartStateChanged;
         base.OnClosed(e);
     }
 
-    private void OnSettingsNavSelectionChanged(object? sender, FluentAvalonia.UI.Controls.NavigationViewSelectionChangedEventArgs e)
+    private void InitializeSettingsNavigation()
     {
+        _settingsNavItems.Clear();
+        _pluginSettingsNavItems.Clear();
+
+        SettingsPrimaryNavHost.Children.Clear();
+        SettingsSecondaryNavHost.Children.Clear();
+        SettingsPluginNavHost.Children.Clear();
+        SettingsPluginNavSection.IsVisible = false;
+
+        AddSettingsNavItem(SettingsPrimaryNavHost, "Wallpaper", Symbol.Wallpaper, "Wallpaper");
+        AddSettingsNavItem(SettingsPrimaryNavHost, "Grid", Symbol.Grid, "Grid");
+        AddSettingsNavItem(SettingsPrimaryNavHost, "Color", Symbol.Color, "Color");
+        AddSettingsNavItem(SettingsPrimaryNavHost, "StatusBar", Symbol.Status, "Status Bar");
+        AddSettingsNavItem(SettingsPrimaryNavHost, "Weather", Symbol.WeatherSunny, "Weather");
+
+        AddSettingsNavItem(SettingsSecondaryNavHost, "Region", Symbol.Globe, "Region");
+        AddSettingsNavItem(SettingsSecondaryNavHost, "Launcher", Symbol.Apps, "App Launcher");
+        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)
+    {
+        if (sender is not Button button || button.Tag is not string tag)
+        {
+            return;
+        }
+
+        SelectSettingsTab(tag, persistSelection: true);
+    }
+
+    private Button AddSettingsNavItem(Panel host, string tag, Symbol symbol, string title)
+    {
+        var button = CreateSettingsNavItem(tag, symbol, title);
+        host.Children.Add(button);
+        _settingsNavItems[tag] = button;
+        return button;
+    }
+
+    private Button CreateSettingsNavItem(string tag, Symbol symbol, string title)
+    {
+        var icon = new SymbolIcon
+        {
+            Symbol = symbol,
+            IconVariant = IconVariant.Regular
+        };
+        icon.Classes.Add("settings-nav-icon");
+
+        var iconShell = new Border
+        {
+            Child = icon,
+            Classes = { "settings-sidebar-icon-shell" }
+        };
+
+        var label = new TextBlock
+        {
+            Text = title,
+            Classes = { "settings-nav-label" }
+        };
+
+        var contentGrid = new Grid
+        {
+            ColumnDefinitions = new ColumnDefinitions("Auto,*"),
+            ColumnSpacing = 12
+        };
+        contentGrid.Children.Add(iconShell);
+        contentGrid.Children.Add(label);
+        Grid.SetColumn(label, 1);
+
+        var button = new Button
+        {
+            Tag = tag,
+            Content = contentGrid,
+            Classes = { "settings-sidebar-item" }
+        };
+        button.Click += OnSettingsNavItemClick;
+        return button;
+    }
+
+    private IEnumerable<Button> EnumerateSettingsNavItems()
+    {
+        foreach (var button in SettingsPrimaryNavHost.Children.OfType<Button>())
+        {
+            yield return button;
+        }
+
+        foreach (var button in SettingsSecondaryNavHost.Children.OfType<Button>())
+        {
+            yield return button;
+        }
+
+        foreach (var button in SettingsPluginNavHost.Children.OfType<Button>())
+        {
+            yield return button;
+        }
+    }
+
+    private Button? GetSettingsNavItem(string tag)
+    {
+        if (_settingsNavItems.TryGetValue(tag, out var builtIn))
+        {
+            return builtIn;
+        }
+
+        return _pluginSettingsNavItems.GetValueOrDefault(tag);
+    }
+
+    private static void SetSettingsNavItemLabel(Button? button, string text)
+    {
+        if (button?.Content is Grid grid)
+        {
+            var label = grid.Children
+                .OfType<TextBlock>()
+                .FirstOrDefault(textBlock => textBlock.Classes.Contains("settings-nav-label"));
+
+            if (label is not null)
+            {
+                label.Text = text;
+            }
+        }
+    }
+
+    private void SelectSettingsTab(string? tag, bool persistSelection)
+    {
+        if (string.IsNullOrWhiteSpace(tag))
+        {
+            return;
+        }
+
+        var selectedButton = GetSettingsNavItem(tag);
+        if (selectedButton is null)
+        {
+            return;
+        }
+
+        _selectedSettingsTabTag = tag;
+        foreach (var button in EnumerateSettingsNavItems())
+        {
+            var isSelected = ReferenceEquals(button, selectedButton);
+            if (isSelected)
+            {
+                if (!button.Classes.Contains("nav-selected"))
+                {
+                    button.Classes.Add("nav-selected");
+                }
+            }
+            else
+            {
+                button.Classes.Remove("nav-selected");
+            }
+        }
+
         UpdateSettingsTabContent();
-        PersistSettings();
+
+        if (persistSelection)
+        {
+            PersistSettings();
+        }
     }
 
     private int GetSettingsTabIndex()
@@ -59,13 +218,7 @@ public partial class SettingsWindow
 
     private void UpdateSettingsTabContent()
     {
-        if (SettingsNavView is null)
-        {
-            return;
-        }
-
-        var selectedItem = SettingsNavView.SelectedItem as FluentAvalonia.UI.Controls.NavigationViewItem;
-        var tag = selectedItem?.Tag?.ToString();
+        var tag = GetSelectedSettingsTabTag();
 
         WallpaperSettingsPanel.IsVisible = tag == "Wallpaper";
         GridSettingsPanel.IsVisible = tag == "Grid";
@@ -77,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")
@@ -84,6 +238,16 @@ public partial class SettingsWindow
             RenderLauncherHiddenItemsList();
         }
 
+        if (tag == "Plugins")
+        {
+            PluginSettingsPanel.RefreshFromRuntime();
+        }
+
+        if (tag == "PluginMarket")
+        {
+            PluginMarketSettingsPanel.RefreshFromRuntime();
+        }
+
         if (tag == "Grid")
         {
             UpdateGridPreviewLayout();
@@ -128,6 +292,7 @@ public partial class SettingsWindow
         snapshot.WeatherIconPackId = _weatherIconPackId;
         snapshot.WeatherNoTlsRequests = _weatherNoTlsRequests;
         snapshot.AutoStartWithWindows = _autoStartWithWindows;
+        snapshot.AppRenderMode = _selectedAppRenderMode;
         snapshot.AutoCheckUpdates = _autoCheckUpdates;
         snapshot.IncludePrereleaseUpdates = IncludePrereleaseUpdates;
         snapshot.UpdateChannel = IncludePrereleaseUpdates ? UpdateChannelPreview : UpdateChannelStable;
@@ -276,6 +441,11 @@ public partial class SettingsWindow
             return;
         }
 
+        if (radioButton.IsChecked != true)
+        {
+            return;
+        }
+
         _clockDisplayFormat = formatTag == "Hm"
             ? ClockDisplayFormat.HourMinute
             : ClockDisplayFormat.HourMinuteSecond;
@@ -372,8 +542,7 @@ public partial class SettingsWindow
 
     private TaskbarContext GetCurrentTaskbarContext()
     {
-        var selectedItem = SettingsNavView?.SelectedItem as FluentAvalonia.UI.Controls.NavigationViewItem;
-        return selectedItem?.Tag?.ToString() switch
+        return GetSelectedSettingsTabTag() switch
         {
             "Wallpaper" => TaskbarContext.SettingsWallpaper,
             "Grid" => TaskbarContext.SettingsGrid,

LanMountainDesktop/Views/SettingsWindow.Layout.cs

@@ -83,11 +83,6 @@ public partial class SettingsWindow
 
     private void OnGridSpacingPresetSelectionChanged(object? sender, SelectionChangedEventArgs e)
     {
-        if (_suppressGridSpacingEvents)
-        {
-            return;
-        }
-
         UpdateGridPreviewLayout();
     }
 

LanMountainDesktop/Views/SettingsWindow.Localization.cs

@@ -1,6 +1,7 @@
 using System;
 using System.Linq;
 using Avalonia.Controls;
+using LanMountainDesktop.Services;
 
 namespace LanMountainDesktop.Views;
 
@@ -47,20 +48,33 @@ public partial class SettingsWindow
 
     private void ApplyLocalization()
     {
-        Title = L("settings.title", "Settings");
-        WindowTitleTextBlock.Text = L("settings.title", "Settings");
-        WindowSubtitleTextBlock.Text = L("settings.footer", "LanMountainDesktop Settings");
+        Title = L("settings.shell.title", "Application Settings");
+        WindowTitleTextBlock.Text = L("settings.shell.title", "Application Settings");
+        WindowSubtitleTextBlock.Text = L("settings.shell.subtitle", "LanMountainDesktop standalone preferences");
+        WindowVersionBadgeTextBlock.Text = GetAppVersionText();
+        WindowCodeNameBadgeTextBlock.Text = AppCodeName;
+        SettingsSidebarTitleTextBlock.Text = L("settings.nav_header", "Settings");
+        SettingsSidebarHintTextBlock.Text = L(
+            "settings.shell.sidebar_hint",
+            "Choose a category to adjust application behavior and desktop appearance.");
+        SettingsPrimaryGroupTextBlock.Text = L("settings.nav.group_desktop", "Desktop");
+        SettingsSecondaryGroupTextBlock.Text = L("settings.nav.group_system", "System");
+        SettingsPluginGroupTextBlock.Text = L("settings.nav.group_extensions", "Extensions");
+        SettingsSidebarFooterTextBlock.Text = L(
+            "settings.shell.footer_hint",
+            "Tray-opened settings are managed in this standalone window.");
 
-        SettingsNavWallpaperItem.Content = L("settings.nav.wallpaper", "Wallpaper");
-        SettingsNavGridItem.Content = L("settings.nav.grid", "Grid");
-        SettingsNavColorItem.Content = L("settings.nav.color", "Color");
-        SettingsNavStatusBarItem.Content = L("settings.nav.status_bar", "Status Bar");
-        SettingsNavWeatherItem.Content = L("settings.nav.weather", "Weather");
-        SettingsNavRegionItem.Content = L("settings.nav.region", "Region");
-        SettingsNavUpdateItem.Content = L("settings.nav.update", "Update");
-        SettingsNavAboutItem.Content = L("settings.nav.about", "About");
-        SettingsNavLauncherItem.Content = L("settings.nav.launcher", "App Launcher");
-        SettingsNavPluginsItem.Content = L("settings.nav.plugins", "Plugins");
+        SetSettingsNavItemLabel(GetSettingsNavItem("Wallpaper"), L("settings.nav.wallpaper", "Wallpaper"));
+        SetSettingsNavItemLabel(GetSettingsNavItem("Grid"), L("settings.nav.grid", "Grid"));
+        SetSettingsNavItemLabel(GetSettingsNavItem("Color"), L("settings.nav.color", "Color"));
+        SetSettingsNavItemLabel(GetSettingsNavItem("StatusBar"), L("settings.nav.status_bar", "Status Bar"));
+        SetSettingsNavItemLabel(GetSettingsNavItem("Weather"), L("settings.nav.weather", "Weather"));
+        SetSettingsNavItemLabel(GetSettingsNavItem("Region"), L("settings.nav.region", "Region"));
+        SetSettingsNavItemLabel(GetSettingsNavItem("Update"), L("settings.nav.update", "Update"));
+        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");
@@ -95,6 +109,60 @@ public partial class SettingsWindow
         StatusBarSpacingModeCustomItem.Content = L("settings.status_bar.spacing_mode_custom", "Custom");
         StatusBarSpacingCustomPanel.Content = L("settings.status_bar.spacing_custom_label", "Custom spacing (%)");
 
+        WeatherPanelTitleTextBlock.Text = L("settings.weather.title", "Weather");
+        WeatherPreviewSectionTextBlock.Text = L("settings.weather.preview_section", "Weather Preview");
+        WeatherSettingsSectionTextBlock.Text = L("settings.weather.settings_section", "Settings");
+        WeatherPreviewButton.Content = L("settings.weather.refresh_button", "Refresh");
+        WeatherPreviewResultTextBlock.Text = L("settings.weather.preview_hint", "Use refresh to verify your weather configuration.");
+        WeatherLocationSettingsExpander.Header = L("settings.weather.location_source_header", "Location Source");
+        WeatherLocationSettingsExpander.Description = L(
+            "settings.weather.location_source_desc",
+            "Choose how weather widgets resolve location.");
+        WeatherLocationModeCityItem.Content = L("settings.weather.mode_city_search", "City Search");
+        WeatherLocationModeCoordinatesItem.Content = L("settings.weather.mode_coordinates", "Coordinates");
+        WeatherLocationModeCityChipItem.Content = L("settings.weather.mode_city_search", "City Search");
+        WeatherLocationModeCoordinatesChipItem.Content = L("settings.weather.mode_coordinates", "Coordinates");
+        WeatherAutoRefreshToggleSwitch.Content = L("settings.weather.auto_refresh", "Auto refresh location on startup");
+        WeatherCitySearchSettingsExpander.Header = L("settings.weather.city_search_header", "City Search");
+        WeatherCitySearchSettingsExpander.Description = L(
+            "settings.weather.city_search_desc",
+            "Search cities and apply one weather location.");
+        WeatherCitySearchTextBox.Watermark = L("settings.weather.search_placeholder", "e.g. Beijing");
+        WeatherSearchButton.Content = L("settings.weather.search_button", "Search");
+        WeatherApplyCityButton.Content = L("settings.weather.apply_city_button", "Apply City");
+        WeatherSearchStatusTextBlock.Text = L("settings.weather.search_hint", "Search by city name and apply one location.");
+        WeatherCoordinateSettingsExpander.Header = L("settings.weather.coordinates_header", "Coordinates");
+        WeatherCoordinateSettingsExpander.Description = L(
+            "settings.weather.coordinates_desc",
+            "Set latitude/longitude and optional key/name.");
+        WeatherLatitudeNumberBox.Header = L("settings.weather.latitude_label", "Latitude");
+        WeatherLongitudeNumberBox.Header = L("settings.weather.longitude_label", "Longitude");
+        WeatherLocationKeyTextBox.Watermark = L("settings.weather.location_key_placeholder", "Location key (optional)");
+        WeatherLocationNameTextBox.Watermark = L("settings.weather.location_name_placeholder", "Display name (optional)");
+        WeatherApplyCoordinatesButton.Content = L("settings.weather.apply_coordinates_button", "Apply Coordinates");
+        WeatherAlertFilterSettingsExpander.Header = L("settings.weather.alert_filter_header", "Excluded Alerts");
+        WeatherAlertFilterSettingsExpander.Description = L(
+            "settings.weather.alert_filter_desc",
+            "Alerts containing these words will not be shown. One rule per line.");
+        WeatherAlertListTitleTextBlock.Text = L("settings.weather.alert_list_label", "Exclude List");
+        WeatherAlertListDescriptionTextBlock.Text = L("settings.weather.alert_list_desc", "One exclusion rule per line.");
+        WeatherExcludedAlertsTextBox.Watermark = L("settings.weather.alert_filter_placeholder", "One keyword per line");
+        WeatherNoTlsSettingsExpander.Header = L("settings.weather.no_tls_header", "No TLS Weather Request");
+        WeatherNoTlsSettingsExpander.Description = L(
+            "settings.weather.no_tls_desc",
+            "Not recommended. Enable only for incompatible network environments.");
+        WeatherNoTlsToggleSwitch.Content = L("settings.weather.no_tls_toggle", "Allow non-TLS request fallback");
+        WeatherFooterHintTextBlock.Text = L(
+            "settings.weather.footer_hint",
+            "Desktop weather widgets will reuse the location and alert exclusion settings configured here.");
+        WeatherIconPackSettingsExpander.Header = L("settings.weather.icon_style_header", "Weather Icon Style");
+        WeatherIconPackSettingsExpander.Description = L(
+            "settings.weather.icon_style_desc",
+            "Choose Fluent Icon style for weather symbols.");
+        WeatherIconPackFluentRegularItem.Content = L("settings.weather.icon_style_fluent_regular", "Fluent Regular");
+        WeatherIconPackFluentFilledItem.Content = L("settings.weather.icon_style_fluent_filled", "Fluent Filled");
+        UpdateWeatherLocationStatusText();
+
         RegionPanelTitleTextBlock.Text = L("settings.region.title", "Region");
         LanguageSettingsExpander.Header = L("settings.region.language_header", "Language");
         LanguageSettingsExpander.Description = L("settings.region.language_desc", "Select application language. Changes apply immediately.");
@@ -109,16 +177,8 @@ public partial class SettingsWindow
         LauncherHiddenItemsDescriptionTextBlock.Text = L("settings.launcher.hidden_hint", "Right-click an icon in launcher to hide it. Hidden entries appear here.");
         LauncherHiddenItemsEmptyTextBlock.Text = L("settings.launcher.hidden_empty", "No hidden items.");
 
-        PluginSettingsPanelTitleTextBlock.Text = L("settings.plugins.title", "Plugins");
-        PluginSystemSettingsExpander.Header = L("settings.plugins.runtime_header", "Plugin Runtime");
-        PluginSystemSettingsExpander.Description = L("settings.plugins.runtime_desc", "Review plugin runtime state and load results.");
-        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.");
-        PluginCatalogEmptyTextBlock.Text = L("settings.plugins.empty", "No plugins found.");
-        PluginSettingsPanel.RefreshFromRuntime();
+        ApplyPluginSettingsLocalization();
+        ApplyPluginMarketSettingsLocalization();
 
         AboutPanelTitleTextBlock.Text = L("settings.about.title", "About");
         VersionTextBlock.Text = Lf("settings.about.version_format", "Version: {0}", GetAppVersionText());
@@ -126,6 +186,17 @@ public partial class SettingsWindow
         FontInfoTextBlock.Text = Lf("settings.about.font_format", "Font: {0}", AppFontName);
         AboutStartupSettingsExpander.Header = L("settings.about.startup_header", "Windows Startup");
         AboutStartupSettingsExpander.Description = L("settings.about.startup_desc", "Launch the app automatically when signing in to Windows.");
+        AboutRenderModeSettingsExpander.Header = L("settings.about.render_mode_header", "Rendering Mode");
+        AboutRenderModeSettingsExpander.Description = L(
+            "settings.about.render_mode_desc",
+            "Choose the rendering backend. Restart the app after changing this option. Unsupported modes fall back to software.");
+        SetAppRenderModeComboItemContent(AppRenderingModeHelper.Default, L("settings.about.render_mode.default", "Default"));
+        SetAppRenderModeComboItemContent(AppRenderingModeHelper.Software, L("settings.about.render_mode.software", "Software"));
+        SetAppRenderModeComboItemContent(AppRenderingModeHelper.AngleEgl, L("settings.about.render_mode.angle_egl", "angleEgl"));
+        SetAppRenderModeComboItemContent(AppRenderingModeHelper.Wgl, L("settings.about.render_mode.wgl", "WGL"));
+        SetAppRenderModeComboItemContent(AppRenderingModeHelper.Vulkan, L("settings.about.render_mode.vulkan", "Vulkan"));
+        UpdateCurrentRenderBackendStatus();
+        UpdatePendingRestartDock();
 
         var placementItems = WallpaperPlacementComboBox.Items.OfType<ComboBoxItem>().ToList();
         if (placementItems.Count >= 5)
@@ -142,6 +213,19 @@ public partial class SettingsWindow
         RenderLauncherHiddenItemsList();
     }
 
+    private void SetAppRenderModeComboItemContent(string tag, string content)
+    {
+        var item = AppRenderModeComboBox.Items
+            .OfType<ComboBoxItem>()
+            .FirstOrDefault(candidate =>
+                string.Equals(candidate.Tag?.ToString(), tag, StringComparison.OrdinalIgnoreCase));
+
+        if (item is not null)
+        {
+            item.Content = content;
+        }
+    }
+
     private string GetLocalizedTimeZoneDisplayName(TimeZoneInfo timeZone)
     {
         var offset = timeZone.GetUtcOffset(DateTime.UtcNow);

LanMountainDesktop/Views/SettingsWindow.RenderBackend.cs

@@ -0,0 +1,42 @@
+using System;
+using LanMountainDesktop.Services;
+
+namespace LanMountainDesktop.Views;
+
+public partial class SettingsWindow
+{
+    private void UpdateCurrentRenderBackendStatus()
+    {
+        var backendInfo = AppRenderBackendDiagnostics.Detect();
+        var localizedBackend = GetLocalizedRenderBackendName(backendInfo.ActualBackend);
+
+        CurrentRenderBackendLabelTextBlock.Text = L(
+            "settings.about.render_mode.current_label",
+            "Current actual backend");
+        CurrentRenderBackendValueTextBlock.Text = Lf(
+            "settings.about.render_mode.current_format",
+            "Current backend: {0}",
+            localizedBackend);
+        CurrentRenderBackendImplementationTextBlock.Text = string.IsNullOrWhiteSpace(backendInfo.ImplementationTypeName)
+            ? L(
+                "settings.about.render_mode.impl_unavailable",
+                "Runtime implementation is unavailable.")
+            : Lf(
+                "settings.about.render_mode.impl_format",
+                "Runtime implementation: {0}",
+                backendInfo.ImplementationTypeName);
+    }
+
+    private string GetLocalizedRenderBackendName(string renderBackend)
+    {
+        return renderBackend switch
+        {
+            AppRenderingModeHelper.Default => L("settings.about.render_mode.default", "Default"),
+            AppRenderingModeHelper.Software => L("settings.about.render_mode.software", "Software"),
+            AppRenderingModeHelper.AngleEgl => L("settings.about.render_mode.angle_egl", "angleEgl"),
+            AppRenderingModeHelper.Wgl => L("settings.about.render_mode.wgl", "WGL"),
+            AppRenderingModeHelper.Vulkan => L("settings.about.render_mode.vulkan", "Vulkan"),
+            _ => L("settings.about.render_mode.unknown", "Unknown")
+        };
+    }
+}

LanMountainDesktop/Views/SettingsWindow.RestartPrompt.cs

@@ -0,0 +1,112 @@
+using System.Threading.Tasks;
+using Avalonia.Interactivity;
+using Avalonia.Threading;
+using FluentAvalonia.UI.Controls;
+using LanMountainDesktop.Services;
+
+namespace LanMountainDesktop.Views;
+
+public partial class SettingsWindow
+{
+    private bool _isRestartPromptVisible;
+
+    private void OnPendingRestartStateChanged()
+    {
+        if (Dispatcher.UIThread.CheckAccess())
+        {
+            UpdatePendingRestartDock();
+            return;
+        }
+
+        Dispatcher.UIThread.Post(UpdatePendingRestartDock);
+    }
+
+    private void UpdatePendingRestartDock()
+    {
+        PendingRestartDock.IsVisible = PendingRestartStateService.HasPendingRestart;
+        PendingRestartDockTitleTextBlock.Text = L("settings.restart_dock.title", "Restart required");
+        PendingRestartDockDescriptionTextBlock.Text = L(
+            "settings.restart_dock.description",
+            "Some changes will take effect after restarting the app.");
+        PendingRestartDockButtonTextBlock.Text = L("settings.restart_dock.button", "Restart app");
+    }
+
+    private async void OnPendingRestartDockButtonClick(object? sender, RoutedEventArgs e)
+    {
+        await ShowGenericRestartPromptAsync();
+    }
+
+    private Task ShowRenderModeRestartPromptAsync(string selectedMode)
+    {
+        var message = Lf(
+            "settings.restart_dialog.render_mode_message",
+            "Restart the app to switch the rendering mode from \"{0}\" to \"{1}\". Restart now?",
+            GetLocalizedAppRenderModeDisplayName(_runningAppRenderMode),
+            GetLocalizedAppRenderModeDisplayName(selectedMode));
+
+        return ShowRestartPromptCoreAsync(message);
+    }
+
+    private Task ShowGenericRestartPromptAsync()
+    {
+        return ShowRestartPromptCoreAsync(L(
+            "settings.restart_dock.description",
+            "Some changes will take effect after restarting the app."));
+    }
+
+    private async Task ShowRestartPromptCoreAsync(string message)
+    {
+        if (_isRestartPromptVisible)
+        {
+            return;
+        }
+
+        _isRestartPromptVisible = true;
+
+        try
+        {
+            var dialog = new ContentDialog
+            {
+                Title = L("settings.restart_dialog.title", "Restart required"),
+                Content = message,
+                PrimaryButtonText = L("settings.restart_dialog.restart", "Restart now"),
+                CloseButtonText = L("settings.restart_dialog.cancel", "Cancel"),
+                DefaultButton = ContentDialogButton.Primary
+            };
+
+            var result = await dialog.ShowAsync(this);
+            if (result == ContentDialogResult.Primary)
+            {
+                if (!AppRestartService.TryRestartApplication())
+                {
+                    UpdatePendingRestartDock();
+                }
+
+                return;
+            }
+
+            UpdatePendingRestartDock();
+        }
+        finally
+        {
+            _isRestartPromptVisible = false;
+        }
+    }
+
+    private string GetLocalizedAppRenderModeDisplayName(string renderMode)
+    {
+        if (renderMode == AppRenderBackendDiagnostics.Unknown)
+        {
+            return L("settings.about.render_mode.unknown", "Unknown");
+        }
+
+        return AppRenderingModeHelper.Normalize(renderMode) switch
+        {
+            AppRenderingModeHelper.Software => L("settings.about.render_mode.software", "Software"),
+            AppRenderingModeHelper.AngleEgl => L("settings.about.render_mode.angle_egl", "angleEgl"),
+            AppRenderingModeHelper.Wgl => L("settings.about.render_mode.wgl", "WGL"),
+            AppRenderingModeHelper.Vulkan => L("settings.about.render_mode.vulkan", "Vulkan"),
+            _ => L("settings.about.render_mode.default", "Default")
+        };
+    }
+}

LanMountainDesktop/Views/SettingsWindow.WeatherLauncher.cs

@@ -14,6 +14,7 @@ using Avalonia.Threading;
 using FluentIcons.Common;
 using LanMountainDesktop.Models;
 using LanMountainDesktop.Services;
+using LanMountainDesktop.Views.Components;
 
 namespace LanMountainDesktop.Views;
 
@@ -89,6 +90,51 @@ public partial class SettingsWindow
         }
     }
 
+    private void InitializeAppRenderModeSetting(AppSettingsSnapshot snapshot)
+    {
+        _selectedAppRenderMode = AppRenderingModeHelper.Normalize(snapshot.AppRenderMode);
+        _runningAppRenderMode = ResolveActiveAppRenderModeForUi(_selectedAppRenderMode);
+        var renderModeForUi = PendingRestartStateService.HasPendingReason(PendingRestartStateService.RenderModeReason)
+            ? _selectedAppRenderMode
+            : _runningAppRenderMode;
+
+        _suppressAppRenderModeSelectionEvents = true;
+        try
+        {
+            AppRenderModeComboBox.IsEnabled = OperatingSystem.IsWindows();
+            SelectAppRenderModeInUi(renderModeForUi);
+        }
+        finally
+        {
+            _suppressAppRenderModeSelectionEvents = false;
+        }
+    }
+
+    private void SelectAppRenderModeInUi(string renderMode)
+    {
+        AppRenderModeComboBox.SelectedIndex = GetAppRenderModeComboBoxIndex(renderMode);
+    }
+
+    private static int GetAppRenderModeComboBoxIndex(string renderMode)
+    {
+        return AppRenderingModeHelper.Normalize(renderMode) switch
+        {
+            AppRenderingModeHelper.Software => 1,
+            AppRenderingModeHelper.AngleEgl => 2,
+            AppRenderingModeHelper.Wgl => 3,
+            AppRenderingModeHelper.Vulkan => 4,
+            _ => 0
+        };
+    }
+
+    private static string ResolveActiveAppRenderModeForUi(string configuredRenderMode)
+    {
+        var detectedRenderMode = AppRenderBackendDiagnostics.Detect().ActualBackend;
+        return string.Equals(detectedRenderMode, AppRenderBackendDiagnostics.Unknown, StringComparison.Ordinal)
+            ? configuredRenderMode
+            : AppRenderingModeHelper.Normalize(detectedRenderMode);
+    }
+
     private static WeatherLocationMode ParseWeatherLocationMode(string? value)
     {
         return string.Equals(value, "Coordinates", StringComparison.OrdinalIgnoreCase)
@@ -180,6 +226,7 @@ public partial class SettingsWindow
     {
         WeatherCitySearchSettingsExpander.IsVisible = _weatherLocationMode == WeatherLocationMode.CitySearch;
         WeatherCoordinateSettingsExpander.IsVisible = _weatherLocationMode == WeatherLocationMode.Coordinates;
+        UpdateWeatherLocationSummaryCard();
     }
 
     private void OnWeatherLocationModeSelectionChanged(object? sender, SelectionChangedEventArgs e)
@@ -319,6 +366,33 @@ public partial class SettingsWindow
         PersistSettings();
     }
 
+    private void OnAppRenderModeSelectionChanged(object? sender, SelectionChangedEventArgs e)
+    {
+        if (_suppressAppRenderModeSelectionEvents)
+        {
+            return;
+        }
+
+        var selectedMode = AppRenderingModeHelper.Normalize(
+            TryGetSelectedComboBoxTag(AppRenderModeComboBox));
+
+        if (string.Equals(_selectedAppRenderMode, selectedMode, StringComparison.Ordinal))
+        {
+            return;
+        }
+
+        _selectedAppRenderMode = selectedMode;
+        PersistSettings();
+        var requiresRestart = !string.Equals(_runningAppRenderMode, selectedMode, StringComparison.Ordinal);
+        PendingRestartStateService.SetPending(PendingRestartStateService.RenderModeReason, requiresRestart);
+        UpdatePendingRestartDock();
+
+        if (requiresRestart)
+        {
+            _ = ShowRenderModeRestartPromptAsync(selectedMode);
+        }
+    }
+
     private async void OnSearchWeatherCityClick(object? sender, RoutedEventArgs e)
     {
         if (_isWeatherSearchInProgress)
@@ -512,7 +586,7 @@ public partial class SettingsWindow
                 : snapshot.LocationName;
             var weather = snapshot.Current.WeatherText ?? L("settings.weather.preview_unknown", "Unknown");
             var temperature = snapshot.Current.TemperatureC.HasValue
-                ? string.Create(CultureInfo.InvariantCulture, $"{snapshot.Current.TemperatureC.Value:F1} C")
+                ? FormatWeatherPreviewTemperature(snapshot.Current.TemperatureC.Value)
                 : "--";
             var updatedAt = snapshot.ObservationTime ?? snapshot.FetchedAt;
 
@@ -533,16 +607,25 @@ public partial class SettingsWindow
 
     private void UpdateWeatherPreviewSummary(int? weatherCode, string temperatureText, DateTimeOffset? updatedAt)
     {
+        var kind = HyperOS3WeatherTheme.ResolveVisualKind(weatherCode, _isNightMode);
+        WeatherPreviewIconImage.Source = HyperOS3WeatherAssetLoader.LoadImage(
+            HyperOS3WeatherTheme.ResolveIconAsset(kind)) ??
+            HyperOS3WeatherAssetLoader.LoadImage(HyperOS3WeatherTheme.ResolveHeroIconAsset(kind));
         WeatherPreviewIconSymbol.Symbol = ResolveWeatherPreviewSymbol(weatherCode, _isNightMode);
         WeatherPreviewIconSymbol.IconVariant = string.Equals(_weatherIconPackId, "FluentFilled", StringComparison.OrdinalIgnoreCase)
             ? IconVariant.Filled
             : IconVariant.Regular;
         WeatherPreviewTemperatureTextBlock.Text = string.IsNullOrWhiteSpace(temperatureText) ? "--" : temperatureText;
         WeatherPreviewUpdatedTextBlock.Text = updatedAt.HasValue
-            ? Lf("weather.widget.updated_format", "Updated {0:HH:mm}", updatedAt.Value.LocalDateTime)
+            ? updatedAt.Value.LocalDateTime.ToString("yyyy/M/d HH:mm:ss", CultureInfo.InvariantCulture)
             : "-";
     }
 
+    private static string FormatWeatherPreviewTemperature(double temperatureC)
+    {
+        return string.Create(CultureInfo.InvariantCulture, $"{temperatureC:0.#}°C");
+    }
+
     private static Symbol ResolveWeatherPreviewSymbol(int? weatherCode, bool isNight)
     {
         return weatherCode switch
@@ -586,11 +669,13 @@ public partial class SettingsWindow
             if (string.IsNullOrWhiteSpace(_weatherLocationKey))
             {
                 WeatherLocationStatusTextBlock.Text = L("settings.weather.status_city_empty", "No city location is configured.");
+                UpdateWeatherLocationSummaryCard();
                 return;
             }
 
             var locationName = string.IsNullOrWhiteSpace(_weatherLocationName) ? _weatherLocationKey : _weatherLocationName;
             WeatherLocationStatusTextBlock.Text = Lf("settings.weather.status_city_format", "Mode: {0} | {1} | Key: {2}", modeText, locationName, _weatherLocationKey);
+            UpdateWeatherLocationSummaryCard();
             return;
         }
 
@@ -601,6 +686,34 @@ public partial class SettingsWindow
             _weatherLatitude,
             _weatherLongitude,
             string.IsNullOrWhiteSpace(_weatherLocationKey) ? BuildCoordinateLocationKey(_weatherLatitude, _weatherLongitude) : _weatherLocationKey);
+        UpdateWeatherLocationSummaryCard();
+    }
+
+    private void UpdateWeatherLocationSummaryCard()
+    {
+        if (_weatherLocationMode == WeatherLocationMode.Coordinates)
+        {
+            WeatherLocationSelectionTitleTextBlock.Text = L("settings.weather.coordinates_selection_label", "Coordinate Location");
+            WeatherLocationSelectionDescriptionTextBlock.Text = L(
+                "settings.weather.location_coordinates_summary_desc",
+                "Set latitude/longitude and optional location name used for weather queries.");
+
+            var locationName = string.IsNullOrWhiteSpace(_weatherLocationName)
+                ? string.Create(CultureInfo.InvariantCulture, $"{_weatherLatitude:F4}, {_weatherLongitude:F4}")
+                : _weatherLocationName;
+            WeatherLocationValueTextBlock.Text = locationName;
+            return;
+        }
+
+        WeatherLocationSelectionTitleTextBlock.Text = L("settings.weather.city_selection_label", "City Selection");
+        WeatherLocationSelectionDescriptionTextBlock.Text = L(
+            "settings.weather.location_city_summary_desc",
+            "Select the current city used for weather queries.");
+        WeatherLocationValueTextBlock.Text = !string.IsNullOrWhiteSpace(_weatherLocationName)
+            ? _weatherLocationName
+            : !string.IsNullOrWhiteSpace(_weatherLocationKey)
+                ? _weatherLocationKey
+                : L("settings.weather.location_not_selected", "No location selected");
     }
 
     private void InitializeLauncherVisibilitySettings(LauncherSettingsSnapshot snapshot)

LanMountainDesktop/Views/SettingsWindow.axaml

@@ -1,6 +1,5 @@
 <Window xmlns="https://github.com/avaloniaui"
         xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
-        xmlns:ui="using:FluentAvalonia.UI.Controls"
         xmlns:fi="using:FluentIcons.Avalonia"
         xmlns:ic="using:FluentIcons.Avalonia.Fluent"
         xmlns:pages="using:LanMountainDesktop.Views.SettingsPages"
@@ -8,16 +7,94 @@
         x:Class="LanMountainDesktop.Views.SettingsWindow"
         Title="Settings"
         Icon="/Assets/avalonia-logo.ico"
-        Width="1360"
-        Height="900"
-        MinWidth="1120"
-        MinHeight="760"
+        Width="1520"
+        Height="960"
+        MinWidth="1240"
+        MinHeight="820"
         ShowInTaskbar="True"
         WindowStartupLocation="CenterScreen"
-        ExtendClientAreaToDecorationsHint="True"
-        ExtendClientAreaChromeHints="SystemChrome"
         Background="{DynamicResource AdaptiveSurfaceBaseBrush}">
 
+    <Window.Styles>
+        <Style Selector="Border.settings-shell-card">
+            <Setter Property="Background" Value="{DynamicResource AdaptiveGlassPanelBackgroundBrush}" />
+            <Setter Property="BorderBrush" Value="{DynamicResource AdaptiveGlassPanelBorderBrush}" />
+            <Setter Property="BorderThickness" Value="1" />
+            <Setter Property="CornerRadius" Value="28" />
+            <Setter Property="BoxShadow" Value="0 10 28 #12000000" />
+        </Style>
+
+        <Style Selector="TextBlock.settings-shell-eyebrow">
+            <Setter Property="FontSize" Value="12" />
+            <Setter Property="FontWeight" Value="SemiBold" />
+            <Setter Property="Foreground" Value="{DynamicResource AdaptiveTextSecondaryBrush}" />
+        </Style>
+
+        <Style Selector="TextBlock.settings-shell-hint">
+            <Setter Property="FontSize" Value="13" />
+            <Setter Property="Foreground" Value="{DynamicResource AdaptiveTextSecondaryBrush}" />
+        </Style>
+
+        <Style Selector="StackPanel.settings-sidebar-host Button.settings-sidebar-item">
+            <Setter Property="Background" Value="Transparent" />
+            <Setter Property="BorderBrush" Value="Transparent" />
+            <Setter Property="BorderThickness" Value="1" />
+            <Setter Property="CornerRadius" Value="18" />
+            <Setter Property="Padding" Value="14,12" />
+            <Setter Property="Margin" Value="0,0,0,8" />
+            <Setter Property="HorizontalContentAlignment" Value="Stretch" />
+            <Setter Property="Transitions">
+                <Transitions>
+                    <BrushTransition Property="Background" Duration="{StaticResource FluttermotionToken.Duration.Fast}" Easing="0.22,1,0.36,1" />
+                    <BrushTransition Property="BorderBrush" Duration="{StaticResource FluttermotionToken.Duration.Fast}" Easing="0.22,1,0.36,1" />
+                    <TransformOperationsTransition Property="RenderTransform" Duration="{StaticResource FluttermotionToken.Duration.Fast}" Easing="0.22,1,0.36,1" />
+                </Transitions>
+            </Setter>
+        </Style>
+
+        <Style Selector="StackPanel.settings-sidebar-host Button.settings-sidebar-item:pointerover">
+            <Setter Property="Background" Value="{DynamicResource AdaptiveButtonHoverBackgroundBrush}" />
+            <Setter Property="BorderBrush" Value="{DynamicResource AdaptiveButtonBorderBrush}" />
+            <Setter Property="RenderTransform" Value="scale(1.01)" />
+        </Style>
+
+        <Style Selector="StackPanel.settings-sidebar-host Button.settings-sidebar-item.nav-selected">
+            <Setter Property="Background" Value="{DynamicResource AdaptiveNavItemSelectedBackgroundBrush}" />
+            <Setter Property="BorderBrush" Value="{DynamicResource AdaptiveAccentBrush}" />
+        </Style>
+
+        <Style Selector="Border.settings-sidebar-icon-shell">
+            <Setter Property="Width" Value="34" />
+            <Setter Property="Height" Value="34" />
+            <Setter Property="CornerRadius" Value="12" />
+            <Setter Property="Background" Value="{DynamicResource AdaptiveButtonBackgroundBrush}" />
+            <Setter Property="BorderBrush" Value="{DynamicResource AdaptiveButtonBorderBrush}" />
+            <Setter Property="BorderThickness" Value="1" />
+        </Style>
+
+        <Style Selector="Button.settings-sidebar-item.nav-selected Border.settings-sidebar-icon-shell">
+            <Setter Property="Background" Value="{DynamicResource AdaptiveAccentBrush}" />
+            <Setter Property="BorderBrush" Value="{DynamicResource AdaptiveAccentBrush}" />
+        </Style>
+
+        <Style Selector="TextBlock.settings-nav-label">
+            <Setter Property="FontSize" Value="16" />
+            <Setter Property="FontWeight" Value="SemiBold" />
+            <Setter Property="VerticalAlignment" Value="Center" />
+        </Style>
+
+        <Style Selector="ic|SymbolIcon.settings-nav-icon">
+            <Setter Property="Foreground" Value="{DynamicResource AdaptiveTextPrimaryBrush}" />
+            <Setter Property="FontSize" Value="18" />
+            <Setter Property="HorizontalAlignment" Value="Center" />
+            <Setter Property="VerticalAlignment" Value="Center" />
+        </Style>
+
+        <Style Selector="Button.settings-sidebar-item.nav-selected ic|SymbolIcon.settings-nav-icon">
+            <Setter Property="Foreground" Value="White" />
+        </Style>
+    </Window.Styles>
+
     <Grid x:Name="DesktopHost">
         <Border x:Name="DesktopWallpaperLayer"
                 Background="{DynamicResource AdaptiveSurfaceBaseBrush}" />
@@ -27,118 +104,142 @@
               IsVisible="True"
               Opacity="1"
               Margin="20">
-            <Border x:Name="SettingsContentPanel"
-                    Background="Transparent"
-                    BorderThickness="0"
-                    Margin="0"
-                    Padding="0"
-                    HorizontalAlignment="Stretch"
-                    VerticalAlignment="Stretch">
-                <Grid RowDefinitions="Auto,*">
-                    <Border Grid.Row="0"
-                            Classes="mica-strong"
-                            CornerRadius="24,24,0,0"
-                            Padding="20,16">
-                        <Grid ColumnDefinitions="Auto,*,Auto">
-                            <Border Width="40"
-                                    Height="40"
-                                    CornerRadius="20"
-                                    Background="{DynamicResource AdaptiveAccentBrush}">
-                                <fi:FluentIcon Icon="Settings"
-                                               IconVariant="Regular"
-                                               Foreground="White"
-                                               FontSize="18"
-                                               HorizontalAlignment="Center"
-                                               VerticalAlignment="Center" />
-                            </Border>
-                            <StackPanel Grid.Column="1"
-                                        Margin="14,0,0,0"
-                                        Spacing="2"
-                                        VerticalAlignment="Center">
-                                <TextBlock x:Name="WindowTitleTextBlock"
-                                           FontSize="24"
+            <Grid x:Name="SettingsContentPanel"
+                  RowDefinitions="Auto,*"
+                  RowSpacing="18">
+                <Border Grid.Row="0"
+                        Classes="settings-shell-card"
+                        Padding="20,18">
+                    <Grid ColumnDefinitions="Auto,*,Auto"
+                          ColumnSpacing="18">
+                        <Border Width="52"
+                                Height="52"
+                                CornerRadius="18"
+                                Background="{DynamicResource AdaptiveAccentBrush}">
+                            <TextBlock Text="LMD"
+                                       FontSize="16"
+                                       FontWeight="Bold"
+                                       Foreground="White"
+                                       HorizontalAlignment="Center"
+                                       VerticalAlignment="Center" />
+                        </Border>
+
+                        <StackPanel Grid.Column="1"
+                                    Spacing="3"
+                                    VerticalAlignment="Center">
+                            <TextBlock x:Name="WindowTitleTextBlock"
+                                       FontSize="28"
+                                       FontWeight="SemiBold"
+                                       Text="Application Settings" />
+                            <TextBlock x:Name="WindowSubtitleTextBlock"
+                                       Classes="settings-shell-hint"
+                                       Text="LanMountainDesktop" />
+                        </StackPanel>
+
+                        <StackPanel Grid.Column="2"
+                                    Orientation="Horizontal"
+                                    Spacing="10"
+                                    VerticalAlignment="Center">
+                            <Border Classes="settings-shell-card"
+                                    Padding="12,8"
+                                    CornerRadius="18">
+                                <TextBlock x:Name="WindowVersionBadgeTextBlock"
+                                           FontSize="14"
                                            FontWeight="SemiBold"
+                                           Text="1.0.0" />
+                            </Border>
+                            <Border Classes="settings-shell-card"
+                                    Padding="12,8"
+                                    CornerRadius="18">
+                                <TextBlock x:Name="WindowCodeNameBadgeTextBlock"
+                                           Classes="settings-shell-hint"
+                                           Text="Administrate" />
+                            </Border>
+                        </StackPanel>
+                    </Grid>
+                </Border>
+
+                <Grid Grid.Row="1"
+                      ColumnDefinitions="300,20,*">
+                    <Border Grid.Column="0"
+                            Classes="settings-shell-card"
+                            Padding="18,18,18,16">
+                        <Grid RowDefinitions="Auto,*,Auto"
+                              RowSpacing="18">
+                            <StackPanel Spacing="6">
+                                <TextBlock x:Name="SettingsSidebarTitleTextBlock"
+                                           Classes="settings-shell-eyebrow"
                                            Text="Settings" />
-                                <TextBlock x:Name="WindowSubtitleTextBlock"
-                                           Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
-                                           Text="LanMountainDesktop preferences" />
+                                <TextBlock x:Name="SettingsSidebarHintTextBlock"
+                                           Classes="settings-shell-hint"
+                                           TextWrapping="Wrap"
+                                           Text="Choose a category to adjust application behavior and desktop appearance." />
                             </StackPanel>
-                            <Button Grid.Column="2"
-                                    Padding="10,8"
-                                    HorizontalAlignment="Right"
-                                    Click="OnCloseWindowClick">
-                                <StackPanel Orientation="Horizontal" Spacing="8">
-                                    <fi:FluentIcon Icon="Dismiss" IconVariant="Regular" />
-                                    <TextBlock Text="Close" VerticalAlignment="Center" />
+
+                            <ScrollViewer Grid.Row="1"
+                                          HorizontalScrollBarVisibility="Disabled"
+                                          VerticalScrollBarVisibility="Auto">
+                                <StackPanel Spacing="20">
+                                    <StackPanel Spacing="10">
+                                        <TextBlock x:Name="SettingsPrimaryGroupTextBlock"
+                                                   Classes="settings-shell-eyebrow"
+                                                   Text="Desktop" />
+                                        <StackPanel x:Name="SettingsPrimaryNavHost"
+                                                    Classes="settings-sidebar-host"
+                                                    Spacing="0" />
+                                    </StackPanel>
+
+                                    <Border Background="{DynamicResource SurfaceStrokeColorDefaultBrush}"
+                                            Height="1" />
+
+                                    <StackPanel Spacing="10">
+                                        <TextBlock x:Name="SettingsSecondaryGroupTextBlock"
+                                                   Classes="settings-shell-eyebrow"
+                                                   Text="System" />
+                                        <StackPanel x:Name="SettingsSecondaryNavHost"
+                                                    Classes="settings-sidebar-host"
+                                                    Spacing="0" />
+                                    </StackPanel>
+
+                                    <StackPanel x:Name="SettingsPluginNavSection"
+                                                IsVisible="False"
+                                                Spacing="10">
+                                        <Border Background="{DynamicResource SurfaceStrokeColorDefaultBrush}"
+                                                Height="1" />
+                                        <TextBlock x:Name="SettingsPluginGroupTextBlock"
+                                                   Classes="settings-shell-eyebrow"
+                                                   Text="Extensions" />
+                                        <StackPanel x:Name="SettingsPluginNavHost"
+                                                    Classes="settings-sidebar-host"
+                                                    Spacing="0" />
+                                    </StackPanel>
                                 </StackPanel>
-                            </Button>
+                            </ScrollViewer>
+
+                            <Border Grid.Row="2"
+                                    Classes="settings-shell-card"
+                                    Padding="14,12"
+                                    CornerRadius="22">
+                                <StackPanel Spacing="4">
+                                    <TextBlock Text="LanMountainDesktop"
+                                               FontWeight="SemiBold" />
+                                    <TextBlock x:Name="SettingsSidebarFooterTextBlock"
+                                               Classes="settings-shell-hint"
+                                               TextWrapping="Wrap"
+                                               Text="Tray-opened settings are managed in this standalone window." />
+                                </StackPanel>
+                            </Border>
                         </Grid>
                     </Border>
 
-                    <Border Grid.Row="1"
-                            Classes="mica-strong"
-                            CornerRadius="0,0,24,24"
-                            Padding="18">
-                        <ui:NavigationView x:Name="SettingsNavView"
-                                           PaneDisplayMode="Left"
-                                           IsSettingsVisible="False"
-                                           OpenPaneLength="240"
-                                           SelectionChanged="OnSettingsNavSelectionChanged">
-                            <ui:NavigationView.MenuItems>
-                                <ui:NavigationViewItem x:Name="SettingsNavWallpaperItem" Content="壁纸" Tag="Wallpaper">
-                                    <ui:NavigationViewItem.IconSource>
-                                        <ic:SymbolIconSource Symbol="Wallpaper" IconVariant="Regular" />
-                                    </ui:NavigationViewItem.IconSource>
-                                </ui:NavigationViewItem>
-                                <ui:NavigationViewItem x:Name="SettingsNavGridItem" Content="网格" Tag="Grid">
-                                    <ui:NavigationViewItem.IconSource>
-                                        <ic:SymbolIconSource Symbol="Grid" IconVariant="Regular" />
-                                    </ui:NavigationViewItem.IconSource>
-                                </ui:NavigationViewItem>
-                                <ui:NavigationViewItem x:Name="SettingsNavColorItem" Content="颜色" Tag="Color">
-                                    <ui:NavigationViewItem.IconSource>
-                                        <ic:SymbolIconSource Symbol="Color" IconVariant="Regular" />
-                                    </ui:NavigationViewItem.IconSource>
-                                </ui:NavigationViewItem>
-                                <ui:NavigationViewItem x:Name="SettingsNavStatusBarItem" Content="状态栏" Tag="StatusBar">
-                                    <ui:NavigationViewItem.IconSource>
-                                        <ic:SymbolIconSource Symbol="Status" IconVariant="Regular" />
-                                    </ui:NavigationViewItem.IconSource>
-                                </ui:NavigationViewItem>
-                                <ui:NavigationViewItem x:Name="SettingsNavWeatherItem" Content="天气" Tag="Weather">
-                                    <ui:NavigationViewItem.IconSource>
-                                        <ic:SymbolIconSource Symbol="WeatherSunny" IconVariant="Regular" />
-                                    </ui:NavigationViewItem.IconSource>
-                                </ui:NavigationViewItem>
-                                <ui:NavigationViewItem x:Name="SettingsNavRegionItem" Content="地区" Tag="Region">
-                                    <ui:NavigationViewItem.IconSource>
-                                        <ic:SymbolIconSource Symbol="Globe" IconVariant="Regular" />
-                                    </ui:NavigationViewItem.IconSource>
-                                </ui:NavigationViewItem>
-                                <ui:NavigationViewItem x:Name="SettingsNavUpdateItem" Content="更新" Tag="Update">
-                                    <ui:NavigationViewItem.IconSource>
-                                        <ic:SymbolIconSource Symbol="ArrowSync" IconVariant="Regular" />
-                                    </ui:NavigationViewItem.IconSource>
-                                </ui:NavigationViewItem>
-                                <ui:NavigationViewItem x:Name="SettingsNavAboutItem" Content="关于" Tag="About">
-                                    <ui:NavigationViewItem.IconSource>
-                                        <ic:SymbolIconSource Symbol="Info" IconVariant="Regular" />
-                                    </ui:NavigationViewItem.IconSource>
-                                </ui:NavigationViewItem>
-                                <ui:NavigationViewItem x:Name="SettingsNavLauncherItem" Content="应用启动台" Tag="Launcher">
-                                    <ui:NavigationViewItem.IconSource>
-                                        <ic:SymbolIconSource Symbol="Apps" IconVariant="Regular" />
-                                    </ui:NavigationViewItem.IconSource>
-                                </ui:NavigationViewItem>
-                                <ui:NavigationViewItem x:Name="SettingsNavPluginsItem" Content="插件" Tag="Plugins">
-                                    <ui:NavigationViewItem.IconSource>
-                                        <ic:SymbolIconSource Symbol="PuzzlePiece" IconVariant="Regular" />
-                                    </ui:NavigationViewItem.IconSource>
-                                </ui:NavigationViewItem>
-                            </ui:NavigationView.MenuItems>
-
+                    <Grid Grid.Column="2"
+                          RowDefinitions="*,Auto"
+                          RowSpacing="14">
+                        <Border Grid.Row="0"
+                                Classes="settings-shell-card"
+                                Padding="0">
                             <ScrollViewer x:Name="SettingsContentScrollViewer"
-                                          Padding="0,0,16,0"
+                                          Padding="30,28,30,30"
                                           HorizontalScrollBarVisibility="Disabled"
                                           VerticalScrollBarVisibility="Auto">
                                 <Grid x:Name="SettingsContentPagesHost">
@@ -152,12 +253,59 @@
                                     <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>
-                    </Border>
+                        </Border>
+
+                        <Border x:Name="PendingRestartDock"
+                                Grid.Row="1"
+                                IsVisible="False"
+                                Classes="settings-shell-card"
+                                Padding="16,14"
+                                CornerRadius="24">
+                            <Grid ColumnDefinitions="Auto,*,Auto"
+                                  ColumnSpacing="14">
+                                <Border Width="38"
+                                        Height="38"
+                                        CornerRadius="14"
+                                        Background="{DynamicResource AdaptiveAccentBrush}">
+                                    <fi:FluentIcon Icon="ArrowSync"
+                                                   IconVariant="Regular"
+                                                   FontSize="18"
+                                                   Foreground="White"
+                                                   HorizontalAlignment="Center"
+                                                   VerticalAlignment="Center" />
+                                </Border>
+                                <StackPanel Grid.Column="1"
+                                            Spacing="2"
+                                            VerticalAlignment="Center">
+                                    <TextBlock x:Name="PendingRestartDockTitleTextBlock"
+                                               FontSize="14"
+                                               FontWeight="SemiBold"
+                                               Text="Restart required" />
+                                    <TextBlock x:Name="PendingRestartDockDescriptionTextBlock"
+                                               TextWrapping="Wrap"
+                                               Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
+                                               Text="Your changes will apply after restarting the app." />
+                                </StackPanel>
+                                <Button x:Name="PendingRestartDockButton"
+                                        Grid.Column="2"
+                                        Padding="16,8"
+                                        Click="OnPendingRestartDockButtonClick">
+                                    <StackPanel Orientation="Horizontal" Spacing="8">
+                                        <fi:FluentIcon Icon="ArrowSync"
+                                                       IconVariant="Regular" />
+                                        <TextBlock x:Name="PendingRestartDockButtonTextBlock"
+                                                   VerticalAlignment="Center"
+                                                   Text="Restart app" />
+                                    </StackPanel>
+                                </Button>
+                            </Grid>
+                        </Border>
+                    </Grid>
                 </Grid>
-            </Border>
+            </Grid>
         </Grid>
 
         <Grid IsVisible="False">

LanMountainDesktop/Views/SettingsWindow.axaml.cs

@@ -102,13 +102,14 @@ public partial class SettingsWindow : Window
     private readonly HashSet<string> _hiddenLauncherFolderPaths = new(StringComparer.OrdinalIgnoreCase);
     private readonly HashSet<string> _hiddenLauncherAppPaths = new(StringComparer.OrdinalIgnoreCase);
     private readonly Stack<StartMenuFolderNode> _launcherFolderStack = [];
+    private readonly Dictionary<string, Button> _settingsNavItems = new(StringComparer.OrdinalIgnoreCase);
+    private readonly Dictionary<string, Button> _pluginSettingsNavItems = new(StringComparer.OrdinalIgnoreCase);
 
     private StartMenuFolderNode _startMenuRoot = new("All Apps", string.Empty);
     private byte[]? _launcherFolderIconPngBytes;
     private Bitmap? _launcherFolderIconBitmap;
 
     private int _targetShortSideCells;
-    private bool _isSettingsOpen = true;
     private bool _isNightMode;
     private bool _enableDynamicTaskbarActions;
     private bool _suppressThemeToggleEvents;
@@ -116,10 +117,10 @@ public partial class SettingsWindow : Window
     private bool _suppressTimeZoneSelectionEvents;
     private bool _suppressWeatherLocationEvents;
     private bool _suppressSettingsPersistence;
-    private bool _suppressGridSpacingEvents;
     private bool _suppressGridInsetEvents;
     private bool _suppressStatusBarSpacingEvents;
     private bool _suppressAutoStartToggleEvents;
+    private bool _suppressAppRenderModeSelectionEvents;
     private bool _isUpdatingWallpaperPreviewLayout;
     private IBrush? _defaultDesktopBackground;
     private Bitmap? _wallpaperBitmap;
@@ -134,12 +135,12 @@ public partial class SettingsWindow : Window
     private IReadOnlyList<Color> _monetColors = Array.Empty<Color>();
     private Color _selectedThemeColor = Color.Parse("#FF3B82F6");
     private double _currentDesktopCellSize;
-    private double _currentDesktopCellGap;
-    private double _currentDesktopEdgeInset;
     private string _gridSpacingPreset = "Relaxed";
     private string _statusBarSpacingMode = "Relaxed";
     private int _statusBarCustomSpacingPercent = 12;
     private int _desktopEdgeInsetPercent = DefaultEdgeInsetPercent;
+    private string _selectedAppRenderMode = AppRenderingModeHelper.Default;
+    private string _runningAppRenderMode = AppRenderingModeHelper.Default;
     private string _taskbarLayoutMode = TaskbarLayoutBottomFullRowMacStyle;
     private string _languageCode = "zh-CN";
     private WeatherLocationMode _weatherLocationMode = WeatherLocationMode.CitySearch;
@@ -153,6 +154,7 @@ public partial class SettingsWindow : Window
     private bool _weatherNoTlsRequests;
     private bool _autoStartWithWindows;
     private string _weatherSearchKeyword = string.Empty;
+    private string _selectedSettingsTabTag = "Wallpaper";
     private bool _isWeatherSearchInProgress;
     private bool _isWeatherPreviewInProgress;
 
@@ -160,9 +162,11 @@ public partial class SettingsWindow : Window
     {
         _componentRegistry = DesktopComponentRegistryFactory.Create((Application.Current as App)?.PluginRuntimeService);
         InitializeComponent();
+        InitializeSettingsNavigation();
         InitializePluginSettingsNavigation();
         _fluentAvaloniaTheme = Application.Current?.Styles.OfType<FluentAvaloniaTheme>().FirstOrDefault();
         RequestedThemeVariant = Application.Current?.RequestedThemeVariant ?? ThemeVariant.Default;
+        PendingRestartStateService.StateChanged += OnPendingRestartStateChanged;
         HookEvents();
     }
 
@@ -180,8 +184,7 @@ public partial class SettingsWindow : Window
         GridSpacingPresetComboBox.SelectionChanged += OnGridSpacingPresetSelectionChanged;
         GridEdgeInsetSlider.ValueChanged += OnGridEdgeInsetSliderChanged;
         ApplyGridButton.Click += OnApplyGridSizeClick;
-        NightModeToggleSwitch.Checked += OnNightModeChecked;
-        NightModeToggleSwitch.Unchecked += OnNightModeUnchecked;
+        NightModeToggleSwitch.IsCheckedChanged += OnNightModeIsCheckedChanged;
         RecommendedColorButton1.Click += OnRecommendedColorClick;
         RecommendedColorButton2.Click += OnRecommendedColorClick;
         RecommendedColorButton3.Click += OnRecommendedColorClick;
@@ -195,36 +198,64 @@ public partial class SettingsWindow : Window
         MonetColorButton4.Click += OnMonetColorClick;
         MonetColorButton5.Click += OnMonetColorClick;
         MonetColorButton6.Click += OnMonetColorClick;
-        StatusBarClockToggleSwitch.Checked += OnStatusBarClockChecked;
-        StatusBarClockToggleSwitch.Unchecked += OnStatusBarClockUnchecked;
-        ClockFormatHMSSRadio.Checked += OnClockFormatChanged;
-        ClockFormatHMRadio.Checked += OnClockFormatChanged;
+        StatusBarClockToggleSwitch.IsCheckedChanged += OnStatusBarClockIsCheckedChanged;
+        ClockFormatHMSSRadio.IsCheckedChanged += OnClockFormatChanged;
+        ClockFormatHMRadio.IsCheckedChanged += OnClockFormatChanged;
         StatusBarSpacingModeComboBox.SelectionChanged += OnStatusBarSpacingModeChanged;
         StatusBarSpacingSlider.ValueChanged += OnStatusBarSpacingSliderChanged;
         WeatherPreviewButton.Click += OnTestWeatherRequestClick;
         WeatherLocationModeComboBox.SelectionChanged += OnWeatherLocationModeSelectionChanged;
         WeatherLocationModeChipListBox.SelectionChanged += OnWeatherLocationModeChipSelectionChanged;
-        WeatherAutoRefreshToggleSwitch.Checked += OnWeatherAutoRefreshToggled;
-        WeatherAutoRefreshToggleSwitch.Unchecked += OnWeatherAutoRefreshToggled;
+        WeatherAutoRefreshToggleSwitch.IsCheckedChanged += OnWeatherAutoRefreshToggled;
         WeatherSearchButton.Click += OnSearchWeatherCityClick;
         WeatherApplyCityButton.Click += OnApplyWeatherCitySelectionClick;
         WeatherApplyCoordinatesButton.Click += OnApplyWeatherCoordinatesClick;
         WeatherExcludedAlertsTextBox.LostFocus += OnWeatherExcludedAlertsLostFocus;
         WeatherIconPackComboBox.SelectionChanged += OnWeatherIconPackSelectionChanged;
-        WeatherNoTlsToggleSwitch.Checked += OnWeatherNoTlsToggled;
-        WeatherNoTlsToggleSwitch.Unchecked += OnWeatherNoTlsToggled;
+        WeatherNoTlsToggleSwitch.IsCheckedChanged += OnWeatherNoTlsToggled;
         LanguageComboBox.SelectionChanged += OnLanguageSelectionChanged;
         TimeZoneComboBox.SelectionChanged += OnTimeZoneSelectionChanged;
-        AutoCheckUpdatesToggleSwitch.Checked += OnAutoCheckUpdatesToggled;
-        AutoCheckUpdatesToggleSwitch.Unchecked += OnAutoCheckUpdatesToggled;
+        AutoCheckUpdatesToggleSwitch.IsCheckedChanged += OnAutoCheckUpdatesToggled;
         UpdateChannelChipListBox.SelectionChanged += OnUpdateChannelSelectionChanged;
         CheckForUpdatesButton.Click += OnCheckForUpdatesClick;
         DownloadAndInstallUpdateButton.Click += OnDownloadAndInstallUpdateClick;
-        AutoStartWithWindowsToggleSwitch.Checked += OnAutoStartWithWindowsToggled;
-        AutoStartWithWindowsToggleSwitch.Unchecked += OnAutoStartWithWindowsToggled;
+        AutoStartWithWindowsToggleSwitch.IsCheckedChanged += OnAutoStartWithWindowsToggled;
+        AppRenderModeComboBox.SelectionChanged += OnAppRenderModeSelectionChanged;
         Opened += OnWindowOpened;
     }
 
+    private void OnNightModeIsCheckedChanged(object? sender, RoutedEventArgs e)
+    {
+        if (sender is not ToggleButton toggleButton)
+        {
+            return;
+        }
+
+        if (toggleButton.IsChecked == true)
+        {
+            OnNightModeChecked(sender, e);
+            return;
+        }
+
+        OnNightModeUnchecked(sender, e);
+    }
+
+    private void OnStatusBarClockIsCheckedChanged(object? sender, RoutedEventArgs e)
+    {
+        if (sender is not ToggleButton toggleButton)
+        {
+            return;
+        }
+
+        if (toggleButton.IsChecked == true)
+        {
+            OnStatusBarClockChecked(sender, e);
+            return;
+        }
+
+        OnStatusBarClockUnchecked(sender, e);
+    }
+
     private void OnWindowOpened(object? sender, EventArgs e)
     {
         Opened -= OnWindowOpened;
@@ -260,6 +291,7 @@ public partial class SettingsWindow : Window
         InitializeLocalization(snapshot.LanguageCode);
         InitializeWeatherSettings(snapshot);
         InitializeAutoStartWithWindowsSetting(snapshot);
+        InitializeAppRenderModeSetting(snapshot);
         InitializeUpdateSettings(snapshot);
         InitializeLauncherVisibilitySettings(launcherSnapshot);
         InitializeSettingsIcons();
@@ -277,8 +309,6 @@ public partial class SettingsWindow : Window
         EnsureSelectedThemeColor();
         UpdateThemeColorSelectionState();
         ThemeColorStatusTextBlock.Text = Lf("settings.color.theme_ready_format", "Theme color ready: {0}.", _selectedThemeColor);
-        WindowTitleTextBlock.Text = L("settings.title", "Settings");
-        WindowSubtitleTextBlock.Text = L("settings.footer", "LanMountainDesktop Settings");
         _defaultDesktopBackground = DesktopWallpaperLayer.Background;
         RestoreSettingsTabSelection(snapshot);
         UpdateSettingsTabContent();

LanMountainDesktop/installer/LanMountainDesktop.iss

@@ -24,6 +24,8 @@ AppName={#MyAppName}
 AppVersion={#MyAppVersion}
 AppPublisher={#MyAppPublisher}
 DefaultDirName={autopf}\{#MyAppName}
+DisableDirPage=no
+UsePreviousAppDir=no
 DefaultGroupName={#MyAppName}
 UninstallDisplayIcon={app}\{#MyAppExeName}
 OutputDir={#MyOutputDir}

LanMountainDesktop/plugins/LoadedPlugin.cs

@@ -1,7 +1,12 @@
+using System;
+using System.Collections.Generic;
 using System.Reflection;
 using System.Threading;
+using System.Threading.Tasks;
 
-namespace LanMountainDesktop.PluginSdk;
+using LanMountainDesktop.PluginSdk;
+
+namespace LanMountainDesktop.Plugins;
 
 public sealed class LoadedPlugin : IDisposable, IAsyncDisposable
 {
@@ -68,6 +73,15 @@ public sealed class LoadedPlugin : IDisposable, IAsyncDisposable
             disposable.Dispose();
         }
 
+        if (Context is IAsyncDisposable asyncContext)
+        {
+            await asyncContext.DisposeAsync();
+        }
+        else if (Context is IDisposable disposableContext)
+        {
+            disposableContext.Dispose();
+        }
+
         LoadContext.Unload();
         GC.SuppressFinalize(this);
     }

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

@@ -0,0 +1,14 @@
+using Avalonia.Controls;
+
+namespace LanMountainDesktop.Views;
+
+public partial class MainWindow
+{
+    internal TextBlock PluginSettingsPanelTitleTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginSettingsPanelTitleTextBlock")!;
+    internal FluentAvalonia.UI.Controls.SettingsExpander PluginSystemSettingsExpander => PluginSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("PluginSystemSettingsExpander")!;
+    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 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);
@@ -139,6 +139,30 @@ public partial class MainWindow
         }
     }
 
+    internal void RefreshPluginSettingsNavigation()
+    {
+        if (SettingsNavView?.MenuItems is null)
+        {
+            return;
+        }
+
+        foreach (var pair in _pluginSettingsPageHosts.ToArray())
+        {
+            var navItem = SettingsNavView.MenuItems
+                .OfType<NavigationViewItem>()
+                .FirstOrDefault(item => string.Equals(item.Tag?.ToString(), pair.Key, StringComparison.OrdinalIgnoreCase));
+            if (navItem is not null)
+            {
+                SettingsNavView.MenuItems.Remove(navItem);
+            }
+
+            SettingsContentPagesHost.Children.Remove(pair.Value);
+        }
+
+        _pluginSettingsPageHosts.Clear();
+        InitializePluginSettingsNavigation();
+    }
+
     private string? GetSelectedSettingsTabTag()
     {
         return (SettingsNavView?.SelectedItem as NavigationViewItem)?.Tag?.ToString();

LanMountainDesktop/plugins/MainWindow.PluginSettingsLocalization.cs

@@ -0,0 +1,28 @@
+namespace LanMountainDesktop.Views;
+
+public partial class MainWindow
+{
+    private void ApplyPluginSettingsLocalization()
+    {
+        PluginSettingsPanelTitleTextBlock.Text = L("settings.plugins.title", "Plugins");
+        PluginSystemSettingsExpander.Header = L("settings.plugins.runtime_header", "Plugin Runtime");
+        PluginSystemSettingsExpander.Description = L(
+            "settings.plugins.runtime_desc",
+            "Review plugin runtime state and load results.");
+        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.");
+        PluginCatalogEmptyTextBlock.Text = L("settings.plugins.empty", "No plugins found.");
+        PluginSettingsPanel.RefreshFromRuntime();
+    }
+}

LanMountainDesktop/plugins/PluginContributions.cs

@@ -1,3 +1,4 @@
+using LanMountainDesktop.Plugins;
 using LanMountainDesktop.PluginSdk;
 
 namespace LanMountainDesktop.Services;

LanMountainDesktop/plugins/PluginLoadContext.cs

@@ -1,7 +1,13 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
 using System.Reflection;
 using System.Runtime.Loader;
 
-namespace LanMountainDesktop.PluginSdk;
+using LanMountainDesktop.PluginSdk;
+
+namespace LanMountainDesktop.Plugins;
 
 public sealed class PluginLoadContext : AssemblyLoadContext
 {

LanMountainDesktop/plugins/PluginLoadResult.cs

@@ -1,4 +1,8 @@
-namespace LanMountainDesktop.PluginSdk;
+using System;
+
+using LanMountainDesktop.PluginSdk;
+
+namespace LanMountainDesktop.Plugins;
 
 public sealed record PluginLoadResult(
     string SourcePath,

LanMountainDesktop/plugins/PluginLoader.cs

@@ -1,10 +1,18 @@
+using System;
+using System.Collections.Generic;
 using System.Collections.ObjectModel;
+using System.IO;
 using System.IO.Compression;
+using System.Linq;
 using System.Reflection;
 using System.Security.Cryptography;
 using System.Text;
+using System.Threading;
+using System.Threading.Tasks;
 
-namespace LanMountainDesktop.PluginSdk;
+using LanMountainDesktop.PluginSdk;
+
+namespace LanMountainDesktop.Plugins;
 
 public sealed class PluginLoader
 {
@@ -125,14 +133,16 @@ public sealed class PluginLoader
         IReadOnlyDictionary<string, object?>? properties)
     {
         PluginLoadContext? loadContext = null;
+        IPlugin? plugin = null;
+        PluginContext? context = null;
 
         try
         {
             loadContext = new PluginLoadContext(assemblyPath, _options.SharedAssemblyNames);
             var assembly = loadContext.LoadFromAssemblyPath(assemblyPath);
             var pluginType = ResolvePluginType(assembly);
-            var plugin = CreatePluginInstance(pluginType);
-            var context = CreateContext(manifest, pluginDirectory, dataDirectory, services, properties);
+            plugin = CreatePluginInstance(pluginType);
+            context = CreateContext(manifest, pluginDirectory, dataDirectory, services, properties);
 
             plugin.Initialize(context);
             var settingsPages = context.GetSettingsPagesSnapshot();
@@ -153,6 +163,8 @@ public sealed class PluginLoader
         }
         catch (Exception ex)
         {
+            DisposeInstance(plugin);
+            DisposeInstance(context);
             loadContext?.Unload();
             return PluginLoadResult.Failure(sourcePath, manifest, ex);
         }
@@ -477,6 +489,33 @@ public sealed class PluginLoader
         return plugin;
     }
 
+    private static void DisposeInstance(object? instance)
+    {
+        if (instance is null)
+        {
+            return;
+        }
+
+        try
+        {
+            if (instance is IAsyncDisposable asyncDisposable)
+            {
+                asyncDisposable.DisposeAsync().AsTask().GetAwaiter().GetResult();
+                return;
+            }
+
+            if (instance is IDisposable disposable)
+            {
+                disposable.Dispose();
+            }
+        }
+        catch (Exception disposeError)
+        {
+            System.Diagnostics.Debug.WriteLine(
+                $"[PluginLoader] Disposal of '{instance.GetType().FullName}' failed: {disposeError}");
+        }
+    }
+
     private static Type[] GetLoadableTypes(Assembly assembly)
     {
         try
@@ -500,12 +539,17 @@ public sealed class PluginLoader
         }
     }
 
-    private sealed class PluginContext : IPluginContext
+    private sealed class PluginContext : IPluginContext, IDisposable, IAsyncDisposable
     {
         private readonly Dictionary<string, PluginSettingsPageRegistration> _settingsPages =
             new(StringComparer.OrdinalIgnoreCase);
         private readonly Dictionary<string, PluginDesktopComponentRegistration> _desktopComponents =
             new(StringComparer.OrdinalIgnoreCase);
+        private readonly Dictionary<Type, object> _registeredServices = [];
+        private readonly List<object> _serviceRegistrationOrder = [];
+        private readonly object _serviceGate = new();
+        private readonly IServiceProvider _hostServices;
+        private int _disposed;
 
         public PluginContext(
             PluginManifest manifest,
@@ -517,8 +561,12 @@ public sealed class PluginLoader
             Manifest = manifest;
             PluginDirectory = pluginDirectory;
             DataDirectory = dataDirectory;
-            Services = services;
+            _hostServices = services;
+            Services = new PluginCompositeServiceProvider(this);
             Properties = properties;
+
+            RegisterBuiltInService<IPluginContext>(this);
+            RegisterBuiltInService<IPluginMessageBus>(new PluginMessageBus());
         }
 
         public PluginManifest Manifest { get; }
@@ -550,9 +598,16 @@ public sealed class PluginLoader
             return false;
         }
 
+        public void RegisterService<TService>(TService service)
+            where TService : class
+        {
+            RegisterServiceCore(typeof(TService), service, allowOverride: false);
+        }
+
         public void RegisterSettingsPage(PluginSettingsPageRegistration registration)
         {
             ArgumentNullException.ThrowIfNull(registration);
+            ThrowIfDisposed();
 
             if (!_settingsPages.TryAdd(registration.Id, registration))
             {
@@ -564,6 +619,7 @@ public sealed class PluginLoader
         public void RegisterDesktopComponent(PluginDesktopComponentRegistration registration)
         {
             ArgumentNullException.ThrowIfNull(registration);
+            ThrowIfDisposed();
 
             if (!_desktopComponents.TryAdd(registration.ComponentId, registration))
             {
@@ -574,6 +630,7 @@ public sealed class PluginLoader
 
         public IReadOnlyList<PluginSettingsPageRegistration> GetSettingsPagesSnapshot()
         {
+            ThrowIfDisposed();
             return _settingsPages.Values
                 .OrderBy(page => page.SortOrder)
                 .ThenBy(page => page.Title, StringComparer.OrdinalIgnoreCase)
@@ -582,11 +639,270 @@ public sealed class PluginLoader
 
         public IReadOnlyList<PluginDesktopComponentRegistration> GetDesktopComponentsSnapshot()
         {
+            ThrowIfDisposed();
             return _desktopComponents.Values
                 .OrderBy(component => component.Category, StringComparer.OrdinalIgnoreCase)
                 .ThenBy(component => component.DisplayName, StringComparer.OrdinalIgnoreCase)
                 .ToArray();
         }
+
+        internal object? ResolveService(Type serviceType)
+        {
+            if (Volatile.Read(ref _disposed) != 0)
+            {
+                return null;
+            }
+
+            if (serviceType == typeof(IServiceProvider))
+            {
+                return Services;
+            }
+
+            lock (_serviceGate)
+            {
+                if (_registeredServices.TryGetValue(serviceType, out var service))
+                {
+                    return service;
+                }
+
+                foreach (var registeredService in _registeredServices.Values)
+                {
+                    if (serviceType.IsInstanceOfType(registeredService))
+                    {
+                        return registeredService;
+                    }
+                }
+            }
+
+            return _hostServices.GetService(serviceType);
+        }
+
+        private void RegisterBuiltInService<TService>(TService service)
+            where TService : class
+        {
+            RegisterServiceCore(typeof(TService), service, allowOverride: true);
+        }
+
+        public void Dispose()
+        {
+            DisposeAsync().AsTask().GetAwaiter().GetResult();
+        }
+
+        public async ValueTask DisposeAsync()
+        {
+            if (Interlocked.Exchange(ref _disposed, 1) != 0)
+            {
+                return;
+            }
+
+            object[] services;
+            lock (_serviceGate)
+            {
+                services = _serviceRegistrationOrder.ToArray();
+                _registeredServices.Clear();
+                _serviceRegistrationOrder.Clear();
+            }
+
+            _settingsPages.Clear();
+            _desktopComponents.Clear();
+
+            var disposedServices = new HashSet<object>(ReferenceEqualityComparer.Instance);
+            for (var i = services.Length - 1; i >= 0; i--)
+            {
+                var service = services[i];
+                if (ReferenceEquals(service, this) || !disposedServices.Add(service))
+                {
+                    continue;
+                }
+
+                if (service is IAsyncDisposable asyncDisposable)
+                {
+                    await asyncDisposable.DisposeAsync();
+                }
+                else if (service is IDisposable disposable)
+                {
+                    disposable.Dispose();
+                }
+            }
+        }
+
+        private void RegisterServiceCore(Type serviceType, object service, bool allowOverride)
+        {
+            ArgumentNullException.ThrowIfNull(serviceType);
+            ArgumentNullException.ThrowIfNull(service);
+            ThrowIfDisposed();
+
+            if (!serviceType.IsInstanceOfType(service))
+            {
+                throw new InvalidOperationException(
+                    $"Service instance '{service.GetType().FullName}' is not assignable to '{serviceType.FullName}'.");
+            }
+
+            lock (_serviceGate)
+            {
+                if (!allowOverride && _registeredServices.ContainsKey(serviceType))
+                {
+                    throw new InvalidOperationException(
+                        $"Plugin '{Manifest.Id}' already registered a service for '{serviceType.FullName}'.");
+                }
+
+                _registeredServices[serviceType] = service;
+                _serviceRegistrationOrder.Add(service);
+            }
+        }
+
+        private void ThrowIfDisposed()
+        {
+            if (Volatile.Read(ref _disposed) != 0)
+            {
+                throw new ObjectDisposedException(nameof(PluginContext));
+            }
+        }
+    }
+
+    private sealed class PluginCompositeServiceProvider : IServiceProvider
+    {
+        private readonly PluginContext _context;
+
+        public PluginCompositeServiceProvider(PluginContext context)
+        {
+            _context = context;
+        }
+
+        public object? GetService(Type serviceType)
+        {
+            ArgumentNullException.ThrowIfNull(serviceType);
+            return _context.ResolveService(serviceType);
+        }
+    }
+
+    private sealed class PluginMessageBus : IPluginMessageBus, IDisposable
+    {
+        private readonly Dictionary<Type, List<Subscription>> _subscriptions = [];
+        private readonly object _gate = new();
+        private int _disposed;
+
+        public IDisposable Subscribe<TMessage>(Action<TMessage> handler)
+        {
+            ArgumentNullException.ThrowIfNull(handler);
+            if (Volatile.Read(ref _disposed) != 0)
+            {
+                throw new ObjectDisposedException(nameof(PluginMessageBus));
+            }
+
+            var subscription = new Subscription(this, typeof(TMessage), message => handler((TMessage)message!));
+            lock (_gate)
+            {
+                if (!_subscriptions.TryGetValue(subscription.MessageType, out var handlers))
+                {
+                    handlers = [];
+                    _subscriptions[subscription.MessageType] = handlers;
+                }
+
+                handlers.Add(subscription);
+            }
+
+            return subscription;
+        }
+
+        public void Publish<TMessage>(TMessage message)
+        {
+            if (Volatile.Read(ref _disposed) != 0)
+            {
+                return;
+            }
+
+            Subscription[] handlers;
+            lock (_gate)
+            {
+                if (!_subscriptions.TryGetValue(typeof(TMessage), out var subscriptions) || subscriptions.Count == 0)
+                {
+                    return;
+                }
+
+                handlers = subscriptions.ToArray();
+            }
+
+            foreach (var handler in handlers)
+            {
+                try
+                {
+                    handler.Invoke(message);
+                }
+                catch (Exception ex)
+                {
+                    System.Diagnostics.Debug.WriteLine(
+                        $"[PluginMessageBus] Handler for '{typeof(TMessage).FullName}' failed: {ex}");
+                }
+            }
+        }
+
+        public void Dispose()
+        {
+            if (Interlocked.Exchange(ref _disposed, 1) != 0)
+            {
+                return;
+            }
+
+            lock (_gate)
+            {
+                _subscriptions.Clear();
+            }
+        }
+
+        private void Unsubscribe(Subscription subscription)
+        {
+            lock (_gate)
+            {
+                if (!_subscriptions.TryGetValue(subscription.MessageType, out var handlers))
+                {
+                    return;
+                }
+
+                handlers.Remove(subscription);
+                if (handlers.Count == 0)
+                {
+                    _subscriptions.Remove(subscription.MessageType);
+                }
+            }
+        }
+
+        private sealed class Subscription : IDisposable
+        {
+            private readonly PluginMessageBus _owner;
+            private int _disposed;
+
+            public Subscription(PluginMessageBus owner, Type messageType, Action<object?> handler)
+            {
+                _owner = owner;
+                MessageType = messageType;
+                Handler = handler;
+            }
+
+            public Type MessageType { get; }
+
+            public Action<object?> Handler { get; }
+
+            public void Invoke(object? message)
+            {
+                if (_disposed != 0)
+                {
+                    return;
+                }
+
+                Handler(message);
+            }
+
+            public void Dispose()
+            {
+                if (Interlocked.Exchange(ref _disposed, 1) != 0)
+                {
+                    return;
+                }
+
+                _owner.Unsubscribe(this);
+            }
+        }
     }
 
     private sealed class NullServiceProvider : IServiceProvider

LanMountainDesktop/plugins/PluginLoaderOptions.cs

@@ -1,4 +1,9 @@
-namespace LanMountainDesktop.PluginSdk;
+using System;
+using System.Collections.Generic;
+
+using LanMountainDesktop.PluginSdk;
+
+namespace LanMountainDesktop.Plugins;
 
 public sealed class PluginLoaderOptions
 {

LanMountainDesktop/plugins/PluginMarketCacheService.cs

@@ -0,0 +1,44 @@
+using System;
+using System.IO;
+
+namespace LanMountainDesktop.Views.SettingsPages;
+
+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;
+        }
+    }
+}

LanMountainDesktop/plugins/PluginMarketEmbeddedView.cs

@@ -0,0 +1,812 @@
+using System;
+using System.Collections.Generic;
+using System.Globalization;
+using System.IO;
+using System.Linq;
+using System.Threading.Tasks;
+using Avalonia;
+using Avalonia.Controls;
+using Avalonia.Interactivity;
+using Avalonia.Layout;
+using Avalonia.Media;
+using LanMountainDesktop.PluginSdk;
+using LanMountainDesktop.Services;
+
+namespace LanMountainDesktop.Views.SettingsPages;
+
+internal sealed class PluginMarketEmbeddedView : UserControl, IDisposable
+{
+    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 AppSettingsService _appSettingsService = new();
+    private readonly LocalizationService _localizationService = new();
+    private readonly PluginRuntimeService _runtime;
+    private readonly AirAppMarketIndexService _indexService;
+    private readonly AirAppMarketInstallService _installService;
+    private readonly AirAppMarketReadmeService _readmeService;
+    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, PluginCatalogEntry> _installedPlugins = new(StringComparer.OrdinalIgnoreCase);
+    private readonly Dictionary<string, string> _readmeContents = new(StringComparer.OrdinalIgnoreCase);
+    private readonly Dictionary<string, string> _readmeErrors = new(StringComparer.OrdinalIgnoreCase);
+    private string _marketSourceDisplay = AirAppMarketDefaults.DefaultIndexUrl;
+    private string? _loadingReadmePluginId;
+    private bool _isRefreshing;
+    private bool _isInstalling;
+    private bool _hasLoadedOnce;
+
+    public PluginMarketEmbeddedView(PluginRuntimeService runtime)
+    {
+        _runtime = runtime;
+        var dataDirectory = Path.Combine(AppContext.BaseDirectory, "Data", "AirAppMarket");
+        _indexService = new AirAppMarketIndexService(new AirAppMarketCacheService(dataDirectory));
+        _installService = new AirAppMarketInstallService(runtime, dataDirectory);
+        _readmeService = new AirAppMarketReadmeService();
+        _hostVersion = typeof(App).Assembly.GetName().Version;
+
+        _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();
+        };
+    }
+
+    public void RefreshInstalledSnapshot()
+    {
+        _installedPlugins = _runtime.Catalog
+            .ToDictionary(entry => entry.Manifest.Id, StringComparer.OrdinalIgnoreCase);
+        RebuildSurface();
+    }
+
+    public void RefreshLocalization()
+    {
+        _searchTextBox.Watermark = T("market.toolbar.search_placeholder", "Search plugins");
+        _refreshButton.Content = T("market.toolbar.refresh", "Refresh");
+        RebuildSurface();
+    }
+
+    public void Dispose()
+    {
+        _readmeService.Dispose();
+        _installService.Dispose();
+        _indexService.Dispose();
+    }
+
+    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
+        {
+            RefreshInstalledSnapshot();
+
+            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;
+            _marketSourceDisplay = result.SourceLocation ?? AirAppMarketDefaults.DefaultIndexUrl;
+            _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();
+            await EnsureReadmeLoadedAsync(_selectedPlugin);
+        }
+        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();
+        _ = EnsureReadmeLoadedAsync(_selectedPlugin);
+    }
+
+    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 += async (_, _) =>
+        {
+            _selectedPlugin = plugin;
+            RebuildSurface();
+            await EnsureReadmeLoadedAsync(plugin);
+        };
+
+        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", "市场源"), _marketSourceDisplay),
+                CreateInfoRow(T("market.detail.project", "Project"), plugin.ProjectUrl),
+                CreateInfoRow(T("market.detail.homepage", "主页"), plugin.HomepageUrl),
+                CreateInfoRow(T("market.detail.repository", "仓库"), plugin.RepositoryUrl),
+                new TextBlock
+                {
+                    Text = T("market.detail.readme", "README"),
+                    FontSize = 18,
+                    FontWeight = FontWeight.SemiBold
+                },
+                new Border
+                {
+                    Background = SurfaceBrush,
+                    CornerRadius = new CornerRadius(16),
+                    Padding = new Thickness(14),
+                    Child = new TextBlock
+                    {
+                        Text = GetReadmeContent(plugin),
+                        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.Manifest is null)
+            {
+                SetStatus(
+                    F(
+                        "market.status.install_failed_format",
+                        "安装插件失败：{0}",
+                        result.ErrorMessage ?? T("market.detail.unknown", "未知错误")),
+                    ErrorBrush);
+                return;
+            }
+
+            RefreshInstalledSnapshot();
+            SetStatus(
+                F(
+                    "market.status.install_success_format",
+                    "插件“{0}”已暂存完成，重启应用后生效。",
+                    result.Manifest.Name),
+                SuccessBrush);
+            RebuildSurface();
+        }
+        finally
+        {
+            _isInstalling = false;
+            BuildDetailPanel();
+        }
+    }
+
+    private async Task EnsureReadmeLoadedAsync(AirAppMarketPluginEntry? plugin)
+    {
+        if (plugin is null ||
+            _readmeContents.ContainsKey(plugin.Id) ||
+            string.Equals(_loadingReadmePluginId, plugin.Id, StringComparison.OrdinalIgnoreCase))
+        {
+            return;
+        }
+
+        _loadingReadmePluginId = plugin.Id;
+        _readmeErrors.Remove(plugin.Id);
+        BuildDetailPanel();
+
+        try
+        {
+            var readme = await _readmeService.LoadAsync(plugin);
+            _readmeContents[plugin.Id] = string.IsNullOrWhiteSpace(readme)
+                ? T("market.detail.readme_empty", "README is empty.")
+                : readme.Trim();
+        }
+        catch (Exception ex)
+        {
+            _readmeErrors[plugin.Id] = ex.Message;
+        }
+        finally
+        {
+            _loadingReadmePluginId = null;
+            if (string.Equals(_selectedPlugin?.Id, plugin.Id, StringComparison.OrdinalIgnoreCase))
+            {
+                BuildDetailPanel();
+            }
+        }
+    }
+
+    private string GetReadmeContent(AirAppMarketPluginEntry plugin)
+    {
+        if (_readmeContents.TryGetValue(plugin.Id, out var readme))
+        {
+            return readme;
+        }
+
+        if (_readmeErrors.TryGetValue(plugin.Id, out var error))
+        {
+            return F(
+                "market.detail.readme_error_format",
+                "README could not be loaded: {0}",
+                error);
+        }
+
+        if (string.Equals(_loadingReadmePluginId, plugin.Id, StringComparison.OrdinalIgnoreCase))
+        {
+            return T("market.detail.readme_loading", "Loading README...");
+        }
+
+        return plugin.ReleaseNotes;
+    }
+
+    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 PluginCatalogEntry? 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)
+    {
+        var snapshot = _appSettingsService.Load();
+        return _localizationService.GetString(snapshot.LanguageCode, 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 => "已安装",
+            _ => "安装"
+        };
+    }
+}

LanMountainDesktop/plugins/PluginMarketIndexService.cs

@@ -0,0 +1,121 @@
+using System;
+using System.IO;
+using System.Net.Http;
+using System.Net.Http.Headers;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace LanMountainDesktop.Views.SettingsPages;
+
+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;
+
+        if (AirAppMarketDefaults.TryGetWorkspaceIndexPath() is { } localIndexPath)
+        {
+            try
+            {
+                var json = await File.ReadAllTextAsync(localIndexPath, cancellationToken);
+                var document = AirAppMarketIndexDocument.Load(json, localIndexPath);
+                _cacheService.SaveIndexJson(json);
+                return new AirAppMarketLoadResult(
+                    true,
+                    document,
+                    AirAppMarketLoadSource.Local,
+                    localIndexPath,
+                    null,
+                    null);
+            }
+            catch (OperationCanceledException)
+            {
+                throw;
+            }
+            catch (Exception ex)
+            {
+                networkError = ex;
+            }
+        }
+
+        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,
+                AirAppMarketDefaults.DefaultIndexUrl,
+                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,
+                    _cacheService.CacheFilePath,
+                    networkError?.Message,
+                    null);
+            }
+            catch (Exception cacheEx)
+            {
+                return new AirAppMarketLoadResult(
+                    false,
+                    null,
+                    null,
+                    null,
+                    null,
+                    $"{networkError?.Message ?? "Unknown network error"} | Cached index invalid: {cacheEx.Message}");
+            }
+        }
+
+        return new AirAppMarketLoadResult(
+            false,
+            null,
+            null,
+            null,
+            null,
+            networkError?.Message ?? "Unknown network error");
+    }
+
+    public void Dispose()
+    {
+        _httpClient.Dispose();
+    }
+}

LanMountainDesktop/plugins/PluginMarketInstallService.cs

@@ -0,0 +1,109 @@
+using System;
+using System.IO;
+using System.Linq;
+using System.Net.Http;
+using System.Threading;
+using System.Threading.Tasks;
+using System.Security.Cryptography;
+using LanMountainDesktop.PluginSdk;
+using LanMountainDesktop.Services;
+
+namespace LanMountainDesktop.Views.SettingsPages;
+
+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)
+    {
+        _runtime = runtime;
+        _downloadsDirectory = Path.Combine(dataDirectory, "downloads");
+        _httpClient = new HttpClient
+        {
+            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(
+        AirAppMarketPluginEntry plugin,
+        CancellationToken cancellationToken = default)
+    {
+        ArgumentNullException.ThrowIfNull(plugin);
+
+        Directory.CreateDirectory(_downloadsDirectory);
+        var downloadPath = Path.Combine(
+            _downloadsDirectory,
+            $"{SanitizeFileName(plugin.Id)}-{SanitizeFileName(plugin.Version)}.laapp");
+
+        try
+        {
+            var resolvedDownloadUrl = await _releaseResolverService.ResolveDownloadUrlAsync(plugin, cancellationToken);
+
+            if (AirAppMarketDefaults.TryResolveWorkspaceFile(resolvedDownloadUrl, out var localPackagePath))
+            {
+                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
+            {
+                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);
+            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 manifest = _runtime.InstallPluginPackage(downloadPath);
+            return new AirAppMarketInstallResult(true, manifest, 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());
+    }
+}

LanMountainDesktop/plugins/PluginMarketModels.cs

@@ -0,0 +1,544 @@
+using System;
+using System.Collections.Generic;
+using System.Globalization;
+using System.IO;
+using System.Linq;
+using System.Text.Json;
+using LanMountainDesktop.PluginSdk;
+
+namespace LanMountainDesktop.Views.SettingsPages;
+
+internal static class AirAppMarketDefaults
+{
+    public const string DefaultIndexUrl =
+        "https://raw.githubusercontent.com/wwiinnddyy/LanAirApp/main/airappmarket/index.json";
+
+    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 = TryGetWorkspaceRepositoryRoot("LanAirApp");
+        if (repositoryRoot is null)
+        {
+            return null;
+        }
+
+        var candidatePath = Path.Combine(repositoryRoot, "airappmarket", "index.json");
+        return File.Exists(candidatePath) ? candidatePath : null;
+    }
+
+    public static bool TryResolveWorkspaceFile(string url, out string localPath)
+    {
+        localPath = string.Empty;
+
+        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 candidatePath = Path.GetFullPath(Path.Combine(repositoryRoot, relativePath));
+        if (!File.Exists(candidatePath))
+        {
+            return false;
+        }
+
+        localPath = candidatePath;
+        return true;
+    }
+
+    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, repositoryName);
+            if (Directory.Exists(candidate))
+            {
+                return candidate;
+            }
+
+            current = current.Parent;
+        }
+
+        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
+{
+    Local = 0,
+    Network = 1,
+    Cache = 2
+}
+
+internal enum AirAppMarketInstallState
+{
+    NotInstalled = 0,
+    UpdateAvailable = 1,
+    Installed = 2
+}
+
+internal sealed record AirAppMarketLoadResult(
+    bool Success,
+    AirAppMarketIndexDocument? Document,
+    AirAppMarketLoadSource? Source,
+    string? SourceLocation,
+    string? WarningMessage,
+    string? ErrorMessage);
+
+internal sealed record AirAppMarketInstallResult(
+    bool Success,
+    PluginManifest? Manifest,
+    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 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) ||
+            (uri.Scheme != Uri.UriSchemeHttp && uri.Scheme != Uri.UriSchemeHttps))
+        {
+            throw new InvalidOperationException(
+                $"Market index '{sourceName}' declares invalid URL '{url}' for '{propertyName}'.");
+        }
+    }
+
+    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;
+        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 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;
+
+    public List<string> Tags { get; init; } = [];
+
+    public DateTimeOffset PublishedAt { get; init; }
+
+    public DateTimeOffset UpdatedAt { get; init; }
+
+    public string ReleaseNotes { get; init; } = string.Empty;
+
+    public bool HasReleaseDownloadMetadata =>
+        !string.IsNullOrWhiteSpace(ReleaseTag) &&
+        !string.IsNullOrWhiteSpace(ReleaseAssetName);
+
+    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 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)}'.");
+        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);
+        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);
+
+        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)
+        {
+            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,
+            ReleaseTag = normalizedReleaseTag ?? string.Empty,
+            ReleaseAssetName = normalizedReleaseAssetName ?? string.Empty,
+            ProjectUrl = normalizedProjectUrl,
+            ReadmeUrl = normalizedReadmeUrl,
+            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);
+    }
+}

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

@@ -9,6 +9,7 @@ using Avalonia;
 using Avalonia.Controls;
 using Avalonia.Markup.Xaml;
 using LanMountainDesktop.Models;
+using LanMountainDesktop.Plugins;
 using LanMountainDesktop.PluginSdk;
 
 namespace LanMountainDesktop.Services;
@@ -17,6 +18,8 @@ public sealed class PluginRuntimeService : IDisposable
 {
     private readonly PluginLoader _loader;
     private readonly AppSettingsService _appSettingsService = new();
+    private readonly IServiceProvider _hostServices;
+    private readonly IPluginPackageManager _packageManager;
     private readonly List<LoadedPlugin> _loadedPlugins = [];
     private readonly List<PluginLoadResult> _loadResults = [];
     private readonly List<PluginCatalogEntry> _catalog = [];
@@ -26,6 +29,8 @@ public sealed class PluginRuntimeService : IDisposable
     public PluginRuntimeService()
     {
         PluginsDirectory = Path.Combine(AppContext.BaseDirectory, "Extensions", "Plugins");
+        _packageManager = new PluginRuntimePackageManager(this);
+        _hostServices = new PluginHostServiceProvider(_packageManager);
         _loader = new PluginLoader(CreateOptions());
     }
 
@@ -47,11 +52,14 @@ public sealed class PluginRuntimeService : IDisposable
         UnloadInstalledPlugins();
 
         var disabledPluginIds = GetDisabledPluginIds();
+        var settingsSnapshot = _appSettingsService.Load();
+        var hostLanguageCode = PluginLocalizer.NormalizeLanguageCode(settingsSnapshot.LanguageCode);
         var hostProperties = new Dictionary<string, object?>(StringComparer.OrdinalIgnoreCase)
         {
-            ["HostApplicationName"] = "LanMountainDesktop",
-            ["HostVersion"] = typeof(App).Assembly.GetName().Version?.ToString(),
-            ["PluginSdkApiVersion"] = PluginSdkInfo.ApiVersion
+            [PluginHostPropertyKeys.HostApplicationName] = "LanMountainDesktop",
+            [PluginHostPropertyKeys.HostVersion] = typeof(App).Assembly.GetName().Version?.ToString(),
+            [PluginHostPropertyKeys.PluginSdkApiVersion] = PluginSdkInfo.ApiVersion,
+            [PluginHostPropertyKeys.HostLanguageCode] = hostLanguageCode
         };
 
         var discoveryFailures = new List<PluginLoadResult>();
@@ -92,11 +100,11 @@ public sealed class PluginRuntimeService : IDisposable
                 PluginCatalogSourceKind.Package => _loader.LoadFromPackage(
                     candidate.SourcePath,
                     PluginsDirectory,
-                    services: null,
+                    services: _hostServices,
                     hostProperties),
                 _ => _loader.LoadFromManifest(
                     candidate.SourcePath,
-                    services: null,
+                    services: _hostServices,
                     hostProperties)
             };
 
@@ -174,6 +182,57 @@ public sealed class PluginRuntimeService : IDisposable
         return true;
     }
 
+    public PluginManifest InstallPluginPackage(string packagePath)
+    {
+        return InstallPluginPackageCore(packagePath).Manifest;
+    }
+
+    internal IReadOnlyList<InstalledPluginInfo> GetInstalledPluginsSnapshot()
+    {
+        return _catalog
+            .OrderBy(entry => entry.Manifest.Name, StringComparer.OrdinalIgnoreCase)
+            .Select(entry => new InstalledPluginInfo(
+                entry.Manifest,
+                entry.IsEnabled,
+                entry.IsLoaded,
+                entry.IsPackage,
+                entry.ErrorMessage))
+            .ToArray();
+    }
+
+    private PluginPackageInstallResult InstallPluginPackageCore(string packagePath)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(packagePath);
+
+        var fullPackagePath = Path.GetFullPath(packagePath);
+        if (!File.Exists(fullPackagePath))
+        {
+            throw new FileNotFoundException($"Plugin package '{fullPackagePath}' was not found.", fullPackagePath);
+        }
+
+        if (!string.Equals(Path.GetExtension(fullPackagePath), PluginSdkInfo.PackageFileExtension, StringComparison.OrdinalIgnoreCase))
+        {
+            throw new InvalidOperationException(
+                $"Plugin package must use the '{PluginSdkInfo.PackageFileExtension}' extension.");
+        }
+
+        Directory.CreateDirectory(PluginsDirectory);
+
+        var manifest = ReadManifestFromPackage(fullPackagePath);
+        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);
+        }
+
+        UpdateCatalogAfterPackageInstall(manifest, destinationPath);
+        PendingRestartStateService.SetPending(PendingRestartStateService.PluginCatalogReason, true);
+
+        return new PluginPackageInstallResult(manifest, replacedExisting, RestartRequired: true);
+    }
+
     public void Dispose()
     {
         UnloadInstalledPlugins();
@@ -269,6 +328,71 @@ public sealed class PluginRuntimeService : IDisposable
         return PluginManifest.Load(stream, $"{packagePath}!/{entries[0].FullName}");
     }
 
+    private bool RemoveExistingPluginPackages(string pluginId, string packagePathToKeep)
+    {
+        var replacedExisting = false;
+        foreach (var existingPackagePath in EnumerateCandidatePaths($"*{PluginSdkInfo.PackageFileExtension}"))
+        {
+            if (string.Equals(
+                    Path.GetFullPath(existingPackagePath),
+                    Path.GetFullPath(packagePathToKeep),
+                    StringComparison.OrdinalIgnoreCase))
+            {
+                continue;
+            }
+
+            try
+            {
+                var existingManifest = ReadManifestFromPackage(existingPackagePath);
+                if (!string.Equals(existingManifest.Id, pluginId, StringComparison.OrdinalIgnoreCase))
+                {
+                    continue;
+                }
+
+                File.Delete(existingPackagePath);
+                replacedExisting = true;
+            }
+            catch
+            {
+                // Ignore unrelated or invalid packages during replacement.
+            }
+        }
+
+        return replacedExisting;
+    }
+
+    private void UpdateCatalogAfterPackageInstall(PluginManifest manifest, string destinationPath)
+    {
+        var isEnabled = !GetDisabledPluginIds().Contains(manifest.Id);
+        var entry = new PluginCatalogEntry(
+            manifest,
+            destinationPath,
+            IsPackage: true,
+            IsEnabled: isEnabled,
+            IsLoaded: false,
+            ErrorMessage: null,
+            SettingsPageCount: 0,
+            WidgetCount: 0);
+
+        for (var i = 0; i < _catalog.Count; i++)
+        {
+            if (string.Equals(_catalog[i].Manifest.Id, manifest.Id, StringComparison.OrdinalIgnoreCase))
+            {
+                _catalog[i] = entry;
+                return;
+            }
+        }
+
+        _catalog.Add(entry);
+    }
+
+    private static string BuildInstalledPackageFileName(string pluginId)
+    {
+        var invalidChars = Path.GetInvalidFileNameChars();
+        var fileName = new string(pluginId.Select(ch => invalidChars.Contains(ch) ? '_' : ch).ToArray());
+        return fileName + PluginSdkInfo.PackageFileExtension;
+    }
+
     private static string EnsureTrailingSeparator(string path)
     {
         return path.EndsWith(Path.DirectorySeparatorChar.ToString(), StringComparison.Ordinal)
@@ -280,9 +404,22 @@ public sealed class PluginRuntimeService : IDisposable
     {
         var options = new PluginLoaderOptions();
         AddSharedAssembly(options, typeof(App).Assembly);
-        AddSharedAssembly(options, typeof(Application).Assembly);
-        AddSharedAssembly(options, typeof(Control).Assembly);
-        AddSharedAssembly(options, typeof(AvaloniaXamlLoader).Assembly);
+
+        foreach (var assembly in AppDomain.CurrentDomain.GetAssemblies())
+        {
+            var assemblyName = assembly.GetName().Name;
+            if (string.IsNullOrWhiteSpace(assemblyName))
+            {
+                continue;
+            }
+
+            if (assemblyName.StartsWith("Avalonia", StringComparison.OrdinalIgnoreCase) ||
+                string.Equals(assemblyName, "MicroCom.Runtime", StringComparison.OrdinalIgnoreCase))
+            {
+                AddSharedAssembly(options, assembly);
+            }
+        }
+
         return options;
     }
 
@@ -312,4 +449,41 @@ public sealed class PluginRuntimeService : IDisposable
         string SourcePath,
         PluginManifest Manifest,
         PluginCatalogSourceKind SourceKind);
+
+    private sealed class PluginHostServiceProvider : IServiceProvider
+    {
+        private readonly IPluginPackageManager _packageManager;
+
+        public PluginHostServiceProvider(IPluginPackageManager packageManager)
+        {
+            _packageManager = packageManager;
+        }
+
+        public object? GetService(Type serviceType)
+        {
+            return serviceType == typeof(IPluginPackageManager)
+                ? _packageManager
+                : null;
+        }
+    }
+
+    private sealed class PluginRuntimePackageManager : IPluginPackageManager
+    {
+        private readonly PluginRuntimeService _runtimeService;
+
+        public PluginRuntimePackageManager(PluginRuntimeService runtimeService)
+        {
+            _runtimeService = runtimeService;
+        }
+
+        public IReadOnlyList<InstalledPluginInfo> GetInstalledPlugins()
+        {
+            return _runtimeService.GetInstalledPluginsSnapshot();
+        }
+
+        public PluginPackageInstallResult InstallPackage(string packagePath)
+        {
+            return _runtimeService.InstallPluginPackageCore(packagePath);
+        }
+    }
 }

LanMountainDesktop/plugins/PluginSettingsPage.Host.cs

@@ -1,19 +1,28 @@
-using System;
+using System;
 using System.Globalization;
+using System.IO;
 using System.Linq;
+using System.Threading.Tasks;
 using Avalonia;
 using Avalonia.Controls;
 using Avalonia.Layout;
 using Avalonia.Media;
+using Avalonia.Platform.Storage;
 using FluentAvalonia.UI.Controls;
+using LanMountainDesktop.PluginSdk;
 using LanMountainDesktop.Services;
 
 namespace LanMountainDesktop.Views.SettingsPages;
 
 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 readonly AppSettingsService _appSettingsService = new();
     private readonly LocalizationService _localizationService = new();
+    private string? _packageImportStatusMessage;
+    private bool _packageImportStatusIsError;
 
     public PluginSettingsPage()
     {
@@ -24,6 +33,7 @@ public partial class PluginSettingsPage : UserControl
     public void RefreshFromRuntime()
     {
         var runtime = (Application.Current as App)?.PluginRuntimeService;
+        UpdateInstallerUi(runtime);
         if (runtime is null)
         {
             PluginSystemStatusTextBlock.Text = L("settings.plugins.runtime_unavailable", "Plugin runtime is not available.");
@@ -37,6 +47,24 @@ public partial class PluginSettingsPage : UserControl
         BuildPluginCatalog(runtime);
     }
 
+    private void UpdateInstallerUi(PluginRuntimeService? runtime)
+    {
+        InstallPluginPackageButton.Content = L("settings.plugins.install_button", "Open .laapp package");
+        InstallPluginPackageButton.IsEnabled = runtime is not null;
+        PluginPackageImportHintTextBlock.Text = runtime is null
+            ? L(
+                "settings.plugins.install_unavailable",
+                "Plugin runtime is unavailable, so .laapp packages cannot be installed right now.")
+            : F(
+                "settings.plugins.install_hint_format",
+                "Open a .laapp package to install it into: {0}",
+                runtime.PluginsDirectory);
+
+        PluginPackageImportStatusTextBlock.IsVisible = !string.IsNullOrWhiteSpace(_packageImportStatusMessage);
+        PluginPackageImportStatusTextBlock.Text = _packageImportStatusMessage ?? string.Empty;
+        PluginPackageImportStatusTextBlock.Foreground = _packageImportStatusIsError ? ErrorBrush : SuccessBrush;
+    }
+
     private void BuildRuntimeSummary(PluginRuntimeService runtime)
     {
         var failures = runtime.LoadResults.Where(result => !result.IsSuccess).ToArray();
@@ -112,8 +140,7 @@ public partial class PluginSettingsPage : UserControl
             VerticalAlignment = VerticalAlignment.Center
         };
 
-        enabledToggle.Checked += (_, _) => OnPluginEnableChanged(runtime, entry, true);
-        enabledToggle.Unchecked += (_, _) => OnPluginEnableChanged(runtime, entry, false);
+        enabledToggle.IsCheckedChanged += (_, _) => OnPluginEnableChanged(runtime, entry, enabledToggle.IsChecked == true);
 
         var header = new Grid
         {
@@ -165,6 +192,113 @@ public partial class PluginSettingsPage : UserControl
                 : L("settings.plugins.toggle_state_disabled", "disabled"));
     }
 
+    private async void OnInstallPluginPackageClick(object? sender, Avalonia.Interactivity.RoutedEventArgs e)
+    {
+        var runtime = (Application.Current as App)?.PluginRuntimeService;
+        if (runtime is null)
+        {
+            SetPackageImportStatus(
+                L(
+                    "settings.plugins.install_unavailable",
+                    "Plugin runtime is unavailable, so .laapp packages cannot be installed right now."),
+                isError: true);
+            return;
+        }
+
+        var topLevel = TopLevel.GetTopLevel(this);
+        var storageProvider = topLevel?.StorageProvider;
+        if (storageProvider is null)
+        {
+            SetPackageImportStatus(
+                L("settings.plugins.install_picker_unavailable", "Storage provider is unavailable."),
+                isError: true);
+            return;
+        }
+
+        var files = await storageProvider.OpenFilePickerAsync(new FilePickerOpenOptions
+        {
+            Title = L("settings.plugins.install_picker_title", "Select plugin package"),
+            AllowMultiple = false,
+            FileTypeFilter =
+            [
+                new FilePickerFileType(L("settings.plugins.install_file_type", ".laapp plugin package"))
+                {
+                    Patterns = [$"*{PluginSdkInfo.PackageFileExtension}"]
+                }
+            ]
+        });
+
+        if (files.Count == 0)
+        {
+            return;
+        }
+
+        string? temporaryPackagePath = null;
+        try
+        {
+            temporaryPackagePath = await CopyPackageToTemporaryFileAsync(files[0]);
+            if (string.IsNullOrWhiteSpace(temporaryPackagePath))
+            {
+                SetPackageImportStatus(
+                    L("settings.plugins.install_copy_failed", "Failed to copy the selected .laapp package."),
+                    isError: true);
+                return;
+            }
+
+            var manifest = runtime.InstallPluginPackage(temporaryPackagePath);
+            RefreshFromRuntime();
+            SetPackageImportStatus(
+                F(
+                    "settings.plugins.install_success_format",
+                    "Installed plugin '{0}'. Restart the app to apply newly added settings pages and widgets.",
+                    manifest.Name),
+                isError: false);
+        }
+        catch (Exception ex)
+        {
+            SetPackageImportStatus(
+                F(
+                    "settings.plugins.install_failed_format",
+                    "Failed to install plugin package: {0}",
+                    ex.Message),
+                isError: true);
+        }
+        finally
+        {
+            if (!string.IsNullOrWhiteSpace(temporaryPackagePath))
+            {
+                try
+                {
+                    File.Delete(temporaryPackagePath);
+                }
+                catch
+                {
+                    // Ignore temporary file cleanup errors.
+                }
+            }
+        }
+    }
+
+    private void RefreshPluginNavigation(TopLevel? topLevel)
+    {
+        switch (topLevel)
+        {
+            case MainWindow mainWindow:
+                mainWindow.RefreshPluginSettingsNavigation();
+                break;
+            case SettingsWindow settingsWindow:
+                settingsWindow.RefreshPluginSettingsNavigation();
+                break;
+        }
+    }
+
+    private void SetPackageImportStatus(string message, bool isError)
+    {
+        _packageImportStatusMessage = string.IsNullOrWhiteSpace(message) ? null : message;
+        _packageImportStatusIsError = isError;
+        UpdateInstallerUi((Application.Current as App)?.PluginRuntimeService);
+    }
+
     private string BuildPluginSubtitle(PluginCatalogEntry entry)
     {
         var source = entry.IsPackage
@@ -215,8 +349,35 @@ public partial class PluginSettingsPage : UserControl
     {
         return string.Format(CultureInfo.CurrentCulture, L(key, fallback), args);
     }
+
+    private static async Task<string?> CopyPackageToTemporaryFileAsync(IStorageFile file)
+    {
+        try
+        {
+            var extension = Path.GetExtension(file.Name);
+            if (string.IsNullOrWhiteSpace(extension))
+            {
+                extension = PluginSdkInfo.PackageFileExtension;
+            }
+
+            var temporaryDirectory = Path.Combine(
+                Path.GetTempPath(),
+                "LanMountainDesktop",
+                "PluginImports");
+            Directory.CreateDirectory(temporaryDirectory);
+
+            var temporaryPackagePath = Path.Combine(
+                temporaryDirectory,
+                $"{DateTime.Now:yyyyMMdd_HHmmss}_{Guid.NewGuid():N}{extension}");
+
+            await using var sourceStream = await file.OpenReadAsync();
+            await using var destinationStream = File.Create(temporaryPackagePath);
+            await sourceStream.CopyToAsync(destinationStream);
+            return temporaryPackagePath;
+        }
+        catch
+        {
+            return null;
+        }
+    }
 }
-
-
-
-

LanMountainDesktop/plugins/PluginSettingsPage.axaml

@@ -51,6 +51,24 @@
                 </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"
@@ -64,5 +82,6 @@
                 </ui:SettingsExpander.Footer>
             </ui:SettingsExpander>
         </Border>
+
     </StackPanel>
 </UserControl>

LanMountainDesktop/plugins/README.md

@@ -0,0 +1,57 @@
+# 宿主侧插件运行时
+
+## 中文
+
+本目录保存阑山桌面宿主程序中的插件运行时实现。
+
+### 主要职责
+
+- 发现已安装插件
+- 安装和替换 `.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`
+- `PluginRuntimeService.cs`
+- `PluginCatalogEntry.cs`
+- `PluginSettingsPage.axaml`
+- `PluginSettingsPage.Host.cs`
+- `PluginMarketIndexService.cs`
+- `PluginMarketInstallService.cs`
+
+### 与 `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

@@ -0,0 +1,14 @@
+using Avalonia.Controls;
+
+namespace LanMountainDesktop.Views;
+
+public partial class SettingsWindow
+{
+    internal TextBlock PluginSettingsPanelTitleTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginSettingsPanelTitleTextBlock")!;
+    internal FluentAvalonia.UI.Controls.SettingsExpander PluginSystemSettingsExpander => PluginSettingsPanel.FindControl<FluentAvalonia.UI.Controls.SettingsExpander>("PluginSystemSettingsExpander")!;
+    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 TextBlock PluginRestartHintTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginRestartHintTextBlock")!;
+    internal TextBlock PluginCatalogEmptyTextBlock => PluginSettingsPanel.FindControl<TextBlock>("PluginCatalogEmptyTextBlock")!;
+}

LanMountainDesktop/plugins/SettingsWindow.PluginSettingsHost.cs

@@ -1,11 +1,10 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using Avalonia;
 using Avalonia.Controls;
+using Avalonia.Layout;
 using Avalonia.Media;
-using FluentAvalonia.UI.Controls;
-using FluentIcons.Avalonia.Fluent;
 using FluentIcons.Common;
 using LanMountainDesktop.Models;
 using LanMountainDesktop.Services;
@@ -18,7 +17,7 @@ public partial class SettingsWindow
 
     private void InitializePluginSettingsNavigation()
     {
-        if (_pluginSettingsPageHosts.Count > 0 || SettingsNavView?.MenuItems is null)
+        if (_pluginSettingsPageHosts.Count > 0)
         {
             return;
         }
@@ -32,6 +31,7 @@ public partial class SettingsWindow
 
         if (contributions is not { Length: > 0 })
         {
+            SettingsPluginNavSection.IsVisible = false;
             return;
         }
 
@@ -39,31 +39,23 @@ public partial class SettingsWindow
             .GroupBy(contribution => contribution.Plugin.Manifest.Id, StringComparer.OrdinalIgnoreCase)
             .ToDictionary(group => group.Key, group => group.Count(), StringComparer.OrdinalIgnoreCase);
 
-        var insertIndex = SettingsNavView.MenuItems.IndexOf(SettingsNavPluginsItem) + 1;
         foreach (var contribution in contributions)
         {
             var tag = BuildPluginSettingsTag(contribution);
             var navigationTitle = BuildPluginSettingsNavigationTitle(contribution, pageCountsByPluginId);
-            var navItem = new NavigationViewItem
-            {
-                Content = navigationTitle,
-                Tag = tag,
-                IconSource = new FluentIcons.Avalonia.Fluent.SymbolIconSource
-                {
-                    Symbol = FluentIcons.Common.Symbol.PuzzlePiece,
-                    IconVariant = FluentIcons.Common.IconVariant.Regular
-                }
-            };
-
+            var navItem = CreateSettingsNavItem(tag, Symbol.PuzzlePiece, navigationTitle);
             ToolTip.SetTip(navItem, $"{contribution.Plugin.Manifest.Name} - {contribution.Registration.Title}");
 
-            SettingsNavView.MenuItems.Insert(insertIndex++, navItem);
+            SettingsPluginNavHost.Children.Add(navItem);
+            _pluginSettingsNavItems[tag] = navItem;
 
             var pageHost = CreatePluginSettingsPageHost(contribution);
             pageHost.IsVisible = false;
             SettingsContentPagesHost.Children.Add(pageHost);
             _pluginSettingsPageHosts[tag] = pageHost;
         }
+
+        SettingsPluginNavSection.IsVisible = SettingsPluginNavHost.Children.Count > 0;
     }
 
     private static string BuildPluginSettingsTag(PluginSettingsPageContribution contribution)
@@ -139,21 +131,50 @@ public partial class SettingsWindow
         }
     }
 
+    internal void RefreshPluginSettingsNavigation()
+    {
+        foreach (var pair in _pluginSettingsPageHosts.ToArray())
+        {
+            if (_pluginSettingsNavItems.TryGetValue(pair.Key, out var navItem))
+            {
+                SettingsPluginNavHost.Children.Remove(navItem);
+            }
+
+            SettingsContentPagesHost.Children.Remove(pair.Value);
+        }
+
+        _pluginSettingsPageHosts.Clear();
+        _pluginSettingsNavItems.Clear();
+        SettingsPluginNavSection.IsVisible = false;
+        InitializePluginSettingsNavigation();
+
+        if (GetSettingsNavItem(_selectedSettingsTabTag) is null)
+        {
+            SelectSettingsTab("Plugins", persistSelection: false);
+        }
+        else
+        {
+            SelectSettingsTab(_selectedSettingsTabTag, persistSelection: false);
+        }
+    }
+
     private string? GetSelectedSettingsTabTag()
     {
-        return (SettingsNavView?.SelectedItem as NavigationViewItem)?.Tag?.ToString();
+        return _selectedSettingsTabTag;
     }
 
     private int ResolveSelectedSettingsTabIndex()
     {
-        if (SettingsNavView?.SelectedItem is null || SettingsNavView.MenuItems is null)
+        var selectedTag = GetSelectedSettingsTabTag();
+        if (string.IsNullOrWhiteSpace(selectedTag))
         {
             return 0;
         }
 
-        for (var i = 0; i < SettingsNavView.MenuItems.Count; i++)
+        var buttons = EnumerateSettingsNavItems().ToList();
+        for (var i = 0; i < buttons.Count; i++)
         {
-            if (ReferenceEquals(SettingsNavView.MenuItems[i], SettingsNavView.SelectedItem))
+            if (string.Equals(buttons[i].Tag?.ToString(), selectedTag, StringComparison.OrdinalIgnoreCase))
             {
                 return i;
             }
@@ -164,30 +185,21 @@ public partial class SettingsWindow
 
     private void RestoreSettingsTabSelection(AppSettingsSnapshot snapshot)
     {
-        if (SettingsNavView?.MenuItems is null || SettingsNavView.MenuItems.Count == 0)
+        var buttons = EnumerateSettingsNavItems().ToList();
+        if (buttons.Count == 0)
         {
             return;
         }
 
-        if (!string.IsNullOrWhiteSpace(snapshot.SettingsTabTag))
+        if (!string.IsNullOrWhiteSpace(snapshot.SettingsTabTag) &&
+            GetSettingsNavItem(snapshot.SettingsTabTag) is not null)
         {
-            var taggedItem = SettingsNavView.MenuItems
-                .OfType<NavigationViewItem>()
-                .FirstOrDefault(item => string.Equals(item.Tag?.ToString(), snapshot.SettingsTabTag, StringComparison.OrdinalIgnoreCase));
-            if (taggedItem is not null)
-            {
-                SettingsNavView.SelectedItem = taggedItem;
-                return;
-            }
+            SelectSettingsTab(snapshot.SettingsTabTag, persistSelection: false);
+            return;
         }
 
-        var safeIndex = Math.Clamp(snapshot.SettingsTabIndex, 0, Math.Max(0, SettingsNavView.MenuItems.Count - 1));
-        if (SettingsNavView.MenuItems[safeIndex] is NavigationViewItem navItem)
-        {
-            SettingsNavView.SelectedItem = navItem;
-        }
+        var safeIndex = Math.Clamp(snapshot.SettingsTabIndex, 0, Math.Max(0, buttons.Count - 1));
+        var button = buttons[safeIndex];
+        SelectSettingsTab(button.Tag?.ToString() ?? "Wallpaper", persistSelection: false);
     }
 }
-
-
-

LanMountainDesktop/plugins/SettingsWindow.PluginSettingsLocalization.cs

@@ -0,0 +1,18 @@
+namespace LanMountainDesktop.Views;
+
+public partial class SettingsWindow
+{
+    private void ApplyPluginSettingsLocalization()
+    {
+        PluginSettingsPanelTitleTextBlock.Text = L("settings.plugins.title", "Plugins");
+        PluginSystemSettingsExpander.Header = L("settings.plugins.runtime_header", "Plugin Runtime");
+        PluginSystemSettingsExpander.Description = L("settings.plugins.runtime_desc", "Review plugin runtime state and load results.");
+        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.");
+        PluginCatalogEmptyTextBlock.Text = L("settings.plugins.empty", "No plugins found.");
+        PluginSettingsPanel.RefreshFromRuntime();
+    }
+}

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

@@ -0,0 +1,17 @@
+# AirApp Market 目录说明
+
+## 中文
+
+这个目录是阑山桌面仓库里遗留的市场原型目录，只用于历史参考，不再作为官方权威市场源。
+
+### 当前结论
+
+- 官方市场源以独立 `LanAirApp` 仓库中的 `airappmarket/index.json` 为准
+- 阑山桌面程序应连接 `LanAirApp` 仓库，而不是以本目录为权威数据源
+- 如无特殊需要，不应继续向这里添加正式市场数据
+
+## English
+
+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/sample-plugin.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" role="img" aria-label="Sample Plugin">
+  <defs>
+    <linearGradient id="sampleBg" x1="0" x2="1" y1="0" y2="1">
+      <stop offset="0%" stop-color="#F59E0B"/>
+      <stop offset="100%" stop-color="#EF4444"/>
+    </linearGradient>
+  </defs>
+  <rect x="8" y="8" width="112" height="112" rx="28" fill="url(#sampleBg)"/>
+  <path d="M52 32c0-6.627 5.373-12 12-12s12 5.373 12 12v8h8c6.627 0 12 5.373 12 12s-5.373 12-12 12h-8v32c0 6.627-5.373 12-12 12s-12-5.373-12-12V64h-8c-6.627 0-12-5.373-12-12s5.373-12 12-12h8v-8Z" fill="#FFFFFF" fill-opacity="0.92"/>
+</svg>

airappmarket/index.json

@@ -0,0 +1,31 @@
+{
+  "schemaVersion": "1.0.0",
+  "sourceId": "official.lanmountaindesktop",
+  "sourceName": "LanMountainDesktop Official Market",
+  "generatedAt": "2026-03-10T11:10:00Z",
+  "plugins": [
+    {
+      "id": "LanMountainDesktop.SamplePlugin",
+      "name": "LanMountain Sample Plugin",
+      "description": "Example plugin used to validate PluginSdk loading and isolation.",
+      "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.SamplePlugin.1.0.0.laapp",
+      "sha256": "c092f9d215ee0f1e436bc49b919dd9a75b3838e950c72c46dd7e41807557125c",
+      "packageSizeBytes": 1703398,
+      "iconUrl": "https://raw.githubusercontent.com/wwiinnddyy/LanMountainDesktop/main/airappmarket/assets/sample-plugin.svg",
+      "homepageUrl": "https://github.com/wwiinnddyy/LanMountainDesktop/tree/main/LanAirApp/samples/LanMountainDesktop.SamplePlugin",
+      "repositoryUrl": "https://github.com/wwiinnddyy/LanMountainDesktop/tree/main/LanAirApp/samples/LanMountainDesktop.SamplePlugin",
+      "tags": [
+        "example",
+        "official",
+        "sdk"
+      ],
+      "publishedAt": "2026-03-10T01:30:00Z",
+      "updatedAt": "2026-03-10T01:30:00Z",
+      "releaseNotes": "Reference plugin for SDK validation. Includes a settings page, a desktop widget, localization resources, service registration, and plugin message bus usage."
+    }
+  ]
+}

airappmarket/schema/airappmarket-index.schema.json

@@ -0,0 +1,137 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/wwiinnddyy/LanMountainDesktop/main/airappmarket/schema/airappmarket-index.schema.json",
+  "title": "AirAppMarket Index",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "sourceId",
+    "sourceName",
+    "generatedAt",
+    "plugins"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$"
+    },
+    "sourceId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "sourceName": {
+      "type": "string",
+      "minLength": 1
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "plugins": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/plugin"
+      }
+    }
+  },
+  "$defs": {
+    "plugin": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "name",
+        "description",
+        "author",
+        "version",
+        "apiVersion",
+        "minHostVersion",
+        "downloadUrl",
+        "sha256",
+        "packageSizeBytes",
+        "iconUrl",
+        "homepageUrl",
+        "repositoryUrl",
+        "tags",
+        "publishedAt",
+        "updatedAt",
+        "releaseNotes"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "author": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+ ][A-Za-z0-9.-]+)?$"
+        },
+        "apiVersion": {
+          "type": "string",
+          "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+ ][A-Za-z0-9.-]+)?$"
+        },
+        "minHostVersion": {
+          "type": "string",
+          "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+ ][A-Za-z0-9.-]+)?$"
+        },
+        "downloadUrl": {
+          "type": "string",
+          "format": "uri"
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[a-fA-F0-9]{64}$"
+        },
+        "packageSizeBytes": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "iconUrl": {
+          "type": "string",
+          "format": "uri"
+        },
+        "homepageUrl": {
+          "type": "string",
+          "format": "uri"
+        },
+        "repositoryUrl": {
+          "type": "string",
+          "format": "uri"
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": true
+        },
+        "publishedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "updatedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "releaseNotes": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    }
+  }
+}

airappmarket/tools/AirAppMarket.Validator/AirAppMarket.Validator.csproj

@@ -0,0 +1,11 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <Version>1.0.0</Version>
+  </PropertyGroup>
+
+</Project>

airappmarket/tools/AirAppMarket.Validator/Program.cs

@@ -0,0 +1,247 @@
+using System.Text.Json;
+
+return await RunAsync(args);
+
+static Task<int> RunAsync(string[] args)
+{
+    try
+    {
+        var indexPath = args.Length > 0
+            ? Path.GetFullPath(args[0])
+            : Path.GetFullPath(Path.Combine(AppContext.BaseDirectory, "..", "..", "..", "..", "index.json"));
+        var schemaPath = args.Length > 1
+            ? Path.GetFullPath(args[1])
+            : Path.GetFullPath(Path.Combine(Path.GetDirectoryName(indexPath)!, "schema", "airappmarket-index.schema.json"));
+
+        if (!File.Exists(indexPath))
+        {
+            throw new FileNotFoundException($"Market index '{indexPath}' was not found.", indexPath);
+        }
+
+        if (!File.Exists(schemaPath))
+        {
+            throw new FileNotFoundException($"Market schema '{schemaPath}' was not found.", schemaPath);
+        }
+
+        JsonDocument.Parse(File.ReadAllText(schemaPath));
+        var document = MarketIndex.Load(File.ReadAllText(indexPath), indexPath);
+
+        Console.WriteLine($"Validated '{indexPath}'.");
+        Console.WriteLine($"Source: {document.SourceName} ({document.SourceId})");
+        Console.WriteLine($"Plugins: {document.Plugins.Count}");
+        return Task.FromResult(0);
+    }
+    catch (Exception ex)
+    {
+        Console.Error.WriteLine(ex.Message);
+        return Task.FromResult(1);
+    }
+}
+
+internal sealed class MarketIndex
+{
+    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<MarketPlugin> Plugins { get; init; } = [];
+
+    public static MarketIndex Load(string json, string sourceName)
+    {
+        var document = JsonSerializer.Deserialize<MarketIndex>(
+            json.TrimStart('\uFEFF'),
+            SerializerOptions) ?? throw new InvalidOperationException($"Failed to parse market index '{sourceName}'.");
+
+        return document.ValidateAndNormalize(sourceName);
+    }
+
+    private MarketIndex ValidateAndNormalize(string sourceName)
+    {
+        var normalizedPlugins = new List<MarketPlugin>(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 MarketIndex
+        {
+            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
+        };
+    }
+
+    internal 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 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 static void EnsureUrl(string? value, string propertyName, string sourceName)
+    {
+        var normalized = RequireValue(value, propertyName, sourceName);
+        if (!Uri.TryCreate(normalized, UriKind.Absolute, out var uri) ||
+            (uri.Scheme != Uri.UriSchemeHttp && uri.Scheme != Uri.UriSchemeHttps))
+        {
+            throw new InvalidOperationException(
+                $"Market index '{sourceName}' declares invalid URL '{normalized}' for '{propertyName}'.");
+        }
+    }
+}
+
+internal sealed class MarketPlugin
+{
+    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 MarketPlugin ValidateAndNormalize(string sourceName)
+    {
+        var tagSource = Tags ?? [];
+        var normalizedTags = tagSource
+            .Select(MarketIndex.NormalizeValue)
+            .Where(tag => !string.IsNullOrWhiteSpace(tag))
+            .Select(tag => tag!)
+            .Distinct(StringComparer.OrdinalIgnoreCase)
+            .ToList();
+
+        if (normalizedTags.Count != tagSource.Count(tag => !string.IsNullOrWhiteSpace(tag)))
+        {
+            throw new InvalidOperationException(
+                $"Market index '{sourceName}' contains duplicate or blank tags for plugin '{Id}'.");
+        }
+
+        var normalizedSha = MarketIndex.RequireValue(Sha256, nameof(Sha256), sourceName).ToLowerInvariant();
+        if (normalizedSha.Length != 64 || normalizedSha.Any(ch => !Uri.IsHexDigit(ch)))
+        {
+            throw new InvalidOperationException(
+                $"Market index '{sourceName}' declares invalid SHA-256 '{normalizedSha}' for plugin '{Id}'.");
+        }
+
+        MarketIndex.EnsureUrl(DownloadUrl, nameof(DownloadUrl), sourceName);
+        MarketIndex.EnsureUrl(IconUrl, nameof(IconUrl), sourceName);
+        MarketIndex.EnsureUrl(HomepageUrl, nameof(HomepageUrl), sourceName);
+        MarketIndex.EnsureUrl(RepositoryUrl, 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 MarketPlugin
+        {
+            Id = MarketIndex.RequireValue(Id, nameof(Id), sourceName),
+            Name = MarketIndex.RequireValue(Name, nameof(Name), sourceName),
+            Description = MarketIndex.RequireValue(Description, nameof(Description), sourceName),
+            Author = MarketIndex.RequireValue(Author, nameof(Author), sourceName),
+            Version = MarketIndex.NormalizeVersion(Version, nameof(Version), sourceName),
+            ApiVersion = MarketIndex.NormalizeVersion(ApiVersion, nameof(ApiVersion), sourceName),
+            MinHostVersion = MarketIndex.NormalizeVersion(MinHostVersion, nameof(MinHostVersion), sourceName),
+            DownloadUrl = MarketIndex.RequireValue(DownloadUrl, nameof(DownloadUrl), sourceName),
+            Sha256 = normalizedSha,
+            PackageSizeBytes = PackageSizeBytes,
+            IconUrl = MarketIndex.RequireValue(IconUrl, nameof(IconUrl), sourceName),
+            HomepageUrl = MarketIndex.RequireValue(HomepageUrl, nameof(HomepageUrl), sourceName),
+            RepositoryUrl = MarketIndex.RequireValue(RepositoryUrl, nameof(RepositoryUrl), sourceName),
+            Tags = normalizedTags,
+            PublishedAt = PublishedAt,
+            UpdatedAt = UpdatedAt,
+            ReleaseNotes = MarketIndex.RequireValue(ReleaseNotes, nameof(ReleaseNotes), sourceName)
+        };
+    }
+}