0.6.9

改变无声

.codex/environments/environment.toml

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

.github/workflows/release.yml

@@ -25,6 +25,8 @@ jobs:
     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: |

.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] 当前课程变化时自动复位到最新进行中课程

.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
+
+（无）

.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 完成后进行

.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 设计风格

.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 包裹改为直接内容布局

.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

Directory.Build.props

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

LanAirApp/README.md

@@ -1,21 +1,33 @@
-# LanAirApp
+# LanAirApp (Mirror)
 
 ## 中文
 
-`LanAirApp` 是阑山桌面插件生态的对外工作区。这个目录是宿主仓库中的镜像副本，权威版本以独立 `LanAirApp` 仓库为准。
+这里的 `LanAirApp/` 是放在宿主仓库里的镜像副本，只用于本地联调和工作区构建，不是插件市场或插件开发资料的最终权威来源。
 
-### 目录说明
+### 这份镜像的角色
 
-- `docs/`：插件开发与打包文档。
-- `samples/`：示例插件与参考项目。
-- `standards/`：插件清单和目录结构约定。
-- `tools/`：插件打包与辅助工具。
+- 提供本地工作区里的 `airappmarket` 索引副本
+- 提供插件文档、工具和样例镜像，便于和宿主一起联调
+- 不承担宿主运行时职责
 
-### 与宿主的关系
+### 权威来源
 
-- 宿主程序只连接独立 `LanAirApp` 仓库中的官方市场索引。
-- 每个插件项目应在仓库根目录提供 `.laapp` 和 `README.md`。
+- 插件市场与开发文档：独立 `LanAirApp` 仓库
+- 权威示例插件：独立 `LanMountainDesktop.SamplePlugin`
+- 本目录中的 `samples/LanMountainDesktop.SamplePlugin` 只是镜像模板副本
 
 ## English
 
-`LanAirApp` is the external-facing workspace for the LanMountainDesktop plugin ecosystem. This copy is only a mirror inside the host repository; the standalone `LanAirApp` repository remains the source of truth.
+This `LanAirApp/` directory is a mirror that lives inside the host repository. It exists for local workspace integration and build convenience only. It is not the final authority for the plugin market or developer-facing plugin materials.
+
+### Role of this mirror
+
+- keep a local copy of the `airappmarket` index for workspace integration
+- keep mirrored docs, tools, and sample templates for local development
+- avoid duplicating host runtime responsibilities
+
+### Sources of truth
+
+- Plugin market and developer docs: standalone `LanAirApp`
+- Authoritative sample plugin: standalone `LanMountainDesktop.SamplePlugin`
+- `samples/LanMountainDesktop.SamplePlugin` in this mirror is template/mirror content only

LanAirApp/samples/LanMountainDesktop.SamplePlugin/LanMountainDesktop.SamplePlugin.csproj

@@ -9,9 +9,9 @@
     <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>
+    <PluginPackageOutputDirectory>$(MSBuildThisFileDirectory)artifacts\Packages\</PluginPackageOutputDirectory>
+    <PluginPackagePath>$(PluginPackageOutputDirectory)$(AssemblyName).$(Version).laapp</PluginPackagePath>
+    <LegacyLoosePluginOutputDirectory>$(MSBuildThisFileDirectory)artifacts\Loose\</LegacyLoosePluginOutputDirectory>
   </PropertyGroup>
 
   <ItemGroup>

LanAirApp/samples/LanMountainDesktop.SamplePlugin/SamplePlugin.cs

@@ -16,7 +16,6 @@ public sealed class SamplePlugin : PluginBase, IDisposable
         var hostName = GetHostProperty(context, PluginHostPropertyKeys.HostApplicationName, "UnknownHost");
         var hostVersion = GetHostProperty(context, PluginHostPropertyKeys.HostVersion, "UnknownVersion");
         var sdkApiVersion = GetHostProperty(context, PluginHostPropertyKeys.PluginSdkApiVersion, "UnknownApiVersion");
-        var hostApplicationLifecycle = context.GetService<IHostApplicationLifecycle>();
         var messageBus = context.GetService<IPluginMessageBus>()
             ?? throw new InvalidOperationException("Plugin message bus is not available.");
 
@@ -44,31 +43,26 @@ public sealed class SamplePlugin : PluginBase, IDisposable
             File.AppendAllText(logPath, initMessage + Environment.NewLine);
             _stateService.MarkBackendReady(localizer.Format(
                 "status.backend.detail.log_written",
-                "初始化日志已写入：{0}",
+                "Initialization log written: {0}",
                 logPath));
         }
         catch (Exception ex)
         {
             _stateService.MarkBackendFaulted(localizer.Format(
                 "status.backend.detail.log_write_failed",
-                "初始化日志写入失败：{0}",
+                "Initialization log failed: {0}",
                 ex.Message));
             throw;
         }
 
         _clockService.Start();
 
