0.5.1

插件系统试验

LanMountainDesktop.SamplePlugin/LanMountainDesktop.SamplePlugin.csproj

@@ -0,0 +1,29 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <Version>1.0.0</Version>
+    <EnableDynamicLoading>true</EnableDynamicLoading>
+    <OutputPath>bin\$(Configuration)\$(TargetFramework)\content\</OutputPath>
+    <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
+    <AppendRuntimeIdentifierToOutputPath>false</AppendRuntimeIdentifierToOutputPath>
+    <PluginPackageOutputDirectory>..\LanMountainDesktop\bin\$(Configuration)\$(TargetFramework)\Extensions\Plugins\</PluginPackageOutputDirectory>
+    <PluginPackagePath>$(PluginPackageOutputDirectory)$(AssemblyName).laapp</PluginPackagePath>
+    <LegacyLoosePluginOutputDirectory>..\LanMountainDesktop\bin\$(Configuration)\$(TargetFramework)\Extensions\Plugins\SamplePlugin\</LegacyLoosePluginOutputDirectory>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\LanMountainDesktop.PluginSdk\LanMountainDesktop.PluginSdk.csproj" Private="false" />
+    <None Include="plugin.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>

LanMountainDesktop.SamplePlugin/SamplePlugin.cs

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

LanMountainDesktop.SamplePlugin/SamplePluginRuntimeStatus.cs

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

LanMountainDesktop.SamplePlugin/SamplePluginSettingsView.cs

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

LanMountainDesktop.SamplePlugin/SamplePluginStatusClockWidget.cs

@@ -0,0 +1,227 @@
+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 DispatcherTimer _timer = new()
+    {
+        Interval = TimeSpan.FromSeconds(1)
+    };
+
+    private readonly PluginDesktopComponentContext _context;
+    private readonly TextBlock _timeTextBlock;
+    private readonly TextBlock _titleTextBlock;
+    private readonly StackPanel _statusPanel;
+
+    public SamplePluginStatusClockWidget(PluginDesktopComponentContext context)
+    {
+        _context = context;
+        _timeTextBlock = new TextBlock
+        {
+            Foreground = Brushes.White,
+            FontWeight = FontWeight.Bold,
+            HorizontalAlignment = HorizontalAlignment.Left
+        };
+        _titleTextBlock = new TextBlock
+        {
+            Text = "Plugin Status",
+            Foreground = new SolidColorBrush(Color.Parse("#FFBFE9FF")),
+            HorizontalAlignment = HorizontalAlignment.Left
+        };
+        _statusPanel = new StackPanel
+        {
+            Spacing = 8
+        };
+
+        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,
+                        _titleTextBlock
+                    }
+                },
+                new Border
+                {
+                    Background = new SolidColorBrush(Color.Parse("#1F082F49")),
+                    BorderBrush = new SolidColorBrush(Color.Parse("#5538BDF8")),
+                    BorderThickness = new Thickness(1),
+                    CornerRadius = new CornerRadius(18),
+                    Padding = new Thickness(12),
+                    Child = _statusPanel
+                }
+            }
+        };
+
+        Grid.SetRow(((Grid)Child).Children[1], 1);
+
+        _timer.Tick += OnTimerTick;
+        AttachedToVisualTree += OnAttachedToVisualTree;
+        DetachedFromVisualTree += OnDetachedFromVisualTree;
+        SizeChanged += OnSizeChanged;
+
+        var placementText = string.IsNullOrWhiteSpace(context.PlacementId)
+            ? "Preview instance created."
+            : $"Widget created for placement {context.PlacementId}.";
+        SamplePluginRuntimeStatus.MarkFrontendReady("Widget frontend surface rendered successfully.");
+        SamplePluginRuntimeStatus.MarkComponentCreated($"{placementText} Baseline footprint: 4x4.");
+
+        RefreshClock();
+        RefreshStatusPanel();
+        ApplyScale();
+    }
+
+    private void OnAttachedToVisualTree(object? sender, VisualTreeAttachmentEventArgs e)
+    {
+        RefreshClock();
+        RefreshStatusPanel();
+        _timer.Start();
+    }
+
+    private void OnDetachedFromVisualTree(object? sender, VisualTreeAttachmentEventArgs e)
+    {
+        _timer.Stop();
+    }
+
+    private void OnTimerTick(object? sender, EventArgs e)
+    {
+        RefreshClock();
+        RefreshStatusPanel();
+    }
+
+    private void OnSizeChanged(object? sender, SizeChangedEventArgs e)
+    {
+        ApplyScale();
+        RefreshStatusPanel();
+    }
+
+    private void RefreshClock()
+    {
+        _timeTextBlock.Text = DateTime.Now.ToString("HH:mm:ss");
+    }
+
+    private void RefreshStatusPanel()
+    {
+        _statusPanel.Children.Clear();
+
+        var basis = GetLayoutBasis();
+        var titleSize = Math.Clamp(basis * 0.072, 11, 16);
+        var detailSize = Math.Clamp(basis * 0.055, 10, 13);
+
+        foreach (var entry in SamplePluginRuntimeStatus.GetSnapshot())
+        {
+            var palette = GetPalette(entry.State);
+            var summaryText = $"{entry.Summary} - {entry.UpdatedAt.LocalDateTime:HH:mm:ss}";
+
+            _statusPanel.Children.Add(new Border
+            {
+                Background = new SolidColorBrush(palette.Background),
+                BorderBrush = new SolidColorBrush(palette.Border),
+                BorderThickness = new Thickness(1),
+                CornerRadius = new CornerRadius(12),
+                Padding = new Thickness(10, 8),
+                Child = new Grid
+                {
+                    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 = summaryText,
+                            FontSize = detailSize,
+                            Foreground = new SolidColorBrush(Color.Parse("#FFD7F2FF")),
+                            HorizontalAlignment = HorizontalAlignment.Right,
+                            TextAlignment = TextAlignment.Right,
+                            VerticalAlignment = VerticalAlignment.Center
+                        }
+                    }
+                }
+            });
+
+            var row = (Grid)((Border)_statusPanel.Children[^1]).Child!;
+            Grid.SetColumn(row.Children[1], 1);
+            Grid.SetColumn(row.Children[2], 2);
+        }
+    }
+
+    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);
+        _titleTextBlock.FontSize = Math.Clamp(basis * 0.07, 12, 18);
+    }
+
+    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"))
+        };
+    }
+}

LanMountainDesktop.SamplePlugin/plugin.json

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