0.7.2

0.7.1
2026-06-20 23:54:26 +08:00 · 2026-03-21 16:16:02 +08:00 · 2026-03-21 13:08:20 +08:00 · 2026-03-20 22:37:37 +08:00 · 2026-03-20 18:05:42 +08:00 · 2026-03-20 14:22:33 +08:00
435 changed files with 40467 additions and 21337 deletions
--- a/.codex/environments/environment.toml
+++ b/.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"
--- a/.github/FIX_REPORT.md
+++ b/.github/FIX_REPORT.md
@@ -8,14 +8,14 @@ MSBUILD : error MSB1003: Specify a project or solution file.
 The current working directory does not contain a project or solution file.
 ```

-**原因**: 项目中缺少 `LanMountainDesktop.sln` 解决方案文件，但工作流尝试执行 `dotnet restore` 而没有指定项目。
+**原因**: 项目中缺少 `LanMountainDesktop.slnx` 解决方案文件，但工作流尝试执行 `dotnet restore` 而没有指定项目。

 ---

 ## 🔧 已采取的修复

-### 1. 创建解决方案文件
-✅ 创建了标准的 `LanMountainDesktop.sln` 文件，包含：
+### 1. 创建 `.slnx` 解决方案文件
+✅ 创建了标准的 `LanMountainDesktop.slnx` 文件，包含：
 - `LanMountainDesktop/LanMountainDesktop.csproj`

 ### 2. 验证本地构建工作
@@ -35,10 +35,10 @@ The current working directory does not contain a project or solution file.

 ## 📋 解决方案文件内容

-包含主桌面项目的标准 Visual Studio 解决方案格式：
+包含主桌面项目的标准 XML 解决方案格式：

 ```
-LanMountainDesktop.sln
+LanMountainDesktop.slnx
 └── LanMountainDesktop (Desktop UI - Avalonia)
 ```

@@ -50,10 +50,11 @@ LanMountainDesktop.sln

 ```bash
 # 1. 添加新创建的解决方案文件
-git add LanMountainDesktop.sln
+git add LanMountainDesktop.slnx
+git add global.json

 # 2. 提交
-git commit -m "Add solution file for desktop project"
+git commit -m "Migrate desktop solution to .slnx"

 # 3. 推送
 git push origin main
@@ -92,7 +93,7 @@ git push origin v1.0.1
 | `.github/workflows/code-quality.yml` | 代码质量检查 | ✅ 可用 |
 | `.github/workflows/release.yml` | 多平台发布 | ✅ 可用 |
 | `.github/workflows/issue-management.yml` | Issue自动管理 | ✅ 可用 |
-| `LanMountainDesktop.sln` | 解决方案文件 | ✅ 已修复 |
+| `LanMountainDesktop.slnx` | 解决方案文件 | ✅ 已修复 |

 ---

--- a/.github/README.md
+++ b/.github/README.md
@@ -36,9 +36,10 @@
 - 扩展契约与字段说明见组件系统文档：`LanMountainDesktop/ComponentSystem/README.md`。

 ## 当前状态
- 项目包含桌面端与推荐后端两个子项目，并在同一 solution 中维护。
+- 项目包含桌面端与推荐后端两个子项目，并在同一 `LanMountainDesktop.slnx` 工作区中维护。
 - 配置默认写入本地：`%LOCALAPPDATA%\LanMountainDesktop\settings.json`。
 - 当前体验以 Windows 为主要目标平台。
+- SDK 版本由仓库根目录 `global.json` 锁定。

 ## 运行说明
 运行与环境准备已拆分到独立文档：[`run.md`](./run.md)
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -9,7 +9,7 @@ on:

 env:
  DOTNET_VERSION: '10.0.x'
-  Solution_Name: LanMountainDesktop.sln
+  Solution_Name: LanMountainDesktop.slnx

 jobs:
  build-windows:
@@ -71,10 +71,10 @@ jobs:
          dotnet-version: ${{ env.DOTNET_VERSION }}

      - name: Restore
-        run: dotnet restore
+        run: dotnet restore ${{ env.Solution_Name }}

      - name: Build
-        run: dotnet build --no-restore -c Release -v minimal
+        run: dotnet build ${{ env.Solution_Name }} --no-restore -c Release -v minimal

      - name: Upload artifacts
        uses: actions/upload-artifact@v4
@@ -101,10 +101,10 @@ jobs:
          dotnet-version: ${{ env.DOTNET_VERSION }}

      - name: Restore
-        run: dotnet restore
+        run: dotnet restore ${{ env.Solution_Name }}

      - name: Build
-        run: dotnet build --no-restore -c Release -v minimal
+        run: dotnet build ${{ env.Solution_Name }} --no-restore -c Release -v minimal

      - name: Upload artifacts
        uses: actions/upload-artifact@v4
@@ -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
--- a/.github/workflows/code-quality.yml
+++ b/.github/workflows/code-quality.yml
@@ -8,7 +8,7 @@ on:

 env:
  DOTNET_VERSION: '10.0.x'
-  Solution_Name: LanMountainDesktop.sln
+  Solution_Name: LanMountainDesktop.slnx

 jobs:
  analyze:
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -18,13 +18,15 @@ on:

 env:
  DOTNET_VERSION: '10.0.x'
-  Solution_Name: LanMountainDesktop.sln
+  Solution_Name: LanMountainDesktop.slnx

 jobs:
  prepare:
    runs-on: ubuntu-latest
    outputs:
      version: ${{ steps.version.outputs.version }}
+      assembly_version: ${{ steps.version.outputs.assembly_version }}
+      informational_version: ${{ steps.version.outputs.informational_version }}
      tag: ${{ steps.version.outputs.tag }}
      checkout_ref: ${{ steps.version.outputs.checkout_ref }}
    
@@ -47,8 +49,15 @@ jobs:
            CHECKOUT_REF="${GITHUB_SHA}"
          fi
          VERSION="${TAG#v}"
+          IFS='.' read -r -a VERSION_PARTS <<< "${VERSION}"
+          while [ "${#VERSION_PARTS[@]}" -lt 4 ]; do
+            VERSION_PARTS+=("0")
+          done
+          ASSEMBLY_VERSION="${VERSION_PARTS[0]}.${VERSION_PARTS[1]}.${VERSION_PARTS[2]}.${VERSION_PARTS[3]}"
          echo "tag=${TAG}" >> $GITHUB_OUTPUT
          echo "version=${VERSION}" >> $GITHUB_OUTPUT
+          echo "assembly_version=${ASSEMBLY_VERSION}" >> $GITHUB_OUTPUT
+          echo "informational_version=${VERSION}" >> $GITHUB_OUTPUT
          echo "checkout_ref=${CHECKOUT_REF}" >> $GITHUB_OUTPUT

  build-windows:
@@ -73,26 +82,16 @@ jobs:
        with:
          dotnet-version: ${{ env.DOTNET_VERSION }}

-      - name: Update version in .csproj
-        run: |
-          $VERSION = "${{ needs.prepare.outputs.version }}"
-          $csprojFiles = @(
-            "LanMountainDesktop/LanMountainDesktop.csproj"
-          )
-          
-          foreach ($csprojPath in $csprojFiles) {
-            Write-Host "Updating version in $csprojPath to $VERSION"
-            $content = Get-Content $csprojPath -Raw
-            $content = $content -replace '<Version>.*?</Version>', "<Version>$VERSION</Version>"
-            Set-Content $csprojPath $content
-          }
-        shell: pwsh
-
      - name: Restore
        run: dotnet restore ${{ env.Solution_Name }}

      - name: Build
-        run: dotnet build ${{ env.Solution_Name }} -c Release --no-restore -v minimal
+        run: >
+          dotnet build ${{ env.Solution_Name }} -c Release --no-restore -v minimal
+          -p:Version=${{ needs.prepare.outputs.version }}
+          -p:AssemblyVersion=${{ needs.prepare.outputs.assembly_version }}
+          -p:FileVersion=${{ needs.prepare.outputs.assembly_version }}
+          -p:InformationalVersion=${{ needs.prepare.outputs.informational_version }}

      - name: Publish
        run: |