-        context.RegisterSettingsPage(new PluginSettingsPageRegistration(
-            "status",
-            localizer.GetString("settings.page_title", "插件状态"),
-            () => new SamplePluginSettingsView(context)));
-
         context.RegisterDesktopComponent(new PluginDesktopComponentRegistration(
             "LanMountainDesktop.SamplePlugin.StatusClock",
-            localizer.GetString("widget.display_name", "示例插件状态时钟"),
+            localizer.GetString("widget.display_name", "Sample Plugin Status Clock"),
             widgetContext => new SamplePluginStatusClockWidget(widgetContext),
             iconKey: "PuzzlePiece",
-            category: localizer.GetString("widget.category", "插件"),
+            category: localizer.GetString("widget.category", "Plugins"),
             minWidthCells: 4,
             minHeightCells: 4,
             allowDesktopPlacement: true,
@@ -78,10 +72,10 @@ public sealed class SamplePlugin : PluginBase, IDisposable
 
         context.RegisterDesktopComponent(new PluginDesktopComponentRegistration(
             "LanMountainDesktop.SamplePlugin.CloseDesktop",
-            localizer.GetString("widget.close_desktop.display_name", "关闭桌面"),
+            localizer.GetString("widget.close_desktop.display_name", "Close Desktop"),
             widgetContext => new SamplePluginCloseDesktopWidget(widgetContext),
             iconKey: "DismissCircle",
-            category: localizer.GetString("widget.category", "鎻掍欢"),
+            category: localizer.GetString("widget.category", "Plugins"),
             minWidthCells: 2,
             minHeightCells: 1,
             allowDesktopPlacement: true,

LanMontainDesktop/.trae/specs/remove-video-wallpaper-feature/design.md

@@ -0,0 +1,578 @@
+# 移除视频壁纸功能 - 技术设计文档
+
+## 1. 概述
+
+### 1.1 设计目标
+
+本设计文档描述如何从 LanMountainDesktop 项目中完全移除视频壁纸功能，包括：
+- 移除 LibVLC 相关依赖
+- 清理主窗口中的视频壁纸代码
+- 简化壁纸设置页面
+- 清理本地化资源
+
+### 1.2 技术约束
+
+- 保持现有图片壁纸和纯色壁纸功能完整
+- 确保应用构建和运行正常
+- 不引入新的外部依赖
+
+---
+
+## 2. 架构变更
+
+### 2.1 变更概览图
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                        变更前架构                                │
+├─────────────────────────────────────────────────────────────────┤
+│  MainWindow                                                      │
+│  ├── DesktopWallpaperLayer (背景层)                              │
+│  │   ├── DesktopWallpaperImageLayer (图片层)                     │
+│  │   ├── DesktopVideoWallpaperImage (视频海报层)                  │
+│  │   └── DesktopVideoWallpaperView (VLC视频播放层)               │
+│  ├── _libVlc, _videoWallpaperPlayer, _videoWallpaperMedia        │
+│  └── StartVideoWallpaper(), StopVideoWallpaper()                 │
+│                                                                  │
+│  WallpaperSettingsPage                                           │
+│  ├── 类型选择: Image | Video | SolidColor                        │
+│  └── 视频预览区域                                                 │
+└─────────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────────┐
+│                        变更后架构                                │
+├─────────────────────────────────────────────────────────────────┤
+│  MainWindow                                                      │
+│  ├── DesktopWallpaperLayer (背景层)                              │
+│  │   └── DesktopWallpaperImageLayer (图片层)                     │
+│  └── (移除所有视频相关字段和方法)                                  │
+│                                                                  │
+│  WallpaperSettingsPage                                           │
+│  ├── 类型选择: Image | SolidColor                                │
+│  └── (移除视频预览区域)                                           │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### 2.2 组件变更清单
+
+| 组件 | 变更类型 | 说明 |
+|------|----------|------|
+| LanMountainDesktop.csproj | 修改 | 移除 LibVLC 包引用 |
+| MainWindow.axaml | 修改 | 移除视频控件和命名空间 |
+| MainWindow.axaml.cs | 修改 | 移除视频相关字段和清理代码 |
+| MainWindow.SettingsHardCut.Stubs.cs | 修改 | 移除视频壁纸方法 |
+| AppearanceThemeService.cs | 修改 | 移除视频种子提取器 |
+| WallpaperSettingsPage.axaml | 修改 | 移除视频类型UI |
+| WallpaperSettingsPageViewModel.cs | 修改 | 移除视频相关属性 |
+| SettingsContracts.cs | 修改 | 移除 Video 枚举值 |
+| SettingsDomainServices.cs | 修改 | 移除视频扩展名检测 |
+| zh-CN.json | 修改 | 移除视频相关本地化文本 |
+
+---
+
+## 3. 详细设计
+
+### 3.1 项目依赖变更 (LanMountainDesktop.csproj)
+
+#### 3.1.1 移除的包引用
+
+```xml
+<!-- 移除以下包引用 -->
+<PackageReference Include="LibVLCSharp.Avalonia" Version="3.9.5" />
+<PackageReference Include="VideoLAN.LibVLC.Windows" Version="3.0.23" Condition="..." />
+<PackageReference Include="VideoLAN.LibVLC.Mac" Version="3.1.3.1" Condition="..." />
+```
+
+#### 3.1.2 变更影响
+
+- 减少约 100MB+ 的依赖包大小
+- 简化构建和发布流程
+- 移除平台特定的原生库依赖
+
+---
+
+### 3.2 主窗口 XAML 变更 (MainWindow.axaml)
+
+#### 3.2.1 移除命名空间声明
+
+```xml
+<!-- 移除此行 -->
+xmlns:vlc="clr-namespace:LibVLCSharp.Avalonia;assembly=LibVLCSharp.Avalonia"
+```
+
+#### 3.2.2 移除视频壁纸控件
+
+移除以下控件（约第126-137行）：
+
+```xml
+<!-- 移除 DesktopVideoWallpaperImage -->
+<Image x:Name="DesktopVideoWallpaperImage"
+       IsVisible="False"
+       IsHitTestVisible="False"
+       Stretch="UniformToFill"
+       HorizontalAlignment="Stretch"
+       VerticalAlignment="Stretch" />
+
+<!-- 移除 DesktopVideoWallpaperView -->
+<vlc:VideoView x:Name="DesktopVideoWallpaperView"
+               IsVisible="False"
+               IsHitTestVisible="False"
+               HorizontalAlignment="Stretch"
+               VerticalAlignment="Stretch" />
+```
+
+---
+
+### 3.3 主窗口代码变更 (MainWindow.axaml.cs)
+
+#### 3.3.1 移除 using 声明
+
+```csharp
+// 移除以下 using（如果存在）
+using LibVLCSharp.Shared;
+using LibVLCSharp.Avalonia;
+```
+
+#### 3.3.2 移除静态字段
+
+```csharp
+// 移除以下字段（约第68-71行）
+private static readonly HashSet<string> SupportedVideoExtensions = new(StringComparer.OrdinalIgnoreCase)
+{
+    ".mp4", ".mkv", ".webm", ".avi", ".mov", ".m4v"
+};
+```
+
+#### 3.3.3 移除实例字段
+
+```csharp
+// 移除以下字段（约第123-146行）
+private Bitmap? _videoWallpaperPosterBitmap;
+private string? _videoWallpaperPosterPath;
+private string? _wallpaperVideoPath;
+private LibVLC? _libVlc;
+private MediaPlayer? _videoWallpaperPlayer;
+private Media? _videoWallpaperMedia;
+private readonly object _desktopVideoFrameSync = new();
+private MediaPlayer.LibVLCVideoLockCb? _desktopVideoLockCallback;
+private MediaPlayer.LibVLCVideoUnlockCb? _desktopVideoUnlockCallback;
+private MediaPlayer.LibVLCVideoDisplayCb? _desktopVideoDisplayCallback;
+private DispatcherTimer? _desktopVideoFrameRefreshTimer;
+private IntPtr _desktopVideoFrameBufferPtr;
+private byte[]? _desktopVideoStagingBuffer;
+private WriteableBitmap? _desktopVideoBitmap;
+private int _desktopVideoFrameWidth;
+private int _desktopVideoFrameHeight;
+private int _desktopVideoFramePitch;
+private int _desktopVideoFrameBufferSize;
+private int _desktopVideoFrameDirtyFlag;
+```
+
+#### 3.3.4 修改 OnClosed 方法
+
+移除视频相关清理代码（约第336-350行）：
+
+```csharp
+// 移除以下代码行
+StopVideoWallpaper();
+_videoWallpaperMedia?.Dispose();
+_videoWallpaperMedia = null;
+_videoWallpaperPlayer?.Dispose();
+_videoWallpaperPlayer = null;
+_desktopVideoFrameRefreshTimer?.Stop();
+_desktopVideoFrameRefreshTimer = null;
+_videoWallpaperPosterBitmap?.Dispose();
+_videoWallpaperPosterBitmap = null;
+_videoWallpaperPosterPath = null;
+_libVlc?.Dispose();
+_libVlc = null;
+```
+
+---
+
+### 3.4 主窗口 Stub 方法变更 (MainWindow.SettingsHardCut.Stubs.cs)
+
+#### 3.4.1 移除 using 声明
+
+```csharp
+// 移除以下 using（第19-20行）
+using LibVLCSharp.Shared;
+using LibVLCSharp.Avalonia;
+```
+
+#### 3.4.2 移除方法
+
+移除以下完整方法：
+
+| 方法名 | 行号范围 | 说明 |
+|--------|----------|------|
+| `StartVideoWallpaper` | 337-383 | 启动视频壁纸播放 |
+| `StopVideoWallpaper` | 385-395 | 停止视频壁纸播放 |
+| `TryCaptureVideoWallpaperPosterFrame` | 666-751 | 捕获视频海报帧 |
+| `ApplyVideoWallpaperPosterVisibility` | 647-664 | 控制视频海报可见性 |
+
+#### 3.4.3 修改 UpdateWallpaperDisplay 方法
+
+简化为仅处理图片壁纸：
+
+```csharp
+private void UpdateWallpaperDisplay()
+{
+    // 移除视频分支，仅保留图片处理
+    StopVideoWallpaper();  // 移除此调用
+    ApplyWallpaperBrush();
+}
+```
+
+修改后：
+
+```csharp
+private void UpdateWallpaperDisplay()
+{
+    ApplyWallpaperBrush();
+}
+```
+
+#### 3.4.4 修改 ApplyWallpaperBrush 方法
+
+移除所有 `ApplyVideoWallpaperPosterVisibility` 调用：
+
+```csharp
+// 移除以下调用
+ApplyVideoWallpaperPosterVisibility(showPoster: false);
+ApplyVideoWallpaperPosterVisibility(showPoster: _videoWallpaperPosterBitmap is not null);
+```
+
+#### 3.4.5 修改 SetWallpaperState 方法
+
+移除视频类型处理分支（约第238-247行）：
+
+```csharp
+// 移除以下代码块
+var requestedTypeIsVideo = string.Equals(_wallpaperType, "Video", StringComparison.OrdinalIgnoreCase);
+if (SupportedVideoExtensions.Contains(extension) || requestedTypeIsVideo)
+{
+    _wallpaperMediaType = WallpaperMediaType.Video;
+    _wallpaperVideoPath = _wallpaperPath;
+    _wallpaperDisplayState = File.Exists(_wallpaperPath)
+        ? WallpaperDisplayState.CurrentValidWallpaper
+        : WallpaperDisplayState.TemporarilyUnavailable;
+    return;
+}
+```
+
+---
+
+### 3.5 外观主题服务变更 (AppearanceThemeService.cs)
+
+#### 3.5.1 移除接口和类
+
+移除以下代码（约第92-184行）：
+
+```csharp
+// 移除接口
+internal interface IVideoWallpaperSeedExtractor
+{
+    IReadOnlyList<Color> ExtractSeedCandidates(string videoPath, MonetColorService monetColorService);
+}
+
+// 移除实现类
+internal sealed class LibVlcVideoWallpaperSeedExtractor : IVideoWallpaperSeedExtractor
+{
+    // ... 整个类实现
+}
+```
+
+---
+
+### 3.6 壁纸设置页面 XAML 变更 (WallpaperSettingsPage.axaml)
+
+#### 3.6.1 移除视频预览区域
+
+移除以下代码（约第29-44行）：
+
+```xml
+<Border Background="#FFF6F7F9"
+        IsVisible="{Binding IsVideo}">
+    <StackPanel HorizontalAlignment="Center"
+                VerticalAlignment="Center"
+                Spacing="12">
+        <fi:FluentIcon Icon="Video"
+                       Width="72"
+                       Height="72"
+                       Foreground="{DynamicResource AdaptiveTextSecondaryBrush}" />
+        <TextBlock Text="{Binding VideoModeHintText}"
+                   Width="300"
+                   TextAlignment="Center"
+                   TextWrapping="Wrap"
+                   Foreground="{DynamicResource AdaptiveTextSecondaryBrush}" />
+    </StackPanel>
+</Border>
+```
+
+#### 3.6.2 移除视频模式提示文本
+
+移除以下代码（约第150-154行）：
+
+```xml
+<TextBlock Margin="0,8,0,0"
+           IsVisible="{Binding IsVideo}"
+           Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
+           Text="{Binding VideoModeHintText}"
+           TextWrapping="Wrap" />
+```
+
+#### 3.6.3 修改填充方式设置可见性绑定
+
+```xml
+<!-- 修改前 -->
+IsVisible="{Binding IsImageOrVideo}"
+
+<!-- 修改后 -->
+IsVisible="{Binding IsImage}"
+```
+
+---
+
+### 3.7 壁纸设置 ViewModel 变更 (WallpaperSettingsPageViewModel.cs)
+
+#### 3.7.1 移除属性
+
+```csharp
+// 移除以下属性
+[ObservableProperty]
+private bool _isImageOrVideo;
+
+[ObservableProperty]
+private bool _isVideo;
+
+[ObservableProperty]
+private string _videoModeHintText = string.Empty;
+```
+
+#### 3.7.2 修改 CreateWallpaperTypes 方法
+
+```csharp
+// 修改前
+private IReadOnlyList<SelectionOption> CreateWallpaperTypes()
+{
+    return
+    [
+        new SelectionOption("Image", L("settings.wallpaper.type.image", "Image")),
+        new SelectionOption("Video", L("settings.wallpaper.type.video", "Video")),
+        new SelectionOption("SolidColor", L("settings.wallpaper.type.solid_color", "Solid Color"))
+    ];
+}
+
+// 修改后
+private IReadOnlyList<SelectionOption> CreateWallpaperTypes()
+{
+    return
+    [
+        new SelectionOption("Image", L("settings.wallpaper.type.image", "Image")),
+        new SelectionOption("SolidColor", L("settings.wallpaper.type.solid_color", "Solid Color"))
+    ];
+}
+```
+
+#### 3.7.3 修改 UpdateVisibility 方法
+
+移除 IsVideo 和 IsImageOrVideo 的赋值：
+
+```csharp
+// 移除以下行
+IsVideo = SelectedWallpaperType?.Value == "Video";
+IsImageOrVideo = SelectedWallpaperType?.Value is "Image" or "Video";
+```
+
+#### 3.7.4 修改 RefreshLocalizedText 方法
+
+```csharp
+// 移除以下行
+VideoModeHintText = L("settings.wallpaper.video_mode", "Video wallpaper uses automatic fill mode.");
+```
+
+---
+
+### 3.8 设置契约变更 (SettingsContracts.cs)
+
+#### 3.8.1 修改 WallpaperMediaType 枚举
+
+```csharp
+// 修改前
+public enum WallpaperMediaType
+{
+    None,
+    Image,
+    Video
+}
+
+// 修改后
+public enum WallpaperMediaType
+{
+    None,
+    Image
+}
+```
+
+---
+
+### 3.9 设置域服务变更 (SettingsDomainServices.cs)
+
+#### 3.9.1 移除视频扩展名集合
+
+```csharp
+// 移除以下字段（约第150-153行）
+private static readonly HashSet<string> VideoExtensions = new(StringComparer.OrdinalIgnoreCase)
+{
+    ".mp4", ".mkv", ".webm", ".avi", ".mov", ".m4v"
+};
+```
+
+#### 3.9.2 修改 DetectMediaType 方法
+
+```csharp
+// 修改前
+public WallpaperMediaType DetectMediaType(string? path)
+{
+    if (string.IsNullOrWhiteSpace(path))
+    {
+        return WallpaperMediaType.None;
+    }
+
+    var extension = Path.GetExtension(path.Trim());
+    if (string.IsNullOrWhiteSpace(extension))
+    {
+        return WallpaperMediaType.None;
+    }
+
+    if (ImageExtensions.Contains(extension))
+    {
+        return WallpaperMediaType.Image;
+    }
+
+    if (VideoExtensions.Contains(extension))
+    {
+        return WallpaperMediaType.Video;
+    }
+
+    return WallpaperMediaType.None;
+}
+
+// 修改后
+public WallpaperMediaType DetectMediaType(string? path)
+{
+    if (string.IsNullOrWhiteSpace(path))
+    {
+        return WallpaperMediaType.None;
+    }
+
+    var extension = Path.GetExtension(path.Trim());
+    if (string.IsNullOrWhiteSpace(extension))
+    {
+        return WallpaperMediaType.None;
+    }
+
+    if (ImageExtensions.Contains(extension))
+    {
+        return WallpaperMediaType.Image;
+    }
+
+    return WallpaperMediaType.None;
+}
+```
+
+---
+
+### 3.10 本地化文件变更 (zh-CN.json)
+
+#### 3.10.1 移除的本地化键
+
+```json
+// 移除以下键值对
+"settings.wallpaper.type.video": "视频",
+"settings.wallpaper.video_applied": "视频壁纸已应用。",
+"settings.wallpaper.video_mode": "视频壁纸使用自动填充模式。",
+"settings.wallpaper.video_restored": "已恢复保存的视频壁纸。",
+"settings.wallpaper.video_not_found": "未找到视频壁纸文件。",
+"settings.wallpaper.video_player_unavailable": "视频播放器不可用。",
+"settings.wallpaper.video_play_failed_format": "播放视频壁纸失败：{0}"
+```
+
+#### 3.10.2 修改描述文本
+
+```json
+// 修改前
+"settings.wallpaper.description": "选择图片或视频后可立即设为应用窗口壁纸。",
+
+// 修改后
+"settings.wallpaper.description": "选择图片后可立即设为应用窗口壁纸。",
+```
+
+---
+
+## 4. 数据模型变更
+
+### 4.1 WallpaperMediaType 枚举简化
+
+```
+变更前: None | Image | Video
+变更后: None | Image
+```
+
+### 4.2 设置存储兼容性
+
+现有用户设置中如果包含 `Type: "Video"` 的壁纸配置：
+- 应用将无法识别该类型
+- 将回退到纯色背景
+- 用户需要重新选择图片壁纸
+
+---
+
+## 5. 风险评估
+
+### 5.1 潜在风险
+
+| 风险 | 影响 | 缓解措施 |
+|------|------|----------|
+| 现有视频壁纸用户设置失效 | 中 | 应用会自动回退到纯色背景 |
+| 遗漏的视频相关代码引用 | 低 | 编译器会报告未定义类型错误 |
+| 本地化键遗漏 | 低 | 运行时会显示键名而非翻译文本 |
+
+### 5.2 回滚策略
+
+如需回滚，可通过 Git 恢复以下文件：
+- LanMountainDesktop.csproj
+- MainWindow.axaml / .axaml.cs
+- MainWindow.SettingsHardCut.Stubs.cs
+- AppearanceThemeService.cs
+- WallpaperSettingsPage.axaml
+- WallpaperSettingsPageViewModel.cs
+- SettingsContracts.cs
+- SettingsDomainServices.cs
+- zh-CN.json
+
+---
+
+## 6. 验证清单
+
+### 6.1 编译验证
+
+- [ ] 项目编译无错误
+- [ ] 无 LibVLC 相关类型引用警告
+- [ ] 无未使用变量警告
+
+### 6.2 功能验证
+
+- [ ] 应用正常启动
+- [ ] 图片壁纸正常显示
+- [ ] 纯色壁纸正常显示
+- [ ] 壁纸设置页面正常打开
+- [ ] 类型选择器仅显示"图片"和"纯色"
+- [ ] 壁纸导入功能正常工作
+
+### 6.3 清理验证
+
+- [ ] 无 LibVLC 相关 DLL 在输出目录
+- [ ] 无视频相关本地化文本残留
+- [ ] 无视频相关 UI 控件残留

LanMontainDesktop/.trae/specs/remove-video-wallpaper-feature/spec.md

@@ -0,0 +1,206 @@
+# 移除视频壁纸功能规格说明书
+
+## Why
+
+当前 LanMountainDesktop 项目包含视频壁纸功能，该功能引入了以下复杂性和依赖：
+1. 引入了 LibVLCSharp.Avalonia、VideoLAN.LibVLC.Windows、VideoLAN.LibVLC.Mac 等重型依赖
+2. 在主窗口中残留大量视频壁纸相关代码和字段
+3. 在设置页面中保留了视频类型选择器和相关 UI 元素
+4. 在本地化文件中保留了视频壁纸相关文本
+5. 增加了应用复杂度和维护成本
+
+用户决定移除该功能以简化代码库。
+
+## What Changes
+
+- 移除 LibVLCSharp.Avalonia 及 VideoLAN.LibVLC.* NuGet 依赖
+- 移除 AppearanceThemeService.cs 中的 LibVlcVideoWallpaperSeedExtractor 类和 IVideoWallpaperSeedExtractor 接口
+- 移除 MainWindow.axaml.cs 中的视频壁纸相关字段和清理代码
+- 移除 MainWindow.SettingsHardCut.Stubs.cs 中的视频壁纸相关方法
+- 移除 MainWindow.axaml 中的 DesktopVideoWallpaperImage 和 DesktopVideoWallpaperView 控件
+- 移除 WallpaperSettingsPage.axaml 中的视频类型选择器和视频模式提示
+- 移除 WallpaperSettingsPageViewModel.cs 中的 IsVideo、VideoModeHintText 等属性
+- 移除 SettingsContracts.cs 中 WallpaperMediaType 枚举的 Video 值
+- 移除 SettingsDomainServices.cs 中 WallpaperMediaService 类的视频扩展名检测逻辑
+- 移除本地化文件中的视频壁纸相关文本
+
+## Impact
+
+### Affected specs
+- 壁纸设置功能规格
+- 主窗口桌面层规格
+
+### Affected code
+- `LanMountainDesktop.csproj` - NuGet 依赖配置
+- `Services/AppearanceThemeService.cs` - 视频壁纸种子提取器
+- `Views/MainWindow.axaml.cs` - 主窗口字段和清理逻辑
+- `Views/MainWindow.SettingsHardCut.Stubs.cs` - 视频壁纸控制方法
+- `Views/MainWindow.axaml` - 视频壁纸 UI 控件
+- `Views/SettingsPages/WallpaperSettingsPage.axaml` - 壁纸设置页面 UI
+- `ViewModels/WallpaperSettingsPageViewModel.cs` - 壁纸设置 ViewModel
+- `Services/Settings/SettingsContracts.cs` - 壁纸媒体类型枚举
+- `Services/Settings/SettingsDomainServices.cs` - 壁纸媒体服务
+- `Localization/zh-CN.json` - 本地化文本
+
+---
+
+## REMOVED Requirements
+
+### Requirement: 视频壁纸播放功能
+
+**Reason**: 用户决定移除视频壁纸功能以简化代码库，减少重型依赖
+
+**Migration**: 
+- 用户如需动态壁纸，可使用静态图片壁纸替代
+- 现有视频壁纸设置将被重置为纯色背景
+
+#### Scenario: 视频壁纸播放
+- **GIVEN** 用户选择了视频文件作为壁纸
+- **WHEN** 系统检测到视频格式
+- **THEN** 系统不再支持视频壁纸播放
+- **AND THEN** 系统提示用户该文件类型不受支持
+
+### Requirement: LibVLC 依赖
+
+**Reason**: 移除视频壁纸功能后不再需要 LibVLC 库
+
+**Migration**: 从项目依赖中移除以下包：
+- LibVLCSharp.Avalonia
+- VideoLAN.LibVLC.Windows
+- VideoLAN.LibVLC.Mac
+
+### Requirement: 视频壁纸种子提取
+
+**Reason**: 移除视频壁纸功能后不再需要从视频中提取颜色种子
+
+**Migration**: 移除 `LibVlcVideoWallpaperSeedExtractor` 类和 `IVideoWallpaperSeedExtractor` 接口
+
+### Requirement: 视频壁纸 UI 控件
+
+**Reason**: 移除视频壁纸功能后不再需要视频显示控件
+
+**Migration**: 移除 `DesktopVideoWallpaperImage` 和 `DesktopVideoWallpaperView` 控件
+
+### Requirement: 视频类型选择器
+
+**Reason**: 移除视频壁纸功能后不再需要视频类型选项
+
+**Migration**: 从壁纸类型选择器中移除"视频"选项
+
+---
+
+## MODIFIED Requirements
+
+### Requirement: 壁纸媒体类型检测
+
+**当前**: 支持检测 None、Image、Video 三种类型
+
+**修改后**: 仅支持检测 None、Image 两种类型
+
+#### Scenario: 检测媒体类型
+- **WHEN** 用户选择壁纸文件
+- **THEN** 系统仅检测图片格式（.png, .jpg, .jpeg, .bmp, .gif, .webp）
+- **AND THEN** 视频格式文件将被识别为不受支持的类型
+
+### Requirement: 壁纸类型选项
+
+**当前**: 提供图片、视频、纯色三种类型选项
+
+**修改后**: 仅提供图片、纯色两种类型选项
+
+#### Scenario: 壁纸类型选择
+- **WHEN** 用户打开壁纸设置页面
+- **THEN** 类型选择器仅显示"图片"和"纯色"选项
+- **AND THEN** "视频"选项不再显示
+
+### Requirement: 壁纸设置页面预览
+
+**当前**: 根据类型显示图片预览、视频预览或纯色预览
+
+**修改后**: 根据类型显示图片预览或纯色预览
+
+#### Scenario: 预览显示
+- **WHEN** 用户选择壁纸类型
+- **THEN** 系统仅显示图片预览或纯色预览
+- **AND THEN** 视频预览区域不再显示
+
+### Requirement: 主窗口壁纸显示
+
+**当前**: 支持显示静态图片壁纸和视频壁纸
+
+**修改后**: 仅支持显示静态图片壁纸
+
+#### Scenario: 壁纸显示更新
+- **WHEN** 用户应用新壁纸
+- **THEN** 系统仅处理静态图片壁纸显示
+- **AND THEN** 视频壁纸播放逻辑不再执行
+
+---
+
+## ADDED Requirements
+
+### Requirement: 清理残留代码
+
+系统 SHALL 完全移除视频壁纸功能相关的所有代码和资源。
+
+#### Scenario: 主窗口字段清理
+- **WHEN** 执行代码清理
+- **THEN** 移除以下字段：
+  - `_videoWallpaperPosterBitmap`
+  - `_videoWallpaperPosterPath`
+  - `_libVlc`
+  - `_videoWallpaperPlayer`
+  - `_videoWallpaperMedia`
+  - `_wallpaperVideoPath`
+
+#### Scenario: 主窗口方法清理
+- **WHEN** 执行代码清理
+- **THEN** 移除以下方法：
+  - `StartVideoWallpaper`
+  - `StopVideoWallpaper`
+  - `TryCaptureVideoWallpaperPosterFrame`
+  - `ApplyVideoWallpaperPosterVisibility`
+  - `UpdateWallpaperDisplay` 中的视频处理分支
+
+#### Scenario: ViewModel 属性清理
+- **WHEN** 执行代码清理
+- **THEN** 移除以下属性：
+  - `IsVideo`
+  - `VideoModeHintText`
+  - `IsImageOrVideo`（改为 `IsImage`）
+
+#### Scenario: 本地化文本清理
+- **WHEN** 执行代码清理
+- **THEN** 移除以下本地化键：
+  - `settings.wallpaper.type.video`
+  - `settings.wallpaper.video_applied`
+  - `settings.wallpaper.video_mode`
+  - `settings.wallpaper.video_restored`
+  - `settings.wallpaper.video_not_found`
+  - `settings.wallpaper.video_player_unavailable`
+  - `settings.wallpaper.video_play_failed_format`
+
+### Requirement: 依赖项清理
+
+系统 SHALL 从项目文件中移除 LibVLC 相关 NuGet 包引用。
+
+#### Scenario: NuGet 包移除
+- **WHEN** 执行依赖清理
+- **THEN** 移除以下包引用：
+  - `LibVLCSharp.Avalonia`
+  - `VideoLAN.LibVLC.Windows`
+  - `VideoLAN.LibVLC.Mac`
+
+### Requirement: 构建验证
+
+系统 SHALL 在移除视频壁纸功能后保持正常构建和运行。
+
+#### Scenario: 构建成功
+- **WHEN** 执行项目构建
+- **THEN** 构建成功无错误
+- **AND THEN** 所有现有测试通过
+
+#### Scenario: 应用启动
+- **WHEN** 启动应用程序
+- **THEN** 应用正常启动
+- **AND THEN** 壁纸设置功能正常工作（仅支持图片和纯色）

LanMontainDesktop/.trae/specs/remove-video-wallpaper-feature/tasks.md

@@ -0,0 +1,600 @@
+# 移除视频壁纸功能 - 编码任务清单
+
+## 任务概览
+
+本文档将技术设计分解为可执行的编码任务，按依赖关系排序执行。
+
+---
+
+## 任务 1: 移除项目依赖
+
+**优先级**: P0 (最高)  
+**依赖**: 无  
+**预估工作量**: 5 分钟
+
+### 描述
+
+从项目文件中移除 LibVLC 相关的 NuGet 包引用。
+
+### 输入
+
+- `LanMountainDesktop/LanMountainDesktop.csproj`
+
+### 输出
+
+- 修改后的 `LanMountainDesktop.csproj`，移除以下包引用：
+  - `LibVLCSharp.Avalonia`
+  - `VideoLAN.LibVLC.Windows`
+  - `VideoLAN.LibVLC.Mac`
+
+### 验收标准
+
+- [ ] 项目文件中不再包含 LibVLC 相关包引用
+- [ ] 执行 `dotnet restore` 成功
+
+### 执行提示
+
+```
+编辑 LanMountainDesktop.csproj，移除以下 PackageReference 节点：
+1. <PackageReference Include="LibVLCSharp.Avalonia" Version="3.9.5" />
+2. <PackageReference Include="VideoLAN.LibVLC.Windows" ... />
+3. <PackageReference Include="VideoLAN.LibVLC.Mac" ... />
+```
+
+---
+
+## 任务 2: 移除主窗口 XAML 视频控件
+
+**优先级**: P0  
+**依赖**: 任务 1  
+**预估工作量**: 10 分钟
+
+### 描述
+
+从 MainWindow.axaml 中移除视频壁纸相关的 XAML 控件和命名空间声明。
+
+### 输入
+
+- `LanMountainDesktop/Views/MainWindow.axaml`
+
+### 输出
+
+- 移除 LibVLC 命名空间声明
+- 移除 `DesktopVideoWallpaperImage` 控件
+- 移除 `DesktopVideoWallpaperView` 控件
+
+### 验收标准
+
+- [ ] XAML 中无 `xmlns:vlc` 命名空间
+- [ ] XAML 中无 `DesktopVideoWallpaperImage` 元素
+- [ ] XAML 中无 `DesktopVideoWallpaperView` 元素
+
+### 执行提示
+
+```
+编辑 MainWindow.axaml：
+1. 移除第 9 行: xmlns:vlc="clr-namespace:LibVLCSharp.Avalonia;assembly=LibVLCSharp.Avalonia"
+2. 移除第 126-131 行: <Image x:Name="DesktopVideoWallpaperImage" ... />
+3. 移除第 133-137 行: <vlc:VideoView x:Name="DesktopVideoWallpaperView" ... />
+```
+
+---
+
+## 任务 3: 移除主窗口代码视频字段
+
+**优先级**: P0  
+**依赖**: 任务 1  
+**预估工作量**: 15 分钟
+
+### 描述
+
+从 MainWindow.axaml.cs 中移除视频壁纸相关的字段声明。
+
+### 输入
+
+- `LanMountainDesktop/Views/MainWindow.axaml.cs`
+
+### 输出
+
+- 移除 `SupportedVideoExtensions` 静态字段
+- 移除所有视频相关实例字段
+
+### 验收标准
+
+- [ ] 无 `SupportedVideoExtensions` 字段
+- [ ] 无 `_videoWallpaperPosterBitmap` 字段
+- [ ] 无 `_videoWallpaperPosterPath` 字段
+- [ ] 无 `_wallpaperVideoPath` 字段
+- [ ] 无 `_libVlc` 字段
+- [ ] 无 `_videoWallpaperPlayer` 字段
+- [ ] 无 `_videoWallpaperMedia` 字段
+- [ ] 无 `_desktopVideoFrameSync` 及相关视频帧处理字段
+
+### 执行提示
+
+```
+编辑 MainWindow.axaml.cs：
+1. 移除第 68-71 行的 SupportedVideoExtensions 定义
+2. 移除第 123-146 行的所有视频相关字段
+```
+
+---
+
+## 任务 4: 移除主窗口 OnClosed 清理代码
+
+**优先级**: P0  
+**依赖**: 任务 3  
+**预估工作量**: 5 分钟
+
+### 描述
+
+从 MainWindow.axaml.cs 的 OnClosed 方法中移除视频相关清理代码。
+
+### 输入
+
+- `LanMountainDesktop/Views/MainWindow.axaml.cs` (OnClosed 方法)
+
+### 输出
+
+- 简化的 OnClosed 方法，无视频清理逻辑
+
+### 验收标准
+
+- [ ] OnClosed 方法中无 `StopVideoWallpaper()` 调用
+- [ ] OnClosed 方法中无 `_videoWallpaperMedia` 相关清理
+- [ ] OnClosed 方法中无 `_videoWallpaperPlayer` 相关清理
+- [ ] OnClosed 方法中无 `_libVlc` 相关清理
+
+### 执行提示
+
+```
+编辑 MainWindow.axaml.cs 的 OnClosed 方法，移除以下代码行：
+- StopVideoWallpaper();
+- _videoWallpaperMedia?.Dispose(); _videoWallpaperMedia = null;
+- _videoWallpaperPlayer?.Dispose(); _videoWallpaperPlayer = null;
+- _desktopVideoFrameRefreshTimer?.Stop(); _desktopVideoFrameRefreshTimer = null;
+- _videoWallpaperPosterBitmap?.Dispose(); _videoWallpaperPosterBitmap = null;
+- _videoWallpaperPosterPath = null;
+- _libVlc?.Dispose(); _libVlc = null;
+```
+
+---
+
+## 任务 5: 移除主窗口 Stub 方法
+
+**优先级**: P0  
+**依赖**: 任务 1  
+**预估工作量**: 20 分钟
+
+### 描述
+
+从 MainWindow.SettingsHardCut.Stubs.cs 中移除视频壁纸相关方法和 using 声明。
+
+### 输入
+
+- `LanMountainDesktop/Views/MainWindow.SettingsHardCut.Stubs.cs`
+
+### 输出
+
+- 移除 LibVLC using 声明
+- 移除 `StartVideoWallpaper` 方法
+- 移除 `StopVideoWallpaper` 方法
+- 移除 `TryCaptureVideoWallpaperPosterFrame` 方法
+- 移除 `ApplyVideoWallpaperPosterVisibility` 方法
+
+### 验收标准
+
+- [ ] 无 `using LibVLCSharp.Shared;`
+- [ ] 无 `using LibVLCSharp.Avalonia;`
+- [ ] 无 `StartVideoWallpaper` 方法定义
+- [ ] 无 `StopVideoWallpaper` 方法定义
+- [ ] 无 `TryCaptureVideoWallpaperPosterFrame` 方法定义
+- [ ] 无 `ApplyVideoWallpaperPosterVisibility` 方法定义
+
+### 执行提示
+
+```
+编辑 MainWindow.SettingsHardCut.Stubs.cs：
+1. 移除第 19-20 行的 using 声明
+2. 移除 StartVideoWallpaper 方法（第 337-383 行）
+3. 移除 StopVideoWallpaper 方法（第 385-395 行）
+4. 移除 ApplyVideoWallpaperPosterVisibility 方法（第 647-664 行）
+5. 移除 TryCaptureVideoWallpaperPosterFrame 方法（第 666-751 行）
+```
+
+---
+
+## 任务 6: 简化壁纸状态处理逻辑
+
+**优先级**: P0  
+**依赖**: 任务 5  
+**预估工作量**: 15 分钟
+
+### 描述
+
+修改 MainWindow.SettingsHardCut.Stubs.cs 中的壁纸状态处理方法，移除视频类型分支。
+
+### 输入
+
+- `LanMountainDesktop/Views/MainWindow.SettingsHardCut.Stubs.cs`
+
+### 输出
+
+- 简化的 `SetWallpaperState` 方法
+- 简化的 `UpdateWallpaperDisplay` 方法
+- 简化的 `ApplyWallpaperBrush` 方法
+
+### 验收标准
+
+- [ ] `SetWallpaperState` 中无视频类型检测分支
+- [ ] `SetWallpaperState` 中无 `_wallpaperVideoPath` 赋值
+- [ ] `UpdateWallpaperDisplay` 中无 `StopVideoWallpaper()` 调用
+- [ ] `ApplyWallpaperBrush` 中无 `ApplyVideoWallpaperPosterVisibility` 调用
+
+### 执行提示
+
+```
+编辑 MainWindow.SettingsHardCut.Stubs.cs：
+
+1. SetWallpaperState 方法：
+   - 移除 requestedTypeIsVideo 变量定义
+   - 移除视频类型检测 if 块（SupportedVideoExtensions.Contains 检查）
+
+2. UpdateWallpaperDisplay 方法：
+   - 移除视频类型分支，仅保留 ApplyWallpaperBrush() 调用
+
+3. ApplyWallpaperBrush 方法：
+   - 移除所有 ApplyVideoWallpaperPosterVisibility 调用
+```
+
+---
+
+## 任务 7: 移除外观主题服务视频提取器
+
+**优先级**: P1  
+**依赖**: 任务 1  
+**预估工作量**: 10 分钟
+
+### 描述
+
+从 AppearanceThemeService.cs 中移除视频壁纸种子提取器接口和实现类。
+
+### 输入
+
+- `LanMountainDesktop/Services/AppearanceThemeService.cs`
+
+### 输出
+
+- 移除 `IVideoWallpaperSeedExtractor` 接口
+- 移除 `LibVlcVideoWallpaperSeedExtractor` 类
+
+### 验收标准
+
+- [ ] 无 `IVideoWallpaperSeedExtractor` 接口定义
+- [ ] 无 `LibVlcVideoWallpaperSeedExtractor` 类定义
+
+### 执行提示
+
+```
+编辑 AppearanceThemeService.cs：
+移除第 92-184 行的接口和类定义：
+- IVideoWallpaperSeedExtractor 接口
+- LibVlcVideoWallpaperSeedExtractor 类
+```
+
+---
+
+## 任务 8: 简化壁纸设置页面 XAML
+
+**优先级**: P1  
+**依赖**: 无  
+**预估工作量**: 10 分钟
+
+### 描述
+
+从 WallpaperSettingsPage.axaml 中移除视频预览区域和相关 UI 元素。
+
+### 输入
+
+- `LanMountainDesktop/Views/SettingsPages/WallpaperSettingsPage.axaml`
+
+### 输出
+
+- 移除视频预览 Border 区域
+- 移除视频模式提示 TextBlock
+- 修改填充方式可见性绑定
+
+### 验收标准
+
+- [ ] 无视频预览 Border（IsVisible="{Binding IsVideo}"）
+- [ ] 无 VideoModeHintText 绑定的 TextBlock
+- [ ] 填充方式设置绑定改为 `IsVisible="{Binding IsImage}"`
+
+### 执行提示
+
+```
+编辑 WallpaperSettingsPage.axaml：
+1. 移除第 29-44 行的视频预览 Border
+2. 移除第 150-154 行的视频模式提示 TextBlock
+3. 修改第 132 行: IsVisible="{Binding IsImageOrVideo}" 改为 IsVisible="{Binding IsImage}"
+```
+
+---
+
+## 任务 9: 简化壁纸设置 ViewModel
+
+**优先级**: P1  
+**依赖**: 任务 8  
+**预估工作量**: 15 分钟
+
+### 描述
+
+从 WallpaperSettingsPageViewModel.cs 中移除视频相关属性和方法逻辑。
+
+### 输入
+
+- `LanMountainDesktop/ViewModels/WallpaperSettingsPageViewModel.cs`
+
+### 输出
+
+- 移除 `_isImageOrVideo`、`_isVideo`、`_videoModeHintText` 属性
+- 修改 `CreateWallpaperTypes` 方法
+- 修改 `UpdateVisibility` 方法
+- 修改 `RefreshLocalizedText` 方法
+
+### 验收标准
+
+- [ ] 无 `IsImageOrVideo` 属性
+- [ ] 无 `IsVideo` 属性
+- [ ] 无 `VideoModeHintText` 属性
+- [ ] `CreateWallpaperTypes` 仅返回 Image 和 SolidColor 选项
+- [ ] `UpdateVisibility` 中无 IsVideo、IsImageOrVideo 赋值
+- [ ] `RefreshLocalizedText` 中无 VideoModeHintText 赋值
+
+### 执行提示
+
+```
+编辑 WallpaperSettingsPageViewModel.cs：
+1. 移除第 76-77 行的 _isImageOrVideo 字段和属性
+2. 移除第 85-86 行的 _isVideo 字段和属性
+3. 移除第 94-95 行的 _videoModeHintText 字段和属性
+4. 修改 CreateWallpaperTypes 方法，移除 Video 选项
+5. 修改 UpdateVisibility 方法，移除 IsVideo 和 IsImageOrVideo 赋值
+6. 修改 RefreshLocalizedText 方法，移除 VideoModeHintText 赋值
+```
+
+---
+
+## 任务 10: 简化壁纸媒体类型枚举
+
+**优先级**: P1  
+**依赖**: 无  
+**预估工作量**: 5 分钟
+
+### 描述
+
+从 SettingsContracts.cs 中移除 WallpaperMediaType 枚举的 Video 值。
+
+### 输入
+
+- `LanMountainDesktop/Services/Settings/SettingsContracts.cs`
+
+### 输出
+
+- 简化的 `WallpaperMediaType` 枚举
+
+### 验收标准
+
+- [ ] `WallpaperMediaType` 枚举仅包含 `None` 和 `Image`
+
+### 执行提示
+
+```
+编辑 SettingsContracts.cs：
+修改第 11-16 行的枚举定义：
+public enum WallpaperMediaType
+{
+    None,
+    Image
+}
+```
+
+---
+
+## 任务 11: 简化壁纸媒体服务
+
+**优先级**: P1  
+**依赖**: 任务 10  
+**预估工作量**: 10 分钟
+
+### 描述
+
+从 SettingsDomainServices.cs 中移除视频扩展名检测逻辑。
+
+### 输入
+
+- `LanMountainDesktop/Services/Settings/SettingsDomainServices.cs`
+
+### 输出
+
+- 移除 `VideoExtensions` 字段
+- 简化 `DetectMediaType` 方法
+
+### 验收标准
+
+- [ ] 无 `VideoExtensions` 字段定义
+- [ ] `DetectMediaType` 方法中无视频扩展名检测逻辑
+
+### 执行提示
+
+```
+编辑 SettingsDomainServices.cs：
+1. 移除第 150-153 行的 VideoExtensions 字段定义
+2. 修改 DetectMediaType 方法，移除视频检测分支
+```
+
+---
+
+## 任务 12: 清理本地化文件
+
+**优先级**: P2  
+**依赖**: 无  
+**预估工作量**: 5 分钟
+
+### 描述
+
+从 zh-CN.json 中移除视频壁纸相关的本地化文本。
+
+### 输入
+
+- `LanMountainDesktop/Localization/zh-CN.json`
+
+### 输出
+
+- 移除视频相关本地化键
+- 修改壁纸描述文本
+
+### 验收标准
+
+- [ ] 无 `settings.wallpaper.type.video` 键
+- [ ] 无 `settings.wallpaper.video_applied` 键
+- [ ] 无 `settings.wallpaper.video_mode` 键
+- [ ] 无 `settings.wallpaper.video_restored` 键
+- [ ] 无 `settings.wallpaper.video_not_found` 键
+- [ ] 无 `settings.wallpaper.video_player_unavailable` 键
+- [ ] 无 `settings.wallpaper.video_play_failed_format` 键
+- [ ] `settings.wallpaper.description` 文本已更新
+
+### 执行提示
+
+```
+编辑 zh-CN.json：
+1. 移除以下键值对：
+   - "settings.wallpaper.type.video"
+   - "settings.wallpaper.video_applied"
+   - "settings.wallpaper.video_mode"
+   - "settings.wallpaper.video_restored"
+   - "settings.wallpaper.video_not_found"
+   - "settings.wallpaper.video_player_unavailable"
+   - "settings.wallpaper.video_play_failed_format"
+
+2. 修改描述文本：
+   "settings.wallpaper.description": "选择图片后可立即设为应用窗口壁纸。"
+```
+
+---
+
+## 任务 13: 构建验证
+
+**优先级**: P0  
+**依赖**: 任务 1-12 全部完成  
+**预估工作量**: 10 分钟
+
+### 描述
+
+验证项目在移除视频壁纸功能后能够正常构建。
+
+### 输入
+
+- 整个项目
+
+### 输出
+
+- 构建成功确认
+
+### 验收标准
+
+- [ ] `dotnet build` 执行成功，无编译错误
+- [ ] 无 LibVLC 相关类型未定义错误
+- [ ] 无未使用变量警告（或已处理）
+
+### 执行提示
+
+```
+在项目根目录执行：
+dotnet build LanMountainDesktop/LanMountainDesktop.csproj
+
+检查输出：
+- 确认无编译错误
+- 确认无 LibVLC 相关类型引用错误
+```
+
+---
+
+## 任务 14: 功能验证
+
+**优先级**: P0  
+**依赖**: 任务 13  
+**预估工作量**: 15 分钟
+
+### 描述
+
+验证应用在移除视频壁纸功能后核心功能正常工作。
+
+### 输入
+
+- 构建后的应用
+
+### 输出
+
+- 功能验证报告
+
+### 验收标准
+
+- [ ] 应用正常启动
+- [ ] 图片壁纸正常显示
+- [ ] 纯色壁纸正常显示
+- [ ] 壁纸设置页面正常打开
+- [ ] 类型选择器仅显示"图片"和"纯色"选项
+- [ ] 壁纸导入功能正常工作
+
+### 执行提示
+
+```
+运行应用：
+dotnet run --project LanMountainDesktop/LanMountainDesktop.csproj
+
+手动验证：
+1. 应用启动无崩溃
+2. 打开设置 -> 壁纸页面
+3. 确认类型选择器仅有"图片"和"纯色"
+4. 测试选择图片壁纸
+5. 测试选择纯色壁纸
+```
+
+---
+
+## 任务依赖关系图
+
+```
+任务 1 (移除依赖)
+  ├── 任务 2 (XAML控件)
+  ├── 任务 3 (代码字段)
+  │     └── 任务 4 (OnClosed清理)
+  ├── 任务 5 (Stub方法)
+  │     └── 任务 6 (状态处理逻辑)
+  └── 任务 7 (主题服务)
+
+任务 8 (设置页面XAML)
+  └── 任务 9 (设置ViewModel)
+
+任务 10 (枚举简化)
+  └── 任务 11 (媒体服务)
+
+任务 12 (本地化) - 独立
+
+任务 13 (构建验证) - 依赖所有任务
+  └── 任务 14 (功能验证)
+```
+
+---
+
+## 执行顺序建议
+
+按以下顺序执行可确保依赖关系正确：
+
+1. **第一批** (可并行): 任务 1, 任务 8, 任务 10, 任务 12
+2. **第二批** (可并行): 任务 2, 任务 3, 任务 5, 任务 7, 任务 9, 任务 11
+3. **第三批** (可并行): 任务 4, 任务 6
+4. **第四批**: 任务 13
+5. **第五批**: 任务 14

LanMountainDesktop.Appearance/AppearanceCornerRadiusTokenFactory.cs

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

LanMountainDesktop.Appearance/LanMountainDesktop.Appearance.csproj

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

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

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

LanMountainDesktop.DesktopHost/DesktopBootstrap.cs

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

LanMountainDesktop.DesktopHost/DesktopShellHost.cs

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

LanMountainDesktop.DesktopHost/DesktopStartupCoordinator.cs

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

LanMountainDesktop.DesktopHost/LanMountainDesktop.DesktopHost.csproj

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

LanMountainDesktop.DesktopHost/SettingsWindowHost.cs

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

LanMountainDesktop.DesktopHost/ShutdownCoordinator.cs

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

LanMountainDesktop.Host.Abstractions/ComponentChromeContext.cs

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

LanMountainDesktop.Host.Abstractions/IDesktopShellHost.cs

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

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

@@ -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>

LanMountainDesktop.PluginSdk/IComponentEditorHostContext.cs

@@ -0,0 +1,10 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public interface IComponentEditorHostContext
+{
+    void RequestRefresh();
+
+    void CloseEditor();
+
+    void RequestRestart(string? reason = null);
+}

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

LanMountainDesktop.PluginSdk/IPluginContext.cs

@@ -1,6 +1,6 @@
 namespace LanMountainDesktop.PluginSdk;
 
-[Obsolete("Plugin API 2.0.0 uses IPluginRuntimeContext and IServiceCollection-based initialization.")]
+[Obsolete("Plugin API 3.0.0 uses IPluginRuntimeContext and IServiceCollection-based initialization.")]
 public interface IPluginContext : IPluginRuntimeContext
 {
 }

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

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

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

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

LanMountainDesktop.PluginSdk/LanMountainDesktop.PluginSdk.csproj

@@ -4,7 +4,7 @@
     <TargetFramework>net10.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
-    <Version>2.0.0</Version>
+    <Version>3.0.0</Version>
   </PropertyGroup>
 
   <ItemGroup>
@@ -12,6 +12,7 @@
     <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>
 
 </Project>

LanMountainDesktop.PluginSdk/PluginDesktopComponentContext.cs

@@ -1,3 +1,5 @@
+using LanMountainDesktop.Shared.Contracts;
+
 namespace LanMountainDesktop.PluginSdk;
 
 public sealed class PluginDesktopComponentContext
@@ -10,7 +12,10 @@ public sealed class PluginDesktopComponentContext
         IReadOnlyDictionary<string, object?> properties,
         string componentId,
         string? placementId,
-        double cellSize)
+        double cellSize,
+        double globalCornerRadiusScale,
+        AppearanceCornerRadiusTokens cornerRadiusTokens,
+        IPluginSettingsService? pluginSettings = null)
     {
         ArgumentNullException.ThrowIfNull(manifest);
         ArgumentException.ThrowIfNullOrWhiteSpace(pluginDirectory);
@@ -18,6 +23,7 @@ public sealed class PluginDesktopComponentContext
         ArgumentException.ThrowIfNullOrWhiteSpace(componentId);
         ArgumentNullException.ThrowIfNull(services);
         ArgumentNullException.ThrowIfNull(properties);
+        ArgumentNullException.ThrowIfNull(cornerRadiusTokens);
 
         Manifest = manifest;
         PluginDirectory = pluginDirectory;
@@ -27,6 +33,9 @@ public sealed class PluginDesktopComponentContext
         ComponentId = componentId.Trim();
         PlacementId = string.IsNullOrWhiteSpace(placementId) ? null : placementId.Trim();
         CellSize = Math.Max(1, cellSize);
+        GlobalCornerRadiusScale = Math.Max(0.1d, globalCornerRadiusScale);
+        CornerRadiusTokens = cornerRadiusTokens;
+        PluginSettings = pluginSettings;
     }
 
     public PluginManifest Manifest { get; }
@@ -45,6 +54,22 @@ public sealed class PluginDesktopComponentContext
 
     public double CellSize { get; }
 
+    public double GlobalCornerRadiusScale { get; }
+
+    public AppearanceCornerRadiusTokens CornerRadiusTokens { get; }
+
+    public IPluginSettingsService? PluginSettings { get; }
+
+    public double ResolveScaledCornerRadius(double baseRadius, double? minimum = null, double? maximum = null)
+    {
+        var scaled = Math.Max(0d, baseRadius) * GlobalCornerRadiusScale;
+        var scaledMin = minimum.HasValue ? minimum.Value * GlobalCornerRadiusScale : scaled;
+        var scaledMax = maximum.HasValue ? maximum.Value * GlobalCornerRadiusScale : scaled;
+        return minimum.HasValue || maximum.HasValue
+            ? Math.Clamp(scaled, scaledMin, scaledMax)
+            : scaled;
+    }
+
     public T? GetService<T>()
     {
         return (T?)Services.GetService(typeof(T));

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

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

LanMountainDesktop.PluginSdk/PluginManifest.cs

@@ -85,7 +85,10 @@ 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}'. Upgrade the plugin to API {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. " +
+                $"Migrate the plugin to API {PluginSdkInfo.ApiVersion} and rebuild the package.");
         }
 
         return normalized;

LanMountainDesktop.PluginSdk/PluginSdkInfo.cs

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

LanMountainDesktop.PluginSdk/PluginServiceCollectionExtensions.cs

