0.7.3

修东西

.codex/environments/environment.toml

@@ -0,0 +1,16 @@
+# THIS IS AUTOGENERATED. DO NOT EDIT MANUALLY
+version = 1
+name = "LanMountainDesktop"
+
+[setup]
+script = ""
+
+[[actions]]
+name = "运行"
+icon = "run"
+command = "dotnet run --project 'C:\\Users\\USER693091\\Documents\\GitHub\\LanMountainDesktop\\LanMountainDesktop\\LanMountainDesktop.csproj"
+
+[[actions]]
+name = "构建"
+icon = "tool"
+command = "dotnet build 'C:\\Users\\USER693091\\Documents\\GitHub\\LanMountainDesktop\\LanMountainDesktop.slnx"

.github/workflows/airappmarket-validate.yml

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

.github/workflows/build.yml

@@ -113,3 +113,31 @@ jobs:
           path: |
             LanMountainDesktop/bin/Release/
           retention-days: 7
+
+  pack-plugin-packages:
+    runs-on: ubuntu-latest
+    name: Pack_Plugin_Packages
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          submodules: recursive
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{ env.DOTNET_VERSION }}
+
+      - name: Pack SDK and template packages
+        shell: pwsh
+        run: .\scripts\Pack-PluginPackages.ps1 -Configuration Release -OutputPath .\artifacts\nuget
+
+      - name: Upload plugin package artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: plugin-packages
+          path: artifacts/nuget/*.nupkg
+          if-no-files-found: error
+          retention-days: 14

Directory.Build.props

@@ -0,0 +1,8 @@
+<Project>
+  <PropertyGroup>
+    <Version>1.0.0</Version>
+    <TargetFramework Condition="'$(TargetFramework)' == ''">net10.0</TargetFramework>
+    <Nullable Condition="'$(Nullable)' == ''">enable</Nullable>
+    <ImplicitUsings Condition="'$(ImplicitUsings)' == ''">enable</ImplicitUsings>
+  </PropertyGroup>
+</Project>

LanAirApp/README.md

@@ -1,33 +0,0 @@
-# LanAirApp (Mirror)
-
-## 中文
-
-这里的 `LanAirApp/` 是放在宿主仓库里的镜像副本，只用于本地联调和工作区构建，不是插件市场或插件开发资料的最终权威来源。
-
-### 这份镜像的角色
-
-- 提供本地工作区里的 `airappmarket` 索引副本
-- 提供插件文档、工具和样例镜像，便于和宿主一起联调
-- 不承担宿主运行时职责
-
-### 权威来源
-
-- 插件市场与开发文档：独立 `LanAirApp` 仓库
-- 权威示例插件：独立 `LanMountainDesktop.SamplePlugin`
-- 本目录中的 `samples/LanMountainDesktop.SamplePlugin` 只是镜像模板副本
-
-## English
-
-This `LanAirApp/` directory is a mirror that lives inside the host repository. It exists for local workspace integration and build convenience only. It is not the final authority for the plugin market or developer-facing plugin materials.
-
-### Role of this mirror
-
-- keep a local copy of the `airappmarket` index for workspace integration
-- keep mirrored docs, tools, and sample templates for local development
-- avoid duplicating host runtime responsibilities
-
-### Sources of truth
-
-- Plugin market and developer docs: standalone `LanAirApp`
-- Authoritative sample plugin: standalone `LanMountainDesktop.SamplePlugin`
-- `samples/LanMountainDesktop.SamplePlugin` in this mirror is template/mirror content only

LanAirApp/docs/PLUGIN_DEVELOPMENT.md

@@ -1,16 +0,0 @@
-# 插件开发指南
-
-## 中文
-
-使用 `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

@@ -1,14 +0,0 @@
-# 插件打包指南
-
-## 中文
-
-阑山桌面插件的标准安装格式为 `.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

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

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

@@ -1,84 +0,0 @@
-{
-  "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.close_desktop.display_name": "Close Desktop",
-  "widget.close_desktop.text": "Close Desktop",
-  "widget.close_desktop.hint": "Exit LanMountainDesktop on click",
-  "widget.close_desktop.unavailable": "Host lifecycle API is unavailable",
-  "widget.close_desktop.failed": "Host rejected the exit request",
-  "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

@@ -1,79 +0,0 @@
-{
-  "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

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

@@ -1,100 +0,0 @@
-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",
-                "Initialization log written: {0}",
-                logPath));
-        }
-        catch (Exception ex)
-        {
-            _stateService.MarkBackendFaulted(localizer.Format(
-                "status.backend.detail.log_write_failed",
-                "Initialization log failed: {0}",
-                ex.Message));
-            throw;
-        }
-
-        _clockService.Start();
-
-        context.RegisterDesktopComponent(new PluginDesktopComponentRegistration(
-            "LanMountainDesktop.SamplePlugin.StatusClock",
-            localizer.GetString("widget.display_name", "Sample Plugin Status Clock"),
-            widgetContext => new SamplePluginStatusClockWidget(widgetContext),
-            iconKey: "PuzzlePiece",
-            category: localizer.GetString("widget.category", "Plugins"),
-            minWidthCells: 4,
-            minHeightCells: 4,
-            allowDesktopPlacement: true,
-            allowStatusBarPlacement: false,
-            resizeMode: PluginDesktopComponentResizeMode.Proportional,
-            cornerRadiusResolver: cellSize => Math.Clamp(cellSize * 0.34, 18, 34)));
-
-        context.RegisterDesktopComponent(new PluginDesktopComponentRegistration(
-            "LanMountainDesktop.SamplePlugin.CloseDesktop",
-            localizer.GetString("widget.close_desktop.display_name", "Close Desktop"),
-            widgetContext => new SamplePluginCloseDesktopWidget(widgetContext),
-            iconKey: "DismissCircle",
-            category: localizer.GetString("widget.category", "Plugins"),
-            minWidthCells: 2,
-            minHeightCells: 1,
-            allowDesktopPlacement: true,
-            allowStatusBarPlacement: false,
-            resizeMode: PluginDesktopComponentResizeMode.Free,
-            cornerRadiusResolver: cellSize => Math.Clamp(cellSize * 0.28, 14, 22)));
-    }
-
-    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/SamplePluginCloseDesktopWidget.cs

@@ -1,166 +0,0 @@
-using Avalonia;
-using Avalonia.Controls;
-using Avalonia.Layout;
-using Avalonia.Media;
-using LanMountainDesktop.PluginSdk;
-
-namespace LanMountainDesktop.SamplePlugin;
-
-internal sealed class SamplePluginCloseDesktopWidget : Border
-{
-    private readonly PluginLocalizer _localizer;
-    private readonly IHostApplicationLifecycle? _hostApplicationLifecycle;
-    private readonly TextBlock _titleTextBlock;
-    private readonly TextBlock _statusTextBlock;
-
-    public SamplePluginCloseDesktopWidget(PluginDesktopComponentContext context)
-    {
-        _localizer = PluginLocalizer.Create(context);
-        _hostApplicationLifecycle = context.GetService<IHostApplicationLifecycle>();
-
-        _titleTextBlock = new TextBlock
-        {
-            Text = T("widget.close_desktop.text", "关闭桌面"),
-            Foreground = Brushes.White,
-            FontWeight = FontWeight.SemiBold,
-            VerticalAlignment = VerticalAlignment.Center
-        };
-
-        _statusTextBlock = new TextBlock
-        {
-            Text = _hostApplicationLifecycle is null
-                ? T("widget.close_desktop.unavailable", "宿主未提供退出接口")
-                : T("widget.close_desktop.hint", "点击后退出阑山桌面"),
-            Foreground = new SolidColorBrush(Color.Parse("#FFD4E7F6")),
-            VerticalAlignment = VerticalAlignment.Center
-        };
-
-        var contentGrid = new Grid
-        {
-            ColumnDefinitions = new ColumnDefinitions("Auto,*"),
-            ColumnSpacing = 14,
-            VerticalAlignment = VerticalAlignment.Center,
-            Children =
-            {
-                CreateIconShell(),
-                new StackPanel
-                {
-                    Spacing = 2,
-                    VerticalAlignment = VerticalAlignment.Center,
-                    Children =
-                    {
-                        _titleTextBlock,
-                        _statusTextBlock
-                    }
-                }
-            }
-        };
-
-        Grid.SetColumn(contentGrid.Children[1], 1);
-
-        var actionButton = new Button
-        {
-            HorizontalAlignment = HorizontalAlignment.Stretch,
-            VerticalAlignment = VerticalAlignment.Stretch,
-            HorizontalContentAlignment = HorizontalAlignment.Stretch,
-            VerticalContentAlignment = VerticalAlignment.Stretch,
-            Background = Brushes.Transparent,
-            BorderThickness = new Thickness(0),
-            Padding = new Thickness(0),
-            IsEnabled = _hostApplicationLifecycle is not null,
-            Content = contentGrid
-        };
-        actionButton.Click += OnButtonClick;
-
-        Background = new LinearGradientBrush
-        {
-            StartPoint = new RelativePoint(0, 0, RelativeUnit.Relative),
-            EndPoint = new RelativePoint(1, 1, RelativeUnit.Relative),
-            GradientStops =
-            [
-                new GradientStop(Color.Parse("#FF0B1220"), 0),
-                new GradientStop(Color.Parse("#FF172554"), 0.55),
-                new GradientStop(Color.Parse("#FF7F1D1D"), 1)
-            ]
-        };
-        BorderBrush = new SolidColorBrush(Color.Parse("#66FB7185"));
-        BorderThickness = new Thickness(1);
-        CornerRadius = new CornerRadius(18);
-        Padding = new Thickness(14, 10);
-        Child = actionButton;
-
-        SizeChanged += OnSizeChanged;
-        ApplyScale();
-    }
-
-    private Border CreateIconShell()
-    {
-        return new Border
-        {
-            Width = 36,
-            Height = 36,
-            CornerRadius = new CornerRadius(999),
-            Background = new SolidColorBrush(Color.Parse("#33F87171")),
-            BorderBrush = new SolidColorBrush(Color.Parse("#88FCA5A5")),
-            BorderThickness = new Thickness(1),
-            VerticalAlignment = VerticalAlignment.Center,
-            Child = new TextBlock
-            {
-                Text = "⏻",
-                FontSize = 18,
-                Foreground = Brushes.White,
-                HorizontalAlignment = HorizontalAlignment.Center,
-                VerticalAlignment = VerticalAlignment.Center,
-                TextAlignment = TextAlignment.Center
-            }
-        };
-    }
-
-    private void OnButtonClick(object? sender, Avalonia.Interactivity.RoutedEventArgs e)
-    {
-        if (_hostApplicationLifecycle?.TryExit(new HostApplicationLifecycleRequest(
-                Source: "SamplePlugin.CloseDesktopWidget",
-                Reason: "User invoked the sample plugin close-desktop widget.")) == true)
-        {
-            return;
-        }
-
-        _statusTextBlock.Text = T("widget.close_desktop.failed", "宿主未接受退出请求");
-    }
-
-    private void OnSizeChanged(object? sender, SizeChangedEventArgs e)
-    {
-        ApplyScale();
-    }
-
-    private void ApplyScale()
-    {
-        var basis = Bounds.Height > 1 ? Bounds.Height : 72;
-        Padding = new Thickness(Math.Clamp(basis * 0.18, 12, 18), Math.Clamp(basis * 0.14, 8, 14));
-        CornerRadius = new CornerRadius(Math.Clamp(basis * 0.32, 16, 24));
-
-        if (Child is not Button actionButton || actionButton.Content is not Grid contentGrid)
-        {
-            return;
-        }
-
-        if (contentGrid.Children[0] is Border iconShell)
-        {
-            var iconSize = Math.Clamp(basis * 0.58, 28, 40);
-            iconShell.Width = iconSize;
-            iconShell.Height = iconSize;
-            if (iconShell.Child is TextBlock iconText)
-            {
-                iconText.FontSize = Math.Clamp(iconSize * 0.5, 14, 20);
-            }
-        }
-
-        _titleTextBlock.FontSize = Math.Clamp(basis * 0.28, 14, 20);
-        _statusTextBlock.FontSize = Math.Clamp(basis * 0.18, 10, 13);
-    }
-
-    private string T(string key, string fallback)
-    {
-        return _localizer.GetString(key, fallback);
-    }
-}

LanAirApp/samples/LanMountainDesktop.SamplePlugin/SamplePluginRuntimeStatus.cs

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

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

@@ -1,298 +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 SamplePluginStatusClockWidget : Border
-{
-    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 _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
-        };
-        _subtitleTextBlock = new TextBlock
-        {
-            Foreground = new SolidColorBrush(Color.Parse("#FFBFE9FF")),
-            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
-        {
-            StartPoint = new RelativePoint(0, 0, RelativeUnit.Relative),
-            EndPoint = new RelativePoint(1, 1, RelativeUnit.Relative),
-            GradientStops =
-            [
-                new GradientStop(Color.Parse("#FF07111F"), 0),
-                new GradientStop(Color.Parse("#FF0C4A6E"), 0.55),
-                new GradientStop(Color.Parse("#FF0EA5E9"), 1)
-            ]
-        };
-        BorderBrush = new SolidColorBrush(Color.Parse("#6648C7FF"));
-        BorderThickness = new Thickness(1);
-        HorizontalAlignment = HorizontalAlignment.Stretch;
-        VerticalAlignment = VerticalAlignment.Stretch;
-        Child = new Grid
-        {
-            RowDefinitions = new RowDefinitions("Auto,*"),
-            RowSpacing = 14,
-            Children =
-            {
-                new StackPanel
-                {
-                    Spacing = 4,
-                    HorizontalAlignment = HorizontalAlignment.Left,
-                    Children =
-                    {
-                        _timeTextBlock,
-                        _subtitleTextBlock
-                    }
-                },
-                _statusHost
-            }
-        };
-
-        Grid.SetRow(((Grid)Child).Children[1], 1);
-
-        AttachedToVisualTree += OnAttachedToVisualTree;
-        DetachedFromVisualTree += OnDetachedFromVisualTree;
-        SizeChanged += OnSizeChanged;
-
-        RefreshClock(_clockService.CurrentTime);
-        UpdateSubtitle();
-        RefreshStatusPanel();
-        ApplyScale();
-    }
-
-    private void OnAttachedToVisualTree(object? sender, VisualTreeAttachmentEventArgs e)
-    {
-        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();
-    }
-
-    private void OnDetachedFromVisualTree(object? sender, VisualTreeAttachmentEventArgs e)
-    {
-        foreach (var subscription in _subscriptions)
-        {
-            subscription.Dispose();
-        }
-
-        _subscriptions.Clear();
-
-        if (string.IsNullOrWhiteSpace(_instanceId))
-        {
-            return;
-        }
-
-        _stateService.UnregisterComponentInstance(_instanceId);
-        _instanceId = null;
-    }
-
-    private void OnSizeChanged(object? sender, SizeChangedEventArgs e)
-    {
-        ApplyScale();
-        RefreshStatusPanel();
-    }
-
-    private void SubscribeToPluginBus()
-    {
-        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.068, 11, 16);
-        var detailSize = Math.Clamp(basis * 0.052, 9, 13);
-
-        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(10, 8),
-                Child = new Grid
-                {
-                    RowDefinitions = new RowDefinitions("Auto,Auto"),
-                    ColumnDefinitions = new ColumnDefinitions("Auto,*,Auto"),
-                    ColumnSpacing = 8,
-                    Children =
-                    {
-                        new Border
-                        {
-                            Width = Math.Clamp(basis * 0.038, 8, 11),
-                            Height = Math.Clamp(basis * 0.038, 8, 11),
-                            CornerRadius = new CornerRadius(999),
-                            Background = new SolidColorBrush(palette.Dot),
-                            VerticalAlignment = VerticalAlignment.Center
-                        },
-                        new TextBlock
-                        {
-                            Text = entry.Title,
-                            FontSize = titleSize,
-                            FontWeight = FontWeight.SemiBold,
-                            Foreground = Brushes.White,
-                            TextWrapping = TextWrapping.Wrap
-                        },
-                        new TextBlock
-                        {
-                            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
-                        }
-                    }
-                }
-            });
-
-            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);
-        }
-    }
-
-    private void ApplyScale()
-    {
-        var basis = GetLayoutBasis();
-        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);
-        _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()
-    {
-        var width = Bounds.Width > 1 ? Bounds.Width : _context.CellSize * 4;
-        var height = Bounds.Height > 1 ? Bounds.Height : _context.CellSize * 4;
-        return Math.Max(_context.CellSize * 4, Math.Min(width, height));
-    }
-
-    private static (Color Background, Color Border, Color Dot) GetPalette(SamplePluginHealthState state)
-    {
-        return state switch
-        {
-            SamplePluginHealthState.Healthy => (
-                Color.Parse("#1F0F766E"),
-                Color.Parse("#4D5EEAD4"),
-                Color.Parse("#5EEAD4")),
-            SamplePluginHealthState.Faulted => (
-                Color.Parse("#29B91C1C"),
-                Color.Parse("#66F87171"),
-                Color.Parse("#F87171")),
-            _ => (
-                Color.Parse("#1F7C2D12"),
-                Color.Parse("#66FDBA74"),
-                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/LanMountainDesktop.SamplePlugin/plugin.json

@@ -1,9 +0,0 @@
-{
-  "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",
-  "entranceAssembly": "LanMountainDesktop.SamplePlugin.dll"
-}

LanAirApp/samples/README.md

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

LanAirApp/standards/README.md

@@ -1,9 +0,0 @@
-# 插件标准说明
-
-## 中文
-
-本目录存放插件开发需要遵循的基础约定，包括 `.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

@@ -1,9 +0,0 @@
-{
-  "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/Program.cs

@@ -1,136 +0,0 @@
-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.Appearance/AppearanceCornerRadiusTokenFactory.cs

@@ -0,0 +1,27 @@
+using Avalonia;
+using LanMountainDesktop.Settings.Core;
+using LanMountainDesktop.Shared.Contracts;
+
+namespace LanMountainDesktop.Appearance;
+
+public static class AppearanceCornerRadiusTokenFactory
+{
+    public static AppearanceCornerRadiusTokens Create(double scale)
+    {
+        var normalizedScale = GlobalAppearanceSettings.NormalizeCornerRadiusScale(scale);
+        return new AppearanceCornerRadiusTokens(
+            Radius(6, normalizedScale),
+            Radius(10, normalizedScale),
+            Radius(14, normalizedScale),
+            Radius(18, normalizedScale),
+            Radius(24, normalizedScale),
+            Radius(30, normalizedScale),
+            Radius(36, normalizedScale));
+    }
+
+    private static CornerRadius Radius(double value, double scale)
+    {
+        var scaled = Math.Round(value * scale * 2, MidpointRounding.AwayFromZero) / 2d;
+        return new CornerRadius(scaled);
+    }
+}

LanMountainDesktop.Appearance/LanMountainDesktop.Appearance.csproj

@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+  <ItemGroup>
+    <ProjectReference Include="..\LanMountainDesktop.PluginSdk\LanMountainDesktop.PluginSdk.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Shared.Contracts\LanMountainDesktop.Shared.Contracts.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Settings.Core\LanMountainDesktop.Settings.Core.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Host.Abstractions\LanMountainDesktop.Host.Abstractions.csproj" />
+  </ItemGroup>
+</Project>

LanMountainDesktop.DesktopComponents.Runtime/LanMountainDesktop.DesktopComponents.Runtime.csproj

@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+  <ItemGroup>
+    <ProjectReference Include="..\LanMountainDesktop.PluginSdk\LanMountainDesktop.PluginSdk.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Shared.Contracts\LanMountainDesktop.Shared.Contracts.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Settings.Core\LanMountainDesktop.Settings.Core.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Appearance\LanMountainDesktop.Appearance.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Host.Abstractions\LanMountainDesktop.Host.Abstractions.csproj" />
+  </ItemGroup>
+</Project>

LanMountainDesktop.DesktopHost/DesktopBootstrap.cs

@@ -0,0 +1,31 @@
+using System;
+using Avalonia;
+
+namespace LanMountainDesktop.DesktopHost;
+
+public static class DesktopBootstrap
+{
+    public static void InitializeStartupServices(
+        Action initializeTelemetryIdentity,
+        Action initializeCrashTelemetry,
+        Action initializeUsageTelemetry,
+        Action scheduleStartupCleanup)
+    {
+        ArgumentNullException.ThrowIfNull(initializeTelemetryIdentity);
+        ArgumentNullException.ThrowIfNull(initializeCrashTelemetry);
+        ArgumentNullException.ThrowIfNull(initializeUsageTelemetry);
+        ArgumentNullException.ThrowIfNull(scheduleStartupCleanup);
+
+        initializeTelemetryIdentity();
+        initializeCrashTelemetry();
+        initializeUsageTelemetry();
+        scheduleStartupCleanup();
+    }
+
+    public static void InitializeApplication(Application application, Action initializeShell)
+    {
+        ArgumentNullException.ThrowIfNull(application);
+        ArgumentNullException.ThrowIfNull(initializeShell);
+        initializeShell();
+    }
+}

LanMountainDesktop.DesktopHost/DesktopShellHost.cs

@@ -0,0 +1,55 @@
+using System;
+using Avalonia;
+using Avalonia.Controls;
+using Avalonia.Controls.ApplicationLifetimes;
+using LanMountainDesktop.Host.Abstractions;
+
+namespace LanMountainDesktop.DesktopHost;
+
+public sealed class DesktopShellHost : IDesktopShellHost
+{
+    private readonly Action _initializePluginRuntime;
+    private readonly Action _initializeTrayIcon;
+    private readonly Action<IClassicDesktopStyleApplicationLifetime> _createAndAssignMainWindow;
+    private readonly Action _performExitCleanup;
+    private readonly Action _startActivationListener;
+    private readonly Action _startWeatherRefresh;
+
+    public DesktopShellHost(
+        Action initializePluginRuntime,
+        Action initializeTrayIcon,
+        Action<IClassicDesktopStyleApplicationLifetime> createAndAssignMainWindow,
+        Action performExitCleanup,
+        Action startActivationListener,
+        Action startWeatherRefresh)
+    {
+        _initializePluginRuntime = initializePluginRuntime;
+        _initializeTrayIcon = initializeTrayIcon;
+        _createAndAssignMainWindow = createAndAssignMainWindow;
+        _performExitCleanup = performExitCleanup;
+        _startActivationListener = startActivationListener;
+        _startWeatherRefresh = startWeatherRefresh;
+    }
+
+    public void Initialize()
+    {
+        throw new InvalidOperationException("An application instance is required to initialize the desktop shell.");
+    }
+
+    public void Initialize(Application application)
+    {
+        ArgumentNullException.ThrowIfNull(application);
+
+        _initializePluginRuntime();
+        _initializeTrayIcon();
+
+        if (application.ApplicationLifetime is IClassicDesktopStyleApplicationLifetime desktop)
+        {
+            desktop.Exit += (_, _) => _performExitCleanup();
+            _createAndAssignMainWindow(desktop);
+            _startActivationListener();
+        }
+
+        _startWeatherRefresh();
+    }
+}

LanMountainDesktop.DesktopHost/DesktopStartupCoordinator.cs

@@ -0,0 +1,15 @@
+using System;
+
+namespace LanMountainDesktop.DesktopHost;
+
+public sealed class DesktopStartupCoordinator
+{
+    private readonly Action _restoreWorkspaceState;
+
+    public DesktopStartupCoordinator(Action restoreWorkspaceState)
+    {
+        _restoreWorkspaceState = restoreWorkspaceState ?? throw new ArgumentNullException(nameof(restoreWorkspaceState));
+    }
+
+    public void Restore() => _restoreWorkspaceState();
+}

LanMountainDesktop.DesktopHost/LanMountainDesktop.DesktopHost.csproj

@@ -0,0 +1,18 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+  <ItemGroup>
+    <PackageReference Include="Avalonia" Version="11.3.12" />
+  </ItemGroup>
+  <ItemGroup>
+    <ProjectReference Include="..\LanMountainDesktop.PluginSdk\LanMountainDesktop.PluginSdk.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Shared.Contracts\LanMountainDesktop.Shared.Contracts.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Settings.Core\LanMountainDesktop.Settings.Core.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Appearance\LanMountainDesktop.Appearance.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.DesktopComponents.Runtime\LanMountainDesktop.DesktopComponents.Runtime.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Host.Abstractions\LanMountainDesktop.Host.Abstractions.csproj" />
+  </ItemGroup>
+</Project>

LanMountainDesktop.DesktopHost/SettingsWindowHost.cs

@@ -0,0 +1,18 @@
+using System;
+
+namespace LanMountainDesktop.DesktopHost;
+
+public sealed class SettingsWindowHost
+{
+    private readonly Action<string, string?> _openSettingsWindow;
+
+    public SettingsWindowHost(Action<string, string?> openSettingsWindow)
+    {
+        _openSettingsWindow = openSettingsWindow ?? throw new ArgumentNullException(nameof(openSettingsWindow));
+    }
+
+    public void Open(string source, string? pageId = null)
+    {
+        _openSettingsWindow(source, pageId);
+    }
+}

LanMountainDesktop.DesktopHost/ShutdownCoordinator.cs

@@ -0,0 +1,19 @@
+using System;
+
+namespace LanMountainDesktop.DesktopHost;
+
+public sealed class ShutdownCoordinator
+{
+    private readonly Action<bool, string> _prepareForShutdown;
+    private readonly Action<string> _resetShutdownIntent;
+
+    public ShutdownCoordinator(Action<bool, string> prepareForShutdown, Action<string> resetShutdownIntent)
+    {
+        _prepareForShutdown = prepareForShutdown ?? throw new ArgumentNullException(nameof(prepareForShutdown));
+        _resetShutdownIntent = resetShutdownIntent ?? throw new ArgumentNullException(nameof(resetShutdownIntent));
+    }
+
+    public void Prepare(bool isRestart, string source) => _prepareForShutdown(isRestart, source);
+
+    public void Reset(string source) => _resetShutdownIntent(source);
+}

LanMountainDesktop.Host.Abstractions/ComponentChromeContext.cs

@@ -0,0 +1,12 @@
+using LanMountainDesktop.PluginSdk;
+using LanMountainDesktop.Shared.Contracts;
+
+namespace LanMountainDesktop.Host.Abstractions;
+
+public sealed record ComponentChromeContext(
+    string ComponentId,
+    string? PlacementId,
+    double CellSize,
+    double GlobalCornerRadiusScale,
+    AppearanceCornerRadiusTokens CornerRadiusTokens,
+    SettingsScope Scope = SettingsScope.App);

LanMountainDesktop.Host.Abstractions/IDesktopShellHost.cs

@@ -0,0 +1,6 @@
+namespace LanMountainDesktop.Host.Abstractions;
+
+public interface IDesktopShellHost
+{
+    void Initialize();
+}

LanMountainDesktop.Host.Abstractions/LanMountainDesktop.Host.Abstractions.csproj

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

LanMountainDesktop.PluginSdk/IPluginAppearanceContext.cs

@@ -0,0 +1,10 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public interface IPluginAppearanceContext
+{
+    PluginAppearanceSnapshot Snapshot { get; }
+
+    double ResolveScaledCornerRadius(double baseRadius, double? minimum = null, double? maximum = null);
+
+    double ResolveCornerRadius(PluginCornerRadiusPreset preset, double? minimum = null, double? maximum = null);
+}

LanMountainDesktop.PluginSdk/IPluginRuntimeContext.cs

@@ -12,6 +12,8 @@ public interface IPluginRuntimeContext
 
     IReadOnlyDictionary<string, object?> Properties { get; }
 
+    IPluginAppearanceContext Appearance { get; }
+
     T? GetService<T>();
 
     bool TryGetProperty<T>(string key, out T? value);

LanMountainDesktop.PluginSdk/LanMountainDesktop.PluginSdk.csproj

@@ -4,7 +4,15 @@
     <TargetFramework>net10.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
-    <Version>3.0.0</Version>
+    <Version>4.0.0</Version>
+    <PackageId>LanMountainDesktop.PluginSdk</PackageId>
+    <IsPackable>true</IsPackable>
+    <Authors>LanMountainDesktop</Authors>
+    <Description>Official plugin SDK for LanMountainDesktop, including plugin manifest contracts, runtime interfaces, and registration extensions.</Description>
+    <PackageTags>LanMountainDesktop;Plugin;SDK;Avalonia</PackageTags>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
+    <RepositoryUrl>https://github.com/wwiinnddyy/LanMountainDesktop</RepositoryUrl>
+    <RepositoryType>git</RepositoryType>
   </PropertyGroup>
 
   <ItemGroup>
@@ -12,6 +20,13 @@
     <PackageReference Include="Avalonia" Version="11.3.12" />
     <PackageReference Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="10.0.0" />
     <PackageReference Include="Microsoft.Extensions.Hosting.Abstractions" Version="10.0.0" />
+    <ProjectReference Include="..\LanMountainDesktop.Shared.Contracts\LanMountainDesktop.Shared.Contracts.csproj" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="\" />
+    <None Include="buildTransitive\LanMountainDesktop.PluginSdk.props" Pack="true" PackagePath="buildTransitive\" />
+    <None Include="buildTransitive\LanMountainDesktop.PluginSdk.targets" Pack="true" PackagePath="buildTransitive\" />
   </ItemGroup>
 
 </Project>

LanMountainDesktop.PluginSdk/PluginAppearanceContext.cs

@@ -0,0 +1,49 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed class PluginAppearanceContext : IPluginAppearanceContext
+{
+    public PluginAppearanceContext(PluginAppearanceSnapshot snapshot)
+    {
+        ArgumentNullException.ThrowIfNull(snapshot);
+        ArgumentNullException.ThrowIfNull(snapshot.CornerRadiusTokens);
+
+        Snapshot = snapshot with
+        {
+            GlobalCornerRadiusScale = Math.Max(0d, snapshot.GlobalCornerRadiusScale),
+            ThemeVariant = string.IsNullOrWhiteSpace(snapshot.ThemeVariant)
+                ? "Unknown"
+                : snapshot.ThemeVariant.Trim()
+        };
+    }
+
+    public PluginAppearanceSnapshot Snapshot { get; }
+
+    public double ResolveScaledCornerRadius(double baseRadius, double? minimum = null, double? maximum = null)
+    {
+        var scale = Snapshot.GlobalCornerRadiusScale;
+        var scaled = Math.Max(0d, baseRadius) * scale;
+        var scaledMin = minimum.HasValue ? minimum.Value * scale : scaled;
+        var scaledMax = maximum.HasValue ? maximum.Value * scale : scaled;
+        return minimum.HasValue || maximum.HasValue
+            ? Math.Clamp(scaled, scaledMin, scaledMax)
+            : scaled;
+    }
+
+    public double ResolveCornerRadius(PluginCornerRadiusPreset preset, double? minimum = null, double? maximum = null)
+    {
+        var resolved = Math.Max(0d, Snapshot.CornerRadiusTokens.Get(preset));
+        if (!minimum.HasValue && !maximum.HasValue)
+        {
+            return resolved;
+        }
+
+        var clampedMin = minimum ?? resolved;
+        var clampedMax = maximum ?? resolved;
+        if (clampedMin > clampedMax)
+        {
+            (clampedMin, clampedMax) = (clampedMax, clampedMin);
+        }
+
+        return Math.Clamp(resolved, clampedMin, clampedMax);
+    }
+}

LanMountainDesktop.PluginSdk/PluginAppearanceSnapshot.cs

@@ -0,0 +1,6 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed record PluginAppearanceSnapshot(
+    double GlobalCornerRadiusScale,
+    PluginCornerRadiusTokens CornerRadiusTokens,
+    string ThemeVariant);

LanMountainDesktop.PluginSdk/PluginCornerRadiusPreset.cs

@@ -0,0 +1,13 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public enum PluginCornerRadiusPreset
+{
+    Default = 0,
+    Micro = 1,
+    Xs = 2,
+    Sm = 3,
+    Md = 4,
+    Lg = 5,
+    Xl = 6,
+    Island = 7
+}

LanMountainDesktop.PluginSdk/PluginCornerRadiusTokens.cs

@@ -0,0 +1,49 @@
+using Avalonia;
+using LanMountainDesktop.Shared.Contracts;
+
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed record PluginCornerRadiusTokens(
+    double Micro,
+    double Xs,
+    double Sm,
+    double Md,
+    double Lg,
+    double Xl,
+    double Island)
+{
+    public double Get(PluginCornerRadiusPreset preset)
+    {
+        return preset switch
+        {
+            PluginCornerRadiusPreset.Default => Md,
+            PluginCornerRadiusPreset.Micro => Micro,
+            PluginCornerRadiusPreset.Xs => Xs,
+            PluginCornerRadiusPreset.Sm => Sm,
+            PluginCornerRadiusPreset.Md => Md,
+            PluginCornerRadiusPreset.Lg => Lg,
+            PluginCornerRadiusPreset.Xl => Xl,
+            PluginCornerRadiusPreset.Island => Island,
+            _ => Md
+        };
+    }
+
+    public CornerRadius ToCornerRadius(PluginCornerRadiusPreset preset)
+    {
+        return new CornerRadius(Get(preset));
+    }
+
+    public static PluginCornerRadiusTokens FromShared(AppearanceCornerRadiusTokens tokens)
+    {
+        ArgumentNullException.ThrowIfNull(tokens);
+
+        return new PluginCornerRadiusTokens(
+            tokens.Micro.TopLeft,
+            tokens.Xs.TopLeft,
+            tokens.Sm.TopLeft,
+            tokens.Md.TopLeft,
+            tokens.Lg.TopLeft,
+            tokens.Xl.TopLeft,
+            tokens.Island.TopLeft);
+    }
+}

LanMountainDesktop.PluginSdk/PluginDesktopComponentContext.cs

@@ -11,6 +11,7 @@ public sealed class PluginDesktopComponentContext
         string componentId,
         string? placementId,
         double cellSize,
+        IPluginAppearanceContext appearance,
         IPluginSettingsService? pluginSettings = null)
     {
         ArgumentNullException.ThrowIfNull(manifest);
@@ -19,6 +20,7 @@ public sealed class PluginDesktopComponentContext
         ArgumentException.ThrowIfNullOrWhiteSpace(componentId);
         ArgumentNullException.ThrowIfNull(services);
         ArgumentNullException.ThrowIfNull(properties);
+        ArgumentNullException.ThrowIfNull(appearance);
 
         Manifest = manifest;
         PluginDirectory = pluginDirectory;
@@ -28,6 +30,7 @@ public sealed class PluginDesktopComponentContext
         ComponentId = componentId.Trim();
         PlacementId = string.IsNullOrWhiteSpace(placementId) ? null : placementId.Trim();
         CellSize = Math.Max(1, cellSize);
+        Appearance = appearance;
         PluginSettings = pluginSettings;
     }
 
@@ -47,8 +50,24 @@ public sealed class PluginDesktopComponentContext
 
     public double CellSize { get; }
 
+    public IPluginAppearanceContext Appearance { get; }
+
+    public double GlobalCornerRadiusScale => Appearance.Snapshot.GlobalCornerRadiusScale;
+
+    public PluginCornerRadiusTokens CornerRadiusTokens => Appearance.Snapshot.CornerRadiusTokens;
+
     public IPluginSettingsService? PluginSettings { get; }
 
+    public double ResolveScaledCornerRadius(double baseRadius, double? minimum = null, double? maximum = null)
+    {
+        return Appearance.ResolveScaledCornerRadius(baseRadius, minimum, maximum);
+    }
+
+    public double ResolveCornerRadius(PluginCornerRadiusPreset preset, double? minimum = null, double? maximum = null)
+    {
+        return Appearance.ResolveCornerRadius(preset, minimum, maximum);
+    }
+
     public T? GetService<T>()
     {
         return (T?)Services.GetService(typeof(T));

LanMountainDesktop.PluginSdk/PluginDesktopComponentOptions.cs

@@ -0,0 +1,28 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed class PluginDesktopComponentOptions
+{
+    public required string ComponentId { get; init; }
+
+    public required string DisplayName { get; init; }
+
+    public string IconKey { get; init; } = "PuzzlePiece";
+
+    public string Category { get; init; } = "Plugins";
+
+    public int MinWidthCells { get; init; } = 2;
+
+    public int MinHeightCells { get; init; } = 2;
+
+    public bool AllowDesktopPlacement { get; init; } = true;
+
+    public bool AllowStatusBarPlacement { get; init; }
+
+    public PluginDesktopComponentResizeMode ResizeMode { get; init; } = PluginDesktopComponentResizeMode.Proportional;
+
+    public string? DisplayNameLocalizationKey { get; init; }
+
+    public PluginCornerRadiusPreset CornerRadiusPreset { get; init; } = PluginCornerRadiusPreset.Default;
+
+    public Func<IPluginAppearanceContext, double, double>? CornerRadiusResolver { get; init; }
+}

LanMountainDesktop.PluginSdk/PluginDesktopComponentRegistration.cs

@@ -5,67 +5,37 @@ namespace LanMountainDesktop.PluginSdk;
 public sealed class PluginDesktopComponentRegistration
 {
     public PluginDesktopComponentRegistration(
-        string componentId,
-        string displayName,
         Func<IServiceProvider, PluginDesktopComponentContext, Control> controlFactory,
-        string iconKey = "PuzzlePiece",
+        PluginDesktopComponentOptions options)
-        string category = "Plugins",
-        int minWidthCells = 2,
-        int minHeightCells = 2,
-        bool allowDesktopPlacement = true,
-        bool allowStatusBarPlacement = false,
-        PluginDesktopComponentResizeMode resizeMode = PluginDesktopComponentResizeMode.Proportional,
-        string? displayNameLocalizationKey = null,
-        Func<double, double>? cornerRadiusResolver = null)
     {
-        ArgumentException.ThrowIfNullOrWhiteSpace(componentId);
-        ArgumentException.ThrowIfNullOrWhiteSpace(displayName);
-        ArgumentException.ThrowIfNullOrWhiteSpace(iconKey);
-        ArgumentException.ThrowIfNullOrWhiteSpace(category);
         ArgumentNullException.ThrowIfNull(controlFactory);
+        ArgumentNullException.ThrowIfNull(options);
+        ArgumentException.ThrowIfNullOrWhiteSpace(options.ComponentId);
+        ArgumentException.ThrowIfNullOrWhiteSpace(options.DisplayName);
+        ArgumentException.ThrowIfNullOrWhiteSpace(options.IconKey);
+        ArgumentException.ThrowIfNullOrWhiteSpace(options.Category);
 
-        ComponentId = componentId.Trim();
+        ComponentId = options.ComponentId.Trim();
-        DisplayName = displayName.Trim();
+        DisplayName = options.DisplayName.Trim();
-        DisplayNameLocalizationKey = string.IsNullOrWhiteSpace(displayNameLocalizationKey)
+        DisplayNameLocalizationKey = string.IsNullOrWhiteSpace(options.DisplayNameLocalizationKey)
             ? null
-            : displayNameLocalizationKey.Trim();
+            : options.DisplayNameLocalizationKey.Trim();
         ControlFactory = controlFactory;
-        IconKey = iconKey.Trim();
+        IconKey = options.IconKey.Trim();
-        Category = category.Trim();
+        Category = options.Category.Trim();
-        MinWidthCells = Math.Max(1, minWidthCells);
+        MinWidthCells = Math.Max(1, options.MinWidthCells);
-        MinHeightCells = Math.Max(1, minHeightCells);
+        MinHeightCells = Math.Max(1, options.MinHeightCells);
-        AllowDesktopPlacement = allowDesktopPlacement;
+        AllowDesktopPlacement = options.AllowDesktopPlacement;
-        AllowStatusBarPlacement = allowStatusBarPlacement;
+        AllowStatusBarPlacement = options.AllowStatusBarPlacement;
-        ResizeMode = resizeMode;
+        ResizeMode = options.ResizeMode;
-        CornerRadiusResolver = cornerRadiusResolver;
+        CornerRadiusPreset = options.CornerRadiusPreset;
+        CornerRadiusResolver = options.CornerRadiusResolver;
     }
 
     public PluginDesktopComponentRegistration(
-        string componentId,
-        string displayName,
         Func<PluginDesktopComponentContext, Control> controlFactory,
-        string iconKey = "PuzzlePiece",
+        PluginDesktopComponentOptions options)
-        string category = "Plugins",
+        : this((_, context) => controlFactory(context), options)
-        int minWidthCells = 2,
-        int minHeightCells = 2,
-        bool allowDesktopPlacement = true,
-        bool allowStatusBarPlacement = false,
-        PluginDesktopComponentResizeMode resizeMode = PluginDesktopComponentResizeMode.Proportional,
-        string? displayNameLocalizationKey = null,
-        Func<double, double>? cornerRadiusResolver = null)
-        : this(
-            componentId,
-            displayName,
-            (_, context) => controlFactory(context),
-            iconKey,
-            category,
-            minWidthCells,
-            minHeightCells,
-            allowDesktopPlacement,
-            allowStatusBarPlacement,
-            resizeMode,
-            displayNameLocalizationKey,
-            cornerRadiusResolver)
     {
     }
 
@@ -91,5 +61,25 @@ public sealed class PluginDesktopComponentRegistration
 
     public PluginDesktopComponentResizeMode ResizeMode { get; }
 
-    public Func<double, double>? CornerRadiusResolver { get; }
+    public PluginCornerRadiusPreset CornerRadiusPreset { get; }
+
+    public Func<IPluginAppearanceContext, double, double>? CornerRadiusResolver { get; }
+
+    public double ResolveCornerRadius(IPluginAppearanceContext appearance, double cellSize)
+    {
+        ArgumentNullException.ThrowIfNull(appearance);
+
+        var resolved = CornerRadiusResolver is not null
+            ? CornerRadiusResolver(appearance, Math.Max(1d, cellSize))
+            : CornerRadiusPreset == PluginCornerRadiusPreset.Default
+                ? appearance.ResolveScaledCornerRadius(
+                    Math.Clamp(Math.Max(1d, cellSize) * 0.22, 8, 18),
+                    8,
+                    18)
+                : appearance.ResolveCornerRadius(CornerRadiusPreset);
+
+        return double.IsFinite(resolved)
+            ? Math.Max(0d, resolved)
+            : appearance.ResolveCornerRadius(PluginCornerRadiusPreset.Default);
+    }
 }

LanMountainDesktop.PluginSdk/PluginManifest.cs

@@ -87,8 +87,8 @@ public sealed record PluginManifest(
             throw new InvalidOperationException(
                 $"Plugin '{normalized.Id}' targets API version '{normalized.ApiVersion}' (major {requestedVersion.Major}), " +
                 $"but the host provides '{PluginSdkInfo.ApiVersion}' (major {currentVersion.Major}). " +
-                $"This host only supports v{currentVersion.Major}.x plugins. " +
+                $"This host only supports v{currentVersion.Major}.x plugins and rejects v{requestedVersion.Major}.x packages by default. " +
-                $"Migrate the plugin to API {PluginSdkInfo.ApiVersion} and rebuild the package.");
+                $"Migrate the plugin manifest and code to API {PluginSdkInfo.ApiVersion}, then rebuild and republish the package.");
         }
 
         return normalized;

LanMountainDesktop.PluginSdk/PluginSdkInfo.cs

@@ -2,7 +2,7 @@ namespace LanMountainDesktop.PluginSdk;
 
 public static class PluginSdkInfo
 {
-    public const string ApiVersion = "3.0.0";
+    public const string ApiVersion = "4.0.0";
     public const string ManifestFileName = "plugin.json";
     public const string PackageFileExtension = ".laapp";
     public const string DataDirectoryName = "Data";

LanMountainDesktop.PluginSdk/PluginServiceCollectionExtensions.cs

@@ -30,34 +30,15 @@ public static class PluginServiceCollectionExtensions
 
     public static IServiceCollection AddPluginDesktopComponent<TControl>(
         this IServiceCollection services,
-        string componentId,
+        PluginDesktopComponentOptions options)
-        string displayName,
-        string iconKey = "PuzzlePiece",
-        string category = "Plugins",
-        int minWidthCells = 2,
-        int minHeightCells = 2,
-        bool allowDesktopPlacement = true,
-        bool allowStatusBarPlacement = false,
-        PluginDesktopComponentResizeMode resizeMode = PluginDesktopComponentResizeMode.Proportional,
-        string? displayNameLocalizationKey = null,
-        Func<double, double>? cornerRadiusResolver = null)
         where TControl : Control
     {
         ArgumentNullException.ThrowIfNull(services);
+        ArgumentNullException.ThrowIfNull(options);
 
         services.AddSingleton(new PluginDesktopComponentRegistration(
-            componentId,
-            displayName,
             (provider, context) => ActivatorUtilities.CreateInstance<TControl>(provider, context),
-            iconKey,
+            options));
-            category,
-            minWidthCells,
-            minHeightCells,
-            allowDesktopPlacement,
-            allowStatusBarPlacement,
-            resizeMode,
-            displayNameLocalizationKey,
-            cornerRadiusResolver));
         return services;
     }
 

LanMountainDesktop.PluginSdk/README.md

@@ -0,0 +1,21 @@
+# LanMountainDesktop.PluginSdk
+
+Official SDK package for LanMountainDesktop plugins.
+
+## Includes
+
+- `IPlugin`/`PluginBase` entry abstractions
+- `PluginManifest` and shared contract declarations
+- desktop component registration extensions
+- plugin runtime context and host service abstractions
+- build-transitive packaging targets for `.laapp` output
+
+## Quick Start
+
+```xml
+<ItemGroup>
+  <PackageReference Include="LanMountainDesktop.PluginSdk" Version="4.0.0" />
+</ItemGroup>
+```
+
+Create `plugin.json` in your plugin project root, then run `dotnet build` to produce both build output and a `.laapp` package.

LanMountainDesktop.PluginSdk/buildTransitive/LanMountainDesktop.PluginSdk.props

@@ -0,0 +1,14 @@
+<Project>
+  <PropertyGroup>
+    <LanMountainPluginManifestFileName Condition="'$(LanMountainPluginManifestFileName)' == ''">plugin.json</LanMountainPluginManifestFileName>
+    <LanMountainPluginPackageExtension Condition="'$(LanMountainPluginPackageExtension)' == ''">.laapp</LanMountainPluginPackageExtension>
+    <LanMountainPluginPackageOutputDirectory Condition="'$(LanMountainPluginPackageOutputDirectory)' == ''">$(MSBuildProjectDirectory)\</LanMountainPluginPackageOutputDirectory>
+
+    <LanMountainPluginEnablePackaging Condition="'$(LanMountainPluginEnablePackaging)' == '' and Exists('$(MSBuildProjectDirectory)\$(LanMountainPluginManifestFileName)')">true</LanMountainPluginEnablePackaging>
+    <LanMountainPluginEnablePackaging Condition="'$(LanMountainPluginEnablePackaging)' == ''">false</LanMountainPluginEnablePackaging>
+  </PropertyGroup>
+
+  <ItemGroup Condition="Exists('$(MSBuildProjectDirectory)\$(LanMountainPluginManifestFileName)')">
+    <None Update="$(LanMountainPluginManifestFileName)" CopyToOutputDirectory="PreserveNewest" />
+  </ItemGroup>
+</Project>

LanMountainDesktop.PluginSdk/buildTransitive/LanMountainDesktop.PluginSdk.targets

@@ -0,0 +1,51 @@
+<Project>
+  <Target Name="ValidateLanMountainPluginManifest"
+          BeforeTargets="Build"
+          Condition="'$(LanMountainPluginEnablePackaging)' == 'true'">
+    <Error Condition="!Exists('$(MSBuildProjectDirectory)\$(LanMountainPluginManifestFileName)')"
+           Text="LanMountain plugin packaging is enabled, but '$(LanMountainPluginManifestFileName)' was not found in '$(MSBuildProjectDirectory)'." />
+  </Target>
+
+  <Target Name="CreateLanMountainPluginPackage"
+          AfterTargets="Build"
+          Condition="'$(LanMountainPluginEnablePackaging)' == 'true'">
+    <PropertyGroup>
+      <_LanMountainPluginBuildOutputDirectory>$(LanMountainPluginBuildOutputDirectory)</_LanMountainPluginBuildOutputDirectory>
+      <_LanMountainPluginBuildOutputDirectory Condition="'$(_LanMountainPluginBuildOutputDirectory)' == ''">$(TargetDir)</_LanMountainPluginBuildOutputDirectory>
+      <_LanMountainPluginBuildOutputDirectory Condition="'$(_LanMountainPluginBuildOutputDirectory)' == ''">$(MSBuildProjectDirectory)\$(OutputPath)</_LanMountainPluginBuildOutputDirectory>
+      <_LanMountainPluginAssemblyName>$(LanMountainPluginAssemblyName)</_LanMountainPluginAssemblyName>
+      <_LanMountainPluginAssemblyName Condition="'$(_LanMountainPluginAssemblyName)' == '' and '$(AssemblyName)' != ''">$(AssemblyName)</_LanMountainPluginAssemblyName>
+      <_LanMountainPluginAssemblyName Condition="'$(_LanMountainPluginAssemblyName)' == ''">$(MSBuildProjectName)</_LanMountainPluginAssemblyName>
+      <_LanMountainPluginPackageVersion>$(LanMountainPluginPackageVersion)</_LanMountainPluginPackageVersion>
+      <_LanMountainPluginPackageVersion Condition="'$(_LanMountainPluginPackageVersion)' == '' and '$(Version)' != ''">$(Version)</_LanMountainPluginPackageVersion>
+      <_LanMountainPluginPackageVersion Condition="'$(_LanMountainPluginPackageVersion)' == ''">1.0.0</_LanMountainPluginPackageVersion>
+      <_LanMountainPluginPackageOutputDirectory>$(LanMountainPluginPackageOutputDirectory)</_LanMountainPluginPackageOutputDirectory>
+      <_LanMountainPluginPackageOutputDirectory Condition="'$(_LanMountainPluginPackageOutputDirectory)' == ''">$(MSBuildProjectDirectory)\</_LanMountainPluginPackageOutputDirectory>
+      <_LanMountainPluginPackageFileName>$(LanMountainPluginPackageFileName)</_LanMountainPluginPackageFileName>
+      <_LanMountainPluginPackageFileName Condition="'$(_LanMountainPluginPackageFileName)' == ''">$(_LanMountainPluginAssemblyName).$(_LanMountainPluginPackageVersion)$(LanMountainPluginPackageExtension)</_LanMountainPluginPackageFileName>
+      <_LanMountainPluginPackagePath>$(LanMountainPluginPackagePath)</_LanMountainPluginPackagePath>
+      <_LanMountainPluginPackagePath Condition="'$(_LanMountainPluginPackagePath)' == ''">$(_LanMountainPluginPackageOutputDirectory)$(_LanMountainPluginPackageFileName)</_LanMountainPluginPackagePath>
+      <_LanMountainPluginManifestOutputPath>$(_LanMountainPluginBuildOutputDirectory)$(LanMountainPluginManifestFileName)</_LanMountainPluginManifestOutputPath>
+      <_LanMountainPluginDepsPath>$(ProjectDepsFilePath)</_LanMountainPluginDepsPath>
+    </PropertyGroup>
+
+    <Copy SourceFiles="$(MSBuildProjectDirectory)\$(LanMountainPluginManifestFileName)"
+          DestinationFiles="$(_LanMountainPluginManifestOutputPath)"
+          SkipUnchangedFiles="true"
+          Condition="Exists('$(MSBuildProjectDirectory)\$(LanMountainPluginManifestFileName)')" />
+
+    <Error Condition="!Exists('$(_LanMountainPluginManifestOutputPath)')"
+           Text="Plugin manifest '$(_LanMountainPluginManifestOutputPath)' was not found in build output. Ensure '$(LanMountainPluginManifestFileName)' is copied to output." />
+    <Error Condition="!Exists('$(TargetPath)')"
+           Text="Plugin assembly '$(TargetPath)' was not found. Build output is incomplete." />
+    <Error Condition="'$(_LanMountainPluginDepsPath)' != '' and !Exists('$(_LanMountainPluginDepsPath)')"
+           Text="Plugin deps file '$(_LanMountainPluginDepsPath)' was not found. Plugin packages must include a .deps.json file." />
+
+    <MakeDir Directories="$(_LanMountainPluginPackageOutputDirectory)" />
+    <Delete Files="$(_LanMountainPluginPackagePath)" TreatErrorsAsWarnings="true" />
+    <ZipDirectory SourceDirectory="$(_LanMountainPluginBuildOutputDirectory)"
+                  DestinationFile="$(_LanMountainPluginPackagePath)" />
+    <Message Importance="High"
+             Text="LanMountain plugin package generated: $(_LanMountainPluginPackagePath)" />
+  </Target>
+</Project>

LanMountainDesktop.PluginTemplate/LanMountainDesktop.PluginTemplate.csproj

@@ -0,0 +1,25 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <NoWarn>$(NoWarn);NU5128</NoWarn>
+    <EnableDefaultCompileItems>false</EnableDefaultCompileItems>
+    <PackageId>LanMountainDesktop.PluginTemplate</PackageId>
+    <Version>1.0.0</Version>
+    <Authors>LanMountainDesktop</Authors>
+    <Description>Official dotnet new template package for LanMountainDesktop plugins.</Description>
+    <PackageTags>LanMountainDesktop;Plugin;Template;dotnet-new</PackageTags>
+    <PackageType>Template</PackageType>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
+    <RepositoryUrl>https://github.com/wwiinnddyy/LanMountainDesktop</RepositoryUrl>
+    <RepositoryType>git</RepositoryType>
+    <IncludeBuildOutput>false</IncludeBuildOutput>
+    <IsPackable>true</IsPackable>
+    <NoDefaultExcludes>true</NoDefaultExcludes>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <Compile Remove="content\**\*.cs" />
+    <None Include="README.md" Pack="true" PackagePath="\" />
+    <None Include="content\**\*" Pack="true" PackagePath="content\" />
+  </ItemGroup>
+</Project>

LanMountainDesktop.PluginTemplate/README.md

@@ -0,0 +1,17 @@
+# LanMountainDesktop.PluginTemplate
+
+Official `dotnet new` template package for LanMountainDesktop plugins.
+
+## Install
+
+```powershell
+dotnet new install LanMountainDesktop.PluginTemplate
+```
+
+## Create a plugin
+
+```powershell
+dotnet new lmd-plugin -n YourPluginName
+```
+
+The generated project references `LanMountainDesktop.PluginSdk` and produces a `.laapp` package automatically when built.

LanMountainDesktop.PluginTemplate/content/.template.config/template.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "http://json.schemastore.org/template",
+  "author": "LanMountainDesktop",
+  "classifications": [
+    "LanMountainDesktop",
+    "Plugin",
+    "Desktop"
+  ],
+  "name": "LanMountainDesktop Plugin",
+  "identity": "LanMountainDesktop.PluginTemplate.CSharp",
+  "shortName": "lmd-plugin",
+  "sourceName": "LanMountainDesktop.PluginTemplate",
+  "preferNameDirectory": true,
+  "tags": {
+    "type": "project",
+    "language": "C#"
+  },
+  "symbols": {
+    "pluginId": {
+      "type": "parameter",
+      "datatype": "text",
+      "defaultValue": "LanMountainDesktop.PluginTemplate",
+      "description": "Plugin manifest id.",
+      "replaces": "__PLUGIN_ID__"
+    },
+    "pluginAuthor": {
+      "type": "parameter",
+      "datatype": "text",
+      "defaultValue": "Your Name",
+      "description": "Plugin author.",
+      "replaces": "__PLUGIN_AUTHOR__"
+    },
+    "pluginName": {
+      "type": "parameter",
+      "datatype": "text",
+      "defaultValue": "LanMountain Plugin Template",
+      "description": "Display name shown in plugin manifest.",
+      "replaces": "__PLUGIN_NAME__"
+    },
+    "pluginDescription": {
+      "type": "parameter",
+      "datatype": "text",
+      "defaultValue": "Plugin generated from the official LanMountainDesktop template.",
+      "description": "Plugin description shown in plugin manifest.",
+      "replaces": "__PLUGIN_DESCRIPTION__"
+    },
+    "pluginSdkVersion": {
+      "type": "parameter",
+      "datatype": "text",
+      "defaultValue": "4.0.0",
+      "description": "LanMountainDesktop.PluginSdk package version.",
+      "replaces": "__PLUGIN_SDK_VERSION__"
+    }
+  }
+}

LanMountainDesktop.PluginTemplate/content/LanMountainDesktop.PluginTemplate.csproj

@@ -0,0 +1,19 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <Version>1.0.0</Version>
+    <EnableDynamicLoading>true</EnableDynamicLoading>
+    <LanMountainPluginPackageVersion>$(Version)</LanMountainPluginPackageVersion>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="LanMountainDesktop.PluginSdk" Version="__PLUGIN_SDK_VERSION__" ExcludeAssets="runtime" PrivateAssets="all" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <None Update="plugin.json" CopyToOutputDirectory="PreserveNewest" />
+    <None Include="Localization\*.json" CopyToOutputDirectory="PreserveNewest" />
+  </ItemGroup>
+</Project>

LanMountainDesktop.PluginTemplate/content/Localization/en-US.json

@@ -0,0 +1,2 @@
+{
+}

LanMountainDesktop.PluginTemplate/content/Localization/zh-CN.json

@@ -0,0 +1,2 @@
+{
+}

LanMountainDesktop.PluginTemplate/content/Plugin.cs

@@ -0,0 +1,15 @@
+using LanMountainDesktop.PluginSdk;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+
+namespace LanMountainDesktop.PluginTemplate;
+
+[PluginEntrance]
+public sealed class Plugin : PluginBase
+{
+    public override void Initialize(HostBuilderContext context, IServiceCollection services)
+    {
+        _ = context;
+        _ = services;
+    }
+}

LanMountainDesktop.PluginTemplate/content/README.md

@@ -0,0 +1,24 @@
+# __PLUGIN_NAME__
+
+Official-style plugin scaffold generated for LanMountainDesktop.
+
+## Build
+
+```powershell
+dotnet build -c Release
+```
+
+`LanMountainDesktop.PluginSdk` build targets will generate:
+
+- plugin output files under `bin/<Configuration>/<TFM>/`
+- a `.laapp` package in the project root
+
+## Manifest
+
+Update `plugin.json` fields as needed before release:
+
+- `id`
+- `name`
+- `description`
+- `author`
+- `version`

LanMountainDesktop.PluginTemplate/content/plugin.json

@@ -0,0 +1,10 @@
+{
+  "id": "__PLUGIN_ID__",
+  "name": "__PLUGIN_NAME__",
+  "description": "__PLUGIN_DESCRIPTION__",
+  "author": "__PLUGIN_AUTHOR__",
+  "version": "1.0.0",
+  "apiVersion": "4.0.0",
+  "entranceAssembly": "LanMountainDesktop.PluginTemplate.dll",
+  "sharedContracts": []
+}

LanMountainDesktop.Settings.Core/GlobalAppearanceSettings.cs

@@ -0,0 +1,18 @@
+namespace LanMountainDesktop.Settings.Core;
+
+public static class GlobalAppearanceSettings
+{
+    public const double DefaultCornerRadiusScale = 1.0;
+    public const double MinimumCornerRadiusScale = 0.0;
+    public const double MaximumCornerRadiusScale = 2.50;
+
+    public static double NormalizeCornerRadiusScale(double value)
+    {
+        if (double.IsNaN(value) || double.IsInfinity(value))
+        {
+            return DefaultCornerRadiusScale;
+        }
+
+        return Math.Clamp(value, MinimumCornerRadiusScale, MaximumCornerRadiusScale);
+    }
+}

LanMountainDesktop.Settings.Core/LanMountainDesktop.Settings.Core.csproj

@@ -1,15 +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>
+    <ImplicitUsings>enable</ImplicitUsings>
   </PropertyGroup>
-
   <ItemGroup>
-    <ProjectReference Include="..\..\..\LanMountainDesktop.PluginSdk\LanMountainDesktop.PluginSdk.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.PluginSdk\LanMountainDesktop.PluginSdk.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Shared.Contracts\LanMountainDesktop.Shared.Contracts.csproj" />
   </ItemGroup>
-
 </Project>

LanMountainDesktop.Shared.Contracts/AppearanceCornerRadiusTokens.cs

@@ -0,0 +1,12 @@
+using Avalonia;
+
+namespace LanMountainDesktop.Shared.Contracts;
+
+public sealed record AppearanceCornerRadiusTokens(
+    CornerRadius Micro,
+    CornerRadius Xs,
+    CornerRadius Sm,
+    CornerRadius Md,
+    CornerRadius Lg,
+    CornerRadius Xl,
+    CornerRadius Island);

LanMountainDesktop.Shared.Contracts/LanMountainDesktop.Shared.Contracts.csproj

@@ -0,0 +1,22 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Version>1.0.0</Version>
+    <PackageId>LanMountainDesktop.Shared.Contracts</PackageId>
+    <IsPackable>true</IsPackable>
+    <Authors>LanMountainDesktop</Authors>
+    <Description>Shared contracts used by LanMountainDesktop host and plugins for cross-boundary communication.</Description>
+    <PackageTags>LanMountainDesktop;Plugin;SharedContracts;Avalonia</PackageTags>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
+    <RepositoryUrl>https://github.com/wwiinnddyy/LanMountainDesktop</RepositoryUrl>
+    <RepositoryType>git</RepositoryType>
+  </PropertyGroup>
+  <ItemGroup>
+    <PackageReference Include="Avalonia" Version="11.3.12" />
+  </ItemGroup>
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="\" />
+  </ItemGroup>
+</Project>

LanMountainDesktop.Shared.Contracts/README.md

@@ -0,0 +1,16 @@
+# LanMountainDesktop.Shared.Contracts
+
+Shared contracts package for LanMountainDesktop host and plugin ecosystems.
+
+## Includes
+
+- cross-boundary records used by host/runtime and plugins
+- contract types intended for stable shared communication
+
+## Usage
+
+```xml
+<ItemGroup>
+  <PackageReference Include="LanMountainDesktop.Shared.Contracts" Version="1.0.0" />
+</ItemGroup>
+```

LanMountainDesktop.Tests/BuiltInDesktopHostCornerRadiusBaselineTests.cs

@@ -0,0 +1,43 @@
+using System;
+using Avalonia;
+using LanMountainDesktop.Appearance;
+using LanMountainDesktop.ComponentSystem;
+using LanMountainDesktop.Host.Abstractions;
+using LanMountainDesktop.Views.Components;
+using Xunit;
+
+namespace LanMountainDesktop.Tests;
+
+public sealed class BuiltInDesktopHostCornerRadiusBaselineTests
+{
+    [Theory]
+    [InlineData(80d, 0d)]
+    [InlineData(120d, 1d)]
+    [InlineData(160d, 2.5d)]
+    public void BuiltInDesktopHosts_ResolveToTheUnifiedLgBaseline(double cellSize, double globalScale)
+    {
+        var registry = new DesktopComponentRuntimeRegistry(
+            ComponentRegistry.CreateDefault(),
+            DesktopComponentRuntimeRegistry.GetDefaultRegistrations());
+        var expected = AppearanceCornerRadiusTokenFactory.Create(globalScale).Lg.TopLeft;
+
+        foreach (var descriptor in registry.GetDesktopComponents())
+        {
+            var resolved = descriptor.ResolveCornerRadius(CreateChromeContext(descriptor.Definition.Id, cellSize, globalScale));
+            Assert.Equal(expected, resolved, 3);
+        }
+    }
+
+    private static ComponentChromeContext CreateChromeContext(
+        string componentId,
+        double cellSize,
+        double globalScale)
+    {
+        return new ComponentChromeContext(
+            componentId,
+            null,
+            cellSize,
+            globalScale,
+            AppearanceCornerRadiusTokenFactory.Create(globalScale));
+    }
+}

LanMountainDesktop.Tests/CornerRadiusScaleTests.cs

@@ -0,0 +1,91 @@
+using Avalonia;
+using LanMountainDesktop.PluginSdk;
+using LanMountainDesktop.Settings.Core;
+using LanMountainDesktop.Shared.Contracts;
+using Xunit;
+
+namespace LanMountainDesktop.Tests;
+
+public sealed class CornerRadiusScaleTests
+{
+    [Theory]
+    [InlineData(-1d, 0d)]
+    [InlineData(0d, 0d)]
+    [InlineData(0.33d, 0.33d)]
+    [InlineData(1.234d, 1.234d)]
+    [InlineData(2.5d, 2.5d)]
+    [InlineData(3d, 2.5d)]
+    public void NormalizeCornerRadiusScale_ClampsWithoutSnapping(double input, double expected)
+    {
+        Assert.Equal(expected, GlobalAppearanceSettings.NormalizeCornerRadiusScale(input), 3);
+    }
+
+    [Fact]
+    public void NormalizeCornerRadiusScale_UsesDefaultForInvalidValues()
+    {
+        Assert.Equal(
+            GlobalAppearanceSettings.DefaultCornerRadiusScale,
+            GlobalAppearanceSettings.NormalizeCornerRadiusScale(double.NaN),
+            3);
+        Assert.Equal(
+            GlobalAppearanceSettings.DefaultCornerRadiusScale,
+            GlobalAppearanceSettings.NormalizeCornerRadiusScale(double.PositiveInfinity),
+            3);
+    }
+
+    [Fact]
+    public void PluginDesktopComponentContext_AllowsZeroRadiusScaling()
+    {
+        var appearanceContext = new PluginAppearanceContext(new PluginAppearanceSnapshot(
+            GlobalCornerRadiusScale: 0d,
+            CornerRadiusTokens: PluginCornerRadiusTokens.FromShared(new AppearanceCornerRadiusTokens(
+                new CornerRadius(6),
+                new CornerRadius(10),
+                new CornerRadius(14),
+                new CornerRadius(18),
+                new CornerRadius(24),
+                new CornerRadius(30),
+                new CornerRadius(36))),
+            ThemeVariant: "Unknown"));
+
+        var context = new PluginDesktopComponentContext(
+            new PluginManifest("plugin.id", "Plugin Name", "plugin.dll"),
+            "C:\\Plugins\\plugin.id",
+            "C:\\Data\\plugin.id",
+            new NullServiceProvider(),
+            new Dictionary<string, object?>(),
+            "component-1",
+            null,
+            96d,
+            appearanceContext);
+
+        Assert.Equal(0d, context.GlobalCornerRadiusScale, 3);
+        Assert.Equal(0d, context.ResolveScaledCornerRadius(12d), 3);
+        Assert.Equal(0d, context.ResolveScaledCornerRadius(12d, 8d, 18d), 3);
+    }
+
+    [Fact]
+    public void PluginAppearanceContext_ResolveCornerRadius_DoesNotDoubleScalePresetTokens()
+    {
+        var context = new PluginAppearanceContext(new PluginAppearanceSnapshot(
+            GlobalCornerRadiusScale: 2d,
+            CornerRadiusTokens: new PluginCornerRadiusTokens(
+                Micro: 12d,
+                Xs: 20d,
+                Sm: 28d,
+                Md: 36d,
+                Lg: 48d,
+                Xl: 60d,
+                Island: 72d),
+            ThemeVariant: "Light"));
+
+        Assert.Equal(36d, context.ResolveCornerRadius(PluginCornerRadiusPreset.Md), 3);
+        Assert.Equal(36d, context.ResolveCornerRadius(PluginCornerRadiusPreset.Md, maximum: 40d), 3);
+        Assert.Equal(36d, context.ResolveScaledCornerRadius(18d), 3);
+    }
+
+    private sealed class NullServiceProvider : IServiceProvider
+    {
+        public object? GetService(Type serviceType) => null;
+    }
+}

LanMountainDesktop.Tests/DesktopComponentRuntimeRegistrationCornerRadiusTests.cs

@@ -0,0 +1,58 @@
+using Avalonia;
+using Avalonia.Controls;
+using LanMountainDesktop.Host.Abstractions;
+using LanMountainDesktop.Shared.Contracts;
+using LanMountainDesktop.Views.Components;
+using Xunit;
+
+namespace LanMountainDesktop.Tests;
+
+public sealed class DesktopComponentRuntimeRegistrationCornerRadiusTests
+{
+    [Fact]
+    public void LegacyCellSizeResolver_AppliesGlobalCornerRadiusScale()
+    {
+        var registration = new DesktopComponentRuntimeRegistration(
+            componentId: "test.component",
+            displayNameLocalizationKey: null,
+            controlFactory: () => new Border(),
+            cornerRadiusResolver: cellSize => Math.Clamp(cellSize * 0.30, 10, 40));
+
+        var resolver = Assert.IsType<Func<ComponentChromeContext, double>>(registration.CornerRadiusResolver);
+        var resolved = resolver(CreateChromeContext(cellSize: 120, globalScale: 2.0));
+
+        Assert.Equal(72.0, resolved, 3);
+    }
+
+    [Fact]
+    public void ChromeContextResolver_IsNotDoubleScaledByRegistrationWrapper()
+    {
+        var registration = new DesktopComponentRuntimeRegistration(
+            componentId: "test.component",
+            displayNameLocalizationKey: null,
+            controlFactory: _ => new Border(),
+            cornerRadiusResolver: chromeContext => chromeContext.CellSize + chromeContext.GlobalCornerRadiusScale);
+
+        var resolver = Assert.IsType<Func<ComponentChromeContext, double>>(registration.CornerRadiusResolver);
+        var resolved = resolver(CreateChromeContext(cellSize: 50, globalScale: 2.5));
+
+        Assert.Equal(52.5, resolved, 3);
+    }
+
+    private static ComponentChromeContext CreateChromeContext(double cellSize, double globalScale)
+    {
+        return new ComponentChromeContext(
+            ComponentId: "test.component",
+            PlacementId: null,
+            CellSize: cellSize,
+            GlobalCornerRadiusScale: globalScale,
+            CornerRadiusTokens: new AppearanceCornerRadiusTokens(
+                new CornerRadius(6),
+                new CornerRadius(10),
+                new CornerRadius(14),
+                new CornerRadius(18),
+                new CornerRadius(24),
+                new CornerRadius(30),
+                new CornerRadius(36)));
+    }
+}

LanMountainDesktop.Tests/InfoRecommendationHostCornerRadiusTests.cs

@@ -0,0 +1,73 @@
+using System.Collections.Generic;
+using LanMountainDesktop.Appearance;
+using LanMountainDesktop.ComponentSystem;
+using LanMountainDesktop.Host.Abstractions;
+using LanMountainDesktop.Views.Components;
+using Xunit;
+
+namespace LanMountainDesktop.Tests;
+
+public sealed class InfoRecommendationHostCornerRadiusTests
+{
+    private static readonly string[] WideInfoComponentIds =
+    [
+        BuiltInComponentIds.DesktopDailyPoetry,
+        BuiltInComponentIds.DesktopDailyArtwork,
+        BuiltInComponentIds.DesktopDailyWord,
+        BuiltInComponentIds.DesktopCnrDailyNews,
+        BuiltInComponentIds.DesktopIfengNews,
+        BuiltInComponentIds.DesktopBilibiliHotSearch,
+        BuiltInComponentIds.DesktopBaiduHotSearch,
+        BuiltInComponentIds.DesktopStcn24Forum
+    ];
+
+    [Theory]
+    [InlineData(80d)]
+    [InlineData(120d)]
+    [InlineData(160d)]
+    public void InfoHostRegistrations_ResolveToTheUnifiedLgBaseline(double cellSize)
+    {
+        var registry = new DesktopComponentRuntimeRegistry(
+            ComponentRegistry.CreateDefault(),
+            DesktopComponentRuntimeRegistry.GetDefaultRegistrations());
+
+        foreach (var componentId in WideInfoComponentIds)
+        {
+            AssertResolved(registry, componentId, cellSize);
+        }
+
+        AssertResolved(registry, BuiltInComponentIds.DesktopDailyWord2x2, cellSize);
+    }
+
+    private static void AssertResolved(
+        DesktopComponentRuntimeRegistry registry,
+        string componentId,
+        double cellSize)
+    {
+        Assert.True(
+            registry.TryGetDescriptor(componentId, out var descriptor),
+            $"Missing runtime registration for '{componentId}'.");
+
+        var zero = descriptor.ResolveCornerRadius(CreateChromeContext(componentId, cellSize, 0d));
+        var unit = descriptor.ResolveCornerRadius(CreateChromeContext(componentId, cellSize, 1d));
+        var max = descriptor.ResolveCornerRadius(CreateChromeContext(componentId, cellSize, 2.5d));
+
+        Assert.Equal(0d, zero, 3);
+        Assert.Equal(24d, unit, 3);
+        Assert.Equal(60d, max, 3);
+        Assert.True(zero <= unit && unit <= max);
+    }
+
+    private static ComponentChromeContext CreateChromeContext(
+        string componentId,
+        double cellSize,
+        double globalScale)
+    {
+        return new ComponentChromeContext(
+            componentId,
+            null,
+            cellSize,
+            globalScale,
+            AppearanceCornerRadiusTokenFactory.Create(globalScale));
+    }
+}

LanMountainDesktop.Tests/LanMountainDesktop.Tests.csproj

@@ -4,6 +4,7 @@
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
     <IsPackable>false</IsPackable>
+    <Version>1.0.0</Version>
   </PropertyGroup>
 
   <ItemGroup>

LanMountainDesktop.Tests/WhiteboardNotePersistenceServiceTests.cs

@@ -0,0 +1,157 @@
+using System;
+using System.IO;
+using LanMountainDesktop.Models;
+using LanMountainDesktop.Services;
+using Xunit;
+
+namespace LanMountainDesktop.Tests;
+
+public sealed class WhiteboardNotePersistenceServiceTests
+{
+    [Fact]
+    public void SaveNote_ThenLoadNote_RoundTripsSnapshot()
+    {
+        using var sandbox = new WhiteboardNotePersistenceSandbox();
+        var service = sandbox.CreateService();
+        var snapshot = CreateSampleSnapshot();
+
+        service.SaveNote("DesktopWhiteboard", "whiteboard-1", snapshot, retentionDays: 15);
+
+        var loaded = service.LoadNote("DesktopWhiteboard", "whiteboard-1", retentionDays: 15);
+
+        Assert.Single(loaded.Strokes);
+        Assert.Equal(2, loaded.Strokes[0].Points.Count);
+        Assert.Equal("#FF112233", loaded.Strokes[0].Color);
+        Assert.True(loaded.SavedUtc > DateTimeOffset.MinValue);
+    }
+
+    [Fact]
+    public void LoadNote_RemovesExpiredSnapshot_WhenRetentionExceeded()
+    {
+        using var sandbox = new WhiteboardNotePersistenceSandbox();
+        var service = sandbox.CreateService();
+
+        service.SaveNote("DesktopWhiteboard", "expired-board", CreateSampleSnapshot(), retentionDays: 7);
+        sandbox.OverrideSavedTimestamp("DesktopWhiteboard", "expired-board", DateTimeOffset.UtcNow.AddDays(-10), retentionDays: 7);
+
+        var loaded = service.LoadNote("DesktopWhiteboard", "expired-board", retentionDays: 7);
+
+        Assert.Empty(loaded.Strokes);
+        Assert.False(sandbox.Exists("DesktopWhiteboard", "expired-board"));
+    }
+
+    [Fact]
+    public void DeleteExpiredNotesBatch_RemovesExpiredRows_AndKeepsFreshRows()
+    {
+        using var sandbox = new WhiteboardNotePersistenceSandbox();
+        var service = sandbox.CreateService();
+
+        service.SaveNote("DesktopWhiteboard", "expired-a", CreateSampleSnapshot(), retentionDays: 7);
+        service.SaveNote("DesktopWhiteboard", "expired-b", CreateSampleSnapshot(), retentionDays: 7);
+        service.SaveNote("DesktopWhiteboard", "fresh-c", CreateSampleSnapshot(), retentionDays: 15);
+
+        sandbox.OverrideSavedTimestamp("DesktopWhiteboard", "expired-a", DateTimeOffset.UtcNow.AddDays(-9), retentionDays: 7);
+        sandbox.OverrideSavedTimestamp("DesktopWhiteboard", "expired-b", DateTimeOffset.UtcNow.AddDays(-8), retentionDays: 7);
+        sandbox.OverrideSavedTimestamp("DesktopWhiteboard", "fresh-c", DateTimeOffset.UtcNow.AddDays(-2), retentionDays: 15);
+
+        var deletedCount = service.DeleteExpiredNotesBatch(batchSize: 10);
+
+        Assert.Equal(2, deletedCount);
+        Assert.False(sandbox.Exists("DesktopWhiteboard", "expired-a"));
+        Assert.False(sandbox.Exists("DesktopWhiteboard", "expired-b"));
+        Assert.True(sandbox.Exists("DesktopWhiteboard", "fresh-c"));
+    }
+
+    private static WhiteboardNoteSnapshot CreateSampleSnapshot()
+    {
+        return new WhiteboardNoteSnapshot
+        {
+            Strokes =
+            [
+                new WhiteboardStrokeSnapshot
+                {
+                    Color = "#FF112233",
+                    InkThickness = 3.5d,
+                    IgnorePressure = true,
+                    Points =
+                    [
+                        new WhiteboardStylusPointSnapshot { X = 12, Y = 34, Pressure = 0.4d, Width = 2, Height = 2 },
+                        new WhiteboardStylusPointSnapshot { X = 48, Y = 64, Pressure = 0.7d, Width = 2, Height = 2 }
+                    ]
+                }
+            ]
+        };
+    }
+
+    private sealed class WhiteboardNotePersistenceSandbox : IDisposable
+    {
+        private readonly string _directoryPath = Path.Combine(
+            Path.GetTempPath(),
+            "LanMountainDesktop.WhiteboardNoteTests",
+            Guid.NewGuid().ToString("N"));
+
+        private readonly string _databasePath;
+
+        public WhiteboardNotePersistenceSandbox()
+        {
+            Directory.CreateDirectory(_directoryPath);
+            _databasePath = Path.Combine(_directoryPath, "whiteboard-tests.db");
+        }
+
+        public WhiteboardNotePersistenceService CreateService()
+        {
+            return new WhiteboardNotePersistenceService(new AppDatabaseService(_databasePath));
+        }
+
+        public void OverrideSavedTimestamp(string componentId, string placementId, DateTimeOffset savedUtc, int retentionDays)
+        {
+            var expiresUtc = savedUtc.AddDays(WhiteboardNoteRetentionPolicy.NormalizeDays(retentionDays));
+            using var connection = new AppDatabaseService(_databasePath).OpenConnection();
+            using var command = connection.CreateCommand();
+            command.CommandText = """
+                UPDATE whiteboard_notes
+                SET saved_at_utc_ms = $savedAtUtcMs,
+                    expires_at_utc_ms = $expiresAtUtcMs,
+                    updated_at_utc_ms = $updatedAtUtcMs
+                WHERE component_id = $componentId
+                  AND placement_id = $placementId;
+                """;
+            command.Parameters.AddWithValue("$savedAtUtcMs", savedUtc.ToUnixTimeMilliseconds());
+            command.Parameters.AddWithValue("$expiresAtUtcMs", expiresUtc.ToUnixTimeMilliseconds());
+            command.Parameters.AddWithValue("$updatedAtUtcMs", DateTimeOffset.UtcNow.ToUnixTimeMilliseconds());
+            command.Parameters.AddWithValue("$componentId", componentId);
+            command.Parameters.AddWithValue("$placementId", placementId);
+            command.ExecuteNonQuery();
+        }
+
+        public bool Exists(string componentId, string placementId)
+        {
+            using var connection = new AppDatabaseService(_databasePath).OpenConnection();
+            using var command = connection.CreateCommand();
+            command.CommandText = """
+                SELECT COUNT(1)
+                FROM whiteboard_notes
+                WHERE component_id = $componentId
+                  AND placement_id = $placementId;
+                """;
+            command.Parameters.AddWithValue("$componentId", componentId);
+            command.Parameters.AddWithValue("$placementId", placementId);
+            return Convert.ToInt32(command.ExecuteScalar()) > 0;
+        }
+
+        public void Dispose()
+        {
+            try
+            {
+                if (Directory.Exists(_directoryPath))
+                {
+                    Directory.Delete(_directoryPath, true);
+                }
+            }
+            catch
+            {
+                // Temporary test directories are best-effort cleanup.
+            }
+        }
+    }
+}

LanMountainDesktop.slnx

@@ -1,6 +1,12 @@
 <Solution>
-  <Project Path="LanAirApp/tools/LanMountainDesktop.PluginPackager/LanMountainDesktop.PluginPackager.csproj" />
+  <Project Path="LanMountainDesktop.Host.Abstractions/LanMountainDesktop.Host.Abstractions.csproj" />
+  <Project Path="LanMountainDesktop.Shared.Contracts/LanMountainDesktop.Shared.Contracts.csproj" />
+  <Project Path="LanMountainDesktop.Settings.Core/LanMountainDesktop.Settings.Core.csproj" />
+  <Project Path="LanMountainDesktop.Appearance/LanMountainDesktop.Appearance.csproj" />
+  <Project Path="LanMountainDesktop.DesktopComponents.Runtime/LanMountainDesktop.DesktopComponents.Runtime.csproj" />
+  <Project Path="LanMountainDesktop.DesktopHost/LanMountainDesktop.DesktopHost.csproj" />
   <Project Path="LanMountainDesktop.PluginSdk/LanMountainDesktop.PluginSdk.csproj" />
+  <Project Path="LanMountainDesktop.PluginTemplate/LanMountainDesktop.PluginTemplate.csproj" />
   <Project Path="LanMountainDesktop.PluginsInstallHelper/LanMountainDesktop.PluginsInstallHelper.csproj" />
   <Project Path="LanMountainDesktop/LanMountainDesktop.csproj" />
   <Project Path="LanMountainDesktop.Tests/LanMountainDesktop.Tests.csproj" />

LanMountainDesktop/App.axaml

@@ -71,4 +71,5 @@
             <Setter Property="VerticalAlignment" Value="Center" />
         </Style>
     </Application.Styles>
+
 </Application>

LanMountainDesktop/App.axaml.cs

@@ -15,6 +15,7 @@ using Avalonia.Styling;
 using Avalonia.Threading;
 using AvaloniaWebView;
 using LanMountainDesktop.ComponentSystem;
+using LanMountainDesktop.DesktopHost;
 using LanMountainDesktop.Models;
 using LanMountainDesktop.PluginSdk;
 using LanMountainDesktop.Services;
@@ -56,17 +57,31 @@ public partial class App : Application
     private DesktopShellState _desktopShellState = DesktopShellState.ForegroundDesktop;
     private ShutdownIntent _shutdownIntent;
 
-    private TrayIcons? _trayIcons;
+    private TrayIcon? _trayIcon;
+    private NativeMenuItem? _trayShowDesktopMenuItem;
+    private NativeMenuItem? _traySettingsMenuItem;
+    private NativeMenuItem? _trayComponentLibraryMenuItem;
+    private NativeMenuItem? _trayRestartMenuItem;
+    private NativeMenuItem? _trayExitMenuItem;
     private PluginRuntimeService? _pluginRuntimeService;
     private MainWindow? _mainWindow;
     private bool _mainWindowClosed;
     private bool _uiUnhandledExceptionHooked;
+    private DesktopShellHost? _desktopShellHost;
 
     internal static SingleInstanceService? CurrentSingleInstanceService { get; set; }
-    internal static (UserBehaviorAnalyticsService?, CrashReportService?) AnalyticsServices { get; set; }
     internal static IHostApplicationLifecycle? CurrentHostApplicationLifecycle =>
         (Current as App)?._hostApplicationLifecycle;
 
+    // 隐私政策查看事件
+    public static event Action? CurrentPrivacyPolicyViewRequested;
+
+    // 触发隐私政策查看事件的方法
+    public static void RaisePrivacyPolicyViewRequested()
+    {
+        CurrentPrivacyPolicyViewRequested?.Invoke();
+    }
+
     public PluginRuntimeService? PluginRuntimeService => _pluginRuntimeService;
     public ISettingsFacadeService SettingsFacade => _settingsFacade;
     public IHostApplicationLifecycle HostApplicationLifecycle => _hostApplicationLifecycle;
@@ -107,28 +122,32 @@ public partial class App : Application
         AppLogger.Info("App", "Framework initialization completed.");
         RegisterUiUnhandledExceptionGuard();
         LinuxDesktopEntryInstaller.EnsureInstalled();
-        InitializePluginRuntime();
+        DesktopBootstrap.InitializeApplication(this, InitializeDesktopShell);
-        InitializeTrayIcon();
 
-        if (ApplicationLifetime is IClassicDesktopStyleApplicationLifetime desktop)
+        base.OnFrameworkInitializationCompleted();
-        {
+    }
-            // Avoid duplicate validations from both Avalonia and the CommunityToolkit.
+
-            // More info: https://docs.avaloniaui.net/docs/guides/development-guides/data-validation#manage-validationplugins
+    private void InitializeDesktopShell()
-            DisableAvaloniaDataAnnotationValidation();
+    {
-            desktop.ShutdownMode = Avalonia.Controls.ShutdownMode.OnExplicitShutdown;
+        _desktopShellHost ??= new DesktopShellHost(
-            desktop.Exit += (_, _) =>
+            InitializePluginRuntime,
+            InitializeTrayIcon,
+            desktop =>
+            {
+                // Avoid duplicate validations from both Avalonia and the CommunityToolkit.
+                // More info: https://docs.avaloniaui.net/docs/guides/development-guides/data-validation#manage-validationplugins
+                DisableAvaloniaDataAnnotationValidation();
+                desktop.ShutdownMode = Avalonia.Controls.ShutdownMode.OnExplicitShutdown;
+                CreateAndAssignMainWindow(desktop, "FrameworkInitialization");
+            },
+            () =>
             {
                 AppLogger.Info("App", "Desktop lifetime exit triggered.");
                 PerformExitCleanup();
-            };
+            },
-
+            () => CurrentSingleInstanceService?.StartActivationListener(ActivateMainWindow),
-            CreateAndAssignMainWindow(desktop, "FrameworkInitialization");
+            StartWeatherLocationRefreshIfNeeded);
-            CurrentSingleInstanceService?.StartActivationListener(ActivateMainWindow);
+        _desktopShellHost.Initialize(this);
-        }
-
-        StartWeatherLocationRefreshIfNeeded();
-
-        base.OnFrameworkInitializationCompleted();
     }
 
     private void OnTrayExitClick(object? sender, EventArgs e)
@@ -229,18 +248,43 @@ public partial class App : Application
     {
         try
         {
-            DisposeTrayIcon();
+            if (_trayIcon is null)
-
-            var trayIcon = new TrayIcon
             {
-                Icon = _appLogoService.CreateTrayIcon(),
+                _trayShowDesktopMenuItem = new NativeMenuItem();
-                ToolTipText = L("tray.tooltip", "LanMountainDesktop"),
+                _trayShowDesktopMenuItem.Click += OnTrayShowDesktopClick;
-                Menu = BuildTrayMenu(),
-                IsVisible = true
-            };
 
-            _trayIcons = [trayIcon];
+                _traySettingsMenuItem = new NativeMenuItem();
-            TrayIcon.SetIcons(this, _trayIcons);
+                _traySettingsMenuItem.Click += OnTraySettingsClick;
+
+                _trayComponentLibraryMenuItem = new NativeMenuItem();
+                _trayComponentLibraryMenuItem.Click += OnTrayComponentLibraryClick;
+
+                _trayRestartMenuItem = new NativeMenuItem();
+                _trayRestartMenuItem.Click += OnTrayRestartClick;
+
+                _trayExitMenuItem = new NativeMenuItem();
+                _trayExitMenuItem.Click += OnTrayExitClick;
+
+                var trayMenu = new NativeMenu();
+                trayMenu.Items.Add(_trayShowDesktopMenuItem);
+                trayMenu.Items.Add(_traySettingsMenuItem);
+                trayMenu.Items.Add(_trayComponentLibraryMenuItem);
+                trayMenu.Items.Add(new NativeMenuItemSeparator());
+                trayMenu.Items.Add(_trayRestartMenuItem);
+                trayMenu.Items.Add(new NativeMenuItemSeparator());
+                trayMenu.Items.Add(_trayExitMenuItem);
+
+                _trayIcon = new TrayIcon
+                {
+                    Icon = _appLogoService.CreateTrayIcon(),
+                    Menu = trayMenu,
+                    IsVisible = true
+                };
+
+                TrayIcon.SetIcons(this, [_trayIcon]);
+            }
+
+            RefreshTrayIconContent();
         }
         catch (Exception ex)
         {
@@ -248,51 +292,58 @@ public partial class App : Application
         }
     }
 
-    private NativeMenu BuildTrayMenu()
+    private void RefreshTrayIconContent()
     {
-        var menu = new NativeMenu();
+        if (_trayIcon is not null)
+        {
+            _trayIcon.IsVisible = true;
+            if (!OperatingSystem.IsLinux())
+            {
+                _trayIcon.ToolTipText = L("tray.tooltip", "LanMountainDesktop");
+            }
+        }
 
-        var showDesktopItem = new NativeMenuItem(L("tray.menu.show_desktop", "Open Desktop"));
+        if (_trayShowDesktopMenuItem is not null)
-        showDesktopItem.Click += OnTrayShowDesktopClick;
+        {
-        menu.Items.Add(showDesktopItem);
+            _trayShowDesktopMenuItem.Header = L("tray.menu.show_desktop", "Open Desktop");
+        }
 
-        var settingsItem = new NativeMenuItem(L("tray.menu.settings", "Settings"));
+        if (_traySettingsMenuItem is not null)
-        settingsItem.Click += OnTraySettingsClick;
+        {
-        menu.Items.Add(settingsItem);
+            _traySettingsMenuItem.Header = L("tray.menu.settings", "Settings");
+        }
 
-        var componentLibraryItem = new NativeMenuItem(L("tray.menu.component_library", "Component Library"));
+        if (_trayComponentLibraryMenuItem is not null)
-        componentLibraryItem.Click += OnTrayComponentLibraryClick;
+        {
-        menu.Items.Add(componentLibraryItem);
+            _trayComponentLibraryMenuItem.Header = L("tray.menu.component_library", "Component Library");
+        }
 
-        menu.Items.Add(new NativeMenuItemSeparator());
+        if (_trayRestartMenuItem is not null)
+        {
+            _trayRestartMenuItem.Header = L("tray.menu.restart", "Restart App");
+        }
 
-        var restartItem = new NativeMenuItem(L("tray.menu.restart", "Restart App"));
+        if (_trayExitMenuItem is not null)
-        restartItem.Click += OnTrayRestartClick;
+        {
-        menu.Items.Add(restartItem);
+            _trayExitMenuItem.Header = L("tray.menu.exit", "Exit App");
-
+        }
-        menu.Items.Add(new NativeMenuItemSeparator());
-
-        var exitItem = new NativeMenuItem(L("tray.menu.exit", "Exit App"));
-        exitItem.Click += OnTrayExitClick;
-        menu.Items.Add(exitItem);
-
-        return menu;
     }
 
     private void DisposeTrayIcon()
     {
-        if (_trayIcons is null)
+        if (_trayIcon is null)
         {
             return;
         }
 
-        TrayIcon.SetIcons(this, null);
+        try
-        foreach (var trayIcon in _trayIcons)
         {
-            trayIcon.Dispose();
+            _trayIcon.IsVisible = false;
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("TrayIcon", "Failed to hide tray icon during cleanup.", ex);
         }
-
-        _trayIcons = null;
     }
 
     private void EnsureSettingsWindowService()
@@ -484,6 +535,7 @@ public partial class App : Application
                 refreshAll ||
                 changedKeys.Contains(nameof(AppSettingsSnapshot.IsNightMode), StringComparer.OrdinalIgnoreCase) ||
                 changedKeys.Contains(nameof(AppSettingsSnapshot.UseSystemChrome), StringComparer.OrdinalIgnoreCase) ||
+                changedKeys.Contains(nameof(AppSettingsSnapshot.GlobalCornerRadiusScale), StringComparer.OrdinalIgnoreCase) ||
                 (string.Equals(liveAppearance.ThemeColorMode, ThemeAppearanceValues.ColorModeSeedMonet, StringComparison.OrdinalIgnoreCase) &&
                  changedKeys.Contains(nameof(AppSettingsSnapshot.ThemeColor), StringComparer.OrdinalIgnoreCase)) ||
                 (string.Equals(liveAppearance.ThemeColorMode, ThemeAppearanceValues.ColorModeWallpaperMonet, StringComparison.OrdinalIgnoreCase) &&
@@ -501,11 +553,10 @@ public partial class App : Application
 
             if (languageChanged)
             {
+                // 清除本地化缓存，强制重新加载语言文件
+                _localizationService.ClearCache();
                 ApplyCurrentCultureFromSettings();
-                if (_trayIcons is not null)
+                RefreshTrayIconContent();
-                {
-                    InitializeTrayIcon();
-                }
             }
         }, DispatcherPriority.Background);
     }
@@ -573,13 +624,13 @@ public partial class App : Application
 
         try
         {
-            var (analytics, crashReport) = App.AnalyticsServices;
+            TelemetryServices.Usage?.Shutdown(
-            analytics?.SendShutdownEvent();
+                _shutdownIntent == ShutdownIntent.RestartRequested,
-            crashReport?.SendShutdownEvent();
+                "App.PerformExitCleanup");
         }
         catch (Exception ex)
         {
-            AppLogger.Warn("Analytics", "Failed to send shutdown events during exit cleanup.", ex);
+            AppLogger.Warn("Analytics", "Failed to shut down usage telemetry during exit cleanup.", ex);
         }
 
         try
@@ -613,6 +664,27 @@ public partial class App : Application
         AudioRecorderServiceFactory.DisposeSharedServices();
         StudyAnalyticsServiceFactory.DisposeSharedService();
         DisposeTrayIcon();
+
+        try
+        {
+            TelemetryServices.Crash?.CaptureShutdown(
+                _shutdownIntent == ShutdownIntent.RestartRequested,
+                "App.PerformExitCleanup");
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("Analytics", "Failed to capture crash shutdown telemetry during exit cleanup.", ex);
+        }
+
+        try
+        {
+            TelemetryServices.Crash?.Dispose();
+            TelemetryServices.Usage?.Dispose();
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("Analytics", "Failed to dispose telemetry services during exit cleanup.", ex);
+        }
     }
 
     private MainWindow CreateAndAssignMainWindow(

LanMountainDesktop/Assets/Documents/Privacy.md

@@ -0,0 +1,54 @@
+# 隐私与遥测说明
+
+LanMountainDesktop 提供两类可选遥测能力：
+
+- 崩溃数据上传
+- 行为数据分析
+
+这两个开关默认关闭。即使两项都关闭，应用仍会在首次启动时向 PostHog 发送一次最小化的启动基线事件，用于统计用户量。
+
+## 默认行为
+
+当“崩溃数据上传”和“行为数据分析”都关闭时：
+
+- 仅首次启动会发送一次 `app_first_launch` 事件
+- 该事件只用于统计用户量
+- 事件时间由 PostHog 接入侧记录的请求时间和启动时间决定
+- 不会主动上传设备型号、操作系统细节、组件操作轨迹等详细信息
+
+## 崩溃数据上传
+
+当开启“崩溃数据上传”时，应用会把崩溃与未处理异常发送到 Sentry，用于分析稳定性问题。
+
+上报内容可能包括：
+
+- 异常堆栈和错误上下文
+- 应用版本与运行环境
+- 操作系统信息
+- 设备基础信息
+- 最近的日志尾部内容
+
+应用退出或崩溃时，会尽量补充最后一次会话和日志信息，方便定位问题。
+
+## 行为数据分析
+
+当开启“行为数据分析”时，应用会把关键行为事件发送到 PostHog，用于分析功能使用情况和会话路径。
+
+上报内容可能包括：
+
+- 应用启动和退出时间
+- 会话开始与结束时间
+- 设置页打开、关闭和导航
+- 抽屉打开和关闭
+- 桌面组件的放置、移动、缩放、删除和编辑入口
+
+这些事件会被转换成 PostHog 可以直接接收和分析的事件格式，方便在 PostHog 中按事件流查看用户行为。桌面端的“回放”能力通过事件时间线重建，而不是浏览器式 Session Replay。
+
+## 身份与隐私控制
+
+应用会使用随机生成的匿名 install ID 和可刷新 telemetry ID 来区分安装与运行会话。
+
+- 刷新 telemetry ID 只会影响后续详细遥测
+- 关闭开关后，不会继续发送对应类别的详细遥测
+- IP 只会通过 Sentry / PostHog 的服务端接入侧自然记录，不会作为自定义字段重复上报
+

LanMountainDesktop/ComponentSystem/BuiltInComponentIds.cs

@@ -41,4 +41,5 @@ public static class BuiltInComponentIds
     public const string DesktopBlackboardLandscape = "DesktopBlackboardLandscape";
     public const string DesktopBrowser = "DesktopBrowser";
     public const string DesktopOfficeRecentDocuments = "DesktopOfficeRecentDocuments";
+    public const string DesktopRemovableStorage = "DesktopRemovableStorage";
 }

LanMountainDesktop/ComponentSystem/ComponentRegistry.cs

@@ -336,6 +336,15 @@ public sealed class ComponentRegistry
                 MinHeightCells: 2,
                 AllowStatusBarPlacement: false,
                 AllowDesktopPlacement: true),
+            new DesktopComponentDefinition(
+                BuiltInComponentIds.DesktopRemovableStorage,
+                "Removable Storage",
+                "Storage",
+                "File",
+                MinWidthCells: 2,
+                MinHeightCells: 2,
+                AllowStatusBarPlacement: false,
+                AllowDesktopPlacement: true),
             new DesktopComponentDefinition(
                 BuiltInComponentIds.Date,
                 "Calendar",

LanMountainDesktop/ComponentSystem/DesktopComponentRuntimeContext.cs

@@ -1,3 +1,4 @@
+using LanMountainDesktop.Host.Abstractions;
 using LanMountainDesktop.PluginSdk;
 using LanMountainDesktop.Services;
 using LanMountainDesktop.Services.Settings;
@@ -10,5 +11,6 @@ public sealed record DesktopComponentRuntimeContext(
     ISettingsFacadeService SettingsFacade,
     ISettingsService SettingsService,
     IAppearanceThemeService AppearanceTheme,
+    ComponentChromeContext Chrome,
     IComponentSettingsAccessor ComponentSettingsAccessor,
     IComponentInstanceSettingsStore ComponentSettingsStore);

LanMountainDesktop/ComponentSystem/IComponentChromeContextAware.cs

@@ -0,0 +1,8 @@
+using LanMountainDesktop.Host.Abstractions;
+
+namespace LanMountainDesktop.ComponentSystem;
+
+public interface IComponentChromeContextAware
+{
+    void SetComponentChromeContext(ComponentChromeContext context);
+}

LanMountainDesktop/LanMountainDesktop.csproj

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
     <OutputType>WinExe</OutputType>
     <TargetFramework>net10.0</TargetFramework>
@@ -21,11 +21,20 @@
   <ItemGroup>
     <Folder Include="Models\" />
     <AvaloniaResource Include="Assets\**" />
+    <AvaloniaResource Include="Localization\**" />
+    <EmbeddedResource Include="Assets\Documents\Privacy.md" />
+    <EmbeddedResource Include="Localization\*.json" />
     <None Include="Localization\*.json" CopyToOutputDirectory="PreserveNewest" />
     <None Include="Extensions\Components\*.json" CopyToOutputDirectory="PreserveNewest" />
   </ItemGroup>
 
   <ItemGroup>
+    <ProjectReference Include="..\LanMountainDesktop.Host.Abstractions\LanMountainDesktop.Host.Abstractions.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Shared.Contracts\LanMountainDesktop.Shared.Contracts.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Settings.Core\LanMountainDesktop.Settings.Core.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Appearance\LanMountainDesktop.Appearance.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.DesktopComponents.Runtime\LanMountainDesktop.DesktopComponents.Runtime.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.DesktopHost\LanMountainDesktop.DesktopHost.csproj" />
     <ProjectReference Include="..\LanMountainDesktop.PluginSdk\LanMountainDesktop.PluginSdk.csproj" />
     <ProjectReference Include="..\LanMountainDesktop.PluginsInstallHelper\LanMountainDesktop.PluginsInstallHelper.csproj" ReferenceOutputAssembly="false" />
   </ItemGroup>
@@ -52,15 +61,18 @@
     <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="10.0.0" />
     <PackageReference Include="Microsoft.Extensions.Hosting.Abstractions" Version="10.0.0" />
     <PackageReference Include="Microsoft.Data.Sqlite" Version="10.0.0" />
-    <PackageReference Include="LibVLCSharp.Avalonia" Version="3.9.5" />
+    <PackageReference Include="MudTools.OfficeInterop" Version="2.0.8" />
+    <PackageReference Include="MudTools.OfficeInterop.Word" Version="2.0.8" />
+    <PackageReference Include="MudTools.OfficeInterop.Excel" Version="2.0.8" />
+    <PackageReference Include="MudTools.OfficeInterop.PowerPoint" Version="2.0.8" />
+
     <PackageReference Include="PortAudioSharp2" Version="1.0.6" />
     <PackageReference Include="MaterialColorUtilities" Version="0.3.0" />
     <PackageReference Include="PostHog" Version="2.4.0" />
     <PackageReference Include="Sentry" Version="4.0.0" />
     <PackageReference Include="System.Runtime.WindowsRuntime" Version="4.7.0" />
     <PackageReference Include="System.Drawing.Common" Version="10.0.0" />
-    <PackageReference Include="VideoLAN.LibVLC.Windows" Version="3.0.23" Condition="('$(RuntimeIdentifier)' == '' and $([MSBuild]::IsOSPlatform('Windows')))&#xA;                              or '$(RuntimeIdentifier)' == 'win-x64'&#xA;                              or '$(RuntimeIdentifier)' == 'win-x86'" />
+
-    <PackageReference Include="VideoLAN.LibVLC.Mac" Version="3.1.3.1" Condition="('$(RuntimeIdentifier)' == '' and $([MSBuild]::IsOSPlatform('OSX')))&#xA;                              or '$(RuntimeIdentifier)' == 'osx-x64'" />
     <PackageReference Include="WebView.Avalonia" Version="11.0.0.1" />
     <PackageReference Include="WebView.Avalonia.Desktop" Version="11.0.0.1" />
     <PackageReference Include="YamlDotNet" Version="16.3.0" />

LanMountainDesktop/Localization/en-US.json

@@ -7,7 +7,12 @@
     "tray.menu.restart":  "Restart App",
     "tray.menu.exit":  "Exit App",
     "button.back_to_windows":  "Back to Windows",
+    "button.back_to_platform": "Back to {0}",
     "tooltip.back_to_windows":  "Back to Windows",
+    "tooltip.back_to_platform": "Back to {0}",
+    "platform.windows": "Windows",
+    "platform.linux": "Linux",
+    "platform.macos": "macOS",
     "tooltip.open_settings":  "Settings",
     "settings.title":  "Settings",
     "settings.shell.title":  "Settings",
@@ -20,7 +25,7 @@
     "settings.nav.group_system":  "System",
     "settings.nav.group_extensions":  "Extensions",
     "settings.nav.wallpaper":  "Wallpaper",
-    "settings.nav.grid":  "Grid",
+    "settings.nav.grid":  "Components",
     "settings.nav.color":  "Color",
     "settings.nav.status_bar":  "Status Bar",
     "settings.nav.weather":  "Weather",
@@ -86,6 +91,8 @@
     "settings.status_bar.description":  "Choose which components appear on the top status bar.",
     "settings.status_bar.clock_header":  "Clock Component",
     "settings.status_bar.clock_description":  "Display a clock on the top status bar.",
+    "settings.status_bar.clock_transparent_background_label":  "Transparent background",
+    "settings.status_bar.clock_transparent_background_desc":  "Remove the capsule background and keep only the clock text.",
     "settings.status_bar.spacing_header":  "Component Spacing",
     "settings.status_bar.spacing_desc":  "Adjust spacing between status bar components.",
     "settings.status_bar.spacing_mode_compact":  "Compact",
@@ -99,6 +106,11 @@
     "settings.privacy.crash_upload_description":  "Help us improve application stability.",
     "settings.privacy.usage_upload_title":  "Anonymous usage data uploads",
     "settings.privacy.usage_upload_description":  "Help us improve application features.",
+    "settings.privacy.device_id_title":  "Device ID",
+    "settings.privacy.device_id_description":  "Unique identifier for this device. Click refresh to regenerate.",
+    "settings.privacy.refresh_device_id":  "Refresh",
+    "settings.privacy.policy_hint_prefix":  "For more details, please ",
+    "settings.privacy.view_policy":  "view our privacy policy",
     "settings.weather.title":  "Weather",
     "settings.weather.description":  "Configure weather location, Xiaomi weather preview, and startup positioning behavior.",
     "settings.weather.location_source_header":  "Location Source",
@@ -291,8 +303,17 @@
     "settings.status_bar.clock_format.hm":  "Hour:Minute",
     "settings.status_bar.clock_format.hms":  "Hour:Minute:Second",
     "settings.components.title":  "Components",
-    "settings.components.description":  "Adjust desktop grid density and widget placement.",
+    "settings.components.description":  "Adjust component layout and corner design.",
-    "settings.components.grid_header":  "Grid Layout",
+    "settings.components.grid_header":  "Grid Settings",
+    "settings.components.header":  "Grid Settings",
+    "settings.components.short_side_label":  "Short Side Cells",
+    "settings.components.edge_inset_label":  "Screen Inset",
+    "settings.components.spacing_label":  "Component Spacing",
+    "settings.components.spacing_compact":  "Compact",
+    "settings.components.spacing_relaxed":  "Relaxed",
+    "settings.components.corner_radius.header":  "Corner Design",
+    "settings.components.corner_radius.label":  "Component Corner Radius",
+    "settings.components.corner_radius.description":  "Adjust the shared corner radius from a square edge to a capsule-like shape, and expand the internal safe area with it.",
     "settings.update.title":  "Update",
     "settings.update.current_version_label":  "Current Version",
     "settings.update.latest_version_label":  "Latest Release",
@@ -398,6 +419,7 @@
     "common.monet":  "Monet",
     "desktop.page_index_format":  "Desktop {0}",
     "launcher.title":  "App Launcher",
+    "launcher.folder": "Folder",
     "launcher.subtitle":  "Apps and folders from Windows Start Menu",
     "launcher.subtitle_linux":  "Installed apps discovered from Linux desktop entries",
     "launcher.empty":  "No Start Menu entries found.",
@@ -554,6 +576,7 @@
     "component_category.info":  "Info",
     "component_category.calculator":  "Calculator",
     "component_category.study":  "Study",
+    "component_category.file":  "File",
     "component.date":  "Calendar",
     "component.month_calendar":  "Month Calendar",
     "component.lunar_calendar":  "Lunar Calendar",
@@ -582,6 +605,19 @@
     "component.blackboard_landscape":  "Blackboard (Landscape)",
     "component.browser":  "Browser",
     "component.office_recent_documents":  "Recent Documents",
+    "whiteboard.settings.desc": "Each blackboard keeps its own note history and saves it independently.",
+    "whiteboard.settings.retention.title": "Note retention",
+    "whiteboard.settings.retention.desc": "Choose how long this blackboard should keep saved notes before expired data is removed automatically.",
+    "whiteboard.settings.retention.option": "{0} days",
+    "whiteboard.settings.instance_scope": "This retention setting is stored per blackboard component instance.",
+    "office_recent_documents.settings.desc":  "Choose which Windows and Office sources this widget should scan for recent documents.",
+    "office_recent_documents.settings.sources_title":  "Recent document sources",
+    "office_recent_documents.settings.sources_desc":  "You can combine multiple sources. Registry selection also keeps the Office interop MRU fallback available.",
+    "office_recent_documents.settings.source.registry":  "Office registry MRU",
+    "office_recent_documents.settings.source.recent_folders":  "Windows Recent folders",
+    "office_recent_documents.settings.source.jump_lists":  "Windows Jump Lists",
+    "office_recent_documents.settings.hint":  "If you disable all sources, this widget will stay empty until at least one source is enabled again.",
+    "component.removable_storage":  "Removable Storage",
     "component.holiday_calendar":  "Holiday Calendar",
     "component.study_environment":  "Environment",
     "component.study_session_control":  "Study Session Control",
@@ -783,6 +819,20 @@
     "study.environment.settings.show_display_db":  "Show display dB",
     "study.environment.settings.show_dbfs":  "Show dBFS",
     "study.environment.settings.hint":  "At least one display mode must stay enabled.",
+    "removable_storage.settings.desc":  "Show a connected USB drive with quick open and eject actions.",
+    "removable_storage.settings.behavior_title":  "Behavior",
+    "removable_storage.settings.behavior_desc":  "The widget automatically watches for removable drives and switches to the newest inserted USB drive.",
+    "removable_storage.action.open":  "Open",
+    "removable_storage.action.eject":  "Eject",
+    "removable_storage.widget.default_name":  "Removable Drive",
+    "removable_storage.widget.empty_title":  "No device inserted",
+    "removable_storage.widget.empty_subtitle":  "Insert a USB drive to show it here.",
+    "removable_storage.widget.empty_hint":  "Buttons stay disabled until a removable device is inserted.",
+    "removable_storage.widget.ready":  "Ready to open or eject.",
+    "removable_storage.widget.ejecting":  "Ejecting drive...",
+    "removable_storage.widget.eject_failed":  "Could not eject this drive. Close any files on it and try again.",
+    "removable_storage.widget.open_failed":  "Failed to open this drive.",
+    "removable_storage.widget.refresh_failed":  "Drive list refresh failed.",
     "study.session_control.action.start":  "Start Study Session",
     "study.session_control.action.stop":  "Stop Study Session",
     "study.session_control.idle_hint":  "Tap the right button to start",
@@ -887,5 +937,7 @@
     "placement.tile":  "Tile",
     "single_instance.notice.title":  "App already running",
     "single_instance.notice.description":  "The app is already running. There is no need to click multiple times to open it.",
-    "single_instance.notice.button":  "OK"
+    "single_instance.notice.button":  "OK",
+    "market.status.install_success_restart_format":  "✓ Plugin '{0}' installed successfully! Please restart the application to activate it.",
+    "market.dialog.restart_message_format":  "Plugin '{0}' has been installed successfully.\n\nTo use this plugin, you need to restart the application now.\n\nWould you like to restart?"
   }

LanMountainDesktop/Localization/zh-CN.json

@@ -7,7 +7,12 @@
     "tray.menu.restart":  "重启应用",
     "tray.menu.exit":  "退出应用",
     "button.back_to_windows":  "回到Windows",
+    "button.back_to_platform": "回到{0}",
     "tooltip.back_to_windows":  "回到Windows",
+    "tooltip.back_to_platform": "回到{0}",
+    "platform.windows": "Windows",
+    "platform.linux": "Linux",
+    "platform.macos": "macOS",
     "tooltip.open_settings":  "设置",
     "settings.title":  "设置",
     "settings.shell.title":  "设置",
@@ -20,7 +25,7 @@
     "settings.nav.group_system":  "系统",
     "settings.nav.group_extensions":  "扩展",
     "settings.nav.wallpaper":  "壁纸",
-    "settings.nav.grid":  "网格",
+    "settings.nav.grid":  "组件",
     "settings.nav.color":  "颜色",
     "settings.nav.status_bar":  "状态栏",
     "settings.nav.weather":  "天气",
@@ -31,13 +36,14 @@
     "settings.nav.plugins":  "插件",
     "settings.nav.about":  "关于",
     "settings.wallpaper.title":  "壁纸",
-    "settings.wallpaper.description":  "选择图片或视频后可立即设为应用窗口壁纸。",
+    "settings.wallpaper.description":  "选择图片后可立即设为应用窗口壁纸。",
     "settings.wallpaper.current_label":  "当前壁纸",
     "settings.wallpaper.type_label":  "壁纸类型",
     "settings.wallpaper.type.image":  "图片",
-    "settings.wallpaper.type.video":  "视频",
     "settings.wallpaper.type.solid_color":  "纯色",
     "settings.wallpaper.color_label":  "壁纸颜色",
+    "settings.wallpaper.custom_color_tooltip":  "自定义颜色",
+    "settings.wallpaper.custom_color_apply":  "应用",
     "settings.wallpaper.placement_label":  "显示方式",
     "settings.wallpaper.placement_desc":  "调整图像在桌面上的填充方式。",
     "settings.wallpaper.pick_button":  "选择文件",
@@ -46,20 +52,14 @@
     "settings.wallpaper.storage_unavailable":  "存储提供器不可用。",
     "settings.wallpaper.import_failed":  "导入壁纸文件失败。",
     "settings.wallpaper.image_applied":  "图片壁纸已应用。",
-    "settings.wallpaper.video_applied":  "视频壁纸已应用。",
     "settings.wallpaper.unsupported_file":  "所选文件类型不受支持。",
     "settings.wallpaper.apply_failed_format":  "应用壁纸失败：{0}",
     "settings.wallpaper.mode_format":  "壁纸模式：{0}。",
-    "settings.wallpaper.video_mode":  "视频壁纸使用自动填充模式。",
     "settings.wallpaper.cleared":  "背景已恢复为纯色。",
     "settings.wallpaper.default_status":  "当前使用纯色背景。",
     "settings.wallpaper.saved_not_found":  "未找到已保存的壁纸文件，已使用纯色背景。",
     "settings.wallpaper.restored":  "已恢复保存的壁纸。",
-    "settings.wallpaper.video_restored":  "已恢复保存的视频壁纸。",
     "settings.wallpaper.restore_failed":  "恢复已保存壁纸失败，已使用纯色背景。",
-    "settings.wallpaper.video_not_found":  "未找到视频壁纸文件。",
-    "settings.wallpaper.video_player_unavailable":  "视频播放器不可用。",
-    "settings.wallpaper.video_play_failed_format":  "播放视频壁纸失败：{0}",
     "settings.grid.title":  "网格布局",
     "settings.grid.description":  "每个组件至少占用一个格子（最小 1x1）。",
     "settings.grid.short_side_label":  "短边格数",
@@ -85,12 +85,13 @@
     "settings.color.theme_ready_format":  "主题色已就绪：{0}。",
     "settings.color.theme_applied_format":  "{0}主题色已应用：{1}。",
     "settings.color.theme_updated_wallpaper":  "壁纸已更新，莫奈色已刷新。",
-    "settings.color.theme_updated_video":  "视频壁纸已更新，主题色已刷新。",
     "settings.color.theme_cleared_wallpaper":  "壁纸已清除，莫奈色已刷新。",
     "settings.status_bar.title":  "状态栏",
     "settings.status_bar.description":  "选择顶部状态栏显示的组件。",
     "settings.status_bar.clock_header":  "时间组件",
     "settings.status_bar.clock_description":  "在顶部状态栏显示时钟。",
+    "settings.status_bar.clock_transparent_background_label":  "透明背景",
+    "settings.status_bar.clock_transparent_background_desc":  "移除胶囊背景，仅保留时钟文字。",
     "settings.status_bar.spacing_header":  "组件间距",
     "settings.status_bar.spacing_desc":  "调整状态栏组件之间的间距。",
     "settings.status_bar.spacing_mode_compact":  "紧凑",
@@ -104,6 +105,11 @@
     "settings.privacy.crash_upload_description":  "帮助我们提高应用稳定性。",
     "settings.privacy.usage_upload_title":  "匿名上传使用数据",
     "settings.privacy.usage_upload_description":  "帮助我们改善应用功能。",
+    "settings.privacy.device_id_title":  "设备标识符",
+    "settings.privacy.device_id_description":  "此设备的唯一标识符。点击刷新以重新生成。",
+    "settings.privacy.refresh_device_id":  "刷新",
+    "settings.privacy.policy_hint_prefix":  "了解更多详情，请",
+    "settings.privacy.view_policy":  "查看我们的隐私政策",
     "settings.weather.title":  "天气",
     "settings.weather.description":  "配置天气位置、小米天气预览和启动时的位置刷新行为。",
     "settings.weather.location_source_header":  "位置来源",
@@ -295,9 +301,18 @@
     "settings.status_bar.clock_format_label":  "时钟格式",
     "settings.status_bar.clock_format.hm":  "时:分",
     "settings.status_bar.clock_format.hms":  "时:分:秒",
-    "settings.components.title":  "网格",
+    "settings.components.title":  "组件",
-    "settings.components.description":  "调整桌面网格与布局。",
+    "settings.components.description":  "调整组件布局与圆角设计。",
-    "settings.components.grid_header":  "网格布局",
+    "settings.components.grid_header":  "网格设置",
+    "settings.components.header":  "网格设置",
+    "settings.components.short_side_label":  "短边格数",
+    "settings.components.edge_inset_label":  "屏幕边距",
+    "settings.components.spacing_label":  "组件间距",
+    "settings.components.spacing_compact":  "紧凑",
+    "settings.components.spacing_relaxed":  "宽松",
+    "settings.components.corner_radius.header":  "圆角设计",
+    "settings.components.corner_radius.label":  "组件圆角",
+    "settings.components.corner_radius.description":  "将组件容器圆角从直角连续调到接近胶囊的形态，并随圆角增大同步扩展内部安全区。",
     "settings.update.title":  "更新",
     "settings.update.current_version_label":  "当前版本",
     "settings.update.latest_version_label":  "最新发布",
@@ -393,7 +408,6 @@
     "settings.footer":  "LanMountainDesktop 设置",
     "filepicker.title":  "选择壁纸",
     "filepicker.image_files":  "图片文件",
-    "filepicker.video_files":  "视频文件",
     "common.day":  "日间",
     "common.night":  "夜间",
     "common.back":  "返回",
@@ -403,6 +417,7 @@
     "common.monet":  "莫奈",
     "desktop.page_index_format":  "桌面 {0}",
     "launcher.title":  "应用启动台",
+    "launcher.folder": "文件夹",
     "launcher.subtitle":  "按 Windows 开始菜单结构显示所有应用与文件夹",
     "launcher.subtitle_linux":  "显示从 Linux .desktop 条目扫描到的已安装应用",
     "launcher.empty":  "未找到开始菜单条目。",
@@ -559,6 +574,7 @@
     "component_category.info":  "信息推荐",
     "component_category.calculator":  "计算器",
     "component_category.study":  "自习",
+    "component_category.file":  "文件",
     "component.date":  "日历",
     "component.month_calendar":  "月历",
     "component.lunar_calendar":  "农历",
@@ -587,6 +603,18 @@
     "component.blackboard_landscape":  "横向小黑板",
     "component.browser":  "浏览器",
     "component.office_recent_documents":  "最近文档",
+    "whiteboard.settings.desc": "每个小黑板都会独立保存自己的笔记历史。",
+    "whiteboard.settings.retention.title": "笔记保留时间",
+    "whiteboard.settings.retention.desc": "选择这个小黑板在过期笔记被自动删除前，应当保留已保存笔记多久。",
+    "whiteboard.settings.retention.option": "{0} 天",
+    "whiteboard.settings.instance_scope": "这个保留时间设置会按每个小黑板组件实例单独存储。",
+    "office_recent_documents.settings.desc":  "选择此小组件需要扫描的 Windows 和 Office 最近文档来源。",
+    "office_recent_documents.settings.sources_title":  "最近文档来源",
+    "office_recent_documents.settings.sources_desc":  "可以同时选择多个来源。勾选注册表来源时，还会保留 Office interop 的 MRU 回退。",
+    "office_recent_documents.settings.source.registry":  "Office 注册表 MRU",
+    "office_recent_documents.settings.source.recent_folders":  "Windows 最近文件夹",
+    "office_recent_documents.settings.source.jump_lists":  "Windows 跳转列表",
+    "office_recent_documents.settings.hint":  "如果关闭全部来源，此小组件会保持空白，直到再次至少启用一个来源。",
     "component.holiday_calendar":  "节假日日历",
     "component.study_environment":  "环境",
     "component.study_session_control":  "自习时段控制",
@@ -783,6 +811,21 @@
     "study.environment.value.unavailable":  "--",
     "study.environment.value.display_format":  "{0:F1} dB",
     "study.environment.value.dbfs_format":  "{0:F1} dBFS",
+    "component.removable_storage":  "可移动存储",
+    "removable_storage.settings.desc":  "在桌面上显示已连接的 U 盘，并提供打开与弹出操作。",
+    "removable_storage.settings.behavior_title":  "行为",
+    "removable_storage.settings.behavior_desc":  "组件会自动监听可移动存储设备，并优先显示最新插入的 U 盘。",
+    "removable_storage.action.open":  "打开",
+    "removable_storage.action.eject":  "弹出",
+    "removable_storage.widget.default_name":  "可移动磁盘",
+    "removable_storage.widget.empty_title":  "未插入设备",
+    "removable_storage.widget.empty_subtitle":  "插入 U 盘后会自动显示在这里。",
+    "removable_storage.widget.empty_hint":  "在插入可移动设备之前，底部按钮会保持置灰不可点击。",
+    "removable_storage.widget.ready":  "已准备好，可直接打开或弹出。",
+    "removable_storage.widget.ejecting":  "正在弹出设备...",
+    "removable_storage.widget.eject_failed":  "无法弹出该设备，请先关闭正在占用它的文件后再试。",
+    "removable_storage.widget.open_failed":  "打开该设备失败。",
+    "removable_storage.widget.refresh_failed":  "刷新可移动存储列表失败。",
     "study.environment.settings.title":  "环境组件设置",
     "study.environment.settings.desc":  "配置右侧实时噪音值显示内容。",
     "study.environment.settings.show_display_db":  "显示 display dB",
@@ -892,5 +935,7 @@
     "placement.tile":  "平铺",
     "single_instance.notice.title":  "应用已经运行",
     "single_instance.notice.description":  "应用已经运行，无需多次点击打开。",
-    "single_instance.notice.button":  "确定"
+    "single_instance.notice.button":  "确定",
+    "market.status.install_success_restart_format":  "✓ 插件'{0}'安装成功！请重启应用以激活它。",
+    "market.dialog.restart_message_format":  "插件'{0}'已成功安装。\n\n要使用此插件，您需要立即重启应用。\n\n是否立即重启？"
   }

LanMountainDesktop/Models/AppSettingsSnapshot.cs

@@ -1,4 +1,5 @@
 using System.Collections.Generic;
+using LanMountainDesktop.Settings.Core;
 
 namespace LanMountainDesktop.Models;
 
@@ -16,6 +17,8 @@ public sealed class AppSettingsSnapshot
 
     public bool UseSystemChrome { get; set; }
 
+    public double GlobalCornerRadiusScale { get; set; } = GlobalAppearanceSettings.DefaultCornerRadiusScale;
+
     public string ThemeColorMode { get; set; } = "default_neutral";
 
     public string SystemMaterialMode { get; set; } = "none";
@@ -62,15 +65,17 @@ public sealed class AppSettingsSnapshot
 
     public string AppRenderMode { get; set; } = "Default";
 
-    public bool AutoCheckUpdates { get; set; } = true;
-
     public bool IncludePrereleaseUpdates { get; set; }
 
     public bool UploadAnonymousCrashData { get; set; }
 
     public bool UploadAnonymousUsageData { get; set; }
 
-    public string? DeviceId { get; set; }
+    public string? TelemetryInstallId { get; set; }
+
+    public string? TelemetryId { get; set; }
+
+    public bool HasReportedTelemetryBaseline { get; set; }
 
     public string UpdateChannel { get; set; } = "stable";
 
@@ -101,6 +106,8 @@ public sealed class AppSettingsSnapshot
 
     public string ClockDisplayFormat { get; set; } = "HourMinuteSecond";
 
+    public bool StatusBarClockTransparentBackground { get; set; }
+
     public string StatusBarSpacingMode { get; set; } = "Relaxed";
 
     public int StatusBarCustomSpacingPercent { get; set; } = 12;

LanMountainDesktop/Models/ComponentSettingsSnapshot.cs

@@ -58,12 +58,16 @@ public sealed class ComponentSettingsSnapshot
 
     public int WeatherAutoRefreshIntervalMinutes { get; set; } = 12;
 
+    public int WhiteboardNoteRetentionDays { get; set; } = 15;
+
     public bool Stcn24ForumAutoRefreshEnabled { get; set; } = true;
 
     public int Stcn24ForumAutoRefreshIntervalMinutes { get; set; } = 20;
 
     public string Stcn24ForumSourceType { get; set; } = Stcn24ForumSourceTypes.LatestCreated;
 
+    public List<string>? OfficeRecentDocumentsEnabledSources { get; set; }
+
     public ComponentSettingsSnapshot Clone()
     {
         var clone = (ComponentSettingsSnapshot)MemberwiseClone();
@@ -91,6 +95,9 @@ public sealed class ComponentSettingsSnapshot
         clone.WorldClockTimeZoneIds = WorldClockTimeZoneIds is { Count: > 0 }
             ? new List<string>(WorldClockTimeZoneIds)
             : [];
+        clone.OfficeRecentDocumentsEnabledSources = OfficeRecentDocumentsEnabledSources is not null
+            ? new List<string>(OfficeRecentDocumentsEnabledSources)
+            : null;
 
         return clone;
     }

LanMountainDesktop/Models/OfficeRecentDocumentSourceTypes.cs

@@ -0,0 +1,53 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace LanMountainDesktop.Models;
+
+public static class OfficeRecentDocumentSourceTypes
+{
+    public const string Registry = "registry";
+    public const string RecentFolders = "recent_folders";
+    public const string JumpLists = "jump_lists";
+
+    public static IReadOnlyList<string> SupportedValues { get; } =
+    [
+        Registry,
+        RecentFolders,
+        JumpLists
+    ];
+
+    public static IReadOnlyList<string> DefaultValues => SupportedValues;
+
+    public static IReadOnlyList<string> NormalizeValues(IEnumerable<string>? values, bool useDefaultWhenEmpty)
+    {
+        if (values is null)
+        {
+            return useDefaultWhenEmpty ? DefaultValues : Array.Empty<string>();
+        }
+
+        var normalized = values
+            .Select(NormalizeValue)
+            .OfType<string>()
+            .Distinct(StringComparer.OrdinalIgnoreCase)
+            .ToArray();
+
+        if (normalized.Length == 0 && useDefaultWhenEmpty)
+        {
+            return DefaultValues;
+        }
+
+        return normalized;
+    }
+
+    private static string? NormalizeValue(string? value)
+    {
+        return value?.Trim().ToLowerInvariant() switch
+        {
+            Registry => Registry,
+            RecentFolders => RecentFolders,
+            JumpLists => JumpLists,
+            _ => null
+        };
+    }
+}

LanMountainDesktop/Models/WhiteboardNoteRetentionPolicy.cs

@@ -0,0 +1,23 @@
+namespace LanMountainDesktop.Models;
+
+public static class WhiteboardNoteRetentionPolicy
+{
+    public const int MinimumDays = 7;
+    public const int MaximumDays = 15;
+    public const int DefaultDays = MaximumDays;
+
+    public static int NormalizeDays(int days)
+    {
+        if (days < MinimumDays)
+        {
+            return MinimumDays;
+        }
+
+        if (days > MaximumDays)
+        {
+            return MaximumDays;
+        }
+
+        return days;
+    }
+}

LanMountainDesktop/Models/WhiteboardNoteSnapshot.cs

@@ -0,0 +1,60 @@
+using System;
+using System.Collections.Generic;
+
+namespace LanMountainDesktop.Models;
+
+public sealed class WhiteboardNoteSnapshot
+{
+    public int Version { get; set; } = 1;
+
+    public DateTimeOffset SavedUtc { get; set; }
+
+    public List<WhiteboardStrokeSnapshot> Strokes { get; set; } = [];
+
+    public WhiteboardNoteSnapshot Clone()
+    {
+        var clone = (WhiteboardNoteSnapshot)MemberwiseClone();
+        clone.Strokes = Strokes is { Count: > 0 }
+            ? new List<WhiteboardStrokeSnapshot>(Strokes.ConvertAll(stroke => stroke?.Clone() ?? new WhiteboardStrokeSnapshot()))
+            : [];
+        return clone;
+    }
+}
+
+public sealed class WhiteboardStrokeSnapshot
+{
+    public string Color { get; set; } = "#FF000000";
+
+    public double InkThickness { get; set; } = 2.5d;
+
+    public bool IgnorePressure { get; set; } = true;
+
+    public List<WhiteboardStylusPointSnapshot> Points { get; set; } = [];
+
+    public WhiteboardStrokeSnapshot Clone()
+    {
+        var clone = (WhiteboardStrokeSnapshot)MemberwiseClone();
+        clone.Points = Points is { Count: > 0 }
+            ? new List<WhiteboardStylusPointSnapshot>(Points.ConvertAll(point => point?.Clone() ?? new WhiteboardStylusPointSnapshot()))
+            : [];
+        return clone;
+    }
+}
+
+public sealed class WhiteboardStylusPointSnapshot
+{
+    public double X { get; set; }
+
+    public double Y { get; set; }
+
+    public double Pressure { get; set; } = 0.5d;
+
+    public double Width { get; set; }
+
+    public double Height { get; set; }
+
+    public WhiteboardStylusPointSnapshot Clone()
+    {
+        return (WhiteboardStylusPointSnapshot)MemberwiseClone();
+    }
+}

LanMountainDesktop/Program.cs

@@ -4,10 +4,10 @@ using System.Threading;
 using System.Threading.Tasks;
 using Avalonia;
 using Avalonia.WebView.Desktop;
+using LanMountainDesktop.DesktopHost;
 using LanMountainDesktop.Models;
 using LanMountainDesktop.Services;
 using LanMountainDesktop.Services.Settings;
-using Sentry;
 
 namespace LanMountainDesktop;
 
@@ -20,9 +20,6 @@ sealed class Program
     {
         AppLogger.Initialize();
         RegisterGlobalExceptionLogging();
-        InitializeDeviceId();
-        InitializeCrashReporting();
-        InitializeUserBehaviorAnalytics();
         var restartParentProcessId = AppRestartService.TryGetRestartParentProcessId(args);
 
         using var singleInstance = AcquireSingleInstance(restartParentProcessId);
@@ -41,6 +38,12 @@ sealed class Program
             return;
         }
 
+        DesktopBootstrap.InitializeStartupServices(
+            InitializeTelemetryIdentity,
+            InitializeCrashTelemetry,
+            InitializeUsageTelemetry,
+            ScheduleWhiteboardNoteStartupCleanup);
+
         var diagnostics = StartupDiagnosticsService.Run(args);
         StartupDiagnosticsService.ShowLegacyExecutableWarningIfNeeded(diagnostics);
 
@@ -50,7 +53,6 @@ sealed class Program
             StartupRenderMode = renderMode;
             AppLogger.Info("Startup", $"Resolved render mode '{renderMode}'.");
             App.CurrentSingleInstanceService = singleInstance;
-            App.AnalyticsServices = (_userBehaviorAnalyticsService, _crashReportService);
             BuildAvaloniaApp(renderMode).StartWithClassicDesktopLifetime(args);
             AppLogger.Info("Startup", "Application exited normally.");
         }
@@ -88,6 +90,25 @@ sealed class Program
         return builder;
     }
 
+    private static void ScheduleWhiteboardNoteStartupCleanup()
+    {
+        _ = Task.Run(() =>
+        {
+            try
+            {
+                var deletedCount = new WhiteboardNotePersistenceService().DeleteExpiredNotesBatch(batchSize: 512);
+                if (deletedCount > 0)
+                {
+                    AppLogger.Info("Startup", $"Deleted {deletedCount} expired whiteboard notes during startup maintenance.");
+                }
+            }
+            catch (Exception ex)
+            {
+                AppLogger.Warn("Startup", "Failed to run whiteboard note startup maintenance.", ex);
+            }
+        });
+    }
+
     private static SingleInstanceService AcquireSingleInstance(int? restartParentProcessId)
     {
         var singleInstance = SingleInstanceService.CreateDefault();
@@ -163,204 +184,90 @@ sealed class Program
     {
         AppDomain.CurrentDomain.UnhandledException += (_, eventArgs) =>
         {
+            var exception = eventArgs.ExceptionObject as Exception
+                ?? new Exception(eventArgs.ExceptionObject?.ToString() ?? "Unhandled exception.");
+
             AppLogger.Critical(
                 "UnhandledException",
                 $"Unhandled exception. IsTerminating={eventArgs.IsTerminating}",
-                eventArgs.ExceptionObject as Exception);
+                exception);
 
-            if (eventArgs.IsTerminating)
+            try
             {
-                SentrySdk.Flush(TimeSpan.FromSeconds(5));
+                TelemetryServices.Crash?.CaptureUnhandledException(
+                    exception,
+                    "AppDomain.UnhandledException",
+                    eventArgs.IsTerminating);
+            }
+            catch (Exception telemetryException)
+            {
+                AppLogger.Warn("UnhandledException", "Failed to forward unhandled exception to crash telemetry.", telemetryException);
             }
         };
 
         TaskScheduler.UnobservedTaskException += (_, eventArgs) =>
         {
             AppLogger.Error("TaskScheduler", "Unobserved task exception.", eventArgs.Exception);
+
+            try
+            {
+                TelemetryServices.Crash?.CaptureTaskException(
+                    eventArgs.Exception,
+                    "TaskScheduler.UnobservedTaskException");
+            }
+            catch (Exception telemetryException)
+            {
+                AppLogger.Warn("TaskScheduler", "Failed to forward task exception to crash telemetry.", telemetryException);
+            }
+
             eventArgs.SetObserved();
         };
     }
 
-    private static void InitializeDeviceId()
+    private static void InitializeTelemetryIdentity()
     {
         try
         {
-            DeviceIdService.Initialize(HostSettingsFacadeProvider.GetOrCreate());
+            TelemetryIdentityService.Initialize(HostSettingsFacadeProvider.GetOrCreate());
-            AppLogger.Info("Startup", $"DeviceId initialized: {DeviceIdService.Instance.DeviceId}");
+            AppLogger.Info(
+                "Startup",
+                $"Telemetry identity initialized. InstallId={TelemetryIdentityService.Instance.InstallId}; TelemetryId={TelemetryIdentityService.Instance.TelemetryId}.");
         }
         catch (Exception ex)
         {
-            AppLogger.Warn("Startup", "Failed to initialize DeviceIdService.", ex);
+            AppLogger.Warn("Startup", "Failed to initialize telemetry identity service.", ex);
         }
     }
 
-    private static void InitializeSentryForAnalytics()
+    private static void InitializeCrashTelemetry()
-    {
-        try
-        {
-            var deviceId = DeviceIdService.Instance.DeviceId;
-
-            SentrySdk.Init(options =>
-            {
-                options.Dsn = "https://f2aad3a1c63b5f2213ad82683ce93c06@o4511049423257600.ingest.us.sentry.io/4511049425813504";
-                options.AutoSessionTracking = true;
-                options.Release = GetAppVersion();
-                options.Environment = GetEnvironment();
-            });
-
-            SentrySdk.ConfigureScope(scope =>
-            {
-                scope.User = new SentryUser
-                {
-                    Id = deviceId
-                };
-
-                scope.SetTag("data_type", "analytics");
-                scope.SetTag("device_id", deviceId);
-                scope.SetTag("app_version", GetAppVersion());
-                scope.SetTag("os_name", GetOsName());
-                scope.SetTag("os_version", GetOsVersion());
-                scope.SetTag("os_build", GetOsBuild());
-                scope.SetTag("device_model", GetDeviceModel());
-                scope.SetTag("device_arch", GetDeviceArchitecture());
-                scope.SetTag("processor_count", GetProcessorCount().ToString());
-                scope.SetTag("total_memory_mb", GetTotalMemoryMB().ToString());
-                scope.SetTag("runtime_version", GetRuntimeVersion());
-                scope.SetTag("language", GetSystemLanguage());
-                scope.SetTag("clr_version", GetClrVersion());
-                scope.SetTag("is_64bit", Environment.Is64BitOperatingSystem.ToString());
-            });
-
-            SentrySdk.CaptureMessage("user_active");
-
-            AppLogger.Info("Startup", $"Analytics service initialized. DeviceId={deviceId}");
-        }
-        catch (Exception ex)
-        {
-            AppLogger.Warn("Startup", "Failed to initialize analytics service.", ex);
-        }
-    }
-
-    private static string GetAppVersion()
-    {
-        var version = typeof(Program).Assembly.GetName().Version;
-        return version is null ? "1.0.0" : $"{version.Major}.{version.Minor}.{version.Build}";
-    }
-
-    private static string GetOsName()
-    {
-        if (OperatingSystem.IsWindows()) return "Windows";
-        if (OperatingSystem.IsLinux()) return "Linux";
-        if (OperatingSystem.IsMacOS()) return "macOS";
-        return "Unknown";
-    }
-
-    private static string GetOsVersion()
-    {
-        try { return Environment.OSVersion.VersionString ?? "Unknown"; }
-        catch { return "Unknown"; }
-    }
-
-    private static string GetOsBuild()
-    {
-        try { return Environment.OSVersion.Version.Build.ToString() ?? "Unknown"; }
-        catch { return "Unknown"; }
-    }
-
-    private static string GetDeviceName()
-    {
-        try { return Environment.MachineName ?? "Unknown"; }
-        catch { return "Unknown"; }
-    }
-
-    private static string GetDeviceModel()
-    {
-        if (OperatingSystem.IsWindows()) return "Windows PC";
-        if (OperatingSystem.IsLinux()) return "Linux PC";
-        if (OperatingSystem.IsMacOS()) return "Mac";
-        return "Unknown";
-    }
-
-    private static string GetDeviceArchitecture()
-    {
-        return Environment.Is64BitOperatingSystem ? "x64" : "x86";
-    }
-
-    private static int GetProcessorCount()
-    {
-        return Environment.ProcessorCount;
-    }
-
-    private static long GetTotalMemoryMB()
-    {
-        try { return GC.GetGCMemoryInfo().TotalAvailableMemoryBytes / (1024 * 1024); }
-        catch { return 0; }
-    }
-
-    private static string GetRuntimeVersion()
-    {
-        return Environment.Version.ToString();
-    }
-
-    private static string GetSystemLanguage()
-    {
-        try { return System.Globalization.CultureInfo.CurrentUICulture.Name ?? "en-US"; }
-        catch { return "en-US"; }
-    }
-
-    private static string GetClrVersion()
-    {
-        return Environment.Version.ToString();
-    }
-
-    private static CrashReportService? _crashReportService;
-    private static UserBehaviorAnalyticsService? _userBehaviorAnalyticsService;
-
-    private static void InitializeCrashReporting()
     {
         try
         {
             var settingsFacade = HostSettingsFacadeProvider.GetOrCreate();
-            _crashReportService = new CrashReportService(settingsFacade, DeviceIdService.Instance);
+            var crashTelemetry = new SentryCrashTelemetryService(settingsFacade);
-            _crashReportService.RefreshEnabledState();
+            TelemetryServices.Crash = crashTelemetry;
+            crashTelemetry.Initialize();
+            AppLogger.Info("Startup", $"Crash telemetry initialized. Enabled={crashTelemetry.IsEnabled}.");
         }
         catch (Exception ex)
         {
-            AppLogger.Warn("Startup", "Failed to initialize crash reporting service.", ex);
+            AppLogger.Warn("Startup", "Failed to initialize crash telemetry service.", ex);
         }
     }
 
-    private static void InitializeUserBehaviorAnalytics()
+    private static void InitializeUsageTelemetry()
     {
         try
         {
             var settingsFacade = HostSettingsFacadeProvider.GetOrCreate();
-            _userBehaviorAnalyticsService = new UserBehaviorAnalyticsService(settingsFacade, DeviceIdService.Instance);
+            var usageTelemetry = new PostHogUsageTelemetryService(settingsFacade);
-            _userBehaviorAnalyticsService.Initialize();
+            TelemetryServices.Usage = usageTelemetry;
+            usageTelemetry.Initialize();
+            AppLogger.Info("Startup", $"Usage telemetry initialized. Enabled={usageTelemetry.IsUsageEnabled}.");
         }
         catch (Exception ex)
         {
-            AppLogger.Warn("Startup", "Failed to initialize user behavior analytics service.", ex);
+            AppLogger.Warn("Startup", "Failed to initialize usage telemetry service.", ex);
         }
     }
-
-    private static string GetReleaseVersion()
-    {
-        var assembly = typeof(Program).Assembly;
-        var version = assembly.GetName().Version;
-        if (version is null)
-        {
-            return "1.0.0";
-        }
-        return version.Major >= 0 ? $"{version.Major}.{version.Minor}.{version.Build}" : "1.0.0";
-    }
-
-    private static string GetEnvironment()
-    {
-#if DEBUG
-        return "development";
-#else
-        return "production";
-#endif
-    }
 }

LanMountainDesktop/Services/AppDatabaseService.cs

@@ -29,6 +29,16 @@ public sealed class AppDatabaseService
         _databasePath = Path.Combine(dataDirectory, "app.db");
     }
 
+    public AppDatabaseService(string databasePath)
+    {
+        if (string.IsNullOrWhiteSpace(databasePath))
+        {
+            throw new ArgumentException("Database path cannot be null or whitespace.", nameof(databasePath));
+        }
+
+        _databasePath = databasePath;
+    }
+
     public SqliteConnection OpenConnection()
     {
         var directory = Path.GetDirectoryName(_databasePath);

LanMountainDesktop/Services/AppearanceThemeService.cs

@@ -11,11 +11,13 @@ using Avalonia.Media;
 using Avalonia.Styling;
 using Avalonia.Threading;
 using Avalonia.Media.Imaging;
+using LanMountainDesktop.Appearance;
 using LanMountainDesktop.Models;
 using LanMountainDesktop.PluginSdk;
 using LanMountainDesktop.Services.Settings;
+using LanMountainDesktop.Settings.Core;
+using LanMountainDesktop.Shared.Contracts;
 using LanMountainDesktop.Theme;
-using LibVLCSharp.Shared;
 using Microsoft.Win32;
 
 namespace LanMountainDesktop.Services;
@@ -42,6 +44,8 @@ public sealed record AppearanceThemeSnapshot(
     string ThemeColorMode,
     string? UserThemeColor,
     string? SelectedWallpaperSeed,
+    double GlobalCornerRadiusScale,
+    AppearanceCornerRadiusTokens CornerRadiusTokens,
     string ResolvedSeedSource,
     MonetPalette MonetPalette,
     Color AccentColor,
@@ -89,11 +93,6 @@ internal interface IMaterialSurfaceService
     AppearanceMaterialSurface GetSurface(ThemeColorContext context, MaterialSurfaceRole role);
 }
 
-internal interface IVideoWallpaperSeedExtractor
-{
-    IReadOnlyList<Color> ExtractSeedCandidates(string videoPath, MonetColorService monetColorService);
-}
-
 internal readonly record struct WallpaperSeedSourceDescriptor(
     string SourceKind,
     string SourceKey,
@@ -114,75 +113,6 @@ internal readonly record struct WallpaperPaletteResolution(
     Color EffectiveSeedColor,
     string? ResolvedWallpaperPath);
 
-internal sealed class LibVlcVideoWallpaperSeedExtractor : IVideoWallpaperSeedExtractor
-{
-    public IReadOnlyList<Color> ExtractSeedCandidates(string videoPath, MonetColorService monetColorService)
-    {
-        if (string.IsNullOrWhiteSpace(videoPath) || !File.Exists(videoPath))
-        {
-            return [];
-        }
-
-        var snapshotPath = Path.Combine(
-            Path.GetTempPath(),
-            $"lanmountaindesktop-video-seed-{Guid.NewGuid():N}.png");
-
-        try
-        {
-            using var libVlc = new LibVLC("--no-audio", "--intf=dummy", "--no-video-title-show");
-            using var media = new Media(libVlc, new Uri(videoPath));
-            using var mediaPlayer = new MediaPlayer(libVlc)
-            {
-                Media = media
-            };
-
-            mediaPlayer.Play();
-
-            var stopwatch = Stopwatch.StartNew();
-            while (stopwatch.Elapsed < TimeSpan.FromSeconds(5))
-            {
-                Thread.Sleep(180);
-                if (!mediaPlayer.TakeSnapshot(0, snapshotPath, 320, 180))
-                {
-                    continue;
-                }
-
-                var fileInfo = new FileInfo(snapshotPath);
-                if (!fileInfo.Exists || fileInfo.Length <= 0)
-                {
-                    continue;
-                }
-
-                using var bitmap = new Bitmap(snapshotPath);
-                return monetColorService.ExtractSeedCandidates(bitmap);
-            }
-        }
-        catch (Exception ex)
-        {
-            AppLogger.Warn(
-                "Appearance.VideoWallpaperPalette",
-                $"Failed to extract wallpaper seed candidates from video '{videoPath}'.",
-                ex);
-        }
-        finally
-        {
-            try
-            {
-                if (File.Exists(snapshotPath))
-                {
-                    File.Delete(snapshotPath);
-                }
-            }
-            catch
-            {
-                // Best effort cleanup only.
-            }
-        }
-
-        return [];
-    }
-}
-
 internal sealed class SystemWallpaperService : ISystemWallpaperService
 {
     public bool IsSupported => OperatingSystem.IsWindows();
@@ -477,7 +407,6 @@ internal sealed class AppearanceThemeService : IAppearanceThemeService, IDisposa
     private readonly ISystemWallpaperService _systemWallpaperService;
     private readonly IWindowMaterialService _windowMaterialService;
     private readonly IMaterialSurfaceService _materialSurfaceService;
-    private readonly IVideoWallpaperSeedExtractor _videoWallpaperSeedExtractor;
     private readonly MonetColorService _monetColorService = new();
     private readonly string _liveThemeColorMode;
     private readonly string _liveSystemMaterialMode;
@@ -490,14 +419,12 @@ internal sealed class AppearanceThemeService : IAppearanceThemeService, IDisposa
         ISettingsFacadeService settingsFacade,
         ISystemWallpaperService systemWallpaperService,
         IWindowMaterialService windowMaterialService,
-        IMaterialSurfaceService materialSurfaceService,
+        IMaterialSurfaceService materialSurfaceService)
-        IVideoWallpaperSeedExtractor? videoWallpaperSeedExtractor = null)
     {
         _settingsFacade = settingsFacade ?? throw new ArgumentNullException(nameof(settingsFacade));
         _systemWallpaperService = systemWallpaperService ?? throw new ArgumentNullException(nameof(systemWallpaperService));
         _windowMaterialService = windowMaterialService ?? throw new ArgumentNullException(nameof(windowMaterialService));
         _materialSurfaceService = materialSurfaceService ?? throw new ArgumentNullException(nameof(materialSurfaceService));
-        _videoWallpaperSeedExtractor = videoWallpaperSeedExtractor ?? new LibVlcVideoWallpaperSeedExtractor();
         var initialThemeState = _settingsFacade.Theme.Get();
         _liveThemeColorMode = ThemeAppearanceValues.NormalizeThemeColorMode(
             initialThemeState.ThemeColorMode,
@@ -542,6 +469,13 @@ internal sealed class AppearanceThemeService : IAppearanceThemeService, IDisposa
         var context = CreateThemeContext(snapshot);
         ThemeColorSystemService.ApplyThemeResources(resources, context);
         GlassEffectService.ApplyGlassResources(resources, context);
+        resources["DesignCornerRadiusMicro"] = snapshot.CornerRadiusTokens.Micro;
+        resources["DesignCornerRadiusXs"] = snapshot.CornerRadiusTokens.Xs;
+        resources["DesignCornerRadiusSm"] = snapshot.CornerRadiusTokens.Sm;
+        resources["DesignCornerRadiusMd"] = snapshot.CornerRadiusTokens.Md;
+        resources["DesignCornerRadiusLg"] = snapshot.CornerRadiusTokens.Lg;
+        resources["DesignCornerRadiusXl"] = snapshot.CornerRadiusTokens.Xl;
+        resources["DesignCornerRadiusIsland"] = snapshot.CornerRadiusTokens.Island;
     }
 
     public AppearanceMaterialSurface GetMaterialSurface(MaterialSurfaceRole role)
@@ -616,6 +550,7 @@ internal sealed class AppearanceThemeService : IAppearanceThemeService, IDisposa
         if (!refreshAll &&
             !changedKeys.Contains(nameof(AppSettingsSnapshot.IsNightMode), StringComparer.OrdinalIgnoreCase) &&
             !changedKeys.Contains(nameof(AppSettingsSnapshot.UseSystemChrome), StringComparer.OrdinalIgnoreCase) &&
+            !changedKeys.Contains(nameof(AppSettingsSnapshot.GlobalCornerRadiusScale), StringComparer.OrdinalIgnoreCase) &&
             !(respondsToThemeColor &&
               changedKeys.Contains(nameof(AppSettingsSnapshot.ThemeColor), StringComparer.OrdinalIgnoreCase)) &&
             !(respondsToWallpaper &&
@@ -637,6 +572,8 @@ internal sealed class AppearanceThemeService : IAppearanceThemeService, IDisposa
         bool queueWallpaperPaletteBuild)
     {
         var availableModes = _windowMaterialService.GetAvailableModes();
+        var globalCornerRadiusScale = GlobalAppearanceSettings.NormalizeCornerRadiusScale(themeState.GlobalCornerRadiusScale);
+        var cornerRadiusTokens = AppearanceCornerRadiusTokenFactory.Create(globalCornerRadiusScale);
         MonetPalette palette;
         IReadOnlyList<Color> wallpaperSeedCandidates;
         Color effectiveSeedColor;
@@ -676,6 +613,8 @@ internal sealed class AppearanceThemeService : IAppearanceThemeService, IDisposa
             themeColorMode,
             themeState.ThemeColor,
             selectedWallpaperSeed,
+            globalCornerRadiusScale,
+            cornerRadiusTokens,
             resolvedSeedSource,
             palette,
             ResolveAccentColor(themeColorMode, themeState.ThemeColor, palette),
@@ -886,7 +825,6 @@ internal sealed class AppearanceThemeService : IAppearanceThemeService, IDisposa
         IReadOnlyList<Color> seedCandidates = source.SourceKind switch
         {
             "app_wallpaper" or "system_wallpaper" => ExtractImageSeedCandidates(source.FilePath),
-            "app_video" => ExtractVideoSeedCandidates(source.FilePath),
             "app_solid" when source.SolidColor is { } solidColor => new[] { solidColor },
             _ => []
         };
@@ -920,16 +858,6 @@ internal sealed class AppearanceThemeService : IAppearanceThemeService, IDisposa
         }
     }
 
-    private IReadOnlyList<Color> ExtractVideoSeedCandidates(string? wallpaperPath)
-    {
-        if (string.IsNullOrWhiteSpace(wallpaperPath) || !File.Exists(wallpaperPath))
-        {
-            return [];
-        }
-
-        return _videoWallpaperSeedExtractor.ExtractSeedCandidates(wallpaperPath, _monetColorService);
-    }
-
     private WallpaperSeedSourceDescriptor ResolveWallpaperSeedSource(WallpaperSettingsState wallpaperState)
     {
         if (string.Equals(wallpaperState.Type, "SolidColor", StringComparison.OrdinalIgnoreCase) &&
@@ -960,16 +888,6 @@ internal sealed class AppearanceThemeService : IAppearanceThemeService, IDisposa
                     wallpaperPath,
                     null);
             }
-
-            if (appWallpaperMediaType == WallpaperMediaType.Video)
-            {
-                return new WallpaperSeedSourceDescriptor(
-                    "app_video",
-                    CreateWallpaperSourceKey("app_video", wallpaperPath),
-                    wallpaperPath,
-                    wallpaperPath,
-                    null);
-            }
         }
 
         var systemWallpaper = _systemWallpaperService.GetWallpaperPath();

LanMountainDesktop/Services/ComponentSettingsService.cs

@@ -106,6 +106,8 @@ public sealed class ComponentSettingsService : IComponentInstanceSettingsStore
 
     public void DeleteForComponent(string componentId, string? placementId)
     {
+        _ = new WhiteboardNotePersistenceService().DeleteNote(componentId, placementId);
+
         if (_settingsService is not null)
         {
             _settingsService.SaveSnapshot(

LanMountainDesktop/Services/CrashReportService.cs

@@ -1,943 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Runtime.InteropServices;
-using System.Text;
-using System.Text.Json;
-using LanMountainDesktop.Models;
-using LanMountainDesktop.PluginSdk;
-using LanMountainDesktop.Services.Settings;
-using Sentry;
-
-namespace LanMountainDesktop.Services;
-
-public sealed class DeviceIdService
-{
-    private static DeviceIdService? _instance;
-    private string? _deviceId;
-    private readonly ISettingsFacadeService _settingsFacade;
-    private bool _isInitialized;
-
-    public static DeviceIdService Instance => _instance ?? throw new InvalidOperationException("DeviceIdService not initialized");
-
-    public DeviceIdService(ISettingsFacadeService settingsFacade)
-    {
-        _settingsFacade = settingsFacade ?? throw new ArgumentNullException(nameof(settingsFacade));
-    }
-
-    public static void Initialize(ISettingsFacadeService settingsFacade)
-    {
-        _instance = new DeviceIdService(settingsFacade);
-        _instance.EnsureDeviceId();
-    }
-
-    public string DeviceId
-    {
-        get
-        {
-            if (_deviceId is null)
-            {
-                throw new InvalidOperationException("DeviceId not initialized");
-            }
-            return _deviceId;
-        }
-    }
-
-    private void EnsureDeviceId()
-    {
-        if (_isInitialized)
-        {
-            return;
-        }
-
-        _isInitialized = true;
-
-        try
-        {
-            var snapshot = _settingsFacade.Settings.LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App);
-
-            if (string.IsNullOrEmpty(snapshot.DeviceId))
-            {
-                snapshot.DeviceId = GenerateDeviceId();
-                _settingsFacade.Settings.SaveSnapshot(
-                    SettingsScope.App,
-                    snapshot,
-                    changedKeys: [nameof(AppSettingsSnapshot.DeviceId)]);
-                _deviceId = snapshot.DeviceId;
-                AppLogger.Info("DeviceId", $"Generated new device ID: {_deviceId}");
-            }
-            else
-            {
-                _deviceId = snapshot.DeviceId;
-                AppLogger.Info("DeviceId", $"Loaded existing device ID: {_deviceId}");
-            }
-        }
-        catch (Exception ex)
-        {
-            _deviceId = GenerateDeviceId();
-            AppLogger.Warn("DeviceId", $"Failed to persist device ID, using generated ID: {_deviceId}", ex);
-        }
-    }
-
-    private static string GenerateDeviceId()
-    {
-        var timestamp = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();
-        var deviceInfo = $"{Environment.MachineName}|{Environment.ProcessorCount}|{Environment.OSVersion}|{Environment.UserName}|{timestamp}";
-        using var sha = System.Security.Cryptography.SHA256.Create();
-        var hash = sha.ComputeHash(System.Text.Encoding.UTF8.GetBytes(deviceInfo));
-        return Convert.ToHexString(hash)[..32].ToLower();
-    }
-}
-
-public sealed class UserBehaviorAnalyticsService : IDisposable
-{
-    private const string PostHogApiKey = "phc_bhQZvKDDfsEdLT6kkRFvrWMT8Pc5aCGGsnxoc5ijSf9";
-    private const string PostHogHost = "https://us.i.posthog.com/capture/";
-
-    private bool _isEnabled;
-    private bool _isInitialized;
-    private readonly ISettingsFacadeService _settingsFacade;
-    private readonly DeviceIdService _deviceIdService;
-    private readonly Queue<UserBehaviorEvent> _eventQueue = new();
-    private readonly object _queueLock = new();
-    private System.Threading.Timer? _flushTimer;
-    private readonly PluginSdk.ISettingsService _settingsService;
-
-    public UserBehaviorAnalyticsService(ISettingsFacadeService settingsFacade, DeviceIdService deviceIdService)
-    {
-        _settingsFacade = settingsFacade ?? throw new ArgumentNullException(nameof(settingsFacade));
-        _settingsService = settingsFacade.Settings;
-        _deviceIdService = deviceIdService ?? throw new ArgumentNullException(nameof(deviceIdService));
-        _settingsService.Changed += OnSettingsChanged;
-    }
-
-    private void OnSettingsChanged(object? sender, PluginSdk.SettingsChangedEvent e)
-    {
-        if (e.Scope == PluginSdk.SettingsScope.App &&
-            e.ChangedKeys is not null &&
-            (e.ChangedKeys.Contains("UploadAnonymousCrashData") || e.ChangedKeys.Contains("UploadAnonymousUsageData")))
-        {
-            AppLogger.Info("UserBehaviorAnalytics", "Settings changed, refreshing enabled state.");
-            RefreshEnabledState();
-        }
-    }
-
-    public void Initialize()
-    {
-        if (_isInitialized)
-        {
-            return;
-        }
-
-        _isInitialized = true;
-        RefreshEnabledState();
-
-        try
-        {
-            _flushTimer = new System.Threading.Timer(
-                _ => FlushEvents(),
-                null,
-                TimeSpan.FromSeconds(10),
-                TimeSpan.FromSeconds(30));
-
-            CaptureEvent("app_online", new Dictionary<string, object>
-            {
-                { "event_type", "app_start" }
-            });
-
-            AppLogger.Info("UserBehaviorAnalytics", $"Analytics initialized. DeviceId={_deviceIdService.DeviceId}, Enabled={_isEnabled}");
-        }
-        catch (Exception ex)
-        {
-            AppLogger.Warn("UserBehaviorAnalytics", "Failed to initialize analytics.", ex);
-        }
-    }
-
-    public void TrackClick(string componentName, string? action = null)
-    {
-        if (!_isEnabled || !_isInitialized)
-        {
-            return;
-        }
-
-        CaptureEvent("ui_click", new Dictionary<string, object>
-        {
-            { "component", componentName },
-            { "action", action ?? "click" }
-        });
-    }
-
-    public void TrackComponentDrag(string componentId, string action)
-    {
-        if (!_isEnabled || !_isInitialized)
-        {
-            return;
-        }
-
-        CaptureEvent("component_drag", new Dictionary<string, object>
-        {
-            { "component_id", componentId },
-            { "action", action }
-        });
-    }
-
-    public void TrackComponentDrop(string componentId, string targetPosition)
-    {
-        if (!_isEnabled || !_isInitialized)
-        {
-            return;
-        }
-
-        CaptureEvent("component_drop", new Dictionary<string, object>
-        {
-            { "component_id", componentId },
-            { "target_position", targetPosition }
-        });
-    }
-
-    public void TrackSettingsOpen(string settingsPage)
-    {
-        if (!_isEnabled || !_isInitialized)
-        {
-            return;
-        }
-
-        CaptureEvent("settings_open", new Dictionary<string, object>
-        {
-            { "page", settingsPage }
-        });
-    }
-
-    public void TrackSettingsChange(string settingsPage, string settingKey, string? oldValue, string newValue)
-    {
-        if (!_isEnabled || !_isInitialized)
-        {
-            return;
-        }
-
-        CaptureEvent("settings_change", new Dictionary<string, object>
-        {
-            { "page", settingsPage },
-            { "key", settingKey },
-            { "old_value", oldValue ?? "" },
-            { "new_value", newValue }
-        });
-    }
-
-    public void TrackSettingsClose(string settingsPage)
-    {
-        if (!_isEnabled || !_isInitialized)
-        {
-            return;
-        }
-
-        CaptureEvent("settings_close", new Dictionary<string, object>
-        {
-            { "page", settingsPage }
-        });
-    }
-
-    public void TrackUpdateAction(string action, string? version = null)
-    {
-        if (!_isEnabled || !_isInitialized)
-        {
-            return;
-        }
-
-        var props = new Dictionary<string, object>
-        {
-            { "action", action }
-        };
-
-        if (version is not null)
-        {
-            props["version"] = version;
-        }
-
-        CaptureEvent("update_action", props);
-    }
-
-    public void TrackRestartAction(string action)
-    {
-        if (!_isEnabled || !_isInitialized)
-        {
-            return;
-        }
-
-        CaptureEvent("restart_action", new Dictionary<string, object>
-        {
-            { "action", action }
-        });
-    }
-
-    public void TrackNavigation(string fromPage, string toPage)
-    {
-        if (!_isEnabled || !_isInitialized)
-        {
-            return;
-        }
-
-        CaptureEvent("navigation", new Dictionary<string, object>
-        {
-            { "from", fromPage },
-            { "to", toPage }
-        });
-    }
-
-    public void SendCrashEvent()
-    {
-        if (!_isInitialized)
-        {
-            return;
-        }
-
-        try
-        {
-            var properties = new Dictionary<string, object>
-            {
-                { "app_version", GetAppVersion() },
-                { "event_time", DateTimeOffset.UtcNow.ToString("o") },
-                { "event_type", "app_crash" }
-            };
-
-            CaptureEvent("app_crash", properties);
-            FlushEvents();
-
-            AppLogger.Info("UserBehaviorAnalytics", $"Crash event sent. DeviceId={_deviceIdService.DeviceId}");
-        }
-        catch (Exception ex)
-        {
-            AppLogger.Warn("UserBehaviorAnalytics", "Failed to send crash event.", ex);
-        }
-    }
-
-    public void SendShutdownEvent()
-    {
-        if (!_isInitialized)
-        {
-            return;
-        }
-
-        try
-        {
-            var properties = new Dictionary<string, object>
-            {
-                { "app_version", GetAppVersion() },
-                { "event_time", DateTimeOffset.UtcNow.ToString("o") },
-                { "event_type", "app_shutdown" }
-            };
-
-            if (_isEnabled)
-            {
-                properties["os_name"] = GetOsName();
-                properties["os_version"] = GetOsVersion();
-                properties["device_name"] = GetDeviceName();
-                properties["device_model"] = GetDeviceModel();
-                properties["device_arch"] = GetDeviceArchitecture();
-                properties["language"] = GetSystemLanguage();
-            }
-
-            CaptureEvent("app_shutdown", properties);
-            FlushEvents();
-
-            AppLogger.Info("UserBehaviorAnalytics", $"Shutdown event sent. DeviceId={_deviceIdService.DeviceId}");
-        }
-        catch (Exception ex)
-        {
-            AppLogger.Warn("UserBehaviorAnalytics", "Failed to send shutdown event.", ex);
-        }
-    }
-
-    public void RefreshEnabledState()
-    {
-        try
-        {
-            var snapshot = _settingsFacade.Settings.LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App);
-            var newEnabled = snapshot.UploadAnonymousUsageData;
-
-            if (_isEnabled != newEnabled)
-            {
-                _isEnabled = newEnabled;
-                AppLogger.Info("UserBehaviorAnalytics", $"User behavior analytics enabled state changed to '{_isEnabled}'.");
-
-                if (_isEnabled && _isInitialized)
-                {
-                    CaptureEvent("analytics_enabled", new Dictionary<string, object>());
-                }
-            }
-        }
-        catch (Exception ex)
-        {
-            AppLogger.Warn("UserBehaviorAnalytics", "Failed to refresh analytics enabled state.", ex);
-            _isEnabled = false;
-        }
-    }
-
-    public void CaptureEvent(string eventName, Dictionary<string, object>? properties = null)
-    {
-        if (!_isInitialized)
-        {
-            return;
-        }
-
-        try
-        {
-            var eventData = new UserBehaviorEvent
-            {
-                Event = eventName,
-                DistinctId = _deviceIdService.DeviceId,
-                Timestamp = DateTimeOffset.UtcNow,
-                Properties = properties ?? new Dictionary<string, object>(),
-                IncludeDetailedData = _isEnabled
-            };
-
-            lock (_queueLock)
-            {
-                _eventQueue.Enqueue(eventData);
-
-                if (_eventQueue.Count >= 20)
-                {
-                    FlushEvents();
-                }
-            }
-        }
-        catch (Exception ex)
-        {
-            AppLogger.Warn("UserBehaviorAnalytics", $"Failed to capture event '{eventName}'.", ex);
-        }
-    }
-
-    public void CapturePageView(string pageName, string? sourcePage = null)
-    {
-        var properties = new Dictionary<string, object>
-        {
-            { "page_name", pageName }
-        };
-
-        if (!string.IsNullOrEmpty(sourcePage))
-        {
-            properties["source_page"] = sourcePage;
-        }
-
-        CaptureEvent("page_view", properties);
-    }
-
-    public void CaptureFeatureUsage(string featureName, string action)
-    {
-        CaptureEvent("feature_usage", new Dictionary<string, object>
-        {
-            { "feature_name", featureName },
-            { "action", action }
-        });
-    }
-
-    private void FlushEvents()
-    {
-        List<UserBehaviorEvent> eventsToSend;
-
-        lock (_queueLock)
-        {
-            if (_eventQueue.Count == 0)
-            {
-                return;
-            }
-
-            eventsToSend = new List<UserBehaviorEvent>();
-            while (_eventQueue.Count > 0 && eventsToSend.Count < 20)
-            {
-                eventsToSend.Add(_eventQueue.Dequeue());
-            }
-        }
-
-        try
-        {
-            SendEventsToPostHog(eventsToSend);
-        }
-        catch (Exception ex)
-        {
-            AppLogger.Warn("UserBehaviorAnalytics", "Failed to send events to PostHog.", ex);
-
-            lock (_queueLock)
-            {
-                foreach (var evt in eventsToSend)
-                {
-                    if (_eventQueue.Count < 100)
-                    {
-                        _eventQueue.Enqueue(evt);
-                    }
-                }
-            }
-        }
-    }
-
-    private void SendEventsToPostHog(List<UserBehaviorEvent> events)
-    {
-        try
-        {
-            using var client = new System.Net.Http.HttpClient
-            {
-                Timeout = TimeSpan.FromSeconds(10)
-            };
-
-            var firstEvent = events.FirstOrDefault();
-            if (firstEvent is not null)
-            {
-                SendIdentifyToPostHog(client, firstEvent.DistinctId);
-            }
-
-            foreach (var e in events)
-            {
-                var properties = new Dictionary<string, object>
-                {
-                    { "distinct_id", e.DistinctId }
-                };
-
-                if (e.IncludeDetailedData)
-                {
-                    properties["$os"] = GetOsName();
-                    properties["$os_version"] = GetOsVersion();
-                    properties["$app_version"] = GetAppVersion();
-                    properties["$device_id"] = e.DistinctId;
-                }
-
-                foreach (var kvp in e.Properties)
-                {
-                    properties[kvp.Key] = kvp.Value;
-                }
-
-                var requestBody = new Dictionary<string, object>
-                {
-                    { "api_key", PostHogApiKey },
-                    { "event", e.Event },
-                    { "timestamp", e.Timestamp.ToString("o") },
-                    { "properties", properties }
-                };
-
-                var json = JsonSerializer.Serialize(requestBody);
-                var bytes = Encoding.UTF8.GetBytes(json);
-
-                var content = new System.Net.Http.ByteArrayContent(bytes);
-                content.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue("application/json");
-
-                var response = client.PostAsync(PostHogHost, content).GetAwaiter().GetResult();
-                var responseBody = response.Content.ReadAsStringAsync().GetAwaiter().GetResult();
-
-                if (!response.IsSuccessStatusCode)
-                {
-                    AppLogger.Warn("UserBehaviorAnalytics", $"PostHog API error for event '{e.Event}': {response.StatusCode} - {responseBody}");
-                }
-            }
-
-            AppLogger.Info("UserBehaviorAnalytics", $"Successfully sent {events.Count} events to PostHog.");
-        }
-        catch (Exception ex)
-        {
-            AppLogger.Warn("UserBehaviorAnalytics", "Failed to send events to PostHog API.", ex);
-        }
-    }
-
-    private void SendIdentifyToPostHog(System.Net.Http.HttpClient client, string distinctId)
-    {
-        try
-        {
-            var userProperties = new Dictionary<string, object>
-            {
-                { "$device_id", distinctId },
-                { "$app_version", GetAppVersion() },
-                { "$os", GetOsName() },
-                { "$os_version", GetOsVersion() }
-            };
-
-            var requestBody = new Dictionary<string, object>
-            {
-                { "api_key", PostHogApiKey },
-                { "event", "$identify" },
-                { "timestamp", DateTimeOffset.UtcNow.ToString("o") },
-                { "properties", new Dictionary<string, object>
-                    {
-                        { "distinct_id", distinctId },
-                        { "$set", userProperties }
-                    }
-                }
-            };
-
-            var json = JsonSerializer.Serialize(requestBody);
-            var bytes = Encoding.UTF8.GetBytes(json);
-
-            var content = new System.Net.Http.ByteArrayContent(bytes);
-            content.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue("application/json");
-
-            var response = client.PostAsync(PostHogHost, content).GetAwaiter().GetResult();
-            var responseBody = response.Content.ReadAsStringAsync().GetAwaiter().GetResult();
-
-            AppLogger.Info("UserBehaviorAnalytics", $"PostHog identify response: {response.StatusCode}");
-
-            if (!response.IsSuccessStatusCode)
-            {
-                AppLogger.Warn("UserBehaviorAnalytics", $"PostHog identify failed: {response.StatusCode} - {responseBody}");
-            }
-        }
-        catch (Exception ex)
-        {
-            AppLogger.Warn("UserBehaviorAnalytics", "Failed to send identify to PostHog.", ex);
-        }
-    }
-
-    private static Dictionary<string, object> GetEventProperties(UserBehaviorEvent e)
-    {
-        var props = new Dictionary<string, object>
-        {
-            { "$os", GetOsName() },
-            { "$os_version", GetOsVersion() },
-            { "$app_version", GetAppVersion() },
-            { "$device_id", e.DistinctId }
-        };
-
-        foreach (var kvp in e.Properties)
-        {
-            props[kvp.Key] = kvp.Value;
-        }
-
-        return props;
-    }
-
-    public bool IsEnabled => _isEnabled;
-
-    public string DeviceId => _deviceIdService.DeviceId;
-
-    private static string GetAppVersion()
-    {
-        var assembly = typeof(UserBehaviorAnalyticsService).Assembly;
-        var version = assembly.GetName().Version;
-        return version is null ? "1.0.0" : $"{version.Major}.{version.Minor}.{version.Build}";
-    }
-
-    private static string GetOsName()
-    {
-        if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows)) return "Windows";
-        if (RuntimeInformation.IsOSPlatform(OSPlatform.Linux)) return "Linux";
-        if (RuntimeInformation.IsOSPlatform(OSPlatform.OSX)) return "macOS";
-        return "Unknown";
-    }
-
-    private static string GetOsVersion()
-    {
-        try { return Environment.OSVersion.VersionString ?? "Unknown"; }
-        catch { return "Unknown"; }
-    }
-
-    private static string GetDeviceName()
-    {
-        try { return Environment.MachineName ?? "Unknown"; }
-        catch { return "Unknown"; }
-    }
-
-    private static string GetDeviceModel()
-    {
-        var osDesc = RuntimeInformation.OSDescription;
-        if (osDesc.Contains("Windows")) return "Windows PC";
-        if (osDesc.Contains("Linux")) return "Linux PC";
-        if (osDesc.Contains("Darwin")) return "Mac";
-        return osDesc;
-    }
-
-    private static string GetDeviceArchitecture()
-    {
-        return RuntimeInformation.OSArchitecture.ToString();
-    }
-
-    private static string GetSystemLanguage()
-    {
-        try { return System.Globalization.CultureInfo.CurrentUICulture.Name ?? "en-US"; }
-        catch { return "en-US"; }
-    }
-
-    private static string GetOsBuild()
-    {
-        try { return Environment.OSVersion.Version.Build.ToString() ?? "Unknown"; }
-        catch { return "Unknown"; }
-    }
-
-    private static int GetProcessorCount()
-    {
-        return Environment.ProcessorCount;
-    }
-
-    private static long GetTotalMemoryMB()
-    {
-        try { return GC.GetGCMemoryInfo().TotalAvailableMemoryBytes / (1024 * 1024); }
-        catch { return 0; }
-    }
-
-    private static string GetRuntimeVersion()
-    {
-        return Environment.Version.ToString();
-    }
-
-    private static string GetClrVersion()
-    {
-        return Environment.Version.ToString();
-    }
-
-    private static string GetDotNetVersion()
-    {
-        return Environment.Version.ToString();
-    }
-
-    public void Dispose()
-    {
-        try
-        {
-            _flushTimer?.Dispose();
-            FlushEvents();
-        }
-        catch (Exception ex)
-        {
-            AppLogger.Warn("UserBehaviorAnalytics", "Error disposing analytics service.", ex);
-        }
-    }
-
-    private class UserBehaviorEvent
-    {
-        public string Event { get; set; } = string.Empty;
-        public string DistinctId { get; set; } = string.Empty;
-        public DateTimeOffset Timestamp { get; set; }
-        public Dictionary<string, object> Properties { get; set; } = new();
-        public bool IncludeDetailedData { get; set; }
-    }
-}
-
-public static class DictionaryExtensions
-{
-    public static Dictionary<string, object> Merge(this Dictionary<string, object> first, Dictionary<string, object> second)
-    {
-        var result = new Dictionary<string, object>(first);
-        foreach (var kvp in second)
-        {
-            result[kvp.Key] = kvp.Value;
-        }
-        return result;
-    }
-}
-
-public sealed class CrashReportService
-{
-    private const string SentryDsn = "https://f2aad3a1c63b5f2213ad82683ce93c06@o4511049423257600.ingest.us.sentry.io/4511049425813504";
-
-    private bool _isInitialized;
-    private bool _isEnabled;
-    private readonly ISettingsFacadeService _settingsFacade;
-    private readonly DeviceIdService _deviceIdService;
-    private readonly PluginSdk.ISettingsService _settingsService;
-
-    public CrashReportService(ISettingsFacadeService settingsFacade, DeviceIdService deviceIdService)
-    {
-        _settingsFacade = settingsFacade ?? throw new ArgumentNullException(nameof(settingsFacade));
-        _settingsService = settingsFacade.Settings;
-        _deviceIdService = deviceIdService ?? throw new ArgumentNullException(nameof(deviceIdService));
-        _settingsService.Changed += OnSettingsChanged;
-    }
-
-    private void OnSettingsChanged(object? sender, PluginSdk.SettingsChangedEvent e)
-    {
-        if (e.Scope == PluginSdk.SettingsScope.App &&
-            e.ChangedKeys is not null &&
-            (e.ChangedKeys.Contains("UploadAnonymousCrashData") || e.ChangedKeys.Contains("UploadAnonymousUsageData")))
-        {
-            AppLogger.Info("CrashReport", "Settings changed, refreshing enabled state.");
-            RefreshEnabledState();
-        }
-    }
-
-    public void RefreshEnabledState()
-    {
-        try
-        {
-            var snapshot = _settingsFacade.Settings.LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App);
-            var newEnabled = snapshot.UploadAnonymousCrashData;
-
-            if (_isEnabled != newEnabled)
-            {
-                _isEnabled = newEnabled;
-                AppLogger.Info("CrashReport", $"Crash reporting enabled state changed to '{_isEnabled}'.");
-
-                if (_isEnabled && !_isInitialized)
-                {
-                    InitializeSentry();
-                }
-            }
-        }
-        catch (Exception ex)
-        {
-            AppLogger.Warn("CrashReport", "Failed to refresh crash reporting enabled state.", ex);
-            _isEnabled = false;
-        }
-    }
-
-    private void InitializeSentry()
-    {
-        if (_isInitialized)
-        {
-            return;
-        }
-
-        _isInitialized = true;
-
-        try
-        {
-            SentrySdk.Init(options =>
-            {
-                options.Dsn = SentryDsn;
-                options.AutoSessionTracking = true;
-                options.AttachStacktrace = true;
-                options.MaxBreadcrumbs = 100;
-                options.Release = GetAppVersion();
-                options.Environment = GetEnvironment();
-            });
-
-            ConfigureCrashReportingScope();
-
-            AppLogger.Info("CrashReport", $"Sentry crash reporting initialized. DeviceId={_deviceIdService.DeviceId}");
-
-#if DEBUG
-            SentrySdk.CaptureMessage($"Crash reporting enabled - Debug mode test. DeviceId={_deviceIdService.DeviceId}");
-#endif
-        }
-        catch (Exception ex)
-        {
-            AppLogger.Warn("CrashReport", "Failed to initialize Sentry crash reporting.", ex);
-            _isInitialized = false;
-        }
-    }
-
-    private void ConfigureCrashReportingScope()
-    {
-        try
-        {
-            SentrySdk.ConfigureScope(scope =>
-            {
-                scope.User = new SentryUser
-                {
-                    Id = _deviceIdService.DeviceId
-                };
-
-                scope.SetTag("data_type", "crash_report");
-                scope.SetTag("device_id", _deviceIdService.DeviceId);
-                scope.SetTag("device_name", GetDeviceName());
-                scope.SetTag("device_model", GetDeviceModel());
-                scope.SetTag("device_arch", GetDeviceArchitecture());
-                scope.SetTag("os_name", GetOsName());
-                scope.SetTag("os_version", GetOsVersion());
-                scope.SetTag("language", GetSystemLanguage());
-            });
-
-            AppLogger.Info("CrashReport", $"Crash reporting scope configured. DeviceId={_deviceIdService.DeviceId}");
-        }
-        catch (Exception ex)
-        {
-            AppLogger.Warn("CrashReport", "Failed to configure crash reporting scope.", ex);
-        }
-    }
-
-    public bool IsEnabled => _isEnabled;
-
-    public string DeviceId => _deviceIdService.DeviceId;
-
-    public void SendShutdownEvent()
-    {
-        try
-        {
-            if (_isEnabled && _isInitialized)
-            {
-                AppLogger.Info("CrashReport", $"Shutdown event will be sent via Sentry. DeviceId={_deviceIdService.DeviceId}");
-                return;
-            }
-
-            if (!_isInitialized)
-            {
-                SentrySdk.Init(options =>
-                {
-                    options.Dsn = SentryDsn;
-                    options.AutoSessionTracking = false;
-                    options.Release = GetAppVersion();
-                    options.Environment = GetEnvironment();
-                });
-            }
-
-            SentrySdk.ConfigureScope(scope =>
-            {
-                scope.User = new SentryUser
-                {
-                    Id = _deviceIdService.DeviceId
-                };
-                scope.SetTag("data_type", "shutdown");
-                scope.SetTag("device_id", _deviceIdService.DeviceId);
-                scope.SetTag("app_version", GetAppVersion());
-            });
-
-            SentrySdk.CaptureMessage($"app_shutdown - DeviceId={_deviceIdService.DeviceId}");
-            SentrySdk.Flush(TimeSpan.FromSeconds(3));
-
-            AppLogger.Info("CrashReport", $"Shutdown event sent. DeviceId={_deviceIdService.DeviceId}");
-        }
-        catch (Exception ex)
-        {
-            AppLogger.Warn("CrashReport", "Failed to send shutdown event.", ex);
-        }
-    }
-
-    private static string GetDeviceName()
-    {
-        try { return Environment.MachineName ?? "Unknown"; }
-        catch { return "Unknown"; }
-    }
-
-    private static string GetDeviceModel()
-    {
-        var osDesc = RuntimeInformation.OSDescription;
-        if (osDesc.Contains("Windows")) return "Windows PC";
-        if (osDesc.Contains("Linux")) return "Linux PC";
-        if (osDesc.Contains("Darwin")) return "Mac";
-        return osDesc;
-    }
-
-    private static string GetDeviceArchitecture()
-    {
-        return RuntimeInformation.OSArchitecture.ToString();
-    }
-
-    private static string GetOsName()
-    {
-        if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows)) return "Windows";
-        if (RuntimeInformation.IsOSPlatform(OSPlatform.Linux)) return "Linux";
-        if (RuntimeInformation.IsOSPlatform(OSPlatform.OSX)) return "macOS";
-        return "Unknown";
-    }
-
-    private static string GetOsVersion()
-    {
-        try { return Environment.OSVersion.VersionString ?? "Unknown"; }
-        catch { return "Unknown"; }
-    }
-
-    private static string GetSystemLanguage()
-    {
-        try { return System.Globalization.CultureInfo.CurrentUICulture.Name ?? "en-US"; }
-        catch { return "en-US"; }
-    }
-
-    private static string GetAppVersion()
-    {
-        var version = typeof(CrashReportService).Assembly.GetName().Version;
-        return version is null ? "1.0.0" : $"{version.Major}.{version.Minor}.{version.Build}";
-    }
-
-    private static string GetEnvironment()
-    {
-#if DEBUG
-        return "development";
-#else
-        return "production";
-#endif
-    }
-}

LanMountainDesktop/Services/DesktopComponentEditorRegistryFactory.cs

@@ -72,6 +72,18 @@ public static class DesktopComponentEditorRegistryFactory
             [BuiltInComponentIds.DesktopStudyEnvironment] = new(
                 BuiltInComponentIds.DesktopStudyEnvironment,
                 context => new StudyEnvironmentComponentEditor(context)),
+            [BuiltInComponentIds.DesktopRemovableStorage] = new(
+                BuiltInComponentIds.DesktopRemovableStorage,
+                context => new RemovableStorageComponentEditor(context)),
+            [BuiltInComponentIds.DesktopWhiteboard] = new(
+                BuiltInComponentIds.DesktopWhiteboard,
+                context => new WhiteboardComponentEditor(context)),
+            [BuiltInComponentIds.DesktopBlackboardLandscape] = new(
+                BuiltInComponentIds.DesktopBlackboardLandscape,
+                context => new WhiteboardComponentEditor(context)),
+            [BuiltInComponentIds.DesktopOfficeRecentDocuments] = new(
+                BuiltInComponentIds.DesktopOfficeRecentDocuments,
+                context => new OfficeRecentDocumentsComponentEditor(context)),
             [BuiltInComponentIds.DesktopWeather] = CreateWeatherRegistration(BuiltInComponentIds.DesktopWeather),
             [BuiltInComponentIds.DesktopWeatherClock] = CreateWeatherRegistration(BuiltInComponentIds.DesktopWeatherClock),
             [BuiltInComponentIds.DesktopHourlyWeather] = CreateWeatherRegistration(BuiltInComponentIds.DesktopHourlyWeather),

LanMountainDesktop/Services/DesktopComponentRegistryFactory.cs

@@ -9,6 +9,7 @@ using Avalonia.Layout;
 using Avalonia.Media;
 using LanMountainDesktop.ComponentSystem;
 using LanMountainDesktop.ComponentSystem.Extensions;
+using LanMountainDesktop.Host.Abstractions;
 using LanMountainDesktop.PluginSdk;
 using LanMountainDesktop.Services.Settings;
 using LanMountainDesktop.Views.Components;
@@ -62,7 +63,11 @@ public static class DesktopComponentRegistryFactory
                     registration.ComponentId,
                     registration.DisplayNameLocalizationKey,
                     factoryContext => CreatePluginControl(contribution, factoryContext),
-                    registration.CornerRadiusResolver));
+                    chromeContext =>
+                    {
+                        var appearanceContext = CreatePluginAppearanceContext(chromeContext);
+                        return registration.ResolveCornerRadius(appearanceContext, chromeContext.CellSize);
+                    }));
             }
         }
 
@@ -122,6 +127,11 @@ public static class DesktopComponentRegistryFactory
             var pluginSettings = new PluginScopedSettingsService(
                 contribution.Plugin.Manifest.Id,
                 settingsService);
+            var appearanceSnapshot = HostAppearanceThemeProvider.GetOrCreate().GetCurrent();
+            var pluginAppearance = new PluginAppearanceContext(new PluginAppearanceSnapshot(
+                GlobalCornerRadiusScale: appearanceSnapshot.GlobalCornerRadiusScale,
+                CornerRadiusTokens: PluginCornerRadiusTokens.FromShared(appearanceSnapshot.CornerRadiusTokens),
+                ThemeVariant: appearanceSnapshot.IsNightMode ? "Dark" : "Light"));
             var pluginContext = new PluginDesktopComponentContext(
                 contribution.Plugin.Manifest,
                 contribution.Plugin.Context.PluginDirectory,
@@ -131,6 +141,7 @@ public static class DesktopComponentRegistryFactory
                 contribution.Registration.ComponentId,
                 context.PlacementId,
                 context.CellSize,
+                pluginAppearance,
                 pluginSettings);
 
             return contribution.Registration.ControlFactory(contribution.Plugin.Services, pluginContext);
@@ -143,6 +154,14 @@ public static class DesktopComponentRegistryFactory
         }
     }
 
+    private static IPluginAppearanceContext CreatePluginAppearanceContext(ComponentChromeContext chromeContext)
+    {
+        return new PluginAppearanceContext(new PluginAppearanceSnapshot(
+            GlobalCornerRadiusScale: chromeContext.GlobalCornerRadiusScale,
+            CornerRadiusTokens: PluginCornerRadiusTokens.FromShared(chromeContext.CornerRadiusTokens),
+            ThemeVariant: "Unknown"));
+    }
+
     private static Control CreatePluginErrorControl(
         PluginDesktopComponentContribution contribution,
         Exception exception)

LanMountainDesktop/Services/IComponentLibraryService.cs

@@ -20,6 +20,7 @@ public sealed record ComponentLibraryCategoryEntry(
 
 public sealed record ComponentLibraryCreateContext(
     double CellSize,
+    double GlobalCornerRadiusScale,
     TimeZoneService TimeZoneService,
     IWeatherInfoService WeatherInfoService,
     IRecommendationInfoService RecommendationInfoService,

LanMountainDesktop/Services/IWhiteboardNotePersistenceService.cs

@@ -0,0 +1,19 @@
+using System;
+using LanMountainDesktop.Models;
+
+namespace LanMountainDesktop.Services;
+
+public interface IWhiteboardNotePersistenceService
+{
+    WhiteboardNoteSnapshot LoadNote(string componentId, string? placementId, int retentionDays);
+
+    void SaveNote(string componentId, string? placementId, WhiteboardNoteSnapshot snapshot, int retentionDays);
+
+    bool DeleteNote(string componentId, string? placementId);
+
+    bool TryDeleteExpiredNote(string componentId, string? placementId, int retentionDays);
+
+    bool IsExpired(WhiteboardNoteSnapshot snapshot, int retentionDays, DateTimeOffset? now = null);
+
+    DateTimeOffset? GetExpirationUtc(WhiteboardNoteSnapshot snapshot, int retentionDays);
+}

LanMountainDesktop/Services/LocalizationService.cs

@@ -1,6 +1,7 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.IO;
+using System.Reflection;
 using System.Text.Json;
 
 namespace LanMountainDesktop.Services;
@@ -16,6 +17,23 @@ public sealed class LocalizationService
     private readonly Dictionary<string, Dictionary<string, string>> _cache =
         new(StringComparer.OrdinalIgnoreCase);
 
+    /// <summary>
+    /// 清除指定语言代码的缓存，强制下次重新加载。
+    /// 在语言切换时调用此方法以确保加载最新的语言文件。
+    /// </summary>
+    public void ClearCache(string? languageCode = null)
+    {
+        if (string.IsNullOrWhiteSpace(languageCode))
+        {
+            _cache.Clear();
+        }
+        else
+        {
+            var normalizedCode = NormalizeLanguageCode(languageCode);
+            _cache.Remove(normalizedCode);
+        }
+    }
+
     public string NormalizeLanguageCode(string? languageCode)
     {
         return string.Equals(languageCode, "en-US", StringComparison.OrdinalIgnoreCase)
@@ -42,14 +60,17 @@ public sealed class LocalizationService
         var result = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
         try
         {
-            var filePath = Path.Combine(AppContext.BaseDirectory, "Localization", $"{languageCode}.json");
+            var json = TryLoadFromFileSystem(languageCode);
-            if (File.Exists(filePath))
+            if (string.IsNullOrEmpty(json))
+            {
+                json = TryLoadFromEmbeddedResource(languageCode);
+            }
+
+            if (!string.IsNullOrEmpty(json))
             {
-                var json = File.ReadAllText(filePath);
-                // Defensive: tolerate accidentally duplicated UTF-8 BOM characters at file start.
                 json = json.TrimStart('\uFEFF');
                 var data = JsonSerializer.Deserialize<Dictionary<string, string>>(json, JsonOptions);
-                if (data is not null)
+                if (data is not null && data.Count > 0)
                 {
                     result = new Dictionary<string, string>(data, StringComparer.OrdinalIgnoreCase);
                 }
@@ -60,7 +81,48 @@ public sealed class LocalizationService
             // Keep empty table for resilience.
         }
 
-        _cache[languageCode] = result;
+        // 只有当语言表非空时才缓存，这样如果加载失败可以下次重试
+        if (result.Count > 0)
+        {
+            _cache[languageCode] = result;
+        }
         return result;
     }
+
+    private string? TryLoadFromFileSystem(string languageCode)
+    {
+        try
+        {
+            var filePath = Path.Combine(AppContext.BaseDirectory, "Localization", $"{languageCode}.json");
+            if (File.Exists(filePath))
+            {
+                return File.ReadAllText(filePath);
+            }
+        }
+        catch
+        {
+            // Continue to next method
+        }
+        return null;
+    }
+
+    private string? TryLoadFromEmbeddedResource(string languageCode)
+    {
+        try
+        {
+            var assembly = Assembly.GetExecutingAssembly();
+            var resourceName = $"LanMountainDesktop.Localization.{languageCode}.json";
+            using var stream = assembly.GetManifestResourceStream(resourceName);
+            if (stream != null)
+            {
+                using var reader = new StreamReader(stream);
+                return reader.ReadToEnd();
+            }
+        }
+        catch
+        {
+            // Continue to next method
+        }
+        return null;
+    }
 }

LanMountainDesktop/Services/OfficeRecentDocumentsService.cs

@@ -1,18 +1,25 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
+using System.Globalization;
 using System.IO;
 using System.Linq;
 using System.Runtime.InteropServices;
+using System.Runtime.Versioning;
 using System.Text;
-using System.Text.Json;
+using System.Text.RegularExpressions;
-using LanMountainDesktop.Services.Settings;
+using System.Threading;
+using LanMountainDesktop.Models;
+using Microsoft.Win32;
+using MudTools.OfficeInterop;
+using MudTools.OfficeInterop.Excel;
+using MudTools.OfficeInterop.Word;
 
 namespace LanMountainDesktop.Services;
 
 public interface IOfficeRecentDocumentsService
 {
-    List<OfficeRecentDocument> GetRecentDocuments(int maxCount = 20);
+    List<OfficeRecentDocument> GetRecentDocuments(int maxCount = 20, IReadOnlyCollection<string>? enabledSources = null);
     void OpenDocument(string filePath);
 }
 
@@ -24,78 +31,67 @@ public sealed class OfficeRecentDocument
     public DateTime LastModifiedTime { get; set; }
     public long FileSizeBytes { get; set; }
     public string IconGlyph { get; set; } = string.Empty;
+    internal DateTime? RecentAccessTime { get; set; }
+    internal int SourcePriority { get; set; }
+    internal int SourceOrder { get; set; }
 }
 
 public sealed class OfficeRecentDocumentsService : IOfficeRecentDocumentsService
 {
+    private const string LogCategory = "OfficeRecentDocs";
     private static readonly string[] OfficeExtensions = { ".doc", ".docx", ".dot", ".dotx", ".rtf" };
     private static readonly string[] ExcelExtensions = { ".xls", ".xlsx", ".xlsm", ".xlsb", ".csv" };
     private static readonly string[] PowerPointExtensions = { ".ppt", ".pptx", ".pptm", ".pps", ".ppsx" };
+    private static readonly Regex OfficeFilePathRegex = new(
+        @"(?:[A-Z]:\\|\\\\)[^\x00-\x1F""<>|]+?\.(?:docx?|dotx?|rtf|xlsx?|xlsm|xlsb|csv|pptx?|pptm|ppsx?)",
+        RegexOptions.IgnoreCase | RegexOptions.Compiled);
+    private static readonly Regex OfficeMruTimestampRegex = new(
+        @"\[T(?<filetime>[0-9A-F]+)\]",
+        RegexOptions.IgnoreCase | RegexOptions.Compiled);
 
-    public List<OfficeRecentDocument> GetRecentDocuments(int maxCount = 20)
+    public List<OfficeRecentDocument> GetRecentDocuments(int maxCount = 20, IReadOnlyCollection<string>? enabledSources = null)
     {
         var documents = new List<OfficeRecentDocument>();
-        var recentPaths = GetRecentFolders();
+        var normalizedSources = OfficeRecentDocumentSourceTypes.NormalizeValues(
+            enabledSources,
+            useDefaultWhenEmpty: enabledSources is null);
 
-        foreach (var recentPath in recentPaths)
+        if (!OperatingSystem.IsWindows() || normalizedSources.Count == 0)
         {
-            if (!Directory.Exists(recentPath))
+            return documents;
-            {
+        }
-                continue;
-            }
 
-            try
+        var useRegistry = normalizedSources.Contains(OfficeRecentDocumentSourceTypes.Registry, StringComparer.OrdinalIgnoreCase);
-            {
+        var useRecentFolders = normalizedSources.Contains(OfficeRecentDocumentSourceTypes.RecentFolders, StringComparer.OrdinalIgnoreCase);
-                var files = Directory.GetFiles(recentPath, "*.lnk");
+        var useJumpLists = normalizedSources.Contains(OfficeRecentDocumentSourceTypes.JumpLists, StringComparer.OrdinalIgnoreCase);
-                foreach (var lnkPath in files)
-                {
-                    var targetPath = GetShortcutTarget(lnkPath);
-                    if (string.IsNullOrEmpty(targetPath))
-                    {
-                        continue;
-                    }
 
-                    var extension = Path.GetExtension(targetPath).ToLowerInvariant();
+        if (useRegistry)
-                    if (!IsOfficeFile(extension))
+        {
-                    {
+            TryGetFromRegistry(documents);
-                        continue;
+        }
-                    }
 
-                    if (!System.IO.File.Exists(targetPath))
+        if (useRecentFolders)
-                    {
+        {
-                        continue;
+            TryGetFromRecentFolders(documents);
-                    }
+        }
 
-                    try
+        if (useJumpLists)
-                    {
+        {
-                        var fileInfo = new FileInfo(targetPath);
+            TryGetFromJumpLists(documents);
-                        var doc = new OfficeRecentDocument
+        }
-                        {
-                            FileName = Path.GetFileNameWithoutExtension(targetPath),
-                            FilePath = targetPath,
-                            Extension = extension,
-                            LastModifiedTime = fileInfo.LastWriteTime,
-                            FileSizeBytes = fileInfo.Length,
-                            IconGlyph = GetIconGlyph(extension)
-                        };
 
-                        if (!documents.Any(d => d.FilePath == targetPath))
+        if (useRegistry && documents.Count < maxCount)
-                        {
+        {
-                            documents.Add(doc);
+            TryGetFromMudToolsInterop(documents);
-                        }
-                    }
-                    catch
-                    {
-                    }
-                }
-            }
-            catch
-            {
-            }
         }
 
         return documents
-            .OrderByDescending(d => d.LastModifiedTime)
+            .GroupBy(d => d.FilePath, StringComparer.OrdinalIgnoreCase)
+            .Select(MergeDocuments)
+            .OrderByDescending(d => d.RecentAccessTime ?? DateTime.MinValue)
+            .ThenBy(d => d.SourcePriority)
+            .ThenBy(d => d.SourceOrder)
+            .ThenByDescending(d => d.LastModifiedTime)
             .Take(maxCount)
             .ToList();
     }
@@ -109,30 +105,587 @@ public sealed class OfficeRecentDocumentsService : IOfficeRecentDocumentsService
                 FileName = filePath,
                 UseShellExecute = true
             };
+
             Process.Start(startInfo);
         }
+        catch (Exception ex)
+        {
+            AppLogger.Warn(LogCategory, $"Failed to open Office document '{filePath}'.", ex);
+        }
+    }
+
+    private static OfficeRecentDocument MergeDocuments(IGrouping<string, OfficeRecentDocument> group)
+    {
+        var preferred = group
+            .OrderByDescending(d => d.RecentAccessTime ?? DateTime.MinValue)
+            .ThenBy(d => d.SourcePriority)
+            .ThenBy(d => d.SourceOrder)
+            .ThenByDescending(d => d.LastModifiedTime)
+            .First();
+
+        return new OfficeRecentDocument
+        {
+            FileName = preferred.FileName,
+            FilePath = preferred.FilePath,
+            Extension = preferred.Extension,
+            LastModifiedTime = group.Max(d => d.LastModifiedTime),
+            FileSizeBytes = preferred.FileSizeBytes,
+            IconGlyph = preferred.IconGlyph,
+            RecentAccessTime = group
+                .Where(d => d.RecentAccessTime.HasValue)
+                .Select(d => d.RecentAccessTime)
+                .Max(),
+            SourcePriority = preferred.SourcePriority,
+            SourceOrder = preferred.SourceOrder
+        };
+    }
+
+    [SupportedOSPlatform("windows")]
+    private void TryGetFromMudToolsInterop(List<OfficeRecentDocument> documents)
+    {
+        try
+        {
+            RunOnStaThread(() =>
+            {
+                var sourceOrder = 0;
+                TryGetFromWordInterop(documents, ref sourceOrder);
+                TryGetFromExcelInterop(documents, ref sourceOrder);
+            });
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn(LogCategory, "MudTools.OfficeInterop recent-document read failed.", ex);
+        }
+    }
+
+    [SupportedOSPlatform("windows")]
+    private void TryGetFromWordInterop(List<OfficeRecentDocument> documents, ref int sourceOrder)
+    {
+        if (!TryGetOfficeApplication("Word.Application", out var comObject, out var createdNew))
+        {
+            return;
+        }
+
+        object? application = null;
+
+        try
+        {
+            application = WordFactory.Connection(comObject!);
+
+            if (createdNew)
+            {
+                TrySetProperty(comObject, "Visible", false);
+                TrySetProperty(application, "DisplayAlerts", WdAlertLevel.wdAlertsNone);
+            }
+
+            AddInteropRecentFiles(documents, GetPropertyValue(application, "RecentFiles"), 0, ref sourceOrder);
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn(LogCategory, "Failed to read Word recent files via MudTools.OfficeInterop.", ex);
+        }
+        finally
+        {
+            CleanupOfficeApplication(application, comObject, createdNew);
+        }
+    }
+
+    [SupportedOSPlatform("windows")]
+    private void TryGetFromExcelInterop(List<OfficeRecentDocument> documents, ref int sourceOrder)
+    {
+        if (!TryGetOfficeApplication("Excel.Application", out var comObject, out var createdNew))
+        {
+            return;
+        }
+
+        object? application = null;
+
+        try
+        {
+            application = ExcelFactory.Connection(comObject!);
+
+            if (createdNew)
+            {
+                TrySetProperty(comObject, "Visible", false);
+                TrySetProperty(application, "DisplayAlerts", false);
+            }
+
+            AddInteropRecentFiles(documents, GetPropertyValue(application, "RecentFiles"), 0, ref sourceOrder);
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn(LogCategory, "Failed to read Excel recent files via MudTools.OfficeInterop.", ex);
+        }
+        finally
+        {
+            CleanupOfficeApplication(application, comObject, createdNew);
+        }
+    }
+
+    private void AddInteropRecentFiles(
+        List<OfficeRecentDocument> documents,
+        object? recentFiles,
+        int sourcePriority,
+        ref int sourceOrder)
+    {
+        if (recentFiles == null)
+        {
+            return;
+        }
+
+        var count = GetIntProperty(recentFiles, "Count");
+        var itemProperty = recentFiles.GetType().GetProperty("Item");
+        if (count <= 0 || itemProperty == null)
+        {
+            return;
+        }
+
+        for (var index = 1; index <= count; index++)
+        {
+            try
+            {
+                var recentFile = itemProperty.GetValue(recentFiles, new object[] { index });
+                var filePath = GetStringProperty(recentFile, "Path");
+                AddDocumentIfExists(documents, filePath, sourcePriority, sourceOrder++, null);
+            }
+            catch
+            {
+                // Ignore a single malformed MRU entry and keep processing the rest.
+            }
+        }
+    }
+
+    [SupportedOSPlatform("windows")]
+    private static bool TryGetOfficeApplication(string progId, out object? comObject, out bool createdNew)
+    {
+        comObject = null;
+        createdNew = false;
+
+        var applicationType = Type.GetTypeFromProgID(progId, throwOnError: false);
+        if (applicationType == null)
+        {
+            return false;
+        }
+
+        try
+        {
+            comObject = Activator.CreateInstance(applicationType);
+            createdNew = comObject != null;
+            return comObject != null;
+        }
+        catch
+        {
+            return false;
+        }
+    }
+
+    [SupportedOSPlatform("windows")]
+    private static void CleanupOfficeApplication(object? application, object? comObject, bool createdNew)
+    {
+        try
+        {
+            if (createdNew && application != null)
+            {
+                InvokeParameterlessMethod(application, "Quit");
+            }
+        }
+        catch
+        {
+        }
+
+        try
+        {
+            if (application is IDisposable disposable)
+            {
+                disposable.Dispose();
+            }
+        }
+        catch
+        {
+        }
+
+        ReleaseComObject(application);
+        if (!ReferenceEquals(application, comObject))
+        {
+            ReleaseComObject(comObject);
+        }
+    }
+
+    [SupportedOSPlatform("windows")]
+    private static void ReleaseComObject(object? instance)
+    {
+        if (instance == null || !Marshal.IsComObject(instance))
+        {
+            return;
+        }
+
+        try
+        {
+            Marshal.FinalReleaseComObject(instance);
+        }
         catch
         {
         }
     }
 
-    private static List<string> GetRecentFolders()
+    [SupportedOSPlatform("windows")]
+    private static void RunOnStaThread(Action action)
     {
-        var folders = new List<string>();
+        Exception? exception = null;
+        using var finished = new ManualResetEventSlim();
 
+        var thread = new Thread(() =>
+        {
+            try
+            {
+                action();
+            }
+            catch (Exception ex)
+            {
+                exception = ex;
+            }
+            finally
+            {
+                finished.Set();
+            }
+        });
+
+        thread.IsBackground = true;
+        thread.SetApartmentState(ApartmentState.STA);
+        thread.Start();
+        finished.Wait();
+
+        if (exception != null)
+        {
+            throw new InvalidOperationException("Failed to run Office interop on STA thread.", exception);
+        }
+    }
+
+    [SupportedOSPlatform("windows")]
+    private void TryGetFromRegistry(List<OfficeRecentDocument> documents)
+    {
+        try
+        {
+            using var officeRoot = Registry.CurrentUser.OpenSubKey(@"Software\Microsoft\Office");
+            if (officeRoot == null)
+            {
+                return;
+            }
+
+            var versions = officeRoot
+                .GetSubKeyNames()
+                .Where(IsOfficeVersionKey)
+                .OrderByDescending(ParseVersionKey)
+                .ToList();
+
+            var sourceOrder = 0;
+            foreach (var version in versions)
+            {
+                TryGetFromRegistryApp(documents, version, "Word", ref sourceOrder);
+                TryGetFromRegistryApp(documents, version, "Excel", ref sourceOrder);
+                TryGetFromRegistryApp(documents, version, "PowerPoint", ref sourceOrder);
+            }
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn(LogCategory, "Failed to read Office MRU entries from the registry.", ex);
+        }
+    }
+
+    [SupportedOSPlatform("windows")]
+    private void TryGetFromRegistryApp(List<OfficeRecentDocument> documents, string version, string appName, ref int sourceOrder)
+    {
+        TryGetFromRegistryMruKey(documents, $@"Software\Microsoft\Office\{version}\{appName}\File MRU", ref sourceOrder);
+
+        using var userMruRoot = Registry.CurrentUser.OpenSubKey($@"Software\Microsoft\Office\{version}\{appName}\User MRU");
+        if (userMruRoot == null)
+        {
+            return;
+        }
+
+        foreach (var identityKey in userMruRoot.GetSubKeyNames())
+        {
+            TryGetFromRegistryMruKey(
+                documents,
+                $@"Software\Microsoft\Office\{version}\{appName}\User MRU\{identityKey}\File MRU",
+                ref sourceOrder);
+        }
+    }
+
+    [SupportedOSPlatform("windows")]
+    private void TryGetFromRegistryMruKey(List<OfficeRecentDocument> documents, string registryPath, ref int sourceOrder)
+    {
+        using var key = Registry.CurrentUser.OpenSubKey(registryPath);
+        if (key == null)
+        {
+            return;
+        }
+
+        var entries = key
+            .GetValueNames()
+            .Where(name => name.StartsWith("Item ", StringComparison.OrdinalIgnoreCase))
+            .Select(name => new
+            {
+                Name = name,
+                Order = ParseMruItemOrder(name),
+                Value = key.GetValue(name) as string
+            })
+            .Where(entry => !string.IsNullOrWhiteSpace(entry.Value))
+            .OrderBy(entry => entry.Order);
+
+        foreach (var entry in entries)
+        {
+            var (filePath, recentAccessTime) = ParseOfficeMruValue(entry.Value!);
+            AddDocumentIfExists(documents, filePath, 1, sourceOrder++, recentAccessTime);
+        }
+    }
+
+    private void TryGetFromRecentFolders(List<OfficeRecentDocument> documents)
+    {
+        try
+        {
+            var linkFiles = GetRecentFolders()
+                .Where(Directory.Exists)
+                .SelectMany(path => Directory.EnumerateFiles(path, "*.lnk"))
+                .Select(path => new FileInfo(path))
+                .OrderByDescending(info => info.LastWriteTimeUtc)
+                .ToList();
+
+            var sourceOrder = 0;
+            foreach (var linkFile in linkFiles)
+            {
+                var targetPath = GetShortcutTarget(linkFile.FullName);
+                AddDocumentIfExists(documents, targetPath, 2, sourceOrder++, linkFile.LastWriteTime);
+            }
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn(LogCategory, "Failed to read Windows Recent shortcut folders.", ex);
+        }
+    }
+
+    private void TryGetFromJumpLists(List<OfficeRecentDocument> documents)
+    {
+        try
+        {
+            var jumpListFiles = GetJumpListFolders()
+                .Where(Directory.Exists)
+                .SelectMany(path => Directory.EnumerateFiles(path, "*.automaticDestinations-ms")
+                    .Concat(Directory.EnumerateFiles(path, "*.customDestinations-ms")))
+                .Select(path => new FileInfo(path))
+                .OrderByDescending(info => info.LastWriteTimeUtc)
+                .ToList();
+
+            var sourceOrder = 0;
+            foreach (var jumpListFile in jumpListFiles)
+            {
+                TryParseJumpListFile(jumpListFile, documents, ref sourceOrder);
+            }
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn(LogCategory, "Failed to read Windows Jump Lists for Office documents.", ex);
+        }
+    }
+
+    private void TryParseJumpListFile(FileInfo jumpListFile, List<OfficeRecentDocument> documents, ref int sourceOrder)
+    {
+        try
+        {
+            var bytes = File.ReadAllBytes(jumpListFile.FullName);
+            foreach (var filePath in ExtractPossiblePaths(bytes))
+            {
+                AddDocumentIfExists(documents, filePath, 3, sourceOrder++, jumpListFile.LastWriteTime);
+            }
+        }
+        catch
+        {
+            // Ignore a single Jump List file and keep scanning the rest.
+        }
+    }
+
+    private static IEnumerable<string> ExtractPossiblePaths(byte[] bytes)
+    {
+        var paths = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
+
+        foreach (var text in new[]
+                 {
+                     Encoding.Unicode.GetString(bytes),
+                     Encoding.Latin1.GetString(bytes)
+                 })
+        {
+            foreach (Match match in OfficeFilePathRegex.Matches(text))
+            {
+                var normalizedPath = NormalizeFilePath(match.Value);
+                if (!string.IsNullOrWhiteSpace(normalizedPath))
+                {
+                    paths.Add(normalizedPath);
+                }
+            }
+        }
+
+        return paths;
+    }
+
+    private void AddDocumentIfExists(
+        List<OfficeRecentDocument> documents,
+        string? filePath,
+        int sourcePriority,
+        int sourceOrder,
+        DateTime? recentAccessTime)
+    {
+        try
+        {
+            var normalizedPath = NormalizeFilePath(filePath);
+            if (string.IsNullOrWhiteSpace(normalizedPath))
+            {
+                return;
+            }
+
+            var extension = Path.GetExtension(normalizedPath).ToLowerInvariant();
+            if (!IsOfficeFile(extension) || !File.Exists(normalizedPath))
+            {
+                return;
+            }
+
+            var fileInfo = new FileInfo(normalizedPath);
+            documents.Add(new OfficeRecentDocument
+            {
+                FileName = Path.GetFileNameWithoutExtension(normalizedPath),
+                FilePath = normalizedPath,
+                Extension = extension,
+                LastModifiedTime = fileInfo.LastWriteTime,
+                FileSizeBytes = fileInfo.Length,
+                IconGlyph = GetIconGlyph(extension),
+                RecentAccessTime = recentAccessTime,
+                SourcePriority = sourcePriority,
+                SourceOrder = sourceOrder
+            });
+        }
+        catch
+        {
+            // Ignore a single file and keep processing the rest of the MRU list.
+        }
+    }
+
+    private static IEnumerable<string> GetRecentFolders()
+    {
         var appData = Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData);
-        folders.Add(Path.Combine(appData, "Microsoft", "Word", "Recent"));
+        var localAppData = Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData);
-        folders.Add(Path.Combine(appData, "Microsoft", "Excel", "Recent"));
-        folders.Add(Path.Combine(appData, "Microsoft", "PowerPoint", "Recent"));
 
-        return folders;
+        return new[]
+        {
+            Path.Combine(appData, "Microsoft", "Windows", "Recent"),
+            Path.Combine(appData, "Microsoft", "Word", "Recent"),
+            Path.Combine(appData, "Microsoft", "Excel", "Recent"),
+            Path.Combine(appData, "Microsoft", "PowerPoint", "Recent"),
+            Path.Combine(localAppData, "Microsoft", "Office", "Word", "Recent"),
+            Path.Combine(localAppData, "Microsoft", "Office", "Excel", "Recent"),
+            Path.Combine(localAppData, "Microsoft", "Office", "PowerPoint", "Recent")
+        }.Distinct(StringComparer.OrdinalIgnoreCase);
+    }
+
+    private static IEnumerable<string> GetJumpListFolders()
+    {
+        var appData = Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData);
+        var localAppData = Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData);
+
+        return new[]
+        {
+            Path.Combine(appData, "Microsoft", "Windows", "Recent", "AutomaticDestinations"),
+            Path.Combine(appData, "Microsoft", "Windows", "Recent", "CustomDestinations"),
+            Path.Combine(localAppData, "Microsoft", "Windows", "Recent", "AutomaticDestinations"),
+            Path.Combine(localAppData, "Microsoft", "Windows", "Recent", "CustomDestinations")
+        }.Distinct(StringComparer.OrdinalIgnoreCase);
+    }
+
+    private static bool IsOfficeVersionKey(string keyName)
+    {
+        return Version.TryParse(keyName, out _);
+    }
+
+    private static Version ParseVersionKey(string keyName)
+    {
+        return Version.TryParse(keyName, out var version) ? version : new Version(0, 0);
+    }
+
+    private static int ParseMruItemOrder(string valueName)
+    {
+        var numberText = valueName["Item ".Length..];
+        return int.TryParse(numberText, NumberStyles.Integer, CultureInfo.InvariantCulture, out var number)
+            ? number
+            : int.MaxValue;
+    }
+
+    private static (string? FilePath, DateTime? RecentAccessTime) ParseOfficeMruValue(string rawValue)
+    {
+        var filePath = ExtractOfficeFilePath(rawValue);
+        DateTime? recentAccessTime = null;
+
+        var timestampMatch = OfficeMruTimestampRegex.Match(rawValue);
+        if (timestampMatch.Success &&
+            long.TryParse(timestampMatch.Groups["filetime"].Value, NumberStyles.HexNumber, CultureInfo.InvariantCulture, out var fileTime) &&
+            fileTime > 0)
+        {
+            try
+            {
+                recentAccessTime = DateTime.FromFileTimeUtc(fileTime).ToLocalTime();
+            }
+            catch
+            {
+                recentAccessTime = null;
+            }
+        }
+
+        return (filePath, recentAccessTime);
+    }
+
+    private static string? ExtractOfficeFilePath(string rawValue)
+    {
+        if (string.IsNullOrWhiteSpace(rawValue))
+        {
+            return null;
+        }
+
+        var markerIndex = rawValue.LastIndexOf('*');
+        var candidate = markerIndex >= 0
+            ? rawValue[(markerIndex + 1)..]
+            : rawValue;
+
+        var normalizedCandidate = NormalizeFilePath(candidate);
+        if (!string.IsNullOrWhiteSpace(normalizedCandidate) && IsOfficeFile(Path.GetExtension(normalizedCandidate)))
+        {
+            return normalizedCandidate;
+        }
+
+        var match = OfficeFilePathRegex.Match(rawValue);
+        return match.Success ? NormalizeFilePath(match.Value) : null;
+    }
+
+    private static string? NormalizeFilePath(string? rawPath)
+    {
+        if (string.IsNullOrWhiteSpace(rawPath))
+        {
+            return null;
+        }
+
+        var candidate = rawPath.Trim('\0', ' ', '"');
+        candidate = Environment.ExpandEnvironmentVariables(candidate);
+
+        if (Uri.TryCreate(candidate, UriKind.Absolute, out var uri) && uri.IsFile)
+        {
+            candidate = uri.LocalPath;
+        }
+
+        candidate = candidate.Replace('/', '\\');
+        return string.IsNullOrWhiteSpace(candidate) ? null : candidate;
     }
 
     private static bool IsOfficeFile(string extension)
     {
-        return OfficeExtensions.Contains(extension) ||
+        return OfficeExtensions.Contains(extension, StringComparer.OrdinalIgnoreCase) ||
-               ExcelExtensions.Contains(extension) ||
+               ExcelExtensions.Contains(extension, StringComparer.OrdinalIgnoreCase) ||
-               PowerPointExtensions.Contains(extension);
+               PowerPointExtensions.Contains(extension, StringComparer.OrdinalIgnoreCase);
     }
 
     private static string GetIconGlyph(string extension)
@@ -150,4 +703,40 @@ public sealed class OfficeRecentDocumentsService : IOfficeRecentDocumentsService
     {
         return ShortcutHelper.GetShortcutTarget(lnkPath);
     }
+
+    private static object? GetPropertyValue(object? instance, string propertyName)
+    {
+        return instance?.GetType().GetProperty(propertyName)?.GetValue(instance);
+    }
+
+    private static string? GetStringProperty(object? instance, string propertyName)
+    {
+        return GetPropertyValue(instance, propertyName) as string;
+    }
+
+    private static int GetIntProperty(object instance, string propertyName)
+    {
+        var value = GetPropertyValue(instance, propertyName);
+        return value switch
+        {
+            int intValue => intValue,
+            short shortValue => shortValue,
+            long longValue => (int)longValue,
+            _ => 0
+        };
+    }
+
+    private static void TrySetProperty(object? instance, string propertyName, object value)
+    {
+        var property = instance?.GetType().GetProperty(propertyName);
+        if (property?.CanWrite == true)
+        {
+            property.SetValue(instance, value);
+        }
+    }
+
+    private static void InvokeParameterlessMethod(object instance, string methodName)
+    {
+        instance.GetType().GetMethod(methodName, Type.EmptyTypes)?.Invoke(instance, null);
+    }
 }

LanMountainDesktop/Services/PostHogUsageTelemetryService.cs

@@ -0,0 +1,637 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Net.Http;
+using System.Text;
+using System.Text.Json;
+using System.Threading;
+using LanMountainDesktop.Models;
+using LanMountainDesktop.PluginSdk;
+using LanMountainDesktop.Services.Settings;
+
+namespace LanMountainDesktop.Services;
+
+public sealed class PostHogUsageTelemetryService : IDisposable
+{
+    private const string PostHogApiKey = "phc_bhQZvKDDfsEdLT6kkRFvrWMT8Pc5aCGGsnxoc5ijSf9";
+    private const string PostHogHost = "https://us.i.posthog.com/capture/";
+
+    private readonly ISettingsFacadeService _settingsFacade;
+    private readonly ISettingsService _settingsService;
+    private readonly HttpClient _httpClient = new()
+    {
+        Timeout = TimeSpan.FromSeconds(10)
+    };
+    private readonly Queue<TelemetryEvent> _eventQueue = new();
+    private readonly object _queueLock = new();
+
+    private Timer? _flushTimer;
+    private bool _isInitialized;
+    private bool _isUsageEnabled;
+    private bool _sessionActive;
+    private string _sessionId = string.Empty;
+    private DateTimeOffset _sessionStartUtc;
+    private long _sequence;
+    private readonly string _launchId = Guid.NewGuid().ToString("N");
+
+    public PostHogUsageTelemetryService(ISettingsFacadeService settingsFacade)
+    {
+        _settingsFacade = settingsFacade ?? throw new ArgumentNullException(nameof(settingsFacade));
+        _settingsService = settingsFacade.Settings;
+        _settingsService.Changed += OnSettingsChanged;
+    }
+
+    public bool IsUsageEnabled => _isUsageEnabled;
+
+    public void Initialize()
+    {
+        if (_isInitialized)
+        {
+            return;
+        }
+
+        _isInitialized = true;
+
+        EnsureBaselineEventSent();
+        RefreshEnabledState(forceSessionStart: true);
+
+        _flushTimer = new Timer(
+            _ => FlushEvents(),
+            null,
+            TimeSpan.FromSeconds(10),
+            TimeSpan.FromSeconds(30));
+
+        AppLogger.Info(
+            "PostHogUsage",
+            $"Usage telemetry initialized. Enabled={_isUsageEnabled}; InstallId={TelemetryIdentityService.Instance.InstallId}; TelemetryId={TelemetryIdentityService.Instance.TelemetryId}.");
+    }
+
+    public void RefreshEnabledState(bool forceSessionStart = false)
+    {
+        try
+        {
+            var snapshot = _settingsFacade.Settings.LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App);
+            var enabled = snapshot.UploadAnonymousUsageData;
+
+            if (_isUsageEnabled == enabled && !forceSessionStart)
+            {
+                return;
+            }
+
+            var previous = _isUsageEnabled;
+            _isUsageEnabled = enabled;
+            AppLogger.Info("PostHogUsage", $"Usage analytics enabled state changed from '{previous}' to '{_isUsageEnabled}'.");
+
+            if (_isUsageEnabled)
+            {
+                StartSession("usage_enabled");
+                return;
+            }
+
+            ClearQueuedEvents();
+            StopSessionWithoutSending();
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("PostHogUsage", "Failed to refresh usage analytics enabled state.", ex);
+            _isUsageEnabled = false;
+            ClearQueuedEvents();
+            StopSessionWithoutSending();
+        }
+    }
+
+    public void TrackMainWindowOpened(string source, bool isVisible, string windowState)
+    {
+        CaptureEvent(
+            "main_window_opened",
+            new Dictionary<string, object?>
+            {
+                ["source"] = source,
+                ["is_visible"] = isVisible,
+                ["window_state"] = windowState
+            },
+            forceFlush: true);
+    }
+
+    public void TrackMainWindowClosed(string source, bool wasVisible, string windowState)
+    {
+        CaptureEvent(
+            "main_window_closed",
+            new Dictionary<string, object?>
+            {
+                ["source"] = source,
+                ["was_visible"] = wasVisible,
+                ["window_state"] = windowState
+            },
+            forceFlush: true);
+    }
+
+    public void TrackSettingsWindowOpened(string source, string? currentPageId)
+    {
+        CaptureEvent(
+            "settings_window_opened",
+            new Dictionary<string, object?>
+            {
+                ["source"] = source,
+                ["current_page_id"] = currentPageId
+            },
+            forceFlush: true);
+    }
+
+    public void TrackSettingsWindowClosed(string source, string? currentPageId)
+    {
+        CaptureEvent(
+            "settings_window_closed",
+            new Dictionary<string, object?>
+            {
+                ["source"] = source,
+                ["current_page_id"] = currentPageId
+            },
+            forceFlush: true);
+    }
+
+    public void TrackSettingsNavigation(string? fromPageId, string? toPageId, string source)
+    {
+        CaptureEvent(
+            "settings_navigation",
+            new Dictionary<string, object?>
+            {
+                ["source"] = source,
+                ["from_page_id"] = fromPageId,
+                ["to_page_id"] = toPageId
+            },
+            stateBefore: CreatePageState(fromPageId),
+            stateAfter: CreatePageState(toPageId));
+    }
+
+    public void TrackSettingsDrawerOpened(string? pageId, string? drawerTitle)
+    {
+        CaptureEvent(
+            "settings_drawer_opened",
+            new Dictionary<string, object?>
+            {
+                ["page_id"] = pageId,
+                ["drawer_title"] = drawerTitle
+            },
+            forceFlush: true);
+    }
+
+    public void TrackSettingsDrawerClosed(string? pageId, string? drawerTitle)
+    {
+        CaptureEvent(
+            "settings_drawer_closed",
+            new Dictionary<string, object?>
+            {
+                ["page_id"] = pageId,
+                ["drawer_title"] = drawerTitle
+            },
+            forceFlush: true);
+    }
+
+    public void TrackDesktopComponentPlaced(DesktopComponentPlacementSnapshot placement, string source)
+    {
+        CaptureEvent(
+            "desktop_component_placed",
+            new Dictionary<string, object?>
+            {
+                ["source"] = source
+            },
+            stateAfter: DescribePlacement(placement),
+            forceFlush: true);
+    }
+
+    public void TrackDesktopComponentMoved(
+        DesktopComponentPlacementSnapshot before,
+        DesktopComponentPlacementSnapshot after,
+        string source)
+    {
+        CaptureEvent(
+            "desktop_component_moved",
+            new Dictionary<string, object?>
+            {
+                ["source"] = source
+            },
+            stateBefore: DescribePlacement(before),
+            stateAfter: DescribePlacement(after),
+            forceFlush: true);
+    }
+
+    public void TrackDesktopComponentResized(
+        DesktopComponentPlacementSnapshot before,
+        DesktopComponentPlacementSnapshot after,
+        string source)
+    {
+        CaptureEvent(
+            "desktop_component_resized",
+            new Dictionary<string, object?>
+            {
+                ["source"] = source
+            },
+            stateBefore: DescribePlacement(before),
+            stateAfter: DescribePlacement(after),
+            forceFlush: true);
+    }
+
+    public void TrackDesktopComponentDeleted(DesktopComponentPlacementSnapshot before, string source)
+    {
+        CaptureEvent(
+            "desktop_component_deleted",
+            new Dictionary<string, object?>
+            {
+                ["source"] = source
+            },
+            stateBefore: DescribePlacement(before),
+            forceFlush: true);
+    }
+
+    public void TrackDesktopComponentEditorOpened(DesktopComponentPlacementSnapshot placement, string source)
+    {
+        CaptureEvent(
+            "desktop_component_editor_opened",
+            new Dictionary<string, object?>
+            {
+                ["source"] = source
+            },
+            stateBefore: DescribePlacement(placement),
+            forceFlush: true);
+    }
+
+    public void TrackSessionStarted(string source)
+    {
+        StartSession(source);
+    }
+
+    public void TrackSessionEnded(string source)
+    {
+        EndSession(source);
+    }
+
+    public void Shutdown(bool isRestart, string source)
+    {
+        if (!_isInitialized)
+        {
+            return;
+        }
+
+        if (_isUsageEnabled && _sessionActive)
+        {
+            EndSession(source, isRestart);
+        }
+
+        FlushEvents();
+        AppLogger.Info(
+            "PostHogUsage",
+            $"Usage telemetry shutdown complete. Source='{source}'; Restart='{isRestart}'; Enabled={_isUsageEnabled}.");
+    }
+
+    public void Dispose()
+    {
+        try
+        {
+            _flushTimer?.Dispose();
+            _settingsService.Changed -= OnSettingsChanged;
+            Shutdown(isRestart: false, source: "Dispose");
+            FlushEvents();
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("PostHogUsage", "Error disposing usage telemetry service.", ex);
+        }
+        finally
+        {
+            _httpClient.Dispose();
+        }
+    }
+
+    private void EnsureBaselineEventSent()
+    {
+        try
+        {
+            var identity = TelemetryIdentityService.Instance;
+            if (identity.HasReportedBaseline)
+            {
+                return;
+            }
+
+            var now = DateTimeOffset.UtcNow;
+            if (SendBaselineEventToPostHog(identity.InstallId, now))
+            {
+                identity.MarkBaselineReported();
+            }
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("PostHogUsage", "Failed to send baseline launch event.", ex);
+        }
+    }
+
+    private bool SendBaselineEventToPostHog(string installId, DateTimeOffset timestamp)
+    {
+        try
+        {
+            var requestBody = new Dictionary<string, object?>
+            {
+                ["api_key"] = PostHogApiKey,
+                ["event"] = "app_first_launch",
+                ["distinct_id"] = installId,
+                ["timestamp"] = timestamp.ToString("o"),
+                ["properties"] = new Dictionary<string, object?>
+                {
+                    ["install_id"] = installId,
+                    ["app_version"] = TelemetryEnvironmentInfo.GetAppVersion(),
+                    ["os_name"] = TelemetryEnvironmentInfo.GetOsName(),
+                    ["os_version"] = TelemetryEnvironmentInfo.GetOsVersion(),
+                    ["device_model"] = TelemetryEnvironmentInfo.GetDeviceModel(),
+                    ["device_arch"] = TelemetryEnvironmentInfo.GetDeviceArchitecture(),
+                    ["runtime_version"] = TelemetryEnvironmentInfo.GetRuntimeVersion(),
+                    ["language"] = TelemetryEnvironmentInfo.GetSystemLanguage(),
+                    ["launch_time_utc"] = timestamp.ToString("o")
+                }
+            };
+
+            var json = JsonSerializer.Serialize(requestBody);
+            var bytes = Encoding.UTF8.GetBytes(json);
+
+            using var content = new ByteArrayContent(bytes);
+            content.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue("application/json");
+
+            var response = _httpClient.PostAsync(PostHogHost, content).GetAwaiter().GetResult();
+            var responseBody = response.Content.ReadAsStringAsync().GetAwaiter().GetResult();
+
+            if (!response.IsSuccessStatusCode)
+            {
+                AppLogger.Warn(
+                    "PostHogUsage",
+                    $"PostHog baseline event failed: {response.StatusCode} - {responseBody}");
+                return false;
+            }
+
+            AppLogger.Info("PostHogUsage", "Sent first-launch baseline event.");
+            return true;
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("PostHogUsage", "Failed to send baseline launch event.", ex);
+            return false;
+        }
+    }
+
+    private void StartSession(string source)
+    {
+        if (!_isInitialized || !_isUsageEnabled)
+        {
+            return;
+        }
+
+        if (_sessionActive)
+        {
+            return;
+        }
+
+        _sessionActive = true;
+        _sessionId = Guid.NewGuid().ToString("N");
+        _sessionStartUtc = DateTimeOffset.UtcNow;
+        _sequence = 0;
+
+        CaptureEvent(
+            "app_session_start",
+            new Dictionary<string, object?>
+            {
+                ["source"] = source,
+                ["launch_id"] = _launchId,
+                ["session_start_utc"] = _sessionStartUtc.ToString("o"),
+                ["local_hour"] = _sessionStartUtc.ToLocalTime().Hour,
+                ["day_part"] = TelemetryEnvironmentInfo.GetLocalDayPart(_sessionStartUtc),
+                ["timezone"] = TimeZoneInfo.Local.Id,
+                ["app_version"] = TelemetryEnvironmentInfo.GetAppVersion(),
+                ["os_name"] = TelemetryEnvironmentInfo.GetOsName(),
+                ["os_version"] = TelemetryEnvironmentInfo.GetOsVersion(),
+                ["device_model"] = TelemetryEnvironmentInfo.GetDeviceModel(),
+                ["device_arch"] = TelemetryEnvironmentInfo.GetDeviceArchitecture()
+            },
+            forceFlush: true);
+
+        AppLogger.Info("PostHogUsage", $"Session started. SessionId={_sessionId}; Source='{source}'.");
+    }
+
+    private void EndSession(string source, bool isRestart = false)
+    {
+        if (!_isInitialized || !_sessionActive)
+        {
+            return;
+        }
+
+        var endUtc = DateTimeOffset.UtcNow;
+        var durationMs = Math.Max(0, (long)(endUtc - _sessionStartUtc).TotalMilliseconds);
+
+        CaptureEvent(
+            "app_session_end",
+            new Dictionary<string, object?>
+            {
+                ["source"] = source,
+                ["launch_id"] = _launchId,
+                ["session_start_utc"] = _sessionStartUtc.ToString("o"),
+                ["session_end_utc"] = endUtc.ToString("o"),
+                ["duration_ms"] = durationMs,
+                ["is_restart"] = isRestart
+            },
+            forceFlush: true);
+
+        _sessionActive = false;
+        _sessionId = string.Empty;
+        _sessionStartUtc = default;
+        _sequence = 0;
+        AppLogger.Info("PostHogUsage", $"Session ended. Source='{source}'; DurationMs={durationMs}; Restart={isRestart}.");
+    }
+
+    private void StopSessionWithoutSending()
+    {
+        _sessionActive = false;
+        _sessionId = string.Empty;
+        _sessionStartUtc = default;
+        _sequence = 0;
+    }
+
+    private void OnSettingsChanged(object? sender, SettingsChangedEvent e)
+    {
+        _ = sender;
+
+        if (e.Scope != SettingsScope.App ||
+            e.ChangedKeys is null ||
+            !e.ChangedKeys.Contains(nameof(AppSettingsSnapshot.UploadAnonymousUsageData), StringComparer.OrdinalIgnoreCase))
+        {
+            return;
+        }
+
+        AppLogger.Info("PostHogUsage", "Usage analytics settings changed. Refreshing enabled state.");
+        RefreshEnabledState();
+    }
+
+    private void CaptureEvent(
+        string eventName,
+        IReadOnlyDictionary<string, object?>? payload = null,
+        IReadOnlyDictionary<string, object?>? stateBefore = null,
+        IReadOnlyDictionary<string, object?>? stateAfter = null,
+        bool forceFlush = false)
+    {
+        if (!_isInitialized || !_isUsageEnabled || !_sessionActive)
+        {
+            return;
+        }
+
+        var eventData = new TelemetryEvent(
+            eventName,
+            TelemetryIdentityService.Instance.TelemetryId,
+            TelemetryIdentityService.Instance.InstallId,
+            TelemetryIdentityService.Instance.TelemetryId,
+            _sessionId,
+            Interlocked.Increment(ref _sequence),
+            DateTimeOffset.UtcNow,
+            payload ?? new Dictionary<string, object?>(),
+            stateBefore,
+            stateAfter);
+
+        lock (_queueLock)
+        {
+            _eventQueue.Enqueue(eventData);
+        }
+
+        if (forceFlush)
+        {
+            FlushEvents();
+            return;
+        }
+
+        var shouldFlush = false;
+        lock (_queueLock)
+        {
+            shouldFlush = _eventQueue.Count >= 20;
+        }
+
+        if (shouldFlush)
+        {
+            FlushEvents();
+        }
+    }
+
+    private void FlushEvents()
+    {
+        List<TelemetryEvent> eventsToSend;
+
+        lock (_queueLock)
+        {
+            if (_eventQueue.Count == 0)
+            {
+                return;
+            }
+
+            eventsToSend = new List<TelemetryEvent>();
+            while (_eventQueue.Count > 0 && eventsToSend.Count < 20)
+            {
+                eventsToSend.Add(_eventQueue.Dequeue());
+            }
+        }
+
+        try
+        {
+            foreach (var telemetryEvent in eventsToSend)
+            {
+                if (!SendEventToPostHog(telemetryEvent, flushImmediately: false))
+                {
+                    throw new InvalidOperationException($"Failed to send PostHog event '{telemetryEvent.EventName}'.");
+                }
+            }
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("PostHogUsage", "Failed to send queued events to PostHog.", ex);
+
+            lock (_queueLock)
+            {
+                foreach (var evt in eventsToSend)
+                {
+                    if (_eventQueue.Count >= 100)
+                    {
+                        break;
+                    }
+
+                    _eventQueue.Enqueue(evt);
+                }
+            }
+        }
+    }
+
+    private bool SendEventToPostHog(TelemetryEvent telemetryEvent, bool flushImmediately)
+    {
+        try
+        {
+            var requestBody = new Dictionary<string, object?>
+            {
+                ["api_key"] = PostHogApiKey,
+                ["event"] = telemetryEvent.EventName,
+                ["distinct_id"] = telemetryEvent.DistinctId,
+                ["timestamp"] = telemetryEvent.Timestamp.ToString("o"),
+                ["properties"] = telemetryEvent.ToPostHogProperties()
+            };
+
+            var json = JsonSerializer.Serialize(requestBody);
+            var bytes = Encoding.UTF8.GetBytes(json);
+
+            using var content = new ByteArrayContent(bytes);
+            content.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue("application/json");
+
+            var response = _httpClient.PostAsync(PostHogHost, content).GetAwaiter().GetResult();
+            var responseBody = response.Content.ReadAsStringAsync().GetAwaiter().GetResult();
+
+            if (!response.IsSuccessStatusCode)
+            {
+                AppLogger.Warn(
+                    "PostHogUsage",
+                    $"PostHog event '{telemetryEvent.EventName}' failed: {response.StatusCode} - {responseBody}");
+                return false;
+            }
+
+            if (flushImmediately)
+            {
+                AppLogger.Info("PostHogUsage", $"Sent event '{telemetryEvent.EventName}' immediately.");
+            }
+
+            return true;
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("PostHogUsage", $"Failed to send PostHog event '{telemetryEvent.EventName}'.", ex);
+            return false;
+        }
+    }
+
+    private void ClearQueuedEvents()
+    {
+        lock (_queueLock)
+        {
+            _eventQueue.Clear();
+        }
+    }
+
+    private static IReadOnlyDictionary<string, object?> CreatePageState(string? pageId)
+    {
+        return new Dictionary<string, object?>
+        {
+            ["page_id"] = pageId
+        };
+    }
+
+    private static IReadOnlyDictionary<string, object?> DescribePlacement(DesktopComponentPlacementSnapshot placement)
+    {
+        return new Dictionary<string, object?>
+        {
+            ["placement_id"] = placement.PlacementId,
+            ["component_id"] = placement.ComponentId,
+            ["page_index"] = placement.PageIndex,
+            ["row"] = placement.Row,
+            ["column"] = placement.Column,
+            ["width_cells"] = placement.WidthCells,
+            ["height_cells"] = placement.HeightCells
+        };
+    }
+}

LanMountainDesktop/Services/RemovableStorageService.cs

@@ -0,0 +1,310 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Globalization;
+using System.IO;
+using System.Linq;
+using System.Reflection;
+using System.Runtime.InteropServices;
+
+namespace LanMountainDesktop.Services;
+
+public sealed record RemovableStorageDrive(
+    string RootPath,
+    string DriveLetter,
+    string? VolumeLabel);
+
+public interface IRemovableStorageService
+{
+    IReadOnlyList<RemovableStorageDrive> GetConnectedDrives();
+
+    bool OpenDrive(string rootPath);
+
+    bool EjectDrive(string rootPath);
+}
+
+public sealed class RemovableStorageService : IRemovableStorageService
+{
+    public IReadOnlyList<RemovableStorageDrive> GetConnectedDrives()
+    {
+        var drives = new List<RemovableStorageDrive>();
+
+        foreach (var drive in DriveInfo.GetDrives())
+        {
+            try
+            {
+                if (drive.DriveType != DriveType.Removable || !drive.IsReady)
+                {
+                    continue;
+                }
+
+                var rootPath = NormalizeRootPath(drive.Name);
+                if (string.IsNullOrWhiteSpace(rootPath))
+                {
+                    continue;
+                }
+
+                var driveLetter = rootPath.TrimEnd(Path.DirectorySeparatorChar, Path.AltDirectorySeparatorChar);
+                var volumeLabel = string.IsNullOrWhiteSpace(drive.VolumeLabel)
+                    ? null
+                    : drive.VolumeLabel.Trim();
+
+                drives.Add(new RemovableStorageDrive(rootPath, driveLetter, volumeLabel));
+            }
+            catch (Exception ex)
+            {
+                AppLogger.Warn("RemovableStorage", $"Failed to inspect drive '{drive.Name}'.", ex);
+            }
+        }
+
+        return drives
+            .OrderBy(drive => drive.DriveLetter, StringComparer.OrdinalIgnoreCase)
+            .ToArray();
+    }
+
+    public bool OpenDrive(string rootPath)
+    {
+        var normalizedRootPath = NormalizeRootPath(rootPath);
+        if (string.IsNullOrWhiteSpace(normalizedRootPath))
+        {
+            return false;
+        }
+
+        try
+        {
+            Process.Start(new ProcessStartInfo
+            {
+                FileName = normalizedRootPath,
+                UseShellExecute = true
+            });
+            return true;
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("RemovableStorage", $"Failed to open drive '{normalizedRootPath}'.", ex);
+            return false;
+        }
+    }
+
+    public bool EjectDrive(string rootPath)
+    {
+        if (!OperatingSystem.IsWindows())
+        {
+            return false;
+        }
+
+        var normalizedRootPath = NormalizeRootPath(rootPath);
+        if (string.IsNullOrWhiteSpace(normalizedRootPath))
+        {
+            return false;
+        }
+
+        object? shellApplication = null;
+        object? computerFolder = null;
+        object? driveItem = null;
+
+        try
+        {
+            var shellType = Type.GetTypeFromProgID("Shell.Application");
+            if (shellType is null)
+            {
+                return false;
+            }
+
+            shellApplication = Activator.CreateInstance(shellType);
+            if (shellApplication is null)
+            {
+                return false;
+            }
+
+            computerFolder = shellType.InvokeMember(
+                "NameSpace",
+                BindingFlags.InvokeMethod,
+                binder: null,
+                target: shellApplication,
+                args: [17]);
+            if (computerFolder is null)
+            {
+                return false;
+            }
+
+            var driveToken = normalizedRootPath.TrimEnd(Path.DirectorySeparatorChar, Path.AltDirectorySeparatorChar);
+            driveItem = computerFolder.GetType().InvokeMember(
+                "ParseName",
+                BindingFlags.InvokeMethod,
+                binder: null,
+                target: computerFolder,
+                args: [driveToken]);
+            if (driveItem is null)
+            {
+                return false;
+            }
+
+            if (TryInvokeVerb(driveItem, "Eject"))
+            {
+                return true;
+            }
+
+            return TryInvokeLocalizedEjectVerb(driveItem);
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("RemovableStorage", $"Failed to eject drive '{normalizedRootPath}'.", ex);
+            return false;
+        }
+        finally
+        {
+            ReleaseComObject(driveItem);
+            ReleaseComObject(computerFolder);
+            ReleaseComObject(shellApplication);
+        }
+    }
+
+    private static bool TryInvokeLocalizedEjectVerb(object driveItem)
+    {
+        object? verbs = null;
+
+        try
+        {
+            verbs = driveItem.GetType().InvokeMember(
+                "Verbs",
+                BindingFlags.InvokeMethod,
+                binder: null,
+                target: driveItem,
+                args: null);
+            if (verbs is null)
+            {
+                return false;
+            }
+
+            var verbsType = verbs.GetType();
+            var countObject = verbsType.InvokeMember(
+                "Count",
+                BindingFlags.GetProperty,
+                binder: null,
+                target: verbs,
+                args: null);
+            var count = countObject is null
+                ? 0
+                : Convert.ToInt32(countObject, CultureInfo.InvariantCulture);
+
+            for (var index = 0; index < count; index++)
+            {
+                object? verb = null;
+
+                try
+                {
+                    verb = verbsType.InvokeMember(
+                        "Item",
+                        BindingFlags.InvokeMethod,
+                        binder: null,
+                        target: verbs,
+                        args: [index]);
+                    if (verb is null)
+                    {
+                        continue;
+                    }
+
+                    var verbNameObject = verb.GetType().InvokeMember(
+                        "Name",
+                        BindingFlags.GetProperty,
+                        binder: null,
+                        target: verb,
+                        args: null);
+                    var verbName = Convert.ToString(verbNameObject, CultureInfo.InvariantCulture);
+                    if (!IsEjectVerbName(verbName))
+                    {
+                        continue;
+                    }
+
+                    verb.GetType().InvokeMember(
+                        "DoIt",
+                        BindingFlags.InvokeMethod,
+                        binder: null,
+                        target: verb,
+                        args: null);
+                    return true;
+                }
+                finally
+                {
+                    ReleaseComObject(verb);
+                }
+            }
+
+            return false;
+        }
+        finally
+        {
+            ReleaseComObject(verbs);
+        }
+    }
+
+    private static bool TryInvokeVerb(object driveItem, string verbName)
+    {
+        try
+        {
+            driveItem.GetType().InvokeMember(
+                "InvokeVerb",
+                BindingFlags.InvokeMethod,
+                binder: null,
+                target: driveItem,
+                args: [verbName]);
+            return true;
+        }
+        catch
+        {
+            return false;
+        }
+    }
+
+    private static bool IsEjectVerbName(string? verbName)
+    {
+        if (string.IsNullOrWhiteSpace(verbName))
+        {
+            return false;
+        }
+
+        var normalized = string.Concat(
+            verbName
+                .Where(character => !char.IsWhiteSpace(character) && character != '&'))
+            .Trim();
+
+        return normalized.Contains("Eject", StringComparison.OrdinalIgnoreCase) ||
+               normalized.Contains("弹出", StringComparison.Ordinal) ||
+               normalized.Contains("安全删除", StringComparison.Ordinal) ||
+               normalized.Contains("卸载", StringComparison.Ordinal);
+    }
+
+    private static string NormalizeRootPath(string? rootPath)
+    {
+        if (string.IsNullOrWhiteSpace(rootPath))
+        {
+            return string.Empty;
+        }
+
+        var trimmed = rootPath.Trim();
+        if (trimmed.Length == 1 && char.IsLetter(trimmed[0]))
+        {
+            return string.Create(CultureInfo.InvariantCulture, $"{trimmed}:{Path.DirectorySeparatorChar}");
+        }
+
+        if (trimmed.Length == 2 && char.IsLetter(trimmed[0]) && trimmed[1] == ':')
+        {
+            return trimmed + Path.DirectorySeparatorChar;
+        }
+
+        var normalized = trimmed.Replace(Path.AltDirectorySeparatorChar, Path.DirectorySeparatorChar);
+        var resolvedRoot = Path.GetPathRoot(normalized);
+        return string.IsNullOrWhiteSpace(resolvedRoot)
+            ? normalized
+            : resolvedRoot;
+    }
+
+    private static void ReleaseComObject(object? value)
+    {
+        if (value is not null && Marshal.IsComObject(value))
+        {
+            Marshal.FinalReleaseComObject(value);
+        }
+    }
+}

LanMountainDesktop/Services/SentryCrashTelemetryService.cs

@@ -0,0 +1,410 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Text;
+using LanMountainDesktop.Models;
+using LanMountainDesktop.PluginSdk;
+using LanMountainDesktop.Services.Settings;
+using Sentry;
+
+namespace LanMountainDesktop.Services;
+
+public sealed class SentryCrashTelemetryService : IDisposable
+{
+    private const string SentryDsn = "https://f2aad3a1c63b5f2213ad82683ce93c06@o4511049423257600.ingest.us.sentry.io/4511049425813504";
+    private const string AutoIpAddress = "{{auto}}";
+
+    private readonly ISettingsFacadeService _settingsFacade;
+    private readonly ISettingsService _settingsService;
+    private readonly object _syncRoot = new();
+
+    private IDisposable? _sentryHandle;
+    private bool _isInitialized;
+    private bool _isEnabled;
+    private bool _disposed;
+
+    public SentryCrashTelemetryService(ISettingsFacadeService settingsFacade)
+    {
+        _settingsFacade = settingsFacade ?? throw new ArgumentNullException(nameof(settingsFacade));
+        _settingsService = settingsFacade.Settings;
+        _settingsService.Changed += OnSettingsChanged;
+    }
+
+    public bool IsEnabled
+    {
+        get
+        {
+            lock (_syncRoot)
+            {
+                return _isInitialized && _isEnabled && SentrySdk.IsEnabled;
+            }
+        }
+    }
+
+    public void Initialize()
+    {
+        lock (_syncRoot)
+        {
+            EnsureNotDisposed();
+            if (_isInitialized)
+            {
+                return;
+            }
+
+            _isInitialized = true;
+        }
+
+        RefreshEnabledState(force: true);
+    }
+
+    public void RefreshEnabledState(bool force = false)
+    {
+        bool shouldEnable;
+        lock (_syncRoot)
+        {
+            EnsureNotDisposed();
+            if (!_isInitialized)
+            {
+                return;
+            }
+
+            var snapshot = _settingsFacade.Settings.LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App);
+            shouldEnable = snapshot.UploadAnonymousCrashData;
+
+            if (!force && _isEnabled == shouldEnable)
+            {
+                return;
+            }
+        }
+
+        if (shouldEnable)
+        {
+            EnableSentry();
+            return;
+        }
+
+        DisableSentry();
+    }
+
+    public void CaptureUnhandledException(Exception exception, string source, bool isTerminating)
+    {
+        if (exception is null)
+        {
+            return;
+        }
+
+        lock (_syncRoot)
+        {
+            if (!CanCapture())
+            {
+                return;
+            }
+        }
+
+        var eventId = SentrySdk.CaptureException(exception, scope =>
+        {
+            ApplyCommonScope(scope, source, "unhandled_exception", includeLogTail: true);
+            scope.Level = isTerminating ? SentryLevel.Fatal : SentryLevel.Error;
+            scope.SetTag("exception_source", source);
+            scope.SetTag("is_terminating", isTerminating.ToString());
+        });
+
+        AppLogger.Info("SentryCrash", $"Captured unhandled exception from '{source}'. EventId={eventId}.");
+
+        if (isTerminating)
+        {
+            EndCrashSession();
+            SentrySdk.Flush(TimeSpan.FromSeconds(5));
+        }
+    }
+
+    public void CaptureTaskException(Exception exception, string source)
+    {
+        if (exception is null)
+        {
+            return;
+        }
+
+        lock (_syncRoot)
+        {
+            if (!CanCapture())
+            {
+                return;
+            }
+        }
+
+        var eventId = SentrySdk.CaptureException(exception, scope =>
+        {
+            ApplyCommonScope(scope, source, "task_exception", includeLogTail: true);
+            scope.Level = SentryLevel.Error;
+            scope.SetTag("exception_source", source);
+        });
+
+        AppLogger.Info("SentryCrash", $"Captured task exception from '{source}'. EventId={eventId}.");
+        SentrySdk.Flush(TimeSpan.FromSeconds(2));
+    }
+
+    public void CaptureShutdown(bool isRestart, string source)
+    {
+        lock (_syncRoot)
+        {
+            if (!CanCapture())
+            {
+                return;
+            }
+        }
+
+        var eventId = SentrySdk.CaptureMessage("application_shutdown", scope =>
+        {
+            ApplyCommonScope(scope, source, "shutdown", includeLogTail: true);
+            scope.Level = SentryLevel.Info;
+            scope.SetTag("shutdown_intent", isRestart ? "restart" : "exit");
+            scope.SetExtra("shutdown_intent", isRestart ? "restart" : "exit");
+        }, SentryLevel.Info);
+
+        AppLogger.Info(
+            "SentryCrash",
+            $"Captured application shutdown. Source='{source}'; Restart={isRestart}; EventId={eventId}.");
+
+        EndCrashSession();
+        SentrySdk.Flush(TimeSpan.FromSeconds(5));
+    }
+
+    public void Dispose()
+    {
+        lock (_syncRoot)
+        {
+            if (_disposed)
+            {
+                return;
+            }
+
+            _disposed = true;
+        }
+
+        try
+        {
+            _settingsService.Changed -= OnSettingsChanged;
+            DisableSentry();
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("SentryCrash", "Failed to dispose crash telemetry service.", ex);
+        }
+    }
+
+    private void EnableSentry()
+    {
+        lock (_syncRoot)
+        {
+            if (_isEnabled && _sentryHandle is not null && SentrySdk.IsEnabled)
+            {
+                return;
+            }
+        }
+
+        var handle = SentrySdk.Init(options =>
+        {
+            options.Dsn = SentryDsn;
+            options.AutoSessionTracking = true;
+            options.AttachStacktrace = true;
+            options.SendDefaultPii = true;
+            options.MaxBreadcrumbs = 100;
+            options.Release = TelemetryEnvironmentInfo.GetAppVersion();
+            options.Environment = TelemetryEnvironmentInfo.GetEnvironment();
+            options.DisableAppDomainUnhandledExceptionCapture();
+            options.DisableUnobservedTaskExceptionCapture();
+        });
+
+        lock (_syncRoot)
+        {
+            if (_disposed)
+            {
+                handle.Dispose();
+                return;
+            }
+
+            _sentryHandle?.Dispose();
+            _sentryHandle = handle;
+            _isEnabled = true;
+        }
+
+        SentrySdk.ConfigureScope(scope => ApplyCommonScope(scope, "startup", "startup", includeLogTail: false));
+        AppLogger.Info("SentryCrash", "Crash telemetry enabled.");
+    }
+
+    private void DisableSentry()
+    {
+        IDisposable? handle;
+        lock (_syncRoot)
+        {
+            if (!_isEnabled && _sentryHandle is null)
+            {
+                return;
+            }
+
+            _isEnabled = false;
+            handle = _sentryHandle;
+            _sentryHandle = null;
+        }
+
+        try
+        {
+            EndCrashSession();
+            SentrySdk.Flush(TimeSpan.FromSeconds(3));
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("SentryCrash", "Failed to flush Sentry while disabling crash telemetry.", ex);
+        }
+        finally
+        {
+            handle?.Dispose();
+        }
+
+        AppLogger.Info("SentryCrash", "Crash telemetry disabled.");
+    }
+
+    private void EndCrashSession()
+    {
+        try
+        {
+            if (SentrySdk.IsEnabled)
+            {
+                SentrySdk.EndSession(SessionEndStatus.Exited);
+            }
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("SentryCrash", "Failed to end Sentry session.", ex);
+        }
+    }
+
+    private bool CanCapture()
+    {
+        return !_disposed && _isInitialized && _isEnabled && SentrySdk.IsEnabled;
+    }
+
+    private void ApplyCommonScope(Scope scope, string source, string eventType, bool includeLogTail)
+    {
+        var installId = TelemetryIdentityService.Instance.InstallId;
+        var telemetryId = TelemetryIdentityService.Instance.TelemetryId;
+
+        scope.User = new SentryUser
+        {
+            Id = telemetryId,
+            IpAddress = AutoIpAddress
+        };
+
+        scope.SetTag("telemetry_channel", "sentry");
+        scope.SetTag("event_type", eventType);
+        scope.SetTag("source", source);
+        scope.SetTag("install_id", installId);
+        scope.SetTag("telemetry_id", telemetryId);
+        scope.SetTag("app_version", TelemetryEnvironmentInfo.GetAppVersion());
+        scope.SetTag("environment", TelemetryEnvironmentInfo.GetEnvironment());
+        scope.SetTag("os_name", TelemetryEnvironmentInfo.GetOsName());
+        scope.SetTag("os_version", TelemetryEnvironmentInfo.GetOsVersion());
+        scope.SetTag("os_build", TelemetryEnvironmentInfo.GetOsBuild());
+        scope.SetTag("device_model", TelemetryEnvironmentInfo.GetDeviceModel());
+        scope.SetTag("device_arch", TelemetryEnvironmentInfo.GetDeviceArchitecture());
+        scope.SetTag("processor_count", TelemetryEnvironmentInfo.GetProcessorCount().ToString());
+        scope.SetTag("total_memory_mb", TelemetryEnvironmentInfo.GetTotalMemoryMB().ToString());
+        scope.SetTag("runtime_version", TelemetryEnvironmentInfo.GetRuntimeVersion());
+        scope.SetTag("clr_version", TelemetryEnvironmentInfo.GetClrVersion());
+        scope.SetTag("language", TelemetryEnvironmentInfo.GetSystemLanguage());
+        scope.SetExtra("install_id", installId);
+        scope.SetExtra("telemetry_id", telemetryId);
+        scope.SetExtra("app_version", TelemetryEnvironmentInfo.GetAppVersion());
+        scope.SetExtra("environment", TelemetryEnvironmentInfo.GetEnvironment());
+        scope.SetExtra("os_name", TelemetryEnvironmentInfo.GetOsName());
+        scope.SetExtra("os_version", TelemetryEnvironmentInfo.GetOsVersion());
+        scope.SetExtra("os_build", TelemetryEnvironmentInfo.GetOsBuild());
+        scope.SetExtra("device_model", TelemetryEnvironmentInfo.GetDeviceModel());
+        scope.SetExtra("device_arch", TelemetryEnvironmentInfo.GetDeviceArchitecture());
+        scope.SetExtra("processor_count", TelemetryEnvironmentInfo.GetProcessorCount());
+        scope.SetExtra("total_memory_mb", TelemetryEnvironmentInfo.GetTotalMemoryMB());
+        scope.SetExtra("runtime_version", TelemetryEnvironmentInfo.GetRuntimeVersion());
+        scope.SetExtra("clr_version", TelemetryEnvironmentInfo.GetClrVersion());
+        scope.SetExtra("language", TelemetryEnvironmentInfo.GetSystemLanguage());
+        scope.SetExtra("log_file_path", AppLogger.LogFilePath);
+
+        if (includeLogTail)
+        {
+            var logTail = ReadLogTail(maxLines: 200, maxCharacters: 32_768);
+            if (!string.IsNullOrWhiteSpace(logTail))
+            {
+                scope.SetExtra("log_tail", logTail);
+                scope.SetExtra("log_tail_line_count", logTail.Count(character => character == '\n') + 1);
+                var attachment = new Attachment(
+                    AttachmentType.Default,
+                    new ByteAttachmentContent(Encoding.UTF8.GetBytes(logTail)),
+                    "log-tail.txt",
+                    "text/plain");
+                scope.AddAttachment(attachment);
+            }
+        }
+    }
+
+    private void OnSettingsChanged(object? sender, SettingsChangedEvent e)
+    {
+        _ = sender;
+
+        if (e.Scope != SettingsScope.App ||
+            e.ChangedKeys is null ||
+            !e.ChangedKeys.Contains(nameof(AppSettingsSnapshot.UploadAnonymousCrashData), StringComparer.OrdinalIgnoreCase))
+        {
+            return;
+        }
+
+        AppLogger.Info("SentryCrash", "Crash telemetry setting changed. Refreshing enabled state.");
+        RefreshEnabledState();
+    }
+
+    private static string ReadLogTail(int maxLines, int maxCharacters)
+    {
+        try
+        {
+            var logFilePath = AppLogger.LogFilePath;
+            if (string.IsNullOrWhiteSpace(logFilePath) || !File.Exists(logFilePath))
+            {
+                return string.Empty;
+            }
+
+            var lines = new Queue<string>(Math.Min(maxLines, 256));
+            using var reader = File.OpenText(logFilePath);
+            string? line;
+            while ((line = reader.ReadLine()) is not null)
+            {
+                if (lines.Count >= maxLines)
+                {
+                    lines.Dequeue();
+                }
+
+                lines.Enqueue(line);
+            }
+
+            var tail = string.Join(Environment.NewLine, lines);
+            if (tail.Length <= maxCharacters)
+            {
+                return tail;
+            }
+
+            return tail[^maxCharacters..];
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("SentryCrash", "Failed to read log tail for crash telemetry.", ex);
+            return string.Empty;
+        }
+    }
+
+    private void EnsureNotDisposed()
+    {
+        if (_disposed)
+        {
+            throw new ObjectDisposedException(nameof(SentryCrashTelemetryService));
+        }
+    }
+}

LanMountainDesktop/Services/Settings/SettingsCatalogService.cs

@@ -17,7 +17,7 @@ internal sealed class SettingsCatalogService : ISettingsCatalog
         [
             new SettingsSectionDefinition("general", SettingsCategories.General, SettingsScope.App, "settings.general.title", iconKey: "Settings", sortOrder: 0),
             new SettingsSectionDefinition("appearance", SettingsCategories.Appearance, SettingsScope.App, "settings.appearance.title", iconKey: "DesignIdeas", sortOrder: 10),
-            new SettingsSectionDefinition("components", SettingsCategories.Components, SettingsScope.ComponentInstance, "settings.components.title", iconKey: "GridDots", sortOrder: 20),
+            new SettingsSectionDefinition("components", SettingsCategories.Components, SettingsScope.ComponentInstance, "settings.components.title", iconKey: "Apps", sortOrder: 20),
             new SettingsSectionDefinition("plugins", SettingsCategories.Plugins, SettingsScope.Plugin, "settings.plugins.title", iconKey: "PuzzlePiece", sortOrder: 30),
             new SettingsSectionDefinition("about", SettingsCategories.About, SettingsScope.App, "settings.about.title", iconKey: "Info", sortOrder: 40)
         ]);