@@ -106,7 +105,11 @@ jobs:
            -p:DebugType=none `
            -p:DebugSymbols=false `
            -p:PublishTrimmed=false `
-            -p:PublishReadyToRun=false
+            -p:PublishReadyToRun=false `
+            -p:Version=${{ needs.prepare.outputs.version }} `
+            -p:AssemblyVersion=${{ needs.prepare.outputs.assembly_version }} `
+            -p:FileVersion=${{ needs.prepare.outputs.assembly_version }} `
+            -p:InformationalVersion=${{ needs.prepare.outputs.informational_version }}
        shell: pwsh

      - name: Install Inno Setup
@@ -242,17 +245,16 @@ jobs:
        with:
          dotnet-version: ${{ env.DOTNET_VERSION }}

-      - name: Update version in .csproj
-        run: |
-          VERSION="${{ needs.prepare.outputs.version }}"
-          echo "Updating version in LanMountainDesktop.csproj to $VERSION"
-          sed -i "s/<Version>.*<\/Version>/<Version>$VERSION<\/Version>/" LanMountainDesktop/LanMountainDesktop.csproj
-
      - name: Restore
        run: dotnet restore ${{ env.Solution_Name }}

      - name: Build
-        run: dotnet build ${{ env.Solution_Name }} -c Release --no-restore -v minimal
+        run: >
+          dotnet build ${{ env.Solution_Name }} -c Release --no-restore -v minimal
+          -p:Version=${{ needs.prepare.outputs.version }}
+          -p:AssemblyVersion=${{ needs.prepare.outputs.assembly_version }}
+          -p:FileVersion=${{ needs.prepare.outputs.assembly_version }}
+          -p:InformationalVersion=${{ needs.prepare.outputs.informational_version }}

      - name: Publish
        run: |
@@ -266,7 +268,11 @@ jobs:
            -p:DebugType=none \
            -p:DebugSymbols=false \
            -p:PublishTrimmed=false \
-            -p:PublishReadyToRun=false
+            -p:PublishReadyToRun=false \
+            -p:Version=${{ needs.prepare.outputs.version }} \
+            -p:AssemblyVersion=${{ needs.prepare.outputs.assembly_version }} \
+            -p:FileVersion=${{ needs.prepare.outputs.assembly_version }} \
+            -p:InformationalVersion=${{ needs.prepare.outputs.informational_version }}

      - name: Package as DEB
        run: |
@@ -384,17 +390,16 @@ jobs:
        with:
          dotnet-version: ${{ env.DOTNET_VERSION }}

-      - name: Update version in .csproj
-        run: |
-          VERSION="${{ needs.prepare.outputs.version }}"
-          echo "Updating version in LanMountainDesktop.csproj to $VERSION"
-          sed -i '' "s/<Version>.*<\/Version>/<Version>$VERSION<\/Version>/" LanMountainDesktop/LanMountainDesktop.csproj
-
      - name: Restore
        run: dotnet restore ${{ env.Solution_Name }}

      - name: Build
-        run: dotnet build ${{ env.Solution_Name }} -c Release --no-restore -v minimal
+        run: >
+          dotnet build ${{ env.Solution_Name }} -c Release --no-restore -v minimal
+          -p:Version=${{ needs.prepare.outputs.version }}
+          -p:AssemblyVersion=${{ needs.prepare.outputs.assembly_version }}
+          -p:FileVersion=${{ needs.prepare.outputs.assembly_version }}
+          -p:InformationalVersion=${{ needs.prepare.outputs.informational_version }}

      - name: Publish
        run: |
@@ -408,7 +413,11 @@ jobs:
            -p:DebugType=none \
            -p:DebugSymbols=false \
            -p:PublishTrimmed=false \
-            -p:PublishReadyToRun=false
+            -p:PublishReadyToRun=false \
+            -p:Version=${{ needs.prepare.outputs.version }} \
+            -p:AssemblyVersion=${{ needs.prepare.outputs.assembly_version }} \
+            -p:FileVersion=${{ needs.prepare.outputs.assembly_version }} \
+            -p:InformationalVersion=${{ needs.prepare.outputs.informational_version }}

      - name: Package as DMG
        run: |
--- a/.gitignore
+++ b/.gitignore
@@ -490,4 +490,25 @@ nul
 /_build_verify_sample_plugin_capabilities
 /_build_verify_plugin_page_host
 /_build_verify_plugin_services
+/LanMountainDesktop.PluginSdk/_build_verify_*/
 /_build_obj
+
+# LanMountainDesktop local workspace files
+/.arts/
+/.knox/
+/.lingma/
+/.tmp/
+/publish-test/
+/validator-restore.log
+/temp_old_main.axaml
+/temp_old_main_utf8.axaml
+
+# LanMountainDesktop local packaging outputs
+/build-installer/
+/build-deb/
+/dmg-temp/
+/release-files/
+/LanMountainDesktop.app/
+/*.deb
+/*.dmg
+/*.AppImage
--- a/.trae/specs/class-schedule-enhancement/checklist.md
+++ b/.trae/specs/class-schedule-enhancement/checklist.md
@@ -0,0 +1,24 @@
+# Checklist
+
+## 1. 课表单双周解析修复
+
+- [x] 单周课程（WeekCountDiv=1）在单周正确显示
+- [x] 双周课程（WeekCountDiv=2）在双周正确显示
+- [x] 每周课程（WeekCountDiv=0）在所有周正确显示
+- [x] 多周轮转（2-32周）正确计算当前周期位置
+
+## 2. 课程动态移动功能
+
+- [x] 课程结束自动从视图移除
+- [x] 新课程自动移入视图可见区域
+- [x] 当日课程全部结束后自动切换到次日课程表
+
+## 3. 拖动交互功能
+
+- [x] 课程表支持上下拖动滚动
+- [x] 拖动操作流畅、响应及时
+
+## 4. 自动复位功能
+
+- [x] 用户手动拖动后，标记拖动状态
+- [x] 当前课程变化时自动复位到最新进行中课程
--- a/.trae/specs/class-schedule-enhancement/spec.md
+++ b/.trae/specs/class-schedule-enhancement/spec.md
@@ -0,0 +1,101 @@
+# 课程表组件功能优化规格说明书
+
+## Why
+
+当前课程表组件存在以下问题：
+1. 单双周课程解析逻辑存在缺陷，无法正确识别单周/双周/每周模式
+2. 课程无法动态移动，第一列始终显示进行中的课程，但存在无法正常移动的问题
+3. 缺少用户拖动交互功能
+4. 缺少拖动后的自动复位机制
+
+## What Changes
+
+- 修复 ClassIsland 课程单双周解析逻辑
+- 实现课程动态移动机制（当前课程结束自动上移）
+- 实现课程表上下拖动交互功能
+- 实现自动复位功能（课程结束后视图复位到最新进行中课程）
+
+## Impact
+
+### Affected specs
+- 课程表组件功能规范
+
+### Affected code
+- `Services/ClassIslandScheduleDataService.cs` - 课表解析服务
+- `Views/Components/ClassScheduleWidget.axaml.cs` - 课表组件
+
+---
+
+## ADDED Requirements
+
+### Requirement: 单双周课程解析
+
+系统 SHALL 能够正确解析包含单双周信息的课程数据。
+
+#### Scenario: 单周课程
+- **WHEN** 课程设置为单周上课
+- **THEN** 课程仅在单周显示
+
+#### Scenario: 双周课程
+- **WHEN** 课程设置为双周上课
+- **THEN** 课程仅在双周显示
+
+#### Scenario: 每周课程
+- **WHEN** 课程设置为每周上课
+- **THEN** 课程在所有周显示
+
+---
+
+### Requirement: 课程动态移动
+
+系统 SHALL 实现课程的动态移动机制。
+
+#### Scenario: 课程结束自动上移
+- **WHEN** 当前进行中的课程结束
+- **THEN** 课程列表自动向上移动
+- **AND THEN** 下一个进行中或即将开始的课程移至视图可见区域
+
+#### Scenario: 新课程移入视图
+- **WHEN** 新的课程即将开始
+- **THEN** 该课程自动移至视图可见区域
+
+#### Scenario: 当日课程全部结束
+- **WHEN** 当日所有课程已结束
+- **THEN** 自动显示次日课程表
+
+---
+
+### Requirement: 拖动交互功能
+
+系统 SHALL 提供课程表的上下拖动功能。
+
+#### Scenario: 拖动查看课程
+- **WHEN** 用户在课程表区域进行上下拖动
+- **THEN** 课程列表随拖动方向滚动
+- **AND THEN** 拖动操作流畅、响应及时
+
+---
+
+### Requirement: 自动复位功能
+
+系统 SHALL 在用户手动拖动后自动复位到当前课程。
+
+#### Scenario: 当前课程结束触发复位
+- **WHEN** 用户手动拖动课程表后，当前课程结束
+- **THEN** 视图自动复位到显示最新进行中课程的位置
+
+---
+
+## MODIFIED Requirements
+
+### Requirement: 课程解析逻辑
+
+**当前**: 单双周解析可能存在缺陷
+
+**修改后**: 正确识别 WeekCountDiv 和 WeekCountDivTotal 参数，准确判断单周/双周/每周模式
+
+---
+
+## REMOVED Requirements
+
+（无）
--- a/.trae/specs/class-schedule-enhancement/tasks.md
+++ b/.trae/specs/class-schedule-enhancement/tasks.md
@@ -0,0 +1,61 @@
+# Tasks
+
+## 1. 课表单双周解析修复
+
+- [x] Task 1.1: 分析 ClassIsland 课表单双周数据结构
+  - [x] 分析 ClassIsland Schedule.json 和 Profile.json 中的周数规则字段
+  - [x] 确认 WeekCountDiv 和 WeekCountDivTotal 的含义和取值范围
+
+- [x] Task 1.2: 修复 GetCyclePositionsByDate 方法
+  - [x] 检查单周开始日期的计算逻辑
+  - [x] 修复周期位置计算公式
+
+- [x] Task 1.3: 修复 CheckRegularClassPlan 方法
+  - [x] 验证 weekCountDiv 和 weekCountDivTotal 的匹配逻辑
+  - [x] 确保单周=1、双周=2、每周=0 的正确处理
+
+## 2. 课程动态移动功能
+
+- [x] Task 2.1: 分析当前课程状态检测逻辑
+  - [x] 查看如何判断课程是否为"当前进行中"
+
+- [x] Task 2.2: 实现定时刷新机制
+  - [x] 增加更频繁的刷新定时器（每分钟检查一次）
+  - [x] 实现课程状态变化检测
+
+- [x] Task 2.3: 实现动态移动逻辑
+  - [x] 课程结束后自动上移
+  - [x] 新课程自动移入视图
+
+- [x] Task 2.4: 实现次日课程切换
+  - [x] 当日所有课程结束后自动切换到次日
+
+## 3. 拖动交互功能
+
+- [x] Task 3.1: 实现 ScrollViewer 包裹
+  - [x] 修改 XAML 使用 ScrollViewer 包裹课程列表
+
+- [x] Task 3.2: 实现拖动手势处理
+  - [x] 添加 PointerPressed/PointerMoved/PointerReleased 处理
+  - [x] 实现平滑滚动逻辑
+
+## 4. 自动复位功能
+
+- [x] Task 4.1: 记录用户拖动状态
+  - [x] 添加用户是否手动拖动的标志位
+
+- [x] Task 4.2: 实现自动复位逻辑
+  - [x] 检测当前课程变化
+  - [x] 当用户手动拖动且当前课程变化时自动复位
+
+# Task Dependencies
+
+- Task 1.1 -> Task 1.2 -> Task 1.3
+- Task 2.1 -> Task 2.2 -> Task 2.3 -> Task 2.4
+- Task 3.1 -> Task 3.2
+- Task 4.1 -> Task 4.2
+
+# Parallelizable Tasks
+
+- Task 1.x (解析修复) 与 Task 3.x (拖动) 可以并行开发
+- Task 2.x (动态移动) 可以在 Task 1 完成后进行
--- a/.trae/specs/settings-page-fluent-redesign/checklist.md
+++ b/.trae/specs/settings-page-fluent-redesign/checklist.md
@@ -0,0 +1,32 @@
+# Checklist - 设置页面 Fluent 设计改造
+
+## Phase 1: 分析与准备
+
+- [ ] SettingsExpander 控件分析完成
+- [ ] 当前布局问题定位完成
+
+## Phase 2: 窗口布局调整
+
+- [ ] SettingsWindow 内容区域无额外 Border 包裹
+- [ ] 窗口整体视觉效果正常
+- [ ] 窗口圆角在不同模式下正确显示
+
+## Phase 3: 设置页面改造
+
+- [ ] AppearanceSettingsPage 无额外边框包裹
+- [ ] GeneralSettingsPage 无额外边框包裹
+- [ ] ComponentsSettingsPage 无额外边框包裹
+- [ ] PluginsSettingsPage 无额外边框包裹
+- [ ] AboutSettingsPage 无额外边框包裹
+
+## Phase 4: 视觉规范
+
+- [ ] 设置项间距统一
+- [ ] 圆角样式统一
+- [ ] 页面标题样式统一
+
+## 验证
+
+- [ ] 编译通过，无错误
+- [ ] 运行正常，设置页面可正常显示
+- [ ] 视觉效果符合 Fluent 设计风格
--- a/.trae/specs/settings-page-fluent-redesign/spec.md
+++ b/.trae/specs/settings-page-fluent-redesign/spec.md
@@ -0,0 +1,76 @@
+# 设置页面 Fluent 设计改造规格说明书
+
+## Why
+
+当前 LanMountainDesktop 设置页面存在以下问题：
+1. 右侧详细设置区域被额外边框包裹，未能实现 Fluent Avalonia 控件的完整填充效果
+2. 设置项未采用 Fluent 卡片设计风格，仍使用传统 Border + StackPanel 布局
+3. 与 ClassIsland 项目的视觉风格差异较大
+
+## What Changes
+
+- 移除页面内容区域的额外 Border 包裹，直接使用 ScrollViewer + StackPanel
+- 参考 ClassIsland 项目，引入 SettingsExpander 控件替代传统布局
+- 统一设置项的间距、圆角、字体等视觉规范
+- 修改窗口布局，移除内容区域的 glass-panel 样式
+
+## Impact
+
+### Affected specs
+- 设置页面 UI 布局规范
+- Fluent 设计风格适配
+
+### Affected code
+- `Views/SettingsPages/*.axaml` - 所有设置页面
+- `Views/SettingsWindow.axaml` - 设置窗口布局
+- `Styles/GlassModule.axaml` - 样式资源
+
+---
+
+## ADDED Requirements
+
+### Requirement: 设置页面 Fluent 卡片设计
+
+系统 SHALL 提供类似 ClassIsland 的 SettingsExpander 卡片式设置项。
+
+#### Scenario: 设置页面布局
+- **WHEN** 用户打开任意设置页面
+- **THEN** 页面使用 ScrollViewer 直接包裹内容，无额外 Border 包裹
+- **AND THEN** 设置项使用 SettingsExpander 或 Fluent 卡片样式
+
+### Requirement: 移除内容区域额外边框
+
+系统 SHALL 移除右侧内容区域的 glass-panel 边框包裹。
+
+#### Scenario: 内容区域无额外边框
+- **WHEN** 用户查看设置页面内容
+- **THEN** 内容直接显示在透明背景上，无额外边框包裹
+
+### Requirement: 设置项视觉规范
+
+系统 SHALL 统一设置项的视觉样式。
+
+#### Scenario: 设置项样式
+- **WHEN** 开发者创建新的设置项
+- **THEN** 使用统一的间距（Spacing）、圆角、字体大小
+- **AND THEN** 参考 ClassIsland 的 SettingsExpander 样式
+
+---
+
+## MODIFIED Requirements
+
+### Requirement: 设置页面布局结构
+
+**当前**: Border → ScrollViewer → Border → StackPanel → 内容
+
+**修改后**: ScrollViewer → StackPanel → 设置项（无额外 Border）
+
+---
+
+## REMOVED Requirements
+
+### Requirement: 传统 Border 包裹布局
+
+**Reason**: 实现 Fluent 设计风格，移除视觉噪音
+
+**Migration**: 将现有 Border 包裹改为直接内容布局
--- a/.trae/specs/settings-page-fluent-redesign/tasks.md
+++ b/.trae/specs/settings-page-fluent-redesign/tasks.md
@@ -0,0 +1,51 @@
+# Tasks - 设置页面 Fluent 设计改造
+
+## Phase 1: 分析与准备
+
+- [ ] Task 1.1: 分析 ClassIsland SettingsExpander 控件实现
+  - [ ] 查看 ClassIsland.Core 中的 SettingsExpander 定义
+  - [ ] 分析样式模板和视觉效果
+  - [ ] 确定是否需要自定义控件或使用现有替代方案
+
+- [ ] Task 1.2: 分析当前设置页面布局问题
+  - [ ] 定位右侧内容区域的 Border 包裹代码
+  - [ ] 分析 glass-panel 样式对布局的影响
+
+## Phase 2: 窗口布局调整
+
+- [ ] Task 2.1: 修改 SettingsWindow.axaml 内容区域布局
+  - [ ] 移除 Frame 外部的 glass-panel Border
+  - [ ] 直接使用透明背景
+  - [ ] 验证窗口整体视觉效果
+
+## Phase 3: 设置页面改造
+
+- [ ] Task 3.1: 改造 AppearanceSettingsPage 页面
+  - [ ] 移除外部的 glass-panel Border
+  - [ ] 调整内容布局为直接填充
+  - [ ] 验证视觉效果
+
+- [ ] Task 3.2: 改造 GeneralSettingsPage 页面
+  - [ ] 移除外部的 glass-panel Border
+  - [ ] 调整内容布局
+
+- [ ] Task 3.3: 改造其他设置页面
+  - [ ] ComponentsSettingsPage
+  - [ ] PluginsSettingsPage
+  - [ ] AboutSettingsPage
+
+## Phase 4: 视觉规范统一
+
+- [ ] Task 4.1: 统一设置项间距和圆角
+  - [ ] 定义统一的 Spacing 值
+  - [ ] 统一圆角大小
+
+- [ ] Task 4.2: 优化页面标题区域样式
+  - [ ] 调整 Page Header 字体大小
+  - [ ] 优化 Description 样式
+
+## Task Dependencies
+- Task 1.2 依赖 Task 1.1
+- Task 2.1 依赖 Task 1.2
+- Task 3.x 依赖 Task 2.1
+- Task 4.x 依赖 Task 3.x
--- a/Directory.Build.props
+++ b/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>
--- a/LanMountainDesktop.Appearance/AppearanceCornerRadiusTokenFactory.cs
+++ b/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);
+    }
+}
--- a/LanMountainDesktop.Appearance/LanMountainDesktop.Appearance.csproj
+++ b/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>
--- a/LanMountainDesktop.DesktopComponents.Runtime/LanMountainDesktop.DesktopComponents.Runtime.csproj
+++ b/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>
--- a/LanMountainDesktop.DesktopHost/DesktopBootstrap.cs
+++ b/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();
+    }
+}
--- a/LanMountainDesktop.DesktopHost/DesktopShellHost.cs
+++ b/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();
+    }
+}
--- a/LanMountainDesktop.DesktopHost/DesktopStartupCoordinator.cs
+++ b/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();
+}
--- a/LanMountainDesktop.DesktopHost/LanMountainDesktop.DesktopHost.csproj
+++ b/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>
--- a/LanMountainDesktop.DesktopHost/SettingsWindowHost.cs
+++ b/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);
+    }
+}
--- a/LanMountainDesktop.DesktopHost/ShutdownCoordinator.cs
+++ b/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);
+}
--- a/LanMountainDesktop.Host.Abstractions/ComponentChromeContext.cs
+++ b/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);
--- a/LanMountainDesktop.Host.Abstractions/IDesktopShellHost.cs
+++ b/LanMountainDesktop.Host.Abstractions/IDesktopShellHost.cs
@@ -0,0 +1,6 @@
+namespace LanMountainDesktop.Host.Abstractions;
+
+public interface IDesktopShellHost
+{
+    void Initialize();
+}
--- a/LanMountainDesktop.Host.Abstractions/LanMountainDesktop.Host.Abstractions.csproj
+++ b/LanMountainDesktop.Host.Abstractions/LanMountainDesktop.Host.Abstractions.csproj
@@ -0,0 +1,10 @@
+<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" />
+  </ItemGroup>
+</Project>
--- a/LanMountainDesktop.PluginSdk/IComponentEditorHostContext.cs
+++ b/LanMountainDesktop.PluginSdk/IComponentEditorHostContext.cs
@@ -0,0 +1,10 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public interface IComponentEditorHostContext
+{
+    void RequestRefresh();
+
+    void CloseEditor();
+
+    void RequestRestart(string? reason = null);
+}
--- a/LanMountainDesktop.PluginSdk/IComponentSettingsAccessor.cs
+++ b/LanMountainDesktop.PluginSdk/IComponentSettingsAccessor.cs
@@ -0,0 +1,24 @@
+using System.Collections.Generic;
+
+namespace LanMountainDesktop.PluginSdk;
+
+public interface IComponentSettingsAccessor
+{
+    string ComponentId { get; }
+
+    string? PlacementId { get; }
+
+    T LoadSnapshot<T>() where T : new();
+
+    void SaveSnapshot<T>(T snapshot, IReadOnlyCollection<string>? changedKeys = null);
+
+    T LoadSection<T>(string sectionId) where T : new();
+
+    void SaveSection<T>(string sectionId, T section, IReadOnlyCollection<string>? changedKeys = null);
+
+    void DeleteSection(string sectionId);
+
+    T? GetValue<T>(string key);
+
+    void SetValue<T>(string key, T value, IReadOnlyCollection<string>? changedKeys = null);
+}
--- a/LanMountainDesktop.PluginSdk/IHostApplicationLifecycle.cs
+++ b/LanMountainDesktop.PluginSdk/IHostApplicationLifecycle.cs
@@ -0,0 +1,12 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed record HostApplicationLifecycleRequest(
+    string? Source = null,
+    string? Reason = null);
+
+public interface IHostApplicationLifecycle
+{
+    bool TryExit(HostApplicationLifecycleRequest? request = null);
+
+    bool TryRestart(HostApplicationLifecycleRequest? request = null);
+}
--- a/LanMountainDesktop.PluginSdk/IPlugin.cs
+++ b/LanMountainDesktop.PluginSdk/IPlugin.cs
@@ -1,6 +1,9 @@
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+
 namespace LanMountainDesktop.PluginSdk;

 public interface IPlugin
 {
-    void Initialize(IPluginContext context);
+    void Initialize(HostBuilderContext context, IServiceCollection services);
 }
--- a/LanMountainDesktop.PluginSdk/IPluginAppearanceContext.cs
+++ b/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);
+}
--- a/LanMountainDesktop.PluginSdk/IPluginContext.cs
+++ b/LanMountainDesktop.PluginSdk/IPluginContext.cs
@@ -1,27 +1,6 @@
-using System.Collections.Generic;
-
 namespace LanMountainDesktop.PluginSdk;

-public interface IPluginContext
+[Obsolete("Plugin API 3.0.0 uses IPluginRuntimeContext and IServiceCollection-based initialization.")]
+public interface IPluginContext : IPluginRuntimeContext
 {
-    PluginManifest Manifest { get; }
-
-    string PluginDirectory { get; }
-
-    string DataDirectory { get; }
-
-    IServiceProvider Services { get; }
-
-    IReadOnlyDictionary<string, object?> Properties { get; }
-
-    T? GetService<T>();
-
-    bool TryGetProperty<T>(string key, out T? value);
-
-    void RegisterService<TService>(TService service)
-        where TService : class;
-
-    void RegisterSettingsPage(PluginSettingsPageRegistration registration);
-
-    void RegisterDesktopComponent(PluginDesktopComponentRegistration registration);
 }
--- a/LanMountainDesktop.PluginSdk/IPluginExportRegistry.cs
+++ b/LanMountainDesktop.PluginSdk/IPluginExportRegistry.cs
@@ -0,0 +1,13 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public interface IPluginExportRegistry
+{
+    IReadOnlyList<PluginServiceExportDescriptor> GetExports();
+
+    IReadOnlyList<PluginServiceExportDescriptor> GetExports(Type contractType);
+
+    PluginServiceExportDescriptor? GetExport(Type contractType, string providerPluginId);
+
+    TContract? GetExport<TContract>(string providerPluginId)
+        where TContract : class;
+}
--- a/LanMountainDesktop.PluginSdk/IPluginPackageManager.cs
+++ b/LanMountainDesktop.PluginSdk/IPluginPackageManager.cs
@@ -0,0 +1,8 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public interface IPluginPackageManager
+{
+    IReadOnlyList<InstalledPluginInfo> GetInstalledPlugins();
+
+    PluginPackageInstallResult InstallPackage(string packagePath);
+}
--- a/LanMountainDesktop.PluginSdk/IPluginRuntimeContext.cs
+++ b/LanMountainDesktop.PluginSdk/IPluginRuntimeContext.cs
@@ -0,0 +1,20 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public interface IPluginRuntimeContext
+{
+    PluginManifest Manifest { get; }
+
+    string PluginDirectory { get; }
+
+    string DataDirectory { get; }
+
+    IServiceProvider Services { get; }
+
+    IReadOnlyDictionary<string, object?> Properties { get; }
+
+    IPluginAppearanceContext Appearance { get; }
+
+    T? GetService<T>();
+
+    bool TryGetProperty<T>(string key, out T? value);
+}
--- a/LanMountainDesktop.PluginSdk/IPluginSettingsService.cs
+++ b/LanMountainDesktop.PluginSdk/IPluginSettingsService.cs
@@ -0,0 +1,21 @@
+using System.Collections.Generic;
+
+namespace LanMountainDesktop.PluginSdk;
+
+public interface IPluginSettingsService
+{
+    string PluginId { get; }
+
+    IComponentSettingsAccessor GetComponentAccessor(string componentId, string? placementId);
+
+    T LoadComponentSection<T>(string componentId, string? placementId, string sectionId) where T : new();
+
+    void SaveComponentSection<T>(
+        string componentId,
+        string? placementId,
+        string sectionId,
+        T section,
+        IReadOnlyCollection<string>? changedKeys = null);
+
+    void DeleteComponentSection(string componentId, string? placementId, string sectionId);
+}
--- a/LanMountainDesktop.PluginSdk/ISettingsCatalog.cs
+++ b/LanMountainDesktop.PluginSdk/ISettingsCatalog.cs
@@ -0,0 +1,10 @@
+using System.Collections.Generic;
+
+namespace LanMountainDesktop.PluginSdk;
+
+public interface ISettingsCatalog
+{
+    IReadOnlyList<SettingsSectionDefinition> GetSections();
+
+    IReadOnlyList<SettingsSectionDefinition> GetSections(SettingsScope scope);
+}
--- a/LanMountainDesktop.PluginSdk/ISettingsPageHostContext.cs
+++ b/LanMountainDesktop.PluginSdk/ISettingsPageHostContext.cs
@@ -0,0 +1,12 @@
+using Avalonia.Controls;
+
+namespace LanMountainDesktop.PluginSdk;
+
+public interface ISettingsPageHostContext
+{
+    void OpenDrawer(Control content, string? title = null);
+
+    void CloseDrawer();
+
+    void RequestRestart(string? reason = null);
+}
--- a/LanMountainDesktop.PluginSdk/ISettingsService.cs
+++ b/LanMountainDesktop.PluginSdk/ISettingsService.cs
@@ -0,0 +1,56 @@
+using System.Collections.Generic;
+
+namespace LanMountainDesktop.PluginSdk;
+
+public interface ISettingsService
+{
+    event EventHandler<SettingsChangedEvent>? Changed;
+
+    T LoadSnapshot<T>(SettingsScope scope, string? subjectId = null, string? placementId = null) where T : new();
+
+    void SaveSnapshot<T>(
+        SettingsScope scope,
+        T snapshot,
+        string? subjectId = null,
+        string? placementId = null,
+        string? sectionId = null,
+        IReadOnlyCollection<string>? changedKeys = null);
+
+    T LoadSection<T>(
+        SettingsScope scope,
+        string subjectId,
+        string sectionId,
+        string? placementId = null) where T : new();
+
+    void SaveSection<T>(
+        SettingsScope scope,
+        string subjectId,
+        string sectionId,
+        T section,
+        string? placementId = null,
+        IReadOnlyCollection<string>? changedKeys = null);
+
+    void DeleteSection(
+        SettingsScope scope,
+        string subjectId,
+        string sectionId,
+        string? placementId = null);
+
+    T? GetValue<T>(
+        SettingsScope scope,
+        string key,
+        string? subjectId = null,
+        string? placementId = null,
+        string? sectionId = null);
+
+    void SetValue<T>(
+        SettingsScope scope,
+        string key,
+        T value,
+        string? subjectId = null,
+        string? placementId = null,
+        string? sectionId = null,
+        IReadOnlyCollection<string>? changedKeys = null);
+
+    IComponentSettingsAccessor GetComponentAccessor(string componentId, string? placementId);
+}
--- a/LanMountainDesktop.PluginSdk/InstalledPluginInfo.cs
+++ b/LanMountainDesktop.PluginSdk/InstalledPluginInfo.cs
@@ -0,0 +1,8 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed record InstalledPluginInfo(
+    PluginManifest Manifest,
+    bool IsEnabled,
+    bool IsLoaded,
+    bool IsPackage,
+    string? ErrorMessage);
--- a/LanMountainDesktop.PluginSdk/LanMountainDesktop.PluginSdk.csproj
+++ b/LanMountainDesktop.PluginSdk/LanMountainDesktop.PluginSdk.csproj
@@ -1,14 +1,32 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
-    <Version>1.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>
+    <Compile Remove="_build_verify_*\**\*.cs" />
    <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>
--- a/LanMountainDesktop.PluginSdk/LoadedPlugin.cs
+++ b/LanMountainDesktop.PluginSdk/LoadedPlugin.cs
@@ -1,83 +0,0 @@
-using System.Reflection;
-using System.Threading;
-
-namespace LanMountainDesktop.PluginSdk;
-
-public sealed class LoadedPlugin : IDisposable, IAsyncDisposable
-{
-    private int _disposed;
-
-    internal LoadedPlugin(
-        PluginManifest manifest,
-        string sourcePath,
-        string assemblyPath,
-        Assembly assembly,
-        IPlugin plugin,
-        IPluginContext context,
-        IReadOnlyList<PluginSettingsPageRegistration> settingsPages,
-        IReadOnlyList<PluginDesktopComponentRegistration> desktopComponents,
-        PluginLoadContext loadContext)
-    {
-        Manifest = manifest;
-        SourcePath = sourcePath;
-        AssemblyPath = assemblyPath;
-        Assembly = assembly;
-        Plugin = plugin;
-        Context = context;
-        SettingsPages = settingsPages;
-        DesktopComponents = desktopComponents;
-        LoadContext = loadContext;
-    }
-
-    public PluginManifest Manifest { get; }
-
-    public string SourcePath { get; }
-
-    public string AssemblyPath { get; }
-
-    public Assembly Assembly { get; }
-
-    public IPlugin Plugin { get; }
-
-    public IPluginContext Context { get; }
-
-    public IReadOnlyList<PluginSettingsPageRegistration> SettingsPages { get; }
-
-    public IReadOnlyList<PluginDesktopComponentRegistration> DesktopComponents { get; }
-
-    public PluginLoadContext LoadContext { get; }
-
-    public void Dispose()
-    {
-        DisposeAsync().AsTask().GetAwaiter().GetResult();
-    }
-
-    public async ValueTask DisposeAsync()
-    {
-        if (Interlocked.Exchange(ref _disposed, 1) != 0)
-        {
-            return;
-        }
-
-        if (Plugin is IAsyncDisposable asyncDisposable)
-        {
-            await asyncDisposable.DisposeAsync();
-        }
-        else if (Plugin is IDisposable disposable)
-        {
-            disposable.Dispose();
-        }
-
-        if (Context is IAsyncDisposable asyncContext)
-        {
-            await asyncContext.DisposeAsync();
-        }
-        else if (Context is IDisposable disposableContext)
-        {
-            disposableContext.Dispose();
-        }
-
-        LoadContext.Unload();
-        GC.SuppressFinalize(this);
-    }
-}
--- a/LanMountainDesktop.PluginSdk/PluginAppearanceContext.cs
+++ b/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);
+    }
+}
--- a/LanMountainDesktop.PluginSdk/PluginAppearanceSnapshot.cs
+++ b/LanMountainDesktop.PluginSdk/PluginAppearanceSnapshot.cs
@@ -0,0 +1,6 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed record PluginAppearanceSnapshot(
+    double GlobalCornerRadiusScale,
+    PluginCornerRadiusTokens CornerRadiusTokens,
+    string ThemeVariant);
--- a/LanMountainDesktop.PluginSdk/PluginBase.cs
+++ b/LanMountainDesktop.PluginSdk/PluginBase.cs
@@ -1,8 +1,11 @@
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+
 namespace LanMountainDesktop.PluginSdk;

 public abstract class PluginBase : IPlugin
 {
-    public virtual void Initialize(IPluginContext context)
+    public virtual void Initialize(HostBuilderContext context, IServiceCollection services)
    {
    }
 }
--- a/LanMountainDesktop.PluginSdk/PluginCornerRadiusPreset.cs
+++ b/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
+}
--- a/LanMountainDesktop.PluginSdk/PluginCornerRadiusTokens.cs
+++ b/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);
+    }
+}
--- a/LanMountainDesktop.PluginSdk/PluginDesktopComponentContext.cs
+++ b/LanMountainDesktop.PluginSdk/PluginDesktopComponentContext.cs
@@ -10,7 +10,9 @@ public sealed class PluginDesktopComponentContext
        IReadOnlyDictionary<string, object?> properties,
        string componentId,
        string? placementId,
-        double cellSize)
+        double cellSize,
+        IPluginAppearanceContext appearance,
+        IPluginSettingsService? pluginSettings = null)
    {
        ArgumentNullException.ThrowIfNull(manifest);
        ArgumentException.ThrowIfNullOrWhiteSpace(pluginDirectory);
@@ -18,6 +20,7 @@ public sealed class PluginDesktopComponentContext
        ArgumentException.ThrowIfNullOrWhiteSpace(componentId);
        ArgumentNullException.ThrowIfNull(services);
        ArgumentNullException.ThrowIfNull(properties);
+        ArgumentNullException.ThrowIfNull(appearance);

        Manifest = manifest;
        PluginDirectory = pluginDirectory;
@@ -27,6 +30,8 @@ public sealed class PluginDesktopComponentContext
        ComponentId = componentId.Trim();
        PlacementId = string.IsNullOrWhiteSpace(placementId) ? null : placementId.Trim();
        CellSize = Math.Max(1, cellSize);
+        Appearance = appearance;
+        PluginSettings = pluginSettings;
    }

    public PluginManifest Manifest { get; }
@@ -45,6 +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));
--- a/LanMountainDesktop.PluginSdk/PluginDesktopComponentEditorContext.cs
+++ b/LanMountainDesktop.PluginSdk/PluginDesktopComponentEditorContext.cs
@@ -0,0 +1,71 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed class PluginDesktopComponentEditorContext
+{
+    public PluginDesktopComponentEditorContext(
+        PluginManifest manifest,
+        string pluginDirectory,
+        string dataDirectory,
+        IServiceProvider services,
+        IReadOnlyDictionary<string, object?> properties,
+        string componentId,
+        string? placementId,
+        IPluginSettingsService? pluginSettings,
+        IComponentEditorHostContext hostContext)
+    {
+        ArgumentNullException.ThrowIfNull(manifest);
+        ArgumentException.ThrowIfNullOrWhiteSpace(pluginDirectory);
+        ArgumentException.ThrowIfNullOrWhiteSpace(dataDirectory);
+        ArgumentException.ThrowIfNullOrWhiteSpace(componentId);
+        ArgumentNullException.ThrowIfNull(services);
+        ArgumentNullException.ThrowIfNull(properties);
+        ArgumentNullException.ThrowIfNull(hostContext);
+
+        Manifest = manifest;
+        PluginDirectory = pluginDirectory;
+        DataDirectory = dataDirectory;
+        Services = services;
+        Properties = properties;
+        ComponentId = componentId.Trim();
+        PlacementId = string.IsNullOrWhiteSpace(placementId) ? null : placementId.Trim();
+        PluginSettings = pluginSettings;
+        HostContext = hostContext;
+    }
+
+    public PluginManifest Manifest { get; }
+
+    public string PluginDirectory { get; }
+
+    public string DataDirectory { get; }
+
+    public IServiceProvider Services { get; }
+
+    public IReadOnlyDictionary<string, object?> Properties { get; }
+
+    public string ComponentId { get; }
+
+    public string? PlacementId { get; }
+
+    public IPluginSettingsService? PluginSettings { get; }
+
+    public IComponentEditorHostContext HostContext { get; }
+
+    public T? GetService<T>()
+    {
+        return (T?)Services.GetService(typeof(T));
+    }
+
+    public bool TryGetProperty<T>(string key, out T? value)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(key);
+
+        if (Properties.TryGetValue(key, out var rawValue) && rawValue is T typedValue)
+        {
+            value = typedValue;
+            return true;
+        }
+
+        value = default;
+        return false;
+    }
+}
--- a/LanMountainDesktop.PluginSdk/PluginDesktopComponentEditorRegistration.cs
+++ b/LanMountainDesktop.PluginSdk/PluginDesktopComponentEditorRegistration.cs
@@ -0,0 +1,77 @@
+using Avalonia.Controls;
+
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed class PluginDesktopComponentEditorRegistration
+{
+    public PluginDesktopComponentEditorRegistration(
+        string componentId,
+        Func<IServiceProvider, PluginDesktopComponentEditorContext, Control> editorFactory,
+        double preferredWidth = 720d,
+        double preferredHeight = 540d,
+        double minScale = 0.85d,
+        double maxScale = 1.45d)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(componentId);
+        ArgumentNullException.ThrowIfNull(editorFactory);
+
+        if (preferredWidth <= 0)
+        {
+            throw new ArgumentOutOfRangeException(nameof(preferredWidth));
+        }
+
+        if (preferredHeight <= 0)
+        {
+            throw new ArgumentOutOfRangeException(nameof(preferredHeight));
+        }
+
+        if (minScale <= 0)
+        {
+            throw new ArgumentOutOfRangeException(nameof(minScale));
+        }
+
+        if (maxScale < minScale)
+        {
+            throw new ArgumentOutOfRangeException(nameof(maxScale));
+        }
+
+        ComponentId = componentId.Trim();
+        EditorFactory = editorFactory;
+        PreferredWidth = preferredWidth;
+        PreferredHeight = preferredHeight;
+        MinScale = minScale;
+        MaxScale = maxScale;
+        AspectRatio = preferredWidth / preferredHeight;
+    }
+
+    public PluginDesktopComponentEditorRegistration(
+        string componentId,
+        Func<PluginDesktopComponentEditorContext, Control> editorFactory,
+        double preferredWidth = 720d,
+        double preferredHeight = 540d,
+        double minScale = 0.85d,
+        double maxScale = 1.45d)
+        : this(
+            componentId,
+            (_, context) => editorFactory(context),
+            preferredWidth,
+            preferredHeight,
+            minScale,
+            maxScale)
+    {
+    }
+
+    public string ComponentId { get; }
+
+    public Func<IServiceProvider, PluginDesktopComponentEditorContext, Control> EditorFactory { get; }
+
+    public double PreferredWidth { get; }
+
+    public double PreferredHeight { get; }
+
+    public double MinScale { get; }
+
+    public double MaxScale { get; }
+
+    public double AspectRatio { get; }
+}
--- a/LanMountainDesktop.PluginSdk/PluginDesktopComponentOptions.cs
+++ b/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; }
+}
--- a/LanMountainDesktop.PluginSdk/PluginDesktopComponentRegistration.cs
+++ b/LanMountainDesktop.PluginSdk/PluginDesktopComponentRegistration.cs
@@ -5,39 +5,38 @@ namespace LanMountainDesktop.PluginSdk;
 public sealed class PluginDesktopComponentRegistration
 {
    public PluginDesktopComponentRegistration(
-        string componentId,
-        string displayName,
-        Func<PluginDesktopComponentContext, Control> controlFactory,
-        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)
+        Func<IServiceProvider, PluginDesktopComponentContext, Control> controlFactory,
+        PluginDesktopComponentOptions options)
    {
-        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();
-        DisplayName = displayName.Trim();
-        DisplayNameLocalizationKey = string.IsNullOrWhiteSpace(displayNameLocalizationKey)
+        ComponentId = options.ComponentId.Trim();
+        DisplayName = options.DisplayName.Trim();
+        DisplayNameLocalizationKey = string.IsNullOrWhiteSpace(options.DisplayNameLocalizationKey)
            ? null
-            : displayNameLocalizationKey.Trim();
+            : options.DisplayNameLocalizationKey.Trim();
        ControlFactory = controlFactory;
-        IconKey = iconKey.Trim();
-        Category = category.Trim();
-        MinWidthCells = Math.Max(1, minWidthCells);
-        MinHeightCells = Math.Max(1, minHeightCells);
-        AllowDesktopPlacement = allowDesktopPlacement;
-        AllowStatusBarPlacement = allowStatusBarPlacement;
-        ResizeMode = resizeMode;
-        CornerRadiusResolver = cornerRadiusResolver;
+        IconKey = options.IconKey.Trim();
+        Category = options.Category.Trim();
+        MinWidthCells = Math.Max(1, options.MinWidthCells);
+        MinHeightCells = Math.Max(1, options.MinHeightCells);
+        AllowDesktopPlacement = options.AllowDesktopPlacement;
+        AllowStatusBarPlacement = options.AllowStatusBarPlacement;
+        ResizeMode = options.ResizeMode;
+        CornerRadiusPreset = options.CornerRadiusPreset;
+        CornerRadiusResolver = options.CornerRadiusResolver;
+    }
+
+    public PluginDesktopComponentRegistration(
+        Func<PluginDesktopComponentContext, Control> controlFactory,
+        PluginDesktopComponentOptions options)
+        : this((_, context) => controlFactory(context), options)
+    {
    }

    public string ComponentId { get; }
@@ -46,7 +45,7 @@ public sealed class PluginDesktopComponentRegistration

    public string? DisplayNameLocalizationKey { get; }

-    public Func<PluginDesktopComponentContext, Control> ControlFactory { get; }
+    public Func<IServiceProvider, PluginDesktopComponentContext, Control> ControlFactory { get; }

    public string IconKey { get; }

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

    private PluginManifest NormalizeAndValidate(string manifestPath)
    {
+        var normalizedSharedContracts = NormalizeSharedContracts(manifestPath, SharedContracts);
        var normalized = this with
        {
            Id = RequireValue(Id, nameof(Id), manifestPath),
@@ -65,7 +67,8 @@ public sealed record PluginManifest(
            Description = NormalizeOptionalValue(Description),
            Author = NormalizeOptionalValue(Author),
            Version = NormalizeOptionalValue(Version),
-            ApiVersion = NormalizeOptionalValue(ApiVersion) ?? PluginSdkInfo.ApiVersion
+            ApiVersion = NormalizeOptionalValue(ApiVersion) ?? PluginSdkInfo.ApiVersion,
+            SharedContracts = normalizedSharedContracts
        };

        if (!System.Version.TryParse(normalized.ApiVersion, out var requestedVersion))
@@ -82,7 +85,44 @@ public sealed record PluginManifest(
        if (requestedVersion.Major != currentVersion.Major)
        {
            throw new InvalidOperationException(
-                $"Plugin '{normalized.Id}' targets API version '{normalized.ApiVersion}', but the host provides '{PluginSdkInfo.ApiVersion}'.");
+                $"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 and rejects v{requestedVersion.Major}.x packages by default. " +
+                $"Migrate the plugin manifest and code to API {PluginSdkInfo.ApiVersion}, then rebuild and republish the package.");
+        }
+
+        return normalized;
+    }
+
+    private static IReadOnlyList<PluginSharedContractReference> NormalizeSharedContracts(
+        string manifestPath,
+        IReadOnlyList<PluginSharedContractReference>? sharedContracts)
+    {
+        if (sharedContracts is null || sharedContracts.Count == 0)
+        {
+            return Array.Empty<PluginSharedContractReference>();
+        }
+
+        var normalized = new List<PluginSharedContractReference>(sharedContracts.Count);
+        var seenIds = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
+
+        foreach (var contract in sharedContracts)
+        {
+            if (contract is null)
+            {
+                throw new InvalidOperationException(
+                    $"Plugin manifest '{manifestPath}' contains a null shared contract declaration.");
+            }
+
+            var normalizedContract = contract.NormalizeAndValidate(manifestPath);
+            var contractKey = $"{normalizedContract.Id}@{normalizedContract.Version}";
+            if (!seenIds.Add(contractKey))
+            {
+                throw new InvalidOperationException(
+                    $"Plugin manifest '{manifestPath}' declares duplicate shared contract '{contractKey}'.");
+            }
+
+            normalized.Add(normalizedContract);
        }

        return normalized;
--- a/LanMountainDesktop.PluginSdk/PluginPackageInstallResult.cs
+++ b/LanMountainDesktop.PluginSdk/PluginPackageInstallResult.cs
@@ -0,0 +1,6 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed record PluginPackageInstallResult(
+    PluginManifest Manifest,
+    bool ReplacedExisting,
+    bool RestartRequired);
--- a/LanMountainDesktop.PluginSdk/PluginSdkInfo.cs
+++ b/LanMountainDesktop.PluginSdk/PluginSdkInfo.cs
@@ -2,7 +2,7 @@ namespace LanMountainDesktop.PluginSdk;

 public static class PluginSdkInfo
 {
-    public const string ApiVersion = "1.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";
--- a/LanMountainDesktop.PluginSdk/PluginServiceCollectionExtensions.cs
+++ b/LanMountainDesktop.PluginSdk/PluginServiceCollectionExtensions.cs
@@ -0,0 +1,103 @@
+using Avalonia.Controls;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace LanMountainDesktop.PluginSdk;
+
+public static class PluginServiceCollectionExtensions
+{
+    public static IServiceCollection AddPluginSettingsSection(
+        this IServiceCollection services,
+        string id,
+        string titleLocalizationKey,
+        Action<PluginSettingsSectionBuilder> configure,
+        string? descriptionLocalizationKey = null,
+        string iconKey = "PuzzlePiece",
+        int sortOrder = 0)
+    {
+        ArgumentNullException.ThrowIfNull(services);
+        ArgumentNullException.ThrowIfNull(configure);
+
+        var builder = new PluginSettingsSectionBuilder(
+            id,
+            titleLocalizationKey,
+            descriptionLocalizationKey,
+            iconKey,
+            sortOrder);
+        configure(builder);
+        services.AddSingleton(builder.Build());
+        return services;
+    }
+
+    public static IServiceCollection AddPluginDesktopComponent<TControl>(
+        this IServiceCollection services,
+        PluginDesktopComponentOptions options)
+        where TControl : Control
+    {
+        ArgumentNullException.ThrowIfNull(services);
+        ArgumentNullException.ThrowIfNull(options);
+
+        services.AddSingleton(new PluginDesktopComponentRegistration(
+            (provider, context) => ActivatorUtilities.CreateInstance<TControl>(provider, context),
+            options));
+        return services;
+    }
+
+    public static IServiceCollection AddPluginDesktopComponentEditor<TControl>(
+        this IServiceCollection services,
+        string componentId,
+        double preferredWidth = 720d,
+        double preferredHeight = 540d,
+        double minScale = 0.85d,
+        double maxScale = 1.45d)
+        where TControl : Control
+    {
+        ArgumentNullException.ThrowIfNull(services);
+
+        services.AddSingleton(new PluginDesktopComponentEditorRegistration(
+            componentId,
+            (provider, context) => ActivatorUtilities.CreateInstance<TControl>(provider, context),
+            preferredWidth,
+            preferredHeight,
+            minScale,
+            maxScale));
+        return services;
+    }
+
+    public static IServiceCollection AddPluginExport<TContract, TImplementation>(this IServiceCollection services)
+        where TContract : class
+        where TImplementation : class, TContract
+    {
+        ArgumentNullException.ThrowIfNull(services);
+
+        EnsureSingletonRegistration<TContract, TImplementation>(services);
+
+        if (!services.Any(descriptor =>
+                descriptor.ServiceType == typeof(PluginServiceExportRegistration) &&
+                descriptor.ImplementationInstance is PluginServiceExportRegistration existing &&
+                existing.ContractType == typeof(TContract) &&
+                existing.ImplementationType == typeof(TImplementation)))
+        {
+            services.AddSingleton(new PluginServiceExportRegistration(typeof(TContract), typeof(TImplementation)));
+        }
+
+        return services;
+    }
+
+    private static void EnsureSingletonRegistration<TContract, TImplementation>(IServiceCollection services)
+        where TContract : class
+        where TImplementation : class, TContract
+    {
+        var contractDescriptor = services.LastOrDefault(descriptor => descriptor.ServiceType == typeof(TContract));
+        if (contractDescriptor is null)
+        {
+            services.AddSingleton<TContract, TImplementation>();
+            return;
+        }
+
+        if (contractDescriptor.Lifetime != ServiceLifetime.Singleton)
+        {
+            throw new InvalidOperationException(
+                $"Exported contract '{typeof(TContract).FullName}' must be registered as Singleton.");
+        }
+    }
+}
--- a/LanMountainDesktop.PluginSdk/PluginServiceExportDescriptor.cs
+++ b/LanMountainDesktop.PluginSdk/PluginServiceExportDescriptor.cs
@@ -0,0 +1,6 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed record PluginServiceExportDescriptor(
+    string ProviderPluginId,
+    Type ContractType,
+    object ServiceInstance);
--- a/LanMountainDesktop.PluginSdk/PluginServiceExportRegistration.cs
+++ b/LanMountainDesktop.PluginSdk/PluginServiceExportRegistration.cs
@@ -0,0 +1,17 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed class PluginServiceExportRegistration
+{
+    public PluginServiceExportRegistration(Type contractType, Type implementationType)
+    {
+        ArgumentNullException.ThrowIfNull(contractType);
+        ArgumentNullException.ThrowIfNull(implementationType);
+
+        ContractType = contractType;
+        ImplementationType = implementationType;
+    }
+
+    public Type ContractType { get; }
+
+    public Type ImplementationType { get; }
+}
--- a/LanMountainDesktop.PluginSdk/PluginSettingsPageRegistration.cs
+++ b/LanMountainDesktop.PluginSdk/PluginSettingsPageRegistration.cs
@@ -1,30 +0,0 @@
-using Avalonia.Controls;
-
-namespace LanMountainDesktop.PluginSdk;
-
-public sealed class PluginSettingsPageRegistration
-{
-    public PluginSettingsPageRegistration(
-        string id,
-        string title,
-        Func<Control> contentFactory,
-        int sortOrder = 0)
-    {
-        ArgumentException.ThrowIfNullOrWhiteSpace(id);
-        ArgumentException.ThrowIfNullOrWhiteSpace(title);
-        ArgumentNullException.ThrowIfNull(contentFactory);
-
-        Id = id.Trim();
-        Title = title.Trim();
-        ContentFactory = contentFactory;
-        SortOrder = sortOrder;
-    }
-
-    public string Id { get; }
-
-    public string Title { get; }
-
-    public int SortOrder { get; }
-
-    public Func<Control> ContentFactory { get; }
-}
--- a/LanMountainDesktop.PluginSdk/PluginSettingsSectionBuilder.cs
+++ b/LanMountainDesktop.PluginSdk/PluginSettingsSectionBuilder.cs
@@ -0,0 +1,147 @@
+using System.Collections.Generic;
+
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed class PluginSettingsSectionBuilder
+{
+    private readonly List<SettingsOptionDefinition> _options = [];
+
+    internal PluginSettingsSectionBuilder(
+        string id,
+        string titleLocalizationKey,
+        string? descriptionLocalizationKey,
+        string iconKey,
+        int sortOrder)
+    {
+        Id = id;
+        TitleLocalizationKey = titleLocalizationKey;
+        DescriptionLocalizationKey = descriptionLocalizationKey;
+        IconKey = iconKey;
+        SortOrder = sortOrder;
+    }
+
+    public string Id { get; }
+
+    public string TitleLocalizationKey { get; }
+
+    public string? DescriptionLocalizationKey { get; }
+
+    public string IconKey { get; }
+
+    public int SortOrder { get; }
+
+    public IReadOnlyList<SettingsOptionDefinition> Options => _options;
+
+    public PluginSettingsSectionBuilder AddOption(SettingsOptionDefinition option)
+    {
+        ArgumentNullException.ThrowIfNull(option);
+        _options.Add(option);
+        return this;
+    }
+
+    public PluginSettingsSectionBuilder AddToggle(
+        string key,
+        string titleLocalizationKey,
+        string? descriptionLocalizationKey = null,
+        bool defaultValue = false)
+    {
+        return AddOption(new SettingsOptionDefinition(
+            key,
+            SettingsOptionType.Toggle,
+            titleLocalizationKey,
+            descriptionLocalizationKey,
+            defaultValue));
+    }
+
+    public PluginSettingsSectionBuilder AddText(
+        string key,
+        string titleLocalizationKey,
+        string? descriptionLocalizationKey = null,
+        string defaultValue = "",
+        string? validationPattern = null)
+    {
+        return AddOption(new SettingsOptionDefinition(
+            key,
+            SettingsOptionType.Text,
+            titleLocalizationKey,
+            descriptionLocalizationKey,
+            defaultValue,
+            validationPattern: validationPattern));
+    }
+
+    public PluginSettingsSectionBuilder AddNumber(
+        string key,
+        string titleLocalizationKey,
+        string? descriptionLocalizationKey = null,
+        double defaultValue = 0,
+        double? minimum = null,
+        double? maximum = null)
+    {
+        return AddOption(new SettingsOptionDefinition(
+            key,
+            SettingsOptionType.Number,
+            titleLocalizationKey,
+            descriptionLocalizationKey,
+            defaultValue,
+            minimum: minimum,
+            maximum: maximum));
+    }
+
+    public PluginSettingsSectionBuilder AddSelect(
+        string key,
+        string titleLocalizationKey,
+        IEnumerable<SettingsOptionChoice> choices,
+        string? descriptionLocalizationKey = null,
+        string? defaultValue = null)
+    {
+        ArgumentNullException.ThrowIfNull(choices);
+        var normalizedChoices = choices.ToArray();
+
+        return AddOption(new SettingsOptionDefinition(
+            key,
+            SettingsOptionType.Select,
+            titleLocalizationKey,
+            descriptionLocalizationKey,
+            defaultValue,
+            normalizedChoices));
+    }
+
+    public PluginSettingsSectionBuilder AddPath(
+        string key,
+        string titleLocalizationKey,
+        string? descriptionLocalizationKey = null,
+        string defaultValue = "")
+    {
+        return AddOption(new SettingsOptionDefinition(
+            key,
+            SettingsOptionType.Path,
+            titleLocalizationKey,
+            descriptionLocalizationKey,
+            defaultValue));
+    }
+
+    public PluginSettingsSectionBuilder AddList(
+        string key,
+        string titleLocalizationKey,
+        string? descriptionLocalizationKey = null,
+        IReadOnlyList<string>? defaultValue = null)
+    {
+        return AddOption(new SettingsOptionDefinition(
+            key,
+            SettingsOptionType.List,
+            titleLocalizationKey,
+            descriptionLocalizationKey,
+            defaultValue ?? Array.Empty<string>()));
+    }
+
+    internal PluginSettingsSectionRegistration Build()
+    {
+        return new PluginSettingsSectionRegistration(
+            Id,
+            TitleLocalizationKey,
+            _options.ToArray(),
+            DescriptionLocalizationKey,
+            IconKey,
+            SortOrder);
+    }
+}
--- a/LanMountainDesktop.PluginSdk/PluginSettingsSectionRegistration.cs
+++ b/LanMountainDesktop.PluginSdk/PluginSettingsSectionRegistration.cs
@@ -0,0 +1,40 @@
+using System.Collections.Generic;
+
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed class PluginSettingsSectionRegistration
+{
+    public PluginSettingsSectionRegistration(
+        string id,
+        string titleLocalizationKey,
+        IReadOnlyList<SettingsOptionDefinition> options,
+        string? descriptionLocalizationKey = null,
+        string iconKey = "PuzzlePiece",
+        int sortOrder = 0)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(id);
+        ArgumentException.ThrowIfNullOrWhiteSpace(titleLocalizationKey);
+        ArgumentException.ThrowIfNullOrWhiteSpace(iconKey);
+
+        Id = id.Trim();
+        TitleLocalizationKey = titleLocalizationKey.Trim();
+        DescriptionLocalizationKey = string.IsNullOrWhiteSpace(descriptionLocalizationKey)
+            ? null
+            : descriptionLocalizationKey.Trim();
+        IconKey = iconKey.Trim();
+        SortOrder = sortOrder;
+        Options = options ?? [];
+    }
+
+    public string Id { get; }
+
+    public string TitleLocalizationKey { get; }
+
+    public string? DescriptionLocalizationKey { get; }
+
+    public string IconKey { get; }
+
+    public int SortOrder { get; }
+
+    public IReadOnlyList<SettingsOptionDefinition> Options { get; }
+}
--- a/LanMountainDesktop.PluginSdk/PluginSharedContractReference.cs
+++ b/LanMountainDesktop.PluginSdk/PluginSharedContractReference.cs
@@ -0,0 +1,47 @@
+using System.Text.Json.Serialization;
+
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed record PluginSharedContractReference(
+    string Id,
+    string Version,
+    string AssemblyName)
+{
+    [JsonIgnore]
+    public string NormalizedId => Id.Trim();
+
+    [JsonIgnore]
+    public string NormalizedVersion => Version.Trim();
+
+    [JsonIgnore]
+    public string NormalizedAssemblyName => AssemblyName.Trim();
+
+    internal PluginSharedContractReference NormalizeAndValidate(string manifestPath)
+    {
+        var normalized = this with
+        {
+            Id = RequireValue(Id, nameof(Id), manifestPath),
+            Version = RequireValue(Version, nameof(Version), manifestPath),
+            AssemblyName = RequireValue(AssemblyName, nameof(AssemblyName), manifestPath)
+        };
+
+        if (!System.Version.TryParse(normalized.Version, out _))
+        {
+            throw new InvalidOperationException(
+                $"Plugin manifest '{manifestPath}' declares invalid shared contract version '{normalized.Version}' for '{normalized.Id}'.");
+        }
+
+        return normalized;
+    }
+
+    private static string RequireValue(string? value, string propertyName, string manifestPath)
+    {
+        if (string.IsNullOrWhiteSpace(value))
+        {
+            throw new InvalidOperationException(
+                $"Plugin manifest '{manifestPath}' is missing required shared contract property '{propertyName}'.");
+        }
+
+        return value.Trim();
+    }
+}
--- a/LanMountainDesktop.PluginSdk/README.md
+++ b/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.
--- a/LanMountainDesktop.PluginSdk/SettingsCategories.cs
+++ b/LanMountainDesktop.PluginSdk/SettingsCategories.cs
@@ -0,0 +1,14 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public static class SettingsCategories
+{
+    public const string General = "General";
+    public const string Appearance = "Appearance";
+    public const string Components = "Components";
+    public const string Plugins = "Plugins";
+    public const string PluginMarket = "PluginMarket";
+    public const string Update = "Update";
+    public const string About = "About";
+    public const string Advanced = "Advanced";
+    public const string External = "External";
+}
--- a/LanMountainDesktop.PluginSdk/SettingsChangedEvent.cs
+++ b/LanMountainDesktop.PluginSdk/SettingsChangedEvent.cs
@@ -0,0 +1,32 @@
+using System.Collections.Generic;
+
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed class SettingsChangedEvent
+{
+    public SettingsChangedEvent(
+        SettingsScope scope,
+        string? subjectId = null,
+        string? placementId = null,
+        string? sectionId = null,
+        IReadOnlyCollection<string>? changedKeys = null)
+    {
+        Scope = scope;
+        SubjectId = string.IsNullOrWhiteSpace(subjectId) ? null : subjectId.Trim();
+        PlacementId = string.IsNullOrWhiteSpace(placementId) ? null : placementId.Trim();
+        SectionId = string.IsNullOrWhiteSpace(sectionId) ? null : sectionId.Trim();
+        ChangedKeys = changedKeys is { Count: > 0 }
+            ? changedKeys.ToArray()
+            : [];
+    }
+
+    public SettingsScope Scope { get; }
+
+    public string? SubjectId { get; }
+
+    public string? PlacementId { get; }
+
+    public string? SectionId { get; }
+
+    public IReadOnlyCollection<string> ChangedKeys { get; }
+}
--- a/LanMountainDesktop.PluginSdk/SettingsOptionChoice.cs
+++ b/LanMountainDesktop.PluginSdk/SettingsOptionChoice.cs
@@ -0,0 +1,17 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed class SettingsOptionChoice
+{
+    public SettingsOptionChoice(string value, string titleLocalizationKey)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(value);
+        ArgumentException.ThrowIfNullOrWhiteSpace(titleLocalizationKey);
+
+        Value = value.Trim();
+        TitleLocalizationKey = titleLocalizationKey.Trim();
+    }
+
+    public string Value { get; }
+
+    public string TitleLocalizationKey { get; }
+}
--- a/LanMountainDesktop.PluginSdk/SettingsOptionDefinition.cs
+++ b/LanMountainDesktop.PluginSdk/SettingsOptionDefinition.cs
@@ -0,0 +1,53 @@
+using System.Collections.Generic;
+
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed class SettingsOptionDefinition
+{
+    public SettingsOptionDefinition(
+        string key,
+        SettingsOptionType optionType,
+        string titleLocalizationKey,
+        string? descriptionLocalizationKey = null,
+        object? defaultValue = null,
+        IReadOnlyList<SettingsOptionChoice>? choices = null,
+        double? minimum = null,
+        double? maximum = null,
+        string? validationPattern = null)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(key);
+        ArgumentException.ThrowIfNullOrWhiteSpace(titleLocalizationKey);
+
+        Key = key.Trim();
+        OptionType = optionType;
+        TitleLocalizationKey = titleLocalizationKey.Trim();
+        DescriptionLocalizationKey = string.IsNullOrWhiteSpace(descriptionLocalizationKey)
+            ? null
+            : descriptionLocalizationKey.Trim();
+        DefaultValue = defaultValue;
+        Choices = choices ?? [];
+        Minimum = minimum;
+        Maximum = maximum;
+        ValidationPattern = string.IsNullOrWhiteSpace(validationPattern)
+            ? null
+            : validationPattern.Trim();
+    }
+
+    public string Key { get; }
+
+    public SettingsOptionType OptionType { get; }
+
+    public string TitleLocalizationKey { get; }
+
+    public string? DescriptionLocalizationKey { get; }
+
+    public object? DefaultValue { get; }
+
+    public IReadOnlyList<SettingsOptionChoice> Choices { get; }
+
+    public double? Minimum { get; }
+
+    public double? Maximum { get; }
+
+    public string? ValidationPattern { get; }
+}
--- a/LanMountainDesktop.PluginSdk/SettingsOptionType.cs
+++ b/LanMountainDesktop.PluginSdk/SettingsOptionType.cs
@@ -0,0 +1,11 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public enum SettingsOptionType
+{
+    Toggle = 0,
+    Select = 1,
+    Text = 2,
+    Number = 3,
+    Path = 4,
+    List = 5
+}
--- a/LanMountainDesktop.PluginSdk/SettingsPageBase.cs
+++ b/LanMountainDesktop.PluginSdk/SettingsPageBase.cs
@@ -0,0 +1,54 @@
+using System;
+using Avalonia.Controls;
+
+namespace LanMountainDesktop.PluginSdk;
+
+public abstract class SettingsPageBase : UserControl
+{
+    public static readonly string DialogHostIdentifier = "LanMountainDesktop.SettingsWindow";
+
+    private ISettingsPageHostContext? _hostContext;
+
+    public ISettingsPageHostContext? HostContext => _hostContext;
+
+    public Uri? NavigationUri { get; set; }
+
+    public void InitializeHostContext(ISettingsPageHostContext hostContext)
+    {
+        _hostContext = hostContext;
+    }
+
+    public virtual void OnNavigatedTo(object? parameter)
+    {
+    }
+
+    protected void OpenDrawer(Control content, string? title = null)
+    {
+        _hostContext?.OpenDrawer(content, title);
+    }
+
+    protected void OpenDrawer(object content, bool usePageDataContext = false, object? dataContext = null, string? title = null)
+    {
+        if (content is Control control && !usePageDataContext)
+        {
+            control.DataContext = dataContext ?? DataContext ?? this;
+            OpenDrawer(control, title);
+            return;
+        }
+
+        if (content is Control drawerControl)
+        {
+            OpenDrawer(drawerControl, title);
+        }
+    }
+
+    protected void CloseDrawer()
+    {
+        _hostContext?.CloseDrawer();
+    }
+
+    protected void RequestRestart(string? reason = null)
+    {
+        _hostContext?.RequestRestart(reason);
+    }
+}
--- a/LanMountainDesktop.PluginSdk/SettingsPageCategory.cs
+++ b/LanMountainDesktop.PluginSdk/SettingsPageCategory.cs
@@ -0,0 +1,11 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public enum SettingsPageCategory
+{
+    General = 0,
+    Appearance = 10,
+    Components = 20,
+    Plugins = 30,
+    PluginMarket = 35,
+    About = 40
+}
--- a/LanMountainDesktop.PluginSdk/SettingsPageInfoAttribute.cs
+++ b/LanMountainDesktop.PluginSdk/SettingsPageInfoAttribute.cs
@@ -0,0 +1,46 @@
+using System;
+
+namespace LanMountainDesktop.PluginSdk;
+
+[AttributeUsage(AttributeTargets.Class, AllowMultiple = false, Inherited = false)]
+public sealed class SettingsPageInfoAttribute : Attribute
+{
+    public SettingsPageInfoAttribute(
+        string id,
+        string name,
+        SettingsPageCategory category)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(id);
+        ArgumentException.ThrowIfNullOrWhiteSpace(name);
+
+        Id = id.Trim();
+        Name = name.Trim();
+        Category = category;
+    }
+
+    public string Id { get; }
+
+    public string Name { get; }
+
+    public SettingsPageCategory Category { get; }
+
+    public string? TitleLocalizationKey { get; init; }
+
+    public string? DescriptionLocalizationKey { get; init; }
+
+    public string IconKey { get; init; } = "Settings";
+
+    public string? SelectedIconKey { get; init; }
+
+    public int SortOrder { get; init; }
+
+    public bool HideDefault { get; init; }
+
+    public bool HidePageTitle { get; init; }
+
+    public bool UseFullWidth { get; init; }
+
+    public string? GroupId { get; init; }
+
+    public SettingsScope Scope { get; init; } = SettingsScope.App;
+}
--- a/LanMountainDesktop.PluginSdk/SettingsScope.cs
+++ b/LanMountainDesktop.PluginSdk/SettingsScope.cs
@@ -0,0 +1,9 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public enum SettingsScope
+{
+    App = 0,
+    Launcher = 1,
+    Plugin = 2,
+    ComponentInstance = 3
+}
--- a/LanMountainDesktop.PluginSdk/SettingsSectionDefinition.cs
+++ b/LanMountainDesktop.PluginSdk/SettingsSectionDefinition.cs
@@ -0,0 +1,53 @@
+using System.Collections.Generic;
+
+namespace LanMountainDesktop.PluginSdk;
+
+public sealed class SettingsSectionDefinition
+{
+    public SettingsSectionDefinition(
+        string id,
+        string category,
+        SettingsScope scope,
+        string titleLocalizationKey,
+        string? descriptionLocalizationKey = null,
+        string iconKey = "Settings",
+        int sortOrder = 0,
+        string? subjectId = null,
+        IReadOnlyList<SettingsOptionDefinition>? options = null)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(id);
+        ArgumentException.ThrowIfNullOrWhiteSpace(category);
+        ArgumentException.ThrowIfNullOrWhiteSpace(titleLocalizationKey);
+        ArgumentException.ThrowIfNullOrWhiteSpace(iconKey);
+
+        Id = id.Trim();
+        Category = category.Trim();
+        Scope = scope;
+        TitleLocalizationKey = titleLocalizationKey.Trim();
+        DescriptionLocalizationKey = string.IsNullOrWhiteSpace(descriptionLocalizationKey)
+            ? null
+            : descriptionLocalizationKey.Trim();
+        IconKey = iconKey.Trim();
+        SortOrder = sortOrder;
+        SubjectId = string.IsNullOrWhiteSpace(subjectId) ? null : subjectId.Trim();
+        Options = options ?? [];
+    }
+
+    public string Id { get; }
+
+    public string Category { get; }
+
+    public SettingsScope Scope { get; }
+
+    public string TitleLocalizationKey { get; }
+
+    public string? DescriptionLocalizationKey { get; }
+
+    public string IconKey { get; }
+
+    public int SortOrder { get; }
+
+    public string? SubjectId { get; }
+
+    public IReadOnlyList<SettingsOptionDefinition> Options { get; }
+}
--- a/LanMountainDesktop.PluginSdk/buildTransitive/LanMountainDesktop.PluginSdk.props
+++ b/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>
--- a/LanMountainDesktop.PluginSdk/buildTransitive/LanMountainDesktop.PluginSdk.targets
+++ b/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>
--- a/LanMountainDesktop.PluginTemplate/LanMountainDesktop.PluginTemplate.csproj
+++ b/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>
--- a/LanMountainDesktop.PluginTemplate/README.md
+++ b/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.
--- a/LanMountainDesktop.PluginTemplate/content/.template.config/template.json
+++ b/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__"
+    }
+  }
+}
--- a/LanMountainDesktop.PluginTemplate/content/LanMountainDesktop.PluginTemplate.csproj
+++ b/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>
--- a/LanMountainDesktop.PluginTemplate/content/Localization/en-US.json
+++ b/LanMountainDesktop.PluginTemplate/content/Localization/en-US.json
@@ -0,0 +1,2 @@
+{
+}
--- a/LanMountainDesktop.PluginTemplate/content/Localization/zh-CN.json
+++ b/LanMountainDesktop.PluginTemplate/content/Localization/zh-CN.json
@@ -0,0 +1,2 @@
+{
+}
--- a/LanMountainDesktop.PluginTemplate/content/Plugin.cs
+++ b/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;
+    }
+}
--- a/LanMountainDesktop.PluginTemplate/content/README.md
+++ b/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`
--- a/LanMountainDesktop.PluginTemplate/content/plugin.json
+++ b/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": []
+}
--- a/LanMountainDesktop.PluginsInstallHelper/LanMountainDesktop.PluginsInstallHelper.csproj
+++ b/LanMountainDesktop.PluginsInstallHelper/LanMountainDesktop.PluginsInstallHelper.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk" TreatAsLocalProperty="Version;PackageVersion;InformationalVersion;AssemblyVersion;FileVersion">
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Version>1.0.0</Version>
+    <PackageVersion>$(Version)</PackageVersion>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\LanMountainDesktop.PluginSdk\LanMountainDesktop.PluginSdk.csproj" />
+  </ItemGroup>
+</Project>
--- a/LanMountainDesktop.PluginsInstallHelper/Program.cs
+++ b/LanMountainDesktop.PluginsInstallHelper/Program.cs
@@ -0,0 +1,242 @@
+using System.IO.Compression;
+using System.Security.Cryptography;
+using System.Text;
+using System.Text.Json;
+using LanMountainDesktop.PluginSdk;
+
+internal static class Program
+{
+    private static readonly TimeSpan[] RetryDelays =
+    [
+        TimeSpan.FromMilliseconds(120),
+        TimeSpan.FromMilliseconds(250),
+        TimeSpan.FromMilliseconds(500)
+    ];
+
+    private static async Task<int> Main(string[] args)
+    {
+        var result = new HelperResult();
+        string? resultPath = null;
+
+        try
+        {
+            var parsedArgs = ParseArgs(args);
+            if (!parsedArgs.TryGetValue("source", out var sourcePath) ||
+                !parsedArgs.TryGetValue("plugins-dir", out var pluginsDirectory) ||
+                !parsedArgs.TryGetValue("result", out resultPath) ||
+                string.IsNullOrWhiteSpace(sourcePath) ||
+                string.IsNullOrWhiteSpace(pluginsDirectory) ||
+                string.IsNullOrWhiteSpace(resultPath))
+            {
+                throw new InvalidOperationException("Required arguments: --source <path> --plugins-dir <path> --result <path>.");
+            }
+
+            var fullSourcePath = Path.GetFullPath(sourcePath);
+            var fullPluginsDirectory = Path.GetFullPath(pluginsDirectory);
+            resultPath = Path.GetFullPath(resultPath);
+
+            if (!File.Exists(fullSourcePath))
+            {
+                throw new FileNotFoundException($"Plugin package '{fullSourcePath}' was not found.", fullSourcePath);
+            }
+
+            var manifest = ReadManifestFromPackage(fullSourcePath);
+            Directory.CreateDirectory(fullPluginsDirectory);
+            var destinationPath = Path.Combine(fullPluginsDirectory, BuildInstalledPackageFileName(manifest.Id));
+            var stagingPath = destinationPath + ".incoming";
+            DeleteFileWithRetry(stagingPath);
+            CopyWithRetry(fullSourcePath, stagingPath, overwrite: true);
+            RemoveExistingPluginPackages(fullPluginsDirectory, manifest.Id, destinationPath, stagingPath);
+            MoveWithOverwriteRetry(stagingPath, destinationPath);
+
+            result = new HelperResult
+            {
+                Success = true,
+                InstalledPackagePath = destinationPath,
+                ManifestId = manifest.Id,
+                ManifestName = manifest.Name
+            };
+        }
+        catch (Exception ex)
+        {
+            result = new HelperResult
+            {
+                Success = false,
+                ErrorMessage = ex.Message
+            };
+        }
+
+        if (!string.IsNullOrWhiteSpace(resultPath))
+        {
+            var resultDirectory = Path.GetDirectoryName(resultPath);
+            if (!string.IsNullOrWhiteSpace(resultDirectory))
+            {
+                Directory.CreateDirectory(resultDirectory);
+            }
+
+            await File.WriteAllTextAsync(
+                resultPath,
+                JsonSerializer.Serialize(result, new JsonSerializerOptions
+                {
+                    WriteIndented = true
+                }),
+                Encoding.UTF8);
+        }
+
+        return result.Success ? 0 : 1;
+    }
+
+    private static Dictionary<string, string> ParseArgs(string[] args)
+    {
+        var values = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
+        for (var i = 0; i < args.Length; i++)
+        {
+            var current = args[i];
+            if (!current.StartsWith("--", StringComparison.Ordinal))
+            {
+                continue;
+            }
+
+            var key = current[2..];
+            if (string.IsNullOrWhiteSpace(key) || i + 1 >= args.Length)
+            {
+                continue;
+            }
+
+            values[key] = args[++i];
+        }
+
+        return values;
+    }
+
+    private static PluginManifest ReadManifestFromPackage(string packagePath)
+    {
+        using var archive = ZipFile.OpenRead(packagePath);
+        var entries = archive.Entries
+            .Where(entry => string.Equals(entry.Name, PluginSdkInfo.ManifestFileName, StringComparison.OrdinalIgnoreCase))
+            .ToArray();
+
+        if (entries.Length == 0)
+        {
+            throw new InvalidOperationException(
+                $"Plugin package '{packagePath}' does not contain '{PluginSdkInfo.ManifestFileName}'.");
+        }
+
+        if (entries.Length > 1)
+        {
+            throw new InvalidOperationException(
+                $"Plugin package '{packagePath}' contains multiple '{PluginSdkInfo.ManifestFileName}' files.");
+        }
+
+        using var stream = entries[0].Open();
+        return PluginManifest.Load(stream, $"{packagePath}!/{entries[0].FullName}");
+    }
+
+    private static void RemoveExistingPluginPackages(string pluginsDirectory, string pluginId, string destinationPath, string stagingPath)
+    {
+        var runtimeRootDirectory = EnsureTrailingSeparator(Path.Combine(Path.GetFullPath(pluginsDirectory), PluginSdkInfo.RuntimeDirectoryName));
+        foreach (var existingPackagePath in Directory
+                     .EnumerateFiles(pluginsDirectory, "*" + PluginSdkInfo.PackageFileExtension, SearchOption.AllDirectories)
+                     .Select(Path.GetFullPath)
+                     .Where(path => !path.StartsWith(runtimeRootDirectory, StringComparison.OrdinalIgnoreCase)))
+        {
+            try
+            {
+                if (string.Equals(existingPackagePath, Path.GetFullPath(destinationPath), StringComparison.OrdinalIgnoreCase) ||
+                    string.Equals(existingPackagePath, Path.GetFullPath(stagingPath), StringComparison.OrdinalIgnoreCase))
+                {
+                    continue;
+                }
+
+                var existingManifest = ReadManifestFromPackage(existingPackagePath);
+                if (!string.Equals(existingManifest.Id, pluginId, StringComparison.OrdinalIgnoreCase))
+                {
+                    continue;
+                }
+
+                DeleteFileWithRetry(existingPackagePath);
+            }
+            catch
+            {
+                // Ignore unrelated or malformed packages while replacing an install target.
+            }
+        }
+    }
+
+    private static void CopyWithRetry(string sourcePath, string destinationPath, bool overwrite)
+    {
+        Retry(() => File.Copy(sourcePath, destinationPath, overwrite));
+    }
+
+    private static void MoveWithOverwriteRetry(string sourcePath, string destinationPath)
+    {
+        Retry(() => File.Move(sourcePath, destinationPath, overwrite: true));
+    }
+
+    private static void DeleteFileWithRetry(string filePath)
+    {
+        Retry(() =>
+        {
+            if (File.Exists(filePath))
+            {
+                File.Delete(filePath);
+            }
+        });
+    }
+
+    private static void Retry(Action action)
+    {
+        Exception? lastException = null;
+
+        for (var attempt = 0; attempt <= RetryDelays.Length; attempt++)
+        {
+            try
+            {
+                action();
+                return;
+            }
+            catch (Exception ex) when (ex is IOException or UnauthorizedAccessException)
+            {
+                lastException = ex;
+                if (attempt >= RetryDelays.Length)
+                {
+                    break;
+                }
+
+                Thread.Sleep(RetryDelays[attempt]);
+            }
+        }
+
+        if (lastException is not null)
+        {
+            throw lastException;
+        }
+    }
+
+    private static string BuildInstalledPackageFileName(string pluginId)
+    {
+        var invalidChars = Path.GetInvalidFileNameChars();
+        var fileName = new string(pluginId.Select(ch => invalidChars.Contains(ch) ? '_' : ch).ToArray());
+        return fileName + PluginSdkInfo.PackageFileExtension;
+    }
+
+    private static string EnsureTrailingSeparator(string path)
+    {
+        return path.EndsWith(Path.DirectorySeparatorChar.ToString(), StringComparison.Ordinal)
+            ? path
+            : path + Path.DirectorySeparatorChar;
+    }
+
+    private sealed class HelperResult
+    {
+        public bool Success { get; init; }
+
+        public string? InstalledPackagePath { get; init; }
+
+        public string? ManifestId { get; init; }
+
+        public string? ManifestName { get; init; }
+
+        public string? ErrorMessage { get; init; }
+    }
+}
--- a/LanMountainDesktop.SamplePlugin/LanMountainDesktop.SamplePlugin.csproj
+++ b/LanMountainDesktop.SamplePlugin/LanMountainDesktop.SamplePlugin.csproj
@@ -1,29 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-
-  <PropertyGroup>
-    <TargetFramework>net10.0</TargetFramework>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <Version>1.0.0</Version>
-    <EnableDynamicLoading>true</EnableDynamicLoading>
-    <OutputPath>bin\$(Configuration)\$(TargetFramework)\content\</OutputPath>
-    <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
-    <AppendRuntimeIdentifierToOutputPath>false</AppendRuntimeIdentifierToOutputPath>
-    <PluginPackageOutputDirectory>..\LanMountainDesktop\bin\$(Configuration)\$(TargetFramework)\Extensions\Plugins\</PluginPackageOutputDirectory>
-    <PluginPackagePath>$(PluginPackageOutputDirectory)$(AssemblyName).laapp</PluginPackagePath>
-    <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>
--- a/LanMountainDesktop.SamplePlugin/SamplePlugin.cs
+++ b/LanMountainDesktop.SamplePlugin/SamplePlugin.cs
@@ -1,84 +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 hostName = GetHostProperty(context, "HostApplicationName", "UnknownHost");
-        var hostVersion = GetHostProperty(context, "HostVersion", "UnknownVersion");
-        var sdkApiVersion = GetHostProperty(context, "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);
-        context.RegisterService(_stateService);
-
-        _clockService = new SamplePluginClockService(context.DataDirectory, _stateService, messageBus);
-        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($"Initialization log written to {logPath}.");
-        }
-        catch (Exception ex)
-        {
-            _stateService.MarkBackendFaulted($"Initialization log write failed: {ex.Message}");
-            throw;
-        }
-
-        _clockService.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()
-    {
-        _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;
-    }
-}
--- a/LanMountainDesktop.SamplePlugin/SamplePluginRuntimeStatus.cs
+++ b/LanMountainDesktop.SamplePlugin/SamplePluginRuntimeStatus.cs
@@ -1,465 +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 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)
-    {
-        _manifest = manifest;
-        _pluginDirectory = pluginDirectory;
-        _dataDirectory = dataDirectory;
-        _hostApplicationName = hostApplicationName;
-        _hostVersion = hostVersion;
-        _sdkApiVersion = sdkApiVersion;
-        _messageBus = messageBus;
-
-        _frontend = CreateEntry(
-            "frontend",
-            "Frontend",
-            SamplePluginHealthState.Pending,
-            "Pending",
-            "Waiting for a plugin UI surface to connect.");
-
-        _component = CreateEntry(
-            "component",
-            "Component",
-            SamplePluginHealthState.Pending,
-            "Pending",
-            "No component instance has been created yet.");
-
-        _backend = CreateEntry(
-            "backend",
-            "Backend",
-            SamplePluginHealthState.Pending,
-            "Pending",
-            "Plugin initialization is in progress.");
-
-        _service = CreateEntry(
-            "service",
-            "Clock Service",
-            SamplePluginHealthState.Pending,
-            "Pending",
-            "Clock service is not attached yet.");
-    }
-
-    public void AttachClockService(SamplePluginClockService clockService)
-    {
-        ArgumentNullException.ThrowIfNull(clockService);
-
-        lock (_gate)
-        {
-            _serviceClockTime = clockService.CurrentTime;
-            _service = CreateEntry(
-                "service",
-                "Clock Service",
-                SamplePluginHealthState.Pending,
-                "Attached",
-                "Clock service was attached and is waiting for the first tick.");
-        }
-
-        PublishStateChanged("Clock service attached");
-    }
-
-    public void MarkFrontendReady(string detail)
-    {
-        lock (_gate)
-        {
-            _frontend = CreateEntry(
-                "frontend",
-                "Frontend",
-                SamplePluginHealthState.Healthy,
-                "Healthy",
-                detail);
-        }
-
-        PublishStateChanged("Frontend updated");
-    }
-
-    public void MarkBackendReady(string detail)
-    {
-        lock (_gate)
-        {
-            _backend = CreateEntry(
-                "backend",
-                "Backend",
-                SamplePluginHealthState.Healthy,
-                "Healthy",
-                detail);
-        }
-
-        PublishStateChanged("Backend updated");
-    }
-
-    public void MarkBackendFaulted(string detail)
-    {
-        lock (_gate)
-        {
-            _backend = CreateEntry(
-                "backend",
-                "Backend",
-                SamplePluginHealthState.Faulted,
-                "Faulted",
-                detail);
-        }
-
-        PublishStateChanged("Backend faulted");
-    }
-
-    public void MarkClockServiceTick(DateTimeOffset currentTime)
-    {
-        lock (_gate)
-        {
-            _serviceClockTime = currentTime;
-            _service = CreateEntry(
-                "service",
-                "Clock Service",
-                SamplePluginHealthState.Healthy,
-                "Healthy",
-                $"Clock service is running. Current service time: {currentTime.LocalDateTime:HH:mm:ss}");
-        }
-
-        PublishStateChanged("Clock service tick");
-    }
-
-    public void MarkClockServiceFaulted(string detail)
-    {
-        lock (_gate)
-        {
-            _service = CreateEntry(
-                "service",
-                "Clock Service",
-                SamplePluginHealthState.Faulted,
-                "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
-            ? "(none)"
-            : string.Join(", ", context.Properties.Keys.OrderBy(key => key, StringComparer.OrdinalIgnoreCase));
-
-        return
-        [
-            new SamplePluginCapabilityItem(
-                "IPluginContext.Manifest",
-                $"Readable. Current plugin id: {context.Manifest.Id}; version: {context.Manifest.Version ?? "dev"}."),
-            new SamplePluginCapabilityItem(
-                "IPluginContext.PluginDirectory / DataDirectory",
-                $"Readable. Plugin directory: {context.PluginDirectory}; data directory: {context.DataDirectory}."),
-            new SamplePluginCapabilityItem(
-                "IPluginContext.Properties",
-                $"Readable. Host properties currently exposed: {propertyNames}."),
-            new SamplePluginCapabilityItem(
-                "IPluginContext.GetService<T>()",
-                $"Callable. State service resolved: {hasStateService}; clock service resolved: {hasClockService}; message bus resolved: {hasMessageBus}."),
-            new SamplePluginCapabilityItem(
-                "IPluginContext.RegisterService<TService>()",
-                "Callable during plugin initialization. This plugin registers SamplePluginRuntimeStateService and SamplePluginClockService into the plugin service container."),
-            new SamplePluginCapabilityItem(
-                "Plugin communication bus",
-                "This plugin uses IPluginMessageBus to push clock ticks and state change notifications into plugin UI surfaces."),
-            new SamplePluginCapabilityItem(
-                "PluginDesktopComponentContext",
-                "Widgets can read ComponentId, PlacementId, CellSize, and call GetService<T>() against the same plugin service container.")
-        ];
-    }
-
-    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",
-                "Component",
-                SamplePluginHealthState.Healthy,
-                "Placed",
-                $"Placed count: {placementIds.Length}; preview count: {previewCount}; placements: {string.Join(", ", placementIds)}");
-            return;
-        }
-
-        if (previewCount > 0)
-        {
-            _component = CreateEntry(
-                "component",
-                "Component",
-                SamplePluginHealthState.Healthy,
-                "Preview",
-                $"Preview instances: {previewCount}; no placed desktop instance is active yet.");
-            return;
-        }
-
-        _component = CreateEntry(
-            "component",
-            "Component",
-            SamplePluginHealthState.Pending,
-            "Pending",
-            "No component instance is active.");
-    }
-
-    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);
-    }
-}
-
-internal sealed class SamplePluginClockService : IDisposable
-{
-    private readonly object _gate = new();
-    private readonly string _clockStateFilePath;
-    private readonly SamplePluginRuntimeStateService _stateService;
-    private readonly IPluginMessageBus _messageBus;
-    private readonly Timer _timer;
-    private DateTimeOffset _currentTime = DateTimeOffset.Now;
-    private int _disposed;
-
-    public SamplePluginClockService(
-        string dataDirectory,
-        SamplePluginRuntimeStateService stateService,
-        IPluginMessageBus messageBus)
-    {
-        _clockStateFilePath = Path.Combine(dataDirectory, "clock-service.txt");
-        _stateService = stateService;
-        _messageBus = messageBus;
-        _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($"Clock state write failed: {ex.Message}");
-        }
-    }
-}
--- a/LanMountainDesktop.SamplePlugin/SamplePluginSettingsView.cs
+++ b/LanMountainDesktop.SamplePlugin/SamplePluginSettingsView.cs
@@ -1,339 +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 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;
-        _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("Settings page is connected to plugin services and communication.");
-
-        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 Capability Inspector",
-                        FontSize = 22,
-                        FontWeight = FontWeight.SemiBold,
-                        Foreground = Brushes.White
-                    },
-                    CreateSection("Plugin Info", _pluginInfoPanel),
-                    CreateSection("Accessible Capabilities", _capabilityPanel),
-                    CreateSection("Live Runtime 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("Plugin Name", snapshot.Manifest.Name));
-        _pluginInfoPanel.Children.Add(CreateInfoLine("Plugin Id", snapshot.Manifest.Id));
-        _pluginInfoPanel.Children.Add(CreateInfoLine("Version", snapshot.Manifest.Version ?? "dev"));
-        _pluginInfoPanel.Children.Add(CreateInfoLine("Author", snapshot.Manifest.Author ?? "(none)"));
-        _pluginInfoPanel.Children.Add(CreateInfoLine("Description", snapshot.Manifest.Description ?? "(none)"));
-        _pluginInfoPanel.Children.Add(CreateInfoLine("Plugin Directory", snapshot.PluginDirectory));
-        _pluginInfoPanel.Children.Add(CreateInfoLine("Data Directory", snapshot.DataDirectory));
-        _pluginInfoPanel.Children.Add(CreateInfoLine("Host Application", snapshot.HostApplicationName));
-        _pluginInfoPanel.Children.Add(CreateInfoLine("Host Version", snapshot.HostVersion));
-        _pluginInfoPanel.Children.Add(CreateInfoLine("SDK API Version", snapshot.SdkApiVersion));
-        _pluginInfoPanel.Children.Add(CreateInfoLine("State Service Resolved", (_context.GetService<SamplePluginRuntimeStateService>() is not null).ToString()));
-        _pluginInfoPanel.Children.Add(CreateInfoLine("Clock Service Resolved", (_context.GetService<SamplePluginClockService>() is not null).ToString()));
-        _pluginInfoPanel.Children.Add(CreateInfoLine("Message Bus Resolved", (_context.GetService<IPluginMessageBus>() is not null).ToString()));
-        _pluginInfoPanel.Children.Add(CreateInfoLine("Component Placed", snapshot.HasPlacedComponent ? "Yes" : "No"));
-        _pluginInfoPanel.Children.Add(CreateInfoLine("Placed Count", snapshot.PlacedCount.ToString()));
-        _pluginInfoPanel.Children.Add(CreateInfoLine("Preview Count", snapshot.PreviewCount.ToString()));
-        _pluginInfoPanel.Children.Add(CreateInfoLine(
-            "Placement Ids",
-            snapshot.PlacementIds.Count == 0 ? "(none)" : string.Join(", ", snapshot.PlacementIds)));
-        _pluginInfoPanel.Children.Add(CreateInfoLine("Last Component Id", snapshot.LastComponentId ?? "(none)"));
-        _pluginInfoPanel.Children.Add(CreateInfoLine(
-            "Last Cell Size",
-            snapshot.LastCellSize > 0 ? $"{snapshot.LastCellSize:F0}px" : "(unknown)"));
-        _pluginInfoPanel.Children.Add(CreateInfoLine(
-            "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 = $"Updated: {entry.UpdatedAt.LocalDateTime: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"))
-        };
-    }
-}
--- a/LanMountainDesktop.SamplePlugin/SamplePluginStatusClockWidget.cs
+++ b/LanMountainDesktop.SamplePlugin/SamplePluginStatusClockWidget.cs
@@ -1,284 +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 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;
-        _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("Widget surface is connected to plugin services and communication.");
-        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)
-            ? $"Preview surface | placed: {snapshot.PlacedCount}"
-            : $"Placement {_context.PlacementId} | placed: {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"))
-        };
-    }
-}
--- a/LanMountainDesktop.SamplePlugin/plugin.json
+++ b/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"
-}
--- a/LanMountainDesktop.Settings.Core/GlobalAppearanceSettings.cs
+++ b/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);
+    }
+}
--- a/LanMountainDesktop.Settings.Core/LanMountainDesktop.Settings.Core.csproj
+++ b/LanMountainDesktop.Settings.Core/LanMountainDesktop.Settings.Core.csproj
@@ -0,0 +1,11 @@
+<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" />
+  </ItemGroup>
+</Project>
--- a/LanMountainDesktop.Shared.Contracts/AppearanceCornerRadiusTokens.cs
+++ b/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);
--- a/LanMountainDesktop.Shared.Contracts/LanMountainDesktop.Shared.Contracts.csproj
+++ b/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>
--- a/LanMountainDesktop.Shared.Contracts/README.md
+++ b/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>
+```
--- a/LanMountainDesktop.Tests/BuiltInDesktopHostCornerRadiusBaselineTests.cs
+++ b/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));
+    }
+}
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
lincube	46a8df5900	0.7.2	2026-03-21 16:16:02 +08:00
lincube	2a1c09ae39	0.7.2	2026-03-21 13:08:20 +08:00
lincube	33baaa579d	0.7.1	2026-03-20 22:37:37 +08:00
lincube	20cd6041a7	0.7.0.2	2026-03-20 18:05:42 +08:00
lincube	65a3cf832a	Revert "0.7.0.0" This reverts commit `aeae4be060`.	2026-03-20 14:22:33 +08:00
lincube	5d48a03f57	Revert "0.7.0.1" This reverts commit `ea8ce1f5ff`.	2026-03-20 14:12:40 +08:00
lincube	ea8ce1f5ff	0.7.0.1	2026-03-20 12:16:04 +08:00
lincube	aeae4be060	0.7.0.0	2026-03-20 10:22:40 +08:00
lincube	915739ff7b	0.6.9 改变无声	2026-03-20 00:41:14 +08:00
lincube	cb86ca10e7	0.6.8 小黑板数据持久化。	2026-03-19 16:27:16 +08:00
lincube	b3a74aa072	0.6.7.2 文档组件优化	2026-03-19 08:39:25 +08:00
lincube	b436bfa884	0.6.7.1 多平台适配	2026-03-19 02:02:07 +08:00
lincube	081abeb688	0 6 7 可移动存储组件	2026-03-19 00:17:21 +08:00
lincube	594a62132f	0.6.6 滑动优化	2026-03-18 20:09:00 +08:00
lincube	15e589aedd	0.6.5 流畅性优化测试	2026-03-17 18:36:10 +08:00
lincube	ac4617f5cf	0.6.4	2026-03-17 14:57:41 +08:00
lincube	0645598753	0.6.3.1 最近文件查看优化，课程表组件优化，插件安装优化。	2026-03-17 12:30:30 +08:00
lincube	dadd132b4f	0.6.3 优化了文本框焦点，优化了更新体验，优化了遥测，披露了收集的数据。	2026-03-17 01:01:48 +08:00
lincube	298defb829	0.6.2 删除了视频壁纸功能，为纯色背景添加了自定义颜色选项。	2026-03-16 21:08:54 +08:00
lincube	bcf4be6d50	0.6.1 课表组件修复。加入最近文档组件。	2026-03-16 15:19:46 +08:00
lincube	6c9f6be1b1	0.6.0.1 应用遥测，插件市场	2026-03-16 09:50:48 +08:00
lincube	557b79e8c0	，0.6.0 重构了设置系统。解决了大量的bug，正式添加了图标。引入了遥测的同意与许可（暂无实际功能）	2026-03-15 21:27:48 +08:00
lincube	f83c6ede1d	settings_re11	2026-03-15 17:08:07 +08:00
lincube	c7fb48c8ee	settings_re10	2026-03-15 04:35:34 +08:00
lincube	85b70c4a8a	settings_re9	2026-03-14 23:52:26 +08:00
lincube	689be7b585	settings_re8	2026-03-14 22:45:09 +08:00
lincube	91f9f3d6fb	settings_re7	2026-03-14 16:38:56 +08:00
lincube	8d4f00efcb	settings_re6	2026-03-14 15:08:49 +08:00
lincube	e8be0f0576	settings_re5	2026-03-14 13:36:18 +08:00
lincube	5fdaa2539b	settings_re4	2026-03-13 22:20:12 +08:00
lincube	3b3f060f33	setting_re3	2026-03-13 09:10:00 +08:00
lincube	c4df243610	setting_re2 设置架构革新中	2026-03-13 00:33:00 +08:00
lincube	40a3a00cfe	setting_re1	2026-03-12 21:01:23 +08:00
lincube	4679ee006f	0.5.20 我认为很稳定了，后面就要开始弄插件不稳定了	2026-03-12 12:25:22 +08:00
lincube	6952cb2c3e	0.5.19.1	2026-03-12 10:07:23 +08:00
lincube	d3356f3319	0.5.19 插件系统V2	2026-03-12 09:22:03 +08:00
lincube	57c5e41a5c	0.5.18	2026-03-12 00:34:49 +08:00
lincube	ce2b218dfa	0.5.17	2026-03-12 00:18:04 +08:00
lincube	efdfa68dab	0.5.16	2026-03-11 17:43:31 +08:00
lincube	87110f1d69	0.5.15 市场插件安装机制修复，然后修复了一大堆东西	2026-03-11 15:14:08 +08:00
lincube	e7a03404ce	0.5.14 二次启动拦截，统一了生命进程API	2026-03-11 09:40:36 +08:00
lincube	2781d7e0d9	0.5.13 插件市场安装优化	2026-03-11 06:38:11 +08:00
lincube	5003ff1be2	0.5.12	2026-03-10 21:25:47 +08:00
lincube	e1be072b97	0.5.11 插件市场UI优化	2026-03-10 16:35:43 +08:00
lincube	4df740e3df	0.5.10 多线程	2026-03-10 14:56:05 +08:00
lincube	85f7a18cbc	0.5.9 中文与插件市场	2026-03-10 12:14:49 +08:00
lincube	cdffaa16eb	0.5.8 插件市场	2026-03-10 09:55:49 +08:00
lincube	d33d8d3391	0.5.7 示例插件	2026-03-10 00:40:26 +08:00
lincube	9c89c08448	0.5.6 插件系统再进化	2026-03-10 00:04:33 +08:00
lincube	ec7b78bc63	0.5.5 现已支持更改关键设置时提醒重启功能	2026-03-09 22:26:42 +08:00