@@ -5,20 +5,26 @@ namespace LanMountainDesktop.PluginSdk;
 
 public static class PluginServiceCollectionExtensions
 {
-    public static IServiceCollection AddPluginSettingsPage<TControl>(
+    public static IServiceCollection AddPluginSettingsSection(
         this IServiceCollection services,
         string id,
-        string title,
+        string titleLocalizationKey,
+        Action<PluginSettingsSectionBuilder> configure,
+        string? descriptionLocalizationKey = null,
+        string iconKey = "PuzzlePiece",
         int sortOrder = 0)
-        where TControl : Control
     {
         ArgumentNullException.ThrowIfNull(services);
+        ArgumentNullException.ThrowIfNull(configure);
 
-        services.AddSingleton(new PluginSettingsPageRegistration(
+        var builder = new PluginSettingsSectionBuilder(
             id,
-            title,
-            provider => ActivatorUtilities.CreateInstance<TControl>(provider),
-            sortOrder));
+            titleLocalizationKey,
+            descriptionLocalizationKey,
+            iconKey,
+            sortOrder);
+        configure(builder);
+        services.AddSingleton(builder.Build());
         return services;
     }
 
@@ -55,6 +61,27 @@ public static class PluginServiceCollectionExtensions
         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

LanMountainDesktop.PluginSdk/PluginSettingsPageRegistration.cs

@@ -1,39 +0,0 @@
-using Avalonia.Controls;
-
-namespace LanMountainDesktop.PluginSdk;
-
-public sealed class PluginSettingsPageRegistration
-{
-    public PluginSettingsPageRegistration(
-        string id,
-        string title,
-        Func<IServiceProvider, 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 PluginSettingsPageRegistration(
-        string id,
-        string title,
-        Func<Control> contentFactory,
-        int sortOrder = 0)
-        : this(id, title, _ => contentFactory(), sortOrder)
-    {
-    }
-
-    public string Id { get; }
-
-    public string Title { get; }
-
-    public int SortOrder { get; }
-
-    public Func<IServiceProvider, Control> ContentFactory { get; }
-}

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

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

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

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

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

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

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

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

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

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

LanMountainDesktop.PluginSdk/SettingsScope.cs

@@ -0,0 +1,9 @@
+namespace LanMountainDesktop.PluginSdk;
+
+public enum SettingsScope
+{
+    App = 0,
+    Launcher = 1,
+    Plugin = 2,
+    ComponentInstance = 3
+}

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

LanMountainDesktop.Settings.Core/GlobalAppearanceSettings.cs

@@ -0,0 +1,20 @@
+namespace LanMountainDesktop.Settings.Core;
+
+public static class GlobalAppearanceSettings
+{
+    public const double DefaultCornerRadiusScale = 1.0;
+    public const double MinimumCornerRadiusScale = 0.70;
+    public const double MaximumCornerRadiusScale = 1.40;
+    public const double CornerRadiusScaleStep = 0.05;
+
+    public static double NormalizeCornerRadiusScale(double value)
+    {
+        if (double.IsNaN(value) || double.IsInfinity(value))
+        {
+            return DefaultCornerRadiusScale;
+        }
+
+        var clamped = Math.Clamp(value, MinimumCornerRadiusScale, MaximumCornerRadiusScale);
+        return Math.Round(clamped / CornerRadiusScaleStep, MidpointRounding.AwayFromZero) * CornerRadiusScaleStep;
+    }
+}

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>

LanMountainDesktop.Shared.Contracts/AppearanceCornerRadiusTokens.cs

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

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

@@ -0,0 +1,10 @@
+<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>
+</Project>

LanMountainDesktop.Tests/LanMountainDesktop.Tests.csproj

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

LanMountainDesktop.Tests/WhiteboardNotePersistenceServiceTests.cs

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

LanMountainDesktop.slnx

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

LanMountainDesktop/App.axaml

@@ -1,4 +1,4 @@
-<Application xmlns="https://github.com/avaloniaui"
+<Application xmlns="https://github.com/avaloniaui"
              xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
              xmlns:sty="using:FluentAvalonia.Styling"
              xmlns:fi="using:FluentIcons.Avalonia"
@@ -22,6 +22,7 @@
         <StyleInclude Source="avares://LanMountainDesktop/Styles/FluttermotionToken.axaml" />
         <StyleInclude Source="avares://LanMountainDesktop/Styles/GlassModule.axaml" />
         <StyleInclude Source="avares://LanMountainDesktop/Styles/SettingsAnimations.axaml" />
+        <StyleInclude Source="avares://LanMountainDesktop/Styles/SettingsCardStyles.axaml" />
 
         <Style Selector="Window">
             <Setter Property="FontFamily" Value="{DynamicResource AppFontFamily}" />

LanMountainDesktop/App.axaml.cs

@@ -1,39 +1,105 @@
+using System;
+using System.Globalization;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
 using Avalonia;
 using Avalonia.Controls;
 using Avalonia.Controls.ApplicationLifetimes;
 using Avalonia.Data.Core;
 using Avalonia.Data.Core.Plugins;
-using System;
-using System.Linq;
 using Avalonia.Markup.Xaml;
+using Avalonia.Media;
 using Avalonia.Platform;
+using Avalonia.Styling;
 using Avalonia.Threading;
+using AvaloniaWebView;
 using LanMountainDesktop.ComponentSystem;
+using LanMountainDesktop.DesktopHost;
+using LanMountainDesktop.Models;
+using LanMountainDesktop.PluginSdk;
 using LanMountainDesktop.Services;
+using LanMountainDesktop.Services.Settings;
+using LanMountainDesktop.Theme;
 using LanMountainDesktop.ViewModels;
 using LanMountainDesktop.Views;
-using AvaloniaWebView;
-using LanMountainDesktop.PluginSdk;
 
 namespace LanMountainDesktop;
 
 public partial class App : Application
 {
-    private readonly AppSettingsService _appSettingsService = new();
+    private static readonly Color DefaultAccentColor = Color.Parse("#FF3B82F6");
+    private enum DesktopShellState
+    {
+        ForegroundDesktop = 0,
+        MinimizedToTaskbar = 1,
+        TrayOnly = 2
+    }
+
+    private enum ShutdownIntent
+    {
+        None = 0,
+        ExitRequested = 1,
+        RestartRequested = 2
+    }
+
+    private readonly ISettingsFacadeService _settingsFacade = HostSettingsFacadeProvider.GetOrCreate();
+    private readonly IAppearanceThemeService _appearanceThemeService = HostAppearanceThemeProvider.GetOrCreate();
+    private readonly IAppLogoService _appLogoService = HostAppLogoProvider.GetOrCreate();
     private readonly LocalizationService _localizationService = new();
     private readonly IHostApplicationLifecycle _hostApplicationLifecycle = new HostApplicationLifecycleService();
+    private readonly IDetachedComponentLibraryWindowService _detachedComponentLibraryWindowService = new DetachedComponentLibraryWindowService();
+    private readonly ILocationService _locationService = HostLocationServiceProvider.GetOrCreate();
+    private ISettingsPageRegistry? _settingsPageRegistry;
+    private ISettingsWindowService? _settingsWindowService;
+    private WeatherLocationRefreshService? _weatherLocationRefreshService;
     private bool _exitCleanupCompleted;
+    private DesktopShellState _desktopShellState = DesktopShellState.ForegroundDesktop;
+    private ShutdownIntent _shutdownIntent;
 
-    private SettingsWindow? _traySettingsWindow;
     private TrayIcons? _trayIcons;
     private PluginRuntimeService? _pluginRuntimeService;
+    private MainWindow? _mainWindow;
+    private bool _mainWindowClosed;
+    private bool _uiUnhandledExceptionHooked;
+    private DesktopShellHost? _desktopShellHost;
 
     internal static SingleInstanceService? CurrentSingleInstanceService { get; set; }
+    internal static (UserBehaviorAnalyticsService?, CrashReportService?) AnalyticsServices { get; set; }
     internal static IHostApplicationLifecycle? CurrentHostApplicationLifecycle =>
         (Current as App)?._hostApplicationLifecycle;
 
+    // 隐私政策查看事件
+    public static event Action? CurrentPrivacyPolicyViewRequested;
+
+    // 触发隐私政策查看事件的方法
+    public static void RaisePrivacyPolicyViewRequested()
+    {
+        CurrentPrivacyPolicyViewRequested?.Invoke();
+    }
+
     public PluginRuntimeService? PluginRuntimeService => _pluginRuntimeService;
+    public ISettingsFacadeService SettingsFacade => _settingsFacade;
     public IHostApplicationLifecycle HostApplicationLifecycle => _hostApplicationLifecycle;
+    internal ISettingsWindowService? SettingsWindowService => _settingsWindowService;
+
+    internal void OpenIndependentSettingsModule(string source, string? pageTag = null)
+    {
+        EnsureSettingsWindowService();
+        AppLogger.Info(
+            "SettingsFacade",
+            $"Opening settings window. Source='{source}'; PageTag='{pageTag ?? "<default>"}'.");
+        _settingsWindowService?.Open(new SettingsWindowOpenRequest(
+            Source: source,
+            Owner: _mainWindow is { IsVisible: true } ? _mainWindow : null,
+            PageId: pageTag));
+    }
+
+    public App()
+    {
+        _settingsFacade.Settings.Changed += OnSettingsChanged;
+        _appearanceThemeService.Changed += OnAppearanceThemeChanged;
+    }
 
     public override void Initialize()
     {
@@ -41,37 +107,43 @@ public partial class App : Application
         ConfigureWebViewUserDataFolder();
         AvaloniaWebViewBuilder.Initialize(default);
         AvaloniaXamlLoader.Load(this);
+        ApplyThemeFromSettings();
+        ApplyCurrentCultureFromSettings();
+        EnsureSettingsWindowService();
+        EnsureWeatherLocationRefreshService();
     }
 
     public override void OnFrameworkInitializationCompleted()
     {
         AppLogger.Info("App", "Framework initialization completed.");
+        RegisterUiUnhandledExceptionGuard();
         LinuxDesktopEntryInstaller.EnsureInstalled();
-        InitializePluginRuntime();
-        AppSettingsService.SettingsSaved += OnAppSettingsSaved;
-        InitializeTrayIcon();
+        DesktopBootstrap.InitializeApplication(this, InitializeDesktopShell);
 
-        if (ApplicationLifetime is IClassicDesktopStyleApplicationLifetime desktop)
-        {
-            // Avoid duplicate validations from both Avalonia and the CommunityToolkit.
-            // More info: https://docs.avaloniaui.net/docs/guides/development-guides/data-validation#manage-validationplugins
-            DisableAvaloniaDataAnnotationValidation();
-            desktop.ShutdownMode = Avalonia.Controls.ShutdownMode.OnExplicitShutdown;
-            desktop.Exit += (_, _) =>
+        base.OnFrameworkInitializationCompleted();
+    }
+
+    private void InitializeDesktopShell()
+    {
+        _desktopShellHost ??= new DesktopShellHost(
+            InitializePluginRuntime,
+            InitializeTrayIcon,
+            desktop =>
+            {
+                // Avoid duplicate validations from both Avalonia and the CommunityToolkit.
+                // More info: https://docs.avaloniaui.net/docs/guides/development-guides/data-validation#manage-validationplugins
+                DisableAvaloniaDataAnnotationValidation();
+                desktop.ShutdownMode = Avalonia.Controls.ShutdownMode.OnExplicitShutdown;
+                CreateAndAssignMainWindow(desktop, "FrameworkInitialization");
+            },
+            () =>
             {
                 AppLogger.Info("App", "Desktop lifetime exit triggered.");
                 PerformExitCleanup();
-            };
-            desktop.MainWindow = new MainWindow
-            {
-                DataContext = new MainWindowViewModel(),
-            };
-            AppLogger.Info("App", $"Main window created. LogFile={AppLogger.LogFilePath}");
-            LogBrowserStartupDiagnostics();
-            CurrentSingleInstanceService?.StartActivationListener(ActivateMainWindow);
-        }
-
-        base.OnFrameworkInitializationCompleted();
+            },
+            () => CurrentSingleInstanceService?.StartActivationListener(ActivateMainWindow),
+            StartWeatherLocationRefreshIfNeeded);
+        _desktopShellHost.Initialize(this);
     }
 
     private void OnTrayExitClick(object? sender, EventArgs e)
@@ -81,42 +153,9 @@ public partial class App : Application
             Reason: "User selected Exit App from the tray menu."));
     }
 
-    private void OnTraySettingsClick(object? sender, EventArgs e)
+    private void OnTrayShowDesktopClick(object? sender, EventArgs e)
     {
-        if (ApplicationLifetime is not IClassicDesktopStyleApplicationLifetime)
-        {
-            return;
-        }
-
-        Dispatcher.UIThread.Post(() =>
-        {
-            try
-            {
-                if (_traySettingsWindow is { } existingWindow && existingWindow.IsVisible)
-                {
-                    existingWindow.WindowState = Avalonia.Controls.WindowState.Normal;
-                    existingWindow.Activate();
-                    return;
-                }
-
-                var settingsWindow = new SettingsWindow();
-                settingsWindow.Closed += (_, _) =>
-                {
-                    if (ReferenceEquals(_traySettingsWindow, settingsWindow))
-                    {
-                        _traySettingsWindow = null;
-                    }
-                };
-
-                _traySettingsWindow = settingsWindow;
-                settingsWindow.Show();
-                settingsWindow.Activate();
-            }
-            catch (Exception ex)
-            {
-                AppLogger.Warn("TraySettings", "Failed to open settings window.", ex);
-            }
-        }, DispatcherPriority.Normal);
+        RestoreOrCreateMainWindow(showSingleInstanceNotice: false, source: "TrayMenu");
     }
 
     private void OnTrayRestartClick(object? sender, EventArgs e)
@@ -126,6 +165,25 @@ public partial class App : Application
             Reason: "User selected Restart App from the tray menu."));
     }
 
+    private void OnTraySettingsClick(object? sender, EventArgs e)
+    {
+        _ = sender;
+        _ = e;
+        OpenIndependentSettingsModule("TrayMenu");
+    }
+
+    private void OnTrayComponentLibraryClick(object? sender, EventArgs e)
+    {
+        _ = sender;
+        _ = e;
+        if (_mainWindow is null)
+        {
+            return;
+        }
+
+        _detachedComponentLibraryWindowService.Open(_mainWindow);
+    }
+
     private void DisableAvaloniaDataAnnotationValidation()
     {
         // Get an array of plugins to remove
@@ -172,7 +230,8 @@ public partial class App : Application
         try
         {
             _pluginRuntimeService?.Dispose();
-            _pluginRuntimeService = new PluginRuntimeService();
+            _pluginRuntimeService = new PluginRuntimeService(_settingsFacade);
+            HostSettingsFacadeProvider.BindPluginRuntime(_pluginRuntimeService);
             _pluginRuntimeService.LoadInstalledPlugins();
         }
         catch (Exception ex)
@@ -187,10 +246,9 @@ public partial class App : Application
         {
             DisposeTrayIcon();
 
-            using var iconStream = AssetLoader.Open(new Uri("avares://LanMountainDesktop/Assets/avalonia-logo.ico"));
             var trayIcon = new TrayIcon
             {
-                Icon = new WindowIcon(iconStream),
+                Icon = _appLogoService.CreateTrayIcon(),
                 ToolTipText = L("tray.tooltip", "LanMountainDesktop"),
                 Menu = BuildTrayMenu(),
                 IsVisible = true
@@ -209,19 +267,27 @@ public partial class App : Application
     {
         var menu = new NativeMenu();
 
-        var settingsItem = new NativeMenuItem(L("tray.menu.settings", "设置"));
+        var showDesktopItem = new NativeMenuItem(L("tray.menu.show_desktop", "Open Desktop"));
+        showDesktopItem.Click += OnTrayShowDesktopClick;
+        menu.Items.Add(showDesktopItem);
+
+        var settingsItem = new NativeMenuItem(L("tray.menu.settings", "Settings"));
         settingsItem.Click += OnTraySettingsClick;
         menu.Items.Add(settingsItem);
 
+        var componentLibraryItem = new NativeMenuItem(L("tray.menu.component_library", "Component Library"));
+        componentLibraryItem.Click += OnTrayComponentLibraryClick;
+        menu.Items.Add(componentLibraryItem);
+
         menu.Items.Add(new NativeMenuItemSeparator());
 
-        var restartItem = new NativeMenuItem(L("tray.menu.restart", "重启应用"));
+        var restartItem = new NativeMenuItem(L("tray.menu.restart", "Restart App"));
         restartItem.Click += OnTrayRestartClick;
         menu.Items.Add(restartItem);
 
         menu.Items.Add(new NativeMenuItemSeparator());
 
-        var exitItem = new NativeMenuItem(L("tray.menu.exit", "退出应用"));
+        var exitItem = new NativeMenuItem(L("tray.menu.exit", "Exit App"));
         exitItem.Click += OnTrayExitClick;
         menu.Items.Add(exitItem);
 
@@ -244,7 +310,84 @@ public partial class App : Application
         _trayIcons = null;
     }
 
+    private void EnsureSettingsWindowService()
+    {
+        _settingsPageRegistry ??= new SettingsPageRegistry(
+            _settingsFacade,
+            _hostApplicationLifecycle,
+            _localizationService,
+            () => _pluginRuntimeService);
+        _settingsWindowService ??= new SettingsWindowService(
+            _settingsPageRegistry,
+            _hostApplicationLifecycle,
+            _settingsFacade);
+    }
+
+    private void EnsureWeatherLocationRefreshService()
+    {
+        _weatherLocationRefreshService ??= new WeatherLocationRefreshService(
+            _settingsFacade,
+            _locationService,
+            _localizationService);
+    }
+
+    private void StartWeatherLocationRefreshIfNeeded()
+    {
+        EnsureWeatherLocationRefreshService();
+        if (_weatherLocationRefreshService is null)
+        {
+            return;
+        }
+
+        _ = Task.Run(async () =>
+        {
+            try
+            {
+                await _weatherLocationRefreshService.TryRefreshOnStartupAsync();
+            }
+            catch (Exception ex)
+            {
+                AppLogger.Warn("Weather.Location", "Failed to refresh weather location during startup.", ex);
+            }
+        });
+    }
+
+    private void ApplyThemeFromSettings()
+    {
+        var snapshot = _appearanceThemeService.GetCurrent();
+        RequestedThemeVariant = snapshot.IsNightMode
+            ? ThemeVariant.Dark
+            : ThemeVariant.Light;
+        ApplyAdaptiveThemeResources();
+    }
+
+    private void ApplyCurrentCultureFromSettings()
+    {
+        var snapshot = _settingsFacade.Settings.LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App);
+        var languageCode = _localizationService.NormalizeLanguageCode(snapshot.LanguageCode);
+
+        CultureInfo culture;
+        try
+        {
+            culture = CultureInfo.GetCultureInfo(languageCode);
+        }
+        catch (CultureNotFoundException)
+        {
+            culture = CultureInfo.GetCultureInfo("zh-CN");
+        }
+
+        CultureInfo.DefaultThreadCurrentCulture = culture;
+        CultureInfo.DefaultThreadCurrentUICulture = culture;
+        Thread.CurrentThread.CurrentCulture = culture;
+        Thread.CurrentThread.CurrentUICulture = culture;
+    }
+
     private void ActivateMainWindow()
+    {
+        RestoreOrCreateMainWindow(showSingleInstanceNotice: true, source: "SingleInstance");
+    }
+
+    private void RestoreOrCreateMainWindow(bool showSingleInstanceNotice, string source)
     {
         Dispatcher.UIThread.Post(() =>
         {
@@ -253,13 +396,11 @@ public partial class App : Application
                 return;
             }
 
-            if (desktop.MainWindow is not Window mainWindow)
-            {
-                return;
-            }
-
             try
             {
+                var mainWindow = GetOrCreateMainWindow(desktop, source);
+                mainWindow.ShowInTaskbar = true;
+
                 if (!mainWindow.IsVisible)
                 {
                     mainWindow.Show();
@@ -278,29 +419,165 @@ public partial class App : Application
                 mainWindow.Activate();
                 mainWindow.Topmost = true;
                 mainWindow.Topmost = false;
-                if (mainWindow is MainWindow lanMountainMainWindow)
+                SetDesktopShellState(DesktopShellState.ForegroundDesktop, $"Restore:{source}");
+                AppLogger.Info(
+                    "DesktopShell",
+                    $"Desktop restored. Source='{source}'; MainWindowClosed={_mainWindowClosed}; ShowSingleInstanceNotice={showSingleInstanceNotice}; WindowState='{mainWindow.WindowState}'.");
+
+                if (showSingleInstanceNotice)
                 {
-                    lanMountainMainWindow.ShowSingleInstanceNotice();
+                    mainWindow.ShowSingleInstanceNotice();
                 }
             }
             catch (Exception ex)
             {
-                AppLogger.Warn("SingleInstance", "Failed to activate the existing main window.", ex);
+                AppLogger.Warn("DesktopShell", $"Failed to restore desktop shell. Source='{source}'.", ex);
             }
         }, DispatcherPriority.Send);
     }
 
-    private void OnAppSettingsSaved(string _)
+    internal void PrepareForShutdown(bool isRestart, string source)
     {
+        void Mark()
+        {
+            _shutdownIntent = isRestart
+                ? ShutdownIntent.RestartRequested
+                : ShutdownIntent.ExitRequested;
+            AppLogger.Info(
+                "DesktopShell",
+                $"Shutdown intent marked. Intent='{_shutdownIntent}'; Source='{source}'; CurrentShellState='{_desktopShellState}'.");
+        }
+
+        if (Dispatcher.UIThread.CheckAccess())
+        {
+            Mark();
+            return;
+        }
+
+        Dispatcher.UIThread.InvokeAsync(Mark, DispatcherPriority.Send).GetAwaiter().GetResult();
+    }
+
+    internal void ResetShutdownIntent(string source)
+    {
+        void Reset()
+        {
+            if (_shutdownIntent == ShutdownIntent.None)
+            {
+                return;
+            }
+
+            AppLogger.Warn(
+                "DesktopShell",
+                $"Shutdown intent cleared without process exit. PreviousIntent='{_shutdownIntent}'; Source='{source}'.");
+            _shutdownIntent = ShutdownIntent.None;
+        }
+
+        if (Dispatcher.UIThread.CheckAccess())
+        {
+            Reset();
+            return;
+        }
+
+        Dispatcher.UIThread.InvokeAsync(Reset, DispatcherPriority.Send).GetAwaiter().GetResult();
+    }
+
+    private void OnSettingsChanged(object? sender, SettingsChangedEvent e)
+    {
+        _ = sender;
+
+        if (e.Scope != SettingsScope.App)
+        {
+            return;
+        }
+
         Dispatcher.UIThread.Post(() =>
         {
-            if (_trayIcons is not null)
+            var changedKeys = e.ChangedKeys?.ToArray();
+            var refreshAll = changedKeys is null || changedKeys.Length == 0;
+            var liveAppearance = _appearanceThemeService.GetCurrent();
+            var themeChanged =
+                refreshAll ||
+                changedKeys.Contains(nameof(AppSettingsSnapshot.IsNightMode), StringComparer.OrdinalIgnoreCase) ||
+                changedKeys.Contains(nameof(AppSettingsSnapshot.UseSystemChrome), StringComparer.OrdinalIgnoreCase) ||
+                changedKeys.Contains(nameof(AppSettingsSnapshot.GlobalCornerRadiusScale), StringComparer.OrdinalIgnoreCase) ||
+                (string.Equals(liveAppearance.ThemeColorMode, ThemeAppearanceValues.ColorModeSeedMonet, StringComparison.OrdinalIgnoreCase) &&
+                 changedKeys.Contains(nameof(AppSettingsSnapshot.ThemeColor), StringComparer.OrdinalIgnoreCase)) ||
+                (string.Equals(liveAppearance.ThemeColorMode, ThemeAppearanceValues.ColorModeWallpaperMonet, StringComparison.OrdinalIgnoreCase) &&
+                 (changedKeys.Contains(nameof(AppSettingsSnapshot.WallpaperPath), StringComparer.OrdinalIgnoreCase) ||
+                  changedKeys.Contains(nameof(AppSettingsSnapshot.WallpaperType), StringComparer.OrdinalIgnoreCase) ||
+                  changedKeys.Contains(nameof(AppSettingsSnapshot.WallpaperColor), StringComparer.OrdinalIgnoreCase)));
+            var languageChanged =
+                refreshAll ||
+                changedKeys.Contains(nameof(AppSettingsSnapshot.LanguageCode), StringComparer.OrdinalIgnoreCase);
+
+            if (themeChanged)
             {
-                InitializeTrayIcon();
+                ApplyThemeFromSettings();
+            }
+
+            if (languageChanged)
+            {
+                // 清除本地化缓存，强制重新加载语言文件
+                _localizationService.ClearCache();
+                ApplyCurrentCultureFromSettings();
+                if (_trayIcons is not null)
+                {
+                    InitializeTrayIcon();
+                }
             }
         }, DispatcherPriority.Background);
     }
 
+    private void OnAppearanceThemeChanged(object? sender, AppearanceThemeSnapshot e)
+    {
+        _ = sender;
+        _ = e;
+
+        Dispatcher.UIThread.Post(ApplyThemeFromSettings, DispatcherPriority.Background);
+    }
+
+    private void ApplyAdaptiveThemeResources()
+    {
+        _appearanceThemeService.ApplyThemeResources(Resources);
+    }
+
+    private void RegisterUiUnhandledExceptionGuard()
+    {
+        if (_uiUnhandledExceptionHooked)
+        {
+            return;
+        }
+
+        Dispatcher.UIThread.UnhandledException += OnUiThreadUnhandledException;
+        _uiUnhandledExceptionHooked = true;
+    }
+
+    private void OnUiThreadUnhandledException(object? sender, DispatcherUnhandledExceptionEventArgs e)
+    {
+        if (!IsKnownWebViewStartupException(e.Exception))
+        {
+            return;
+        }
+
+        e.Handled = true;
+        AppLogger.Warn(
+            "WebView2",
+            "Suppressed a known WebView startup exception from AvaloniaWebView.Navigate to keep the host process alive.",
+            e.Exception);
+    }
+
+    private static bool IsKnownWebViewStartupException(Exception exception)
+    {
+        if (exception is not NullReferenceException)
+        {
+            return false;
+        }
+
+        var stackTrace = exception.StackTrace ?? string.Empty;
+        return stackTrace.Contains("AvaloniaWebView.WebView.Navigate", StringComparison.Ordinal) &&
+               stackTrace.Contains("AvaloniaWebView.WebView.OnAttachedToVisualTree", StringComparison.Ordinal);
+    }
+
     private void PerformExitCleanup()
     {
         if (_exitCleanupCompleted)
@@ -309,19 +586,27 @@ public partial class App : Application
         }
 
         _exitCleanupCompleted = true;
-        AppSettingsService.SettingsSaved -= OnAppSettingsSaved;
+        _settingsFacade.Settings.Changed -= OnSettingsChanged;
+        _appearanceThemeService.Changed -= OnAppearanceThemeChanged;
 
         try
         {
-            _traySettingsWindow?.Close();
+            var (analytics, crashReport) = App.AnalyticsServices;
+            analytics?.SendShutdownEvent();
+            crashReport?.SendShutdownEvent();
         }
         catch (Exception ex)
         {
-            AppLogger.Warn("App", "Failed to close tray-opened settings window during shutdown.", ex);
+            AppLogger.Warn("Analytics", "Failed to send shutdown events during exit cleanup.", ex);
         }
-        finally
+
+        try
         {
-            _traySettingsWindow = null;
+            HostUpdateWorkflowServiceProvider.GetOrCreate().TryApplyPendingUpdateOnExit();
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("UpdateWorkflow", "Failed to apply pending update during exit cleanup.", ex);
         }
 
         try
@@ -337,11 +622,182 @@ public partial class App : Application
             _pluginRuntimeService = null;
         }
 
+        _settingsWindowService?.Close();
+        if (_settingsPageRegistry is IDisposable disposableRegistry)
+        {
+            disposableRegistry.Dispose();
+        }
+
         AudioRecorderServiceFactory.DisposeSharedServices();
         StudyAnalyticsServiceFactory.DisposeSharedService();
         DisposeTrayIcon();
     }
 
+    private MainWindow CreateAndAssignMainWindow(
+        IClassicDesktopStyleApplicationLifetime desktop,
+        string reason)
+    {
+        var mainWindow = new MainWindow
+        {
+            DataContext = new MainWindowViewModel(),
+            ShowInTaskbar = true
+        };
+
+        AttachMainWindow(mainWindow);
+        desktop.MainWindow = mainWindow;
+        AppLogger.Info("App", $"Main window created. Reason='{reason}'. LogFile={AppLogger.LogFilePath}");
+        LogBrowserStartupDiagnostics();
+        SetDesktopShellState(DesktopShellState.ForegroundDesktop, $"MainWindowCreated:{reason}");
+        return mainWindow;
+    }
+
+    private MainWindow GetOrCreateMainWindow(
+        IClassicDesktopStyleApplicationLifetime desktop,
+        string reason)
+    {
+        if (_mainWindow is not null && !_mainWindowClosed)
+        {
+            return _mainWindow;
+        }
+
+        if (desktop.MainWindow is MainWindow desktopMainWindow && !_mainWindowClosed)
+        {
+            AttachMainWindow(desktopMainWindow);
+            return desktopMainWindow;
+        }
+
+        return CreateAndAssignMainWindow(desktop, reason);
+    }
+
+    private void AttachMainWindow(MainWindow mainWindow)
+    {
+        if (ReferenceEquals(_mainWindow, mainWindow))
+        {
+            _mainWindowClosed = false;
+            return;
+        }
+
+        if (_mainWindow is not null)
+        {
+            _mainWindow.Closing -= OnMainWindowClosing;
+            _mainWindow.Closed -= OnMainWindowClosed;
+            _mainWindow.PropertyChanged -= OnMainWindowPropertyChanged;
+        }
+
+        _mainWindow = mainWindow;
+        _mainWindowClosed = false;
+        mainWindow.Closing += OnMainWindowClosing;
+        mainWindow.Closed += OnMainWindowClosed;
+        mainWindow.PropertyChanged += OnMainWindowPropertyChanged;
+    }
+
+    private void OnMainWindowClosing(object? sender, WindowClosingEventArgs e)
+    {
+        if (sender is not MainWindow mainWindow)
+        {
+            return;
+        }
+
+        AppLogger.Info(
+            "DesktopShell",
+            $"Main window closing requested. Intent='{_shutdownIntent}'; ShellState='{_desktopShellState}'; WindowState='{mainWindow.WindowState}'; IsVisible={mainWindow.IsVisible}.");
+
+        if (_shutdownIntent is ShutdownIntent.ExitRequested or ShutdownIntent.RestartRequested)
+        {
+            AppLogger.Info(
+                "DesktopShell",
+                $"Main window close allowed. Intent='{_shutdownIntent}'; ShellState='{_desktopShellState}'.");
+            return;
+        }
+
+        e.Cancel = true;
+        HideMainWindowToTray(mainWindow, "MainWindowClosing");
+    }
+
+    private void OnMainWindowClosed(object? sender, EventArgs e)
+    {
+        if (sender is not MainWindow mainWindow)
+        {
+            return;
+        }
+
+        mainWindow.Closing -= OnMainWindowClosing;
+        mainWindow.Closed -= OnMainWindowClosed;
+        mainWindow.PropertyChanged -= OnMainWindowPropertyChanged;
+
+        if (ReferenceEquals(_mainWindow, mainWindow))
+        {
+            _mainWindow = null;
+        }
+
+        _mainWindowClosed = true;
+        AppLogger.Info(
+            "DesktopShell",
+            $"Main window closed. Intent='{_shutdownIntent}'; ShellState='{_desktopShellState}'.");
+
+        if (_shutdownIntent == ShutdownIntent.None)
+        {
+            SetDesktopShellState(DesktopShellState.TrayOnly, "MainWindowClosedUnexpected");
+        }
+    }
+
+    private void OnMainWindowPropertyChanged(object? sender, AvaloniaPropertyChangedEventArgs e)
+    {
+        if (sender is not MainWindow mainWindow)
+        {
+            return;
+        }
+
+        if (e.Property != Window.WindowStateProperty)
+        {
+            return;
+        }
+
+        if (_shutdownIntent != ShutdownIntent.None || !mainWindow.IsVisible)
+        {
+            return;
+        }
+
+        if (mainWindow.WindowState == WindowState.Minimized)
+        {
+            SetDesktopShellState(DesktopShellState.MinimizedToTaskbar, "MainWindowMinimized");
+            return;
+        }
+
+        SetDesktopShellState(DesktopShellState.ForegroundDesktop, "MainWindowRestored");
+    }
+
+    private void HideMainWindowToTray(MainWindow mainWindow, string source)
+    {
+        try
+        {
+            mainWindow.ShowInTaskbar = false;
+            mainWindow.Hide();
+            SetDesktopShellState(DesktopShellState.TrayOnly, source);
+            AppLogger.Info(
+                "DesktopShell",
+                $"Main window hidden to tray. Source='{source}'; WindowState='{mainWindow.WindowState}'.");
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("DesktopShell", $"Failed to hide main window to tray. Source='{source}'.", ex);
+        }
+    }
+
+    private void SetDesktopShellState(DesktopShellState state, string source)
+    {
+        if (_desktopShellState == state)
+        {
+            return;
+        }
+
+        var previous = _desktopShellState;
+        _desktopShellState = state;
+        AppLogger.Info(
+            "DesktopShell",
+            $"Shell state changed. Previous='{previous}'; Current='{state}'; Source='{source}'.");
+    }
+
     private void LogBrowserStartupDiagnostics()
     {
         try
@@ -372,7 +828,7 @@ public partial class App : Application
 
     private string L(string key, string fallback)
     {
-        var snapshot = _appSettingsService.Load();
+        var snapshot = _settingsFacade.Settings.LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App);
         var languageCode = _localizationService.NormalizeLanguageCode(snapshot.LanguageCode);
         return _localizationService.GetString(languageCode, key, fallback);
     }

LanMountainDesktop/Assets/Documents/Privacy.md

@@ -0,0 +1,326 @@
+# LanMountainDesktop 隐私政策
+
+**最后更新日期：2026年3月17日**
+
+---
+
+## 引言
+
+欢迎使用 LanMountainDesktop！我们非常重视您的隐私保护。本隐私政策旨在向您说明我们如何收集、使用、存储和保护您的数据。
+
+**请在使用本应用前仔细阅读本隐私政策。使用本应用即表示您同意本政策的条款。**
+
+---
+
+## 1. 数据收集范围
+
+### 1.1 我们收集的数据
+
+当您启用匿名数据收集功能时，我们会收集以下数据：
+
+#### 匿名崩溃数据
+- **崩溃报告**：应用崩溃时的错误日志和堆栈跟踪
+- **设备信息**：操作系统版本、设备型号、架构（x64/x86）
+- **应用版本**：当前使用的应用版本号
+- **设备标识符**：匿名生成的唯一设备ID（不包含个人信息）
+
+#### 匿名使用数据
+- **应用启动和关闭事件**：记录应用何时启动和关闭
+- **功能使用统计**：哪些功能被使用、使用频率
+- **设置变更**：用户更改了哪些设置（不包含具体设置值）
+- **界面交互**：点击了哪些按钮、访问了哪些页面
+- **设备信息**：操作系统、应用版本、设备类型
+
+### 1.2 始终收集的基础数据
+
+**重要说明：** 为了统计应用的用户数量和日活跃用户，即使您关闭了匿名数据收集开关，我们仍会收集以下基础数据：
+
+- ✅ **应用启动事件**：用于统计日活跃用户
+- ✅ **设备标识符**：用于区分不同用户（不包含个人信息）
+- ✅ **应用版本**：用于统计版本分布
+
+**这些基础数据不包含任何个人身份信息，仅用于统计用户数量和应用使用情况。**
+
+### 1.3 我们不收集的数据
+
+我们**明确承诺不收集**以下数据：
+
+- ❌ 个人身份信息（姓名、邮箱、电话等）
+- ❌ 真实姓名或用户名
+- ❌ 地理位置信息（精确位置）
+- ❌ 文件内容或文档数据
+- ❌ 密码或凭据信息
+- ❌ 网络浏览历史
+- ❌ 联系人信息
+- ❌ 照片、视频或音频文件
+
+---
+
+## 2. 数据收集目的
+
+我们收集数据的目的如下：
+
+### 2.1 基础数据用途（始终收集）
+- **统计用户数量**：了解应用的用户规模
+- **统计日活跃用户**：了解应用的活跃程度
+- **版本分布统计**：了解用户使用的版本情况
+
+### 2.2 崩溃数据用途
+- **提高应用稳定性**：识别和修复崩溃问题
+- **优化性能**：分析性能瓶颈
+- **改进用户体验**：了解应用在不同设备上的表现
+
+### 2.3 使用数据用途
+- **功能优化**：了解哪些功能最受欢迎，优先改进
+- **用户体验改进**：优化界面设计和交互流程
+- **统计分析**：了解用户规模和使用趋势
+- **产品决策**：基于数据做出产品发展方向决策
+
+---
+
+## 3. 数据存储和处理
+
+### 3.1 数据存储位置
+
+我们使用以下第三方服务存储和处理数据：
+
+#### Sentry（崩溃报告）
+- **用途**：崩溃数据收集和分析
+- **位置**：美国
+- **官网**：https://sentry.io
+- **隐私政策**：https://sentry.io/privacy/
+
+#### PostHog（使用分析）
+- **用途**：用户行为分析和统计
+- **位置**：美国
+- **官网**：https://posthog.com
+- **隐私政策**：https://posthog.com/privacy
+
+### 3.2 数据保留期限
+
+- **崩溃数据**：保留90天后自动删除
+- **使用数据**：保留12个月后自动删除
+- **设备标识符**：永久保留（用于统计日活用户）
+
+### 3.3 数据安全措施
+
+我们采取以下安全措施保护您的数据：
+
+- ✅ 数据传输使用HTTPS加密
+- ✅ 数据存储使用加密技术
+- ✅ 访问权限严格控制
+- ✅ 定期安全审计
+
+---
+
+## 4. 数据共享
+
+### 4.1 我们不会出售您的数据
+
+我们**明确承诺**：
+- ❌ 不会出售您的个人数据
+- ❌ 不会将您的数据用于广告目的
+- ❌ 不会与第三方共享可识别个人的数据
+
+### 4.2 必要的共享
+
+我们仅在以下情况下共享数据：
+
+- **服务提供商**：与Sentry和PostHog共享数据以提供服务
+- **法律要求**：在法律要求或政府机构合法要求时
+
+---
+
+## 5. 您的权利
+
+### 5.1 选择权
+
+您完全控制详细数据收集：
+
+- **匿名崩溃数据**：可在设置中开启或关闭
+- **匿名使用数据**：可在设置中开启或关闭
+- **基础数据**：始终收集（用于统计用户数量）
+
+**注意：** 即使关闭所有开关，我们仍会收集基础数据（应用启动事件和设备标识符）以统计用户数量。
+
+### 5.2 数据访问权
+
+您可以：
+- 查看我们收集的数据类型
+- 了解数据的使用目的
+- 了解数据的存储位置
+
+### 5.3 数据删除权
+
+您可以：
+- 随时关闭详细数据收集功能
+- 删除本地存储的设备标识符
+- 联系我们删除已收集的数据
+
+---
+
+## 6. 设备标识符
+
+### 6.1 什么是设备标识符？
+
+设备标识符是一个随机生成的唯一字符串，用于：
+- 统计日活用户数量
+- 区分不同设备
+- 分析用户使用趋势
+
+### 6.2 设备标识符的特点
+
+- **匿名性**：不包含任何个人信息
+- **随机性**：通过SHA256算法生成
+- **唯一性**：每个设备有唯一标识符
+- **持久性**：即使刷新设备ID，仍能关联到同一用户
+- **可重置**：您可以在设置中刷新设备标识符
+
+### 6.3 设备标识符刷新
+
+当您刷新设备标识符时：
+- 生成新的设备ID
+- **持久用户ID保持不变**，确保仍能关联到同一用户
+- 统计数据不会丢失
+
+### 6.4 设备标识符示例
+
+```
+a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
+```
+
+---
+
+## 7. 儿童隐私保护
+
+本应用不面向13岁以下儿童。我们不会故意收集儿童的个人信息。如果您发现我们无意中收集了儿童的数据，请联系我们，我们将立即删除相关数据。
+
+---
+
+## 8. 国际数据传输
+
+由于我们的服务提供商位于美国，您的数据可能会被传输到美国。我们确保：
+
+- 数据传输符合相关法律法规
+- 服务提供商遵守GDPR等隐私法规
+- 采取适当的安全措施保护数据
+
+---
+
+## 9. 隐私政策更新
+
+我们可能会不时更新本隐私政策。更新时，我们将：
+
+- 在本页面更新"最后更新日期"
+- 在应用内通知您重大变更
+- 继续使用应用即表示您同意更新后的政策
+
+---
+
+## 10. 联系我们
+
+如果您对本隐私政策有任何疑问或建议，请通过以下方式联系我们：
+
+- **GitHub Issues**：https://github.com/wwiinnddyy/LanMountainDesktop/issues
+- **电子邮件**：[您的邮箱地址]
+
+---
+
+## 11. 法律依据
+
+### 11.1 GDPR合规
+
+如果您位于欧洲经济区（EEA），我们的数据处理基于：
+
+- **同意**：您明确同意数据收集
+- **合法利益**：改进应用性能和用户体验
+
+### 11.2 CCPA合规
+
+如果您是加州居民，您有权：
+
+- 知道我们收集了哪些数据
+- 要求删除您的数据
+- 选择退出数据销售（我们不销售数据）
+
+---
+
+## 12. 第三方链接
+
+本应用可能包含第三方网站链接。我们不对这些网站的隐私政策负责。请阅读这些网站的隐私政策。
+
+---
+
+## 13. 数据收集示例
+
+### 13.1 崩溃报告示例
+
+```json
+{
+  "event_id": "abc123",
+  "timestamp": "2024-01-01T12:00:00Z",
+  "device_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
+  "app_version": "1.0.0",
+  "os_name": "Windows",
+  "os_version": "10.0.19041",
+  "error_message": "NullReferenceException",
+  "stack_trace": "..."
+}
+```
+
+### 13.2 使用数据示例
+
+```json
+{
+  "event": "app_online",
+  "timestamp": "2024-01-01T12:00:00Z",
+  "distinct_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
+  "properties": {
+    "app_version": "1.0.0",
+    "os_name": "Windows",
+    "event_type": "app_start",
+    "analytics_enabled": true
+  }
+}
+```
+
+### 13.3 基础数据示例（始终收集）
+
+```json
+{
+  "event": "$pageview",
+  "timestamp": "2024-01-01T12:00:00Z",
+  "distinct_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
+  "properties": {
+    "$current_url": "app://main",
+    "$title": "LanMountainDesktop"
+  }
+}
+```
+
+---
+
+## 14. 您的同意
+
+使用本应用即表示您：
+
+- ✅ 已阅读并理解本隐私政策
+- ✅ 同意我们按照本政策收集和使用数据
+- ✅ 了解您可以随时撤回同意（详细数据收集）
+- ✅ 了解基础数据将始终收集以统计用户数量
+
+---
+
+## 15. 免责声明
+
+本隐私政策仅适用于 LanMountainDesktop 应用。我们不对以下情况负责：
+
+- 第三方服务的隐私政策
+- 您自行分享的数据
+- 不可抗力导致的数据泄露
+
+---
+
+**感谢您信任阑山桌面LanMountainDesktop！**
+
+我们承诺保护您的隐私，并持续改进我们的隐私保护措施。

LanMountainDesktop/Assets/logo_nightly.svg

@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="375" height="374.999991" viewBox="0 0 375 374.999991">
+<defs>
+<clipPath id="clip-0">
+<path clip-rule="nonzero" d="M 196.875 178.398438 L 285.058594 178.398438 L 285.058594 266.582031 L 196.875 266.582031 Z M 196.875 178.398438 "/>
+</clipPath>
+<clipPath id="clip-1">
+<path clip-rule="nonzero" d="M 240.96875 178.398438 C 216.617188 178.398438 196.875 198.140625 196.875 222.492188 C 196.875 246.839844 216.617188 266.582031 240.96875 266.582031 C 265.320312 266.582031 285.058594 246.839844 285.058594 222.492188 C 285.058594 198.140625 265.320312 178.398438 240.96875 178.398438 Z M 240.96875 178.398438 "/>
+</clipPath>
+<clipPath id="clip-2">
+<path clip-rule="nonzero" d="M 0.875 0.398438 L 89.058594 0.398438 L 89.058594 88.582031 L 0.875 88.582031 Z M 0.875 0.398438 "/>
+</clipPath>
+<clipPath id="clip-3">
+<path clip-rule="nonzero" d="M 44.96875 0.398438 C 20.617188 0.398438 0.875 20.140625 0.875 44.492188 C 0.875 68.839844 20.617188 88.582031 44.96875 88.582031 C 69.320312 88.582031 89.058594 68.839844 89.058594 44.492188 C 89.058594 20.140625 69.320312 0.398438 44.96875 0.398438 Z M 44.96875 0.398438 "/>
+</clipPath>
+<clipPath id="clip-4">
+<rect x="0" y="0" width="90" height="89"/>
+</clipPath>
+<g id="source-5" clip-path="url(#clip-4)">
+<g clip-path="url(#clip-2)">
+<g clip-path="url(#clip-3)">
+<path fill-rule="nonzero" fill="rgb(100%, 100%, 100%)" fill-opacity="1" d="M 0.875 0.398438 L 89.058594 0.398438 L 89.058594 88.582031 L 0.875 88.582031 Z M 0.875 0.398438 "/>
+</g>
+</g>
+</g>
+</defs>
+<rect x="-37.5" y="-37.499999" width="450" height="449.999989" fill="rgb(100%, 100%, 100%)" fill-opacity="1"/>
+<rect x="-37.5" y="-37.499999" width="450" height="449.999989" fill="rgb(0%, 0%, 0%)" fill-opacity="1"/>
+<path fill="none" stroke-width="21" stroke-linecap="butt" stroke-linejoin="miter" stroke="rgb(100%, 100%, 100%)" stroke-opacity="1" stroke-miterlimit="4" d="M 0.00219613 10.500482 L 127.627201 10.500482 " transform="matrix(0.75, 0, 0, 0.75, 93.623353, 248.98792)"/>
+<path fill="none" stroke-width="21" stroke-linecap="butt" stroke-linejoin="miter" stroke="rgb(100%, 100%, 100%)" stroke-opacity="1" stroke-miterlimit="4" d="M 0.00244625 10.500708 L 127.622243 10.500708 " transform="matrix(0.75, 0, 0, 0.75, 189.341915, 110.327595)"/>
+<path fill="none" stroke-width="21" stroke-linecap="butt" stroke-linejoin="miter" stroke="rgb(100%, 100%, 100%)" stroke-opacity="1" stroke-miterlimit="4" d="M 10.492181 33.974247 C 11.537452 2.677252 36.02023 2.673354 83.94005 33.972962 " transform="matrix(-0.0333864, -0.749256, 0.749256, -0.0333864, 70.972996, 265.851083)"/>
+<path fill="none" stroke-width="21" stroke-linecap="butt" stroke-linejoin="miter" stroke="rgb(100%, 100%, 100%)" stroke-opacity="1" stroke-miterlimit="4" d="M 10.498903 37.532093 C 10.670763 1.489257 37.447477 1.488034 90.82363 37.533419 " transform="matrix(0.0300175, 0.749399, -0.749399, 0.0300175, 310.455894, 109.212543)"/>
+<g clip-path="url(#clip-0)">
+<g clip-path="url(#clip-1)">
+<use xlink:href="#source-5" transform="matrix(1, 0, 0, 1, 196, 178)"/>
+</g>
+</g>
+</svg>

LanMountainDesktop/Assets/logo_nightly_render.html

@@ -0,0 +1,31 @@
+<!doctype html>
+<html>
+<head>
+<meta charset="utf-8" />
+<style>
+html, body {
+  margin: 0;
+  width: 100%;
+  height: 100%;
+  overflow: hidden;
+  background: #000;
+}
+.stage {
+  width: 512px;
+  height: 512px;
+  background: #000;
+}
+.stage img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  display: block;
+}
+</style>
+</head>
+<body>
+  <div class="stage">
+    <img src="./logo_nightly.svg" alt="logo" />
+  </div>
+</body>
+</html>

LanMountainDesktop/ComponentSystem/BuiltInComponentIds.cs

@@ -1,4 +1,4 @@
-namespace LanMountainDesktop.ComponentSystem;
+namespace LanMountainDesktop.ComponentSystem;
 
 public static class BuiltInComponentIds
 {
@@ -40,4 +40,6 @@ public static class BuiltInComponentIds
     public const string DesktopWhiteboard = "DesktopWhiteboard";
     public const string DesktopBlackboardLandscape = "DesktopBlackboardLandscape";
     public const string DesktopBrowser = "DesktopBrowser";
+    public const string DesktopOfficeRecentDocuments = "DesktopOfficeRecentDocuments";
+    public const string DesktopRemovableStorage = "DesktopRemovableStorage";
 }

LanMountainDesktop/ComponentSystem/ComponentColorSchemeHelper.cs

@@ -0,0 +1,37 @@
+using System;
+using LanMountainDesktop.Services;
+using LanMountainDesktop.Views;
+
+namespace LanMountainDesktop.ComponentSystem;
+
+public static class ComponentColorSchemeHelper
+{
+    public static bool ShouldUseMonetColor(string? componentColorScheme, string globalThemeColorMode)
+    {
+        if (string.Equals(componentColorScheme, ThemeAppearanceValues.ColorSchemeNative, StringComparison.OrdinalIgnoreCase))
+        {
+            return false;
+        }
+
+        if (string.Equals(componentColorScheme, ThemeAppearanceValues.ColorSchemeFollowSystem, StringComparison.OrdinalIgnoreCase))
+        {
+            return true;
+        }
+
+        return !string.Equals(globalThemeColorMode, ThemeAppearanceValues.ColorModeDefaultNeutral, StringComparison.OrdinalIgnoreCase);
+    }
+
+    public static string GetCurrentGlobalThemeColorMode()
+    {
+        try
+        {
+            var service = HostAppearanceThemeProvider.GetOrCreate();
+            var appearance = service.GetCurrent();
+            return appearance?.ThemeColorMode ?? ThemeAppearanceValues.ColorModeDefaultNeutral;
+        }
+        catch
+        {
+            return ThemeAppearanceValues.ColorModeDefaultNeutral;
+        }
+    }
+}

LanMountainDesktop/ComponentSystem/ComponentRegistry.cs

@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using LanMountainDesktop.ComponentSystem.Extensions;
@@ -327,6 +327,24 @@ public sealed class ComponentRegistry
                 AllowStatusBarPlacement: false,
                 AllowDesktopPlacement: true,
                 ResizeMode: DesktopComponentResizeMode.Free),
+            new DesktopComponentDefinition(
+                BuiltInComponentIds.DesktopOfficeRecentDocuments,
+                "Office Recent Documents",
+                "Folder",
+                "File",
+                MinWidthCells: 4,
+                MinHeightCells: 2,
+                AllowStatusBarPlacement: false,
+                AllowDesktopPlacement: true),
+            new DesktopComponentDefinition(
+                BuiltInComponentIds.DesktopRemovableStorage,
+                "Removable Storage",
+                "Storage",
+                "File",
+                MinWidthCells: 2,
+                MinHeightCells: 2,
+                AllowStatusBarPlacement: false,
+                AllowDesktopPlacement: true),
             new DesktopComponentDefinition(
                 BuiltInComponentIds.Date,
                 "Calendar",

LanMountainDesktop/ComponentSystem/DesktopComponentEditorRegistry.cs

@@ -0,0 +1,159 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using Avalonia.Controls;
+using LanMountainDesktop.PluginSdk;
+using LanMountainDesktop.Services;
+using LanMountainDesktop.Services.Settings;
+
+namespace LanMountainDesktop.ComponentSystem;
+
+public sealed record DesktopComponentEditorContext(
+    DesktopComponentDefinition Definition,
+    string ComponentId,
+    string? PlacementId,
+    ISettingsFacadeService SettingsFacade,
+    ISettingsService SettingsService,
+    IComponentSettingsAccessor ComponentSettingsAccessor,
+    IComponentInstanceSettingsStore ComponentSettingsStore,
+    IComponentEditorHostContext HostContext);
+
+public sealed class DesktopComponentEditorRegistration
+{
+    public DesktopComponentEditorRegistration(
+        string componentId,
+        Func<DesktopComponentEditorContext, 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 string ComponentId { get; }
+
+    public Func<DesktopComponentEditorContext, Control> EditorFactory { get; }
+
+    public double PreferredWidth { get; }
+
+    public double PreferredHeight { get; }
+
+    public double MinScale { get; }
+
+    public double MaxScale { get; }
+
+    public double AspectRatio { get; }
+}
+
+public sealed class DesktopComponentEditorDescriptor
+{
+    internal DesktopComponentEditorDescriptor(
+        DesktopComponentDefinition definition,
+        Func<DesktopComponentEditorContext, Control> editorFactory,
+        double preferredWidth,
+        double preferredHeight,
+        double minScale,
+        double maxScale,
+        double aspectRatio)
+    {
+        Definition = definition;
+        _editorFactory = editorFactory;
+        PreferredWidth = preferredWidth;
+        PreferredHeight = preferredHeight;
+        MinScale = minScale;
+        MaxScale = maxScale;
+        AspectRatio = aspectRatio;
+    }
+
+    private readonly Func<DesktopComponentEditorContext, Control> _editorFactory;
+
+    public DesktopComponentDefinition Definition { get; }
+
+    public double PreferredWidth { get; }
+
+    public double PreferredHeight { get; }
+
+    public double MinScale { get; }
+
+    public double MaxScale { get; }
+
+    public double AspectRatio { get; }
+
+    public Control CreateEditor(DesktopComponentEditorContext context)
+    {
+        return _editorFactory(context);
+    }
+}
+
+public sealed class DesktopComponentEditorRegistry
+{
+    private readonly Dictionary<string, DesktopComponentEditorDescriptor> _descriptors;
+
+    public DesktopComponentEditorRegistry(
+        ComponentRegistry componentRegistry,
+        IEnumerable<DesktopComponentEditorRegistration> registrations)
+    {
+        ArgumentNullException.ThrowIfNull(componentRegistry);
+        ArgumentNullException.ThrowIfNull(registrations);
+
+        _descriptors = new Dictionary<string, DesktopComponentEditorDescriptor>(StringComparer.OrdinalIgnoreCase);
+
+        foreach (var registration in registrations)
+        {
+            if (!componentRegistry.TryGetDefinition(registration.ComponentId, out var definition))
+            {
+                continue;
+            }
+
+            _descriptors[registration.ComponentId] = new DesktopComponentEditorDescriptor(
+                definition,
+                registration.EditorFactory,
+                registration.PreferredWidth,
+                registration.PreferredHeight,
+                registration.MinScale,
+                registration.MaxScale,
+                registration.AspectRatio);
+        }
+    }
+
+    public bool TryGetDescriptor(string componentId, out DesktopComponentEditorDescriptor descriptor)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(componentId);
+        return _descriptors.TryGetValue(componentId.Trim(), out descriptor!);
+    }
+
+    public IReadOnlyList<DesktopComponentEditorDescriptor> GetAll()
+    {
+        return _descriptors.Values.ToList();
+    }
+}

LanMountainDesktop/ComponentSystem/DesktopComponentRuntimeContext.cs

@@ -1,8 +1,16 @@
+using LanMountainDesktop.Host.Abstractions;
+using LanMountainDesktop.PluginSdk;
 using LanMountainDesktop.Services;
+using LanMountainDesktop.Services.Settings;
 
 namespace LanMountainDesktop.ComponentSystem;
 
 public sealed record DesktopComponentRuntimeContext(
     string ComponentId,
     string? PlacementId,
+    ISettingsFacadeService SettingsFacade,
+    ISettingsService SettingsService,
+    IAppearanceThemeService AppearanceTheme,
+    ComponentChromeContext Chrome,
+    IComponentSettingsAccessor ComponentSettingsAccessor,
     IComponentInstanceSettingsStore ComponentSettingsStore);

LanMountainDesktop/ComponentSystem/IComponentChromeContextAware.cs

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

LanMountainDesktop/ComponentSystem/IComponentSettingsContextAware.cs

@@ -0,0 +1,19 @@
+using LanMountainDesktop.PluginSdk;
+using LanMountainDesktop.Services;
+using LanMountainDesktop.Services.Settings;
+
+namespace LanMountainDesktop.ComponentSystem;
+
+public sealed record DesktopComponentSettingsContext(
+    string ComponentId,
+    string? PlacementId,
+    ISettingsFacadeService SettingsFacade,
+    ISettingsService SettingsService,
+    IAppearanceThemeService AppearanceTheme,
+    IComponentSettingsAccessor ComponentSettingsAccessor,
+    IComponentInstanceSettingsStore ComponentSettingsStore);
+
+public interface IComponentSettingsContextAware
+{
+    void SetComponentSettingsContext(DesktopComponentSettingsContext context);
+}

LanMountainDesktop/ComponentSystem/IComponentSettingsStoreAware.cs

@@ -1,8 +0,0 @@
-using LanMountainDesktop.Services;
-
-namespace LanMountainDesktop.ComponentSystem;
-
-public interface IComponentSettingsStoreAware
-{
-    void SetComponentSettingsStore(IComponentInstanceSettingsStore settingsStore);
-}

LanMountainDesktop/Controls/IconText.axaml

@@ -0,0 +1,19 @@
+<UserControl xmlns="https://github.com/avaloniaui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+             xmlns:fi="using:FluentIcons.Avalonia"
+             x:Class="LanMountainDesktop.Controls.IconText">
+
+    <StackPanel Orientation="Horizontal"
+                Spacing="8"
+                VerticalAlignment="Center">
+        <fi:FluentIcon x:Name="IconElement"
+                       Foreground="{DynamicResource AdaptiveTextPrimaryBrush}"
+                       FontSize="14"
+                       VerticalAlignment="Center" />
+        <TextBlock x:Name="TextElement"
+                   Foreground="{DynamicResource AdaptiveTextPrimaryBrush}"
+                   FontSize="14"
+                   FontWeight="SemiBold"
+                   VerticalAlignment="Center" />
+    </StackPanel>
+</UserControl>

LanMountainDesktop/Controls/IconText.axaml.cs

@@ -0,0 +1,52 @@
+using Avalonia;
+using Avalonia.Controls;
+using FluentIcons.Avalonia;
+using FluentIcons.Common;
+
+namespace LanMountainDesktop.Controls;
+
+public partial class IconText : UserControl
+{
+    public static readonly StyledProperty<Icon> IconProperty =
+        AvaloniaProperty.Register<IconText, Icon>(nameof(Icon), Icon.Info);
+
+    public static readonly StyledProperty<string> TextProperty =
+        AvaloniaProperty.Register<IconText, string>(nameof(Text), string.Empty);
+
+    public IconText()
+    {
+        InitializeComponent();
+    }
+
+    public Icon Icon
+    {
+        get => GetValue(IconProperty);
+        set => SetValue(IconProperty, value);
+    }
+
+    public string Text
+    {
+        get => GetValue(TextProperty);
+        set => SetValue(TextProperty, value);
+    }
+
+    protected override void OnPropertyChanged(AvaloniaPropertyChangedEventArgs change)
+    {
+        base.OnPropertyChanged(change);
+
+        if (change.Property == IconProperty)
+        {
+            if (IconElement is not null)
+            {
+                IconElement.Icon = change.GetNewValue<Icon>();
+            }
+        }
+        else if (change.Property == TextProperty)
+        {
+            if (TextElement is not null)
+            {
+                TextElement.Text = change.GetNewValue<string?>();
+            }
+        }
+    }
+}

LanMountainDesktop/Controls/SettingsOptionCard.axaml

@@ -0,0 +1,37 @@
+<UserControl xmlns="https://github.com/avaloniaui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+             xmlns:local="using:LanMountainDesktop.Controls"
+             xmlns:fi="using:FluentIcons.Avalonia"
+             x:Class="LanMountainDesktop.Controls.SettingsOptionCard"
+             x:Name="Root">
+    <Border Classes="settings-option-card">
+        <Grid RowDefinitions="Auto,Auto"
+              RowSpacing="12">
+            <Grid ColumnDefinitions="Auto,*,Auto"
+                  ColumnSpacing="14">
+                <Border x:Name="IconHost"
+                        Classes="settings-option-card-icon-host">
+                    <fi:SymbolIcon x:Name="CardIcon"
+                                   Classes="icon-m" />
+                </Border>
+
+                <StackPanel Grid.Column="1"
+                            Spacing="4"
+                            VerticalAlignment="Center">
+                    <TextBlock x:Name="TitleTextBlock"
+                               Classes="settings-item-label" />
+                    <TextBlock x:Name="DescriptionTextBlock"
+                               Classes="settings-item-description" />
+                </StackPanel>
+
+                <ContentPresenter x:Name="ActionContentHost"
+                                  Grid.Column="2"
+                                  VerticalAlignment="Center" />
+            </Grid>
+
+            <ContentPresenter x:Name="DetailsContentHost"
+                              Grid.Row="1"
+                              Margin="54,0,0,0" />
+        </Grid>
+    </Border>
+</UserControl>

LanMountainDesktop/Controls/SettingsOptionCard.axaml.cs

@@ -0,0 +1,113 @@
+using Avalonia;
+using Avalonia.Controls;
+using FluentIcons.Common;
+
+namespace LanMountainDesktop.Controls;
+
+public partial class SettingsOptionCard : UserControl
+{
+    public static readonly StyledProperty<string?> IconKeyProperty =
+        AvaloniaProperty.Register<SettingsOptionCard, string?>(nameof(IconKey), "Settings");
+
+    public static readonly StyledProperty<string?> TitleProperty =
+        AvaloniaProperty.Register<SettingsOptionCard, string?>(nameof(Title));
+
+    public static readonly StyledProperty<string?> DescriptionProperty =
+        AvaloniaProperty.Register<SettingsOptionCard, string?>(nameof(Description));
+
+    public static readonly StyledProperty<object?> ActionContentProperty =
+        AvaloniaProperty.Register<SettingsOptionCard, object?>(nameof(ActionContent));
+
+    public static readonly StyledProperty<object?> DetailsContentProperty =
+        AvaloniaProperty.Register<SettingsOptionCard, object?>(nameof(DetailsContent));
+
+    public SettingsOptionCard()
+    {
+        InitializeComponent();
+        RefreshVisualState();
+    }
+
+    public string? IconKey
+    {
+        get => GetValue(IconKeyProperty);
+        set => SetValue(IconKeyProperty, value);
+    }
+
+    public string? Title
+    {
+        get => GetValue(TitleProperty);
+        set => SetValue(TitleProperty, value);
+    }
+
+    public string? Description
+    {
+        get => GetValue(DescriptionProperty);
+        set => SetValue(DescriptionProperty, value);
+    }
+
+    public object? ActionContent
+    {
+        get => GetValue(ActionContentProperty);
+        set => SetValue(ActionContentProperty, value);
+    }
+
+    public object? DetailsContent
+    {
+        get => GetValue(DetailsContentProperty);
+        set => SetValue(DetailsContentProperty, value);
+    }
+
+    protected override void OnPropertyChanged(AvaloniaPropertyChangedEventArgs change)
+    {
+        base.OnPropertyChanged(change);
+
+        if (change.Property == IconKeyProperty ||
+            change.Property == TitleProperty ||
+            change.Property == DescriptionProperty ||
+            change.Property == ActionContentProperty ||
+            change.Property == DetailsContentProperty)
+        {
+            RefreshVisualState();
+        }
+    }
+
+    private void RefreshVisualState()
+    {
+        if (CardIcon is null ||
+            IconHost is null ||
+            TitleTextBlock is null ||
+            DescriptionTextBlock is null ||
+            ActionContentHost is null ||
+            DetailsContentHost is null)
+        {
+            return;
+        }
+
+        CardIcon.Symbol = MapIcon(IconKey);
+        IconHost.IsVisible = !string.IsNullOrWhiteSpace(IconKey);
+
+        TitleTextBlock.Text = Title ?? string.Empty;
+        DescriptionTextBlock.Text = Description ?? string.Empty;
+        DescriptionTextBlock.IsVisible = !string.IsNullOrWhiteSpace(Description);
+
+        ActionContentHost.Content = ActionContent;
+        ActionContentHost.IsVisible = ActionContent is not null;
+
+        DetailsContentHost.Content = DetailsContent;
+        DetailsContentHost.IsVisible = DetailsContent is not null;
+    }
+
+    private static Symbol MapIcon(string? iconKey)
+    {
+        return iconKey?.Trim() switch
+        {
+            "DesignIdeas" => Symbol.Color,
+            "Image" => Symbol.Image,
+            "GridDots" => Symbol.GridDots,
+            "PuzzlePiece" => Symbol.PuzzlePiece,
+            "Info" => Symbol.Info,
+            "ArrowSync" => Symbol.ArrowSync,
+            _ => Symbol.Settings
+        };
+    }
+}

LanMountainDesktop/Controls/SettingsSectionCard.axaml

@@ -0,0 +1,33 @@
+<UserControl xmlns="https://github.com/avaloniaui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+             xmlns:local="using:LanMountainDesktop.Controls"
+             xmlns:fi="using:FluentIcons.Avalonia"
+             x:Class="LanMountainDesktop.Controls.SettingsSectionCard"
+             x:Name="Root">
+    <Border Classes="settings-section-card">
+        <Grid RowDefinitions="Auto,Auto"
+              RowSpacing="16">
+            <Grid ColumnDefinitions="Auto,*"
+                  ColumnSpacing="14">
+                <Border x:Name="IconHost"
+                        Classes="settings-section-card-icon-host">
+                    <fi:SymbolIcon x:Name="CardIcon"
+                                   Classes="icon-l" />
+                </Border>
+
+                <StackPanel Grid.Column="1"
+                            Spacing="4">
+                    <TextBlock x:Name="TitleTextBlock"
+                               Classes="settings-card-header"
+                               Margin="0" />
+                    <TextBlock x:Name="DescriptionTextBlock"
+                               Classes="settings-card-description"
+                               Margin="0" />
+                </StackPanel>
+            </Grid>
+
+            <ContentPresenter x:Name="CardContentHost"
+                              Grid.Row="1" />
+        </Grid>
+    </Border>
+</UserControl>

LanMountainDesktop/Controls/SettingsSectionCard.axaml.cs

@@ -0,0 +1,98 @@
+using Avalonia;
+using Avalonia.Controls;
+using FluentIcons.Common;
+
+namespace LanMountainDesktop.Controls;
+
+public partial class SettingsSectionCard : UserControl
+{
+    public static readonly StyledProperty<string?> IconKeyProperty =
+        AvaloniaProperty.Register<SettingsSectionCard, string?>(nameof(IconKey), "Settings");
+
+    public static readonly StyledProperty<string?> TitleProperty =
+        AvaloniaProperty.Register<SettingsSectionCard, string?>(nameof(Title));
+
+    public static readonly StyledProperty<string?> DescriptionProperty =
+        AvaloniaProperty.Register<SettingsSectionCard, string?>(nameof(Description));
+
+    public static readonly StyledProperty<object?> CardContentProperty =
+        AvaloniaProperty.Register<SettingsSectionCard, object?>(nameof(CardContent));
+
+    public SettingsSectionCard()
+    {
+        InitializeComponent();
+        RefreshVisualState();
+    }
+
+    public string? IconKey
+    {
+        get => GetValue(IconKeyProperty);
+        set => SetValue(IconKeyProperty, value);
+    }
+
+    public string? Title
+    {
+        get => GetValue(TitleProperty);
+        set => SetValue(TitleProperty, value);
+    }
+
+    public string? Description
+    {
+        get => GetValue(DescriptionProperty);
+        set => SetValue(DescriptionProperty, value);
+    }
+
+    public object? CardContent
+    {
+        get => GetValue(CardContentProperty);
+        set => SetValue(CardContentProperty, value);
+    }
+
+    protected override void OnPropertyChanged(AvaloniaPropertyChangedEventArgs change)
+    {
+        base.OnPropertyChanged(change);
+
+        if (change.Property == IconKeyProperty ||
+            change.Property == TitleProperty ||
+            change.Property == DescriptionProperty ||
+            change.Property == CardContentProperty)
+        {
+            RefreshVisualState();
+        }
+    }
+
+    private void RefreshVisualState()
+    {
+        if (CardIcon is null ||
+            IconHost is null ||
+            TitleTextBlock is null ||
+            DescriptionTextBlock is null ||
+            CardContentHost is null)
+        {
+            return;
+        }
+
+        CardIcon.Symbol = MapIcon(IconKey);
+        IconHost.IsVisible = !string.IsNullOrWhiteSpace(IconKey);
+
+        TitleTextBlock.Text = Title ?? string.Empty;
+        DescriptionTextBlock.Text = Description ?? string.Empty;
+        DescriptionTextBlock.IsVisible = !string.IsNullOrWhiteSpace(Description);
+
+        CardContentHost.Content = CardContent;
+    }
+
+    private static Symbol MapIcon(string? iconKey)
+    {
+        return iconKey?.Trim() switch
+        {
+            "DesignIdeas" => Symbol.Color,
+            "Image" => Symbol.Image,
+            "GridDots" => Symbol.GridDots,
+            "PuzzlePiece" => Symbol.PuzzlePiece,
+            "Info" => Symbol.Info,
+            "ArrowSync" => Symbol.ArrowSync,
+            _ => Symbol.Settings
+        };
+    }
+}

LanMountainDesktop/Helpers/PluginMarketMarkdownHelper.cs

@@ -0,0 +1,47 @@
+using System;
+using System.Diagnostics;
+using System.Windows.Input;
+using CommunityToolkit.Mvvm.Input;
+using Markdown.Avalonia;
+
+namespace LanMountainDesktop.Helpers;
+
+public static class PluginMarketMarkdownHelper
+{
+    private static Markdown.Avalonia.Markdown? _engine;
+
+    public static ICommand OpenLinkCommand { get; } = new RelayCommand<object?>(OpenLink);
+
+    public static Markdown.Avalonia.Markdown Engine => _engine ??= new Markdown.Avalonia.Markdown
+    {
+        HyperlinkCommand = OpenLinkCommand
+    };
+
+    private static void OpenLink(object? parameter)
+    {
+        var url = parameter switch
+        {
+            Uri uri => uri.ToString(),
+            string text => text,
+            _ => null
+        };
+
+        if (string.IsNullOrWhiteSpace(url))
+        {
+            return;
+        }
+
+        try
+        {
+            Process.Start(new ProcessStartInfo
+            {
+                FileName = url,
+                UseShellExecute = true
+            });
+        }
+        catch
+        {
+            // Ignore browser launch failures inside the markdown viewer.
+        }
+    }
+}

LanMountainDesktop/LanMountainDesktop.csproj

@@ -1,10 +1,11 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
     <OutputType>WinExe</OutputType>
     <TargetFramework>net10.0</TargetFramework>
     <Nullable>enable</Nullable>
     <Version>1.0.0</Version>
     <ApplicationManifest>app.manifest</ApplicationManifest>
+    <ApplicationIcon>Assets\logo_nightly.ico</ApplicationIcon>
     <AvaloniaUseCompiledBindingsByDefault>true</AvaloniaUseCompiledBindingsByDefault>
     <SelfContained Condition="'$(RuntimeIdentifier)' != ''">true</SelfContained>
   </PropertyGroup>
@@ -20,14 +21,22 @@
   <ItemGroup>
     <Folder Include="Models\" />
     <AvaloniaResource Include="Assets\**" />
+    <AvaloniaResource Include="Localization\**" />
+    <EmbeddedResource Include="Assets\Documents\Privacy.md" />
+    <EmbeddedResource Include="Localization\*.json" />
     <None Include="Localization\*.json" CopyToOutputDirectory="PreserveNewest" />
     <None Include="Extensions\Components\*.json" CopyToOutputDirectory="PreserveNewest" />
   </ItemGroup>
 
   <ItemGroup>
+    <ProjectReference Include="..\LanMountainDesktop.Host.Abstractions\LanMountainDesktop.Host.Abstractions.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Shared.Contracts\LanMountainDesktop.Shared.Contracts.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Settings.Core\LanMountainDesktop.Settings.Core.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.Appearance\LanMountainDesktop.Appearance.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.DesktopComponents.Runtime\LanMountainDesktop.DesktopComponents.Runtime.csproj" />
+    <ProjectReference Include="..\LanMountainDesktop.DesktopHost\LanMountainDesktop.DesktopHost.csproj" />
     <ProjectReference Include="..\LanMountainDesktop.PluginSdk\LanMountainDesktop.PluginSdk.csproj" />
-    <ProjectReference Include="..\LanMountainDesktop.PluginsInstallHelper\LanMountainDesktop.PluginsInstallHelper.csproj"
-                      ReferenceOutputAssembly="false" />
+    <ProjectReference Include="..\LanMountainDesktop.PluginsInstallHelper\LanMountainDesktop.PluginsInstallHelper.csproj" ReferenceOutputAssembly="false" />
   </ItemGroup>
 
   <ItemGroup>
@@ -46,16 +55,24 @@
     <PackageReference Include="FluentAvaloniaUI" Version="2.5.0" />
     <PackageReference Include="FluentIcons.Avalonia" Version="2.0.319" />
     <PackageReference Include="FluentIcons.Avalonia.Fluent" Version="2.0.319" />
+    <PackageReference Include="Material.Avalonia" Version="3.13.4" />
     <PackageReference Include="Material.Icons.Avalonia" Version="2.4.1" />
+    <PackageReference Include="ClassIsland.Markdown.Avalonia" Version="11.0.3.4" />
     <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="10.0.0" />
     <PackageReference Include="Microsoft.Extensions.Hosting.Abstractions" Version="10.0.0" />
     <PackageReference Include="Microsoft.Data.Sqlite" Version="10.0.0" />
-    <PackageReference Include="LibVLCSharp.Avalonia" Version="3.9.5" />
+    <PackageReference Include="MudTools.OfficeInterop" Version="2.0.8" />
+    <PackageReference Include="MudTools.OfficeInterop.Word" Version="2.0.8" />
+    <PackageReference Include="MudTools.OfficeInterop.Excel" Version="2.0.8" />
+    <PackageReference Include="MudTools.OfficeInterop.PowerPoint" Version="2.0.8" />
+
     <PackageReference Include="PortAudioSharp2" Version="1.0.6" />
+    <PackageReference Include="MaterialColorUtilities" Version="0.3.0" />
+    <PackageReference Include="PostHog" Version="2.4.0" />
+    <PackageReference Include="Sentry" Version="4.0.0" />
     <PackageReference Include="System.Runtime.WindowsRuntime" Version="4.7.0" />
     <PackageReference Include="System.Drawing.Common" Version="10.0.0" />
-    <PackageReference Include="VideoLAN.LibVLC.Windows" Version="3.0.23" Condition="('$(RuntimeIdentifier)' == '' and $([MSBuild]::IsOSPlatform('Windows')))&#xA;                              or '$(RuntimeIdentifier)' == 'win-x64'&#xA;                              or '$(RuntimeIdentifier)' == 'win-x86'" />
-    <PackageReference Include="VideoLAN.LibVLC.Mac" Version="3.1.3.1" Condition="('$(RuntimeIdentifier)' == '' and $([MSBuild]::IsOSPlatform('OSX')))&#xA;                              or '$(RuntimeIdentifier)' == 'osx-x64'" />
+
     <PackageReference Include="WebView.Avalonia" Version="11.0.0.1" />
     <PackageReference Include="WebView.Avalonia.Desktop" Version="11.0.0.1" />
     <PackageReference Include="YamlDotNet" Version="16.3.0" />
@@ -65,17 +82,13 @@
     <ItemGroup>
       <PluginsInstallHelperFiles Include="..\LanMountainDesktop.PluginsInstallHelper\bin\$(Configuration)\net10.0\**\*.*" />
     </ItemGroup>
-    <Copy SourceFiles="@(PluginsInstallHelperFiles)"
-          DestinationFiles="@(PluginsInstallHelperFiles->'$(OutDir)PluginsInstallHelper\%(RecursiveDir)%(Filename)%(Extension)')"
-          SkipUnchangedFiles="true" />
+    <Copy SourceFiles="@(PluginsInstallHelperFiles)" DestinationFiles="@(PluginsInstallHelperFiles->'$(OutDir)PluginsInstallHelper\%(RecursiveDir)%(Filename)%(Extension)')" SkipUnchangedFiles="true" />
   </Target>
 
   <Target Name="CopyPluginsInstallHelperToPublish" AfterTargets="Publish" Condition="'$(PublishDir)' != ''">
     <ItemGroup>
       <PluginsInstallHelperPublishFiles Include="..\LanMountainDesktop.PluginsInstallHelper\bin\$(Configuration)\net10.0\**\*.*" />
     </ItemGroup>
-    <Copy SourceFiles="@(PluginsInstallHelperPublishFiles)"
-          DestinationFiles="@(PluginsInstallHelperPublishFiles->'$(PublishDir)PluginsInstallHelper\%(RecursiveDir)%(Filename)%(Extension)')"
-          SkipUnchangedFiles="true" />
+    <Copy SourceFiles="@(PluginsInstallHelperPublishFiles)" DestinationFiles="@(PluginsInstallHelperPublishFiles->'$(PublishDir)PluginsInstallHelper\%(RecursiveDir)%(Filename)%(Extension)')" SkipUnchangedFiles="true" />
   </Target>
 </Project>

LanMountainDesktop/Localization/en-US.json

@@ -1,29 +1,37 @@
-{
+{
     "app.title":  "LanMountainDesktop",
     "tray.tooltip":  "LanMountainDesktop",
+    "tray.menu.show_desktop":  "Open Desktop",
     "tray.menu.settings":  "Settings",
+    "tray.menu.component_library":  "Component Library",
     "tray.menu.restart":  "Restart App",
     "tray.menu.exit":  "Exit App",
     "button.back_to_windows":  "Back to Windows",
+    "button.back_to_platform": "Back to {0}",
     "tooltip.back_to_windows":  "Back to Windows",
+    "tooltip.back_to_platform": "Back to {0}",
+    "platform.windows": "Windows",
+    "platform.linux": "Linux",
+    "platform.macos": "macOS",
     "tooltip.open_settings":  "Settings",
     "settings.title":  "Settings",
-    "settings.shell.title":  "Application Settings",
-    "settings.shell.subtitle":  "LanMountainDesktop standalone preferences",
+    "settings.shell.title":  "Settings",
+    "settings.shell.subtitle":  "LanMountainDesktop independent settings module",
     "settings.shell.sidebar_hint":  "Choose a category to adjust application behavior, desktop layout, and appearance.",
-    "settings.shell.footer_hint":  "Tray-opened settings are managed in this standalone window.",
+    "settings.shell.footer_hint":  "Tray-opened settings are managed in this independent settings module.",
     "settings.back_to_desktop":  "Back to Desktop",
     "settings.nav_header":  "Settings",
     "settings.nav.group_desktop":  "Desktop",
     "settings.nav.group_system":  "System",
     "settings.nav.group_extensions":  "Extensions",
     "settings.nav.wallpaper":  "Wallpaper",
-    "settings.nav.grid":  "Grid",
+    "settings.nav.grid":  "Components",
     "settings.nav.color":  "Color",
     "settings.nav.status_bar":  "Status Bar",
     "settings.nav.weather":  "Weather",
     "settings.nav.region":  "Region",
     "settings.nav.update":  "Update",
+    "settings.nav.privacy":  "Privacy",
     "settings.nav.launcher":  "App Launcher",
     "settings.nav.plugins":  "Plugins",
     "settings.nav.about":  "About",
@@ -83,6 +91,8 @@
     "settings.status_bar.description":  "Choose which components appear on the top status bar.",
     "settings.status_bar.clock_header":  "Clock Component",
     "settings.status_bar.clock_description":  "Display a clock on the top status bar.",
+    "settings.status_bar.clock_transparent_background_label":  "Transparent background",
+    "settings.status_bar.clock_transparent_background_desc":  "Remove the capsule background and keep only the clock text.",
     "settings.status_bar.spacing_header":  "Component Spacing",
     "settings.status_bar.spacing_desc":  "Adjust spacing between status bar components.",
     "settings.status_bar.spacing_mode_compact":  "Compact",
@@ -90,7 +100,19 @@
     "settings.status_bar.spacing_mode_custom":  "Custom",
     "settings.status_bar.spacing_custom_label":  "Custom spacing (%)",
     "settings.status_bar.spacing_custom_px_format":  "≈ {0:F1}px",
+    "settings.privacy.title":  "Privacy",
+    "settings.privacy.description":  "Manage optional anonymous uploads that help improve the app over time.",
+    "settings.privacy.crash_upload_title":  "Anonymous crash data uploads",
+    "settings.privacy.crash_upload_description":  "Help us improve application stability.",
+    "settings.privacy.usage_upload_title":  "Anonymous usage data uploads",
+    "settings.privacy.usage_upload_description":  "Help us improve application features.",
+    "settings.privacy.device_id_title":  "Device ID",
+    "settings.privacy.device_id_description":  "Unique identifier for this device. Click refresh to regenerate.",
+    "settings.privacy.refresh_device_id":  "Refresh",
+    "settings.privacy.policy_hint_prefix":  "For more details, please ",
+    "settings.privacy.view_policy":  "view our privacy policy",
     "settings.weather.title":  "Weather",
+    "settings.weather.description":  "Configure weather location, Xiaomi weather preview, and startup positioning behavior.",
     "settings.weather.location_source_header":  "Location Source",
     "settings.weather.location_source_desc":  "Choose how weather widgets resolve location.",
     "settings.weather.mode_city_search":  "City Search",
@@ -117,6 +139,14 @@
     "settings.weather.apply_coordinates_button":  "Apply Coordinates",
     "settings.weather.coordinates_saved_format":  "Coordinates saved: {0:F4}, {1:F4}",
     "settings.weather.coordinates_default_name_format":  "Coordinate {0:F4}, {1:F4}",
+    "settings.weather.location_services_header":  "Location Service",
+    "settings.weather.location_services_desc":  "Use the current Windows location and decide whether it refreshes automatically on startup.",
+    "settings.weather.use_current_location":  "Use Current Location",
+    "settings.weather.location_unsupported":  "Current platform does not support retrieving the current location.",
+    "settings.weather.location_ready":  "You can use the current Windows location.",
+    "settings.weather.location_refreshing":  "Requesting current location...",
+    "settings.weather.location_refresh_success_format":  "Current location applied: {0}",
+    "settings.weather.location_refresh_failed_format":  "Failed to get current location: {0}",
     "settings.weather.preview_header":  "Connection Test",
     "settings.weather.preview_desc":  "Send one test request to verify current settings.",
     "settings.weather.preview_button":  "Test Fetch",
@@ -125,6 +155,7 @@
     "settings.weather.preview_panel_header":  "Weather Preview",
     "settings.weather.preview_panel_desc":  "Refresh and verify current weather service status.",
     "settings.weather.refresh_button":  "Refresh",
+    "settings.weather.preview_updated_format":  "Updated {0}",
     "settings.weather.preview_hint":  "Use test fetch to verify your weather configuration.",
     "settings.weather.preview_missing_location":  "Please apply one weather location before testing.",
     "settings.weather.preview_success_format":  "Test success: {0} · {1} · {2}",
@@ -220,6 +251,69 @@
     "settings.region.timezone_header":  "Time Zone",
     "settings.region.timezone_desc":  "Select a time zone. Clock and calendar widgets will follow this zone.",
     "settings.region.applied_format":  "Language switched to: {0}",
+    "settings.region.follow_system":  "Follow system default",
+    "settings.general.title":  "General",
+    "settings.general.description":  "Adjust language, time zone, and runtime behavior.",
+    "settings.general.basic_header":  "Basic Settings",
+    "settings.general.runtime_header":  "Runtime",
+    "settings.general.preview_header":  "Date & Time Preview",
+    "settings.general.preview_time_label":  "Time",
+    "settings.general.preview_date_label":  "Date",
+    "settings.general.render_mode_restart_message":  "Rendering mode changes require restarting the app.",
+    "settings.appearance.title":  "Appearance",
+    "settings.appearance.description":  "Adjust theme source, system material, and window chrome.",
+    "settings.appearance.theme_header":  "Theme",
+    "settings.color.enable_night_mode_toggle":  "Enable night mode",
+    "settings.color.use_system_chrome_toggle":  "Use system window chrome",
+    "settings.color.theme_color_label":  "Theme accent color",
+    "settings.appearance.theme_color_mode_label":  "Theme color source",
+    "settings.appearance.theme_color_mode.neutral":  "Default neutral",
+    "settings.appearance.theme_color_mode.user":  "User theme color Monet",
+    "settings.appearance.theme_color_mode.wallpaper":  "Wallpaper Monet",
+    "settings.appearance.theme_color_mode_desc.neutral":  "Use the default white and black neutral surfaces for light and dark mode.",
+    "settings.appearance.theme_color_mode_desc.user":  "Use the selected theme color as the Monet seed for the whole shell.",
+    "settings.appearance.theme_color_mode_desc.wallpaper":  "Use wallpaper colors. The app wallpaper is preferred, then the system wallpaper.",
+    "settings.appearance.theme_color_preview.app":  "Currently previewing colors extracted from the app wallpaper.",
+    "settings.appearance.theme_color_preview.system":  "Currently previewing colors extracted from the system wallpaper.",
+    "settings.appearance.theme_color_preview.fallback":  "No usable wallpaper was found. The app is using a fallback accent.",
+    "component.color_scheme.follow_system":  "Follow system color scheme",
+    "component.color_scheme.native":  "Use component custom color scheme",
+    "settings.appearance.system_material.none":  "None",
+    "settings.appearance.system_material.mica":  "Mica",
+    "settings.appearance.system_material.acrylic":  "Acrylic",
+    "settings.appearance.system_material_desc.switchable":  "Apply the selected material to windows, Dock, status bar, and component hosts.",
+    "settings.appearance.system_material_desc.fixed":  "Your current system only exposes the material modes listed here.",
+    "settings.appearance.restart_message":  "Theme source and system material changes require restarting the app.",
+    "settings.appearance.preview.primary":  "Primary",
+    "settings.appearance.preview.secondary":  "Secondary",
+    "settings.appearance.preview.tertiary":  "Tertiary",
+    "settings.appearance.preview.neutral":  "Neutral",
+    "settings.appearance.preview.seed":  "Seed",
+    "settings.appearance.preview.neutral_light":  "White",
+    "settings.appearance.preview.neutral_dark":  "Black",
+    "settings.appearance.preview.apply_seed":  "Apply",
+    "settings.appearance.preview.wallpaper_candidates":  "Wallpaper seed candidates",
+    "settings.appearance.preview.wallpaper_current":  "Current",
+    "settings.wallpaper.placement.fill":  "Fill",
+    "settings.wallpaper.placement.fit":  "Fit",
+    "settings.wallpaper.placement.stretch":  "Stretch",
+    "settings.wallpaper.placement.center":  "Center",
+    "settings.wallpaper.placement.tile":  "Tile",
+    "settings.status_bar.clock_format_label":  "Clock format",
+    "settings.status_bar.clock_format.hm":  "Hour:Minute",
+    "settings.status_bar.clock_format.hms":  "Hour:Minute:Second",
+    "settings.components.title":  "Components",
+    "settings.components.description":  "Adjust component layout and corner design.",
+    "settings.components.grid_header":  "Grid Settings",
+    "settings.components.header":  "Grid Settings",
+    "settings.components.short_side_label":  "Short Side Cells",
+    "settings.components.edge_inset_label":  "Screen Inset",
+    "settings.components.spacing_label":  "Component Spacing",
+    "settings.components.spacing_compact":  "Compact",
+    "settings.components.spacing_relaxed":  "Relaxed",
+    "settings.components.corner_radius.header":  "Corner Design",
+    "settings.components.corner_radius.label":  "Component Corner Radius",
+    "settings.components.corner_radius.description":  "Adjust the shared corner radius used by component containers, and expand the internal safe area with it.",
     "settings.update.title":  "Update",
     "settings.update.current_version_label":  "Current Version",
     "settings.update.latest_version_label":  "Latest Release",
@@ -272,9 +366,42 @@
     "settings.about.render_mode.current_format":  "Current backend: {0}",
     "settings.about.render_mode.impl_format":  "Runtime implementation: {0}",
     "settings.about.render_mode.impl_unavailable":  "Runtime implementation details are unavailable.",
+    "settings.about.description":  "Application details.",
+    "settings.update.description":  "Check releases, choose the update channel and download source, and control how updates are installed.",
+    "settings.update.status_card_title":  "Update Status",
+    "settings.update.status_card_description":  "Check for updates, review release details, and continue with download or installation when a new version is available.",
+    "settings.update.preferences_header":  "Update Preferences",
+    "settings.update.preferences_description":  "Choose the release channel, installer download source, installation behavior, and download parallelism.",
+    "settings.update.last_checked_label":  "Last Checked",
+    "settings.update.source_label":  "Download Source",
+    "settings.update.source_github":  "GitHub",
+    "settings.update.source_ghproxy":  "gh-proxy",
+    "settings.update.source_github_desc":  "Download release assets directly from GitHub.",
+    "settings.update.source_ghproxy_desc":  "Use the gh-proxy mirror when downloading GitHub release assets.",
+    "settings.update.mode_label":  "Update Mode",
+    "settings.update.mode_manual":  "Manual Update",
+    "settings.update.mode_download_then_confirm":  "Silent Download",
+    "settings.update.mode_silent_on_exit":  "Silent Install",
+    "settings.update.mode_manual_desc":  "Only check for updates. You decide when downloads and installation happen.",
+    "settings.update.mode_download_then_confirm_desc":  "Download updates in the background and ask for confirmation before installing them.",
+    "settings.update.mode_silent_on_exit_desc":  "Download updates in the background and install them the next time you exit the app.",
+    "settings.update.channel_stable_desc":  "Stable builds prioritize reliability and are recommended for most users.",
+    "settings.update.channel_preview_desc":  "Preview builds may contain newer features but can be less stable.",
+    "settings.update.download_threads_label":  "Download Threads",
+    "settings.update.download_threads_desc":  "Set the number of parallel download threads for application update packages.",
+    "settings.update.install_now_button":  "Install Now",
+    "settings.update.status_downloaded_confirm":  "Update downloaded. Review it and choose when to install.",
+    "settings.update.status_downloaded_exit":  "Update downloaded. It will be installed when you exit the app.",
+    "settings.about.app_info_header":  "Application Information",
+    "settings.about.update_header":  "Updates",
+    "settings.about.version_label":  "Version",
+    "settings.about.codename_label":  "Codename",
+    "settings.about.render_backend_label":  "Render Backend",
+    "settings.about.render_backend_format":  "Render Backend: {0}",
     "settings.restart_dialog.title":  "Restart required",
     "settings.restart_dialog.render_mode_message":  "Restart the app to switch the rendering mode from \"{0}\" to \"{1}\". Restart now?",
     "settings.restart_dialog.restart":  "Restart now",
+    "settings.restart_dialog.later":  "Later",
     "settings.restart_dialog.cancel":  "Cancel",
     "settings.restart_dock.title":  "Restart required",
     "settings.restart_dock.description":  "Some changes will take effect after restarting the app.",
@@ -292,6 +419,7 @@
     "common.monet":  "Monet",
     "desktop.page_index_format":  "Desktop {0}",
     "launcher.title":  "App Launcher",
+    "launcher.folder": "Folder",
     "launcher.subtitle":  "Apps and folders from Windows Start Menu",
     "launcher.subtitle_linux":  "Installed apps discovered from Linux desktop entries",
     "launcher.empty":  "No Start Menu entries found.",
@@ -301,18 +429,34 @@
     "launcher.context.hide_icon":  "Hide Icon",
     "launcher.action.hide":  "Hide",
     "settings.launcher.title":  "App Launcher",
+    "settings.launcher.description":  "Manage hidden apps and folders in the App Launcher.",
     "settings.launcher.hidden_header":  "Hidden Items",
     "settings.launcher.hidden_desc":  "Review hidden launcher entries and show them again.",
     "settings.launcher.hidden_hint":  "In desktop edit mode, select a launcher icon and click Hide. Hidden entries appear here.",
     "settings.launcher.hidden_empty":  "No hidden items.",
+    "settings.launcher.hidden_summary_format":  "{0} hidden items",
     "settings.launcher.hidden_type_folder":  "Folder",
-    "settings.launcher.hidden_type_shortcut":  "Shortcut",
+    "settings.launcher.hidden_type_shortcut":  "App",
     "settings.launcher.restore_button":  "Unhide",
     "settings.plugins.title":  "Plugins",
     "settings.plugins.runtime_header":  "Plugin Runtime",
     "settings.plugins.runtime_desc":  "Review plugin runtime state and load results.",
     "settings.plugins.runtime_hint":  "This page shows discovery status, load results, and runtime diagnostics for installed plugins.",
     "settings.plugins.runtime_status":  "Plugin runtime status will appear here after plugin discovery completes.",
+    "settings.plugins.description":  "Manage installed plugins and review their runtime state.",
+    "settings.plugins.initial_status":  "Refresh plugin state to see the latest installed plugins.",
+    "settings.plugins.refresh_button":  "Refresh Plugins",
+    "settings.plugins.refresh_success_installed_format":  "Loaded {0} installed plugins.",
+    "settings.plugins.refresh_success_format":  "Loaded {0} installed plugins and {1} marketplace entries.",
+    "settings.plugins.refresh_failed":  "Failed to load plugin market index.",
+    "settings.plugins.marketplace_header":  "Marketplace",
+    "settings.plugins.marketplace_empty":  "No marketplace plugins are available right now.",
+    "settings.plugins.delete_button_short":  "Delete",
+    "settings.plugins.install_button_short":  "Install",
+    "settings.plugins.restart_required":  "Plugin changes take effect after restart.",
+    "settings.plugins.toggle_unchanged_format":  "Plugin '{0}' did not change.",
+    "settings.plugins.delete_failed_name_format":  "Failed to remove plugin '{0}'.",
+    "settings.plugins.install_failed_name_format":  "Failed to install '{0}'.",
     "settings.plugins.installed_header":  "Installed Plugins",
     "settings.plugins.installed_desc":  "Review installed plugins and remove them here.",
     "settings.plugins.import_header":  "Install From Package",
@@ -356,6 +500,12 @@
     "settings.plugin_market.title":  "Plugin Market",
     "settings.plugin_market.subtitle":  "Browse plugins from the official LanAirApp source and stage installs.",
     "settings.plugin_market.unavailable":  "Plugin runtime is not available, so the official market cannot be opened right now.",
+    "settings.update.status_idle":  "No update check has been performed yet.",
+    "settings.update.status_preferences_saved":  "Update preferences saved.",
+    "settings.update.status_check_failed":  "Failed to check for updates.",
+    "settings.update.status_available_summary_format":  "Update available: {0} (current: {1})",
+    "settings.update.status_up_to_date_format":  "You are up to date ({0}).",
+    "settings.window.drawer_default":  "Details",
     "market.toolbar.search_placeholder":  "Search plugins",
     "market.toolbar.refresh":  "Refresh",
     "market.status.loading":  "Loading the official plugin market...",
@@ -372,7 +522,7 @@
     "market.card.loaded":  "Loaded",
     "market.card.pending_restart":  "Restart required",
     "market.detail.placeholder":  "Select a plugin on the left to inspect details.",
-    "market.detail.author":  "Author",
+    "market.detail.author":  "Publisher",
     "market.detail.version":  "Version",
     "market.detail.api_version":  "API Version",
     "market.detail.min_host_version":  "Minimum Host Version",
@@ -391,6 +541,11 @@
     "market.detail.homepage":  "Homepage",
     "market.detail.repository":  "Repository",
     "market.detail.release_notes":  "Release Notes",
+    "market.detail.dependencies":  "Dependencies",
+    "market.detail.dependencies_empty":  "No shared contract dependencies were declared by this plugin.",
+    "market.detail.readme_loading":  "Loading README...",
+    "market.detail.readme_empty":  "README is empty.",
+    "market.detail.readme_error_format":  "README could not be loaded: {0}",
     "market.detail.state.not_installed":  "Not installed",
     "market.detail.state.update_available":  "Update available",
     "market.detail.state.installed":  "Installed",
@@ -399,6 +554,7 @@
     "market.button.update":  "Update",
     "market.button.installed":  "Installed",
     "market.button.installing":  "Installing...",
+    "market.button.restart":  "Restart to apply",
     "button.component_library":  "Edit Desktop",
     "tooltip.component_library":  "Edit Desktop",
     "component_library.title":  "Widgets",
@@ -406,6 +562,12 @@
     "component_library.drag_hint":  "Drag to place",
     "component.delete":  "Delete",
     "component.edit":  "Edit",
+    "component.editor.instance_scope": "Changes apply to this component instance only.",
+    "component.editor.info_header": "Component Info",
+    "component.editor.id_label": "Component ID",
+    "component.editor.placement_label": "Placement ID",
+    "component.editor.scope_label": "Scope",
+    "component.editor.scope_instance": "Instance-scoped editor",
     "component_category.clock":  "Clock",
     "component_category.date":  "Calendar",
     "component_category.weather":  "Weather",
@@ -414,6 +576,7 @@
     "component_category.info":  "Info",
     "component_category.calculator":  "Calculator",
     "component_category.study":  "Study",
+    "component_category.file":  "File",
     "component.date":  "Calendar",
     "component.month_calendar":  "Month Calendar",
     "component.lunar_calendar":  "Lunar Calendar",
@@ -441,6 +604,20 @@
     "component.whiteboard":  "Blackboard (Portrait)",
     "component.blackboard_landscape":  "Blackboard (Landscape)",
     "component.browser":  "Browser",
+    "component.office_recent_documents":  "Recent Documents",
+    "whiteboard.settings.desc": "Each blackboard keeps its own note history and saves it independently.",
+    "whiteboard.settings.retention.title": "Note retention",
+    "whiteboard.settings.retention.desc": "Choose how long this blackboard should keep saved notes before expired data is removed automatically.",
+    "whiteboard.settings.retention.option": "{0} days",
+    "whiteboard.settings.instance_scope": "This retention setting is stored per blackboard component instance.",
+    "office_recent_documents.settings.desc":  "Choose which Windows and Office sources this widget should scan for recent documents.",
+    "office_recent_documents.settings.sources_title":  "Recent document sources",
+    "office_recent_documents.settings.sources_desc":  "You can combine multiple sources. Registry selection also keeps the Office interop MRU fallback available.",
+    "office_recent_documents.settings.source.registry":  "Office registry MRU",
+    "office_recent_documents.settings.source.recent_folders":  "Windows Recent folders",
+    "office_recent_documents.settings.source.jump_lists":  "Windows Jump Lists",
+    "office_recent_documents.settings.hint":  "If you disable all sources, this widget will stay empty until at least one source is enabled again.",
+    "component.removable_storage":  "Removable Storage",
     "component.holiday_calendar":  "Holiday Calendar",
     "component.study_environment":  "Environment",
     "component.study_session_control":  "Study Session Control",
@@ -642,6 +819,20 @@
     "study.environment.settings.show_display_db":  "Show display dB",
     "study.environment.settings.show_dbfs":  "Show dBFS",
     "study.environment.settings.hint":  "At least one display mode must stay enabled.",
+    "removable_storage.settings.desc":  "Show a connected USB drive with quick open and eject actions.",
+    "removable_storage.settings.behavior_title":  "Behavior",
+    "removable_storage.settings.behavior_desc":  "The widget automatically watches for removable drives and switches to the newest inserted USB drive.",
+    "removable_storage.action.open":  "Open",
+    "removable_storage.action.eject":  "Eject",
+    "removable_storage.widget.default_name":  "Removable Drive",
+    "removable_storage.widget.empty_title":  "No device inserted",
+    "removable_storage.widget.empty_subtitle":  "Insert a USB drive to show it here.",
+    "removable_storage.widget.empty_hint":  "Buttons stay disabled until a removable device is inserted.",
+    "removable_storage.widget.ready":  "Ready to open or eject.",
+    "removable_storage.widget.ejecting":  "Ejecting drive...",
+    "removable_storage.widget.eject_failed":  "Could not eject this drive. Close any files on it and try again.",
+    "removable_storage.widget.open_failed":  "Failed to open this drive.",
+    "removable_storage.widget.refresh_failed":  "Drive list refresh failed.",
     "study.session_control.action.start":  "Start Study Session",
     "study.session_control.action.stop":  "Stop Study Session",
     "study.session_control.idle_hint":  "Tap the right button to start",
@@ -746,7 +937,7 @@
     "placement.tile":  "Tile",
     "single_instance.notice.title":  "App already running",
     "single_instance.notice.description":  "The app is already running. There is no need to click multiple times to open it.",
-    "single_instance.notice.button":  "OK"
+    "single_instance.notice.button":  "OK",
+    "market.status.install_success_restart_format":  "✓ Plugin '{0}' installed successfully! Please restart the application to activate it.",
+    "market.dialog.restart_message_format":  "Plugin '{0}' has been installed successfully.\n\nTo use this plugin, you need to restart the application now.\n\nWould you like to restart?"
   }
-
-

LanMountainDesktop/Localization/zh-CN.json

@@ -1,57 +1,65 @@
-{
+{
     "app.title":  "LanMountainDesktop",
     "tray.tooltip":  "LanMountainDesktop",
+    "tray.menu.show_desktop":  "打开桌面",
     "tray.menu.settings":  "设置",
+    "tray.menu.component_library":  "独立组件库",
     "tray.menu.restart":  "重启应用",
     "tray.menu.exit":  "退出应用",
     "button.back_to_windows":  "回到Windows",
+    "button.back_to_platform": "回到{0}",
     "tooltip.back_to_windows":  "回到Windows",
+    "tooltip.back_to_platform": "回到{0}",
+    "platform.windows": "Windows",
+    "platform.linux": "Linux",
+    "platform.macos": "macOS",
     "tooltip.open_settings":  "设置",
     "settings.title":  "设置",
-    "settings.shell.title":  "应用设置",
-    "settings.shell.subtitle":  "LanMountainDesktop 独立设置窗口",
+    "settings.shell.title":  "设置",
+    "settings.shell.subtitle":  "LanMountainDesktop 独立设置模块",
     "settings.shell.sidebar_hint":  "选择一个分类以调整应用行为、桌面布局与外观。",
-    "settings.shell.footer_hint":  "托盘菜单打开的设置会统一在这个独立窗口中管理。",
+    "settings.shell.footer_hint":  "托盘菜单打开的设置会统一在这个独立设置模块中管理。",
     "settings.back_to_desktop":  "返回桌面",
     "settings.nav_header":  "设置选项",
     "settings.nav.group_desktop":  "桌面",
     "settings.nav.group_system":  "系统",
     "settings.nav.group_extensions":  "扩展",
     "settings.nav.wallpaper":  "壁纸",
-    "settings.nav.grid":  "网格",
+    "settings.nav.grid":  "组件",
     "settings.nav.color":  "颜色",
     "settings.nav.status_bar":  "状态栏",
     "settings.nav.weather":  "天气",
     "settings.nav.region":  "地区",
     "settings.nav.update":  "更新",
+    "settings.nav.privacy":  "隐私",
     "settings.nav.launcher":  "应用启动台",
     "settings.nav.plugins":  "插件",
     "settings.nav.about":  "关于",
     "settings.wallpaper.title":  "壁纸",
-    "settings.wallpaper.description":  "选择图片或视频后可立即设为应用窗口壁纸。",
+    "settings.wallpaper.description":  "选择图片后可立即设为应用窗口壁纸。",
     "settings.wallpaper.current_label":  "当前壁纸",
+    "settings.wallpaper.type_label":  "壁纸类型",
+    "settings.wallpaper.type.image":  "图片",
+    "settings.wallpaper.type.solid_color":  "纯色",
+    "settings.wallpaper.color_label":  "壁纸颜色",
+    "settings.wallpaper.custom_color_tooltip":  "自定义颜色",
+    "settings.wallpaper.custom_color_apply":  "应用",
     "settings.wallpaper.placement_label":  "显示方式",
     "settings.wallpaper.placement_desc":  "调整图像在桌面上的填充方式。",
-    "settings.wallpaper.pick_button":  "浏览文件",
+    "settings.wallpaper.pick_button":  "选择文件",
     "settings.wallpaper.clear_button":  "恢复纯色",
     "settings.wallpaper.no_selection":  "未选择壁纸。",
     "settings.wallpaper.storage_unavailable":  "存储提供器不可用。",
     "settings.wallpaper.import_failed":  "导入壁纸文件失败。",
     "settings.wallpaper.image_applied":  "图片壁纸已应用。",
-    "settings.wallpaper.video_applied":  "视频壁纸已应用。",
     "settings.wallpaper.unsupported_file":  "所选文件类型不受支持。",
     "settings.wallpaper.apply_failed_format":  "应用壁纸失败：{0}",
     "settings.wallpaper.mode_format":  "壁纸模式：{0}。",
-    "settings.wallpaper.video_mode":  "视频壁纸使用自动填充模式。",
     "settings.wallpaper.cleared":  "背景已恢复为纯色。",
     "settings.wallpaper.default_status":  "当前使用纯色背景。",
     "settings.wallpaper.saved_not_found":  "未找到已保存的壁纸文件，已使用纯色背景。",
     "settings.wallpaper.restored":  "已恢复保存的壁纸。",
-    "settings.wallpaper.video_restored":  "已恢复保存的视频壁纸。",
     "settings.wallpaper.restore_failed":  "恢复已保存壁纸失败，已使用纯色背景。",
-    "settings.wallpaper.video_not_found":  "未找到视频壁纸文件。",
-    "settings.wallpaper.video_player_unavailable":  "视频播放器不可用。",
-    "settings.wallpaper.video_play_failed_format":  "播放视频壁纸失败：{0}",
     "settings.grid.title":  "网格布局",
     "settings.grid.description":  "每个组件至少占用一个格子（最小 1x1）。",
     "settings.grid.short_side_label":  "短边格数",
@@ -77,12 +85,13 @@
     "settings.color.theme_ready_format":  "主题色已就绪：{0}。",
     "settings.color.theme_applied_format":  "{0}主题色已应用：{1}。",
     "settings.color.theme_updated_wallpaper":  "壁纸已更新，莫奈色已刷新。",
-    "settings.color.theme_updated_video":  "视频壁纸已更新，主题色已刷新。",
     "settings.color.theme_cleared_wallpaper":  "壁纸已清除，莫奈色已刷新。",
     "settings.status_bar.title":  "状态栏",
     "settings.status_bar.description":  "选择顶部状态栏显示的组件。",
     "settings.status_bar.clock_header":  "时间组件",
     "settings.status_bar.clock_description":  "在顶部状态栏显示时钟。",
+    "settings.status_bar.clock_transparent_background_label":  "透明背景",
+    "settings.status_bar.clock_transparent_background_desc":  "移除胶囊背景，仅保留时钟文字。",
     "settings.status_bar.spacing_header":  "组件间距",
     "settings.status_bar.spacing_desc":  "调整状态栏组件之间的间距。",
     "settings.status_bar.spacing_mode_compact":  "紧凑",
@@ -90,7 +99,19 @@
     "settings.status_bar.spacing_mode_custom":  "自定义",
     "settings.status_bar.spacing_custom_label":  "自定义间距（%）",
     "settings.status_bar.spacing_custom_px_format":  "≈ {0:F1}px",
+    "settings.privacy.title":  "隐私",
+    "settings.privacy.description":  "管理可选的匿名上传设置，帮助我们逐步改进应用体验。",
+    "settings.privacy.crash_upload_title":  "匿名上传崩溃数据",
+    "settings.privacy.crash_upload_description":  "帮助我们提高应用稳定性。",
+    "settings.privacy.usage_upload_title":  "匿名上传使用数据",
+    "settings.privacy.usage_upload_description":  "帮助我们改善应用功能。",
+    "settings.privacy.device_id_title":  "设备标识符",
+    "settings.privacy.device_id_description":  "此设备的唯一标识符。点击刷新以重新生成。",
+    "settings.privacy.refresh_device_id":  "刷新",
+    "settings.privacy.policy_hint_prefix":  "了解更多详情，请",
+    "settings.privacy.view_policy":  "查看我们的隐私政策",
     "settings.weather.title":  "天气",
+    "settings.weather.description":  "配置天气位置、小米天气预览和启动时的位置刷新行为。",
     "settings.weather.location_source_header":  "位置来源",
     "settings.weather.location_source_desc":  "选择天气组件如何解析当前位置。",
     "settings.weather.mode_city_search":  "城市搜索",
@@ -117,6 +138,14 @@
     "settings.weather.apply_coordinates_button":  "应用坐标",
     "settings.weather.coordinates_saved_format":  "坐标已保存：{0:F4}, {1:F4}",
     "settings.weather.coordinates_default_name_format":  "坐标 {0:F4}, {1:F4}",
+    "settings.weather.location_services_header":  "定位服务",
+    "settings.weather.location_services_desc":  "使用当前 Windows 定位，并决定是否在启动时自动刷新天气位置。",
+    "settings.weather.use_current_location":  "使用当前位置",
+    "settings.weather.location_unsupported":  "当前平台不支持获取当前位置。",
+    "settings.weather.location_ready":  "可以使用当前 Windows 定位。",
+    "settings.weather.location_refreshing":  "正在获取当前位置……",
+    "settings.weather.location_refresh_success_format":  "已应用当前位置：{0}",
+    "settings.weather.location_refresh_failed_format":  "获取当前位置失败：{0}",
     "settings.weather.preview_header":  "连接测试",
     "settings.weather.preview_desc":  "发送一次测试请求，验证当前配置是否可用。",
     "settings.weather.preview_button":  "测试获取",
@@ -125,6 +154,7 @@
     "settings.weather.preview_panel_header":  "天气预览",
     "settings.weather.preview_panel_desc":  "刷新并验证当前天气服务状态。",
     "settings.weather.refresh_button":  "刷新",
+    "settings.weather.preview_updated_format":  "更新于 {0}",
     "settings.weather.preview_hint":  "可通过测试获取快速验证天气配置。",
     "settings.weather.preview_missing_location":  "请先应用一个天气位置后再测试。",
     "settings.weather.preview_success_format":  "测试成功：{0} · {1} · {2}",
@@ -220,6 +250,69 @@
     "settings.region.timezone_header":  "时区",
     "settings.region.timezone_desc":  "选择时区。时钟与日历组件会使用该时区。",
     "settings.region.applied_format":  "语言已切换为：{0}",
+    "settings.region.follow_system":  "跟随系统默认",
+    "settings.general.title":  "基本设置",
+    "settings.general.description":  "调整语言、时区与运行时行为。",
+    "settings.general.basic_header":  "基础设置",
+    "settings.general.runtime_header":  "运行设置",
+    "settings.general.preview_header":  "日期与时间预览",
+    "settings.general.preview_time_label":  "时间",
+    "settings.general.preview_date_label":  "日期",
+    "settings.general.render_mode_restart_message":  "渲染模式变更需要重启应用。",
+    "settings.appearance.title":  "外观",
+    "settings.appearance.description":  "调整主题来源、系统材质与窗口外观。",
+    "settings.appearance.theme_header":  "主题",
+    "settings.color.enable_night_mode_toggle":  "启用夜间模式",
+    "settings.color.use_system_chrome_toggle":  "使用系统窗口标题栏",
+    "settings.color.theme_color_label":  "主题强调色",
+    "settings.appearance.theme_color_mode_label":  "主题色来源",
+    "settings.appearance.theme_color_mode.neutral":  "默认中性",
+    "settings.appearance.theme_color_mode.user":  "用户主题色 Monet",
+    "settings.appearance.theme_color_mode.wallpaper":  "壁纸 Monet 取色",
+    "settings.appearance.theme_color_mode_desc.neutral":  "使用标准的日间白底黑字与夜间黑底白字中性色表面。",
+    "settings.appearance.theme_color_mode_desc.user":  "使用用户选择的主题色作为整个桌面壳层的 Monet 种子色。",
+    "settings.appearance.theme_color_mode_desc.wallpaper":  "使用壁纸颜色。优先取应用壁纸，失败后回退系统桌面壁纸。",
+    "settings.appearance.theme_color_preview.app":  "当前正在预览从应用壁纸提取的颜色。",
+    "settings.appearance.theme_color_preview.system":  "当前正在预览从系统壁纸提取的颜色。",
+    "settings.appearance.theme_color_preview.fallback":  "没有可用壁纸，当前使用回退强调色。",
+    "component.color_scheme.follow_system":  "跟随系统配色",
+    "component.color_scheme.native":  "使用组件自定义配色",
+    "settings.appearance.system_material.none":  "无",
+    "settings.appearance.system_material.mica":  "Mica",
+    "settings.appearance.system_material.acrylic":  "Acrylic",
+    "settings.appearance.system_material_desc.switchable":  "将所选材质应用到窗口、Dock、状态栏和组件宿主背板。",
+    "settings.appearance.system_material_desc.fixed":  "当前系统仅提供这里列出的材质模式。",
+    "settings.appearance.restart_message":  "主题色来源和系统材质更改需要重启应用。",
+    "settings.appearance.preview.primary":  "主色",
+    "settings.appearance.preview.secondary":  "次色",
+    "settings.appearance.preview.tertiary":  "三次色",
+    "settings.appearance.preview.neutral":  "中性色",
+    "settings.appearance.preview.seed":  "种子色",
+    "settings.appearance.preview.neutral_light":  "白色",
+    "settings.appearance.preview.neutral_dark":  "黑色",
+    "settings.appearance.preview.apply_seed":  "应用",
+    "settings.appearance.preview.wallpaper_candidates":  "壁纸候选主题色",
+    "settings.appearance.preview.wallpaper_current":  "当前",
+    "settings.wallpaper.placement.fill":  "填充",
+    "settings.wallpaper.placement.fit":  "适应",
+    "settings.wallpaper.placement.stretch":  "拉伸",
+    "settings.wallpaper.placement.center":  "居中",
+    "settings.wallpaper.placement.tile":  "平铺",
+    "settings.status_bar.clock_format_label":  "时钟格式",
+    "settings.status_bar.clock_format.hm":  "时:分",
+    "settings.status_bar.clock_format.hms":  "时:分:秒",
+    "settings.components.title":  "组件",
+    "settings.components.description":  "调整组件布局与圆角设计。",
+    "settings.components.grid_header":  "网格设置",
+    "settings.components.header":  "网格设置",
+    "settings.components.short_side_label":  "短边格数",
+    "settings.components.edge_inset_label":  "屏幕边距",
+    "settings.components.spacing_label":  "组件间距",
+    "settings.components.spacing_compact":  "紧凑",
+    "settings.components.spacing_relaxed":  "宽松",
+    "settings.components.corner_radius.header":  "圆角设计",
+    "settings.components.corner_radius.label":  "组件圆角",
+    "settings.components.corner_radius.description":  "统一调整组件容器圆角，并随圆角增大同步扩展内部安全区。",
     "settings.update.title":  "更新",
     "settings.update.current_version_label":  "当前版本",
     "settings.update.latest_version_label":  "最新发布",
@@ -272,9 +365,42 @@
     "settings.about.render_mode.current_format":  "当前后端：{0}",
     "settings.about.render_mode.impl_format":  "运行时实现：{0}",
     "settings.about.render_mode.impl_unavailable":  "当前无法获取运行时实现信息。",
+    "settings.about.description":  "应用信息。",
+    "settings.update.description":  "检查更新、选择发布通道与下载源，并控制更新安装方式。",
+    "settings.update.status_card_title":  "更新状态",
+    "settings.update.status_card_description":  "检查新版本、查看发布信息，并在有更新时继续下载或安装。",
+    "settings.update.preferences_header":  "更新偏好",
+    "settings.update.preferences_description":  "选择发布通道、安装包下载源、安装方式以及下载并行线程数。",
+    "settings.update.last_checked_label":  "上次检查",
+    "settings.update.source_label":  "下载源",
+    "settings.update.source_github":  "GitHub",
+    "settings.update.source_ghproxy":  "gh-proxy",
+    "settings.update.source_github_desc":  "直接从 GitHub 下载发布安装包。",
+    "settings.update.source_ghproxy_desc":  "下载 GitHub 发布安装包时使用 gh-proxy 镜像。",
+    "settings.update.mode_label":  "更新模式",
+    "settings.update.mode_manual":  "手动更新",
+    "settings.update.mode_download_then_confirm":  "静默下载",
+    "settings.update.mode_silent_on_exit":  "静默安装",
+    "settings.update.mode_manual_desc":  "仅检查更新，何时下载和安装都由你决定。",
+    "settings.update.mode_download_then_confirm_desc":  "后台下载更新，下载完成后由你确认是否安装。",
+    "settings.update.mode_silent_on_exit_desc":  "后台下载更新，并在你下次退出应用时静默安装。",
+    "settings.update.channel_stable_desc":  "正式版以稳定性优先，适合大多数用户。",
+    "settings.update.channel_preview_desc":  "预览版可能包含更早的新功能，但稳定性可能较低。",
+    "settings.update.download_threads_label":  "下载线程数",
+    "settings.update.download_threads_desc":  "设置应用更新安装包使用的并行下载线程数。",
+    "settings.update.install_now_button":  "立即安装",
+    "settings.update.status_downloaded_confirm":  "更新已下载完成，请查看并选择安装时机。",
+    "settings.update.status_downloaded_exit":  "更新已下载完成，将在你退出应用时安装。",
+    "settings.about.app_info_header":  "应用信息",
+    "settings.about.update_header":  "更新",
+    "settings.about.version_label":  "版本",
+    "settings.about.codename_label":  "版本代号",
+    "settings.about.render_backend_label":  "渲染后端",
+    "settings.about.render_backend_format":  "渲染后端：{0}",
     "settings.restart_dialog.title":  "需要重启应用",
     "settings.restart_dialog.render_mode_message":  "需要重启应用，才能将渲染模式从“{0}”切换到“{1}”。是否现在重启？",
     "settings.restart_dialog.restart":  "立即重启",
+    "settings.restart_dialog.later":  "稍后",
     "settings.restart_dialog.cancel":  "取消",
     "settings.restart_dock.title":  "需要重启应用",
     "settings.restart_dock.description":  "部分更改需要在重启应用后才会生效。",
@@ -282,7 +408,6 @@
     "settings.footer":  "LanMountainDesktop 设置",
     "filepicker.title":  "选择壁纸",
     "filepicker.image_files":  "图片文件",
-    "filepicker.video_files":  "视频文件",
     "common.day":  "日间",
     "common.night":  "夜间",
     "common.back":  "返回",
@@ -292,6 +417,7 @@
     "common.monet":  "莫奈",
     "desktop.page_index_format":  "桌面 {0}",
     "launcher.title":  "应用启动台",
+    "launcher.folder": "文件夹",
     "launcher.subtitle":  "按 Windows 开始菜单结构显示所有应用与文件夹",
     "launcher.subtitle_linux":  "显示从 Linux .desktop 条目扫描到的已安装应用",
     "launcher.empty":  "未找到开始菜单条目。",
@@ -301,18 +427,34 @@
     "launcher.context.hide_icon":  "隐藏图标",
     "launcher.action.hide":  "隐藏",
     "settings.launcher.title":  "应用启动台",
+    "settings.launcher.description":  "管理应用启动台中已隐藏的应用与文件夹。",
     "settings.launcher.hidden_header":  "已隐藏项目",
     "settings.launcher.hidden_desc":  "查看已隐藏的启动台项目并重新显示。",
     "settings.launcher.hidden_hint":  "进入桌面编辑模式后，在启动台选中图标并点击“隐藏”，隐藏后的项目会显示在这里。",
     "settings.launcher.hidden_empty":  "暂无隐藏项目。",
+    "settings.launcher.hidden_summary_format":  "共 {0} 个隐藏项目",
     "settings.launcher.hidden_type_folder":  "文件夹",
-    "settings.launcher.hidden_type_shortcut":  "快捷方式",
+    "settings.launcher.hidden_type_shortcut":  "应用",
     "settings.launcher.restore_button":  "取消隐藏",
     "settings.plugins.title":  "插件",
     "settings.plugins.runtime_header":  "插件运行时",
     "settings.plugins.runtime_desc":  "查看插件运行时状态、加载结果与诊断信息。",
     "settings.plugins.runtime_hint":  "这里展示已安装插件的发现结果、加载状态和运行时诊断信息。",
     "settings.plugins.runtime_status":  "插件扫描完成后，运行时状态会显示在这里。",
+    "settings.plugins.description":  "管理已安装插件并查看其运行时状态。",
+    "settings.plugins.initial_status":  "刷新插件状态以查看最新的已安装插件。",
+    "settings.plugins.refresh_button":  "刷新插件",
+    "settings.plugins.refresh_success_installed_format":  "已加载 {0} 个已安装插件。",
+    "settings.plugins.refresh_success_format":  "已加载 {0} 个已安装插件和 {1} 个市场条目。",
+    "settings.plugins.refresh_failed":  "加载插件市场索引失败。",
+    "settings.plugins.marketplace_header":  "插件市场",
+    "settings.plugins.marketplace_empty":  "当前没有可用的市场插件。",
+    "settings.plugins.delete_button_short":  "删除",
+    "settings.plugins.install_button_short":  "安装",
+    "settings.plugins.restart_required":  "插件变更将在重启后生效。",
+    "settings.plugins.toggle_unchanged_format":  "插件“{0}”没有变化。",
+    "settings.plugins.delete_failed_name_format":  "移除插件“{0}”失败。",
+    "settings.plugins.install_failed_name_format":  "安装插件“{0}”失败。",
     "settings.plugins.installed_header":  "已安装插件",
     "settings.plugins.installed_desc":  "在这里查看和删除已安装的插件。",
     "settings.plugins.import_header":  "从安装包导入",
@@ -356,6 +498,12 @@
     "settings.plugin_market.title":  "插件市场",
     "settings.plugin_market.subtitle":  "浏览来自 LanAirApp 官方源的插件，并将安装暂存到本地。",
     "settings.plugin_market.unavailable":  "插件运行时不可用，暂时无法打开官方市场。",
+    "settings.update.status_idle":  "尚未执行更新检查。",
+    "settings.update.status_preferences_saved":  "更新偏好已保存。",
+    "settings.update.status_check_failed":  "检查更新失败。",
+    "settings.update.status_available_summary_format":  "发现更新：{0}（当前：{1}）。",
+    "settings.update.status_up_to_date_format":  "当前已是最新版本（{0}）。",
+    "settings.window.drawer_default":  "详情",
     "market.toolbar.search_placeholder":  "搜索插件",
     "market.toolbar.refresh":  "刷新",
     "market.status.loading":  "正在加载官方插件市场...",
@@ -372,7 +520,7 @@
     "market.card.loaded":  "已加载",
     "market.card.pending_restart":  "需要重启",
     "market.detail.placeholder":  "从左侧选择一个插件以查看详情。",
-    "market.detail.author":  "作者",
+    "market.detail.author":  "发行者",
     "market.detail.version":  "版本",
     "market.detail.api_version":  "API 版本",
     "market.detail.min_host_version":  "最低宿主版本",
@@ -391,6 +539,11 @@
     "market.detail.homepage":  "主页",
     "market.detail.repository":  "仓库",
     "market.detail.release_notes":  "发布说明",
+    "market.detail.dependencies":  "依赖项",
+    "market.detail.dependencies_empty":  "该插件没有声明 SharedContracts 依赖项。",
+    "market.detail.readme_loading":  "正在加载 README...",
+    "market.detail.readme_empty":  "README 为空。",
+    "market.detail.readme_error_format":  "README 加载失败：{0}",
     "market.detail.state.not_installed":  "未安装",
     "market.detail.state.update_available":  "可更新",
     "market.detail.state.installed":  "已安装",
@@ -399,6 +552,7 @@
     "market.button.update":  "更新",
     "market.button.installed":  "已安装",
     "market.button.installing":  "安装中...",
+    "market.button.restart":  "重启后应用",
     "button.component_library":  "桌面编辑",
     "tooltip.component_library":  "桌面编辑",
     "component_library.title":  "桌面编辑",
@@ -406,6 +560,12 @@
     "component_library.drag_hint":  "拖动放置",
     "component.delete":  "删除",
     "component.edit":  "编辑",
+    "component.editor.instance_scope": "设置仅对当前组件实例生效。",
+    "component.editor.info_header": "组件信息",
+    "component.editor.id_label": "组件 ID",
+    "component.editor.placement_label": "实例 ID",
+    "component.editor.scope_label": "作用域",
+    "component.editor.scope_instance": "实例级编辑器",
     "component_category.clock":  "时钟",
     "component_category.date":  "日历",
     "component_category.weather":  "天气",
@@ -414,6 +574,7 @@
     "component_category.info":  "信息推荐",
     "component_category.calculator":  "计算器",
     "component_category.study":  "自习",
+    "component_category.file":  "文件",
     "component.date":  "日历",
     "component.month_calendar":  "月历",
     "component.lunar_calendar":  "农历",
@@ -441,6 +602,19 @@
     "component.whiteboard":  "竖向小黑板",
     "component.blackboard_landscape":  "横向小黑板",
     "component.browser":  "浏览器",
+    "component.office_recent_documents":  "最近文档",
+    "whiteboard.settings.desc": "每个小黑板都会独立保存自己的笔记历史。",
+    "whiteboard.settings.retention.title": "笔记保留时间",
+    "whiteboard.settings.retention.desc": "选择这个小黑板在过期笔记被自动删除前，应当保留已保存笔记多久。",
+    "whiteboard.settings.retention.option": "{0} 天",
+    "whiteboard.settings.instance_scope": "这个保留时间设置会按每个小黑板组件实例单独存储。",
+    "office_recent_documents.settings.desc":  "选择此小组件需要扫描的 Windows 和 Office 最近文档来源。",
+    "office_recent_documents.settings.sources_title":  "最近文档来源",
+    "office_recent_documents.settings.sources_desc":  "可以同时选择多个来源。勾选注册表来源时，还会保留 Office interop 的 MRU 回退。",
+    "office_recent_documents.settings.source.registry":  "Office 注册表 MRU",
+    "office_recent_documents.settings.source.recent_folders":  "Windows 最近文件夹",
+    "office_recent_documents.settings.source.jump_lists":  "Windows 跳转列表",
+    "office_recent_documents.settings.hint":  "如果关闭全部来源，此小组件会保持空白，直到再次至少启用一个来源。",
     "component.holiday_calendar":  "节假日日历",
     "component.study_environment":  "环境",
     "component.study_session_control":  "自习时段控制",
@@ -637,6 +811,21 @@
     "study.environment.value.unavailable":  "--",
     "study.environment.value.display_format":  "{0:F1} dB",
     "study.environment.value.dbfs_format":  "{0:F1} dBFS",
+    "component.removable_storage":  "可移动存储",
+    "removable_storage.settings.desc":  "在桌面上显示已连接的 U 盘，并提供打开与弹出操作。",
+    "removable_storage.settings.behavior_title":  "行为",
+    "removable_storage.settings.behavior_desc":  "组件会自动监听可移动存储设备，并优先显示最新插入的 U 盘。",
+    "removable_storage.action.open":  "打开",
+    "removable_storage.action.eject":  "弹出",
+    "removable_storage.widget.default_name":  "可移动磁盘",
+    "removable_storage.widget.empty_title":  "未插入设备",
+    "removable_storage.widget.empty_subtitle":  "插入 U 盘后会自动显示在这里。",
+    "removable_storage.widget.empty_hint":  "在插入可移动设备之前，底部按钮会保持置灰不可点击。",
+    "removable_storage.widget.ready":  "已准备好，可直接打开或弹出。",
+    "removable_storage.widget.ejecting":  "正在弹出设备...",
+    "removable_storage.widget.eject_failed":  "无法弹出该设备，请先关闭正在占用它的文件后再试。",
+    "removable_storage.widget.open_failed":  "打开该设备失败。",
+    "removable_storage.widget.refresh_failed":  "刷新可移动存储列表失败。",
     "study.environment.settings.title":  "环境组件设置",
     "study.environment.settings.desc":  "配置右侧实时噪音值显示内容。",
     "study.environment.settings.show_display_db":  "显示 display dB",
@@ -746,7 +935,7 @@
     "placement.tile":  "平铺",
     "single_instance.notice.title":  "应用已经运行",
     "single_instance.notice.description":  "应用已经运行，无需多次点击打开。",
-    "single_instance.notice.button":  "确定"
+    "single_instance.notice.button":  "确定",
+    "market.status.install_success_restart_format":  "✓ 插件'{0}'安装成功！请重启应用以激活它。",
+    "market.dialog.restart_message_format":  "插件'{0}'已成功安装。\n\n要使用此插件，您需要立即重启应用。\n\n是否立即重启？"
   }
-
-

LanMountainDesktop/Models/AppSettingsSnapshot.cs

@@ -1,4 +1,5 @@
 using System.Collections.Generic;
+using LanMountainDesktop.Settings.Core;
 
 namespace LanMountainDesktop.Models;
 
@@ -14,8 +15,22 @@ public sealed class AppSettingsSnapshot
 
     public string? ThemeColor { get; set; }
 
+    public bool UseSystemChrome { get; set; }
+
+    public double GlobalCornerRadiusScale { get; set; } = GlobalAppearanceSettings.DefaultCornerRadiusScale;
+
+    public string ThemeColorMode { get; set; } = "default_neutral";
+
+    public string SystemMaterialMode { get; set; } = "none";
+
+    public string? SelectedWallpaperSeed { get; set; }
+
     public string? WallpaperPath { get; set; }
 
+    public string WallpaperType { get; set; } = "Image";
+
+    public string? WallpaperColor { get; set; }
+
     public string WallpaperPlacement { get; set; } = "Fill";
 
     public int SettingsTabIndex { get; set; } = 0;
@@ -42,7 +57,7 @@ public sealed class AppSettingsSnapshot
 
     public string WeatherExcludedAlerts { get; set; } = string.Empty;
 
-    public string WeatherIconPackId { get; set; } = "FluentRegular";
+    public string WeatherIconPackId { get; set; } = "HyperOS3";
 
     public bool WeatherNoTlsRequests { get; set; }
 
@@ -50,18 +65,37 @@ public sealed class AppSettingsSnapshot
 
     public string AppRenderMode { get; set; } = "Default";
 
-    public bool AutoCheckUpdates { get; set; } = true;
-
     public bool IncludePrereleaseUpdates { get; set; }
 
-    public string UpdateChannel { get; set; } = string.Empty;
+    public bool UploadAnonymousCrashData { get; set; }
+
+    public bool UploadAnonymousUsageData { get; set; }
+
+    public string? DeviceId { get; set; }
+
+    public string? PersistentUserId { get; set; }
+
+    public string UpdateChannel { get; set; } = "stable";
+
+    public string UpdateMode { get; set; } = "download_then_confirm";
+
+    public string UpdateDownloadSource { get; set; } = "github";
+
+    public int UpdateDownloadThreads { get; set; } = 4;
+
+    public string? PendingUpdateInstallerPath { get; set; }
+
+    public string? PendingUpdateVersion { get; set; }
+
+    public long? PendingUpdatePublishedAtUtcMs { get; set; }
+
+    public long? LastUpdateCheckUtcMs { get; set; }
 
     public List<string> TopStatusComponentIds { get; set; } = [];
 
     public List<string> PinnedTaskbarActions { get; set; } =
     [
-        TaskbarActionId.MinimizeToWindows.ToString(),
-        TaskbarActionId.OpenSettings.ToString()
+        TaskbarActionId.MinimizeToWindows.ToString()
     ];
 
     public bool EnableDynamicTaskbarActions { get; set; } = true;
@@ -70,6 +104,8 @@ public sealed class AppSettingsSnapshot
 
     public string ClockDisplayFormat { get; set; } = "HourMinuteSecond";
 
+    public bool StatusBarClockTransparentBackground { get; set; }
+
     public string StatusBarSpacingMode { get; set; } = "Relaxed";
 
     public int StatusBarCustomSpacingPercent { get; set; } = 12;

LanMountainDesktop/Models/ComponentSettingsSnapshot.cs

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

LanMountainDesktop/Models/MonetPalette.cs

@@ -1,8 +1,49 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 using Avalonia.Media;
 
 namespace LanMountainDesktop.Models;
 
-public sealed record MonetPalette(
-    IReadOnlyList<Color> RecommendedColors,
-    IReadOnlyList<Color> MonetColors);
+public sealed record MonetPalette
+{
+    public MonetPalette(
+        IReadOnlyList<Color> recommendedColors,
+        Color seed,
+        Color primary,
+        Color secondary,
+        Color tertiary,
+        Color neutral,
+        Color neutralVariant)
+    {
+        RecommendedColors = recommendedColors;
+        Seed = seed;
+        Primary = primary;
+        Secondary = secondary;
+        Tertiary = tertiary;
+        Neutral = neutral;
+        NeutralVariant = neutralVariant;
+        MonetColors =
+        [
+            primary,
+            secondary,
+            tertiary,
+            neutral,
+            neutralVariant
+        ];
+    }
+
+    public IReadOnlyList<Color> RecommendedColors { get; }
+
+    public IReadOnlyList<Color> MonetColors { get; }
+
+    public Color Seed { get; }
+
+    public Color Primary { get; }
+
+    public Color Secondary { get; }
+
+    public Color Tertiary { get; }
+
+    public Color Neutral { get; }
+
+    public Color NeutralVariant { get; }
+}

LanMountainDesktop/Models/OfficeRecentDocumentSourceTypes.cs

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

LanMountainDesktop/Models/TaskbarActionId.cs

@@ -1,12 +1,11 @@
-namespace LanMountainDesktop.Models;
+namespace LanMountainDesktop.Models;
 
 public enum TaskbarActionId
 {
     MinimizeToWindows,
-    OpenSettings,
     AddDesktopPage,
     DeleteDesktopPage,
-    DeleteComponent,
     EditComponent,
+    DeleteComponent,
     HideLauncherEntry
 }

LanMountainDesktop/Models/TaskbarContext.cs

@@ -2,11 +2,5 @@
 
 public enum TaskbarContext
 {
-    Desktop,
-    SettingsWallpaper,
-    SettingsGrid,
-    SettingsColor,
-    SettingsStatusBar,
-    SettingsWeather,
-    SettingsRegion
+    Desktop
 }

LanMountainDesktop/Models/WhiteboardNoteRetentionPolicy.cs

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

LanMountainDesktop/Models/WhiteboardNoteSnapshot.cs

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

LanMountainDesktop/Program.cs

@@ -4,20 +4,28 @@ using System.Threading;
 using System.Threading.Tasks;
 using Avalonia;
 using Avalonia.WebView.Desktop;
+using LanMountainDesktop.DesktopHost;
+using LanMountainDesktop.Models;
 using LanMountainDesktop.Services;
+using LanMountainDesktop.Services.Settings;
+using Sentry;
 
 namespace LanMountainDesktop;
 
 sealed class Program
 {
-    // Initialization code. Don't use any Avalonia, third-party APIs or any
-    // SynchronizationContext-reliant code before AppMain is called: things aren't initialized
-    // yet and stuff might break.
+    internal static string StartupRenderMode { get; private set; } = AppRenderingModeHelper.Default;
+
     [STAThread]
     public static void Main(string[] args)
     {
         AppLogger.Initialize();
         RegisterGlobalExceptionLogging();
+        DesktopBootstrap.InitializeStartupServices(
+            InitializeDeviceId,
+            InitializeCrashReporting,
+            InitializeUserBehaviorAnalytics,
+            ScheduleWhiteboardNoteStartupCleanup);
         var restartParentProcessId = AppRestartService.TryGetRestartParentProcessId(args);
 
         using var singleInstance = AcquireSingleInstance(restartParentProcessId);
@@ -42,8 +50,10 @@ sealed class Program
         try
         {
             var renderMode = LoadConfiguredRenderMode();
+            StartupRenderMode = renderMode;
             AppLogger.Info("Startup", $"Resolved render mode '{renderMode}'.");
             App.CurrentSingleInstanceService = singleInstance;
+            App.AnalyticsServices = (_userBehaviorAnalyticsService, _crashReportService);
             BuildAvaloniaApp(renderMode).StartWithClassicDesktopLifetime(args);
             AppLogger.Info("Startup", "Application exited normally.");
         }
@@ -58,7 +68,6 @@ sealed class Program
         }
     }
 
-    // Avalonia configuration, don't remove; also used by visual designer.
     public static AppBuilder BuildAvaloniaApp(string renderMode = AppRenderingModeHelper.Default)
     {
         var builder = AppBuilder.Configure<App>()
@@ -82,6 +91,25 @@ sealed class Program
         return builder;
     }
 
+    private static void ScheduleWhiteboardNoteStartupCleanup()
+    {
+        _ = Task.Run(() =>
+        {
+            try
+            {
+                var deletedCount = new WhiteboardNotePersistenceService().DeleteExpiredNotesBatch(batchSize: 512);
+                if (deletedCount > 0)
+                {
+                    AppLogger.Info("Startup", $"Deleted {deletedCount} expired whiteboard notes during startup maintenance.");
+                }
+            }
+            catch (Exception ex)
+            {
+                AppLogger.Warn("Startup", "Failed to run whiteboard note startup maintenance.", ex);
+            }
+        });
+    }
+
     private static SingleInstanceService AcquireSingleInstance(int? restartParentProcessId)
     {
         var singleInstance = SingleInstanceService.CreateDefault();
@@ -121,7 +149,10 @@ sealed class Program
     {
         try
         {
-            return AppRenderingModeHelper.Normalize(new AppSettingsService().Load().AppRenderMode);
+            var snapshot = HostSettingsFacadeProvider.GetOrCreate()
+                .Settings
+                .LoadSnapshot<AppSettingsSnapshot>(LanMountainDesktop.PluginSdk.SettingsScope.App);
+            return AppRenderingModeHelper.Normalize(snapshot.AppRenderMode);
         }
         catch (Exception ex)
         {
@@ -143,7 +174,6 @@ sealed class Program
         }
         catch (ArgumentException)
         {
-            // The previous process already exited before we started waiting.
         }
         catch (Exception ex)
         {
@@ -159,6 +189,11 @@ sealed class Program
                 "UnhandledException",
                 $"Unhandled exception. IsTerminating={eventArgs.IsTerminating}",
                 eventArgs.ExceptionObject as Exception);
+
+            if (eventArgs.IsTerminating)
+            {
+                SentrySdk.Flush(TimeSpan.FromSeconds(5));
+            }
         };
 
         TaskScheduler.UnobservedTaskException += (_, eventArgs) =>
@@ -167,4 +202,187 @@ sealed class Program
             eventArgs.SetObserved();
         };
     }
+
+    private static void InitializeDeviceId()
+    {
+        try
+        {
+            DeviceIdService.Initialize(HostSettingsFacadeProvider.GetOrCreate());
+            AppLogger.Info("Startup", $"DeviceId initialized: {DeviceIdService.Instance.DeviceId}");
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("Startup", "Failed to initialize DeviceIdService.", ex);
+        }
+    }
+
+    private static void InitializeSentryForAnalytics()
+    {
+        try
+        {
+            var deviceId = DeviceIdService.Instance.DeviceId;
+
+            SentrySdk.Init(options =>
+            {
+                options.Dsn = "https://f2aad3a1c63b5f2213ad82683ce93c06@o4511049423257600.ingest.us.sentry.io/4511049425813504";
+                options.AutoSessionTracking = true;
+                options.Release = GetAppVersion();
+                options.Environment = GetEnvironment();
+            });
+
+            SentrySdk.ConfigureScope(scope =>
+            {
+                scope.User = new SentryUser
+                {
+                    Id = deviceId
+                };
+
+                scope.SetTag("data_type", "analytics");
+                scope.SetTag("device_id", deviceId);
+                scope.SetTag("app_version", GetAppVersion());
+                scope.SetTag("os_name", GetOsName());
+                scope.SetTag("os_version", GetOsVersion());
+                scope.SetTag("os_build", GetOsBuild());
+                scope.SetTag("device_model", GetDeviceModel());
+                scope.SetTag("device_arch", GetDeviceArchitecture());
+                scope.SetTag("processor_count", GetProcessorCount().ToString());
+                scope.SetTag("total_memory_mb", GetTotalMemoryMB().ToString());
+                scope.SetTag("runtime_version", GetRuntimeVersion());
+                scope.SetTag("language", GetSystemLanguage());
+                scope.SetTag("clr_version", GetClrVersion());
+                scope.SetTag("is_64bit", Environment.Is64BitOperatingSystem.ToString());
+            });
+
+            SentrySdk.CaptureMessage("user_active");
+
+            AppLogger.Info("Startup", $"Analytics service initialized. DeviceId={deviceId}");
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("Startup", "Failed to initialize analytics service.", ex);
+        }
+    }
+
+    private static string GetAppVersion()
+    {
+        var version = typeof(Program).Assembly.GetName().Version;
+        return version is null ? "1.0.0" : $"{version.Major}.{version.Minor}.{version.Build}";
+    }
+
+    private static string GetOsName()
+    {
+        if (OperatingSystem.IsWindows()) return "Windows";
+        if (OperatingSystem.IsLinux()) return "Linux";
+        if (OperatingSystem.IsMacOS()) return "macOS";
+        return "Unknown";
+    }
+
+    private static string GetOsVersion()
+    {
+        try { return Environment.OSVersion.VersionString ?? "Unknown"; }
+        catch { return "Unknown"; }
+    }
+
+    private static string GetOsBuild()
+    {
+        try { return Environment.OSVersion.Version.Build.ToString() ?? "Unknown"; }
+        catch { return "Unknown"; }
+    }
+
+    private static string GetDeviceName()
+    {
+        try { return Environment.MachineName ?? "Unknown"; }
+        catch { return "Unknown"; }
+    }
+
+    private static string GetDeviceModel()
+    {
+        if (OperatingSystem.IsWindows()) return "Windows PC";
+        if (OperatingSystem.IsLinux()) return "Linux PC";
+        if (OperatingSystem.IsMacOS()) return "Mac";
+        return "Unknown";
+    }
+
+    private static string GetDeviceArchitecture()
+    {
+        return Environment.Is64BitOperatingSystem ? "x64" : "x86";
+    }
+
+    private static int GetProcessorCount()
+    {
+        return Environment.ProcessorCount;
+    }
+
+    private static long GetTotalMemoryMB()
+    {
+        try { return GC.GetGCMemoryInfo().TotalAvailableMemoryBytes / (1024 * 1024); }
+        catch { return 0; }
+    }
+
+    private static string GetRuntimeVersion()
+    {
+        return Environment.Version.ToString();
+    }
+
+    private static string GetSystemLanguage()
+    {
+        try { return System.Globalization.CultureInfo.CurrentUICulture.Name ?? "en-US"; }
+        catch { return "en-US"; }
+    }
+
+    private static string GetClrVersion()
+    {
+        return Environment.Version.ToString();
+    }
+
+    private static CrashReportService? _crashReportService;
+    private static UserBehaviorAnalyticsService? _userBehaviorAnalyticsService;
+
+    private static void InitializeCrashReporting()
+    {
+        try
+        {
+            var settingsFacade = HostSettingsFacadeProvider.GetOrCreate();
+            _crashReportService = new CrashReportService(settingsFacade, DeviceIdService.Instance);
+            _crashReportService.RefreshEnabledState();
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("Startup", "Failed to initialize crash reporting service.", ex);
+        }
+    }
+
+    private static void InitializeUserBehaviorAnalytics()
+    {
+        try
+        {
+            var settingsFacade = HostSettingsFacadeProvider.GetOrCreate();
+            _userBehaviorAnalyticsService = new UserBehaviorAnalyticsService(settingsFacade, DeviceIdService.Instance);
+            _userBehaviorAnalyticsService.Initialize();
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("Startup", "Failed to initialize user behavior analytics service.", ex);
+        }
+    }
+
+    private static string GetReleaseVersion()
+    {
+        var assembly = typeof(Program).Assembly;
+        var version = assembly.GetName().Version;
+        if (version is null)
+        {
+            return "1.0.0";
+        }
+        return version.Major >= 0 ? $"{version.Major}.{version.Minor}.{version.Build}" : "1.0.0";
+    }
+
+    private static string GetEnvironment()
+    {
+#if DEBUG
+        return "development";
+#else
+        return "production";
+#endif
+    }
 }

LanMountainDesktop/Services/AppDatabaseService.cs

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

LanMountainDesktop/Services/AppLogoService.cs

@@ -0,0 +1,72 @@
+using System;
+using Avalonia.Controls;
+using Avalonia.Platform;
+
+namespace LanMountainDesktop.Services;
+
+public enum AppLogoVariant
+{
+    Auto = 0,
+    Day = 1,
+    Night = 2
+}
+
+public interface IAppLogoService
+{
+    WindowIcon CreateWindowIcon(AppLogoVariant variant = AppLogoVariant.Auto);
+    WindowIcon CreateTrayIcon(AppLogoVariant variant = AppLogoVariant.Auto);
+    Uri GetVectorLogoUri(AppLogoVariant variant = AppLogoVariant.Auto);
+}
+
+internal sealed class AppLogoService : IAppLogoService
+{
+    private static readonly Uri NightVectorLogoUri = new("avares://LanMountainDesktop/Assets/logo_nightly.svg");
+    private static readonly Uri DayVectorLogoUri = new("avares://LanMountainDesktop/Assets/logo_nightly.svg");
+    private static readonly Uri NightIconUri = new("avares://LanMountainDesktop/Assets/logo_nightly.ico");
+    private static readonly Uri DayIconUri = new("avares://LanMountainDesktop/Assets/logo_nightly.ico");
+
+    public WindowIcon CreateWindowIcon(AppLogoVariant variant = AppLogoVariant.Auto) => CreateIcon(ResolveIconUri(variant));
+
+    public WindowIcon CreateTrayIcon(AppLogoVariant variant = AppLogoVariant.Auto) => CreateIcon(ResolveIconUri(variant));
+
+    public Uri GetVectorLogoUri(AppLogoVariant variant = AppLogoVariant.Auto) => ResolveVectorLogoUri(variant);
+
+    private static WindowIcon CreateIcon(Uri assetUri)
+    {
+        using var stream = AssetLoader.Open(assetUri);
+        return new WindowIcon(stream);
+    }
+
+    private static Uri ResolveIconUri(AppLogoVariant variant) => ResolveVariant(variant) switch
+    {
+        AppLogoVariant.Day => DayIconUri,
+        _ => NightIconUri
+    };
+
+    private static Uri ResolveVectorLogoUri(AppLogoVariant variant) => ResolveVariant(variant) switch
+    {
+        AppLogoVariant.Day => DayVectorLogoUri,
+        _ => NightVectorLogoUri
+    };
+
+    private static AppLogoVariant ResolveVariant(AppLogoVariant variant) => variant switch
+    {
+        AppLogoVariant.Day => AppLogoVariant.Day,
+        AppLogoVariant.Night => AppLogoVariant.Night,
+        _ => AppLogoVariant.Night
+    };
+}
+
+internal static class HostAppLogoProvider
+{
+    private static readonly object Gate = new();
+    private static IAppLogoService? _instance;
+
+    public static IAppLogoService GetOrCreate()
+    {
+        lock (Gate)
+        {
+            return _instance ??= new AppLogoService();
+        }
+    }
+}

LanMountainDesktop/Services/AppearanceThemeService.cs

@@ -0,0 +1,996 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.IO;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Avalonia;
+using Avalonia.Controls;
+using Avalonia.Media;
+using Avalonia.Styling;
+using Avalonia.Threading;
+using Avalonia.Media.Imaging;
+using LanMountainDesktop.Appearance;
+using LanMountainDesktop.Models;
+using LanMountainDesktop.PluginSdk;
+using LanMountainDesktop.Services.Settings;
+using LanMountainDesktop.Settings.Core;
+using LanMountainDesktop.Shared.Contracts;
+using LanMountainDesktop.Theme;
+using Microsoft.Win32;
+
+namespace LanMountainDesktop.Services;
+
+public enum MaterialSurfaceRole
+{
+    WindowBackground = 0,
+    SettingsWindowBackground = 1,
+    DockBackground = 2,
+    StatusBarBackground = 3,
+    DesktopComponentHost = 4,
+    StatusBarComponentHost = 5,
+    OverlayPanel = 6
+}
+
+public sealed record AppearanceMaterialSurface(
+    Color BackgroundColor,
+    Color BorderColor,
+    double BlurRadius,
+    double Opacity);
+
+public sealed record AppearanceThemeSnapshot(
+    bool IsNightMode,
+    string ThemeColorMode,
+    string? UserThemeColor,
+    string? SelectedWallpaperSeed,
+    double GlobalCornerRadiusScale,
+    AppearanceCornerRadiusTokens CornerRadiusTokens,
+    string ResolvedSeedSource,
+    MonetPalette MonetPalette,
+    Color AccentColor,
+    Color EffectiveSeedColor,
+    IReadOnlyList<Color> WallpaperSeedCandidates,
+    string SystemMaterialMode,
+    IReadOnlyList<string> AvailableSystemMaterialModes,
+    bool CanChangeSystemMaterial,
+    bool UseSystemChrome,
+    string? ResolvedWallpaperPath);
+
+public interface IAppearanceThemeService
+{
+    AppearanceThemeSnapshot GetCurrent();
+
+    AppearanceThemeSnapshot BuildPreview(ThemeAppearanceSettingsState pendingState);
+
+    event EventHandler<AppearanceThemeSnapshot>? Changed;
+
+    void ApplyThemeResources(IResourceDictionary resources);
+
+    AppearanceMaterialSurface GetMaterialSurface(MaterialSurfaceRole role);
+
+    void ApplyWindowMaterial(Window window, MaterialSurfaceRole role);
+}
+
+internal interface ISystemWallpaperService
+{
+    bool IsSupported { get; }
+
+    string? GetWallpaperPath();
+}
+
+internal interface IWindowMaterialService
+{
+    IReadOnlyList<string> GetAvailableModes();
+
+    bool CanChangeMode { get; }
+
+    void Apply(Window window, string materialMode);
+}
+
+internal interface IMaterialSurfaceService
+{
+    AppearanceMaterialSurface GetSurface(ThemeColorContext context, MaterialSurfaceRole role);
+}
+
+internal readonly record struct WallpaperSeedSourceDescriptor(
+    string SourceKind,
+    string SourceKey,
+    string? ResolvedWallpaperPath,
+    string? FilePath,
+    Color? SolidColor);
+
+internal sealed record WallpaperSeedExtractionResult(
+    string SourceKind,
+    string SourceKey,
+    string? ResolvedWallpaperPath,
+    IReadOnlyList<Color> SeedCandidates);
+
+internal readonly record struct WallpaperPaletteResolution(
+    MonetPalette Palette,
+    IReadOnlyList<Color> SeedCandidates,
+    string ResolvedSeedSource,
+    Color EffectiveSeedColor,
+    string? ResolvedWallpaperPath);
+
+internal sealed class SystemWallpaperService : ISystemWallpaperService
+{
+    public bool IsSupported => OperatingSystem.IsWindows();
+
+    public string? GetWallpaperPath()
+    {
+        if (!OperatingSystem.IsWindows())
+        {
+            return null;
+        }
+
+        try
+        {
+            using var key = Registry.CurrentUser.OpenSubKey(@"Control Panel\Desktop", writable: false);
+            var wallpaperPath = key?.GetValue("WallPaper") as string;
+            return string.IsNullOrWhiteSpace(wallpaperPath) || !File.Exists(wallpaperPath)
+                ? null
+                : wallpaperPath;
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("Appearance.SystemWallpaper", "Failed to resolve the current system wallpaper path.", ex);
+            return null;
+        }
+    }
+}
+
+internal sealed class WindowMaterialService : IWindowMaterialService
+{
+    private const int Windows11Build = 22000;
+    private const int Windows11_24H2Build = 26100;
+
+    public bool CanChangeMode => GetSupportProfile() == WindowMaterialSupportProfile.FullSwitching;
+
+    public IReadOnlyList<string> GetAvailableModes()
+    {
+        return GetSupportProfile() switch
+        {
+            WindowMaterialSupportProfile.FullSwitching =>
+            [
+                ThemeAppearanceValues.MaterialNone,
+                ThemeAppearanceValues.MaterialMica,
+                ThemeAppearanceValues.MaterialAcrylic
+            ],
+            WindowMaterialSupportProfile.FixedMica =>
+            [
+                ThemeAppearanceValues.MaterialNone,
+                ThemeAppearanceValues.MaterialMica
+            ],
+            WindowMaterialSupportProfile.FixedAcrylic =>
+            [
+                ThemeAppearanceValues.MaterialNone,
+                ThemeAppearanceValues.MaterialAcrylic
+            ],
+            _ =>
+            [
+                ThemeAppearanceValues.MaterialNone
+            ]
+        };
+    }
+
+    public void Apply(Window window, string materialMode)
+    {
+        ArgumentNullException.ThrowIfNull(window);
+
+        var normalizedMode = ThemeAppearanceValues.NormalizeSystemMaterialMode(materialMode);
+
+        if (normalizedMode == ThemeAppearanceValues.MaterialNone)
+        {
+            window.Background = Brushes.White;
+            window.TransparencyLevelHint = [WindowTransparencyLevel.None];
+            return;
+        }
+
+        window.Background = Brushes.Transparent;
+
+        if (!OperatingSystem.IsWindows() || !IsTransparencyEnabled())
+        {
+            window.TransparencyLevelHint =
+            [
+                WindowTransparencyLevel.None
+            ];
+            return;
+        }
+
+        window.TransparencyLevelHint = normalizedMode switch
+        {
+            ThemeAppearanceValues.MaterialMica =>
+            [
+                WindowTransparencyLevel.Mica,
+                WindowTransparencyLevel.Blur,
+                WindowTransparencyLevel.None
+            ],
+            ThemeAppearanceValues.MaterialAcrylic =>
+            [
+                WindowTransparencyLevel.AcrylicBlur,
+                WindowTransparencyLevel.Blur,
+                WindowTransparencyLevel.None
+            ],
+            _ =>
+            [
+                WindowTransparencyLevel.None
+            ]
+        };
+    }
+
+    private static bool IsTransparencyEnabled()
+    {
+        if (!OperatingSystem.IsWindows())
+        {
+            return false;
+        }
+
+        try
+        {
+            using var key = Registry.CurrentUser.OpenSubKey(
+                @"Software\Microsoft\Windows\CurrentVersion\Themes\Personalize",
+                writable: false);
+            var value = key?.GetValue("EnableTransparency");
+            return value switch
+            {
+                int intValue => intValue != 0,
+                byte byteValue => byteValue != 0,
+                _ => true
+            };
+        }
+        catch
+        {
+            return true;
+        }
+    }
+
+    private static WindowMaterialSupportProfile GetSupportProfile()
+    {
+        if (!OperatingSystem.IsWindows() || !IsTransparencyEnabled())
+        {
+            return WindowMaterialSupportProfile.NoneOnly;
+        }
+
+        if (OperatingSystem.IsWindowsVersionAtLeast(10, 0, Windows11_24H2Build))
+        {
+            return WindowMaterialSupportProfile.FullSwitching;
+        }
+
+        if (OperatingSystem.IsWindowsVersionAtLeast(10, 0, Windows11Build))
+        {
+            return WindowMaterialSupportProfile.FixedMica;
+        }
+
+        if (OperatingSystem.IsWindowsVersionAtLeast(10, 0))
+        {
+            return WindowMaterialSupportProfile.FixedAcrylic;
+        }
+
+        return WindowMaterialSupportProfile.NoneOnly;
+    }
+
+    private enum WindowMaterialSupportProfile
+    {
+        NoneOnly = 0,
+        FixedMica = 1,
+        FixedAcrylic = 2,
+        FullSwitching = 3
+    }
+}
+
+internal sealed class MaterialSurfaceService : IMaterialSurfaceService
+{
+    public AppearanceMaterialSurface GetSurface(ThemeColorContext context, MaterialSurfaceRole role)
+    {
+        var monetPalette = context.MonetPalette;
+        var monetColors = context.MonetColors?.Where(color => color.A > 0).ToArray() ?? [];
+        var primary = context.UseNeutralSurfaces
+            ? context.AccentColor
+            : monetPalette?.Primary ?? (monetColors.Length > 0 ? monetColors[0] : context.AccentColor);
+        var secondary = monetPalette?.Secondary
+            ?? (monetColors.Length > 1
+                ? monetColors[1]
+                : ColorMath.Blend(primary, Color.Parse("#FFFFFFFF"), 0.14));
+        var neutralPrimary = monetPalette?.Neutral
+            ?? (monetColors.Length > 3
+                ? monetColors[3]
+                : ResolveNeutralBase(context.IsNightMode, role));
+        var neutralSecondary = monetPalette?.NeutralVariant
+            ?? (monetColors.Length > 4
+                ? monetColors[4]
+                : ResolveLiftBase(context.IsNightMode, role));
+        var materialMode = ThemeAppearanceValues.NormalizeSystemMaterialMode(context.SystemMaterialMode);
+
+        var (tintStrength, liftStrength, alpha, blurRadius) = ResolveModeParameters(materialMode, role, context.IsNightMode);
+        var neutralBase = ResolveNeutralBase(context.IsNightMode, role);
+        var neutralLift = ResolveLiftBase(context.IsNightMode, role);
+        var isDockLike = role is MaterialSurfaceRole.DockBackground;
+        var isComponentLike = role is MaterialSurfaceRole.DesktopComponentHost or MaterialSurfaceRole.StatusBarComponentHost;
+        var baseMix = isDockLike ? 0.88 : isComponentLike ? 0.74 : 0.82;
+        var liftMix = isDockLike ? 0.58 : isComponentLike ? 0.34 : 0.46;
+        var neutralMix = isDockLike ? 0.22 : 0.16;
+
+        var background = ColorMath.Blend(neutralBase, neutralPrimary, baseMix);
+        background = ColorMath.Blend(background, neutralLift, liftMix);
+        background = ColorMath.Blend(background, neutralSecondary, neutralMix);
+        if (!context.UseNeutralSurfaces)
+        {
+            background = ColorMath.Blend(background, primary, tintStrength);
+            background = ColorMath.Blend(background, secondary, liftStrength);
+        }
+
+        if (isDockLike && !context.IsNightMode)
+        {
+            background = ColorMath.Blend(background, Color.Parse("#FFFFFFFF"), 0.12);
+        }
+
+        background = Color.FromArgb(alpha, background.R, background.G, background.B);
+
+        var borderSeed = context.IsNightMode
+            ? ColorMath.Blend(neutralSecondary, Color.Parse("#FFFFFFFF"), 0.16)
+            : ColorMath.Blend(neutralSecondary, Color.Parse("#FF334155"), 0.08);
+        if (!context.UseNeutralSurfaces && !isComponentLike)
+        {
+            borderSeed = ColorMath.Blend(borderSeed, primary, 0.08);
+        }
+
+        var borderAlpha = role switch
+        {
+            MaterialSurfaceRole.DockBackground => context.IsNightMode ? (byte)0x34 : (byte)0x18,
+            MaterialSurfaceRole.DesktopComponentHost or MaterialSurfaceRole.StatusBarComponentHost =>
+                context.IsNightMode ? (byte)0x18 : (byte)0x10,
+            MaterialSurfaceRole.StatusBarBackground => (byte)0x00,
+            _ => context.IsNightMode ? (byte)0x26 : (byte)0x16
+        };
+        var border = ColorMath.WithAlpha(borderSeed, borderAlpha);
+
+        return new AppearanceMaterialSurface(background, border, blurRadius, 1.0);
+    }
+
+    private static (double TintStrength, double LiftStrength, byte Alpha, double BlurRadius) ResolveModeParameters(
+        string materialMode,
+        MaterialSurfaceRole role,
+        bool isNightMode)
+    {
+        var isOverlay = role is MaterialSurfaceRole.DockBackground or MaterialSurfaceRole.StatusBarBackground or MaterialSurfaceRole.OverlayPanel;
+        return materialMode switch
+        {
+            ThemeAppearanceValues.MaterialAcrylic => (
+                isOverlay ? 0.30 : 0.20,
+                isOverlay ? 0.22 : 0.14,
+                isNightMode ? (byte)0xD8 : (byte)0xE0,
+                isOverlay ? 36 : 28),
+            ThemeAppearanceValues.MaterialMica => (
+                isOverlay ? 0.20 : 0.14,
+                isOverlay ? 0.12 : 0.08,
+                isNightMode ? (byte)0xEC : (byte)0xF2,
+                isOverlay ? 28 : 20),
+            _ => (
+                isOverlay ? 0.12 : 0.08,
+                isOverlay ? 0.08 : 0.05,
+                (byte)0xFF,
+                0)
+        };
+    }
+
+    private static Color ResolveNeutralBase(bool isNightMode, MaterialSurfaceRole role)
+    {
+        return role switch
+        {
+            MaterialSurfaceRole.WindowBackground => isNightMode ? Color.Parse("#FF0A0F16") : Color.Parse("#FFF7F8FA"),
+            MaterialSurfaceRole.SettingsWindowBackground => isNightMode ? Color.Parse("#FF0C121A") : Color.Parse("#FFF8FAFC"),
+            MaterialSurfaceRole.DockBackground => isNightMode ? Color.Parse("#FF111A24") : Color.Parse("#FFFAFBFD"),
+            MaterialSurfaceRole.StatusBarBackground => isNightMode ? Color.Parse("#FF101720") : Color.Parse("#FFF9FBFE"),
+            MaterialSurfaceRole.StatusBarComponentHost => isNightMode ? Color.Parse("#FF111A23") : Color.Parse("#FFFCFDFE"),
+            MaterialSurfaceRole.OverlayPanel => isNightMode ? Color.Parse("#FF131C27") : Color.Parse("#FFF4F7FB"),
+            _ => isNightMode ? Color.Parse("#FF121B26") : Color.Parse("#FFFDFEFF")
+        };
+    }
+
+    private static Color ResolveLiftBase(bool isNightMode, MaterialSurfaceRole role)
+    {
+        return role switch
+        {
+            MaterialSurfaceRole.DockBackground or MaterialSurfaceRole.StatusBarBackground or MaterialSurfaceRole.OverlayPanel =>
+                isNightMode ? Color.Parse("#FF1B2633") : Color.Parse("#FFFFFFFF"),
+            _ => isNightMode ? Color.Parse("#FF17212D") : Color.Parse("#FFFFFFFF")
+        };
+    }
+}
+
+internal sealed class AppearanceThemeService : IAppearanceThemeService, IDisposable
+{
+    private static readonly Color DefaultAccentColor = Color.Parse("#FF3B82F6");
+    private static readonly Color NeutralFallbackSeedColor = Color.Parse("#FF8A8A8A");
+    private readonly ISettingsFacadeService _settingsFacade;
+    private readonly ISystemWallpaperService _systemWallpaperService;
+    private readonly IWindowMaterialService _windowMaterialService;
+    private readonly IMaterialSurfaceService _materialSurfaceService;
+    private readonly MonetColorService _monetColorService = new();
+    private readonly string _liveThemeColorMode;
+    private readonly string _liveSystemMaterialMode;
+    private readonly string? _liveSelectedWallpaperSeed;
+    private readonly object _paletteGate = new();
+    private readonly Dictionary<string, WallpaperSeedExtractionResult> _wallpaperSeedCache = new(StringComparer.OrdinalIgnoreCase);
+    private readonly HashSet<string> _pendingWallpaperSeedKeys = new(StringComparer.OrdinalIgnoreCase);
+
+    public AppearanceThemeService(
+        ISettingsFacadeService settingsFacade,
+        ISystemWallpaperService systemWallpaperService,
+        IWindowMaterialService windowMaterialService,
+        IMaterialSurfaceService materialSurfaceService)
+    {
+        _settingsFacade = settingsFacade ?? throw new ArgumentNullException(nameof(settingsFacade));
+        _systemWallpaperService = systemWallpaperService ?? throw new ArgumentNullException(nameof(systemWallpaperService));
+        _windowMaterialService = windowMaterialService ?? throw new ArgumentNullException(nameof(windowMaterialService));
+        _materialSurfaceService = materialSurfaceService ?? throw new ArgumentNullException(nameof(materialSurfaceService));
+        var initialThemeState = _settingsFacade.Theme.Get();
+        _liveThemeColorMode = ThemeAppearanceValues.NormalizeThemeColorMode(
+            initialThemeState.ThemeColorMode,
+            initialThemeState.ThemeColor);
+        _liveSystemMaterialMode = ResolveSupportedMaterialMode(initialThemeState.SystemMaterialMode);
+        _liveSelectedWallpaperSeed = initialThemeState.SelectedWallpaperSeed;
+        _settingsFacade.Settings.Changed += OnSettingsChanged;
+    }
+
+    public event EventHandler<AppearanceThemeSnapshot>? Changed;
+
+    public AppearanceThemeSnapshot GetCurrent()
+    {
+        return BuildCurrentSnapshot(queueWallpaperPaletteBuild: true);
+    }
+
+    public AppearanceThemeSnapshot BuildPreview(ThemeAppearanceSettingsState pendingState)
+    {
+        ArgumentNullException.ThrowIfNull(pendingState);
+
+        var normalizedThemeColorMode = ThemeAppearanceValues.NormalizeThemeColorMode(
+            pendingState.ThemeColorMode,
+            pendingState.ThemeColor);
+        var normalizedSystemMaterialMode = ResolveSupportedMaterialMode(pendingState.SystemMaterialMode);
+        return BuildSnapshot(
+            pendingState with
+            {
+                ThemeColorMode = normalizedThemeColorMode,
+                SystemMaterialMode = normalizedSystemMaterialMode
+            },
+            normalizedThemeColorMode,
+            normalizedSystemMaterialMode,
+            pendingState.SelectedWallpaperSeed,
+            queueWallpaperPaletteBuild: true);
+    }
+
+    public void ApplyThemeResources(IResourceDictionary resources)
+    {
+        ArgumentNullException.ThrowIfNull(resources);
+
+        var snapshot = GetCurrent();
+        var context = CreateThemeContext(snapshot);
+        ThemeColorSystemService.ApplyThemeResources(resources, context);
+        GlassEffectService.ApplyGlassResources(resources, context);
+        resources["DesignCornerRadiusMicro"] = snapshot.CornerRadiusTokens.Micro;
+        resources["DesignCornerRadiusXs"] = snapshot.CornerRadiusTokens.Xs;
+        resources["DesignCornerRadiusSm"] = snapshot.CornerRadiusTokens.Sm;
+        resources["DesignCornerRadiusMd"] = snapshot.CornerRadiusTokens.Md;
+        resources["DesignCornerRadiusLg"] = snapshot.CornerRadiusTokens.Lg;
+        resources["DesignCornerRadiusXl"] = snapshot.CornerRadiusTokens.Xl;
+        resources["DesignCornerRadiusIsland"] = snapshot.CornerRadiusTokens.Island;
+    }
+
+    public AppearanceMaterialSurface GetMaterialSurface(MaterialSurfaceRole role)
+    {
+        var snapshot = GetCurrent();
+        return _materialSurfaceService.GetSurface(CreateThemeContext(snapshot), role);
+    }
+
+    public void ApplyWindowMaterial(Window window, MaterialSurfaceRole role)
+    {
+        ArgumentNullException.ThrowIfNull(window);
+
+        // Avoid hot-switching real backdrops on already-visible windows. This has been
+        // a stability hotspot when users flip theme source/material at runtime.
+        if (window.IsVisible)
+        {
+            return;
+        }
+
+        var snapshot = GetCurrent();
+
+        try
+        {
+            _windowMaterialService.Apply(window, snapshot.SystemMaterialMode);
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn(
+                "Appearance.WindowMaterial",
+                $"Failed to apply window material '{snapshot.SystemMaterialMode}'. Falling back to none.",
+                ex);
+            _windowMaterialService.Apply(window, ThemeAppearanceValues.MaterialNone);
+        }
+    }
+
+    public void Dispose()
+    {
+        _settingsFacade.Settings.Changed -= OnSettingsChanged;
+    }
+
+    private AppearanceThemeSnapshot BuildCurrentSnapshot(bool queueWallpaperPaletteBuild)
+    {
+        var themeState = _settingsFacade.Theme.Get();
+        return BuildSnapshot(
+            themeState,
+            _liveThemeColorMode,
+            _liveSystemMaterialMode,
+            _liveSelectedWallpaperSeed,
+            queueWallpaperPaletteBuild);
+    }
+
+    private void OnSettingsChanged(object? sender, SettingsChangedEvent e)
+    {
+        _ = sender;
+
+        if (e.Scope != SettingsScope.App)
+        {
+            return;
+        }
+
+        var changedKeys = e.ChangedKeys?.ToArray();
+        var refreshAll = changedKeys is null || changedKeys.Length == 0;
+        var respondsToThemeColor = string.Equals(
+            _liveThemeColorMode,
+            ThemeAppearanceValues.ColorModeSeedMonet,
+            StringComparison.OrdinalIgnoreCase);
+        var respondsToWallpaper = string.Equals(
+            _liveThemeColorMode,
+            ThemeAppearanceValues.ColorModeWallpaperMonet,
+            StringComparison.OrdinalIgnoreCase);
+
+        if (!refreshAll &&
+            !changedKeys.Contains(nameof(AppSettingsSnapshot.IsNightMode), StringComparer.OrdinalIgnoreCase) &&
+            !changedKeys.Contains(nameof(AppSettingsSnapshot.UseSystemChrome), StringComparer.OrdinalIgnoreCase) &&
+            !changedKeys.Contains(nameof(AppSettingsSnapshot.GlobalCornerRadiusScale), StringComparer.OrdinalIgnoreCase) &&
+            !(respondsToThemeColor &&
+              changedKeys.Contains(nameof(AppSettingsSnapshot.ThemeColor), StringComparer.OrdinalIgnoreCase)) &&
+            !(respondsToWallpaper &&
+              (changedKeys.Contains(nameof(AppSettingsSnapshot.WallpaperPath), StringComparer.OrdinalIgnoreCase) ||
+               changedKeys.Contains(nameof(AppSettingsSnapshot.WallpaperType), StringComparer.OrdinalIgnoreCase) ||
+               changedKeys.Contains(nameof(AppSettingsSnapshot.WallpaperColor), StringComparer.OrdinalIgnoreCase))))
+        {
+            return;
+        }
+
+        RaiseChanged(queueWallpaperPaletteBuild: true);
+    }
+
+    private AppearanceThemeSnapshot BuildSnapshot(
+        ThemeAppearanceSettingsState themeState,
+        string themeColorMode,
+        string systemMaterialMode,
+        string? selectedWallpaperSeed,
+        bool queueWallpaperPaletteBuild)
+    {
+        var availableModes = _windowMaterialService.GetAvailableModes();
+        var globalCornerRadiusScale = GlobalAppearanceSettings.NormalizeCornerRadiusScale(themeState.GlobalCornerRadiusScale);
+        var cornerRadiusTokens = AppearanceCornerRadiusTokenFactory.Create(globalCornerRadiusScale);
+        MonetPalette palette;
+        IReadOnlyList<Color> wallpaperSeedCandidates;
+        Color effectiveSeedColor;
+        string resolvedSeedSource;
+        string? resolvedWallpaperPath;
+
+        if (string.Equals(themeColorMode, ThemeAppearanceValues.ColorModeWallpaperMonet, StringComparison.OrdinalIgnoreCase))
+        {
+            var wallpaperState = _settingsFacade.Wallpaper.Get();
+            var wallpaperResolution = ResolveWallpaperPalette(
+                themeState.IsNightMode,
+                wallpaperState,
+                selectedWallpaperSeed,
+                queueWallpaperPaletteBuild);
+            palette = wallpaperResolution.Palette;
+            wallpaperSeedCandidates = wallpaperResolution.SeedCandidates;
+            effectiveSeedColor = wallpaperResolution.EffectiveSeedColor;
+            resolvedSeedSource = wallpaperResolution.ResolvedSeedSource;
+            resolvedWallpaperPath = wallpaperResolution.ResolvedWallpaperPath;
+        }
+        else
+        {
+            var preferredSeedColor = string.Equals(themeColorMode, ThemeAppearanceValues.ColorModeSeedMonet, StringComparison.OrdinalIgnoreCase)
+                ? themeState.ThemeColor
+                : null;
+            palette = _settingsFacade.Theme.BuildPalette(themeState.IsNightMode, null, preferredSeedColor);
+            wallpaperSeedCandidates = [];
+            effectiveSeedColor = ResolveEffectiveSeedColor(themeColorMode, themeState.ThemeColor, palette);
+            resolvedSeedSource = string.Equals(themeColorMode, ThemeAppearanceValues.ColorModeDefaultNeutral, StringComparison.OrdinalIgnoreCase)
+                ? "neutral"
+                : "user_color";
+            resolvedWallpaperPath = null;
+        }
+
+        return new AppearanceThemeSnapshot(
+            themeState.IsNightMode,
+            themeColorMode,
+            themeState.ThemeColor,
+            selectedWallpaperSeed,
+            globalCornerRadiusScale,
+            cornerRadiusTokens,
+            resolvedSeedSource,
+            palette,
+            ResolveAccentColor(themeColorMode, themeState.ThemeColor, palette),
+            effectiveSeedColor,
+            wallpaperSeedCandidates,
+            systemMaterialMode,
+            availableModes,
+            _windowMaterialService.CanChangeMode,
+            themeState.UseSystemChrome,
+            resolvedWallpaperPath);
+    }
+
+    private ThemeColorContext CreateThemeContext(AppearanceThemeSnapshot snapshot)
+    {
+        return new ThemeColorContext(
+            snapshot.AccentColor,
+            IsLightBackground: !snapshot.IsNightMode,
+            IsLightNavBackground: !snapshot.IsNightMode,
+            IsNightMode: snapshot.IsNightMode,
+            MonetPalette: snapshot.MonetPalette,
+            MonetColors: snapshot.MonetPalette.MonetColors,
+            UseNeutralSurfaces: snapshot.ThemeColorMode == ThemeAppearanceValues.ColorModeDefaultNeutral,
+            SystemMaterialMode: snapshot.SystemMaterialMode);
+    }
+
+    private string ResolveSupportedMaterialMode(string? requestedMode)
+    {
+        var normalized = ThemeAppearanceValues.NormalizeSystemMaterialMode(requestedMode);
+        var availableModes = _windowMaterialService.GetAvailableModes();
+        return availableModes.Contains(normalized, StringComparer.OrdinalIgnoreCase)
+            ? normalized
+            : ThemeAppearanceValues.MaterialNone;
+    }
+
+    private WallpaperPaletteResolution ResolveWallpaperPalette(
+        bool nightMode,
+        WallpaperSettingsState wallpaperState,
+        string? selectedWallpaperSeed,
+        bool queueWallpaperPaletteBuild)
+    {
+        var source = ResolveWallpaperSeedSource(wallpaperState);
+        if (string.Equals(source.SourceKind, "fallback", StringComparison.OrdinalIgnoreCase))
+        {
+            return BuildFallbackWallpaperPaletteResolution(nightMode, source.ResolvedWallpaperPath);
+        }
+
+        if (string.Equals(source.SourceKind, "app_solid", StringComparison.OrdinalIgnoreCase))
+        {
+            var candidates = source.SolidColor is { } solidColor
+                ? new[] { solidColor }
+                : [];
+            return BuildWallpaperPaletteResolution(nightMode, source, candidates, selectedWallpaperSeed);
+        }
+
+        lock (_paletteGate)
+        {
+            if (_wallpaperSeedCache.TryGetValue(source.SourceKey, out var cachedSeedResult))
+            {
+                if (cachedSeedResult.SeedCandidates.Count > 0)
+                {
+                    return BuildWallpaperPaletteResolution(
+                        nightMode,
+                        source with
+                        {
+                            SourceKind = cachedSeedResult.SourceKind,
+                            ResolvedWallpaperPath = cachedSeedResult.ResolvedWallpaperPath
+                        },
+                        cachedSeedResult.SeedCandidates,
+                        selectedWallpaperSeed);
+                }
+
+                return BuildFallbackWallpaperPaletteResolution(nightMode, cachedSeedResult.ResolvedWallpaperPath);
+            }
+        }
+
+        if (queueWallpaperPaletteBuild)
+        {
+            QueueWallpaperSeedExtraction(source);
+        }
+
+        return BuildFallbackWallpaperPaletteResolution(nightMode, source.ResolvedWallpaperPath);
+    }
+
+    private static Color ResolveAccentColor(
+        string themeColorMode,
+        string? colorText,
+        MonetPalette monetPalette)
+    {
+        if (themeColorMode == ThemeAppearanceValues.ColorModeDefaultNeutral)
+        {
+            return DefaultAccentColor;
+        }
+
+        if (monetPalette.Primary.A > 0)
+        {
+            return monetPalette.Primary;
+        }
+
+        if (!string.IsNullOrWhiteSpace(colorText) && Color.TryParse(colorText, out var parsedColor))
+        {
+            return parsedColor;
+        }
+
+        return DefaultAccentColor;
+    }
+
+    private static Color ResolveEffectiveSeedColor(
+        string themeColorMode,
+        string? userThemeColor,
+        MonetPalette monetPalette)
+    {
+        if (themeColorMode == ThemeAppearanceValues.ColorModeDefaultNeutral)
+        {
+            return DefaultAccentColor;
+        }
+
+        if (themeColorMode == ThemeAppearanceValues.ColorModeSeedMonet &&
+            !string.IsNullOrWhiteSpace(userThemeColor) &&
+            Color.TryParse(userThemeColor, out var parsedColor))
+        {
+            return parsedColor;
+        }
+
+        return monetPalette.Seed;
+    }
+
+    private WallpaperPaletteResolution BuildWallpaperPaletteResolution(
+        bool nightMode,
+        WallpaperSeedSourceDescriptor source,
+        IReadOnlyList<Color> seedCandidates,
+        string? selectedWallpaperSeed)
+    {
+        var validatedSeed = ResolveSelectedWallpaperSeed(seedCandidates, selectedWallpaperSeed);
+        var palette = _monetColorService.BuildPaletteFromSeedCandidates(seedCandidates, nightMode, validatedSeed);
+        return new WallpaperPaletteResolution(
+            palette,
+            seedCandidates,
+            source.SourceKind,
+            palette.Seed,
+            source.ResolvedWallpaperPath);
+    }
+
+    private WallpaperPaletteResolution BuildFallbackWallpaperPaletteResolution(bool nightMode, string? resolvedWallpaperPath)
+    {
+        var palette = _monetColorService.BuildPaletteFromSeedCandidates([], nightMode, NeutralFallbackSeedColor);
+        return new WallpaperPaletteResolution(
+            palette,
+            [],
+            "fallback",
+            palette.Seed,
+            resolvedWallpaperPath);
+    }
+
+    private void QueueWallpaperSeedExtraction(WallpaperSeedSourceDescriptor source)
+    {
+        if (string.Equals(source.SourceKind, "fallback", StringComparison.OrdinalIgnoreCase) ||
+            string.Equals(source.SourceKind, "app_solid", StringComparison.OrdinalIgnoreCase))
+        {
+            return;
+        }
+
+        lock (_paletteGate)
+        {
+            if (_pendingWallpaperSeedKeys.Contains(source.SourceKey))
+            {
+                return;
+            }
+
+            _pendingWallpaperSeedKeys.Add(source.SourceKey);
+        }
+
+        _ = Task.Run(() =>
+        {
+            WallpaperSeedExtractionResult? extractionResult = null;
+
+            try
+            {
+                extractionResult = ExtractWallpaperSeedCandidates(source);
+            }
+            catch (Exception ex)
+            {
+                AppLogger.Warn(
+                    "Appearance.WallpaperSeed",
+                    $"Failed to build wallpaper seed candidates asynchronously. Source='{source.SourceKind}'; Path='{source.FilePath}'.",
+                    ex);
+            }
+            finally
+            {
+                lock (_paletteGate)
+                {
+                    _pendingWallpaperSeedKeys.Remove(source.SourceKey);
+                    if (extractionResult is not null)
+                    {
+                        _wallpaperSeedCache[source.SourceKey] = extractionResult;
+                    }
+                }
+            }
+
+            if (extractionResult is not null)
+            {
+                RaiseChanged(queueWallpaperPaletteBuild: false);
+            }
+        });
+    }
+
+    private WallpaperSeedExtractionResult ExtractWallpaperSeedCandidates(WallpaperSeedSourceDescriptor source)
+    {
+        IReadOnlyList<Color> seedCandidates = source.SourceKind switch
+        {
+            "app_wallpaper" or "system_wallpaper" => ExtractImageSeedCandidates(source.FilePath),
+            "app_solid" when source.SolidColor is { } solidColor => new[] { solidColor },
+            _ => []
+        };
+
+        return new WallpaperSeedExtractionResult(
+            source.SourceKind,
+            source.SourceKey,
+            source.ResolvedWallpaperPath,
+            seedCandidates);
+    }
+
+    private IReadOnlyList<Color> ExtractImageSeedCandidates(string? wallpaperPath)
+    {
+        if (string.IsNullOrWhiteSpace(wallpaperPath) || !File.Exists(wallpaperPath))
+        {
+            return [];
+        }
+
+        try
+        {
+            using var bitmap = new Bitmap(wallpaperPath);
+            return _monetColorService.ExtractSeedCandidates(bitmap);
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn(
+                "Appearance.WallpaperSeed",
+                $"Failed to extract wallpaper seed candidates from image '{wallpaperPath}'.",
+                ex);
+            return [];
+        }
+    }
+
+    private WallpaperSeedSourceDescriptor ResolveWallpaperSeedSource(WallpaperSettingsState wallpaperState)
+    {
+        if (string.Equals(wallpaperState.Type, "SolidColor", StringComparison.OrdinalIgnoreCase) &&
+            !string.IsNullOrWhiteSpace(wallpaperState.Color) &&
+            Color.TryParse(wallpaperState.Color, out var solidColor))
+        {
+            var solidText = solidColor.ToString();
+            return new WallpaperSeedSourceDescriptor(
+                "app_solid",
+                $"app_solid|{solidText}",
+                null,
+                null,
+                solidColor);
+        }
+
+        var wallpaperPath = string.IsNullOrWhiteSpace(wallpaperState.WallpaperPath)
+            ? null
+            : wallpaperState.WallpaperPath.Trim();
+        var appWallpaperMediaType = _settingsFacade.WallpaperMedia.DetectMediaType(wallpaperPath);
+        if (!string.IsNullOrWhiteSpace(wallpaperPath) && File.Exists(wallpaperPath))
+        {
+            if (appWallpaperMediaType == WallpaperMediaType.Image)
+            {
+                return new WallpaperSeedSourceDescriptor(
+                    "app_wallpaper",
+                    CreateWallpaperSourceKey("app_wallpaper", wallpaperPath),
+                    wallpaperPath,
+                    wallpaperPath,
+                    null);
+            }
+        }
+
+        var systemWallpaper = _systemWallpaperService.GetWallpaperPath();
+        if (!string.IsNullOrWhiteSpace(systemWallpaper) &&
+            File.Exists(systemWallpaper) &&
+            _settingsFacade.WallpaperMedia.DetectMediaType(systemWallpaper) == WallpaperMediaType.Image)
+        {
+            return new WallpaperSeedSourceDescriptor(
+                "system_wallpaper",
+                CreateWallpaperSourceKey("system_wallpaper", systemWallpaper),
+                systemWallpaper,
+                systemWallpaper,
+                null);
+        }
+
+        return new WallpaperSeedSourceDescriptor(
+            "fallback",
+            "fallback",
+            null,
+            null,
+            null);
+    }
+
+    private void RaiseChanged(bool queueWallpaperPaletteBuild)
+    {
+        var snapshot = BuildCurrentSnapshot(queueWallpaperPaletteBuild);
+        if (Dispatcher.UIThread.CheckAccess())
+        {
+            Changed?.Invoke(this, snapshot);
+            return;
+        }
+
+        Dispatcher.UIThread.Post(() => Changed?.Invoke(this, snapshot), DispatcherPriority.Background);
+    }
+
+    private static Color? ResolveSelectedWallpaperSeed(
+        IReadOnlyList<Color> seedCandidates,
+        string? selectedWallpaperSeed)
+    {
+        if (seedCandidates.Count == 0)
+        {
+            return null;
+        }
+
+        if (!string.IsNullOrWhiteSpace(selectedWallpaperSeed) &&
+            Color.TryParse(selectedWallpaperSeed, out var parsedSeed))
+        {
+            foreach (var candidate in seedCandidates)
+            {
+                if (candidate == parsedSeed)
+                {
+                    return candidate;
+                }
+            }
+        }
+
+        return seedCandidates[0];
+    }
+
+    private static string CreateWallpaperSourceKey(string sourceKind, string wallpaperPath)
+    {
+        long lastWriteTicks = 0;
+        long length = 0;
+
+        try
+        {
+            var fileInfo = new FileInfo(wallpaperPath);
+            if (fileInfo.Exists)
+            {
+                lastWriteTicks = fileInfo.LastWriteTimeUtc.Ticks;
+                length = fileInfo.Length;
+            }
+        }
+        catch
+        {
+            // Keep the cache key resilient even if metadata lookup fails.
+        }
+
+        return string.Concat(
+            sourceKind,
+            "|",
+            wallpaperPath,
+            "|",
+            lastWriteTicks.ToString(),
+            "|",
+            length.ToString());
+    }
+}
+
+internal static class HostAppearanceThemeProvider
+{
+    private static readonly object Gate = new();
+    private static AppearanceThemeService? _instance;
+
+    public static IAppearanceThemeService GetOrCreate()
+    {
+        lock (Gate)
+        {
+            return _instance ??= new AppearanceThemeService(
+                HostSettingsFacadeProvider.GetOrCreate(),
+                new SystemWallpaperService(),
+                new WindowMaterialService(),
+                new MaterialSurfaceService());
+        }
+    }
+}

LanMountainDesktop/Services/ClassIslandScheduleDataService.cs

@@ -163,7 +163,7 @@ public sealed class ClassIslandScheduleDataService : IClassIslandScheduleDataSer
         var totalElapsedWeeks = (int)Math.Floor(
             (referenceDate.ToDateTime(TimeOnly.MinValue) - cycleRule.SingleWeekStartDate.Value.ToDateTime(TimeOnly.MinValue)).TotalDays / 7d);
 
-        for (var cycleLength = 2; cycleLength <= maxCycle; cycleLength++)
+        for (var cycleLength = 1; cycleLength <= maxCycle; cycleLength++)
         {
             var cycleOffset = cycleLength < cycleRule.MultiWeekRotationOffset.Count
                 ? cycleRule.MultiWeekRotationOffset[cycleLength]
@@ -668,7 +668,7 @@ public sealed class ClassIslandScheduleDataService : IClassIslandScheduleDataSer
             return true;
         }
 
-        if (weekCountDivTotal <= 1 || weekCountDivTotal >= cyclePositions.Count)
+        if (weekCountDivTotal <= 0 || weekCountDivTotal >= cyclePositions.Count)
         {
             return false;
         }