feat.SDK加入了FA的引用。

.github/workflows/release.yml

@@ -1,4 +1,4 @@
-name: Release
+name: Release
 
 on:
   push:
@@ -66,8 +66,15 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        arch: [x64, x86]
-    name: Build_Windows_${{ matrix.arch }}
+        include:
+          # 完整版（自包含 .NET 运行时）
+          - arch: x64
+            self_contained: true
+            suffix: ''
+          - arch: x86
+            self_contained: true
+            suffix: ''
+    name: Build_Windows_${{ matrix.arch }}${{ matrix.suffix }}
     
     steps:
       - name: Checkout
@@ -95,21 +102,42 @@ jobs:
 
       - name: Publish
         run: |
-          dotnet publish LanMountainDesktop/LanMountainDesktop.csproj `
-            -c Release `
-            -o ./publish/windows-${{ matrix.arch }} `
-            --self-contained `
-            -r win-${{ matrix.arch }} `
-            -p:PublishSingleFile=false `
-            -p:SelfContained=true `
-            -p:DebugType=none `
-            -p:DebugSymbols=false `
-            -p:PublishTrimmed=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 }}
+          $selfContained = "${{ matrix.self_contained }}" -eq "true"
+          $publishDir = if ($selfContained) { "publish/windows-${{ matrix.arch }}" } else { "publish/windows-${{ matrix.arch }}-lite" }
+
+          if ($selfContained) {
+            dotnet publish LanMountainDesktop/LanMountainDesktop.csproj `
+              -c Release `
+              -o ./$publishDir `
+              --self-contained `
+              -r win-${{ matrix.arch }} `
+              -p:PublishSingleFile=false `
+              -p:DebugType=none `
+              -p:DebugSymbols=false `
+              -p:PublishTrimmed=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 }}
+          } else {
+            dotnet publish LanMountainDesktop/LanMountainDesktop.csproj `
+              -c Release `
+              -o ./$publishDir `
+              --self-contained:false `
+              -p:PublishSingleFile=false `
+              -p:DebugType=none `
+              -p:DebugSymbols=false `
+              -p:PublishTrimmed=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 }}
+          }
+
+          Write-Host "Published to: $publishDir"
+          Write-Host "Self-contained: $selfContained"
         shell: pwsh
 
       - name: Install Inno Setup
@@ -120,7 +148,9 @@ jobs:
         run: |
           $version = "${{ needs.prepare.outputs.version }}"
           $arch = "${{ matrix.arch }}"
-          $publishDir = "publish\windows-$arch"
+          $selfContained = "${{ matrix.self_contained }}" -eq "true"
+          $suffix = "${{ matrix.suffix }}"
+          $publishDir = if ($selfContained) { "publish\windows-$arch" } else { "publish\windows-$arch-lite" }
           $installerScript = "LanMountainDesktop\installer\LanMountainDesktop.iss"
           $outputDir = "build-installer"
           
@@ -187,6 +217,8 @@ jobs:
             "/DPublishDir=$publishDir",
             "/DMyOutputDir=$outputDir",
             "/DMyAppArch=$arch",
+            "/DMyAppSuffix=$suffix",
+            "/DIsSelfContained=$selfContained",
             $installerScript
           )
           
@@ -213,7 +245,7 @@ jobs:
       - name: Upload Installer
         uses: actions/upload-artifact@v4
         with:
-          name: release-windows-${{ matrix.arch }}
+          name: release-windows-${{ matrix.arch }}${{ matrix.suffix }}
           path: build-installer/*.exe
           if-no-files-found: error
           retention-days: 30
@@ -548,19 +580,19 @@ jobs:
           artifacts: "release-files/**"
           body: |
             ## Release ${{ needs.prepare.outputs.version }}
-            
+
             ### Windows
-            - **LanMountainDesktop-Setup-{version}-x64.exe** - 64-bit installer
-            - **LanMountainDesktop-Setup-{version}-x86.exe** - 32-bit installer
-            
+            - **LanMountainDesktop-Setup-{version}-x64.exe** - 64-bit installer (包含 .NET 运行时)
+            - **LanMountainDesktop-Setup-{version}-x86.exe** - 32-bit installer (包含 .NET 运行时)
+
             Installation: Double-click the .exe file and follow the wizard.
-            
+
             ### Linux
             - **LanMountainDesktop-{version}-linux-x64.deb** - Debian package (x64)
-            
+
             ### macOS
             - **LanMountainDesktop-{version}-macos-x64.dmg** - Intel processor
             - **LanMountainDesktop-{version}-macos-arm64.dmg** - Apple Silicon (M1/M2/M3)
-            
+
             See commits for changes.
           token: ${{ secrets.GITHUB_TOKEN }}

.trae/skills/refactoring-insight/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: "refactoring-insight"
+description: "Analyzes codebase for refactoring opportunities: large files, code duplication, god classes, naming inconsistencies, tight coupling, and missing abstractions. Invoke when user asks for refactoring insight/analysis or wants to improve code architecture."
+---
+
+# Refactoring Insight
+
+Deep codebase analysis skill that identifies structural problems and produces prioritized refactoring recommendations.
+
+## When to Invoke
+
+- User asks for "refactoring insight", "refactoring analysis", "code quality analysis", "architecture review"
+- User wants to understand what should be refactored in the codebase
+- User asks "where are the code smells?" or "what needs refactoring?"
+
+## Analysis Dimensions
+
+Run all 6 dimensions in parallel where possible. For each dimension, use search agents to gather data, then synthesize findings.
+
+### 1. Large Files / God Classes
+
+- Find all .cs files over 300 lines, sorted by line count descending
+- Identify partial classes and sum their total line count across files
+- Flag classes with 15+ methods or constructors taking 8+ parameters
+- Focus on: Views/, ViewModels/, Services/, plugins/
+
+**Output**: Table of files with line counts and responsibility summary.
+
+### 2. Code Duplication
+
+Search for these specific duplication patterns:
+
+- **Service boilerplate**: Repeated DI registration, `new` instantiation instead of DI
+- **Data service pattern**: Services that fetch/parse/transform data similarly (Load → Map → Save)
+- **Localization pattern**: `private readonly LocalizationService _localizationService = new();` and `L()` helper method repetitions
+- **Helper method duplication**: Methods like `ResolveUnifiedMainRadiusValue`, `NormalizeConfig`, `ParticleState` classes copied across files
+- **Error handling pattern**: Identical try-catch blocks repeated in multiple methods
+- **Settings snapshot pattern**: `_settingsFacade.Settings.LoadSnapshot<T>(scope)` call sites
+
+**Output**: List of duplicated patterns with file locations and line numbers.
+
+### 3. Tight Coupling
+
+- Services instantiated via `new` instead of DI injection
+- ViewModels directly accessing infrastructure-layer APIs (e.g., `LoadSnapshot/SaveSnapshot`)
+- Hard-coded dependencies (GitHub repo owner/name, default values)
+- `Application.Current` upcasting to access services: `(Application.Current as App)?.SomeService`
+- Platform-specific code embedded in cross-platform services without interface abstraction
+
+**Output**: Table of coupling violations with severity (high/medium/low).
+
+### 4. Naming Inconsistencies
+
+- Service suffix inconsistency: `Service` vs `Store` vs `Helper` vs `Provider` vs `Manager` vs `Factory` for similar responsibilities
+- Model suffix inconsistency: `Snapshot` vs `State` vs `Types` for similar concepts
+- Platform prefix inconsistency: `Windows`/`Linux` full name vs `Mac` abbreviation
+- Confusing names: services with similar names but different responsibilities (e.g., `NotificationService` vs `NotificationListenerService`)
+
+**Output**: Categorized list of naming inconsistencies.
+
+### 5. Missing Abstractions
+
+- Services without corresponding interfaces (check for `I<ServiceName>` pattern)
+- Common patterns that could be extracted into base classes:
+  - `SettingsPageViewModelBase` for shared ViewModel boilerplate
+  - `JsonFileSettingsService<TSnapshot>` for repeated settings persistence
+  - `SettingsDomainServiceBase<TState>` for Load-Map-Save pattern
+  - `DesktopComponentWidgetBase` for shared Widget code
+  - `ComponentEditorViewBase` enhancements (e.g., `_suppressEvents` pattern)
+- Static singleton/Factory providers repeating thread-safe lazy-load boilerplate
+
+**Output**: List of missing abstractions with proposed base class/interface names.
+
+### 6. Misplaced Responsibilities
+
+- Files in wrong directories (e.g., data access in Settings/, UI services mixed with data services)
+- ViewModels containing business logic or file system operations
+- Widget code-behind files with excessive logic (>200 lines)
+- Platform-specific services not organized into subdirectories
+
+**Output**: List of misplaced files/classes with recommended new locations.
+
+## Output Format
+
+Produce a structured report with:
+
+1. **Summary table**: Total metrics (file count, duplication count, etc.)
+2. **Priority-ranked findings**: P0 (must fix), P1 (should fix), P2 (recommended), P3 (nice to have)
+3. **Each finding includes**: Problem description, affected files with links, specific line numbers, recommended action, estimated impact
+
+### Priority Criteria
+
+- **P0**: Files over 1000 lines with mixed responsibilities; patterns duplicated 10+ times; god classes with 20+ dependencies
+- **P1**: Patterns duplicated 5-9 times; services without interfaces that are widely used; DI bypass affecting testability
+- **P2**: Patterns duplicated 3-4 times; naming inconsistencies affecting readability; misplaced files
+- **P3**: Minor naming variations; single-instance duplications; organizational improvements
+
+## Project-Specific Context
+
+This skill is aware of the LanMountainDesktop project structure:
+
+- `LanMountainDesktop/Services/` — Business and infrastructure services
+- `LanMountainDesktop/Services/Settings/` — Settings subsystem
+- `LanMountainDesktop/ViewModels/` — View models
+- `LanMountainDesktop/Views/Components/` — Desktop widget components
+- `LanMountainDesktop/Views/ComponentEditors/` — Widget editor views
+- `LanMountainDesktop/plugins/` — Plugin runtime
+- `LanMountainDesktop.PluginSdk/` — Plugin SDK public API
+- `LanMountainDesktop.Shared.Contracts/` — Host/plugin shared contracts
+- `LanMountainDesktop.Appearance/` — Appearance and corner radius infrastructure
+
+When analyzing, respect the project's architectural boundaries documented in `docs/ARCHITECTURE.md` and `docs/ECOSYSTEM_BOUNDARIES.md`.

.trae/specs/fused-desktop-library-redesign/spec.md

@@ -0,0 +1,166 @@
+# 融合桌面组件库窗口重设计规格
+
+## Why
+
+当前融合桌面组件库窗口（FusedDesktopComponentLibraryWindow）的UI设计较为基础，与Windows 11小组件编辑面板相比，缺乏现代化的交互体验和视觉层次。用户需要一个更直观、更美观的界面来浏览和添加组件到系统桌面（负一屏）。
+
+参考Windows 11小组件编辑面板的设计特点：
+
+* 左侧分类列表，右侧选中组件的详细预览
+
+* 大型组件预览区域，让用户清楚看到组件效果
+
+* 底部明显的"添加"操作按钮
+
+* 简洁的关闭按钮（X）在右上角
+
+* 深色主题配合毛玻璃效果
+
+## What Changes
+
+* **重新设计窗口布局**：从左右分栏（分类列表+组件网格）改为左侧面板+右侧预览区的布局
+
+* **添加组件详情预览区**：选中组件后右侧显示大尺寸预览和组件信息
+
+* **优化关闭按钮**：使用标准的X图标按钮，不使用圆形样式
+
+* **添加底部操作栏**：包含"添加到桌面"主操作按钮和"查找更多组件"链接
+
+* **复用阑山桌面组件库分类**：使用相同的分类ID、图标和本地化文本
+
+* **移除搜索功能**：参考Windows 11设计，暂不提供搜索
+
+## Impact
+
+* 受影响文件：
+
+  * `LanMountainDesktop/Views/FusedDesktopComponentLibraryWindow.axaml`
+
+  * `LanMountainDesktop/Views/FusedDesktopComponentLibraryWindow.axaml.cs`
+
+  * `LanMountainDesktop/Views/FusedDesktopComponentLibraryControl.axaml`
+
+  * `LanMountainDesktop/Views/FusedDesktopComponentLibraryControl.axaml.cs`
+
+  * `LanMountainDesktop/ViewModels/ComponentLibraryWindowViewModel.cs`（可能需要添加新属性）
+
+## ADDED Requirements
+
+### Requirement: 窗口布局重设计
+
+系统应提供一个类似于Windows 11小组件编辑面板的组件库窗口。
+
+#### Scenario: 窗口整体结构
+
+* **GIVEN** 用户从托盘菜单打开融合桌面组件库
+
+* **WHEN** 窗口显示时
+
+* **THEN** 窗口应呈现：
+
+  * 顶部标题栏：左侧显示"添加小组件"标题，右侧有关闭按钮（X）
+
+  * 左侧面板：分类列表（复用阑山桌面组件库的分类和图标）
+
+  * 右侧主区域：选中组件的大尺寸预览 + 组件信息 + 添加按钮
+
+  * 底部："查找更多组件"链接
+
+#### Scenario: 分类列表交互
+
+* **GIVEN** 左侧显示组件分类列表
+
+* **WHEN** 用户点击某个分类
+
+* **THEN** 右侧应显示该分类下的第一个组件的预览
+
+* **AND** 分类项应有选中状态视觉反馈
+
+* **AND** 分类图标和名称应与阑山桌面组件库保持一致
+
+#### Scenario: 组件预览区
+
+* **GIVEN** 用户选中一个组件
+
+* **WHEN** 预览区显示时
+
+* **THEN** 应显示：
+
+  * 组件标题（大字号）
+
+  * 大尺寸组件预览图（接近实际尺寸）
+
+  * 组件描述/功能说明
+
+  * 底部"添加到桌面"按钮
+
+#### Scenario: 添加组件操作
+
+* **GIVEN** 用户查看组件预览
+
+* **WHEN** 用户点击"添加到桌面"按钮
+
+* **THEN** 组件应被添加到系统桌面（负一屏）中央
+
+* **AND** 窗口应关闭
+
+#### Scenario: 关闭按钮样式
+
+* **GIVEN** 窗口标题栏有关闭按钮
+
+* **THEN** 关闭按钮应使用标准的X图标
+
+* **AND** 不使用圆形背景或特殊样式
+
+* **AND** 使用 `DesignCornerRadiusSm` 动态资源
+
+#### Scenario: 查找更多组件链接
+
+* **GIVEN** 窗口底部显示"查找更多组件"链接
+
+* **WHEN** 用户点击该链接
+
+* **THEN** 应打开设置窗口的插件目录页面（后续将改为插件市场）
+
+## MODIFIED Requirements
+
+### Requirement: 组件列表展示
+
+原实现使用网格展示所有组件，新实现改为：
+
+* 左侧列表仅显示分类（复用阑山桌面组件库的分类ID和图标映射）
+
+* 右侧预览区一次只显示一个组件的详细信息
+
+* ~~移除搜索功能~~（根据Windows 11设计，暂不提供搜索）
+
+### Requirement: 关闭按钮圆角规范
+
+原实现关闭按钮使用硬编码 `CornerRadius="18"`，应改为使用动态资源 `DesignCornerRadiusSm`。
+
+### Requirement: 分类图标复用
+
+分类图标映射应与阑山桌面组件库保持一致：
+
+* Clock -> Symbol.Clock
+
+* Date -> Symbol.CalendarDate
+
+* Weather -> Symbol.WeatherSunny
+
+* Board -> Symbol.Edit
+
+* Media -> Symbol.Play
+
+* Info -> Symbol.Info
+
+* Calculator -> Symbol.Calculator
+
+* Study -> Symbol.Hourglass
+
+* 其他 -> Symbol.Apps
+
+## REMOVED Requirements
+
+* ~~搜索功能~~：根据Windows 11小组件面板设计，暂不提供搜索功能
+

.trae/specs/fused-desktop-library-redesign/tasks.md

@@ -0,0 +1,35 @@
+# Tasks
+
+- [x] Task 1: 修改 FusedDesktopComponentLibraryWindow.axaml 窗口布局
+  - [x] SubTask 1.1: 重新设计标题栏，使用标准X关闭按钮，移除圆形样式，使用 DesignCornerRadiusSm
+  - [x] SubTask 1.2: 调整窗口整体布局为左侧面板+右侧预览区
+  - [x] SubTask 1.3: 添加底部"查找更多组件"链接区域
+
+- [x] Task 2: 修改 FusedDesktopComponentLibraryControl.axaml 控件布局
+  - [x] SubTask 2.1: 重新设计左侧面板：仅保留分类列表（移除搜索框）
+  - [x] SubTask 2.2: 重新设计右侧预览区：组件标题 + 大尺寸预览 + 描述 + 添加按钮
+  - [x] SubTask 2.3: 优化分类列表项样式，添加选中状态视觉反馈
+  - [x] SubTask 2.4: 复用阑山桌面组件库的分类图标映射
+
+- [x] Task 3: 更新 ViewModel 支持新交互模式
+  - [x] SubTask 3.1: 在 ComponentLibraryWindowViewModel 中添加 SelectedComponent 属性
+  - [x] SubTask 3.2: 添加组件描述属性支持
+
+- [x] Task 4: 更新 FusedDesktopComponentLibraryControl.axaml.cs 代码逻辑
+  - [x] SubTask 4.1: 修改分类选择逻辑，选中分类时显示该分类第一个组件
+  - [x] SubTask 4.2: 添加组件选中逻辑
+  - [x] SubTask 4.3: 移除搜索相关代码
+  - [x] SubTask 4.4: 复用阑山桌面组件库的分类图标和本地化方法
+  - [x] SubTask 4.5: 添加"查找更多组件"链接点击处理（打开设置窗口插件目录）
+
+- [x] Task 5: 验证和测试
+  - [x] SubTask 5.1: 验证关闭按钮使用动态圆角资源 DesignCornerRadiusSm
+  - [x] SubTask 5.2: 验证窗口布局符合Windows 11小组件面板风格
+  - [x] SubTask 5.3: 验证分类图标与阑山桌面组件库一致
+  - [x] SubTask 5.4: 验证组件添加功能正常工作
+  - [x] SubTask 5.5: 验证"查找更多组件"链接能打开设置窗口
+
+# Task Dependencies
+- Task 3 依赖于 Task 1 和 Task 2 的UI设计确定
+- Task 4 依赖于 Task 3 的ViewModel更新
+- Task 5 依赖于所有前置任务完成

CHANGELOG.md

@@ -1,31 +1,112 @@
 # 更新日志 / Changelog
 
-所有重要的更改都将记录在此文件中。
-
-格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/),
-并且本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
-
----
-
-## [Unreleased]
+## [0.8.3.5](https://github.com/yourorg/LanMountainDesktop/releases/tag/v0.8.3.5) - 2026-04-12
 
 ### 新增 (Added)
-- 待发布的新功能
+
+- 无
 
 ### 变更 (Changed)
-- 待发布的变更
+
+- ✨ **插件设置页面支持 View 展示**: 插件设置页面现在支持使用 View 进行展示
+  - 插件开发者可以通过 View 自定义设置页面的 UI 和交互
+  - 提供更灵活的设置页面展示方式，提升插件用户体验
+  - 兼容原有的设置方式，平滑过渡
+- 🔧 **三指滑动与融合桌面功能开关位置调整**: 将三指滑动与融合桌面功能开关移动到了开发者设置界面
+  - 优化设置页面结构，将高级功能集中管理
+  - 普通用户界面更加简洁，开发者可在已有的开发者设置界面中访问相关设置
 
 ### 修复 (Fixed)
-- 待发布的修复
+
+- 🐛 **快捷方式组件透明问题**: 修复了快捷方式组件无法正常透明的问题
+  - 问题原因: 组件背景透明属性设置异常或渲染层级问题
+  - 修复方案: 修正透明属性配置，确保快捷方式组件背景透明效果正常显示
+- 🐛 **插件无法正常升级问题**: 修复了插件无法正常升级的问题
+  - 问题原因: 插件升级流程中存在异常，导致升级操作失败或中断
+  - 修复方案: 修复插件升级逻辑，确保插件可以正常检测、下载和安装更新
+- 🐛 **开发者设置项持久化问题**: 修复了开发者设置项不能正确持久化的问题
+  - 问题原因: 开发者设置项的保存或读取逻辑存在缺陷，导致设置无法正确保存或恢复
+  - 修复方案: 修复设置持久化逻辑，确保开发者设置项能够正确保存并在重启后恢复
 
 ### 移除 (Removed)
-- 待发布的移除项
 
----
+- 🗑️ **不附带 .NET 10 依赖的轻量版安装包**: 移除了不附带 .NET 10 依赖的轻量版安装包
+  - 简化版本发布和维护流程，统一提供完整依赖的安装包
+  - 用户无需担心 .NET 运行时环境，安装后即可直接使用
 
-## [0.8.3.1] - 2026-04-08
+***
+
+## [0.8.3.3](https://github.com/yourorg/LanMountainDesktop/releases/tag/v0.8.3.3) - 2026-04-12
 
 ### 新增 (Added)
+
+- ✨ **便签组件**: 全新便签组件上线，支持 Markdown 语法
+  - 支持丰富的 Markdown 格式：标题、列表、加粗、斜体、代码块等
+  - 便签内容自动保存，方便记录和管理日常备忘。丰富信息展示途径，让作业布置也可在阑山桌面完成。
+- ✨ **白板主题自适应笔色**: 白板功能新增主题自适应笔色支持
+  - 根据当前主题自动调整画笔颜色，确保在不同主题下都有良好的书写体验
+  - 深色主题下自动切换为浅色笔迹，浅色主题下使用深色笔迹
+
+### 变更 (Changed)
+
+- 🎨 **融合桌面设置组件库样式更新**: 优化融合桌面设置页面的组件库样式
+  - 提升视觉一致性和用户体验
+  - 统一组件风格，与整体设计语言保持协调
+
+### 修复 (Fixed)
+
+- 🐛 **白板无法使用问题**: 修复了白板功能无法正常使用的问题
+  - 问题原因: 相关依赖或初始化逻辑异常导致白板功能失效
+  - 修复方案: 修复了白板的依赖加载和初始化流程，恢复正常使用
+- 🐛 **央官网新闻组件显示问题**: 修复了央官网新闻组件的显示异常
+  - 优化组件渲染逻辑，确保新闻内容正确展示
+- 🐛 **课程表组件显示问题**: 修复了课程表组件的显示异常
+  - 优化组件布局和渲染，确保课程信息正确显示
+- 🐛 **轻量版 .NET 10 依赖问题（实验性）**: 实验性修复了轻量版在 .NET 10 环境下的依赖问题
+  - 问题原因: 轻量版与 .NET 10 的依赖兼容性存在冲突
+  - 修复方案: 调整依赖配置，提升与 .NET 10 的兼容性（实验性修复，持续观察中）
+
+### 移除 (Removed)
+
+- 无
+
+***
+
+## [0.8.3.2](https://github.com/yourorg/LanMountainDesktop/releases/tag/v0.8.3.2) - 2026-04-09
+
+### 新增 (Added)
+
+- ✨ **应用启动台图标卡片显示选项**: 新增应用启动台图标卡片显示设置
+  - 用户可在设置中选择是否显示应用图标的专属卡片背景
+  - 关闭后仅显示应用图标本身，更加简洁
+  - 支持动态切换，实时预览效果
+
+### 变更 (Changed)
+
+- 无
+
+### 修复 (Fixed)
+
+- 🐛 **应用启动台文件夹应用数量限制**: 修复了应用启动台文件夹无法查看超过12个应用的问题
+  - 问题原因: 文件夹弹窗未实现滚动功能，应用列表超出显示区域后被截断
+  - 修复方案: 为文件夹内容区域添加滚动支持，允许用户滚动查看所有应用
+- 🐛 **电源菜单重启导致关机问题**: 修复了点击电源菜单"重启"选项却触发关机的问题
+  - 问题原因: `SlideToShutDown.exe` 仅支持关机操作，不支持重启，错误地将其用于重启功能
+  - 修复方案: 重启操作改为使用标准的二次确认对话框（所有平台统一），仅关机操作使用 SlideToShutDown 滑动界面
+- 🐛 **课表组件字体显示问题**: 修复了日间模式下课表组件字体颜色与背景色相近导致看不清的问题
+  - 问题原因: 主题切换时增量更新逻辑未同步更新文字颜色
+  - 修复方案: 在 `IncrementalUpdateItems()` 方法中同步更新课程项的文字颜色
+
+### 移除 (Removed)
+
+- 🗑️ **更新页面重复标题**: 移除了更新页面中重复的更新标题，优化页面布局
+
+***
+
+## [0.8.3.1](https://github.com/yourorg/LanMountainDesktop/releases/tag/v0.8.3.1) - 2026-04-08
+
+### 新增 (Added)
+
 - ✨ **快捷方式组件**: 新增快捷方式组件,可在阑山桌面内便捷打开系统应用与文件
   - 支持创建快捷方式,统一管理应用和文件
   - 提供单击打开和双击打开两种交互模式
@@ -33,15 +114,45 @@
 - 📝 初始化更新日志文档,为后续版本发布建立基础
 
 ### 变更 (Changed)
+
 - 无
 
 ### 修复 (Fixed)
+
 - 无
 
 ### 移除 (Removed)
+
 - 无
 
----
+***
+
+所有重要的更改都将记录在此文件中。
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/),
+并且本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+***
+
+## \[格式示例]
+
+### 新增 (Added)
+
+- 待发布的新功能
+
+### 变更 (Changed)
+
+- 待发布的变更
+
+### 修复 (Fixed)
+
+- 待发布的修复
+
+### 移除 (Removed)
+
+- 待发布的移除项
+
+***
 
 ## 版本说明
 
@@ -74,9 +185,6 @@
 - 🔒 **安全**: 安全相关
 - 🌐 **国际化**: 国际化/本地化
 
----
+***
 
 ## 链接
-
-[Unreleased]: https://github.com/yourorg/LanMountainDesktop/compare/v0.8.3.1...HEAD
-[0.8.3.1]: https://github.com/yourorg/LanMountainDesktop/releases/tag/v0.8.3.1

LanMountainDesktop.PluginSdk/AppearanceChangedEvent.cs

@@ -0,0 +1,109 @@
+namespace LanMountainDesktop.PluginSdk;
+
+/// <summary>
+/// 外观变更事件参数，当主题、圆角或其他外观属性变化时触发。
+/// </summary>
+public sealed class AppearanceChangedEvent : EventArgs
+{
+    /// <summary>
+    /// 创建外观变更事件实例。
+    /// </summary>
+    /// <param name="snapshot">当前外观快照</param>
+    /// <param name="changedProperties">变更的属性集合</param>
+    public AppearanceChangedEvent(
+        PluginAppearanceSnapshot snapshot,
+        IReadOnlyCollection<AppearanceProperty> changedProperties)
+    {
+        ArgumentNullException.ThrowIfNull(snapshot);
+        ArgumentNullException.ThrowIfNull(changedProperties);
+
+        Snapshot = snapshot;
+        ChangedProperties = changedProperties;
+    }
+
+    /// <summary>
+    /// 当前外观快照。
+    /// </summary>
+    public PluginAppearanceSnapshot Snapshot { get; }
+
+    /// <summary>
+    /// 变更的属性集合。
+    /// </summary>
+    public IReadOnlyCollection<AppearanceProperty> ChangedProperties { get; }
+
+    /// <summary>
+    /// 圆角是否发生变化。
+    /// </summary>
+    public bool CornerRadiusChanged => ChangedProperties.Contains(AppearanceProperty.CornerRadius);
+
+    /// <summary>
+    /// 主题变体（亮色/暗色）是否发生变化。
+    /// </summary>
+    public bool ThemeVariantChanged => ChangedProperties.Contains(AppearanceProperty.ThemeVariant);
+
+    /// <summary>
+    /// 强调色是否发生变化。
+    /// </summary>
+    public bool AccentColorChanged => ChangedProperties.Contains(AppearanceProperty.AccentColor);
+
+    /// <summary>
+    /// 圆角风格是否发生变化。
+    /// </summary>
+    public bool CornerRadiusStyleChanged => ChangedProperties.Contains(AppearanceProperty.CornerRadiusStyle);
+
+    /// <summary>
+    /// 检查指定属性是否发生变化。
+    /// </summary>
+    /// <param name="property">要检查的属性</param>
+    /// <returns>如果属性发生变化则返回 true</returns>
+    public bool HasChanged(AppearanceProperty property)
+    {
+        return ChangedProperties.Contains(property);
+    }
+
+    /// <summary>
+    /// 检查是否有任何外观属性发生变化。
+    /// </summary>
+    public bool HasAnyChanges => ChangedProperties.Count > 0;
+}
+
+/// <summary>
+/// 可变更的外观属性枚举。
+/// </summary>
+public enum AppearanceProperty
+{
+    /// <summary>
+    /// 圆角Token值发生变化。
+    /// </summary>
+    CornerRadius,
+
+    /// <summary>
+    /// 主题变体（亮色/暗色）发生变化。
+    /// </summary>
+    ThemeVariant,
+
+    /// <summary>
+    /// 强调色发生变化。
+    /// </summary>
+    AccentColor,
+
+    /// <summary>
+    /// 圆角风格（Sharp/Balanced/Rounded/Open）发生变化。
+    /// </summary>
+    CornerRadiusStyle,
+
+    /// <summary>
+    /// 壁纸发生变化。
+    /// </summary>
+    Wallpaper,
+
+    /// <summary>
+    /// 系统材质模式发生变化。
+    /// </summary>
+    SystemMaterialMode,
+
+    /// <summary>
+    /// 所有外观属性（用于批量更新）。
+    /// </summary>
+    All
+}

LanMountainDesktop.PluginSdk/AssemblyInfo.cs

@@ -0,0 +1,4 @@
+using Avalonia.Metadata;
+
+[assembly: XmlnsPrefix("http://lanmountain.tech/schemas/xaml/sdk", "lmd")]
+[assembly: XmlnsDefinition("http://lanmountain.tech/schemas/xaml/sdk", "LanMountainDesktop.PluginSdk")]

LanMountainDesktop.PluginSdk/IPluginAppearanceContext.cs

@@ -1,10 +1,35 @@
 namespace LanMountainDesktop.PluginSdk;
 
+/// <summary>
+/// 插件外观上下文接口，提供主题、圆角等外观资源的访问和变更通知。
+/// </summary>
 public interface IPluginAppearanceContext
 {
+    /// <summary>
+    /// 当前外观快照。
+    /// </summary>
     PluginAppearanceSnapshot Snapshot { get; }
 
+    /// <summary>
+    /// 外观变更事件。当主题、圆角或其他外观属性发生变化时触发。
+    /// </summary>
+    event EventHandler<AppearanceChangedEvent>? Changed;
+
+    /// <summary>
+    /// 解析带缩放的圆角半径。
+    /// </summary>
+    /// <param name="baseRadius">基础圆角半径</param>
+    /// <param name="minimum">最小值（可选）</param>
+    /// <param name="maximum">最大值（可选）</param>
+    /// <returns>解析后的圆角半径</returns>
     double ResolveScaledCornerRadius(double baseRadius, double? minimum = null, double? maximum = null);
 
+    /// <summary>
+    /// 根据预设解析圆角半径。
+    /// </summary>
+    /// <param name="preset">圆角预设</param>
+    /// <param name="minimum">最小值（可选）</param>
+    /// <param name="maximum">最大值（可选）</param>
+    /// <returns>解析后的圆角半径</returns>
     double ResolveCornerRadius(PluginCornerRadiusPreset preset, double? minimum = null, double? maximum = null);
 }

LanMountainDesktop.PluginSdk/LanMountainDesktop.PluginSdk.csproj

@@ -4,7 +4,7 @@
     <TargetFramework>net10.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
-    <Version>4.0.0</Version>
+    <Version>4.0.1</Version>
     <PackageId>LanMountainDesktop.PluginSdk</PackageId>
     <IsPackable>true</IsPackable>
     <Authors>LanMountainDesktop</Authors>
@@ -20,6 +20,9 @@
   <ItemGroup>
     <Compile Remove="_build_verify_*\**\*.cs" />
     <PackageReference Include="Avalonia" Version="11.3.12" />
+    <PackageReference Include="FluentAvaloniaUI" Version="2.5.0" ExcludeAssets="runtime" />
+    <PackageReference Include="FluentIcons.Avalonia" Version="2.0.320" ExcludeAssets="runtime" />
+    <PackageReference Include="FluentIcons.Avalonia.Fluent" Version="2.0.320" ExcludeAssets="runtime" />
     <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" />

LanMountainDesktop.PluginSdk/PluginAppearanceContext.cs

@@ -1,13 +1,22 @@
 namespace LanMountainDesktop.PluginSdk;
 
+/// <summary>
+/// 插件外观上下文实现，提供主题、圆角等外观资源的访问和变更通知。
+/// </summary>
 public sealed class PluginAppearanceContext : IPluginAppearanceContext
 {
+    private PluginAppearanceSnapshot _snapshot;
+
+    /// <summary>
+    /// 创建插件外观上下文实例。
+    /// </summary>
+    /// <param name="snapshot">初始外观快照</param>
     public PluginAppearanceContext(PluginAppearanceSnapshot snapshot)
     {
         ArgumentNullException.ThrowIfNull(snapshot);
         ArgumentNullException.ThrowIfNull(snapshot.CornerRadiusTokens);
 
-        Snapshot = snapshot with
+        _snapshot = snapshot with
         {
             ThemeVariant = string.IsNullOrWhiteSpace(snapshot.ThemeVariant)
                 ? "Unknown"
@@ -15,8 +24,37 @@ public sealed class PluginAppearanceContext : IPluginAppearanceContext
         };
     }
 
-    public PluginAppearanceSnapshot Snapshot { get; }
+    /// <inheritdoc />
+    public PluginAppearanceSnapshot Snapshot => _snapshot;
 
+    /// <inheritdoc />
+    public event EventHandler<AppearanceChangedEvent>? Changed;
+
+    /// <summary>
+    /// 更新外观快照并触发变更事件。
+    /// 此方法由宿主调用，用于在主题、圆角等外观属性变化时通知插件。
+    /// </summary>
+    /// <param name="newSnapshot">新的外观快照</param>
+    /// <param name="changedProperties">变更的属性集合</param>
+    public void UpdateSnapshot(PluginAppearanceSnapshot newSnapshot, IReadOnlyCollection<AppearanceProperty> changedProperties)
+    {
+        ArgumentNullException.ThrowIfNull(newSnapshot);
+        ArgumentNullException.ThrowIfNull(changedProperties);
+
+        _snapshot = newSnapshot with
+        {
+            ThemeVariant = string.IsNullOrWhiteSpace(newSnapshot.ThemeVariant)
+                ? "Unknown"
+                : newSnapshot.ThemeVariant.Trim()
+        };
+
+        if (changedProperties.Count > 0)
+        {
+            Changed?.Invoke(this, new AppearanceChangedEvent(_snapshot, changedProperties));
+        }
+    }
+
+    /// <inheritdoc />
     public double ResolveScaledCornerRadius(double baseRadius, double? minimum = null, double? maximum = null)
     {
         var value = Math.Max(0d, baseRadius);
@@ -30,16 +68,17 @@ public sealed class PluginAppearanceContext : IPluginAppearanceContext
         return Math.Clamp(value, clampedMin, clampedMax);
     }
 
+    /// <inheritdoc />
     public double ResolveCornerRadius(PluginCornerRadiusPreset preset, double? minimum = null, double? maximum = null)
     {
-        var resolved = Math.Max(0d, Snapshot.CornerRadiusTokens.Get(preset));
+        var resolved = Math.Max(0d, _snapshot.CornerRadiusTokens.Get(preset));
         if (!minimum.HasValue && !maximum.HasValue)
         {
             return resolved;
         }
 
-        var clampedMin = minimum ?? resolved;
-        var clampedMax = maximum ?? resolved;
+        var clampedMin = minimum ?? 0d;
+        var clampedMax = maximum ?? double.MaxValue;
         if (clampedMin > clampedMax)
         {
             (clampedMin, clampedMax) = (clampedMax, clampedMin);

LanMountainDesktop.PluginSdk/PluginAppearanceHelper.cs

@@ -0,0 +1,137 @@
+using Avalonia;
+
+namespace LanMountainDesktop.PluginSdk;
+
+/// <summary>
+/// 插件外观辅助方法，提供统一的圆角和主题资源访问。
+/// </summary>
+public static class PluginAppearanceHelper
+{
+    /// <summary>
+    /// 获取桌面组件主外壳圆角半径。
+    /// 这是组件最外层边框应该使用的圆角值，对应 DesignCornerRadiusComponent 资源。
+    /// </summary>
+    /// <param name="context">外观上下文</param>
+    /// <returns>主外壳圆角半径（像素）</returns>
+    public static double GetShellCornerRadius(this IPluginAppearanceContext context)
+    {
+        ArgumentNullException.ThrowIfNull(context);
+        return context.ResolveCornerRadius(PluginCornerRadiusPreset.Component);
+    }
+
+    /// <summary>
+    /// 获取内部卡片圆角半径。
+    /// 用于组件内部的次级卡片、内容区块等。
+    /// </summary>
+    /// <param name="context">外观上下文</param>
+    /// <returns>内部卡片圆角半径（像素）</returns>
+    public static double GetCardCornerRadius(this IPluginAppearanceContext context)
+    {
+        ArgumentNullException.ThrowIfNull(context);
+        return context.ResolveCornerRadius(PluginCornerRadiusPreset.Sm);
+    }
+
+    /// <summary>
+    /// 获取控件圆角半径。
+    /// 用于按钮、输入框、标签等交互控件。
+    /// </summary>
+    /// <param name="context">外观上下文</param>
+    /// <returns>控件圆角半径（像素）</returns>
+    public static double GetControlCornerRadius(this IPluginAppearanceContext context)
+    {
+        ArgumentNullException.ThrowIfNull(context);
+        return context.ResolveCornerRadius(PluginCornerRadiusPreset.Xs);
+    }
+
+    /// <summary>
+    /// 获取徽章/标签圆角半径。
+    /// 用于小徽章、标签、角标等微元素。
+    /// </summary>
+    /// <param name="context">外观上下文</param>
+    /// <returns>徽章圆角半径（像素）</returns>
+    public static double GetBadgeCornerRadius(this IPluginAppearanceContext context)
+    {
+        ArgumentNullException.ThrowIfNull(context);
+        return context.ResolveCornerRadius(PluginCornerRadiusPreset.Micro);
+    }
+
+    /// <summary>
+    /// 获取中等面板圆角半径。
+    /// 用于悬浮菜单、小提示框、子面板等。
+    /// </summary>
+    /// <param name="context">外观上下文</param>
+    /// <returns>中等面板圆角半径（像素）</returns>
+    public static double GetMediumPanelCornerRadius(this IPluginAppearanceContext context)
+    {
+        ArgumentNullException.ThrowIfNull(context);
+        return context.ResolveCornerRadius(PluginCornerRadiusPreset.Md);
+    }
+
+    /// <summary>
+    /// 获取大面板圆角半径。
+    /// 用于对话框、设置面板等大型容器（非桌面组件）。
+    /// </summary>
+    /// <param name="context">外观上下文</param>
+    /// <returns>大面板圆角半径（像素）</returns>
+    public static double GetLargePanelCornerRadius(this IPluginAppearanceContext context)
+    {
+        ArgumentNullException.ThrowIfNull(context);
+        return context.ResolveCornerRadius(PluginCornerRadiusPreset.Lg);
+    }
+
+    /// <summary>
+    /// 将圆角预设转换为 Avalonia CornerRadius。
+    /// </summary>
+    /// <param name="context">外观上下文</param>
+    /// <param name="preset">圆角预设</param>
+    /// <returns>Avalonia CornerRadius 结构</returns>
+    public static CornerRadius ToCornerRadius(this IPluginAppearanceContext context, PluginCornerRadiusPreset preset)
+    {
+        ArgumentNullException.ThrowIfNull(context);
+        var radius = context.ResolveCornerRadius(preset);
+        return new CornerRadius(radius);
+    }
+
+    /// <summary>
+    /// 获取当前主题变体（亮色/暗色）。
+    /// </summary>
+    /// <param name="context">外观上下文</param>
+    /// <returns>是否为暗色主题</returns>
+    public static bool IsDarkTheme(this IPluginAppearanceContext context)
+    {
+        ArgumentNullException.ThrowIfNull(context);
+        return string.Equals(context.Snapshot.ThemeVariant, "Dark", StringComparison.OrdinalIgnoreCase);
+    }
+
+    /// <summary>
+    /// 获取当前主题变体字符串。
+    /// </summary>
+    /// <param name="context">外观上下文</param>
+    /// <returns>主题变体字符串（"Light" 或 "Dark"）</returns>
+    public static string GetThemeVariant(this IPluginAppearanceContext context)
+    {
+        ArgumentNullException.ThrowIfNull(context);
+        return context.Snapshot.ThemeVariant;
+    }
+}
+
+/// <summary>
+/// 内部元素层级，用于区分不同层级的圆角需求。
+/// </summary>
+public enum InnerElementLevel
+{
+    /// <summary>
+    /// 内部卡片：使用 Sm token（14px @ 1.0x）
+    /// </summary>
+    Card,
+
+    /// <summary>
+    /// 交互控件：使用 Xs token（12px @ 1.0x）
+    /// </summary>
+    Control,
+
+    /// <summary>
+    /// 微元素徽章：使用 Micro token（6px @ 1.0x）
+    /// </summary>
+    Badge
+}

LanMountainDesktop.PluginSdk/PluginDesktopComponentRegistration.cs

@@ -72,14 +72,11 @@ public sealed class PluginDesktopComponentRegistration
         var resolved = CornerRadiusResolver is not null
             ? CornerRadiusResolver(appearance, Math.Max(1d, cellSize))
             : CornerRadiusPreset == PluginCornerRadiusPreset.Default
-                ? appearance.ResolveScaledCornerRadius(
-                    Math.Clamp(Math.Max(1d, cellSize) * 0.22, 8, 18),
-                    8,
-                    18)
+                ? appearance.ResolveCornerRadius(PluginCornerRadiusPreset.Component)
                 : appearance.ResolveCornerRadius(CornerRadiusPreset);
 
         return double.IsFinite(resolved)
             ? Math.Max(0d, resolved)
-            : appearance.ResolveCornerRadius(PluginCornerRadiusPreset.Default);
+            : appearance.ResolveCornerRadius(PluginCornerRadiusPreset.Component);
     }
 }

LanMountainDesktop.PluginSdk/PluginSdkInfo.cs

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

LanMountainDesktop.PluginSdk/PluginServiceCollectionExtensions.cs

@@ -28,6 +28,35 @@ public static class PluginServiceCollectionExtensions
         return services;
     }
 
+    /// <summary>
+    /// Registers a plugin settings section with a custom AXAML view.
+    /// The host application will display <typeparamref name="TView"/> directly
+    /// in the settings window, allowing the plugin to use any Fluent Avalonia controls
+    /// and custom layouts — just like built-in settings pages.
+    /// </summary>
+    /// <typeparam name="TView">A <see cref="SettingsPageBase"/> subclass that defines the settings UI using AXAML.</typeparam>
+    public static IServiceCollection AddPluginSettingsSection<TView>(
+        this IServiceCollection services,
+        string id,
+        string titleLocalizationKey,
+        string? descriptionLocalizationKey = null,
+        string iconKey = "PuzzlePiece",
+        int sortOrder = 0)
+        where TView : SettingsPageBase
+    {
+        ArgumentNullException.ThrowIfNull(services);
+
+        var builder = new PluginSettingsSectionBuilder(
+            id,
+            titleLocalizationKey,
+            descriptionLocalizationKey,
+            iconKey,
+            sortOrder);
+        builder.SetCustomView<TView>();
+        services.AddSingleton(builder.Build());
+        return services;
+    }
+
     public static IServiceCollection AddPluginDesktopComponent<TControl>(
         this IServiceCollection services,
         PluginDesktopComponentOptions options)

LanMountainDesktop.PluginSdk/PluginSettingsSectionBuilder.cs

@@ -1,10 +1,13 @@
+using System;
 using System.Collections.Generic;
+using Avalonia.Controls;
 
 namespace LanMountainDesktop.PluginSdk;
 
 public sealed class PluginSettingsSectionBuilder
 {
     private readonly List<SettingsOptionDefinition> _options = [];
+    private Type? _customViewType;
 
     internal PluginSettingsSectionBuilder(
         string id,
@@ -30,8 +33,46 @@ public sealed class PluginSettingsSectionBuilder
 
     public int SortOrder { get; }
 
+    public Type? CustomViewType => _customViewType;
+
     public IReadOnlyList<SettingsOptionDefinition> Options => _options;
 
+    /// <summary>
+    /// Sets a custom AXAML view for this settings section.
+    /// The view type must be a subclass of <see cref="SettingsPageBase"/>.
+    /// When a custom view is provided, the host application will use it directly
+    /// instead of generating a page from the declared options, allowing the plugin
+    /// to use any Fluent Avalonia controls and custom layouts.
+    /// </summary>
+    /// <typeparam name="TView">A <see cref="SettingsPageBase"/> subclass that defines the settings UI.</typeparam>
+    public PluginSettingsSectionBuilder SetCustomView<TView>() where TView : SettingsPageBase
+    {
+        _customViewType = typeof(TView);
+        return this;
+    }
+
+    /// <summary>
+    /// Sets a custom AXAML view for this settings section.
+    /// The view type must be a subclass of <see cref="SettingsPageBase"/>.
+    /// When a custom view is provided, the host application will use it directly
+    /// instead of generating a page from the declared options.
+    /// </summary>
+    /// <param name="viewType">A <see cref="SettingsPageBase"/> subclass type that defines the settings UI.</param>
+    public PluginSettingsSectionBuilder SetCustomView(Type viewType)
+    {
+        ArgumentNullException.ThrowIfNull(viewType);
+
+        if (!typeof(SettingsPageBase).IsAssignableFrom(viewType))
+        {
+            throw new ArgumentException(
+                $"Custom view type must be a subclass of {nameof(SettingsPageBase)}.",
+                nameof(viewType));
+        }
+
+        _customViewType = viewType;
+        return this;
+    }
+
     public PluginSettingsSectionBuilder AddOption(SettingsOptionDefinition option)
     {
         ArgumentNullException.ThrowIfNull(option);
@@ -142,6 +183,7 @@ public sealed class PluginSettingsSectionBuilder
             _options.ToArray(),
             DescriptionLocalizationKey,
             IconKey,
-            SortOrder);
+            SortOrder,
+            _customViewType);
     }
 }

LanMountainDesktop.PluginSdk/PluginSettingsSectionRegistration.cs

@@ -1,3 +1,4 @@
+using System;
 using System.Collections.Generic;
 
 namespace LanMountainDesktop.PluginSdk;
@@ -10,7 +11,8 @@ public sealed class PluginSettingsSectionRegistration
         IReadOnlyList<SettingsOptionDefinition> options,
         string? descriptionLocalizationKey = null,
         string iconKey = "PuzzlePiece",
-        int sortOrder = 0)
+        int sortOrder = 0,
+        Type? customViewType = null)
     {
         ArgumentException.ThrowIfNullOrWhiteSpace(id);
         ArgumentException.ThrowIfNullOrWhiteSpace(titleLocalizationKey);
@@ -24,6 +26,15 @@ public sealed class PluginSettingsSectionRegistration
         IconKey = iconKey.Trim();
         SortOrder = sortOrder;
         Options = options ?? [];
+
+        if (customViewType is not null && !typeof(SettingsPageBase).IsAssignableFrom(customViewType))
+        {
+            throw new ArgumentException(
+                $"Custom view type must be a subclass of {nameof(SettingsPageBase)}.",
+                nameof(customViewType));
+        }
+
+        CustomViewType = customViewType;
     }
 
     public string Id { get; }
@@ -37,4 +48,11 @@ public sealed class PluginSettingsSectionRegistration
     public int SortOrder { get; }
 
     public IReadOnlyList<SettingsOptionDefinition> Options { get; }
+
+    /// <summary>
+    /// When set, the host application will instantiate this <see cref="SettingsPageBase"/> subclass
+    /// instead of generating a page from <see cref="Options"/>.
+    /// This allows plugins to provide fully custom AXAML views with any Fluent Avalonia controls.
+    /// </summary>
+    public Type? CustomViewType { get; }
 }

LanMountainDesktop.PluginSdk/README.md

@@ -14,7 +14,7 @@ Official SDK package for LanMountainDesktop plugins.
 
 ```xml
 <ItemGroup>
-  <PackageReference Include="LanMountainDesktop.PluginSdk" Version="4.0.0" />
+  <PackageReference Include="LanMountainDesktop.PluginSdk" Version="4.0.1" />
 </ItemGroup>
 ```
 

LanMountainDesktop.PluginSdk/SettingsPageCategory.cs

@@ -9,5 +9,6 @@ public enum SettingsPageCategory
     PluginCatalog = 35,
     [Obsolete("Use PluginCatalog instead.")]
     PluginMarket = 35,
-    About = 40
+    About = 40,
+    Dev = 50
 }

LanMountainDesktop.PluginTemplate/content/Plugin.cs

@@ -10,6 +10,38 @@ public sealed class Plugin : PluginBase
     public override void Initialize(HostBuilderContext context, IServiceCollection services)
     {
         _ = context;
+
+        // ── Option 1: Declarative settings (simple key-value options) ──────────
+        // The host generates a settings page automatically from the declared options.
+        // Supported option types: Toggle, Text, Number, Select, Path, List.
+        //
+        // services.AddPluginSettingsSection(
+        //     "my-plugin-settings",
+        //     "My Plugin Settings",
+        //     section => section
+        //         .AddToggle("enable_feature", "Enable Feature", defaultValue: true)
+        //         .AddNumber("refresh_interval", "Refresh Interval", defaultValue: 30, minimum: 5, maximum: 120),
+        //     iconKey: "PuzzlePiece");
+
+        // ── Option 2: Custom AXAML view (full Fluent Avalonia controls) ────────
+        // Provide a SettingsPageBase subclass to use any Fluent Avalonia control
+        // (SettingsExpander, ColorPicker, Slider, etc.) — just like built-in pages.
+        //
+        // services.AddPluginSettingsSection<MyCustomSettingsPage>(
+        //     "my-plugin-settings",
+        //     "My Plugin Settings",
+        //     iconKey: "PuzzlePiece");
+        //
+        // Or mix both: declare options AND set a custom view on the builder:
+        //
+        // services.AddPluginSettingsSection(
+        //     "my-plugin-settings",
+        //     "My Plugin Settings",
+        //     section => section
+        //         .SetCustomView<MyCustomSettingsPage>()
+        //         .AddToggle("enable_feature", "Enable Feature"),
+        //     iconKey: "PuzzlePiece");
+
         _ = services;
     }
 }

LanMountainDesktop.PluginTemplate/content/plugin.json

@@ -4,7 +4,7 @@
   "description": "__PLUGIN_DESCRIPTION__",
   "author": "__PLUGIN_AUTHOR__",
   "version": "1.0.0",
-  "apiVersion": "4.0.0",
+  "apiVersion": "4.0.1",
   "entranceAssembly": "LanMountainDesktop.PluginTemplate.dll",
   "sharedContracts": []
 }

LanMountainDesktop.PluginUpgradeHelper/LanMountainDesktop.PluginUpgradeHelper.csproj

@@ -0,0 +1,16 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>disable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <AssemblyName>LanMountainDesktop.PluginUpgradeHelper</AssemblyName>
+    <RootNamespace>LanMountainDesktop.PluginUpgradeHelper</RootNamespace>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\LanMountainDesktop.PluginSdk\LanMountainDesktop.PluginSdk.csproj" />
+  </ItemGroup>
+
+</Project>

LanMountainDesktop.PluginUpgradeHelper/Program.cs

@@ -0,0 +1,372 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.IO;
+using System.IO.Compression;
+using System.Linq;
+using System.Text;
+using System.Text.Json;
+using System.Threading;
+using LanMountainDesktop.PluginSdk;
+
+namespace LanMountainDesktop.PluginUpgradeHelper;
+
+internal static class Program
+{
+    private const string PendingUpgradesFileName = ".pending-plugin-upgrades.json";
+    private const string LogFileName = "plugin-upgrade-helper.log";
+
+    private static int Main(string[] args)
+    {
+        var logPath = Path.Combine(Path.GetTempPath(), "LanMountainDesktop", LogFileName);
+        Directory.CreateDirectory(Path.GetDirectoryName(logPath)!);
+        File.AppendAllText(logPath, $"\n[{DateTime.Now:O}] PluginUpgradeHelper started. Args: {string.Join(" ", args)}\n");
+
+        try
+        {
+            var parsedArgs = ParseArgs(args);
+
+            if (!parsedArgs.TryGetValue("plugins-dir", out var pluginsDirectory) ||
+                string.IsNullOrWhiteSpace(pluginsDirectory))
+            {
+                LogError(logPath, "Missing required argument: --plugins-dir");
+                return 1;
+            }
+
+            if (!parsedArgs.TryGetValue("parent-pid", out var parentPidStr) ||
+                !int.TryParse(parentPidStr, out var parentPid))
+            {
+                LogError(logPath, "Missing or invalid argument: --parent-pid");
+                return 1;
+            }
+
+            parsedArgs.TryGetValue("launch", out var launchCommand);
+
+            LogInfo(logPath, $"Waiting for parent process {parentPid} to exit...");
+            WaitForParentProcess(parentPid);
+
+            LogInfo(logPath, $"Processing pending upgrades in '{pluginsDirectory}'...");
+            var upgradeResults = ProcessPendingUpgrades(pluginsDirectory, logPath);
+
+            LogInfo(logPath, $"Upgrades completed. Success: {upgradeResults.SuccessCount}, Failed: {upgradeResults.FailureCount}");
+
+            if (!string.IsNullOrWhiteSpace(launchCommand))
+            {
+                LogInfo(logPath, $"Launching application: {launchCommand}");
+                LaunchApplication(launchCommand, parsedArgs);
+            }
+
+            return upgradeResults.FailureCount > 0 ? 2 : 0;
+        }
+        catch (Exception ex)
+        {
+            LogError(logPath, $"Unexpected error: {ex}");
+            return 1;
+        }
+    }
+
+    private static void WaitForParentProcess(int parentPid)
+    {
+        try
+        {
+            var parentProcess = Process.GetProcessById(parentPid);
+            parentProcess.WaitForExit(TimeSpan.FromSeconds(30));
+        }
+        catch (ArgumentException)
+        {
+            // Process already exited
+        }
+        catch (Exception)
+        {
+            // Ignore errors, continue anyway
+        }
+
+        Thread.Sleep(500);
+    }
+
+    private static UpgradeResults ProcessPendingUpgrades(string pluginsDirectory, string logPath)
+    {
+        var pendingUpgradesPath = Path.Combine(pluginsDirectory, PendingUpgradesFileName);
+        var successCount = 0;
+        var failureCount = 0;
+
+        if (!File.Exists(pendingUpgradesPath))
+        {
+            LogInfo(logPath, "No pending upgrades found.");
+            return new UpgradeResults(0, 0);
+        }
+
+        List<PendingUpgrade>? pendingUpgrades;
+        try
+        {
+            var json = File.ReadAllText(pendingUpgradesPath);
+            pendingUpgrades = JsonSerializer.Deserialize<List<PendingUpgrade>>(json);
+        }
+        catch (Exception ex)
+        {
+            LogError(logPath, $"Failed to read pending upgrades: {ex.Message}");
+            return new UpgradeResults(0, 0);
+        }
+
+        if (pendingUpgrades is null || pendingUpgrades.Count == 0)
+        {
+            LogInfo(logPath, "No pending upgrades to process.");
+            return new UpgradeResults(0, 0);
+        }
+
+        Directory.CreateDirectory(pluginsDirectory);
+        var pendingDeletionDir = Path.Combine(pluginsDirectory, ".pending-deletions");
+        Directory.CreateDirectory(pendingDeletionDir);
+
+        foreach (var upgrade in pendingUpgrades)
+        {
+            if (!upgrade.IsValid())
+            {
+                LogWarn(logPath, $"Skipping invalid upgrade entry for plugin '{upgrade.PluginId}'.");
+                failureCount++;
+                continue;
+            }
+
+            try
+            {
+                LogInfo(logPath, $"Processing upgrade for plugin '{upgrade.PluginId}' to version '{upgrade.TargetVersion}'...");
+
+                var manifest = ReadManifestFromPackage(upgrade.SourcePackagePath);
+                var destinationPath = Path.Combine(pluginsDirectory, BuildInstalledPackageFileName(manifest.Id));
+
+                RemoveExistingPluginPackages(pluginsDirectory, manifest.Id, destinationPath, pendingDeletionDir, logPath);
+
+                File.Copy(upgrade.SourcePackagePath, destinationPath, overwrite: true);
+
+                LogInfo(logPath, $"Successfully upgraded plugin '{upgrade.PluginId}' to '{upgrade.TargetVersion}'.");
+                successCount++;
+            }
+            catch (Exception ex)
+            {
+                LogError(logPath, $"Failed to upgrade plugin '{upgrade.PluginId}': {ex.Message}");
+                failureCount++;
+            }
+        }
+
+        try
+        {
+            File.Delete(pendingUpgradesPath);
+        }
+        catch (Exception ex)
+        {
+            LogWarn(logPath, $"Failed to delete pending upgrades file: {ex.Message}");
+        }
+
+        CleanupPendingDeletions(pendingDeletionDir, logPath);
+
+        return new UpgradeResults(successCount, failureCount);
+    }
+
+    private static void RemoveExistingPluginPackages(
+        string pluginsDirectory,
+        string pluginId,
+        string destinationPath,
+        string pendingDeletionDir,
+        string logPath)
+    {
+        var runtimeRootDirectory = EnsureTrailingSeparator(Path.Combine(Path.GetFullPath(pluginsDirectory), ".runtime"));
+
+        foreach (var existingPackagePath in Directory
+                     .EnumerateFiles(pluginsDirectory, "*.laapp", SearchOption.AllDirectories)
+                     .Select(Path.GetFullPath)
+                     .Where(path => !path.StartsWith(runtimeRootDirectory, StringComparison.OrdinalIgnoreCase)))
+        {
+            try
+            {
+                if (string.Equals(existingPackagePath, Path.GetFullPath(destinationPath), StringComparison.OrdinalIgnoreCase))
+                {
+                    continue;
+                }
+
+                var existingManifest = ReadManifestFromPackage(existingPackagePath);
+                if (!string.Equals(existingManifest.Id, pluginId, StringComparison.OrdinalIgnoreCase))
+                {
+                    continue;
+                }
+
+                TryDeleteOrMoveFile(existingPackagePath, pendingDeletionDir, logPath);
+            }
+            catch
+            {
+                // Ignore unrelated or malformed packages
+            }
+        }
+    }
+
+    private static void TryDeleteOrMoveFile(string filePath, string pendingDeletionDir, string logPath)
+    {
+        try
+        {
+            File.Delete(filePath);
+            LogInfo(logPath, $"Deleted existing package: {filePath}");
+        }
+        catch (IOException)
+        {
+            var fileName = Path.GetFileName(filePath);
+            var pendingPath = Path.Combine(pendingDeletionDir, $"{fileName}.{Guid.NewGuid():N}.pending");
+            try
+            {
+                File.Move(filePath, pendingPath);
+                LogInfo(logPath, $"Moved existing package to pending deletion: {filePath} -> {pendingPath}");
+            }
+            catch (Exception ex)
+            {
+                LogWarn(logPath, $"Failed to move existing package '{filePath}': {ex.Message}");
+            }
+        }
+    }
+
+    private static void CleanupPendingDeletions(string pendingDeletionDir, string logPath)
+    {
+        if (!Directory.Exists(pendingDeletionDir))
+        {
+            return;
+        }
+
+        foreach (var pendingFile in Directory.EnumerateFiles(pendingDeletionDir, "*.pending"))
+        {
+            try
+            {
+                File.Delete(pendingFile);
+            }
+            catch (Exception ex)
+            {
+                LogWarn(logPath, $"Failed to delete pending file '{pendingFile}': {ex.Message}");
+            }
+        }
+
+        try
+        {
+            if (Directory.GetFiles(pendingDeletionDir).Length == 0 &&
+                Directory.GetDirectories(pendingDeletionDir).Length == 0)
+            {
+                Directory.Delete(pendingDeletionDir);
+            }
+        }
+        catch
+        {
+            // Ignore
+        }
+    }
+
+    private static void LaunchApplication(string launchCommand, Dictionary<string, string> args)
+    {
+        try
+        {
+            var startInfo = new ProcessStartInfo
+            {
+                FileName = launchCommand,
+                UseShellExecute = true,
+                WorkingDirectory = args.TryGetValue("working-dir", out var workingDir)
+                    ? workingDir
+                    : AppContext.BaseDirectory
+            };
+
+            if (args.TryGetValue("launch-args", out var launchArgs) && !string.IsNullOrWhiteSpace(launchArgs))
+            {
+                startInfo.Arguments = launchArgs;
+            }
+
+            Process.Start(startInfo);
+        }
+        catch (Exception ex)
+        {
+            Debug.WriteLine($"[PluginUpgradeHelper] Failed to launch application: {ex}");
+        }
+    }
+
+    private static PluginManifest ReadManifestFromPackage(string packagePath)
+    {
+        using var archive = ZipFile.OpenRead(packagePath);
+        var entries = archive.Entries
+            .Where(entry => string.Equals(entry.Name, "plugin.json", StringComparison.OrdinalIgnoreCase))
+            .ToArray();
+
+        if (entries.Length == 0)
+        {
+            throw new InvalidOperationException($"Plugin package '{packagePath}' does not contain 'plugin.json'.");
+        }
+
+        if (entries.Length > 1)
+        {
+            throw new InvalidOperationException($"Plugin package '{packagePath}' contains multiple 'plugin.json' files.");
+        }
+
+        using var stream = entries[0].Open();
+        return PluginManifest.Load(stream, $"{packagePath}!/{entries[0].FullName}");
+    }
+
+    private static string BuildInstalledPackageFileName(string pluginId)
+    {
+        var invalidChars = Path.GetInvalidFileNameChars();
+        var fileName = new string(pluginId.Select(ch => invalidChars.Contains(ch) ? '_' : ch).ToArray());
+        return fileName + ".laapp";
+    }
+
+    private static string EnsureTrailingSeparator(string path)
+    {
+        return path.EndsWith(Path.DirectorySeparatorChar.ToString(), StringComparison.Ordinal)
+            ? path
+            : path + Path.DirectorySeparatorChar;
+    }
+
+    private static Dictionary<string, string> ParseArgs(string[] args)
+    {
+        var values = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
+        for (var i = 0; i < args.Length; i++)
+        {
+            var current = args[i];
+            if (!current.StartsWith("--", StringComparison.Ordinal))
+            {
+                continue;
+            }
+
+            var key = current[2..];
+            if (string.IsNullOrWhiteSpace(key) || i + 1 >= args.Length)
+            {
+                continue;
+            }
+
+            values[key] = args[++i];
+        }
+
+        return values;
+    }
+
+    private static void LogInfo(string logPath, string message)
+    {
+        File.AppendAllText(logPath, $"[{DateTime.Now:O}] [INFO] {message}\n");
+    }
+
+    private static void LogWarn(string logPath, string message)
+    {
+        File.AppendAllText(logPath, $"[{DateTime.Now:O}] [WARN] {message}\n");
+    }
+
+    private static void LogError(string logPath, string message)
+    {
+        File.AppendAllText(logPath, $"[{DateTime.Now:O}] [ERROR] {message}\n");
+    }
+
+    private sealed record PendingUpgrade(
+        string PluginId,
+        string SourcePackagePath,
+        string TargetVersion,
+        DateTimeOffset CreatedAt)
+    {
+        public bool IsValid()
+        {
+            return !string.IsNullOrWhiteSpace(PluginId) &&
+                   !string.IsNullOrWhiteSpace(SourcePackagePath) &&
+                   !string.IsNullOrWhiteSpace(TargetVersion) &&
+                   File.Exists(SourcePackagePath);
+        }
+    }
+
+    private sealed record UpgradeResults(int SuccessCount, int FailureCount);
+}

LanMountainDesktop.PluginsInstallHelper/Program.cs

@@ -135,6 +135,9 @@ internal static class Program
     private static void RemoveExistingPluginPackages(string pluginsDirectory, string pluginId, string destinationPath, string stagingPath)
     {
         var runtimeRootDirectory = EnsureTrailingSeparator(Path.Combine(Path.GetFullPath(pluginsDirectory), PluginSdkInfo.RuntimeDirectoryName));
+        var pendingDeletionDir = Path.Combine(pluginsDirectory, ".pending-deletions");
+        Directory.CreateDirectory(pendingDeletionDir);
+
         foreach (var existingPackagePath in Directory
                      .EnumerateFiles(pluginsDirectory, "*" + PluginSdkInfo.PackageFileExtension, SearchOption.AllDirectories)
                      .Select(Path.GetFullPath)
@@ -154,13 +157,58 @@ internal static class Program
                     continue;
                 }
 
-                DeleteFileWithRetry(existingPackagePath);
+                TryRemoveExistingPackage(existingPackagePath, pendingDeletionDir);
             }
             catch
             {
                 // Ignore unrelated or malformed packages while replacing an install target.
             }
         }
+
+        CleanupPendingDeletions(pendingDeletionDir);
+    }
+
+    private static void TryRemoveExistingPackage(string existingPackagePath, string pendingDeletionDir)
+    {
+        try
+        {
+            DeleteFileWithRetry(existingPackagePath);
+        }
+        catch (IOException)
+        {
+            var fileName = Path.GetFileName(existingPackagePath);
+            var pendingPath = Path.Combine(pendingDeletionDir, $"{fileName}.{Guid.NewGuid():N}.pending");
+            try
+            {
+                File.Move(existingPackagePath, pendingPath);
+            }
+            catch (IOException moveEx)
+            {
+                throw new IOException(
+                    $"Cannot delete or move existing plugin package '{existingPackagePath}'. " +
+                    $"The file may be in use by another process. Error: {moveEx.Message}", moveEx);
+            }
+        }
+    }
+
+    private static void CleanupPendingDeletions(string pendingDeletionDir)
+    {
+        if (!Directory.Exists(pendingDeletionDir))
+        {
+            return;
+        }
+
+        foreach (var pendingFile in Directory.EnumerateFiles(pendingDeletionDir, "*.pending"))
+        {
+            try
+            {
+                File.Delete(pendingFile);
+            }
+            catch
+            {
+                // Ignore cleanup failures for pending deletions.
+            }
+        }
     }
 
     private static void CopyWithRetry(string sourcePath, string destinationPath, bool overwrite)

LanMountainDesktop.Tests/CornerRadiusStyleTests.cs

@@ -35,10 +35,11 @@ public sealed class CornerRadiusStyleTests
                 Component: 24d),
             ThemeVariant: "Light"));
 
-        // Preset resolution should return fixed values from tokens regardless of any legacy scale
+        // Preset resolution should return fixed values from tokens
         Assert.Equal(20d, context.ResolveCornerRadius(PluginCornerRadiusPreset.Md), 3);
-        Assert.Equal(20d, context.ResolveCornerRadius(PluginCornerRadiusPreset.Md, maximum: 15d), 3);
-        Assert.Equal(20d, context.ResolveScaledCornerRadius(18d), 3);
+        Assert.Equal(15d, context.ResolveCornerRadius(PluginCornerRadiusPreset.Md, maximum: 15d), 3);
+        // ResolveScaledCornerRadius returns baseRadius as-is when no min/max specified
+        Assert.Equal(18d, context.ResolveScaledCornerRadius(18d), 3);
         Assert.Equal(24d, context.ResolveCornerRadius(PluginCornerRadiusPreset.Component), 3);
     }
 
@@ -60,8 +61,12 @@ public sealed class CornerRadiusStyleTests
             96d,
             appearanceContext);
 
-        Assert.Equal(24d, context.ResolveScaledCornerRadius(12d), 3);
-        Assert.Equal(24d, context.ResolveScaledCornerRadius(12d, 8d, 18d), 3);
+        // ResolveScaledCornerRadius returns baseRadius as-is when no min/max specified
+        Assert.Equal(12d, context.ResolveScaledCornerRadius(12d), 3);
+        // When min/max specified, value is clamped
+        Assert.Equal(12d, context.ResolveScaledCornerRadius(12d, 8d, 18d), 3);
+        // Component token access
+        Assert.Equal(24d, context.CornerRadiusTokens.Component, 3);
     }
 
     private sealed class NullServiceProvider : IServiceProvider

LanMountainDesktop.slnx

@@ -8,6 +8,7 @@
   <Project Path="LanMountainDesktop.PluginSdk/LanMountainDesktop.PluginSdk.csproj" />
   <Project Path="LanMountainDesktop.PluginTemplate/LanMountainDesktop.PluginTemplate.csproj" />
   <Project Path="LanMountainDesktop.PluginsInstallHelper/LanMountainDesktop.PluginsInstallHelper.csproj" />
+  <Project Path="LanMountainDesktop.PluginUpgradeHelper/LanMountainDesktop.PluginUpgradeHelper.csproj" />
   <Project Path="LanMountainDesktop/LanMountainDesktop.csproj" />
   <Project Path="LanMountainDesktop.Tests/LanMountainDesktop.Tests.csproj" />
 </Solution>

LanMountainDesktop/App.axaml.cs

@@ -404,10 +404,7 @@ public partial class App : Application
             _traySettingsMenuItem.Header = L("tray.menu.settings", "Settings");
         }
 
-        if (_trayComponentLibraryMenuItem is not null)
-        {
-            _trayComponentLibraryMenuItem.Header = L("tray.menu.component_library", "Component Library");
-        }
+        RefreshFusedDesktopMenuItemVisibility();
 
         if (_trayRestartMenuItem is not null)
         {
@@ -420,6 +417,30 @@ public partial class App : Application
         }
     }
 
+    private void RefreshFusedDesktopMenuItemVisibility()
+    {
+        if (_trayComponentLibraryMenuItem is null)
+        {
+            return;
+        }
+
+        // 仅在 Windows 上支持融合桌面功能
+        if (!OperatingSystem.IsWindows())
+        {
+            _trayComponentLibraryMenuItem.IsVisible = false;
+            return;
+        }
+
+        // 检查融合桌面功能是否启用
+        var appSnapshot = _settingsFacade.Settings.LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App);
+        _trayComponentLibraryMenuItem.IsVisible = appSnapshot.EnableFusedDesktop;
+
+        if (_trayComponentLibraryMenuItem.IsVisible)
+        {
+            _trayComponentLibraryMenuItem.Header = L("tray.menu.component_library", "Component Library");
+        }
+    }
+
     private void DisposeTrayIcon()
     {
         if (_trayIcon is null)
@@ -687,6 +708,16 @@ public partial class App : Application
                 ApplyCurrentCultureFromSettings();
                 RefreshTrayIconContent();
             }
+
+            // 检查融合桌面设置是否变更
+            var fusedDesktopChanged =
+                refreshAll ||
+                changedKeys.Contains(nameof(AppSettingsSnapshot.EnableFusedDesktop), StringComparer.OrdinalIgnoreCase);
+
+            if (fusedDesktopChanged)
+            {
+                RefreshFusedDesktopMenuItemVisibility();
+            }
         }, DispatcherPriority.Background);
     }
 

LanMountainDesktop/ComponentSystem/BuiltInComponentIds.cs

@@ -47,4 +47,5 @@ public static class BuiltInComponentIds
     public const string DesktopFileManager = "DesktopFileManager";
     public const string DesktopNotificationBox = "DesktopNotificationBox";
     public const string DesktopShortcut = "DesktopShortcut";
+    public const string DesktopStickyNote = "DesktopStickyNote";
 }

LanMountainDesktop/ComponentSystem/ComponentRegistry.cs

@@ -327,6 +327,16 @@ public sealed class ComponentRegistry
                 AllowStatusBarPlacement: false,
                 AllowDesktopPlacement: true,
                 ResizeMode: DesktopComponentResizeMode.Free),
+            new DesktopComponentDefinition(
+                BuiltInComponentIds.DesktopStickyNote,
+                "Sticky Note",
+                "Notepad",
+                "Board",
+                MinWidthCells: 2,
+                MinHeightCells: 2,
+                AllowStatusBarPlacement: false,
+                AllowDesktopPlacement: true,
+                ResizeMode: DesktopComponentResizeMode.Free),
             new DesktopComponentDefinition(
                 BuiltInComponentIds.DesktopBrowser,
                 "Browser",

LanMountainDesktop/LanMountainDesktop.csproj

@@ -2,12 +2,12 @@
   <PropertyGroup>
     <OutputType>WinExe</OutputType>
     <TargetFramework>net10.0</TargetFramework>
+    <RollForward>LatestMajor</RollForward>
     <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>
 
   <!-- Keep Release defaults compatibility-first for desktop dependencies (WebView/interop/reflection). -->

LanMountainDesktop/Localization/en-US.json

@@ -564,6 +564,10 @@
     "settings.launcher.hidden_type_folder":  "Folder",
     "settings.launcher.hidden_type_shortcut":  "App",
     "settings.launcher.restore_button":  "Unhide",
+    "settings.launcher.appearance_header":  "Appearance",
+    "settings.launcher.appearance_desc":  "Customize the appearance of the App Launcher.",
+    "settings.launcher.show_tile_background_header":  "Show tile background",
+    "settings.launcher.show_tile_background_desc":  "Display a background card behind each app icon. When turned off, only the icon is shown for a cleaner look.",
     "settings.plugins.title":  "Plugins",
     "settings.plugins.runtime_header":  "Plugin Runtime",
     "settings.plugins.runtime_desc":  "Review plugin runtime state and load results.",
@@ -694,6 +698,7 @@
     "component.editor.placement_label": "Placement ID",
     "component.editor.scope_label": "Scope",
     "component.editor.scope_instance": "Instance-scoped editor",
+    "component_category.all":  "All",
     "component_category.clock":  "Clock",
     "component_category.date":  "Calendar",
     "component_category.weather":  "Weather",

LanMountainDesktop/Localization/zh-CN.json

@@ -558,6 +558,10 @@
     "settings.launcher.hidden_type_folder":  "文件夹",
     "settings.launcher.hidden_type_shortcut":  "应用",
     "settings.launcher.restore_button":  "取消隐藏",
+    "settings.launcher.appearance_header":  "外观",
+    "settings.launcher.appearance_desc":  "自定义应用启动台的外观样式。",
+    "settings.launcher.show_tile_background_header":  "显示图标卡片背景",
+    "settings.launcher.show_tile_background_desc":  "在应用图标后显示卡片背景，关闭后仅显示图标更加简洁。",
     "settings.plugins.title":  "插件",
     "settings.plugins.runtime_header":  "插件运行时",
     "settings.plugins.runtime_desc":  "查看插件运行时状态、加载结果与诊断信息。",
@@ -688,6 +692,7 @@
     "component.editor.placement_label": "实例 ID",
     "component.editor.scope_label": "作用域",
     "component.editor.scope_instance": "实例级编辑器",
+    "component_category.all":  "全部",
     "component_category.clock":  "时钟",
     "component_category.date":  "日历",
     "component_category.weather":  "天气",

LanMountainDesktop/Models/AppSettingsSnapshot.cs

@@ -152,8 +152,14 @@ public sealed class AppSettingsSnapshot
 
     public bool EnableThreeFingerSwipe { get; set; } = false;
 
+    public bool EnableFusedDesktop { get; set; } = false;
+
     public List<string> DisabledPluginIds { get; set; } = [];
 
+    public bool IsDevModeEnabled { get; set; }
+
+    public string? DevPluginPath { get; set; }
+
     #region Study Settings
 
     public bool StudyEnabled { get; set; } = true;

LanMountainDesktop/Models/ComponentSettingsSnapshot.cs

@@ -142,6 +142,12 @@ public sealed class ComponentSettingsSnapshot
 
     #endregion
 
+    #region Sticky Note Component Settings (便签组件设置)
+
+    public string StickyNoteContent { get; set; } = string.Empty;
+
+    #endregion
+
     public ComponentSettingsSnapshot Clone()
     {
         var clone = (ComponentSettingsSnapshot)MemberwiseClone();

LanMountainDesktop/Models/LauncherSettingsSnapshot.cs

@@ -8,6 +8,8 @@ public sealed class LauncherSettingsSnapshot
 
     public List<string> HiddenLauncherAppPaths { get; set; } = [];
 
+    public bool ShowTileBackground { get; set; } = true;
+
     public LauncherSettingsSnapshot Clone()
     {
         var clone = (LauncherSettingsSnapshot)MemberwiseClone();

LanMountainDesktop/Program.cs

@@ -6,6 +6,7 @@ using Avalonia;
 using Avalonia.WebView.Desktop;
 using LanMountainDesktop.DesktopHost;
 using LanMountainDesktop.Models;
+using LanMountainDesktop.Plugins;
 using LanMountainDesktop.Services;
 using LanMountainDesktop.Services.Settings;
 
@@ -19,6 +20,7 @@ public sealed class Program
     public static void Main(string[] args)
     {
         AppLogger.Initialize();
+        DevPluginOptions.Parse(args);
         RegisterGlobalExceptionLogging();
         var restartParentProcessId = AppRestartService.TryGetRestartParentProcessId(args);
 

LanMountainDesktop/Services/FusedDesktopManagerService.cs

@@ -58,6 +58,14 @@ internal sealed class FusedDesktopManagerService : IFusedDesktopManagerService
     {
         if (!OperatingSystem.IsWindows()) return;
         
+        // 检查融合桌面功能是否启用
+        var appSnapshot = _settingsFacade.Settings.LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App);
+        if (!appSnapshot.EnableFusedDesktop)
+        {
+            AppLogger.Info("FusedDesktop", "Fused desktop is disabled. Skipping initialization.");
+            return;
+        }
+        
         EnsureRegistries();
         ReloadWidgets();
     }

LanMountainDesktop/Services/HostApplicationLifecycleService.cs

@@ -1,5 +1,6 @@
 using System;
 using System.Diagnostics;
+using System.IO;
 using Avalonia;
 using Avalonia.Controls.ApplicationLifetimes;
 using Avalonia.Threading;
@@ -9,6 +10,8 @@ namespace LanMountainDesktop.Services;
 
 public sealed class HostApplicationLifecycleService : IHostApplicationLifecycle
 {
+    private const string UpgradeHelperExecutableName = "LanMountainDesktop.PluginUpgradeHelper.exe";
+
     public bool TryExit(HostApplicationLifecycleRequest? request = null)
     {
         App? app = null;
@@ -50,28 +53,14 @@ public sealed class HostApplicationLifecycleService : IHostApplicationLifecycle
         App? app = null;
         try
         {
-            var startInfo = AppRestartService.CreateRestartStartInfo();
-            if (startInfo is null)
+            app = Application.Current as App;
+
+            if (HasPendingPluginUpgrades())
             {
-                AppLogger.Warn(
-                    "HostLifecycle",
-                    $"Restart request rejected because restart start info could not be resolved. Source='{request?.Source ?? "Unknown"}'.");
-                return false;
+                return TryRestartWithUpgradeHelper(request);
             }
 
-            Process.Start(startInfo);
-            app = Application.Current as App;
-            app?.PrepareForShutdown(isRestart: true, request?.Source ?? "Unknown");
-            var exitRequest = request is null
-                ? new HostApplicationLifecycleRequest(Reason: "Restart accepted.")
-                : request with
-                {
-                    Reason = string.IsNullOrWhiteSpace(request.Reason)
-                        ? "Restart accepted."
-                        : request.Reason
-                };
-
-            return TryExit(exitRequest);
+            return TryRestartDirectly(request);
         }
         catch (Exception ex)
         {
@@ -80,4 +69,92 @@ public sealed class HostApplicationLifecycleService : IHostApplicationLifecycle
             return false;
         }
     }
+
+    private static bool HasPendingPluginUpgrades()
+    {
+        try
+        {
+            var pluginsDirectory = Path.Combine(
+                Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData),
+                "LanMountainDesktop",
+                "Extensions",
+                "Plugins");
+            var pendingUpgradesPath = Path.Combine(pluginsDirectory, ".pending-plugin-upgrades.json");
+            return File.Exists(pendingUpgradesPath);
+        }
+        catch
+        {
+            return false;
+        }
+    }
+
+    private bool TryRestartWithUpgradeHelper(HostApplicationLifecycleRequest? request)
+    {
+        AppLogger.Info("HostLifecycle", "Detected pending plugin upgrades. Using upgrade helper for restart.");
+
+        var helperPath = ResolveUpgradeHelperPath();
+        if (!File.Exists(helperPath))
+        {
+            AppLogger.Warn("HostLifecycle", $"Upgrade helper not found at '{helperPath}'. Falling back to direct restart.");
+            return TryRestartDirectly(request);
+        }
+
+        var pluginsDirectory = Path.Combine(
+            Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData),
+            "LanMountainDesktop",
+            "Extensions",
+            "Plugins");
+
+        var startInfo = AppRestartService.CreateRestartStartInfo();
+        var launchCommand = startInfo?.FileName ?? Process.GetCurrentProcess().MainModule?.FileName ?? AppContext.BaseDirectory;
+        var launchArgs = startInfo?.Arguments ?? "";
+
+        var helperStartInfo = new ProcessStartInfo
+        {
+            FileName = helperPath,
+            Arguments = $"--plugins-dir \"{pluginsDirectory}\" --parent-pid {Environment.ProcessId} --launch \"{launchCommand}\" --launch-args \"{launchArgs}\" --working-dir \"{AppContext.BaseDirectory}\"",
+            UseShellExecute = true,
+            WorkingDirectory = AppContext.BaseDirectory
+        };
+
+        AppLogger.Info("HostLifecycle", $"Starting upgrade helper: {helperStartInfo.FileName} {helperStartInfo.Arguments}");
+
+        Process.Start(helperStartInfo);
+
+        var app = Application.Current as App;
+        app?.PrepareForShutdown(isRestart: true, request?.Source ?? "Unknown");
+
+        return TryExit(request);
+    }
+
+    private bool TryRestartDirectly(HostApplicationLifecycleRequest? request)
+    {
+        var startInfo = AppRestartService.CreateRestartStartInfo();
+        if (startInfo is null)
+        {
+            AppLogger.Warn(
+                "HostLifecycle",
+                $"Restart request rejected because restart start info could not be resolved. Source='{request?.Source ?? "Unknown"}'.");
+            return false;
+        }
+
+        Process.Start(startInfo);
+        var app = Application.Current as App;
+        app?.PrepareForShutdown(isRestart: true, request?.Source ?? "Unknown");
+        var exitRequest = request is null
+            ? new HostApplicationLifecycleRequest(Reason: "Restart accepted.")
+            : request with
+            {
+                Reason = string.IsNullOrWhiteSpace(request.Reason)
+                    ? "Restart accepted."
+                    : request.Reason
+            };
+
+        return TryExit(exitRequest);
+    }
+
+    private static string ResolveUpgradeHelperPath()
+    {
+        return Path.Combine(AppContext.BaseDirectory, "PluginUpgradeHelper", UpgradeHelperExecutableName);
+    }
 }

LanMountainDesktop/Services/PendingPluginUpgradeService.cs

@@ -0,0 +1,160 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Text.Json;
+using System.Threading;
+
+namespace LanMountainDesktop.Services;
+
+public sealed class PendingPluginUpgradeService
+{
+    private const string PendingUpgradesFileName = ".pending-plugin-upgrades.json";
+    private static readonly Lock Gate = new();
+    private readonly string _pendingUpgradesFilePath;
+
+    public PendingPluginUpgradeService(string pluginsDirectory)
+    {
+        _pendingUpgradesFilePath = Path.Combine(pluginsDirectory, PendingUpgradesFileName);
+    }
+
+    public IReadOnlyList<PendingPluginUpgrade> GetPendingUpgrades()
+    {
+        lock (Gate)
+        {
+            return ReadPendingUpgradesCore();
+        }
+    }
+
+    public void AddPendingUpgrade(string pluginId, string sourcePackagePath, string targetVersion)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(pluginId);
+        ArgumentException.ThrowIfNullOrWhiteSpace(sourcePackagePath);
+        ArgumentException.ThrowIfNullOrWhiteSpace(targetVersion);
+
+        lock (Gate)
+        {
+            var upgrades = ReadPendingUpgradesCore().ToList();
+
+            upgrades.RemoveAll(u =>
+                string.Equals(u.PluginId, pluginId, StringComparison.OrdinalIgnoreCase));
+
+            upgrades.Add(new PendingPluginUpgrade(
+                pluginId,
+                Path.GetFullPath(sourcePackagePath),
+                targetVersion,
+                DateTimeOffset.UtcNow));
+
+            SavePendingUpgradesCore(upgrades);
+
+            AppLogger.Info(
+                "PendingPluginUpgrade",
+                $"Added pending upgrade. PluginId='{pluginId}'; TargetVersion='{targetVersion}'; SourcePath='{sourcePackagePath}'.");
+        }
+    }
+
+    public void RemovePendingUpgrade(string pluginId)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(pluginId);
+
+        lock (Gate)
+        {
+            var upgrades = ReadPendingUpgradesCore().ToList();
+            var removed = upgrades.RemoveAll(u =>
+                string.Equals(u.PluginId, pluginId, StringComparison.OrdinalIgnoreCase));
+
+            if (removed > 0)
+            {
+                SavePendingUpgradesCore(upgrades);
+                AppLogger.Info(
+                    "PendingPluginUpgrade",
+                    $"Removed pending upgrade. PluginId='{pluginId}'.");
+            }
+        }
+    }
+
+    public void ClearPendingUpgrades()
+    {
+        lock (Gate)
+        {
+            if (File.Exists(_pendingUpgradesFilePath))
+            {
+                File.Delete(_pendingUpgradesFilePath);
+                AppLogger.Info("PendingPluginUpgrade", "Cleared all pending upgrades.");
+            }
+        }
+    }
+
+    public bool HasPendingUpgrades()
+    {
+        lock (Gate)
+        {
+            return ReadPendingUpgradesCore().Count > 0;
+        }
+    }
+
+    private List<PendingPluginUpgrade> ReadPendingUpgradesCore()
+    {
+        if (!File.Exists(_pendingUpgradesFilePath))
+        {
+            return [];
+        }
+
+        try
+        {
+            var json = File.ReadAllText(_pendingUpgradesFilePath);
+            var upgrades = JsonSerializer.Deserialize<List<PendingPluginUpgrade>>(json);
+            return upgrades?.Where(u => u.IsValid()).ToList() ?? [];
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn(
+                "PendingPluginUpgrade",
+                $"Failed to read pending upgrades from '{_pendingUpgradesFilePath}'.",
+                ex);
+            return [];
+        }
+    }
+
+    private void SavePendingUpgradesCore(List<PendingPluginUpgrade> upgrades)
+    {
+        try
+        {
+            var directory = Path.GetDirectoryName(_pendingUpgradesFilePath);
+            if (!string.IsNullOrWhiteSpace(directory))
+            {
+                Directory.CreateDirectory(directory);
+            }
+
+            var json = JsonSerializer.Serialize(upgrades, new JsonSerializerOptions
+            {
+                WriteIndented = true
+            });
+
+            File.WriteAllText(_pendingUpgradesFilePath, json);
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Error(
+                "PendingPluginUpgrade",
+                $"Failed to save pending upgrades to '{_pendingUpgradesFilePath}'.",
+                ex);
+            throw;
+        }
+    }
+}
+
+public sealed record PendingPluginUpgrade(
+    string PluginId,
+    string SourcePackagePath,
+    string TargetVersion,
+    DateTimeOffset CreatedAt)
+{
+    public bool IsValid()
+    {
+        return !string.IsNullOrWhiteSpace(PluginId) &&
+               !string.IsNullOrWhiteSpace(SourcePackagePath) &&
+               !string.IsNullOrWhiteSpace(TargetVersion) &&
+               File.Exists(SourcePackagePath);
+    }
+}

LanMountainDesktop/Services/PowerManagementService.cs

@@ -113,6 +113,11 @@ internal sealed class WindowsPowerManagementService : IPowerManagementService
 
     public void ShowNativePowerUI(PowerAction action)
     {
+        // SlideToShutDown.exe 只支持关机，不支持重启
+        // 重启操作应该通过 RestartAsync() 使用 shutdown /r 命令
+        if (action != PowerAction.Shutdown)
+            return;
+
         var slideToShutDownPath = Environment.ExpandEnvironmentVariables(@"%windir%\System32\SlideToShutDown.exe");
         if (System.IO.File.Exists(slideToShutDownPath))
         {
@@ -124,26 +129,13 @@ internal sealed class WindowsPowerManagementService : IPowerManagementService
             return;
         }
 
-        switch (action)
+        // 回退到标准关机命令
+        Process.Start(new ProcessStartInfo
         {
-            case PowerAction.Shutdown:
-                Process.Start(new ProcessStartInfo
-                {
-                    FileName = "shutdown",
-                    Arguments = "/s /t 5 /c \"LanMountainDesktop: Shutting down...\"",
-                    UseShellExecute = true
-                });
-                break;
-
-            case PowerAction.Restart:
-                Process.Start(new ProcessStartInfo
-                {
-                    FileName = "shutdown",
-                    Arguments = "/r /t 5 /c \"LanMountainDesktop: Restarting...\"",
-                    UseShellExecute = true
-                });
-                break;
-        }
+            FileName = "shutdown",
+            Arguments = "/s /t 5 /c \"LanMountainDesktop: Shutting down...\"",
+            UseShellExecute = true
+        });
     }
 
     [DllImport("user32.dll", SetLastError = true)]

LanMountainDesktop/Services/Settings/SettingsPageRegistry.cs

@@ -3,6 +3,7 @@ using System.Collections.Generic;
 using System.Linq;
 using System.Reflection;
 using Avalonia.Controls;
+using LanMountainDesktop.Models;
 using LanMountainDesktop.PluginSdk;
 using LanMountainDesktop.Plugins;
 using LanMountainDesktop.Services.PluginMarket;
@@ -204,6 +205,10 @@ internal sealed class SettingsPageRegistry : ISettingsPageRegistry, IDisposable
         string? pluginId,
         bool isBuiltIn)
     {
+        var isDevModeEnabled = _settingsFacade.Settings
+            .LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App)
+            .IsDevModeEnabled;
+
         foreach (var pageType in assembly.GetTypes()
                      .Where(type => !type.IsAbstract && typeof(SettingsPageBase).IsAssignableFrom(type)))
         {
@@ -214,6 +219,12 @@ internal sealed class SettingsPageRegistry : ISettingsPageRegistry, IDisposable
             }
 
             var category = isBuiltIn ? pageInfo.Category : SettingsPageCategory.Plugins;
+
+            if (category == SettingsPageCategory.Dev && !isDevModeEnabled)
+            {
+                continue;
+            }
+
             var sortOrder = isBuiltIn ? pageInfo.SortOrder : 100 + pageInfo.SortOrder;
             var title = ResolveLocalizedText(pageInfo.TitleLocalizationKey, pageInfo.Name);
             var description = ResolveLocalizedText(pageInfo.DescriptionLocalizationKey, null);
@@ -256,6 +267,29 @@ internal sealed class SettingsPageRegistry : ISettingsPageRegistry, IDisposable
                 ? null
                 : localizer.GetString(section.DescriptionLocalizationKey, section.DescriptionLocalizationKey);
 
+            Func<ISettingsPageHostContext, Control> factory;
+
+            if (section.CustomViewType is not null)
+            {
+                var customViewType = section.CustomViewType;
+                var pluginServices = loadedPlugin.Services;
+                factory = hostContext => CreatePage(pluginServices, customViewType, hostContext);
+            }
+            else
+            {
+                factory = hostContext =>
+                {
+                    var page = new GeneratedPluginSettingsPage(
+                        new PluginGeneratedSettingsPageViewModel(
+                            _settingsFacade.Settings,
+                            loadedPlugin.Manifest.Id,
+                            section,
+                            localizer));
+                    page.InitializeHostContext(hostContext);
+                    return page;
+                };
+            }
+
             _pages.Add(new SettingsPageDescriptor(
                 pageId,
                 title,
@@ -270,17 +304,7 @@ internal sealed class SettingsPageRegistry : ISettingsPageRegistry, IDisposable
                 hidePageTitle: false,
                 useFullWidth: false,
                 groupId: null,
-                hostContext =>
-                {
-                    var page = new GeneratedPluginSettingsPage(
-                        new PluginGeneratedSettingsPageViewModel(
-                            _settingsFacade.Settings,
-                            loadedPlugin.Manifest.Id,
-                            section,
-                            localizer));
-                    page.InitializeHostContext(hostContext);
-                    return page;
-                }));
+                factory));
         }
     }
 

LanMountainDesktop/Services/Settings/SettingsWindowService.cs

@@ -72,6 +72,7 @@ internal sealed class SettingsWindowService : ISettingsWindowService
         _localizationService = new();
         _settingsFacade.Settings.Changed += OnSettingsChanged;
         _appearanceThemeService.Changed += OnAppearanceThemeChanged;
+        AppSettingsService.SettingsSaved += OnAppSettingsSaved;
     }
 
     private string L(string key)
@@ -279,6 +280,7 @@ internal sealed class SettingsWindowService : ISettingsWindowService
             var changedKeys = e.ChangedKeys?.ToArray();
             var refreshAll = changedKeys is null || changedKeys.Length == 0;
             var languageChanged = refreshAll || changedKeys.Contains(nameof(AppSettingsSnapshot.LanguageCode), StringComparer.OrdinalIgnoreCase);
+            var devModeChanged = refreshAll || changedKeys.Contains(nameof(AppSettingsSnapshot.IsDevModeEnabled), StringComparer.OrdinalIgnoreCase);
             var liveAppearance = _appearanceThemeService.GetCurrent();
             var themeChanged =
                 refreshAll ||
@@ -291,14 +293,13 @@ internal sealed class SettingsWindowService : ISettingsWindowService
                   changedKeys.Contains(nameof(AppSettingsSnapshot.WallpaperColor), StringComparer.OrdinalIgnoreCase))) ||
                 changedKeys.Contains(nameof(AppSettingsSnapshot.UseSystemChrome), StringComparer.OrdinalIgnoreCase);
 
-            if (languageChanged)
+            if (languageChanged || devModeChanged)
             {
                 var regionState = _settingsFacade.Region.Get();
-                // 清除本地化缓存，强制重新加载语言文件
                 _localizationService.ClearCache();
                 _viewModel.RefreshLanguage(regionState.LanguageCode);
                 _pageRegistry.Rebuild();
-                _window.ReloadPages(_viewModel.CurrentPageId);
+                _window.ReloadPages(devModeChanged ? "dev" : _viewModel.CurrentPageId);
                 _window.RefreshShellText();
             }
 
@@ -311,6 +312,31 @@ internal sealed class SettingsWindowService : ISettingsWindowService
         }, DispatcherPriority.Background);
     }
 
+    private void OnAppSettingsSaved(string instanceId)
+    {
+        Dispatcher.UIThread.Post(() =>
+        {
+            if (_window is null || _viewModel is null)
+            {
+                return;
+            }
+
+            var snapshot = _settingsFacade.Settings.LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App);
+            var devPageVisible = _pageRegistry.GetPages().Any(p => p.PageId == "dev");
+
+            if (snapshot.IsDevModeEnabled && !devPageVisible)
+            {
+                _pageRegistry.Rebuild();
+                _window.ReloadPages("dev");
+            }
+            else if (!snapshot.IsDevModeEnabled && devPageVisible)
+            {
+                _pageRegistry.Rebuild();
+                _window.ReloadPages(null);
+            }
+        }, DispatcherPriority.Background);
+    }
+
     private void ApplyTheme(SettingsWindow window)
     {
         var appearanceSnapshot = _appearanceThemeService.GetCurrent();

LanMountainDesktop/ViewModels/ComponentLibraryWindowViewModel.cs

@@ -10,6 +10,7 @@ namespace LanMountainDesktop.ViewModels;
 public sealed class ComponentLibraryWindowViewModel : ViewModelBase
 {
     private string _title = "Widgets";
+    private ComponentLibraryItemViewModel? _selectedComponent;
 
     public string Title
     {
@@ -20,6 +21,12 @@ public sealed class ComponentLibraryWindowViewModel : ViewModelBase
     public ObservableCollection<ComponentLibraryCategoryViewModel> Categories { get; } = [];
 
     public ObservableCollection<ComponentLibraryItemViewModel> Components { get; } = [];
+
+    public ComponentLibraryItemViewModel? SelectedComponent
+    {
+        get => _selectedComponent;
+        set => SetProperty(ref _selectedComponent, value);
+    }
 }
 
 public sealed class ComponentLibraryCategoryViewModel
@@ -51,6 +58,7 @@ public sealed class ComponentLibraryItemViewModel
     private readonly string _loadingPreviewText;
     private readonly string _previewUnavailableText;
     private string _displayName;
+    private string? _description;
     private ComponentPreviewKey _previewKey;
     private ComponentPreviewImageEntry? _previewImageEntry;
     private ComponentPreviewImageState _previewState;
@@ -61,12 +69,14 @@ public sealed class ComponentLibraryItemViewModel
         string componentId,
         string displayName,
         ComponentPreviewKey previewKey,
+        string? description = null,
         string loadingPreviewText = "Loading preview...",
         string previewUnavailableText = "Preview unavailable",
         ComponentPreviewImageEntry? previewImageEntry = null)
     {
         ComponentId = componentId;
         _displayName = displayName;
+        _description = description;
         _previewKey = previewKey;
         _loadingPreviewText = loadingPreviewText;
         _previewUnavailableText = previewUnavailableText;
@@ -82,6 +92,12 @@ public sealed class ComponentLibraryItemViewModel
         set => SetProperty(ref _displayName, value);
     }
 
+    public string? Description
+    {
+        get => _description;
+        set => SetProperty(ref _description, value);
+    }
+
     public ComponentPreviewKey PreviewKey
     {
         get => _previewKey;

LanMountainDesktop/ViewModels/LauncherSettingsPageViewModel.cs

@@ -117,6 +117,36 @@ public sealed partial class LauncherSettingsPageViewModel : ViewModelBase, IDisp
     [ObservableProperty]
     private bool _isHiddenItemsEmpty = true;
 
+    [ObservableProperty]
+    private string _appearanceHeader = string.Empty;
+
+    [ObservableProperty]
+    private string _appearanceDescription = string.Empty;
+
+    [ObservableProperty]
+    private string _showTileBackgroundHeader = string.Empty;
+
+    [ObservableProperty]
+    private string _showTileBackgroundDescription = string.Empty;
+
+    [ObservableProperty]
+    private bool _showTileBackground;
+
+    partial void OnShowTileBackgroundChanged(bool value)
+    {
+        SaveShowTileBackgroundSetting(value);
+    }
+
+    private void SaveShowTileBackgroundSetting(bool value)
+    {
+        var snapshot = _settingsFacade.LauncherPolicy.Get()?.Clone() ?? new LauncherSettingsSnapshot();
+        snapshot.ShowTileBackground = value;
+        _settingsFacade.Settings.SaveSnapshot(
+            SettingsScope.Launcher,
+            snapshot,
+            changedKeys: [nameof(LauncherSettingsSnapshot.ShowTileBackground)]);
+    }
+
     public void Dispose()
     {
         if (_disposed)
@@ -157,6 +187,8 @@ public sealed partial class LauncherSettingsPageViewModel : ViewModelBase, IDisp
             ResolveCulture(),
             L("settings.launcher.hidden_summary_format", "{0} hidden items"),
             HiddenItems.Count);
+
+        ShowTileBackground = snapshot.ShowTileBackground;
     }
 
     private StartMenuFolderNode LoadCatalogSafe()
@@ -317,6 +349,10 @@ public sealed partial class LauncherSettingsPageViewModel : ViewModelBase, IDisp
         HiddenDescription = L("settings.launcher.hidden_desc", "Review hidden launcher entries and show them again.");
         HiddenHint = L("settings.launcher.hidden_hint", "In desktop edit mode, select a launcher icon and click Hide. Hidden entries appear here.");
         HiddenEmptyText = L("settings.launcher.hidden_empty", "No hidden items.");
+        AppearanceHeader = L("settings.launcher.appearance_header", "Appearance");
+        AppearanceDescription = L("settings.launcher.appearance_desc", "Customize the appearance of the App Launcher.");
+        ShowTileBackgroundHeader = L("settings.launcher.show_tile_background_header", "Show tile background");
+        ShowTileBackgroundDescription = L("settings.launcher.show_tile_background_desc", "Display a background card behind each app icon in the launcher.");
     }
 
     private CultureInfo ResolveCulture()

LanMountainDesktop/ViewModels/SettingsViewModels.cs

@@ -174,9 +174,6 @@ public sealed partial class GeneralSettingsPageViewModel : ViewModelBase, IDispo
         private bool _isInitializing;
         private bool _disposed;
 
-        [ObservableProperty]
-        private bool _enableThreeFingerSwipe;
-
     public GeneralSettingsPageViewModel(ISettingsFacadeService settingsFacade)
     {
         _settingsFacade = settingsFacade;
@@ -204,7 +201,6 @@ public sealed partial class GeneralSettingsPageViewModel : ViewModelBase, IDispo
         SelectedRenderMode = RenderModes.FirstOrDefault(option =>
             string.Equals(option.Value, normalizedRenderMode, StringComparison.OrdinalIgnoreCase))
             ?? RenderModes[0];
-        EnableThreeFingerSwipe = appSnapshot.EnableThreeFingerSwipe;
         _isInitializing = false;
 
         RefreshPreview();
@@ -236,33 +232,6 @@ public sealed partial class GeneralSettingsPageViewModel : ViewModelBase, IDispo
         {
             return;
         }
-        
-        // 如果是其他设置变更，重新加载我们的设置
-        _isInitializing = true;
-        try
-        {
-            var appSnapshot = _settingsFacade.Settings.LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App);
-            EnableThreeFingerSwipe = appSnapshot.EnableThreeFingerSwipe;
-        }
-        finally
-        {
-            _isInitializing = false;
-        }
-    }
-
-    partial void OnEnableThreeFingerSwipeChanged(bool value)
-    {
-        if (_isInitializing)
-        {
-            return;
-        }
-
-        var appSnapshot = _settingsFacade.Settings.LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App);
-        appSnapshot.EnableThreeFingerSwipe = value;
-        _settingsFacade.Settings.SaveSnapshot(
-            SettingsScope.App,
-            appSnapshot,
-            changedKeys: [nameof(AppSettingsSnapshot.EnableThreeFingerSwipe)]);
     }
 
     public event Action? RestartRequested;
@@ -3088,3 +3057,104 @@ public sealed class PluginGeneratedSettingsPageViewModel
 
     public string? Description { get; }
 }
+
+public sealed partial class DevSettingsPageViewModel : ViewModelBase
+{
+    private readonly ISettingsFacadeService _settingsFacade;
+    private bool _isInitializing;
+
+    public DevSettingsPageViewModel(ISettingsFacadeService settingsFacade)
+    {
+        _settingsFacade = settingsFacade;
+        _isInitializing = true;
+        LoadSettings();
+        _isInitializing = false;
+
+        // 监听设置变更，防止被意外重置
+        _settingsFacade.Settings.Changed += OnSettingsChanged;
+    }
+
+    [ObservableProperty]
+    private bool _isDevModeEnabled;
+
+    [ObservableProperty]
+    private string _devPluginPath = string.Empty;
+
+    [ObservableProperty]
+    private bool _enableThreeFingerSwipe;
+
+    [ObservableProperty]
+    private bool _enableFusedDesktop;
+
+    partial void OnIsDevModeEnabledChanged(bool value)
+    {
+        if (_isInitializing) return;
+        SaveField(nameof(AppSettingsSnapshot.IsDevModeEnabled), value);
+    }
+
+    partial void OnDevPluginPathChanged(string value)
+    {
+        if (_isInitializing) return;
+        SaveField(nameof(AppSettingsSnapshot.DevPluginPath), value);
+    }
+
+    partial void OnEnableThreeFingerSwipeChanged(bool value)
+    {
+        if (_isInitializing) return;
+        SaveField(nameof(AppSettingsSnapshot.EnableThreeFingerSwipe), value);
+    }
+
+    partial void OnEnableFusedDesktopChanged(bool value)
+    {
+        if (_isInitializing) return;
+        SaveField(nameof(AppSettingsSnapshot.EnableFusedDesktop), value);
+    }
+
+    private void LoadSettings()
+    {
+        var snapshot = _settingsFacade.Settings.LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App);
+        IsDevModeEnabled = snapshot.IsDevModeEnabled;
+        DevPluginPath = snapshot.DevPluginPath ?? string.Empty;
+        EnableThreeFingerSwipe = snapshot.EnableThreeFingerSwipe;
+        EnableFusedDesktop = snapshot.EnableFusedDesktop;
+    }
+
+    private void OnSettingsChanged(object? sender, SettingsChangedEvent e)
+    {
+        if (e.Scope != SettingsScope.App)
+        {
+            return;
+        }
+
+        var changedKeys = e.ChangedKeys?.ToArray();
+        if (changedKeys is null || changedKeys.Length == 0)
+        {
+            return;
+        }
+
+        // 如果是其他设置变更，重新加载我们的设置
+        _isInitializing = true;
+        try
+        {
+            var snapshot = _settingsFacade.Settings.LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App);
+            EnableThreeFingerSwipe = snapshot.EnableThreeFingerSwipe;
+            EnableFusedDesktop = snapshot.EnableFusedDesktop;
+        }
+        finally
+        {
+            _isInitializing = false;
+        }
+    }
+
+    private void SaveField<T>(string key, T value)
+    {
+        var snapshot = _settingsFacade.Settings.LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App);
+        var property = typeof(AppSettingsSnapshot).GetProperty(key);
+        if (property is not null && property.CanWrite)
+        {
+            property.SetValue(snapshot, value);
+        }
+
+        _settingsFacade.Settings.SaveSnapshot(SettingsScope.App, snapshot, changedKeys: [key]);
+    }
+}

LanMountainDesktop/Views/ComponentLibraryWindow.axaml.cs

@@ -94,6 +94,7 @@ public partial class ComponentLibraryWindow : Window
             entry.ComponentId,
             displayName,
             previewKey,
+            description: null,
             _localize?.Invoke("component_library.preview.loading", "Loading preview...") ?? "Loading preview...",
             _localize?.Invoke("component_library.preview.unavailable", "Preview unavailable") ?? "Preview unavailable",
             previewEntry);

LanMountainDesktop/Views/Components/ClassScheduleWidget.axaml

@@ -34,11 +34,13 @@
                     <TextBlock x:Name="WeekdayTextBlock"
                                Text="周一"
                                TextAlignment="Right"
-                               FontWeight="SemiBold" />
+                               FontWeight="SemiBold"
+                               TextTrimming="CharacterEllipsis" />
                     <TextBlock x:Name="ClassCountTextBlock"
                                Text="0节课"
                                TextAlignment="Right"
-                               FontWeight="SemiBold" />
+                               FontWeight="SemiBold"
+                               TextTrimming="CharacterEllipsis" />
                 </StackPanel>
             </Grid>
 

LanMountainDesktop/Views/Components/ClassScheduleWidget.axaml.cs

@@ -725,6 +725,8 @@ public partial class ClassScheduleWidget : UserControl, IDesktopComponentWidget,
             ? CreateBrush("#FF4FC3F7")
             : CreateBrush("#FF4D5A");
         var normalBulletBrush = CreateBrush(_isNightVisual ? "#B8BEC9" : "#9AA3B2");
+        var primaryBrush = CreateBrush(_isNightVisual ? "#F9FBFF" : "#151821");
+        var secondaryBrush = CreateBrush(_isNightVisual ? "#848B99" : "#667084");
 
         for (var i = 0; i < _courseItems.Count && i < CourseListPanel.Children.Count; i++)
         {
@@ -746,19 +748,31 @@ public partial class ClassScheduleWidget : UserControl, IDesktopComponentWidget,
             var timeText = textStack.Children[1] as TextBlock;
             var detailText = textStack.Children[2] as TextBlock;
 
-            if (titleText != null && titleText.Text != item.Name)
+            if (titleText != null)
             {
-                titleText.Text = item.Name;
+                if (titleText.Text != item.Name)
+                {
+                    titleText.Text = item.Name;
+                }
+                titleText.Foreground = primaryBrush;
             }
 
-            if (timeText != null && timeText.Text != item.TimeRange)
+            if (timeText != null)
             {
-                timeText.Text = item.TimeRange;
+                if (timeText.Text != item.TimeRange)
+                {
+                    timeText.Text = item.TimeRange;
+                }
+                timeText.Foreground = secondaryBrush;
             }
 
-            if (detailText != null && detailText.Text != item.Detail)
+            if (detailText != null)
             {
-                detailText.Text = item.Detail;
+                if (detailText.Text != item.Detail)
+                {
+                    detailText.Text = item.Detail;
+                }
+                detailText.Foreground = secondaryBrush;
             }
         }
     }
@@ -914,7 +928,28 @@ public partial class ClassScheduleWidget : UserControl, IDesktopComponentWidget,
         MetaStack.Spacing = Math.Clamp(6 * scale, 3, 10);
         CourseListPanel.Spacing = Math.Clamp(6 * scale, 3, 10);
 
-        var dateFont = Math.Clamp(66 * scale, 26, 82);
+        var dateFontByScale = Math.Clamp(66 * scale, 26, 82);
+        var weekdayFontByScale = Math.Clamp(34 * scale, 13, 32);
+        var classCountFontByScale = Math.Clamp(40 * scale, 14, 36);
+
+        // 宽度感知：当头部内容总需求超过可用宽度时，按比例缩小日期字体
+        var availableWidth = Math.Max(1, Bounds.Width - rootPadding.Left - rootPadding.Right);
+        var dateGroupEstimatedWidth = dateFontByScale * 0.6 * 3 + DateGroup.Spacing * 2;
+        var metaStackEstimatedWidth = classCountFontByScale * 0.6 * 4 + MetaStack.Spacing;
+        var headerColumnSpacing = Math.Clamp(10 * scale, 4, 16);
+        var totalHeaderNeed = dateGroupEstimatedWidth + headerColumnSpacing + metaStackEstimatedWidth;
+
+        var dateFont = dateFontByScale;
+        if (totalHeaderNeed > availableWidth)
+        {
+            var shrinkRatio = availableWidth / totalHeaderNeed;
+            dateFont = Math.Max(20, dateFontByScale * shrinkRatio);
+        }
+
+        // 为 HeaderGrid 左列设置最小宽度，防止被压缩至零
+        var minDateColumnWidth = dateFont * 0.6 * 3 + DateGroup.Spacing * 2;
+        HeaderGrid.ColumnDefinitions[0].MinWidth = minDateColumnWidth;
+
         MonthTextBlock.FontSize = dateFont;
         DayTextBlock.FontSize = dateFont;
         SlashTextBlock.FontSize = dateFont;
@@ -926,8 +961,8 @@ public partial class ClassScheduleWidget : UserControl, IDesktopComponentWidget,
         ClassCountTextBlock.Foreground = CreateBrush(_isNightVisual ? "#8D95A4" : "#738095");
         StatusTextBlock.Foreground = CreateBrush(_isNightVisual ? "#9AA2B1" : "#4B5565");
 
-        WeekdayTextBlock.FontSize = Math.Clamp(34 * scale, 13, 32);
-        ClassCountTextBlock.FontSize = Math.Clamp(40 * scale, 14, 36);
+        WeekdayTextBlock.FontSize = weekdayFontByScale;
+        ClassCountTextBlock.FontSize = classCountFontByScale;
         StatusTextBlock.FontSize = Math.Clamp(30 * scale, 12, 30);
 
         WeekdayTextBlock.FontWeight = ToVariableWeight(Lerp(560, 700, Math.Clamp((scale - 0.60) / 1.2, 0, 1)));

LanMountainDesktop/Views/Components/CnrDailyNewsWidget.axaml.cs

@@ -704,6 +704,24 @@ public partial class CnrDailyNewsWidget : UserControl, IDesktopComponentWidget,
         ExtraNewsItemsPanel.Spacing = Math.Clamp(6 * scale, 3, 10);
 
         ApplyNightModeVisual();
+
+        var headerHeight = refreshHeight;
+        var newsItemHeight = Math.Max(imageHeight, mainNewsMinHeight);
+
+        var requiredHeight = verticalPadding * 2
+                          + headerHeight
+                          + rowSpacing
+                          + newsItemHeight
+                          + rowSpacing
+                          + newsItemHeight;
+
+        if (_extraNewsRows.Count > 0)
+        {
+            var extraSpacing = ExtraNewsItemsPanel.Spacing * (_extraNewsRows.Count - 1);
+            requiredHeight += rowSpacing + extraSpacing + _extraNewsRows.Count * newsItemHeight;
+        }
+
+        this.MinHeight = requiredHeight;
     }
 
     private void UpdateRefreshButtonState()
@@ -842,6 +860,11 @@ public partial class CnrDailyNewsWidget : UserControl, IDesktopComponentWidget,
         oldBitmap?.Dispose();
         _newsBitmaps[index] = bitmap;
         imageControl.Source = bitmap;
+
+        if (bitmap != null)
+        {
+            InvalidateMeasure();
+        }
     }
 
     private void DisposeNewsBitmaps()

LanMountainDesktop/Views/Components/DesktopComponentRuntimeRegistry.cs

@@ -452,6 +452,10 @@ public sealed class DesktopComponentRuntimeRegistry
                     BuiltInComponentIds.DesktopBlackboardLandscape,
                     "component.blackboard_landscape",
                     () => new WhiteboardWidget(baseWidthCells: 4)),
+                new DesktopComponentRuntimeRegistration(
+                    BuiltInComponentIds.DesktopStickyNote,
+                    "component.sticky_note",
+                    () => new StickyNoteWidget()),
                 new DesktopComponentRuntimeRegistration(
                     BuiltInComponentIds.DesktopBrowser,
                     "component.browser",

LanMountainDesktop/Views/Components/ShortcutWidget.axaml

@@ -8,9 +8,6 @@
              x:Class="LanMountainDesktop.Views.Components.ShortcutWidget">
 
     <Border x:Name="RootBorder"
-            Background="{DynamicResource AdaptiveSurfaceRaisedBrush}"
-            BorderBrush="{DynamicResource AdaptiveButtonBorderBrush}"
-            BorderThickness="1"
             CornerRadius="{DynamicResource DesignCornerRadiusComponent}"
             ClipToBounds="True">
         <Grid RowDefinitions="*,Auto"

LanMountainDesktop/Views/Components/ShortcutWidget.axaml.cs

@@ -25,6 +25,7 @@ public partial class ShortcutWidget : UserControl, IDesktopComponentWidget, ICom
     private bool _showBackground = true;
     private double _currentCellSize = 48;
     private bool _isDisposed;
+    private bool _chromeApplied;
 
     private const double TapMovementThreshold = 10;
     private const long TapTimeThresholdMs = 500;
@@ -40,9 +41,32 @@ public partial class ShortcutWidget : UserControl, IDesktopComponentWidget, ICom
     {
         InitializeComponent();
         DoubleTapped += OnDoubleTapped;
+        Loaded += OnLoaded;
         UpdateDisplay();
     }
 
+    private void OnLoaded(object? sender, RoutedEventArgs e)
+    {
+        // ApplyChrome() may have been called before the control was attached to the visual tree,
+        // causing FindResource() to fail. Re-apply now that resources are available.
+        if (!_chromeApplied)
+        {
+            ApplyChrome();
+        }
+
+        // Subscribe to theme changes so the background follows theme updates.
+        var themeService = HostAppearanceThemeProvider.GetOrCreate();
+        themeService.Changed += OnAppearanceThemeChanged;
+    }
+
+    private void OnAppearanceThemeChanged(object? sender, AppearanceThemeSnapshot e)
+    {
+        if (_isDisposed || _showBackground)
+        {
+            ApplyChrome();
+        }
+    }
+
     public void SetComponentPlacementContext(string componentId, string? placementId)
     {
         _componentId = string.IsNullOrWhiteSpace(componentId)
@@ -258,13 +282,25 @@ public partial class ShortcutWidget : UserControl, IDesktopComponentWidget, ICom
             RootBorder.Background = Brushes.Transparent;
             RootBorder.BorderBrush = Brushes.Transparent;
             RootBorder.BorderThickness = new Thickness(0);
+            _chromeApplied = true;
             return;
         }
 
-        // 恢复默认的实心背景样式
-        RootBorder.Background = this.FindResource("AdaptiveSurfaceRaisedBrush") as IBrush ?? Brushes.Transparent;
-        RootBorder.BorderBrush = this.FindResource("AdaptiveButtonBorderBrush") as IBrush ?? Brushes.Transparent;
+        // FindResource requires the control to be attached to the visual tree.
+        // If it returns null, _chromeApplied stays false so OnLoaded will retry.
+        var background = this.FindResource("AdaptiveSurfaceRaisedBrush") as IBrush;
+        var borderBrush = this.FindResource("AdaptiveButtonBorderBrush") as IBrush;
+
+        if (background is null || borderBrush is null)
+        {
+            _chromeApplied = false;
+            return;
+        }
+
+        RootBorder.Background = background;
+        RootBorder.BorderBrush = borderBrush;
         RootBorder.BorderThickness = new Thickness(1);
+        _chromeApplied = true;
     }
 
     protected override void OnPointerPressed(PointerPressedEventArgs e)
@@ -391,6 +427,10 @@ public partial class ShortcutWidget : UserControl, IDesktopComponentWidget, ICom
         }
 
         _isDisposed = true;
+
+        var themeService = HostAppearanceThemeProvider.GetOrCreate();
+        themeService.Changed -= OnAppearanceThemeChanged;
+
         _gestureStates.Clear();
     }
 }

LanMountainDesktop/Views/Components/StickyNoteWidget.axaml

@@ -0,0 +1,51 @@
+<UserControl xmlns="https://github.com/avaloniaui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+             xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
+             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+             xmlns:fi="using:FluentIcons.Avalonia"
+             xmlns:md="clr-namespace:Markdown.Avalonia;assembly=Markdown.Avalonia"
+             mc:Ignorable="d"
+             d:DesignWidth="200"
+             d:DesignHeight="200"
+             x:Class="LanMountainDesktop.Views.Components.StickyNoteWidget">
+
+    <Border x:Name="RootBorder"
+            CornerRadius="{DynamicResource DesignCornerRadiusComponent}"
+            BorderBrush="#E0C878"
+            BorderThickness="1">
+        <Grid>
+            <md:MarkdownScrollViewer x:Name="MarkdownViewer"
+                                     Margin="14,14,14,10"
+                                     IsVisible="True" />
+
+            <TextBox x:Name="NoteTextBox"
+                     AcceptsReturn="True"
+                     TextWrapping="Wrap"
+                     IsVisible="False"
+                     Background="Transparent"
+                     BorderThickness="0"
+                     Margin="14,14,14,10"
+                     FontFamily="Consolas,Cascadia Code,Courier New,monospace"
+                     Foreground="#5D4E37" />
+
+            <Button x:Name="ToggleButton"
+                    Width="28"
+                    Height="28"
+                    CornerRadius="14"
+                    HorizontalAlignment="Right"
+                    VerticalAlignment="Top"
+                    Margin="4,4,4,0"
+                    Padding="0"
+                    Background="#00000010"
+                    BorderThickness="0"
+                    Click="OnToggleButtonClick">
+                <fi:SymbolIcon x:Name="ToggleIcon"
+                               Symbol="Edit"
+                               IconVariant="Regular"
+                               FontSize="13"
+                               Foreground="#8B7D5A" />
+            </Button>
+        </Grid>
+    </Border>
+
+</UserControl>

LanMountainDesktop/Views/Components/StickyNoteWidget.axaml.cs

@@ -0,0 +1,371 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+using Avalonia;
+using Avalonia.Controls;
+using Avalonia.Interactivity;
+using Avalonia.Media;
+using Avalonia.Styling;
+using Avalonia.Threading;
+using FluentIcons.Common;
+using LanMountainDesktop.ComponentSystem;
+using LanMountainDesktop.Host.Abstractions;
+using LanMountainDesktop.Models;
+using LanMountainDesktop.PluginSdk;
+using LanMountainDesktop.Services.Settings;
+
+namespace LanMountainDesktop.Views.Components;
+
+public partial class StickyNoteWidget : UserControl,
+    IDesktopComponentWidget,
+    IComponentPlacementContextAware,
+    IComponentSettingsContextAware,
+    IDesktopPageVisibilityAwareComponentWidget,
+    IDisposable
+{
+    private static readonly Color LightNoteYellow = Color.FromRgb(0xFF, 0xF9, 0xC4);
+    private static readonly Color LightNoteBorder = Color.FromRgb(0xE0, 0xC8, 0x78);
+    private static readonly Color LightNoteForeground = Color.FromRgb(0x5D, 0x4E, 0x37);
+    private static readonly Color LightNoteHint = Color.FromRgb(0x8B, 0x7D, 0x5A);
+
+    private static readonly Color DarkNoteYellow = Color.FromRgb(0x5D, 0x52, 0x29);
+    private static readonly Color DarkNoteBorder = Color.FromRgb(0x7A, 0x6D, 0x3A);
+    private static readonly Color DarkNoteForeground = Color.FromRgb(0xE8, 0xE0, 0xC8);
+    private static readonly Color DarkNoteHint = Color.FromRgb(0xA0, 0x96, 0x70);
+
+    private string _componentId = BuiltInComponentIds.DesktopStickyNote;
+    private string _placementId = string.Empty;
+    private IComponentSettingsAccessor? _settingsAccessor;
+    private string _markdownContent = string.Empty;
+    private bool _isEditing;
+    private bool _isDirty;
+    private bool _isOnActivePage = true;
+    private bool _isEditMode;
+    private bool _disposed;
+    private bool _isApplyingPersistedContent;
+
+    private readonly DispatcherTimer _autoSaveTimer = new()
+    {
+        Interval = TimeSpan.FromSeconds(30)
+    };
+
+    private CancellationTokenSource? _renderDebounceCts;
+
+    public StickyNoteWidget()
+    {
+        InitializeComponent();
+
+        _autoSaveTimer.Tick += OnAutoSaveTimerTick;
+        NoteTextBox.TextChanged += OnNoteTextBoxTextChanged;
+        AttachedToVisualTree += OnAttachedToVisualTree;
+        DetachedFromVisualTree += OnDetachedFromVisualTree;
+
+        ApplyNoteColors();
+        UpdateDisplay();
+    }
+
+    public void ApplyCellSize(double cellSize)
+    {
+        var scale = Math.Clamp(cellSize / 48d, 0.82, 2.2);
+
+        RootBorder.CornerRadius = new CornerRadius(
+            ComponentChromeCornerRadiusHelper.ResolveMainRectangleRadiusValue(
+                new ComponentChromeContext(
+                    _componentId,
+                    _placementId,
+                    Math.Max(1, cellSize),
+                    Appearance.AppearanceCornerRadiusTokenFactory.Create(
+                        Settings.Core.GlobalAppearanceSettings.DefaultCornerRadiusStyle))));
+
+        RootBorder.Padding = new Thickness(
+            Math.Clamp(2 * scale, 1, 4),
+            Math.Clamp(2 * scale, 1, 4));
+
+        var contentMargin = Math.Clamp(12 * scale, 6, 20);
+        MarkdownViewer.Margin = new Thickness(contentMargin, contentMargin, contentMargin, contentMargin - 2);
+        NoteTextBox.Margin = new Thickness(contentMargin, contentMargin, contentMargin, contentMargin - 2);
+        NoteTextBox.FontSize = Math.Clamp(13 * scale, 10, 22);
+
+        var buttonSize = Math.Clamp(28 * scale, 22, 40);
+        ToggleButton.Width = buttonSize;
+        ToggleButton.Height = buttonSize;
+        ToggleButton.CornerRadius = new CornerRadius(buttonSize / 2d);
+        ToggleButton.Margin = new Thickness(Math.Clamp(4 * scale, 2, 8), Math.Clamp(4 * scale, 2, 8), Math.Clamp(4 * scale, 2, 8), 0);
+        ToggleIcon.FontSize = Math.Clamp(13 * scale, 10, 18);
+    }
+
+    public void SetComponentPlacementContext(string componentId, string? placementId)
+    {
+        if (_isDirty && !string.IsNullOrWhiteSpace(_placementId))
+        {
+            PersistNoteImmediately();
+        }
+
+        _componentId = string.IsNullOrWhiteSpace(componentId)
+            ? BuiltInComponentIds.DesktopStickyNote
+            : componentId.Trim();
+        _placementId = placementId?.Trim() ?? string.Empty;
+
+        if (_isEditing)
+        {
+            ExitEditMode();
+        }
+
+        LoadPersistedContent();
+    }
+
+    public void SetComponentSettingsContext(DesktopComponentSettingsContext context)
+    {
+        _settingsAccessor = context.ComponentSettingsAccessor;
+        LoadPersistedContent();
+    }
+
+    public void SetDesktopPageContext(bool isOnActivePage, bool isEditMode)
+    {
+        _isOnActivePage = isOnActivePage;
+        _isEditMode = isEditMode;
+
+        ToggleButton.IsHitTestVisible = !isEditMode;
+        NoteTextBox.IsReadOnly = isEditMode;
+
+        if (isEditMode && _isEditing)
+        {
+            ExitEditMode();
+        }
+    }
+
+    private void OnToggleButtonClick(object? sender, RoutedEventArgs e)
+    {
+        if (_isEditing)
+        {
+            ExitEditMode();
+        }
+        else
+        {
+            EnterEditMode();
+        }
+    }
+
+    private void EnterEditMode()
+    {
+        _isEditing = true;
+
+        NoteTextBox.Text = _markdownContent;
+        MarkdownViewer.IsVisible = false;
+        NoteTextBox.IsVisible = true;
+        ToggleIcon.Symbol = Symbol.Checkmark;
+
+        Dispatcher.UIThread.Post(() => NoteTextBox.Focus(), DispatcherPriority.Input);
+    }
+
+    private void ExitEditMode()
+    {
+        _isEditing = false;
+
+        var editedContent = NoteTextBox.Text ?? string.Empty;
+        if (editedContent != _markdownContent)
+        {
+            _markdownContent = editedContent;
+            _isDirty = true;
+        }
+
+        NoteTextBox.IsVisible = false;
+        MarkdownViewer.IsVisible = true;
+        ToggleIcon.Symbol = Symbol.Edit;
+
+        UpdateDisplay();
+
+        if (_isDirty)
+        {
+            PersistNoteImmediately();
+        }
+    }
+
+    private void OnNoteTextBoxTextChanged(object? sender, TextChangedEventArgs e)
+    {
+        if (_isApplyingPersistedContent || !_isEditing)
+        {
+            return;
+        }
+
+        _isDirty = true;
+
+        if (!_autoSaveTimer.IsEnabled)
+        {
+            _autoSaveTimer.Start();
+        }
+    }
+
+    private void OnAutoSaveTimerTick(object? sender, EventArgs e)
+    {
+        _autoSaveTimer.Stop();
+
+        if (_isDirty && _isEditing)
+        {
+            _markdownContent = NoteTextBox.Text ?? string.Empty;
+            PersistNoteImmediately();
+        }
+    }
+
+    private void UpdateDisplay()
+    {
+        try
+        {
+            if (string.IsNullOrWhiteSpace(_markdownContent))
+            {
+                MarkdownViewer.Markdown = "*Click ✏️ to write a note...*";
+                return;
+            }
+
+            _renderDebounceCts?.Cancel();
+            _renderDebounceCts?.Dispose();
+            _renderDebounceCts = new CancellationTokenSource();
+            var token = _renderDebounceCts.Token;
+
+            Dispatcher.UIThread.Post(async () =>
+            {
+                try
+                {
+                    await Task.Delay(150, token);
+                    if (!token.IsCancellationRequested)
+                    {
+                        MarkdownViewer.Markdown = _markdownContent;
+                    }
+                }
+                catch (OperationCanceledException) { }
+            });
+        }
+        catch (Exception ex)
+        {
+            MarkdownViewer.Markdown = $"*Error: {ex.Message}*";
+        }
+    }
+
+    private void LoadPersistedContent()
+    {
+        if (_settingsAccessor is null)
+        {
+            return;
+        }
+
+        try
+        {
+            var snapshot = _settingsAccessor.LoadSnapshot<ComponentSettingsSnapshot>();
+            _isApplyingPersistedContent = true;
+            _markdownContent = snapshot.StickyNoteContent ?? string.Empty;
+            _isDirty = false;
+            UpdateDisplay();
+        }
+        catch
+        {
+            _markdownContent = string.Empty;
+            UpdateDisplay();
+        }
+        finally
+        {
+            _isApplyingPersistedContent = false;
+        }
+    }
+
+    private void PersistNoteImmediately()
+    {
+        if (_settingsAccessor is null || _disposed)
+        {
+            return;
+        }
+
+        try
+        {
+            var snapshot = _settingsAccessor.LoadSnapshot<ComponentSettingsSnapshot>();
+            snapshot.StickyNoteContent = _markdownContent;
+            _settingsAccessor.SaveSnapshot(snapshot,
+                [nameof(ComponentSettingsSnapshot.StickyNoteContent)]);
+            _isDirty = false;
+        }
+        catch
+        {
+        }
+    }
+
+    private void ApplyNoteColors()
+    {
+        var isDark = Application.Current?.ActualThemeVariant == ThemeVariant.Dark;
+
+        if (isDark)
+        {
+            RootBorder.Background = new SolidColorBrush(DarkNoteYellow);
+            RootBorder.BorderBrush = new SolidColorBrush(DarkNoteBorder);
+            NoteTextBox.Foreground = new SolidColorBrush(DarkNoteForeground);
+            ToggleIcon.Foreground = new SolidColorBrush(DarkNoteHint);
+        }
+        else
+        {
+            RootBorder.Background = new SolidColorBrush(LightNoteYellow);
+            RootBorder.BorderBrush = new SolidColorBrush(LightNoteBorder);
+            NoteTextBox.Foreground = new SolidColorBrush(LightNoteForeground);
+            ToggleIcon.Foreground = new SolidColorBrush(LightNoteHint);
+        }
+    }
+
+    private void OnAttachedToVisualTree(object? sender, VisualTreeAttachmentEventArgs e)
+    {
+        Application.Current!.ActualThemeVariantChanged += OnThemeVariantChanged;
+        ApplyNoteColors();
+    }
+
+    private void OnDetachedFromVisualTree(object? sender, VisualTreeAttachmentEventArgs e)
+    {
+        Application.Current!.ActualThemeVariantChanged -= OnThemeVariantChanged;
+
+        if (_isDirty)
+        {
+            if (_isEditing)
+            {
+                _markdownContent = NoteTextBox.Text ?? string.Empty;
+            }
+            PersistNoteImmediately();
+        }
+
+        _autoSaveTimer.Stop();
+    }
+
+    private void OnThemeVariantChanged(object? sender, EventArgs e)
+    {
+        Dispatcher.UIThread.Post(ApplyNoteColors);
+    }
+
+    public void ForceSave()
+    {
+        if (_isEditing)
+        {
+            _markdownContent = NoteTextBox.Text ?? string.Empty;
+        }
+
+        if (_isDirty || _isEditing)
+        {
+            PersistNoteImmediately();
+        }
+    }
+
+    public void Dispose()
+    {
+        if (_disposed)
+        {
+            return;
+        }
+
+        _disposed = true;
+        _autoSaveTimer.Stop();
+        _renderDebounceCts?.Cancel();
+        _renderDebounceCts?.Dispose();
+
+        if (_isDirty)
+        {
+            if (_isEditing)
+            {
+                _markdownContent = NoteTextBox.Text ?? string.Empty;
+            }
+            PersistNoteImmediately();
+        }
+    }
+}

LanMountainDesktop/Views/Components/WhiteboardWidget.axaml.cs

@@ -40,13 +40,12 @@ public partial class WhiteboardWidget : UserControl, IDesktopComponentWidget, IC
     private WhiteboardToolMode _toolMode = WhiteboardToolMode.Pen;
     private bool? _isNightModeApplied;
     private SKColor _selectedInkColor = SKColors.Black;
+    private bool _isUserCustomColor;
     private float _selectedInkThickness = 2.5f;
     private string _componentId = BuiltInComponentIds.DesktopWhiteboard;
     private string _placementId = string.Empty;
     private int _noteRetentionDays = WhiteboardNoteRetentionPolicy.DefaultDays;
     private bool _isApplyingPersistedSnapshot;
-    private bool? _lastBitmapCacheEnabled;
-    private int _lastBitmapCacheSize;
     private bool _noteDirty;
     private int _noteLoadRevision;
     private bool _disposed;
@@ -121,10 +120,11 @@ public partial class WhiteboardWidget : UserControl, IDesktopComponentWidget, IC
         settings.IgnorePressure = true;
         settings.InkThickness = _selectedInkThickness;
         settings.EraserSize = new Size(20, 20);
+        settings.IsBitmapCacheEnabled = true;
+        settings.MaxBitmapCacheSize = 2048;
         InkCanvas.StrokeCollected += OnInkCanvasStrokeCollected;
         InkCanvas.PointerReleased += OnInkCanvasPointerReleased;
         InkCanvas.PointerCaptureLost += OnInkCanvasPointerCaptureLost;
-        UpdateInkCanvasCacheSettings(forceRefresh: true);
     }
 
     public void ApplyCellSize(double cellSize)
@@ -158,7 +158,6 @@ public partial class WhiteboardWidget : UserControl, IDesktopComponentWidget, IC
         var settings = InkCanvas.AvaloniaSkiaInkCanvas.Settings;
         var eraserSize = Math.Clamp(_currentCellSize * 0.42, 12, 44);
         settings.EraserSize = new Size(eraserSize, eraserSize);
-        UpdateInkCanvasCacheSettings(forceRefresh: false);
     }
 
     private void ApplyThemeVisual(bool force)
@@ -169,6 +168,7 @@ public partial class WhiteboardWidget : UserControl, IDesktopComponentWidget, IC
             return;
         }
 
+        var wasNightMode = _isNightModeApplied;
         _isNightModeApplied = isNightMode;
 
         RootBorder.Background = new SolidColorBrush(isNightMode ? Color.Parse("#FF181B22") : Color.Parse("#FFF1F4F9"));
@@ -177,9 +177,39 @@ public partial class WhiteboardWidget : UserControl, IDesktopComponentWidget, IC
         ToolbarBorder.Background = new SolidColorBrush(isNightMode ? Color.Parse("#1AFFFFFF") : Color.Parse("#E6FFFFFF"));
         ToolbarBorder.BorderBrush = new SolidColorBrush(isNightMode ? Color.Parse("#26FFFFFF") : Color.Parse("#16000000"));
 
+        ApplyThemeDefaultInkColor(isNightMode, wasNightMode);
         RefreshToolButtonVisuals();
     }
 
+    private void ApplyThemeDefaultInkColor(bool isNightMode, bool? wasNightMode)
+    {
+        if (_isUserCustomColor || wasNightMode == isNightMode)
+        {
+            return;
+        }
+
+        var oldDefault = wasNightMode == true ? SKColors.White : SKColors.Black;
+        var newDefault = isNightMode ? SKColors.White : SKColors.Black;
+
+        if (_selectedInkColor == oldDefault)
+        {
+            _selectedInkColor = newDefault;
+            if (_toolMode == WhiteboardToolMode.Pen)
+            {
+                InkCanvas.AvaloniaSkiaInkCanvas.Settings.InkColor = _selectedInkColor;
+            }
+
+            if (InkColorPicker is not null)
+            {
+                InkColorPicker.Color = new Color(
+                    _selectedInkColor.Alpha,
+                    _selectedInkColor.Red,
+                    _selectedInkColor.Green,
+                    _selectedInkColor.Blue);
+            }
+        }
+    }
+
     public void SetComponentPlacementContext(string componentId, string? placementId)
     {
         var nextComponentId = string.IsNullOrWhiteSpace(componentId)
@@ -431,7 +461,9 @@ public partial class WhiteboardWidget : UserControl, IDesktopComponentWidget, IC
     private void OnColorPickerColorChanged(object? sender, ColorChangedEventArgs e)
     {
         var color = e.NewColor;
-        SetInkColor(new SKColor(color.R, color.G, color.B, color.A));
+        var skColor = new SKColor(color.R, color.G, color.B, color.A);
+        _isUserCustomColor = skColor != SKColors.Black && skColor != SKColors.White;
+        SetInkColor(skColor);
     }
 
     private void OnInkThicknessSliderValueChanged(object? sender, RangeBaseValueChangedEventArgs e)
@@ -713,7 +745,8 @@ public partial class WhiteboardWidget : UserControl, IDesktopComponentWidget, IC
             InkCanvas.AvaloniaSkiaInkCanvas.AddStaticStroke(staticStroke);
         }
 
-        UpdateInkCanvasCacheSettings(forceRefresh: true);
+        InkCanvas.AvaloniaSkiaInkCanvas.UpdateBitmapCache();
+        InkCanvas.InvalidateVisual();
     }
 
     private static InkStylusPoint ConvertStylusPoint(WhiteboardStylusPointSnapshot point)
@@ -766,7 +799,9 @@ public partial class WhiteboardWidget : UserControl, IDesktopComponentWidget, IC
             }
         }
 
-        UpdateInkCanvasCacheSettings(forceRefresh: true);
+        InkCanvas.AvaloniaSkiaInkCanvas.UseBitmapCache(false);
+        InkCanvas.AvaloniaSkiaInkCanvas.InvalidateBitmapCache();
+        InkCanvas.InvalidateVisual();
     }
 
     private bool HasValidPersistenceContext()
@@ -784,47 +819,4 @@ public partial class WhiteboardWidget : UserControl, IDesktopComponentWidget, IC
 
         return Array.Empty<InkStylusPoint>();
     }
-
-    private void UpdateInkCanvasCacheSettings(bool forceRefresh)
-    {
-        var renderScaling = TopLevel.GetTopLevel(this)?.RenderScaling ?? 1d;
-        var widthPx = Math.Max(1d, CanvasBorder.Bounds.Width * renderScaling);
-        var heightPx = Math.Max(1d, CanvasBorder.Bounds.Height * renderScaling);
-        var longestSide = Math.Max(widthPx, heightPx);
-        var area = widthPx * heightPx;
-
-        var cacheEnabled = longestSide <= 1536d && area <= 1_400_000d;
-        var cacheSize = (int)Math.Clamp(Math.Ceiling(longestSide), 384d, 1536d);
-        if (!forceRefresh &&
-            _lastBitmapCacheEnabled == cacheEnabled &&
-            _lastBitmapCacheSize == cacheSize)
-        {
-            return;
-        }
-
-        _lastBitmapCacheEnabled = cacheEnabled;
-        _lastBitmapCacheSize = cacheSize;
-
-        var settings = InkCanvas.AvaloniaSkiaInkCanvas.Settings;
-        settings.IsBitmapCacheEnabled = cacheEnabled;
-        settings.MaxBitmapCacheSize = cacheSize;
-
-        try
-        {
-            InkCanvas.AvaloniaSkiaInkCanvas.UseBitmapCache(cacheEnabled);
-            if (cacheEnabled)
-            {
-                InkCanvas.AvaloniaSkiaInkCanvas.UpdateBitmapCache();
-            }
-            else
-            {
-                InkCanvas.AvaloniaSkiaInkCanvas.InvalidateBitmapCache();
-                InkCanvas.InvalidateVisual();
-            }
-        }
-        catch
-        {
-            // Keep drawing available even if the underlying cache backend rejects the cache update.
-        }
-    }
 }

LanMountainDesktop/Views/FusedDesktopComponentLibraryControl.axaml

@@ -1,160 +1,227 @@
 <UserControl xmlns="https://github.com/avaloniaui"
              xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
              xmlns:vm="using:LanMountainDesktop.ViewModels"
-             xmlns:fi="using:FluentIcons.Avalonia"
+             xmlns:ui="using:FluentAvalonia.UI.Controls"
+             xmlns:fi="using:FluentIcons.Avalonia.Fluent"
+             xmlns:converters="using:Avalonia.Data.Converters"
              x:Class="LanMountainDesktop.Views.FusedDesktopComponentLibraryControl"
              x:DataType="vm:ComponentLibraryWindowViewModel">
-    
-    <Grid ColumnDefinitions="240,*"
-          ColumnSpacing="12"
+
+    <UserControl.Styles>
+        <!-- 分类列表项样式 - 遵循 Fluent NavigationView 风格 -->
+        <Style Selector="ListBoxItem.category-item">
+            <Setter Property="Padding" Value="0"/>
+            <Setter Property="Margin" Value="0,2"/>
+            <Setter Property="Background" Value="Transparent"/>
+            <Setter Property="CornerRadius" Value="{DynamicResource DesignCornerRadiusSm}"/>
+            <Setter Property="Transitions">
+                <Transitions>
+                    <BrushTransition Property="Background" Duration="0:0:0.083" Easing="0.05,0.75,0.10,1.00"/>
+                </Transitions>
+            </Setter>
+        </Style>
+        <Style Selector="ListBoxItem.category-item:pointerover /template/ ContentPresenter#PART_ContentPresenter">
+            <Setter Property="Background" Value="{DynamicResource SubtleFillColorSecondaryBrush}"/>
+        </Style>
+        <Style Selector="ListBoxItem.category-item:selected /template/ ContentPresenter#PART_ContentPresenter">
+            <Setter Property="Background" Value="{DynamicResource AdaptiveNavItemSelectedBackgroundBrush}"/>
+        </Style>
+        <Style Selector="ListBoxItem.category-item:pressed /template/ ContentPresenter#PART_ContentPresenter">
+            <Setter Property="Background" Value="{DynamicResource SubtleFillColorTertiaryBrush}"/>
+        </Style>
+
+        <!-- 分类项图标和文字 -->
+        <Style Selector="ListBoxItem.category-item fi|FluentIcon.category-icon">
+            <Setter Property="Foreground" Value="{DynamicResource AdaptiveTextPrimaryBrush}"/>
+        </Style>
+        <Style Selector="ListBoxItem.category-item:selected fi|FluentIcon.category-icon">
+            <Setter Property="Foreground" Value="{DynamicResource AdaptiveTextPrimaryBrush}"/>
+        </Style>
+
+        <Style Selector="ListBoxItem.category-item TextBlock.category-text">
+            <Setter Property="Foreground" Value="{DynamicResource AdaptiveTextPrimaryBrush}"/>
+        </Style>
+        <Style Selector="ListBoxItem.category-item:selected TextBlock.category-text">
+            <Setter Property="Foreground" Value="{DynamicResource AdaptiveTextPrimaryBrush}"/>
+            <Setter Property="FontWeight" Value="SemiBold"/>
+        </Style>
+    </UserControl.Styles>
+
+    <Grid ColumnDefinitions="Auto,*"
+          ColumnSpacing="0"
           Margin="0">
-        <!-- 分类列表 (左侧) -->
-        <Border Classes="surface-translucent-panel"
-                CornerRadius="{DynamicResource DesignCornerRadiusLg}"
-                Padding="10">
-            <Grid RowDefinitions="Auto,*">
-                <TextBox x:Name="SearchBox"
-                         Watermark="搜索组件..."
-                         Margin="0,0,0,12"
-                         Classes="clear"
-                         Background="{DynamicResource AdaptiveSurfaceLowBrush}"
-                         CornerRadius="12"
-                         Padding="12,8">
-                    <TextBox.InnerLeftContent>
-                        <fi:SymbolIcon Symbol="Search" FontSize="16" Margin="10,0,0,0" Opacity="0.5" />
-                    </TextBox.InnerLeftContent>
-                </TextBox>
-                
+        <!-- 左侧导航列 - 分类列表 + 底部"查找更多组件" -->
+        <Border Width="280"
+                Background="Transparent">
+            <Grid RowDefinitions="*,Auto">
+                <!-- 分类列表 -->
                 <ListBox x:Name="CategoryListBox"
-                         Grid.Row="1"
+                         Grid.Row="0"
                          Background="Transparent"
                          BorderThickness="0"
+                         Margin="8,8,4,0"
                          SelectionChanged="OnCategorySelectionChanged"
                          ItemsSource="{Binding Categories}">
                     <ListBox.ItemTemplate>
                         <DataTemplate x:DataType="vm:ComponentLibraryCategoryViewModel">
-                            <Border Padding="10"
-                                    Margin="0,0,0,6"
-                                    CornerRadius="{DynamicResource DesignCornerRadiusSm}"
-                                    Background="{DynamicResource AdaptiveNavItemBackgroundBrush}">
-                                <Grid ColumnDefinitions="Auto,*"
-                                      ColumnSpacing="8">
-                                    <fi:SymbolIcon Symbol="{Binding Icon}"
-                                                   IconVariant="Regular"
-                                                   FontSize="16" />
-                                    <TextBlock Grid.Column="1"
-                                               VerticalAlignment="Center"
-                                               FontWeight="SemiBold"
-                                               Foreground="{DynamicResource AdaptiveTextPrimaryBrush}"
-                                               Text="{Binding Title}" />
-                                </Grid>
-                            </Border>
+                            <Grid ColumnDefinitions="Auto,*"
+                                  ColumnSpacing="12"
+                                  Margin="12,10">
+                                <fi:FluentIcon Icon="{Binding Icon}"
+                                               IconVariant="Regular"
+                                               FontSize="18"
+                                               Classes="category-icon"/>
+                                <TextBlock Grid.Column="1"
+                                           VerticalAlignment="Center"
+                                           FontSize="14"
+                                           Classes="category-text"
+                                           Text="{Binding Title}"/>
+                            </Grid>
                         </DataTemplate>
                     </ListBox.ItemTemplate>
                 </ListBox>
+
+                <!-- 底部"查找更多组件" - 在左侧导航列底部 -->
+                <StackPanel Grid.Row="1"
+                            Margin="12,8,8,12">
+                    <Border Height="1"
+                            Background="{DynamicResource AdaptiveGlassPanelBorderBrush}"
+                            Opacity="0.4"
+                            Margin="0,0,0,8"/>
+                    <Button Classes="hyperlink"
+                            HorizontalAlignment="Left"
+                            Click="OnFindMoreComponentsClick">
+                        <StackPanel Orientation="Horizontal" Spacing="6">
+                            <fi:FluentIcon Icon="Globe" IconVariant="Regular" FontSize="14"/>
+                            <TextBlock Text="查找更多组件"/>
+                        </StackPanel>
+                    </Button>
+                </StackPanel>
             </Grid>
         </Border>
 
-        <!-- 组件网格 (右侧) -->
+        <!-- 右侧内容区与左侧的分隔线 -->
         <Border Grid.Column="1"
-                Classes="surface-translucent-strong"
-                CornerRadius="{DynamicResource DesignCornerRadiusLg}"
-                Padding="10">
-            <ScrollViewer VerticalScrollBarVisibility="Auto"
-                          HorizontalScrollBarVisibility="Disabled">
-                <ItemsControl x:Name="ComponentItemsControl"
-                              ItemsSource="{Binding Components}">
-                    <ItemsControl.ItemsPanel>
-                        <ItemsPanelTemplate>
-                            <WrapPanel Orientation="Horizontal" />
-                        </ItemsPanelTemplate>
-                    </ItemsControl.ItemsPanel>
+                Width="1"
+                HorizontalAlignment="Left"
+                Background="{DynamicResource AdaptiveGlassPanelBorderBrush}"
+                Opacity="0.5"/>
 
-                    <ItemsControl.ItemTemplate>
-                        <DataTemplate x:DataType="vm:ComponentLibraryItemViewModel">
-                            <Border Width="240"
-                                    Height="220"
-                                    Margin="6"
-                                    CornerRadius="{DynamicResource DesignCornerRadiusComponent}"
-                                    Padding="10"
-                                    Background="{DynamicResource AdaptiveSurfaceRaisedBrush}"
-                                    BorderBrush="{DynamicResource AdaptiveButtonBorderBrush}"
-                                    BorderThickness="1">
-                                <Grid RowDefinitions="*,Auto,Auto"
-                                      RowSpacing="8">
-                                    <!-- 预览区域 -->
-                                    <Border CornerRadius="{DynamicResource DesignCornerRadiusSm}"
-                                            Background="{DynamicResource AdaptiveGlassPanelBackgroundBrush}"
-                                            BorderThickness="1"
-                                            BorderBrush="{DynamicResource AdaptiveGlassPanelBorderBrush}"
-                                            Padding="8">
-                                        <Grid>
-                                            <Image Source="{Binding PreviewBitmap}"
-                                                   Stretch="Uniform"
-                                                   HorizontalAlignment="Stretch"
-                                                   VerticalAlignment="Stretch"
-                                                   RenderOptions.BitmapInterpolationMode="HighQuality"
-                                                   IsVisible="{Binding IsPreviewReady}" />
+        <!-- 组件预览区 (右侧) -->
+        <ScrollViewer Grid.Column="1"
+                      VerticalScrollBarVisibility="Auto"
+                      HorizontalScrollBarVisibility="Disabled">
+            <StackPanel Margin="16,8,12,8"
+                        Spacing="0">
 
-                                            <!-- 加载中状态 -->
-                                            <Border IsVisible="{Binding IsPreviewPending}"
-                                                    Background="{DynamicResource AdaptiveSurfaceBaseBrush}">
-                                                <StackPanel HorizontalAlignment="Center"
-                                                            VerticalAlignment="Center"
-                                                            Spacing="8">
-                                                    <ProgressBar Width="96"
-                                                                 IsIndeterminate="True" />
-                                                    <TextBlock HorizontalAlignment="Center"
-                                                               TextAlignment="Center"
-                                                               FontSize="12"
-                                                               Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
-                                                               Text="{Binding PreviewStatusText}" />
-                                                </StackPanel>
-                                            </Border>
+                <!-- 有选中组件时的显示 -->
+                <Panel IsVisible="{Binding SelectedComponent, Converter={x:Static converters:ObjectConverters.IsNotNull}}">
 
-                                            <!-- 失败状态 -->
-                                            <Border IsVisible="{Binding IsPreviewFailed}"
-                                                    Background="{DynamicResource AdaptiveSurfaceBaseBrush}">
-                                                <StackPanel HorizontalAlignment="Center"
-                                                            VerticalAlignment="Center"
-                                                            Spacing="8">
-                                                    <TextBlock HorizontalAlignment="Center"
-                                                               TextAlignment="Center"
-                                                               FontWeight="SemiBold"
-                                                               Foreground="{DynamicResource AdaptiveTextPrimaryBrush}"
-                                                               Text="{Binding PreviewStatusText}" />
-                                                    <TextBlock HorizontalAlignment="Center"
-                                                               TextAlignment="Center"
-                                                               FontSize="12"
-                                                               TextWrapping="Wrap"
-                                                               Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
-                                                               Text="{Binding PreviewErrorMessage}" />
-                                                </StackPanel>
-                                            </Border>
-                                        </Grid>
+                    <!-- 组件展示面板 - 有独立背景色，与窗口背景形成层级分界 -->
+                    <Border Classes="surface-translucent-panel"
+                            CornerRadius="{DynamicResource DesignCornerRadiusLg}"
+                            Padding="20">
+                        <StackPanel Spacing="16">
+                            <!-- 组件标题 -->
+                            <TextBlock FontSize="28"
+                                       FontWeight="SemiBold"
+                                       Foreground="{DynamicResource AdaptiveTextPrimaryBrush}"
+                                       Text="{Binding SelectedComponent.DisplayName}"/>
+
+                            <!-- 固定大小的预览卡片 -->
+                            <Border CornerRadius="{DynamicResource DesignCornerRadiusSm}"
+                                    Background="{DynamicResource AdaptiveSurfaceBaseBrush}"
+                                    BorderBrush="{DynamicResource AdaptiveGlassPanelBorderBrush}"
+                                    BorderThickness="1"
+                                    Width="420"
+                                    Height="300"
+                                    HorizontalAlignment="Center">
+                                <Grid Margin="16">
+                                    <!-- 预览图片 -->
+                                    <Image Source="{Binding SelectedComponent.PreviewBitmap}"
+                                           Stretch="Uniform"
+                                           HorizontalAlignment="Center"
+                                           VerticalAlignment="Center"
+                                           RenderOptions.BitmapInterpolationMode="HighQuality"
+                                           IsVisible="{Binding SelectedComponent.IsPreviewReady}"/>
+
+                                    <!-- 加载中状态 -->
+                                    <Border IsVisible="{Binding SelectedComponent.IsPreviewPending}"
+                                            Background="{DynamicResource AdaptiveSurfaceBaseBrush}">
+                                        <StackPanel HorizontalAlignment="Center"
+                                                    VerticalAlignment="Center"
+                                                    Spacing="12">
+                                            <ProgressBar Width="120"
+                                                         IsIndeterminate="True"/>
+                                            <TextBlock HorizontalAlignment="Center"
+                                                       TextAlignment="Center"
+                                                       FontSize="14"
+                                                       Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
+                                                       Text="{Binding SelectedComponent.PreviewStatusText}"/>
+                                        </StackPanel>
                                     </Border>
 
-                                    <!-- 组件名称 -->
-                                    <TextBlock Grid.Row="1"
-                                               HorizontalAlignment="Center"
-                                               FontWeight="SemiBold"
-                                               Foreground="{DynamicResource AdaptiveTextPrimaryBrush}"
-                                               Text="{Binding DisplayName}" />
-
-                                    <!-- 添加按钮 -->
-                                    <Button Grid.Row="2"
-                                            HorizontalAlignment="Center"
-                                            Padding="12,6"
-                                            Tag="{Binding ComponentId}"
-                                            Click="OnAddComponentClick">
-                                        <TextBlock Text="添加到桌面" />
-                                    </Button>
+                                    <!-- 失败状态 -->
+                                    <Border IsVisible="{Binding SelectedComponent.IsPreviewFailed}"
+                                            Background="{DynamicResource AdaptiveSurfaceBaseBrush}">
+                                        <StackPanel HorizontalAlignment="Center"
+                                                    VerticalAlignment="Center"
+                                                    Spacing="8">
+                                            <fi:FluentIcon Icon="ImageOff"
+                                                           IconVariant="Regular"
+                                                           FontSize="48"
+                                                           Opacity="0.5"
+                                                           Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"/>
+                                            <TextBlock HorizontalAlignment="Center"
+                                                       TextAlignment="Center"
+                                                       FontWeight="SemiBold"
+                                                       Foreground="{DynamicResource AdaptiveTextPrimaryBrush}"
+                                                       Text="{Binding SelectedComponent.PreviewStatusText}"/>
+                                            <TextBlock HorizontalAlignment="Center"
+                                                       TextAlignment="Center"
+                                                       FontSize="12"
+                                                       TextWrapping="Wrap"
+                                                       Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
+                                                       Text="{Binding SelectedComponent.PreviewErrorMessage}"/>
+                                        </StackPanel>
+                                    </Border>
                                 </Grid>
                             </Border>
-                        </DataTemplate>
-                    </ItemsControl.ItemTemplate>
-                </ItemsControl>
-            </ScrollViewer>
-        </Border>
+
+                            <!-- "添加小组件"按钮 - 在面板内居中，使用主题强调色 -->
+                            <Button HorizontalAlignment="Center"
+                                    Classes="accent"
+                                    Padding="24,10"
+                                    Tag="{Binding SelectedComponent.ComponentId}"
+                                    Click="OnAddComponentClick">
+                                <StackPanel Orientation="Horizontal" Spacing="8">
+                                    <fi:FluentIcon Icon="Add" IconVariant="Regular" FontSize="16"/>
+                                    <TextBlock Text="添加小组件" FontWeight="SemiBold"/>
+                                </StackPanel>
+                            </Button>
+                        </StackPanel>
+                    </Border>
+                </Panel>
+
+                <!-- 空状态 -->
+                <Grid IsVisible="{Binding SelectedComponent, Converter={x:Static converters:ObjectConverters.IsNull}}"
+                      HorizontalAlignment="Center"
+                      VerticalAlignment="Center"
+                      MinHeight="400">
+                    <StackPanel Spacing="16" HorizontalAlignment="Center"
+                                VerticalAlignment="Center">
+                        <fi:FluentIcon Icon="Apps"
+                                       IconVariant="Regular"
+                                       FontSize="64"
+                                       Opacity="0.3"
+                                       Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"/>
+                        <TextBlock HorizontalAlignment="Center"
+                                   FontSize="16"
+                                   Foreground="{DynamicResource AdaptiveTextSecondaryBrush}"
+                                   Text="请从左侧选择一个组件"/>
+                    </StackPanel>
+                </Grid>
+            </StackPanel>
+        </ScrollViewer>
     </Grid>
 </UserControl>

LanMountainDesktop/Views/FusedDesktopComponentLibraryControl.axaml.cs

@@ -4,6 +4,7 @@ using System.Linq;
 using Avalonia;
 using Avalonia.Controls;
 using Avalonia.Interactivity;
+using Avalonia.VisualTree;
 using FluentIcons.Common;
 using LanMountainDesktop.ComponentSystem;
 using LanMountainDesktop.Services;
@@ -29,6 +30,8 @@ public partial class FusedDesktopComponentLibraryControl : UserControl
     private readonly IRecommendationInfoService _recommendationInfoService = new RecommendationDataService();
     private readonly ICalculatorDataService _calculatorDataService = new CalculatorDataService();
 
+    private static readonly LocalizationService _localizationService = new();
+
     public FusedDesktopComponentLibraryControl()
     {
         InitializeComponent();
@@ -39,7 +42,9 @@ public partial class FusedDesktopComponentLibraryControl : UserControl
 
         LoadRegistry();
         LoadCategories();
-        SearchBox.KeyUp += (s, e) => FilterComponents();
+
+        // 为 ListBoxItem 添加 category-item 样式类
+        CategoryListBox.ContainerPrepared += OnCategoryListBoxContainerPrepared;
 
         // 默认选择第一个分类
         if (_viewModel.Categories.Count > 0)
@@ -48,6 +53,14 @@ public partial class FusedDesktopComponentLibraryControl : UserControl
         }
     }
 
+    private void OnCategoryListBoxContainerPrepared(object? sender, ContainerPreparedEventArgs e)
+    {
+        if (e.Container is ListBoxItem listBoxItem)
+        {
+            listBoxItem.Classes.Add("category-item");
+        }
+    }
+
     private void LoadRegistry()
     {
         var pluginRuntimeService = (Application.Current as App)?.PluginRuntimeService;
@@ -65,28 +78,16 @@ public partial class FusedDesktopComponentLibraryControl : UserControl
     private void LoadCategories()
     {
         _viewModel.Categories.Clear();
-        _viewModel.Components.Clear();
+
+        var languageCode = _settingsFacade.Region.Get().LanguageCode;
 
         // 添加"全部组件"分类
         _viewModel.Categories.Add(new ComponentLibraryCategoryViewModel(
             "all",
-            "全部组件",
+            L(languageCode, "component_category.all", "All"),
             Symbol.Apps,
             Array.Empty<ComponentLibraryItemViewModel>()));
 
-        var categoryMap = new Dictionary<string, (string Display, Symbol Icon)>
-        {
-            { "clock", ("时钟", Symbol.Clock) },
-            { "date", ("日历", Symbol.CalendarDate) },
-            { "weather", ("天气", Symbol.WeatherSunny) },
-            { "board", ("画板", Symbol.Edit) },
-            { "media", ("媒体", Symbol.Play) },
-            { "info", ("资讯", Symbol.News) },
-            { "calculator", ("工具", Symbol.Calculator) },
-            { "study", ("学习", Symbol.Hourglass) },
-            { "file", ("文件", Symbol.Folder) }
-        };
-
         var usedCategories = _allDefinitions
             .Select(d => d.Category)
             .Distinct()
@@ -94,23 +95,62 @@ public partial class FusedDesktopComponentLibraryControl : UserControl
 
         foreach (var cat in usedCategories)
         {
-            if (categoryMap.TryGetValue(cat.ToLower(), out var info))
-            {
-                var categoryComponents = _allDefinitions
-                    .Where(d => string.Equals(d.Category, cat, StringComparison.OrdinalIgnoreCase))
-                    .OrderBy(d => d.DisplayName)
-                    .Select(d => CreateComponentItem(d))
-                    .ToArray();
+            var icon = ResolveCategoryIcon(cat);
+            var title = GetLocalizedCategoryTitle(languageCode, cat);
 
-                _viewModel.Categories.Add(new ComponentLibraryCategoryViewModel(
-                    cat,
-                    info.Display,
-                    info.Icon,
-                    categoryComponents));
-            }
+            var categoryComponents = _allDefinitions
+                .Where(d => string.Equals(d.Category, cat, StringComparison.OrdinalIgnoreCase))
+                .OrderBy(d => d.DisplayName)
+                .Select(d => CreateComponentItem(d))
+                .ToArray();
+
+            _viewModel.Categories.Add(new ComponentLibraryCategoryViewModel(
+                cat,
+                title,
+                icon,
+                categoryComponents));
         }
     }
 
+    /// <summary>
+    /// 分类图标映射 - 与阑山桌面 Dock 栏组件库 (MainWindow.ComponentSystem) 保持一致
+    /// </summary>
+    private static Symbol ResolveCategoryIcon(string categoryId)
+    {
+        if (string.Equals(categoryId, "Clock", StringComparison.OrdinalIgnoreCase)) return Symbol.Clock;
+        if (string.Equals(categoryId, "Date", StringComparison.OrdinalIgnoreCase)) return Symbol.CalendarDate;
+        if (string.Equals(categoryId, "Weather", StringComparison.OrdinalIgnoreCase)) return Symbol.WeatherSunny;
+        if (string.Equals(categoryId, "Board", StringComparison.OrdinalIgnoreCase)) return Symbol.Edit;
+        if (string.Equals(categoryId, "Media", StringComparison.OrdinalIgnoreCase)) return Symbol.Play;
+        if (string.Equals(categoryId, "Info", StringComparison.OrdinalIgnoreCase)) return Symbol.Apps;
+        if (string.Equals(categoryId, "Calculator", StringComparison.OrdinalIgnoreCase)) return Symbol.Calculator;
+        if (string.Equals(categoryId, "Study", StringComparison.OrdinalIgnoreCase)) return Symbol.Hourglass;
+        if (string.Equals(categoryId, "File", StringComparison.OrdinalIgnoreCase)) return Symbol.Folder;
+        return Symbol.Apps;
+    }
+
+    /// <summary>
+    /// 分类本地化标题 - 与阑山桌面 Dock 栏组件库 (MainWindow.ComponentSystem) 保持一致
+    /// </summary>
+    private string GetLocalizedCategoryTitle(string languageCode, string categoryId)
+    {
+        if (string.Equals(categoryId, "Clock", StringComparison.OrdinalIgnoreCase)) return L(languageCode, "component_category.clock", "Clock");
+        if (string.Equals(categoryId, "Date", StringComparison.OrdinalIgnoreCase)) return L(languageCode, "component_category.date", "Calendar");
+        if (string.Equals(categoryId, "Weather", StringComparison.OrdinalIgnoreCase)) return L(languageCode, "component_category.weather", "Weather");
+        if (string.Equals(categoryId, "Board", StringComparison.OrdinalIgnoreCase)) return L(languageCode, "component_category.board", "Board");
+        if (string.Equals(categoryId, "Media", StringComparison.OrdinalIgnoreCase)) return L(languageCode, "component_category.media", "Media");
+        if (string.Equals(categoryId, "Info", StringComparison.OrdinalIgnoreCase)) return L(languageCode, "component_category.info", "Info");
+        if (string.Equals(categoryId, "Calculator", StringComparison.OrdinalIgnoreCase)) return L(languageCode, "component_category.calculator", "Calculator");
+        if (string.Equals(categoryId, "Study", StringComparison.OrdinalIgnoreCase)) return L(languageCode, "component_category.study", "Study");
+        if (string.Equals(categoryId, "File", StringComparison.OrdinalIgnoreCase)) return L(languageCode, "component_category.file", "File");
+        return categoryId;
+    }
+
+    private string L(string languageCode, string key, string fallback)
+    {
+        return _localizationService.GetString(languageCode, key, fallback);
+    }
+
     private ComponentLibraryItemViewModel CreateComponentItem(DesktopComponentDefinition definition)
     {
         var previewKey = ComponentPreviewKey.ForComponentType(
@@ -130,10 +170,11 @@ public partial class FusedDesktopComponentLibraryControl : UserControl
             definition.Id,
             definition.DisplayName,
             previewKey,
+            description: null,
             "正在加载预览...",
             "预览不可用",
             previewEntry);
-            
+
         if (mainWindow is not null && (previewEntry is null || previewEntry.State == ComponentPreviewImageState.Pending))
         {
             mainWindow.RequestDetachedLibraryPreview(previewKey);
@@ -158,25 +199,49 @@ public partial class FusedDesktopComponentLibraryControl : UserControl
 
     private void OnCategorySelectionChanged(object? sender, SelectionChangedEventArgs e)
     {
-        FilterComponents();
+        UpdateSelectedComponent();
     }
 
-    private void FilterComponents()
+    private void UpdateSelectedComponent()
     {
-        var selectedCategory = (CategoryListBox.SelectedItem as ComponentLibraryCategoryViewModel)?.Id;
-        var searchText = SearchBox.Text?.ToLower() ?? "";
-
-        var filtered = _allDefinitions.Where(d =>
+        var selectedCategory = CategoryListBox.SelectedItem as ComponentLibraryCategoryViewModel;
+        if (selectedCategory is null)
         {
-            var matchesCategory = selectedCategory == "all" || string.Equals(d.Category, selectedCategory, StringComparison.OrdinalIgnoreCase);
-            var matchesSearch = string.IsNullOrEmpty(searchText) || d.DisplayName.ToLower().Contains(searchText) || d.Id.ToLower().Contains(searchText);
-            return matchesCategory && matchesSearch;
-        });
+            _viewModel.SelectedComponent = null;
+            return;
+        }
 
-        _viewModel.Components.Clear();
-        foreach (var def in filtered)
+        // 获取该分类下的组件列表
+        IEnumerable<DesktopComponentDefinition> filtered;
+        if (selectedCategory.Id == "all")
         {
-            _viewModel.Components.Add(CreateComponentItem(def));
+            filtered = _allDefinitions.OrderBy(d => d.DisplayName);
+        }
+        else
+        {
+            filtered = _allDefinitions
+                .Where(d => string.Equals(d.Category, selectedCategory.Id, StringComparison.OrdinalIgnoreCase))
+                .OrderBy(d => d.DisplayName);
+        }
+
+        // 选择该分类下的第一个组件作为默认选中
+        var firstComponent = filtered.FirstOrDefault();
+        if (firstComponent is not null)
+        {
+            // 查找或创建对应的 ViewModel
+            var existingComponent = selectedCategory.Components.FirstOrDefault(c => c.ComponentId == firstComponent.Id);
+            if (existingComponent is not null)
+            {
+                _viewModel.SelectedComponent = existingComponent;
+            }
+            else
+            {
+                _viewModel.SelectedComponent = CreateComponentItem(firstComponent);
+            }
+        }
+        else
+        {
+            _viewModel.SelectedComponent = null;
         }
     }
 
@@ -187,4 +252,22 @@ public partial class FusedDesktopComponentLibraryControl : UserControl
             AddComponentRequested?.Invoke(this, componentId);
         }
     }
+
+    private void OnFindMoreComponentsClick(object? sender, RoutedEventArgs e)
+    {
+        // 打开设置窗口并导航到插件目录页面
+        if (Application.Current is App app && app.SettingsWindowService is { } settingsWindowService)
+        {
+            var mainWindow = (Application.Current?.ApplicationLifetime as IClassicDesktopStyleApplicationLifetime)?.MainWindow as MainWindow;
+            var request = new SettingsWindowOpenRequest(
+                Source: "FusedDesktopComponentLibrary",
+                Owner: mainWindow,
+                PageId: "plugin-catalog");
+            settingsWindowService.Open(request);
+        }
+
+        // 关闭所在窗口
+        var window = this.FindAncestorOfType<Window>();
+        window?.Close();
+    }
 }

LanMountainDesktop/Views/FusedDesktopComponentLibraryWindow.axaml

@@ -1,57 +1,73 @@
 <Window xmlns="https://github.com/avaloniaui"
         xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
         xmlns:controls="using:LanMountainDesktop.Views"
-        xmlns:fi="using:FluentIcons.Avalonia"
+        xmlns:fi="using:FluentIcons.Avalonia.Fluent"
         x:Class="LanMountainDesktop.Views.FusedDesktopComponentLibraryWindow"
         Width="860" Height="620"
         MinWidth="600" MinHeight="500"
+        CanResize="True"
         WindowStartupLocation="CenterScreen"
-        SystemDecorations="Full"
+        SystemDecorations="BorderOnly"
         ExtendClientAreaToDecorationsHint="True"
         ExtendClientAreaChromeHints="NoChrome"
-        ExtendClientAreaTitleBarHeightHint="-1"
+        ExtendClientAreaTitleBarHeightHint="48"
         Background="Transparent"
-        TransparencyLevelHint="Mica"
-        Title="融合桌面组件库">
-    
-    <Panel>
-        <!-- 背景磨砂效果 -->
-        <Border Background="{DynamicResource AdaptiveSurfaceLowBrush}"
-                Opacity="0.85" />
-        
-        <Grid RowDefinitions="Auto,*">
-            <!-- 自定义标题栏 -->
-            <Border Background="Transparent"
-                    IsHitTestVisible="True"
-                    Padding="20,16">
-                <Grid ColumnDefinitions="*,Auto">
-                    <StackPanel Spacing="6" VerticalAlignment="Center">
-                        <TextBlock Text="融合桌面组件库"
-                                   FontWeight="SemiBold"
-                                   FontSize="20"
-                                   Foreground="{DynamicResource AdaptiveTextPrimaryBrush}" />
-                        <TextBlock Text="将精美组件放置在您的系统桌面上（负一屏）"
-                                   Opacity="0.6"
-                                   FontSize="13"
-                                   Foreground="{DynamicResource AdaptiveTextPrimaryBrush}" />
-                    </StackPanel>
-                    
-                    <Button Grid.Column="1"
-                            Classes="accent"
-                            Width="36" Height="36"
-                            Padding="0"
-                            CornerRadius="18"
-                            BorderThickness="0"
-                            Background="{DynamicResource AdaptiveButtonHoverBackgroundBrush}"
-                            Click="OnCloseClick">
-                        <fi:SymbolIcon Symbol="Dismiss" FontSize="18" />
-                    </Button>
-                </Grid>
-            </Border>
-            
-            <!-- 组件库控件 -->
-            <controls:FusedDesktopComponentLibraryControl x:Name="LibraryControl"
-                                                          Grid.Row="1" />
-        </Grid>
-    </Panel>
+        Title="添加小组件">
+
+    <Grid x:Name="RootGrid"
+          Classes="settings-scope"
+          Background="{DynamicResource AdaptiveSettingsWindowBackgroundBrush}"
+          RowDefinitions="Auto,*">
+        <!-- 自定义标题栏 - 与 SettingsWindow 风格一致 -->
+        <Border x:Name="WindowTitleBarHost"
+                Height="48"
+                Padding="12,0,12,0"
+                Background="{DynamicResource AdaptiveSettingsWindowBackgroundBrush}"
+                BorderBrush="{DynamicResource AdaptiveSettingsWindowBorderBrush}"
+                BorderThickness="0,0,0,1"
+                PointerPressed="OnWindowTitleBarPointerPressed">
+            <Grid ColumnDefinitions="Auto,Auto,*,Auto"
+                  ColumnSpacing="8"
+                  VerticalAlignment="Center">
+                <fi:FluentIcon x:Name="WindowBrandIcon"
+                               Icon="Apps"
+                               IconVariant="Filled"
+                               FontSize="16"
+                               IsHitTestVisible="False"
+                               VerticalAlignment="Center" />
+
+                <TextBlock x:Name="WindowTitleTextBlock"
+                           Grid.Column="1"
+                           FontSize="12"
+                           FontWeight="SemiBold"
+                           IsHitTestVisible="False"
+                           Text="添加小组件" />
+
+                <TextBlock Grid.Column="2"
+                           FontSize="12"
+                           Opacity="0.6"
+                           IsHitTestVisible="False"
+                           VerticalAlignment="Center"
+                           Text="将精美组件放置在您的系统桌面上（负一屏）" />
+
+                <Button x:Name="CloseWindowButton"
+                        Grid.Column="3"
+                        Width="40"
+                        Height="32"
+                        Padding="0"
+                        Background="Transparent"
+                        BorderThickness="0"
+                        Click="OnCloseClick">
+                    <fi:FluentIcon Icon="Dismiss"
+                                   IconVariant="Regular"
+                                   FontSize="16" />
+                </Button>
+            </Grid>
+        </Border>
+
+        <!-- 组件库控件 -->
+        <controls:FusedDesktopComponentLibraryControl x:Name="LibraryControl"
+                                                      Grid.Row="1"
+                                                      Margin="12,8,16,8" />
+    </Grid>
 </Window>

LanMountainDesktop/Views/FusedDesktopComponentLibraryWindow.axaml.cs

@@ -1,6 +1,7 @@
 using System;
 using Avalonia;
 using Avalonia.Controls;
+using Avalonia.Input;
 using Avalonia.Interactivity;
 using LanMountainDesktop.ComponentSystem;
 using LanMountainDesktop.Services;
@@ -102,6 +103,14 @@ public partial class FusedDesktopComponentLibraryWindow : Window
     {
         Close();
     }
+
+    private void OnWindowTitleBarPointerPressed(object? sender, PointerPressedEventArgs e)
+    {
+        if (e.GetCurrentPoint(this).Properties.IsLeftButtonPressed)
+        {
+            BeginMoveDrag(e);
+        }
+    }
     
     protected override void OnClosed(EventArgs e)
     {

LanMountainDesktop/Views/MainWindow.ComponentSystem.cs

@@ -400,10 +400,12 @@ public partial class MainWindow
 
         if (OperatingSystem.IsWindows())
         {
+            // Windows: 使用 SlideToShutDown 滑动关机界面
             _powerService.ShowNativePowerUI(PowerAction.Shutdown);
         }
         else
         {
+            // Linux: 二次确认对话框
             await ShowPowerConfirmDialogAsync(L("power.shutdown_confirm_title", "Shutdown"),
                 L("power.shutdown_confirm_message", "Are you sure you want to shut down this computer?"),
                 () => _powerService.ShutdownAsync());
@@ -416,16 +418,11 @@ public partial class MainWindow
         _ = e;
         ClosePopupIfOpen();
 
-        if (OperatingSystem.IsWindows())
-        {
-            _powerService.ShowNativePowerUI(PowerAction.Restart);
-        }
-        else
-        {
-            await ShowPowerConfirmDialogAsync(L("power.restart_confirm_title", "Restart"),
-                L("power.restart_confirm_message", "Are you sure you want to restart this computer?"),
-                () => _powerService.RestartAsync());
-        }
+        // 所有平台：统一使用二次确认对话框
+        // Note: SlideToShutDown.exe 只支持关机，不支持重启
+        await ShowPowerConfirmDialogAsync(L("power.restart_confirm_title", "Restart"),
+            L("power.restart_confirm_message", "Are you sure you want to restart this computer?"),
+            () => _powerService.RestartAsync());
     }
 
     private async void OnPowerLogoutClick(object? sender, RoutedEventArgs e)
@@ -4289,6 +4286,10 @@ public partial class MainWindow
                 {
                     whiteboard.ForceSaveNote();
                 }
+                else if (contentHost?.Child is StickyNoteWidget stickyNote)
+                {
+                    stickyNote.ForceSave();
+                }
             }
         }
     }

LanMountainDesktop/Views/MainWindow.DesktopPaging.cs

@@ -47,6 +47,7 @@ public partial class MainWindow
     private readonly Stack<StartMenuFolderNode> _launcherFolderStack = [];
     private readonly HashSet<string> _hiddenLauncherFolderPaths = new(StringComparer.OrdinalIgnoreCase);
     private readonly HashSet<string> _hiddenLauncherAppPaths = new(StringComparer.OrdinalIgnoreCase);
+    private bool _showLauncherTileBackground = true;
     private Button? _selectedLauncherTileButton;
     private LauncherEntryKind? _selectedLauncherEntryKind;
     private string? _selectedLauncherEntryKey;
@@ -116,6 +117,8 @@ public partial class MainWindow
                 }
             }
         }
+
+        _showLauncherTileBackground = snapshot.ShowTileBackground;
     }
 
     private void InitializeDesktopSurfaceSwipeHandlers()
@@ -1137,7 +1140,6 @@ public partial class MainWindow
 
         var button = new Button
         {
-            Classes = { "glass-panel" },
             Margin = new Thickness(0, 0, 12, 12),
             BorderThickness = new Thickness(0),
             BorderBrush = Brushes.Transparent,
@@ -1146,6 +1148,16 @@ public partial class MainWindow
             Content = content
             // 不设置固定 Width 和 Height，由 UpdateLauncherTileLayout 动态设置
         };
+
+        // 根据设置决定是否显示背景
+        if (_showLauncherTileBackground)
+        {
+            button.Classes.Add("glass-panel");
+        }
+        else
+        {
+            button.Background = Brushes.Transparent;
+        }
         button.Click += (_, _) =>
         {
             if (_isComponentLibraryOpen)
@@ -1676,7 +1688,6 @@ public partial class MainWindow
 
         var button = new Button
         {
-            Classes = { "glass-panel" },
             HorizontalAlignment = HorizontalAlignment.Stretch,
             VerticalAlignment = VerticalAlignment.Stretch,
             BorderThickness = new Thickness(0),
@@ -1684,6 +1695,17 @@ public partial class MainWindow
             Padding = new Thickness(8, 8, 8, 6),
             Content = content
         };
+
+        // 根据设置决定是否显示背景
+        if (_showLauncherTileBackground)
+        {
+            button.Classes.Add("glass-panel");
+        }
+        else
+        {
+            button.Background = Brushes.Transparent;
+        }
+
         button.Click += (_, _) =>
         {
             if (_isComponentLibraryOpen)
@@ -1745,7 +1767,6 @@ public partial class MainWindow
 
         var button = new Button
         {
-            Classes = { "glass-panel" },
             HorizontalAlignment = HorizontalAlignment.Stretch,
             VerticalAlignment = VerticalAlignment.Stretch,
             BorderThickness = new Thickness(0),
@@ -1753,6 +1774,17 @@ public partial class MainWindow
             Padding = new Thickness(8, 8, 8, 6),
             Content = content
         };
+
+        // 根据设置决定是否显示背景
+        if (_showLauncherTileBackground)
+        {
+            button.Classes.Add("glass-panel");
+        }
+        else
+        {
+            button.Background = Brushes.Transparent;
+        }
+
         button.Click += (_, _) =>
         {
             if (_isComponentLibraryOpen)

LanMountainDesktop/Views/MainWindow.SettingsHardCut.Stubs.cs

@@ -44,6 +44,23 @@ public partial class MainWindow
             return;
         }
 
+        // 启动台设置变化时，重新渲染启动台图标
+        if (e.Scope == SettingsScope.Launcher && e.ChangedKeys is { Count: > 0 })
+        {
+            var changedKeys = e.ChangedKeys.ToArray();
+            if (changedKeys.Any(key =>
+                string.Equals(key, nameof(LauncherSettingsSnapshot.ShowTileBackground), StringComparison.OrdinalIgnoreCase)))
+            {
+                Dispatcher.UIThread.Post(() =>
+                {
+                    var launcherSnapshot = _settingsService.LoadSnapshot<LauncherSettingsSnapshot>(SettingsScope.Launcher);
+                    InitializeLauncherVisibilitySettings(launcherSnapshot);
+                    RenderLauncherRootTiles();
+                }, DispatcherPriority.Background);
+                return;
+            }
+        }
+
         if (e.Scope == SettingsScope.App && e.ChangedKeys is { Count: > 0 })
         {
             var changedKeys = e.ChangedKeys.ToArray();

LanMountainDesktop/Views/SettingsPages/AboutSettingsPage.axaml

@@ -36,7 +36,8 @@
         <StackPanel Classes="about-page-container">
             <Border x:Name="AboutHeroCard"
                     Classes="about-hero-card"
-                    Height="240">
+                    Height="240"
+                    PointerPressed="OnAboutHeroCardPointerPressed">
                 <Image Source="/Assets/about_banner.png"
                        Stretch="Uniform"
                        HorizontalAlignment="Center"

LanMountainDesktop/Views/SettingsPages/AboutSettingsPage.axaml.cs

@@ -1,9 +1,16 @@
 using System;
+using System.Diagnostics;
 using Avalonia;
 using Avalonia.Controls;
+using Avalonia.Input;
+using Avalonia.VisualTree;
+using FluentAvalonia.UI.Controls;
+using LanMountainDesktop.Models;
 using LanMountainDesktop.PluginSdk;
+using LanMountainDesktop.Services;
 using LanMountainDesktop.Services.Settings;
 using LanMountainDesktop.ViewModels;
+using LanMountainDesktop.Views;
 
 namespace LanMountainDesktop.Views.SettingsPages;
 
@@ -19,6 +26,10 @@ namespace LanMountainDesktop.Views.SettingsPages;
 public partial class AboutSettingsPage : SettingsPageBase
 {
     private const double HeroAspectRatio = 9d / 16d;
+    private const int DevModeActivationClicks = 5;
+
+    private int _heroCardClickCount;
+    private DateTime _lastHeroCardClickTime = DateTime.MinValue;
 
     public AboutSettingsPage()
         : this(new AboutSettingsPageViewModel(HostSettingsFacadeProvider.GetOrCreate()))
@@ -60,4 +71,81 @@ public partial class AboutSettingsPage : SettingsPageBase
 
         AboutHeroCard.Height = targetHeight;
     }
+
+    private void OnAboutHeroCardPointerPressed(object? sender, PointerPressedEventArgs e)
+    {
+        var now = DateTime.UtcNow;
+        var elapsed = now - _lastHeroCardClickTime;
+
+        if (elapsed.TotalSeconds > 3)
+        {
+            _heroCardClickCount = 1;
+        }
+        else
+        {
+            _heroCardClickCount++;
+        }
+
+        _lastHeroCardClickTime = now;
+
+        var settingsFacade = HostSettingsFacadeProvider.GetOrCreate();
+        var snapshot = settingsFacade.Settings.LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App);
+
+        if (snapshot.IsDevModeEnabled)
+        {
+            if (_heroCardClickCount >= 3)
+            {
+                _heroCardClickCount = 0;
+                Debug.WriteLine("[AboutSettingsPage] Developer mode is already enabled.");
+            }
+
+            return;
+        }
+
+        var remaining = DevModeActivationClicks - _heroCardClickCount;
+
+        if (remaining <= 0)
+        {
+            _heroCardClickCount = 0;
+            PromptEnableDevMode(settingsFacade);
+        }
+        else if (remaining <= 2)
+        {
+            Debug.WriteLine($"[AboutSettingsPage] 再点击 {remaining} 次即可启用开发者模式。");
+        }
+    }
+
+    private async void PromptEnableDevMode(ISettingsFacadeService settingsFacade)
+    {
+        var dialog = new ContentDialog
+        {
+            Title = "启用开发者模式",
+            Content = "开发者模式提供了插件调试、热重载等高级功能，仅供开发和调试用途。\n\n" +
+                      "请注意：开发者不对以非开发用途使用此功能造成的任何后果负责，也不接受以非开发用途使用时产生的 Bug 反馈。\n\n" +
+                      "确定要启用开发者模式吗？",
+            PrimaryButtonText = "启用",
+            CloseButtonText = "取消",
+            DefaultButton = ContentDialogButton.Close
+        };
+
+        var result = await dialog.ShowAsync();
+        if (result != ContentDialogResult.Primary)
+        {
+            return;
+        }
+
+        var snapshot = settingsFacade.Settings.LoadSnapshot<AppSettingsSnapshot>(SettingsScope.App);
+        snapshot.IsDevModeEnabled = true;
+        settingsFacade.Settings.SaveSnapshot(
+            SettingsScope.App,
+            snapshot,
+            changedKeys: [nameof(AppSettingsSnapshot.IsDevModeEnabled)]);
+
+        AppLogger.Info("DevMode", "Developer mode enabled via About page activation.");
+
+        if (this.FindAncestorOfType<SettingsWindow>() is { } settingsWindow)
+        {
+            settingsWindow.RebuildAndNavigateToDevPage();
+        }
+    }
 }

LanMountainDesktop/Views/SettingsPages/DevSettingsPage.axaml

@@ -0,0 +1,109 @@
+<UserControl xmlns="https://github.com/avaloniaui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+             xmlns:vm="using:LanMountainDesktop.ViewModels"
+             xmlns:ui="using:FluentAvalonia.UI.Controls"
+             xmlns:fi="using:FluentIcons.Avalonia.Fluent"
+             x:Class="LanMountainDesktop.Views.SettingsPages.DevSettingsPage"
+             x:DataType="vm:DevSettingsPageViewModel">
+    <ScrollViewer VerticalScrollBarVisibility="Auto">
+        <StackPanel Classes="settings-page-container settings-page-animated">
+
+            <ui:InfoBar IsOpen="True"
+                        IsClosable="False"
+                        Severity="Warning"
+                        Title="开发者模式"
+                        Message="开发者模式仅供开发和调试用途。开发者不对以非开发用途使用此功能造成的任何后果负责。"
+                        Margin="0,0,0,16" />
+
+            <ui:SettingsExpander Header="启用开发者模式"
+                                 Description="启用后可使用插件调试、开发者插件路径等高级功能">
+                <ui:SettingsExpander.IconSource>
+                    <fi:SymbolIconSource Symbol="DeveloperBoard" />
+                </ui:SettingsExpander.IconSource>
+                <ui:SettingsExpander.Footer>
+                    <ToggleSwitch IsChecked="{Binding IsDevModeEnabled}" />
+                </ui:SettingsExpander.Footer>
+            </ui:SettingsExpander>
+
+            <ui:SettingsExpander Header="启用三指滑动"
+                                 Description="使用三根手指或鼠标右键拖动自由滑动页面，在第一页向右滑动可回到 Windows 桌面（实验性功能）">
+                <ui:SettingsExpander.IconSource>
+                    <fi:SymbolIconSource Symbol="Gesture" />
+                </ui:SettingsExpander.IconSource>
+                <ui:SettingsExpander.Footer>
+                    <ToggleSwitch IsChecked="{Binding EnableThreeFingerSwipe}" />
+                </ui:SettingsExpander.Footer>
+            </ui:SettingsExpander>
+
+            <ui:SettingsExpander Header="启用融合桌面"
+                                 Description="允许将组件放置在 Windows 系统桌面上（实验性功能，重启后生效）">
+                <ui:SettingsExpander.IconSource>
+                    <fi:SymbolIconSource Symbol="Apps" />
+                </ui:SettingsExpander.IconSource>
+                <ui:SettingsExpander.Footer>
+                    <ToggleSwitch IsChecked="{Binding EnableFusedDesktop}" />
+                </ui:SettingsExpander.Footer>
+            </ui:SettingsExpander>
+
+            <Separator Classes="settings-separator" />
+
+            <ui:SettingsExpander Header="开发者插件路径"
+                                 Description="指定开发中的插件目录路径，无需打包即可直接加载。多个路径用分号分隔。">
+                <ui:SettingsExpander.IconSource>
+                    <fi:SymbolIconSource Symbol="FolderLink" />
+                </ui:SettingsExpander.IconSource>
+                <ui:SettingsExpanderItem>
+                    <TextBox Text="{Binding DevPluginPath}"
+                             Watermark="C:\path\to\plugin\bin\Debug\net10.0"
+                             Width="360"
+                             MinWidth="200" />
+                </ui:SettingsExpanderItem>
+            </ui:SettingsExpander>
+
+            <Separator Classes="settings-separator" />
+
+            <ui:SettingsExpander Header="命令行参数"
+                                 Description="也可以通过命令行参数或环境变量指定开发者插件路径">
+                <ui:SettingsExpander.IconSource>
+                    <fi:SymbolIconSource Symbol="WindowConsole" />
+                </ui:SettingsExpander.IconSource>
+                <ui:SettingsExpanderItem>
+                    <StackPanel Margin="0,8,0,0" Spacing="8">
+                        <TextBlock Text="命令行参数：" FontWeight="SemiBold" />
+                        <Border Background="{DynamicResource ControlFillColorDefaultBrush}"
+                                CornerRadius="8"
+                                Padding="12,8">
+                            <TextBlock FontFamily="Cascadia Code, Consolas, monospace"
+                                       FontSize="12"
+                                       Text="--dev-plugin &lt;path&gt;   或   -dp &lt;path&gt;"
+                                       TextWrapping="Wrap" />
+                        </Border>
+                        <TextBlock Text="环境变量：" FontWeight="SemiBold" Margin="0,8,0,0" />
+                        <Border Background="{DynamicResource ControlFillColorDefaultBrush}"
+                                CornerRadius="8"
+                                Padding="12,8">
+                            <TextBlock FontFamily="Cascadia Code, Consolas, monospace"
+                                       FontSize="12"
+                                       Text="LMD_DEV_PLUGIN=&lt;path&gt;"
+                                       TextWrapping="Wrap" />
+                        </Border>
+                        <TextBlock Text="其他参数：" FontWeight="SemiBold" Margin="0,8,0,0" />
+                        <Border Background="{DynamicResource ControlFillColorDefaultBrush}"
+                                CornerRadius="8"
+                                Padding="12,8">
+                            <StackPanel Spacing="4">
+                                <TextBlock FontFamily="Cascadia Code, Consolas, monospace"
+                                           FontSize="12"
+                                           Text="--dev-mode / -dev     启用开发者模式" />
+                                <TextBlock FontFamily="Cascadia Code, Consolas, monospace"
+                                           FontSize="12"
+                                           Text="--hot-reload / -hr    启用热重载（预留）" />
+                            </StackPanel>
+                        </Border>
+                    </StackPanel>
+                </ui:SettingsExpanderItem>
+            </ui:SettingsExpander>
+
+        </StackPanel>
+    </ScrollViewer>
+</UserControl>

LanMountainDesktop/Views/SettingsPages/DevSettingsPage.axaml.cs

@@ -0,0 +1,30 @@
+using LanMountainDesktop.PluginSdk;
+using LanMountainDesktop.Services.Settings;
+using LanMountainDesktop.ViewModels;
+
+namespace LanMountainDesktop.Views.SettingsPages;
+
+[SettingsPageInfo(
+    "dev",
+    "开发者",
+    SettingsPageCategory.Dev,
+    IconKey = "DeveloperBoard",
+    SortOrder = 0,
+    TitleLocalizationKey = "settings.dev.title",
+    DescriptionLocalizationKey = "settings.dev.description")]
+public partial class DevSettingsPage : SettingsPageBase
+{
+    public DevSettingsPage()
+        : this(new DevSettingsPageViewModel(HostSettingsFacadeProvider.GetOrCreate()))
+    {
+    }
+
+    public DevSettingsPage(DevSettingsPageViewModel viewModel)
+    {
+        ViewModel = viewModel;
+        DataContext = ViewModel;
+        InitializeComponent();
+    }
+
+    public DevSettingsPageViewModel ViewModel { get; }
+}

LanMountainDesktop/Views/SettingsPages/GeneralSettingsPage.axaml

@@ -14,13 +14,6 @@
                                Text="{Binding BasicHeader}"
                                Margin="0,0,0,4" />
 
-            <ui:SettingsExpander Header="启用三指滑动"
-                                 Description="使用三根手指或鼠标右键拖动自由滑动页面，在第一页向右滑动可回到 Windows 桌面">
-                <ui:SettingsExpander.Footer>
-                    <ToggleSwitch IsChecked="{Binding EnableThreeFingerSwipe}" />
-                </ui:SettingsExpander.Footer>
-            </ui:SettingsExpander>
-
             <ui:SettingsExpander Header="{Binding LanguageHeader}">
                 <ui:SettingsExpander.IconSource>
                     <fi:SymbolIconSource Symbol="Settings" />

LanMountainDesktop/Views/SettingsPages/LauncherSettingsPage.axaml

@@ -4,6 +4,7 @@
              xmlns:controls="using:LanMountainDesktop.Controls"
              xmlns:ui="using:FluentAvalonia.UI.Controls"
              xmlns:fi="using:FluentIcons.Avalonia.Fluent"
+             xmlns:symbol="using:FluentIcons.Common"
              x:Class="LanMountainDesktop.Views.SettingsPages.LauncherSettingsPage"
              x:DataType="vm:LauncherSettingsPageViewModel">
     <ScrollViewer VerticalScrollBarVisibility="Auto">
@@ -52,9 +53,33 @@
             </Border>
 
             <controls:IconText Icon="Apps"
-                               Text="{Binding HiddenHeader}"
+                               Text="{Binding AppearanceHeader}"
                                Margin="0,0,0,4" />
 
+            <ui:SettingsExpander Classes="settings-expander-card"
+                                 Header="{Binding AppearanceHeader}"
+                                 Description="{Binding AppearanceDescription}"
+                                 IsExpanded="True">
+                <ui:SettingsExpander.IconSource>
+                    <fi:SymbolIconSource Symbol="{x:Static symbol:Symbol.Apps}" />
+                </ui:SettingsExpander.IconSource>
+                <ui:SettingsExpanderItem>
+                    <Grid ColumnDefinitions="*,Auto">
+                        <StackPanel Spacing="2">
+                            <TextBlock Text="{Binding ShowTileBackgroundHeader}" />
+                            <TextBlock Classes="settings-item-description"
+                                       Text="{Binding ShowTileBackgroundDescription}" />
+                        </StackPanel>
+                        <ToggleSwitch Grid.Column="1"
+                                      IsChecked="{Binding ShowTileBackground}" />
+                    </Grid>
+                </ui:SettingsExpanderItem>
+            </ui:SettingsExpander>
+
+            <controls:IconText Icon="Apps"
+                               Text="{Binding HiddenHeader}"
+                               Margin="0,24,0,4" />
+
             <ui:SettingsExpander Classes="settings-expander-card"
                                  Header="{Binding HiddenHeader}"
                                  Description="{Binding HiddenDescription}"

LanMountainDesktop/Views/SettingsPages/UpdateSettingsPage.axaml

@@ -37,11 +37,6 @@
 
     <ScrollViewer VerticalScrollBarVisibility="Auto">
         <StackPanel Classes="settings-page-container settings-page-animated">
-            <TextBlock Classes="settings-section-title"
-                       Text="{Binding PageTitle}" />
-            <TextBlock Classes="settings-section-description"
-                       Text="{Binding PageDescription}" />
-
             <Border Classes="update-status-card">
                 <StackPanel Spacing="18">
                     <Grid ColumnDefinitions="Auto,*,Auto"

LanMountainDesktop/Views/SettingsWindow.axaml.cs

@@ -97,6 +97,12 @@ public partial class SettingsWindow : Window, ISettingsPageHostContext
         NavigateTo(pageId ?? ViewModel.Pages.FirstOrDefault()?.PageId);
     }
 
+    public void RebuildAndNavigateToDevPage()
+    {
+        _pageRegistry.Rebuild();
+        ReloadPages("dev");
+    }
+
     public void OpenDrawer(Control content, string? title = null)
     {
         if (DrawerContentHost is null)
@@ -734,8 +740,11 @@ public partial class SettingsWindow : Window, ISettingsPageHostContext
             "Info" => Symbol.Info,
             "ArrowSync" => Symbol.ArrowSync,
             "Hourglass" => Symbol.Hourglass,
-            "Alert" => Symbol.Alert,  // 铃铛图标
-            "Bell" => Symbol.Alert,   // Bell也映射到Alert图标
+            "Alert" => Symbol.Alert,
+            "Bell" => Symbol.Alert,
+            "DeveloperBoard" => Symbol.DeveloperBoard,
+            "FolderLink" => Symbol.FolderLink,
+            "WindowConsole" => Symbol.WindowConsole,
             _ => Symbol.Settings
         };
     }

LanMountainDesktop/installer/LanMountainDesktop.iss

@@ -20,6 +20,14 @@
   #define MyAppArch "x64"
 #endif
 
+#ifndef MyAppSuffix
+  #define MyAppSuffix ""
+#endif
+
+#ifndef IsSelfContained
+  #define IsSelfContained "true"
+#endif
+
 [Setup]
 AppId={#MyAppId}
 AppName={#MyAppName}
@@ -34,7 +42,7 @@ LanguageDetectionMethod=uilanguage
 DefaultGroupName={cm:AppShortcutName}
 UninstallDisplayIcon={app}\{#MyAppExeName}
 OutputDir={#MyOutputDir}
-OutputBaseFilename={#MyAppName}-Setup-{#MyAppVersion}-{#MyAppArch}
+OutputBaseFilename={#MyAppName}-Setup-{#MyAppVersion}-{#MyAppArch}{#MyAppSuffix}
 Compression=lzma2/ultra64
 SolidCompression=yes
 WizardStyle=modern
@@ -93,7 +101,17 @@ chinesesimplified.UpgradeCleanupMissingUninstaller=安装程序发现了现有
 english.UpgradeCleanupFailedPrefix=Setup could not remove the existing installation automatically. Error code:
 chinesesimplified.UpgradeCleanupFailedPrefix=安装程序无法自动移除现有安装。错误代码：
 english.UpgradeCleanupFailedSuffix=Please close LanMountainDesktop, uninstall the current version manually, and then run this installer again.
-chinesesimplified.UpgradeCleanupFailedSuffix=请关闭 LanMountainDesktop，手动卸载当前版本，然后重新运行此安装程序。
+chinesesimplified.UpgradeCleanupFailedSuffix=请关闭 LanMountain Desktop，手动卸载当前版本，然后重新运行此安装程序。
+english.DotNetRuntimeMissingTitle=.NET Desktop Runtime Required
+chinesesimplified.DotNetRuntimeMissingTitle=需要 .NET Desktop Runtime
+english.DotNetRuntimeMissingMessage=This application requires .NET 10.0 Desktop Runtime to run.
+chinesesimplified.DotNetRuntimeMissingMessage=此应用程序需要 .NET 10.0 Desktop Runtime 才能运行。
+english.DotNetRuntimeMissingAction=Click "Yes" to open the official download page. Install it first, then run this installer again.
+chinesesimplified.DotNetRuntimeMissingAction=单击"是"打开官方下载页面。请先完成安装，然后重新运行此安装程序。
+english.DotNetRuntimeOpenFailedMessage=Unable to open the download page automatically.
+chinesesimplified.DotNetRuntimeOpenFailedMessage=无法自动打开下载页面。
+english.DotNetRuntimeOpenFailedAction=Please open this URL manually:
+chinesesimplified.DotNetRuntimeOpenFailedAction=请手动打开以下链接：
 
 [Tasks]
 Name: "desktopicon"; Description: "{cm:CreateDesktopIcon}"; GroupDescription: "{cm:AdditionalIcons}"
@@ -127,6 +145,7 @@ const
   UninstallRegSubkey = 'Software\Microsoft\Windows\CurrentVersion\Uninstall\{#MyAppRegistryId}_is1';
   WebView2RuntimeKeyPath = 'SOFTWARE\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}';
   WebView2RuntimeDownloadUrl = 'https://go.microsoft.com/fwlink/p/?LinkId=2124703';
+  DotNetRuntimeDownloadUrl = 'https://dotnet.microsoft.com/download/dotnet/10.0';
   UpgradeChoiceInPlace = 0;
   UpgradeChoiceRelocate = 1;
 
@@ -435,10 +454,110 @@ begin
     RegQueryStringValue(HKCU32, WebView2RuntimeKeyPath, 'pv', VersionValue);
 end;
 
+// Checks whether a .NET 10.x shared framework is installed under the given
+// base path by enumerating version sub-directories and looking for one that
+// starts with '10.'.
+function IsDotNet10RuntimePresent(const BasePath: String): Boolean;
+var
+  FindRec: TFindRec;
+begin
+  Result := False;
+  if not DirExists(BasePath) then
+  begin
+    exit;
+  end;
+
+  if FindFirst(BasePath + '\*', FindRec) then
+  begin
+    try
+      repeat
+        if (FindRec.Attributes and FILE_ATTRIBUTE_DIRECTORY <> 0) and
+           (Length(FindRec.Name) >= 3) and
+           (Copy(FindRec.Name, 1, 3) = '10.') then
+        begin
+          Result := True;
+          exit;
+        end;
+      until not FindNext(FindRec);
+    finally
+      FindClose(FindRec);
+    end;
+  end;
+end;
+
+// Returns True when the .NET 10 Desktop Runtime (or the .NET 10 Core Runtime
+// which is sufficient for Avalonia apps) is found on the system.
+// We check both Microsoft.WindowsDesktop.App and Microsoft.NETCore.App because
+// the runtimeconfig.json may reference either framework depending on the
+// publish mode and the app only needs the one it actually references.
+function IsDotNetDesktopRuntimeInstalled(): Boolean;
+var
+  BasePath: String;
+begin
+  Result := False;
+
+  // Check 64-bit Program Files
+  BasePath := ExpandConstant('{commonpf64}\dotnet\shared\Microsoft.WindowsDesktop.App');
+  if IsDotNet10RuntimePresent(BasePath) then
+  begin
+    Result := True;
+    exit;
+  end;
+
+  BasePath := ExpandConstant('{commonpf64}\dotnet\shared\Microsoft.NETCore.App');
+  if IsDotNet10RuntimePresent(BasePath) then
+  begin
+    Result := True;
+    exit;
+  end;
+
+  // Check 32-bit Program Files
+  BasePath := ExpandConstant('{commonpf}\dotnet\shared\Microsoft.WindowsDesktop.App');
+  if IsDotNet10RuntimePresent(BasePath) then
+  begin
+    Result := True;
+    exit;
+  end;
+
+  BasePath := ExpandConstant('{commonpf}\dotnet\shared\Microsoft.NETCore.App');
+  if IsDotNet10RuntimePresent(BasePath) then
+  begin
+    Result := True;
+    exit;
+  end;
+end;
+
 function InitializeSetup(): Boolean;
 var
   ErrorCode: Integer;
+  IsSelfContainedBuild: Boolean;
 begin
+  IsSelfContainedBuild := ('{#IsSelfContained}' = 'true');
+
+  if not IsSelfContainedBuild then
+  begin
+    if not IsDotNetDesktopRuntimeInstalled() then
+    begin
+      if MsgBox(
+        CustomMessage('DotNetRuntimeMissingMessage') + #13#10#13#10 +
+        CustomMessage('DotNetRuntimeMissingAction'),
+        mbConfirmation,
+        MB_YESNO) = IDYES then
+      begin
+        if not ShellExec('open', DotNetRuntimeDownloadUrl, '', '', SW_SHOWNORMAL, ewNoWait, ErrorCode) then
+        begin
+          MsgBox(
+            CustomMessage('DotNetRuntimeOpenFailedMessage') + #13#10 +
+            CustomMessage('DotNetRuntimeOpenFailedAction') + #13#10 + DotNetRuntimeDownloadUrl,
+            mbError,
+            MB_OK);
+        end;
+      end;
+      Result := False;
+      exit;
+    end;
+  end;
+
   if IsWebView2RuntimeInstalled() then
   begin
     Result := True;

LanMountainDesktop/plugins/DevPluginOptions.cs

@@ -0,0 +1,136 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+
+using LanMountainDesktop.Services;
+
+namespace LanMountainDesktop.Plugins;
+
+public sealed class DevPluginOptions
+{
+    private static readonly string[] DevPluginPathArgs = ["--dev-plugin", "-dp"];
+    private static readonly string[] DevModeArgs = ["--dev-mode", "-dev"];
+    private static readonly string[] HotReloadArgs = ["--hot-reload", "-hr"];
+    private static readonly string EnvDevPluginPath = "LMD_DEV_PLUGIN";
+    private static readonly string EnvDevMode = "LMD_DEV_MODE";
+
+    public static DevPluginOptions Current { get; } = new();
+
+    public bool IsDevMode { get; private set; }
+
+    public string? DevPluginPath { get; private set; }
+
+    public bool EnableHotReload { get; private set; }
+
+    public IReadOnlyList<string> DevPluginPaths { get; private set; } = Array.Empty<string>();
+
+    private DevPluginOptions() { }
+
+    public static DevPluginOptions Parse(string[] args)
+    {
+        var options = Current;
+
+        options.IsDevMode = TryGetFlag(args, DevModeArgs) ||
+                            string.Equals(Environment.GetEnvironmentVariable(EnvDevMode), "1", StringComparison.Ordinal) ||
+                            string.Equals(Environment.GetEnvironmentVariable(EnvDevMode), "true", StringComparison.OrdinalIgnoreCase);
+
+        options.DevPluginPath = TryGetValue(args, DevPluginPathArgs) ??
+                                Environment.GetEnvironmentVariable(EnvDevPluginPath)?.Trim();
+
+        options.EnableHotReload = TryGetFlag(args, HotReloadArgs);
+
+        if (!options.IsDevMode && !string.IsNullOrWhiteSpace(options.DevPluginPath))
+        {
+            options.IsDevMode = true;
+        }
+
+        options.DevPluginPaths = ResolveDevPluginPaths(options.DevPluginPath);
+
+        if (options.IsDevMode)
+        {
+            AppLogger.Info(
+                "DevPlugin",
+                $"Developer mode enabled. DevPluginPath='{options.DevPluginPath}'; EnableHotReload={options.EnableHotReload}; ResolvedPaths={options.DevPluginPaths.Count}.");
+        }
+
+        return options;
+    }
+
+    internal void ApplySettingsFromSnapshot(bool isDevMode, string? devPluginPath)
+    {
+        if (isDevMode && !IsDevMode)
+        {
+            IsDevMode = true;
+        }
+
+        if (!string.IsNullOrWhiteSpace(devPluginPath) && string.IsNullOrWhiteSpace(DevPluginPath))
+        {
+            DevPluginPath = devPluginPath;
+        }
+
+        var allPaths = new List<string>(DevPluginPaths);
+        if (!string.IsNullOrWhiteSpace(devPluginPath))
+        {
+            foreach (var path in ResolveDevPluginPaths(devPluginPath))
+            {
+                if (!allPaths.Contains(path, StringComparer.OrdinalIgnoreCase))
+                {
+                    allPaths.Add(path);
+                }
+            }
+        }
+
+        DevPluginPaths = allPaths;
+    }
+
+    private static IReadOnlyList<string> ResolveDevPluginPaths(string? rawPath)
+    {
+        if (string.IsNullOrWhiteSpace(rawPath))
+        {
+            return Array.Empty<string>();
+        }
+
+        var paths = rawPath.Split(';', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
+
+        var resolved = new List<string>();
+        foreach (var path in paths)
+        {
+            try
+            {
+                var fullPath = Path.GetFullPath(path);
+                if (Directory.Exists(fullPath) || File.Exists(fullPath))
+                {
+                    resolved.Add(fullPath);
+                }
+                else
+                {
+                    AppLogger.Warn("DevPlugin", $"Developer plugin path '{path}' does not exist. It will be skipped.");
+                }
+            }
+            catch (Exception ex)
+            {
+                AppLogger.Warn("DevPlugin", $"Failed to resolve developer plugin path '{path}': {ex.Message}");
+            }
+        }
+
+        return resolved;
+    }
+
+    private static bool TryGetFlag(string[] args, string[] names)
+    {
+        return args.Any(arg => names.Any(name => string.Equals(arg, name, StringComparison.OrdinalIgnoreCase)));
+    }
+
+    private static string? TryGetValue(string[] args, string[] names)
+    {
+        for (var i = 0; i < args.Length - 1; i++)
+        {
+            if (names.Any(name => string.Equals(args[i], name, StringComparison.OrdinalIgnoreCase)))
+            {
+                return args[i + 1]?.Trim();
+            }
+        }
+
+        return null;
+    }
+}

LanMountainDesktop/plugins/PluginCatalogEntry.cs

@@ -5,7 +5,8 @@ namespace LanMountainDesktop.Services;
 public enum PluginCatalogSourceKind
 {
     Package = 0,
-    Manifest = 1
+    Manifest = 1,
+    DevPlugin = 2
 }
 
 public sealed record PluginCatalogEntry(
@@ -16,4 +17,5 @@ public sealed record PluginCatalogEntry(
     bool IsLoaded,
     string? ErrorMessage,
     int SettingsPageCount,
-    int WidgetCount);
+    int WidgetCount,
+    bool IsDevPlugin = false);

LanMountainDesktop/plugins/PluginLoader.cs

@@ -146,7 +146,7 @@ public sealed class PluginLoader
         try
         {
             Directory.CreateDirectory(dataDirectory);
-            ValidatePluginRuntimeAssets(manifest, assemblyPath, pluginDirectory);
+            ValidatePluginRuntimeAssets(manifest, assemblyPath, pluginDirectory, _options.IsDevMode);
             AppLogger.Info(
                 "PluginLoader",
                 $"LoadCore starting. PluginId='{manifest.Id}'; AssemblyPath='{assemblyPath}'; PluginDirectory='{pluginDirectory}'; DataDirectory='{dataDirectory}'.");
@@ -721,13 +721,23 @@ public sealed class PluginLoader
     private static void ValidatePluginRuntimeAssets(
         PluginManifest manifest,
         string assemblyPath,
-        string pluginDirectory)
+        string pluginDirectory,
+        bool isDevMode)
     {
         var depsFilePath = Path.ChangeExtension(assemblyPath, ".deps.json");
         if (!File.Exists(depsFilePath))
         {
-            throw new InvalidOperationException(
-                $"Plugin '{manifest.Id}' targets API {PluginSdkInfo.ApiVersion} and must include '{Path.GetFileName(depsFilePath)}' next to its main assembly.");
+            if (isDevMode)
+            {
+                AppLogger.Warn(
+                    "PluginLoader",
+                    $"Plugin '{manifest.Id}' is missing '{Path.GetFileName(depsFilePath)}'. In developer mode this is allowed, but dependency resolution may fail at runtime.");
+            }
+            else
+            {
+                throw new InvalidOperationException(
+                    $"Plugin '{manifest.Id}' targets API {PluginSdkInfo.ApiVersion} and must include '{Path.GetFileName(depsFilePath)}' next to its main assembly.");
+            }
         }
 
         var runtimesDirectory = Path.Combine(pluginDirectory, "runtimes");
@@ -848,6 +858,8 @@ public sealed class PluginLoader
 
     private sealed class PluginRuntimeContext : IPluginRuntimeContext
     {
+        private readonly PluginAppearanceContext _appearanceContext;
+
         public PluginRuntimeContext(
             PluginManifest manifest,
             string pluginDirectory,
@@ -859,7 +871,8 @@ public sealed class PluginLoader
             PluginDirectory = pluginDirectory;
             DataDirectory = dataDirectory;
             Properties = properties;
-            Appearance = new PluginAppearanceContext(appearanceSnapshot);
+            _appearanceContext = new PluginAppearanceContext(appearanceSnapshot);
+            Appearance = _appearanceContext;
             Services = NullServiceProvider.Instance;
         }
 
@@ -898,6 +911,14 @@ public sealed class PluginLoader
         {
             Services = services ?? throw new ArgumentNullException(nameof(services));
         }
+
+        /// <summary>
+        /// 更新外观快照并通知插件。
+        /// </summary>
+        internal void UpdateAppearanceSnapshot(PluginAppearanceSnapshot newSnapshot, IReadOnlyCollection<AppearanceProperty> changedProperties)
+        {
+            _appearanceContext.UpdateSnapshot(newSnapshot, changedProperties);
+        }
     }
 
     private sealed class PluginMessageBus : IPluginMessageBus, IDisposable

LanMountainDesktop/plugins/PluginLoaderOptions.cs

@@ -19,6 +19,8 @@ public sealed class PluginLoaderOptions
 
     public string PackagedDataDirectoryName { get; init; } = PluginSdkInfo.PackagedDataDirectoryName;
 
+    public bool IsDevMode { get; init; }
+
     public ISet<string> SharedAssemblyNames { get; } = new HashSet<string>(StringComparer.OrdinalIgnoreCase)
     {
         typeof(IPlugin).Assembly.GetName().Name!

LanMountainDesktop/plugins/PluginMarketEmbeddedView.cs

@@ -784,12 +784,28 @@ internal sealed class PluginMarketEmbeddedView : UserControl, IDisposable
             }
 
             RefreshInstalledSnapshot();
-            SetStatus(
-                F(
-                    "market.status.install_success_format",
-                    "Plugin '{0}' has been staged. Restart the app to apply it.",
-                    result.Manifest.Name),
-                SuccessBrush);
+
+            if (result.RestartRequired)
+            {
+                SetStatus(
+                    F(
+                        "market.status.upgrade_staged_format",
+                        "Plugin '{0}' v{1} has been downloaded. Restart to complete the upgrade.",
+                        result.Manifest.Name,
+                        result.Manifest.Version),
+                    WarningBrush);
+                PendingRestartStateService.SetPending(PendingRestartStateService.PluginCatalogReason, true);
+            }
+            else
+            {
+                SetStatus(
+                    F(
+                        "market.status.install_success_format",
+                        "Plugin '{0}' has been installed successfully.",
+                        result.Manifest.Name),
+                    SuccessBrush);
+            }
+
             RebuildSurface();
         }
         catch (OperationCanceledException) when (_lifetimeCts.IsCancellationRequested)
@@ -1015,14 +1031,22 @@ internal sealed class PluginMarketEmbeddedView : UserControl, IDisposable
 
     private static int CompareVersions(string? left, string? right)
     {
-        if (!AirAppMarketIndexDocument.TryParseVersion(left, out var leftVersion))
+        var leftParsed = AirAppMarketIndexDocument.TryParseVersion(left, out var leftVersion);
+        var rightParsed = AirAppMarketIndexDocument.TryParseVersion(right, out var rightVersion);
+
+        if (!leftParsed && !rightParsed)
         {
-            leftVersion = new Version(0, 0, 0);
+            return 0;
         }
 
-        if (!AirAppMarketIndexDocument.TryParseVersion(right, out var rightVersion))
+        if (!leftParsed)
         {
-            rightVersion = new Version(0, 0, 0);
+            return -1;
+        }
+
+        if (!rightParsed)
+        {
+            return 1;
         }
 
         return (leftVersion ?? new Version(0, 0, 0)).CompareTo(rightVersion ?? new Version(0, 0, 0));

LanMountainDesktop/plugins/PluginMarketInstallService.cs

@@ -3,6 +3,7 @@ using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using System.Net.Http;
+using System.Reflection;
 using System.Threading;
 using System.Threading.Tasks;
 using System.Security.Cryptography;
@@ -20,7 +21,9 @@ internal sealed class AirAppMarketInstallService : IDisposable
     private readonly HttpClient _httpClient;
     private readonly ResumableDownloadService _downloadService;
     private readonly AirAppMarketReleaseResolverService _releaseResolverService;
+    private readonly PendingPluginUpgradeService _pendingUpgradeService;
     private readonly string _downloadsDirectory;
+    private readonly Version? _hostVersion;
 
     public AirAppMarketInstallService(PluginRuntimeService runtime, string dataDirectory)
     {
@@ -33,6 +36,8 @@ internal sealed class AirAppMarketInstallService : IDisposable
         _httpClient.DefaultRequestHeaders.UserAgent.ParseAdd("LanMountainDesktop-PluginMarketplace/1.0");
         _downloadService = new ResumableDownloadService(_httpClient);
         _releaseResolverService = new AirAppMarketReleaseResolverService(_httpClient);
+        _pendingUpgradeService = new PendingPluginUpgradeService(runtime.PluginsDirectory);
+        _hostVersion = typeof(App).Assembly.GetName().Version;
     }
 
     public async Task<AirAppMarketInstallResult> InstallAsync(
@@ -41,18 +46,6 @@ internal sealed class AirAppMarketInstallService : IDisposable
     {
         ArgumentNullException.ThrowIfNull(plugin);
 
-        if (OperatingSystem.IsWindows())
-        {
-            var helperPath = ResolveHelperPath();
-            if (!File.Exists(helperPath))
-            {
-                return new AirAppMarketInstallResult(
-                    false,
-                    null,
-                    $"Plugins install helper was not found at '{helperPath}'.");
-            }
-        }
-
         Directory.CreateDirectory(_downloadsDirectory);
         var sources = plugin.GetPackageSourcesInInstallOrder();
         if (sources.Count == 0)
@@ -67,6 +60,39 @@ internal sealed class AirAppMarketInstallService : IDisposable
             "PluginMarket",
             $"Starting install. PluginId='{plugin.Id}'; Version='{plugin.Version}'; Sources='{string.Join(", ", sources.Select(source => source.SourceKind.ToString()))}'.");
 
+        var compatibilityError = ValidateCompatibility(plugin);
+        if (!string.IsNullOrWhiteSpace(compatibilityError))
+        {
+            AppLogger.Warn("PluginMarket", $"Compatibility check failed. PluginId='{plugin.Id}'; Error='{compatibilityError}'.");
+            return new AirAppMarketInstallResult(false, null, compatibilityError);
+        }
+
+        var isUpgrade = IsPluginInstalled(plugin.Id);
+        if (isUpgrade)
+        {
+            return await InstallUpgradeAsync(plugin, sources, cancellationToken).ConfigureAwait(false);
+        }
+
+        return await InstallNewAsync(plugin, sources, cancellationToken).ConfigureAwait(false);
+    }
+
+    private async Task<AirAppMarketInstallResult> InstallNewAsync(
+        AirAppMarketPluginEntry plugin,
+        IReadOnlyList<AirAppMarketPluginPackageSourceEntry> sources,
+        CancellationToken cancellationToken)
+    {
+        if (OperatingSystem.IsWindows())
+        {
+            var helperPath = ResolveHelperPath();
+            if (!File.Exists(helperPath))
+            {
+                return new AirAppMarketInstallResult(
+                    false,
+                    null,
+                    $"Plugins install helper was not found at '{helperPath}'.");
+            }
+        }
+
         var sourceErrors = new List<string>();
         foreach (var source in sources)
         {
@@ -93,6 +119,88 @@ internal sealed class AirAppMarketInstallService : IDisposable
         return new AirAppMarketInstallResult(false, null, combinedMessage);
     }
 
+    private async Task<AirAppMarketInstallResult> InstallUpgradeAsync(
+        AirAppMarketPluginEntry plugin,
+        IReadOnlyList<AirAppMarketPluginPackageSourceEntry> sources,
+        CancellationToken cancellationToken)
+    {
+        AppLogger.Info("PluginMarket", $"Detected upgrade scenario. Downloading package for deferred upgrade. PluginId='{plugin.Id}'.");
+
+        foreach (var source in sources)
+        {
+            var downloadResult = await DownloadPackageAsync(plugin, source, cancellationToken).ConfigureAwait(false);
+            if (downloadResult.Success && !string.IsNullOrWhiteSpace(downloadResult.PackagePath))
+            {
+                _pendingUpgradeService.AddPendingUpgrade(plugin.Id, downloadResult.PackagePath, plugin.Version);
+
+                AppLogger.Info(
+                    "PluginMarket",
+                    $"Upgrade staged for next restart. PluginId='{plugin.Id}'; Version='{plugin.Version}'; PackagePath='{downloadResult.PackagePath}'.");
+
+                var manifest = ReadManifestFromPackage(downloadResult.PackagePath);
+                return new AirAppMarketInstallResult(true, manifest, null, RestartRequired: true);
+            }
+        }
+
+        return new AirAppMarketInstallResult(
+            false,
+            null,
+            $"Failed to download upgrade package for plugin '{plugin.Id}' from all available sources.");
+    }
+
+    private bool IsPluginInstalled(string pluginId)
+    {
+        return _runtime.Catalog.Any(entry =>
+            string.Equals(entry.Manifest.Id, pluginId, StringComparison.OrdinalIgnoreCase));
+    }
+
+    private string? ValidateCompatibility(AirAppMarketPluginEntry plugin)
+    {
+        if (_hostVersion is null)
+        {
+            return null;
+        }
+
+        if (!string.IsNullOrWhiteSpace(plugin.MinHostVersion))
+        {
+            if (!AirAppMarketIndexDocument.TryParseVersion(plugin.MinHostVersion, out var minHostVersion) ||
+                minHostVersion is null)
+            {
+                return $"Plugin '{plugin.Id}' declares invalid minimum host version '{plugin.MinHostVersion}'.";
+            }
+
+            if (_hostVersion < minHostVersion)
+            {
+                return $"Plugin '{plugin.Id}' requires host version {plugin.MinHostVersion} or newer. Current host version is {_hostVersion}.";
+            }
+        }
+
+        if (!string.IsNullOrWhiteSpace(plugin.ApiVersion))
+        {
+            if (!AirAppMarketIndexDocument.TryParseVersion(plugin.ApiVersion, out var pluginApiVersion) ||
+                pluginApiVersion is null)
+            {
+                return $"Plugin '{plugin.Id}' declares invalid API version '{plugin.ApiVersion}'.";
+            }
+
+            var hostApiVersion = PluginSdkInfo.ApiVersion;
+            if (hostApiVersion is not null)
+            {
+                if (!AirAppMarketIndexDocument.TryParseVersion(hostApiVersion, out var hostApiVersionParsed) ||
+                    hostApiVersionParsed is null)
+                {
+                    AppLogger.Warn("PluginMarket", $"Host API version '{hostApiVersion}' could not be parsed. Skipping API version check.");
+                }
+                else if (pluginApiVersion.Major != hostApiVersionParsed.Major)
+                {
+                    return $"Plugin '{plugin.Id}' uses incompatible API version {plugin.ApiVersion}. Host API version is {hostApiVersion}. Major version must match.";
+                }
+            }
+        }
+
+        return null;
+    }
+
     private async Task<AirAppMarketInstallAttemptResult> TryInstallFromSourceAsync(
         AirAppMarketPluginEntry plugin,
         AirAppMarketPluginPackageSourceEntry source,
@@ -275,6 +383,71 @@ internal sealed class AirAppMarketInstallService : IDisposable
         }
     }
 
+    private async Task<DownloadPackageResult> DownloadPackageAsync(
+        AirAppMarketPluginEntry plugin,
+        AirAppMarketPluginPackageSourceEntry source,
+        CancellationToken cancellationToken)
+    {
+        var packagePath = Path.Combine(
+            _downloadsDirectory,
+            $"{SanitizeFileName(plugin.Id)}-{SanitizeFileName(plugin.Version)}-{SanitizeFileName(source.SourceKind.ToString())}-{Guid.NewGuid():N}.laapp");
+
+        try
+        {
+            var resolvedDownloadUrl = await _releaseResolverService.ResolveDownloadUrlAsync(plugin, source, cancellationToken).ConfigureAwait(false);
+            AppLogger.Info(
+                "PluginMarket",
+                $"Downloading upgrade package for '{plugin.Id}' from '{resolvedDownloadUrl}'.");
+
+            var acquireResult = await AcquirePackageAsync(plugin, source, resolvedDownloadUrl, packagePath, cancellationToken).ConfigureAwait(false);
+            if (!acquireResult.Success)
+            {
+                TryDeleteFile(packagePath);
+                return new DownloadPackageResult(false, null, acquireResult.ErrorMessage);
+            }
+
+            var verificationResult = await VerifyPackageAsync(plugin, packagePath, cancellationToken).ConfigureAwait(false);
+            if (!verificationResult.Success)
+            {
+                TryDeleteFile(packagePath);
+                return new DownloadPackageResult(false, null, verificationResult.ErrorMessage);
+            }
+
+            return new DownloadPackageResult(true, packagePath, null);
+        }
+        catch (OperationCanceledException)
+        {
+            TryDeleteFile(packagePath);
+            throw;
+        }
+        catch (Exception ex)
+        {
+            TryDeleteFile(packagePath);
+            return new DownloadPackageResult(false, null, ex.Message);
+        }
+    }
+
+    private static PluginManifest ReadManifestFromPackage(string packagePath)
+    {
+        using var archive = System.IO.Compression.ZipFile.OpenRead(packagePath);
+        var entries = archive.Entries
+            .Where(entry => string.Equals(entry.Name, "plugin.json", StringComparison.OrdinalIgnoreCase))
+            .ToArray();
+
+        if (entries.Length == 0)
+        {
+            throw new InvalidOperationException($"Plugin package '{packagePath}' does not contain 'plugin.json'.");
+        }
+
+        if (entries.Length > 1)
+        {
+            throw new InvalidOperationException($"Plugin package '{packagePath}' contains multiple 'plugin.json' files.");
+        }
+
+        using var stream = entries[0].Open();
+        return PluginManifest.Load(stream, $"{packagePath}!/{entries[0].FullName}");
+    }
+
     public void Dispose()
     {
         _httpClient.Dispose();
@@ -299,4 +472,9 @@ internal sealed class AirAppMarketInstallService : IDisposable
     private sealed record AirAppMarketVerificationResult(
         bool Success,
         string? ErrorMessage);
+
+    private sealed record DownloadPackageResult(
+        bool Success,
+        string? PackagePath,
+        string? ErrorMessage);
 }

LanMountainDesktop/plugins/PluginMarketModels.cs

@@ -305,7 +305,8 @@ internal sealed record AirAppMarketLoadResult(
 internal sealed record AirAppMarketInstallResult(
     bool Success,
     PluginManifest? Manifest,
-    string? ErrorMessage);
+    string? ErrorMessage,
+    bool RestartRequired = false);
 
 internal sealed class AirAppMarketIndexDocument
 {

LanMountainDesktop/plugins/PluginRuntimeService.cs

@@ -85,6 +85,7 @@ public sealed class PluginRuntimeService : IDisposable
         Directory.CreateDirectory(PluginsDirectory);
         ApplyPendingPluginDeletions();
         UnloadInstalledPlugins();
+        MergeDevSettingsFromSnapshot();
         AppLogger.Info("PluginRuntime", $"Loading installed plugins from '{PluginsDirectory}'.");
 
         var disabledPluginIds = GetDisabledPluginIds();
@@ -108,19 +109,30 @@ public sealed class PluginRuntimeService : IDisposable
         var selectedPluginIds = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
         foreach (var candidate in candidates)
         {
+            var isDevPlugin = candidate.SourceKind == PluginCatalogSourceKind.DevPlugin;
+
             if (!selectedPluginIds.Add(candidate.Manifest.Id))
             {
-                var duplicateFailure = PluginLoadResult.Failure(
-                    candidate.SourcePath,
-                    candidate.Manifest,
-                    new InvalidOperationException(
-                        $"Duplicate plugin id '{candidate.Manifest.Id}' was found. Source '{candidate.SourcePath}' was ignored because a higher-priority source was already selected."));
-                _loadResults.Add(duplicateFailure);
-                LogPluginFailure("CatalogSelection", duplicateFailure, treatAsError: false);
-                continue;
+                if (isDevPlugin)
+                {
+                    AppLogger.Info(
+                        "DevPlugin",
+                        $"Developer plugin '{candidate.Manifest.Id}' overrides an already-registered plugin from '{candidate.SourcePath}'.");
+                }
+                else
+                {
+                    var duplicateFailure = PluginLoadResult.Failure(
+                        candidate.SourcePath,
+                        candidate.Manifest,
+                        new InvalidOperationException(
+                            $"Duplicate plugin id '{candidate.Manifest.Id}' was found. Source '{candidate.SourcePath}' was ignored because a higher-priority source was already selected."));
+                    _loadResults.Add(duplicateFailure);
+                    LogPluginFailure("CatalogSelection", duplicateFailure, treatAsError: false);
+                    continue;
+                }
             }
 
-            var isEnabled = !disabledPluginIds.Contains(candidate.Manifest.Id);
+            var isEnabled = isDevPlugin || !disabledPluginIds.Contains(candidate.Manifest.Id);
             if (!isEnabled)
             {
                 _catalog.Add(new PluginCatalogEntry(
@@ -172,6 +184,10 @@ public sealed class PluginRuntimeService : IDisposable
                     PluginsDirectory,
                     services: _hostServices,
                     hostProperties),
+                PluginCatalogSourceKind.DevPlugin => _loader.LoadFromManifest(
+                    candidate.SourcePath,
+                    services: _hostServices,
+                    hostProperties),
                 _ => _loader.LoadFromManifest(
                     candidate.SourcePath,
                     services: _hostServices,
@@ -192,7 +208,8 @@ public sealed class PluginRuntimeService : IDisposable
                     true,
                     null,
                     loadResult.LoadedPlugin.SettingsSections.Count,
-                    loadResult.LoadedPlugin.DesktopComponents.Count));
+                    loadResult.LoadedPlugin.DesktopComponents.Count,
+                    IsDevPlugin: isDevPlugin));
                 AppLogger.Info(
                     "PluginRuntime",
                     $"Plugin loaded. PluginId='{loadResult.LoadedPlugin.Manifest.Id}'; SourcePath='{loadResult.SourcePath}'; ManifestVersion='{loadResult.LoadedPlugin.Manifest.Version ?? "<unknown>"}'; ApiVersion='{loadResult.LoadedPlugin.Manifest.ApiVersion ?? "<unknown>"}'; SourceKind='{candidate.SourceKind}'; SettingsSections={loadResult.LoadedPlugin.SettingsSections.Count}; Widgets={loadResult.LoadedPlugin.DesktopComponents.Count}; Editors={loadResult.LoadedPlugin.DesktopComponentEditors.Count}.");
@@ -208,7 +225,8 @@ public sealed class PluginRuntimeService : IDisposable
                 false,
                 loadResult.Error?.Message,
                 0,
-                0));
+                0,
+                IsDevPlugin: isDevPlugin));
             LogPluginFailure("Load", loadResult, treatAsError: true);
             Debug.WriteLine($"[PluginRuntime] Failed to load plugin from '{loadResult.SourcePath}': {loadResult.Error}");
         }
@@ -229,6 +247,14 @@ public sealed class PluginRuntimeService : IDisposable
             return false;
         }
 
+        var catalogEntry = _catalog.FirstOrDefault(entry =>
+            string.Equals(entry.Manifest.Id, pluginId, StringComparison.OrdinalIgnoreCase));
+        if (catalogEntry.IsDevPlugin && !isEnabled)
+        {
+            AppLogger.Warn("DevPlugin", $"Cannot disable developer plugin '{pluginId}'. Developer plugins are always enabled in dev mode.");
+            return false;
+        }
+
         var snapshot = LoadAppSettingsSnapshot();
         var disabledPluginIds = snapshot.DisabledPluginIds is { Count: > 0 }
             ? new HashSet<string>(snapshot.DisabledPluginIds, StringComparer.OrdinalIgnoreCase)
@@ -459,12 +485,74 @@ public sealed class PluginRuntimeService : IDisposable
             }
         }
 
+        DiscoverDevPluginCandidates(candidates, failures);
+
         return candidates
-            .OrderBy(candidate => candidate.SourceKind)
+            .OrderByDescending(candidate => candidate.SourceKind)
             .ThenBy(candidate => candidate.SourcePath, StringComparer.OrdinalIgnoreCase)
             .ToArray();
     }
 
+    private void DiscoverDevPluginCandidates(List<PluginCandidate> candidates, List<PluginLoadResult> failures)
+    {
+        var devOptions = DevPluginOptions.Current;
+        if (!devOptions.IsDevMode || devOptions.DevPluginPaths.Count == 0)
+        {
+            return;
+        }
+
+        AppLogger.Info("DevPlugin", $"Scanning developer plugin paths. Count={devOptions.DevPluginPaths.Count}.");
+
+        foreach (var devPath in devOptions.DevPluginPaths)
+        {
+            if (File.Exists(devPath) && string.Equals(Path.GetExtension(devPath), PluginSdkInfo.PackageFileExtension, StringComparison.OrdinalIgnoreCase))
+            {
+                try
+                {
+                    var manifest = ReadManifestFromPackage(devPath);
+                    candidates.Add(new PluginCandidate(devPath, manifest, PluginCatalogSourceKind.DevPlugin));
+                    AppLogger.Info("DevPlugin", $"Found developer plugin package. PluginId='{manifest.Id}'; Path='{devPath}'.");
+                }
+                catch (Exception ex)
+                {
+                    var failure = PluginLoadResult.Failure(devPath, null, ex);
+                    failures.Add(failure);
+                    AppLogger.Warn("DevPlugin", $"Failed to read developer plugin package '{devPath}'.", ex);
+                }
+
+                continue;
+            }
+
+            if (Directory.Exists(devPath))
+            {
+                var manifestPath = Path.Combine(devPath, PluginSdkInfo.ManifestFileName);
+                if (File.Exists(manifestPath))
+                {
+                    try
+                    {
+                        var manifest = PluginManifest.Load(manifestPath);
+                        candidates.Add(new PluginCandidate(manifestPath, manifest, PluginCatalogSourceKind.DevPlugin));
+                        AppLogger.Info("DevPlugin", $"Found developer plugin manifest. PluginId='{manifest.Id}'; Path='{manifestPath}'.");
+                    }
+                    catch (Exception ex)
+                    {
+                        var failure = PluginLoadResult.Failure(manifestPath, null, ex);
+                        failures.Add(failure);
+                        AppLogger.Warn("DevPlugin", $"Failed to load developer plugin manifest '{manifestPath}'.", ex);
+                    }
+                }
+                else
+                {
+                    AppLogger.Warn("DevPlugin", $"Developer plugin directory '{devPath}' does not contain '{PluginSdkInfo.ManifestFileName}'. Skipping.");
+                }
+
+                continue;
+            }
+
+            AppLogger.Warn("DevPlugin", $"Developer plugin path '{devPath}' is neither a file nor a directory. Skipping.");
+        }
+    }
+
     private IEnumerable<string> EnumerateCandidatePaths(string searchPattern)
     {
         var runtimeRootDirectory = EnsureTrailingSeparator(Path.Combine(Path.GetFullPath(PluginsDirectory), ".runtime"));
@@ -582,7 +670,8 @@ public sealed class PluginRuntimeService : IDisposable
 
     private static PluginLoaderOptions CreateOptions()
     {
-        var options = new PluginLoaderOptions();
+        var devOptions = DevPluginOptions.Current;
+        var options = new PluginLoaderOptions { IsDevMode = devOptions.IsDevMode };
         AddSharedAssembly(options, typeof(App).Assembly);
         AddSharedAssembly(options, typeof(IServiceCollection).Assembly);
         AddSharedAssembly(options, typeof(HostBuilderContext).Assembly);
@@ -596,6 +685,10 @@ public sealed class PluginRuntimeService : IDisposable
             }
 
             if (assemblyName.StartsWith("Avalonia", StringComparison.OrdinalIgnoreCase) ||
+                string.Equals(assemblyName, "FluentAvaloniaUI", StringComparison.OrdinalIgnoreCase) ||
+                string.Equals(assemblyName, "FluentIcons.Avalonia", StringComparison.OrdinalIgnoreCase) ||
+                string.Equals(assemblyName, "FluentIcons.Avalonia.Fluent", StringComparison.OrdinalIgnoreCase) ||
+                string.Equals(assemblyName, "Material.Icons.Avalonia", StringComparison.OrdinalIgnoreCase) ||
                 string.Equals(assemblyName, "MicroCom.Runtime", StringComparison.OrdinalIgnoreCase))
             {
                 AddSharedAssembly(options, assembly);
@@ -614,6 +707,31 @@ public sealed class PluginRuntimeService : IDisposable
         }
     }
 
+    private void MergeDevSettingsFromSnapshot()
+    {
+        var devOptions = DevPluginOptions.Current;
+
+        try
+        {
+            var snapshot = LoadAppSettingsSnapshot();
+
+            if (snapshot.IsDevModeEnabled && !devOptions.IsDevMode)
+            {
+                devOptions.ApplySettingsFromSnapshot(isDevMode: true, devPluginPath: snapshot.DevPluginPath);
+                AppLogger.Info("DevPlugin", $"Developer mode enabled via settings. DevPluginPath='{snapshot.DevPluginPath}'.");
+            }
+            else if (!string.IsNullOrWhiteSpace(snapshot.DevPluginPath) && string.IsNullOrWhiteSpace(devOptions.DevPluginPath))
+            {
+                devOptions.ApplySettingsFromSnapshot(isDevMode: devOptions.IsDevMode, devPluginPath: snapshot.DevPluginPath);
+                AppLogger.Info("DevPlugin", $"Developer plugin path merged from settings. DevPluginPath='{snapshot.DevPluginPath}'.");
+            }
+        }
+        catch (Exception ex)
+        {
+            AppLogger.Warn("DevPlugin", "Failed to merge developer settings from snapshot.", ex);
+        }
+    }
+
     private void CollectContributions(LoadedPlugin loadedPlugin)
     {
         _exportRegistry.ReplaceExports(loadedPlugin.Manifest.Id, loadedPlugin.ExportedServices);
@@ -659,11 +777,6 @@ public sealed class PluginRuntimeService : IDisposable
     private void ApplyPendingPluginDeletions()
     {
         var pendingPaths = ReadPendingPluginDeletions();
-        if (pendingPaths.Count == 0)
-        {
-            return;
-        }
-
         var remainingPaths = new List<string>();
         foreach (var path in pendingPaths)
         {
@@ -674,6 +787,41 @@ public sealed class PluginRuntimeService : IDisposable
         }
 
         SavePendingPluginDeletions(remainingPaths);
+        CleanupPendingDeletionDirectory();
+    }
+
+    private void CleanupPendingDeletionDirectory()
+    {
+        var pendingDeletionDir = Path.Combine(PluginsDirectory, ".pending-deletions");
+        if (!Directory.Exists(pendingDeletionDir))
+        {
+            return;
+        }
+
+        foreach (var pendingFile in Directory.EnumerateFiles(pendingDeletionDir, "*.pending"))
+        {
+            try
+            {
+                File.Delete(pendingFile);
+            }
+            catch
+            {
+                // Ignore cleanup failures for pending deletions.
+            }
+        }
+
+        try
+        {
+            if (Directory.GetFiles(pendingDeletionDir).Length == 0 &&
+                Directory.GetDirectories(pendingDeletionDir).Length == 0)
+            {
+                Directory.Delete(pendingDeletionDir);
+            }
+        }
+        catch
+        {
+            // Ignore directory cleanup failures.
+        }
     }
 
     private string ResolvePluginRemovalTargetPath(PluginCatalogEntry entry)
@@ -826,6 +974,13 @@ public sealed class PluginRuntimeService : IDisposable
         _settingsCatalogService.RemovePluginSections(pluginId);
     }
 
+    private enum PluginCatalogSourceKind
+    {
+        Package = 0,
+        Manifest = 1,
+        DevPlugin = 2
+    }
+
     private sealed record PluginCandidate(
         string SourcePath,
         PluginManifest Manifest,

README.md

@@ -87,7 +87,7 @@ dotnet new install LanMountainDesktop.PluginTemplate
 dotnet new lmd-plugin -n MyPlugin
 ```
 
-- **Plugin SDK**: `LanMountainDesktop.PluginSdk` (API 4.0.0)
+- **Plugin SDK**: `LanMountainDesktop.PluginSdk` (API 4.0.1)
 - **共享契约**: `LanMountainDesktop.Shared.Contracts`
 - **迁移指南**: [PLUGIN_SDK_V4_MIGRATION.md](docs/PLUGIN_SDK_V4_MIGRATION.md)
 

design.md

@@ -0,0 +1,683 @@
+# UI Design System Guide (design.md)
+
+> **目标**: 让 AI 正确使用 Fluent Avalonia / Fluent Icons / Material Avalonia，避免窗口套窗口、容器套容器
+>
+> **最后更新**: 2026-04-11
+
+---
+
+## 一句话总结
+
+**主界面用 Fluent + FluentIcon，编辑器用 Material + MaterialIcon，永远不要混用，保持扁平结构。**
+
+---
+
+## 1. 技术栈与职责
+
+### 1.1 库清单
+
+| 库 | 包名 | 什么时候用 |
+|---|------|----------|
+| **FluentAvaloniaUI** | `FluentAvaloniaUI` | 主界面、设置页、导航 |
+| **FluentIcons.Avalonia.Fluent** | `FluentIcons.Avalonia.Fluent` | 主界面图标（**首选**）|
+| **FluentIcons.Avalonia** | `FluentIcons.Avalonia` | 旧图标兼容（SymbolIcon）|
+| **Material.Icons.Avalonia** | `Material.Icons.Avalonia` | 编辑器图标（**仅限 ComponentEditorWindow**）|
+| **Material.Avalonia** | `Material.Avalonia` | MD3 主题（**仅限 ComponentEditorWindow**）|
+
+### 1.2 初始化顺序（App.axaml）
+
+```xml
+<Application.Styles>
+    <sty:FluentAvaloniaTheme />           <!-- 第 1 位：基础 Win11 风格 -->
+    <mi:MaterialIconStyles />             <!-- 第 2 位：全局注册 Material Icons 样式 -->
+    
+    <!-- 项目自定义样式 -->
+    <StyleInclude Source="avares://LanMountainDesktop/Styles/FlutermotionToken.axaml" />
+    <StyleInclude Source="avares://LanMountainDesktop/Styles/GlassModule.axaml" />
+    <StyleInclude Source="avares://LanMountainDesktop/Styles/SettingsAnimations.axaml" />
+    <StyleInclude Source="avares://LanMountainDesktop/Styles/SettingsCardStyles.axaml" />
+    <StyleInclude Source="avares://LanMountainDesktop/Styles/NavigationStyles.axaml" />
+</Application.Styles>
+```
+
+---
+
+## 2. 命名空间速查表
+
+**复制粘贴用：**
+
+```xml
+<!-- 必需 -->
+xmlns="https://github.com/avaloniaui"
+xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+
+<!-- FluentAvaloniaUI 控件（主界面/设置页必需）-->
+xmlns:ui="using:FluentAvalonia.UI.Controls"
+
+<!-- Fluent Icons - 新版推荐（主界面首选）-->
+xmlns:fi="using:FluentIcons.Avalonia.Fluent"
+
+<!-- Fluent Icons - 旧版兼容（已有代码维护用）-->
+<!-- xmlns:fi-legacy="using:FluentIcons.Avalonia" -->
+
+<!-- Material Icons（仅 ComponentEditorWindow 使用）-->
+<!-- xmlns:mi="clr-namespace:Material.Icons.Avalonia;assembly=Material.Icons.Avalonia" -->
+
+<!-- Material Theme（仅 ComponentEditorWindow 使用）-->
+<!-- xmlns:themes="clr-namespace:Material.Styles.Themes;assembly=Material.Styles" -->
+
+<!-- 项目控件 -->
+xmlns:local="using:LanMountainDesktop.Controls"
+xmlns:comp="using:LanMountainDesktop.Views.Components"
+```
+
+---
+
+## 3. 图标系统
+
+### 3.1 选择决策树
+
+```
+你在写什么？
+├─ 设置页面 / 主界面 / 桌面组件？
+│  └─ 用 FluentIcon（fi:FluentIcon）
+│     ├─ 需要 Filled/Regular 切换？→ IconVariant="Filled" 或 "Regular"
+│     └─ 简单静态图标？→ 也用 FluentIcon，不用 SymbolIcon
+│
+├─ ComponentEditorWindow 及其子页面？
+│  └─ 用 MaterialIcon（mi:MaterialIcon）
+│
+└─ 其他情况？
+   └─ 默认 FluentIcon
+```
+
+### 3.2 FluentIcon 使用方法
+
+```xml
+<fi:FluentIcon Icon="Settings"              <!-- 图标名称 -->
+               IconVariant="Filled"         <!-- Filled | Regular -->
+               Classes="icon-m" />          <!-- icon-s(12px) | icon-m(16px) | icon-l(20px) -->
+```
+
+**常用图标名称：**
+- 导航类：`Home`, `Settings`, `Navigation`, `ArrowLeft`, `ChevronRight`, `Dismiss`
+- 操作类：`Add`, `Delete`, `Edit`, `Save`, `Refresh`, `Sync`, `ArrowSync`
+- 状态类：`Info`, `Warning`, `ErrorBadge`, `CheckmarkCircle`
+- 外观类：`ThemeLightDark`, `ColorBackground`, `Appearance`
+
+### 3.3 MaterialIcon 使用方法（仅限编辑器）
+
+```xml
+<mi:MaterialIcon Kind="Close"                <!-- 图标名称 -->
+                 Width="24"
+                 Height="24"
+                 Foreground="{DynamicResource EditorPrimaryBrush}" />
+```
+
+**常用 Kind 值：**
+- 操作：`Close`, `Check`, `Pencil`, `Delete`, `Settings`, `Plus`
+- 导航：`ArrowLeft`, `ArrowRight`, `Home`, `Menu`
+- 系统：`Power`, `Lock`, `ExitToApp`, `Refresh`, `WeatherNight`
+
+### 3.4 ❌ 禁止事项
+
+```xml
+<!-- ❌ 错误：同一区域混用两种图标库 -->
+<StackPanel>
+    <fi:FluentIcon Icon="Home" />           <!-- Fluent -->
+    <mi:MaterialIcon Kind="Settings" />     <!-- Material -->
+</StackPanel>
+
+<!-- ❌ 错误：硬编码尺寸 -->
+<fi:FluentIcon Icon="Settings" FontSize="18" />
+
+<!-- ✅ 正确：使用预定义 class -->
+<fi:FluentIcon Icon="Settings" Classes="icon-m" />
+```
+
+---
+
+## 4. 容器嵌套规范（核心！）
+
+### 4.1 最大深度限制
+
+| 场景 | 最大层数 | 从哪里开始数 |
+|-----|---------|------------|
+| 普通页面 | **≤ 4 层** | Window/UserControl → ... → 叶子节点 |
+| Popup/Dialog | **≤ 3 层** | Border → Content |
+| 列表项/DataTemplate | **≤ 3 层** | Root → ... → 元素 |
+| MainWindow 桌面布局 | **≤ 6 层** | 特殊允许（多层叠加需求）|
+
+### 4.2 如何数层级？
+
+从根元素到目标元素经过的容器标签数：
+
+```xml
+<UserControl>                          <!-- 层级 0（根）-->
+    <Border>                           <!-- 层级 1 -->
+        <Grid>                         <!-- 层级 2 -->
+            <StackPanel>               <!-- 层级 3 -->
+                <Button>               <!-- 层级 4（叶子节点）✅ OK -->
+                </Button>
+            </StackPanel>
+        </Grid>
+    </Border>
+</UserControl>
+```
+
+### 4.3 推荐的标准结构
+
+#### 结构 A：标准设置页面（3-4 层）
+
+```xml
+<UserControl>
+    <ScrollViewer>                                     <!-- 层 1 -->
+        <StackPanel Spacing="24">                      <!-- 层 2 -->
+            <Border Classes="settings-section-card">  <!-- 层 3 -->
+                <StackPanel Spacing="16">              <!-- 层 4 ✅ -->
+                    <!-- 内容 -->
+                </StackPanel>
+            </Border>
+        </StackPanel>
+    </ScrollViewer>
+</UserControl>
+```
+
+#### 结构 B：卡片/面板组件（3 层）
+
+```xml
+<Border CornerRadius="..." Padding="...">            <!-- 层 1（根）-->
+    <Grid RowDefinitions="Auto,*">                   <!-- 层 2 -->
+        <Grid ColumnDefinitions="Auto,*,Auto">        <!-- 层 3a: Header -->
+            <fi:FluentIcon Classes="icon-l" />
+            <TextBlock Grid.Column="1" />
+            <ContentPresenter Grid.Column="2" />
+        </Grid>
+        <ContentControl Grid.Row="1" />              <!-- 层 3b: Body ✅ -->
+    </Grid>
+</Border>
+```
+
+#### 结构 C：列表项（2-3 层）
+
+```xml
+<Border Classes="list-item">                         <!-- 层 1 -->
+    <Grid ColumnDefinitions="Auto,*,Auto">           <!-- 层 2 -->
+        <Border Classes="icon-host">                 <!-- 层 3a -->
+            <fi:FluentIcon Classes="icon-m" />
+        </Border>
+        <StackPanel Grid.Column="1" Spacing="4">     <!-- 层 3b -->
+            <TextBlock Classes="title" />
+            <TextBlock Classes="subtitle" />
+        </StackPanel>
+        <Button Grid.Column="2">...</Button>         <!-- 层 3c ✅ -->
+    </Grid>
+</Border>
+```
+
+### 4.4 ❌ 反模式：过度嵌套
+
+```xml
+<!-- ❌ 错误：7 层嵌套（实际项目中出现的反面教材）-->
+<Grid>                              <!-- 1 -->
+    <Grid>                          <!-- 2 -->
+        <Border>                    <!-- 3 -->
+            <Grid>                  <!-- 4 -->
+                <Border>            <!-- 5 -->
+                    <Grid>          <!-- 6 -->
+                        <Border>    <!-- 7 ❌ 太深了！-->
+                            <Button Content="Click" />
+                        </Border>
+                    </Grid>
+                </Border>
+            </Grid>
+        </Border>
+    </Grid>
+</Grid>
+
+<!-- ✅ 重构后：2 层 -->
+<Grid HorizontalAlignment="Center"
+      VerticalAlignment="Center">
+    <Button Content="Click"
+            Padding="16,8" />
+</Grid>
+```
+
+### 4.5 何时可以超过限制？
+
+只有这 3 种情况：
+
+1. **MainWindow 桌面布局**（壁纸层 + 组件层 + 拖拽层 + 任务栏）
+2. **需要独立动画层**（Transform/Opacity 动画需要单独容器）
+3. **复杂 Popup 内部**
+
+**必须加注释说明原因：**
+```xml
+<!--
+  允许深层嵌套原因：桌面渲染需要支持以下视觉层级
+  - DesktopWallpaperLayer（壁纸背景）
+  - DesktopPagesContainer（桌面分页）
+  - LauncherPagePanel（启动器面板）
+  - Canvas 拖拽层
+  - BottomTaskbarContainer（任务栏）
+-->
+<Grid x:Name="DesktopHost">
+    ...
+</Grid>
+```
+
+---
+
+## 5. 窗口 vs UserControl vs Border
+
+### 5.1 什么时候用什么？
+
+| 需求 | 用什么 | 示例 |
+|-----|-------|------|
+| 独立窗口（有标题栏、可拖动、任务栏可见）| **Window** | SettingsWindow, ComponentEditorWindow |
+| 可复用的 UI 组件块 | **UserControl** | SettingsOptionCard, ClockWidget |
+| 视觉上的卡片/面板/容器 | **Border** | 设置分区卡片、弹出面板 |
+
+### 5.2 ❌ 禁止：窗口套窗口
+
+```csharp
+// ❌ 错误：在 XAML 中实例化另一个 Window
+// <local:SettingsWindow Visibility="Visible" />
+
+// ✅ 正确：通过代码显示独立窗口
+var settings = new SettingsWindow { Owner = this };
+settings.Show();
+```
+
+### 5.3 ❌ 禁止：把 Window 当 UserControl 用
+
+```xml
+<!-- ❌ 错误：MainWindow 内部嵌入了一个本应是独立窗口的东西 -->
+<Window x:Class="MainWindow">
+    <Grid>
+        <Border x:Name="ComponentLibraryWindow"  <!-- 这看起来像窗口，但不应该是 Window -->
+               Width="620"
+               Height="320"
+               CornerRadius="36">
+            <!-- 组件库内容 -->
+        </Border>
+    </Grid>
+</Window>
+```
+
+**如果它不是真正的操作系统窗口，就用 Border 或 UserControl。**
+
+---
+
+## 6. 颜色与资源使用规范
+
+### 6.1 必须使用 DynamicResource
+
+```xml
+<!-- ❌ 错误：硬编码颜色 -->
+<TextBlock Foreground="#FF1D1B20" />
+<Border Background="#FFF3EDF7" />
+<Button Background="#FF6750A4" />
+
+<!-- ✅ 正确：使用动态资源 -->
+<TextBlock Foreground="{DynamicResource AdaptiveTextPrimaryBrush}" />
+<Border Background="{DynamicResource AdaptiveSurfaceRaisedBrush}" />
+<Button Background="{DynamicResource AccentBrush}" />
+```
+
+### 6.2 常用资源键速查
+
+| 资源键 | 用途 | 示例场景 |
+|--------|------|---------|
+| `AdaptiveTextPrimaryBrush` | 主要文本 | 标题、正文 |
+| `AdaptiveTextSecondaryBrush` | 次要文本 | 描述文字、提示 |
+| `AdaptiveSurfaceRaisedBrush` | 抬高表面 | 卡片背景、面板 |
+| `AdaptiveSurfaceOverlayBrush` | 覆盖层 | 遮罩、弹窗背景 |
+| `AccentBrush` | 强调色 | 主按钮、选中态 |
+| `AppFontFamily` | 应用字体 | 全局字体设置 |
+
+### 6.3 圆角 Token（强制！）
+
+```xml
+<!-- ❌ 错误：硬编码圆角 -->
+<Border CornerRadius="8" />
+<Button CornerRadius="12" />
+
+<!-- ❌ 错误：桌面组件根容器用了非组件级 Token -->
+<Border CornerRadius="{DynamicResource DesignCornerRadiusMd}" />
+
+<!-- ✅ 正确 -->
+<!-- 桌面组件（Widget）根容器必须且只能用这个 -->
+<Border CornerRadius="{DynamicResource DesignCornerRadiusComponent}" />
+
+<!-- 内部元素按层级选择 -->
+<Border CornerRadius="{DynamicResource DesignCornerRadiusSm}" />   <!-- 小 -->
+<Border CornerRadius="{DynamicResource DesignCornerRadiusMd}" />   <!-- 中 -->
+<Border CornerRadius="{DynamicResource DesignCornerRadiusLg}" />   <!-- 大 -->
+```
+
+---
+
+## 7. FluentAvaloniaUI 控件用法
+
+### 7.1 NavigationView（设置页导航）
+
+```xml
+<ui:NavigationView x:Name="RootNav"
+                   PaneDisplayMode="Auto"           <!-- 自动折叠 -->
+                   OpenPaneLength="283"             <!-- Win11 标准宽度 -->
+                   IsSettingsVisible="False"        <!-- 隐藏默认设置按钮 -->
+                   IsBackButtonVisible="False"
+                   SelectionChanged="OnNavChanged">
+
+    <ui:NavigationView.Resources>
+        <!-- 移除默认背景色 -->
+        <SolidColorBrush x:Key="NavigationViewContentBackground" Color="Transparent" />
+        <SolidColorBrush x:Key="NavigationViewContentGridBorderBrush" Color="Transparent" />
+    </ui:NavigationView.Resources>
+
+    <Grid Margin="12,0,16,16">
+        <ui:Frame x:Name="ContentFrame" />
+    </Grid>
+</ui:NavigationView>
+```
+
+### 7.2 Frame（页面导航容器）
+
+```xml
+<ui:Frame x:Name="ContentFrame" />
+```
+
+```csharp
+// C# 代码中导航
+ContentFrame.Navigate(typeof(SettingsHomePage));
+// 或绑定
+ContentFrame.SourcePageType = typeof(SettingsHomePage);
+```
+
+### 7.3 InfoBar（内联通知条）
+
+```xml
+<ui:InfoBar Title="发现新版本"
+             Message="v2.0.0 可用"
+             Severity="Informational"       <!-- Informational | Warning | Error | Success -->
+             IsOpen="True"
+             ActionButtonText="立即更新"
+             ActionButtonClick="OnUpdateClick"
+             CloseButtonClick="OnDismissClick" />
+```
+
+### 7.4 ContentDialog（模态对话框）
+
+```csharp
+var dialog = new ContentDialog
+{
+    Title = "确认删除",
+    Content = "确定要删除吗？此操作不可撤销。",
+    PrimaryButtonText = "删除",
+    CloseButtonText = "取消",
+    DefaultButton = ContentDialogButton.Primary
+};
+
+var result = await dialog.ShowAsync(this);
+if (result == ContentDialogResult.Primary)
+{
+}
+```
+
+---
+
+## 8. Material.Avalonia 使用规范（严格限制！）
+
+### 8.1 ⚠️ 只能在这里用
+
+**✅ 允许：**
+- `ComponentEditorWindow.axaml`
+- ComponentEditorWindow 的子编辑页面
+
+**❌ 禁止：**
+- MainWindow
+- SettingsWindow
+- NotificationWindow
+- 任何桌面组件（Widget）
+- 任何其他地方
+
+### 8.2 如何在 ComponentEditorWindow 中启用
+
+```xml
+<Window ...>
+    <Window.Resources>
+        <!-- MD3 色板（仅此窗口有效）-->
+        <SolidColorBrush x:Key="EditorPrimaryBrush" Color="#FF6750A4" />
+        <SolidColorBrush x:Key="EditorSurfaceContainerBrush" Color="#FFF3EDF7" />
+        <SolidColorBrush x:Key="EditorOnPrimaryBrush" Color="#FFFFFFFF" />
+    </Window.Resources>
+
+    <Window.Styles>
+        <!-- 加载 Material 主题（只影响此窗口）-->
+        <themes:CustomMaterialTheme BaseTheme="Light"
+                                     PrimaryColor="#6750A4"
+                                     SecondaryColor="#625B71" />
+
+        <!-- 项目自定义覆盖 -->
+        <StyleInclude Source="avares://LanMountainDesktop/Styles/ComponentEditorThemeResources.axaml" />
+    </Window.Styles>
+</Window>
+```
+
+### 8.3 MD3 组件示例
+
+#### FAB 按钮（浮动操作按钮）
+
+```xml
+<Button x:Name="SaveFAB"
+        HorizontalAlignment="Right"
+        VerticalAlignment="Bottom"
+        Margin="28"
+        Width="64" Height="64"
+        Background="{DynamicResource EditorPrimaryBrush}"
+        Foreground="{DynamicResource EditorOnPrimaryBrush}"
+        CornerRadius="{DynamicResource DesignCornerRadiusComponent}"
+        Click="OnSaveClick">
+    <mi:MaterialIcon Kind="Check" Width="32" Height="32" />
+</Button>
+```
+
+#### Top App Bar（顶栏）
+
+```xml
+<Border Background="{DynamicResource EditorTopAppBarBackgroundBrush}"
+        Padding="24,16">
+    <Grid ColumnDefinitions="Auto,*,Auto">
+        <mi:MaterialIcon Kind="Widgets"
+                         Width="28" Height="28"
+                         Foreground="{DynamicResource EditorPrimaryBrush}" />
+        <TextBlock Grid.Column="1"
+                   FontSize="20" FontWeight="SemiBold"
+                   Text="组件编辑器"
+                   Margin="16,0,0,0" />
+        <Button Grid.Column="2" Click="OnCloseClick">
+            <mi:MaterialIcon Kind="Close" Width="24" Height="24" />
+        </Button>
+    </Grid>
+</Border>
+```
+
+---
+
+## 9. 实战代码模板
+
+### 模板 1：新建设置页面
+
+文件位置：`Views/Settings/YourPageName.axaml`
+
+```xml
+<UserControl xmlns="https://github.com/avaloniaui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+             xmlns:fi="using:FluentIcons.Avalonia.Fluent"
+             xmlns:local="using:LanMountainDesktop.Controls"
+             x:Class="LanMountainDesktop.Views.Settings.YourPageName">
+
+    <ScrollViewer Padding="24,0,24,24">
+        <StackPanel Spacing="24">
+
+            <!-- 分区卡片 -->
+            <Border Classes="settings-section-card">
+                <StackPanel Spacing="16">
+
+                    <!-- 分区标题 -->
+                    <Grid ColumnDefinitions="Auto,*" ColumnSpacing="12">
+                        <fi:FluentIcon Icon="YourSectionIcon"
+                                       IconVariant="Filled"
+                                       Classes="icon-l" />
+                        <TextBlock Grid.Column="1"
+                                   Classes="settings-section-title"
+                                   Text="分区标题" />
+                    </Grid>
+
+                    <!-- 选项卡 1 -->
+                    <local:SettingsOptionCard Icon="OptionIcon1"
+                                              Title="选项标题"
+                                              Title="选项描述">
+                        <local:SettingsOptionCard.ActionContent>
+                            <ToggleSwitch IsChecked="{Binding YourProperty, Mode=TwoWay}" />
+                        </local:SettingsOptionCard.ActionContent>
+                    </local:SettingsOptionCard>
+
+                    <!-- 选项卡 2 -->
+                    <local:SettingsOptionCard Icon="OptionIcon2"
+                                              Title="另一个选项"
+                                              Title="描述信息" />
+
+                </StackPanel>
+            </Border>
+
+        </StackPanel>
+    </ScrollViewer>
+</UserControl>
+```
+
+**嵌套检查：** ScrollViewer(1) > StackPanel(2) > Border(3) > StackPanel(4) > Items(5) ✅ （因为有 ScrollViewer 容器，5 层可接受）
+
+### 模板 2：新建桌面小组件
+
+文件位置：`Views/Components/YourWidget.axaml`
+
+```xml
+<UserControl xmlns="https://github.com/avaloniaui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+             x:Class="LanMountainDesktop.Views.Components.YourWidget">
+
+    <Border Classes="desktop-widget-root"
+            CornerRadius="{DynamicResource DesignCornerRadiusComponent}"
+            Padding="16,12">
+        <Grid RowDefinitions="Auto,*" RowSpacing="8">
+
+            <!-- 标题区 -->
+            <TextBlock x:Name="TitleTextBlock"
+                       FontSize="14"
+                       FontWeight="SemiBold" />
+
+            <!-- 内容区 -->
+            <ContentControl Grid.Row="1" />
+
+        </Grid>
+    </Border>
+</UserControl>
+```
+
+**嵌套检查：** Border(1) > Grid(2) > Elements(3) ✅ 完美！
+
+### 模板 3：新建独立窗口
+
+```xml
+<Window xmlns="https://github.com/avaloniaui"
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+        xmlns:ui="using:FluentAvalonia.UI.Controls"
+        xmlns:fi="using:FluentIcons.Avalonia.Fluent"
+        x:Class="LanMountainDesktop.Views.YourWindow"
+        Width="800"
+        Height="600"
+        MinWidth="400"
+        MinHeight="300"
+        CanResize="True"
+        SystemDecorations="BorderOnly"
+        Background="Transparent"
+        Title="窗口标题">
+
+    <Grid RowDefinitions="Auto,*">
+
+        <!-- 自定义标题栏 -->
+        <Border Height="48"
+                Padding="12,0"
+                PointerPressed="OnTitleBarPressed">
+            <Grid ColumnDefinitions="Auto,*,Auto">
+                <fi:FluentIcon Icon="WindowIcon"
+                               IconVariant="Filled"
+                               Classes="icon-m" />
+                <TextBlock Grid.Column="1"
+                           Text="{Binding Title}"
+                           VerticalAlignment="Center" />
+                <Button Grid.Column="2"
+                        Click="OnCloseClick">
+                    <fi:FluentIcon Icon="Dismiss" IconVariant="Regular" />
+                </Button>
+            </Grid>
+        </Border>
+
+        <!-- 主内容区 -->
+        <ContentControl Grid.Row="1"
+                        Content="{Binding Content}" />
+
+    </Grid>
+</Window>
+```
+
+**嵌套检查：** Grid(1) > Border(2) > Grid(3) > Elements(4) ✅
+
+---
+
+## 10. AI 编码检查清单
+
+### 写代码前问自己
+
+- [ ] 这个文件是设置页/主界面？→ 用 Fluent + FluentIcon
+- [ ] 这个文件是 ComponentEditorWindow？→ 用 Material + MaterialIcon
+- [ ] 我用了正确的命名空间吗？（见第 2 节速查表）
+- [ ] 图标用了 Classes="icon-s/m/l" 而非硬编码 FontSize 吗？
+
+### 写完代码后检查
+
+- [ ] 数一下最大嵌套深度（见第 4.2 节）
+- [ ] 有没有硬编码颜色值？（应该都用 DynamicResource）
+- [ ] 有没有硬编码 CornerRadius？（应该用 DesignCornerRadiusXxx）
+- [ ] 有没有在同一区域混用 FluentIcon 和 MaterialIcon？
+- [ ] 是不是不小心写了 `<local:SomeWindow>` 在另一个 Window 里？
+- [ ] 是不是连续写了 Border > Grid > Border > Grid 可以合并？
+
+### 如果审查别人代码
+
+- [ ] 发现窗口套窗口了吗？
+- [ ] 发现超过 4 层的无意义嵌套了吗？（没有注释说明原因的话）
+- [ ] 发现 Fluent 和 Material 控件混在同一区域了吗？
+- [ ] 发现应该用 DynamicResource 的地方硬编码了吗？
+
+---
+
+## 附录：常见错误快速修复
+
+| 错误现象 | 问题原因 | 修复方法 |
+|---------|---------|---------|
+| 图标不显示或大小不对 | 用了错误的命名空间或硬编码尺寸 | 改用 `fi:FluentIcon` + `Classes="icon-m"` |
+| 圆角在设置里改了但没生效 | 硬编码了 CornerRadius | 改用 `{DynamicResource DesignCornerRadiusComponent}` |
+| 深色模式下颜色刺眼 | 硬编码了颜色值 | 改用 `{DynamicResource AdaptiveTextPrimaryBrush}` 等 |
+| 设置页风格和其他窗口不一致 | 混用了 Material 控件 | 统一用 FluentAvaloniaUI 控件 |
+| 性能差/渲染慢 | 嵌套太深（>6 层）| 扁平化结构，合并多余容器 |
+| 弹窗显示位置/大小异常 | 把 Window 当成 UserControl 嵌套了 | 改为代码中 `.Show()` 显示 |
+
+---
+
+**相关文档：**
+- [VISUAL_SPEC.md](./VISUAL_SPEC.md) - 视觉规范总纲
+- [CORNER_RADIUS_SPEC.md](./CORNER_RADIUS_SPEC.md) - 圆角详细规范
+- AGENTS.md - AI 强制规则

docs/PRODUCT.md

@@ -39,7 +39,7 @@
 ### 当前阶段
 
 - 产品版本：`1.0.0`
-- Plugin SDK API 基线：`4.0.0`
+- Plugin SDK API 基线：`4.0.1`
 - 当前重点：持续完善宿主体验、设置页体验、组件能力与插件生态
 - 近期需求入口：以 `.trae/specs/` 中的 feature spec 为准
 
@@ -59,4 +59,4 @@
 
 LanMountainDesktop is a cross-platform desktop enhancement product built with Avalonia UI and .NET 10. It targets students, office users, and customization-focused users who want a programmable desktop surface for information, tools, and plugin-driven extensions.
 
-This repository is the source of truth for the desktop host, plugin runtime, Plugin SDK, shared contracts, and core appearance/settings infrastructure. The current product version is `1.0.0`, and the active Plugin SDK baseline in this repository is `4.0.0`.
+This repository is the source of truth for the desktop host, plugin runtime, Plugin SDK, shared contracts, and core appearance/settings infrastructure. The current product version is `1.0.0`, and the active Plugin SDK baseline in this repository is `4.0.1`.

docs/Plugins develop/00-索引与导航.md

@@ -0,0 +1,118 @@
+# 🧭 阑山桌面插件开发文档导航
+
+欢迎来到 **LanMountainDesktop（阑山桌面）** 插件开发文档！
+
+这套文档将帮助你从零开始，一步步掌握插件开发的完整流程，最终发布你的作品到插件市场。
+
+---
+
+## 📖 文档概述
+
+**目标读者：**
+- 有一定 .NET/C# 基础的开发者
+- 熟悉或愿意学习 Avalonia UI 框架的开发者
+- 想要为阑山桌面扩展功能的创意开发者
+
+**你能学到什么：**
+- 🚀 快速搭建插件开发环境
+- 🧩 创建桌面组件（Widgets）
+- ⚙️ 集成设置页面
+- 🎨 适配主题和外观
+- 🐛 调试和故障排除
+- 🚀 CI/CD 自动化构建
+- 📦 发布到插件市场
+
+---
+
+## 🛤️ 推荐阅读路径
+
+### 🌱 新手路径（从零开始）
+
+如果你从未开发过阑山桌面插件，请按以下顺序阅读：
+
+1. **[01-开发环境准备](01-快速开始/01-开发环境准备.md)** - 安装必要工具和模板
+2. **[02-三分钟创建第一个插件](01-快速开始/02-三分钟创建第一个插件.md)** - 快速上手，建立信心
+3. **[03-插件项目结构详解](01-快速开始/03-插件项目结构详解.md)** - 理解项目组成
+4. **[04-调试运行指南](01-快速开始/04-调试运行指南.md)** - 学会调试技巧
+5. **[01-插件生命周期](02-核心概念与原理/01-插件生命周期.md)** - 理解运行原理
+6. **[02-桌面组件系统](02-核心概念与原理/02-桌面组件系统.md)** - 创建你的第一个组件
+7. **[01-开发天气组件](04-实战案例/01-开发天气组件.md)** - 完整实战案例
+
+**预计时间：** 2-3 小时即可开发出第一个可用插件
+
+### 🚀 有经验路径（已有 .NET/Avalonia 基础）
+
+如果你已有相关经验，可以跳过基础部分：
+
+1. **[01-开发环境准备](01-快速开始/01-开发环境准备.md)** - 快速配置环境
+2. **[02-核心概念与原理/](02-核心概念与原理/)** - 了解阑山桌面的特殊机制
+3. **[03-API实践指南/](03-API实践指南/)** - 查阅具体 API 用法
+4. **[04-实战案例/](04-实战案例/)** - 参考完整示例
+
+---
+
+## 🔍 快速问题索引
+
+| 我想知道... | 查看文档 |
+|------------|---------|
+| 如何搭建开发环境？ | [01-开发环境准备](01-快速开始/01-开发环境准备.md) |
+| 如何创建第一个插件？ | [02-三分钟创建第一个插件](01-快速开始/02-三分钟创建第一个插件.md) |
+| plugin.json 各字段含义？ | [03-插件项目结构详解](01-快速开始/03-插件项目结构详解.md) |
+| 如何调试插件代码？ | [04-调试运行指南](01-快速开始/04-调试运行指南.md) |
+| 插件什么时候初始化？能做什么？ | [01-插件生命周期](02-核心概念与原理/01-插件生命周期.md) |
+| 什么是桌面组件？如何创建？ | [02-桌面组件系统](02-核心概念与原理/02-桌面组件系统.md) |
+| 如何添加设置页面？ | [03-设置系统集成](02-核心概念与原理/03-设置系统集成.md) + [04-开发设置页面](04-实战案例/04-开发设置页面.md) |
+| 如何适配暗色模式？ | [04-外观与主题系统](02-核心概念与原理/04-外观与主题系统.md) |
+| 插件之间如何通信？ | [05-插件间通信](02-核心概念与原理/05-插件间通信.md) |
+| 完整的组件开发示例？ | [01-开发天气组件](04-实战案例/01-开发天气组件.md) |
+| 如何排查插件不加载的问题？ | [03-常见问题排查](05-调试与故障排除/03-常见问题排查.md) |
+| 如何配置 GitHub Actions？ | [01-GitHub Actions入门](06-CI-CD与自动化/01-GitHub Actions入门.md) |
+| 如何自动打包 .laapp？ | [03-自动打包与发布](06-CI-CD与自动化/03-自动打包与发布.md) |
+| 如何发布到插件市场？ | [03-发布到插件市场](07-发布与运营/03-发布到插件市场.md) |
+
+---
+
+## 📚 相关资源
+
+### 官方资源
+
+| 资源 | 位置 | 说明 |
+|-----|------|------|
+| **Plugin SDK 源码** | `LanMountainDesktop.PluginSdk/` | SDK 的完整源码和 XML 注释 |
+| **插件模板** | `LanMountainDesktop.PluginTemplate/` | `dotnet new` 模板源码 |
+| **共享契约** | `LanMountainDesktop.Shared.Contracts/` | 宿主与插件共享的类型定义 |
+| **架构文档** | `docs/ARCHITECTURE.md` | 宿主应用架构说明 |
+| **视觉规范** | `docs/VISUAL_SPEC.md` | UI 设计规范 |
+| **圆角规范** | `docs/CORNER_RADIUS_SPEC.md` | 圆角设计系统 |
+| **开发指南** | `docs/DEVELOPMENT.md` | 宿主开发指南 |
+
+### 外部资源
+
+| 资源 | 链接 | 说明 |
+|-----|------|------|
+| **示例插件仓库** | `LanMountainDesktop.SamplePlugin` | 官方示例插件（独立仓库） |
+| **Avalonia UI 文档** | https://docs.avaloniaui.net/ | UI 框架官方文档 |
+| **FluentAvalonia** | https://github.com/amwx/FluentAvalonia | 主题控件库 |
+| **.NET 文档** | https://learn.microsoft.com/dotnet/ | .NET 官方文档 |
+
+---
+
+## 💡 获取帮助
+
+如果在开发过程中遇到问题：
+
+1. **查阅本文档** - 使用上方快速索引找到相关章节
+2. **查看示例代码** - 参考 `LanMountainDesktop.PluginTemplate/content/` 中的模板代码
+3. **阅读 SDK 源码** - `LanMountainDesktop.PluginSdk/` 中有详细的 XML 注释
+4. **搜索 Issues** - 在 GitHub 仓库搜索是否有人遇到类似问题
+5. **提交 Issue** - 如果确认是 bug，欢迎提交 Issue
+
+---
+
+## 🎯 下一步
+
+准备好开始了吗？点击 **[01-开发环境准备](01-快速开始/01-开发环境准备.md)** 开始你的插件开发之旅！
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/01-快速开始/01-开发环境准备.md

@@ -0,0 +1,220 @@
+# 01-开发环境准备
+
+在开始开发阑山桌面插件之前，你需要准备好开发环境。本指南将带你完成所有必要的安装和配置。
+
+---
+
+## ✅ 系统要求
+
+### 支持的操作系统
+
+| 操作系统 | 版本要求 | 备注 |
+|---------|---------|------|
+| **Windows** | Windows 10 版本 1809 或更高 | 推荐开发平台 |
+| **Windows** | Windows 11 | 最佳体验 |
+| **Linux** | Ubuntu 20.04+ / Debian 10+ | 支持开发和运行 |
+| **macOS** | macOS 12+ | 支持开发和运行 |
+
+### 硬件要求
+
+- **处理器**：x64 或 ARM64 架构
+- **内存**：至少 4GB RAM（推荐 8GB）
+- **磁盘空间**：至少 2GB 可用空间
+
+---
+
+## 🛠️ 安装 .NET SDK
+
+阑山桌面插件基于 **.NET 10** 开发，你需要安装对应版本的 SDK。
+
+### 下载安装
+
+1. 访问 [.NET 10 下载页面](https://dotnet.microsoft.com/download/dotnet/10.0)
+2. 下载适合你操作系统的 SDK 安装包
+3. 运行安装程序，按提示完成安装
+
+### 验证安装
+
+打开终端（PowerShell、CMD 或 Bash），运行以下命令：
+
+```powershell
+# 检查 .NET SDK 版本
+dotnet --version
+```
+
+✅ **预期输出示例：**
+```
+10.0.100
+```
+
+⚠️ **如果版本低于 10.0**，请重新下载安装最新版 .NET 10 SDK。
+
+---
+
+## 💻 安装 IDE（集成开发环境）
+
+你可以选择以下任一 IDE 进行开发：
+
+### 选项 1：Visual Studio 2022（推荐 Windows 用户）
+
+**优点：** 功能最全，调试体验最佳
+
+1. 下载 [Visual Studio 2022](https://visualstudio.microsoft.com/vs/)
+2. 安装时选择以下工作负载：
+   - ✅ **.NET 桌面开发**
+   - ✅ **Avalonia UI 开发**（可选，如需 Avalonia 设计器）
+
+### 选项 2：JetBrains Rider（跨平台推荐）
+
+**优点：** 跨平台，智能提示强大，Avalonia 支持好
+
+1. 下载 [Rider](https://www.jetbrains.com/rider/)
+2. 安装后打开，会自动检测 .NET SDK
+
+### 选项 3：Visual Studio Code（轻量级）
+
+**优点：** 免费，轻量，插件丰富
+
+1. 下载 [VS Code](https://code.visualstudio.com/)
+2. 安装以下扩展：
+   - **C# Dev Kit**（Microsoft 官方）
+   - **Avalonia for VS Code**（可选）
+
+---
+
+## 📦 安装插件模板
+
+阑山桌面提供了官方的 `dotnet new` 模板，帮助你快速创建插件项目。
+
+### 安装模板
+
+```powershell
+# 安装最新版插件模板
+dotnet new install LanMountainDesktop.PluginTemplate
+```
+
+✅ **成功提示：**
+```
+模板名                                 短名称      语言  标签
+-------------------------------------  ----------  ----  ------------
+LanMountainDesktop Plugin              lmd-plugin  C#    LanMountainDesktop/Plugin
+```
+
+### 验证安装
+
+```powershell
+# 列出已安装的模板，查找 lmd-plugin
+dotnet new list | findstr lmd
+```
+
+或（Linux/macOS）：
+```bash
+dotnet new list | grep lmd
+```
+
+---
+
+## 🎮 获取宿主应用
+
+插件需要在阑山桌面宿主中运行，你需要获取宿主应用：
+
+### 方式 1：下载 Release 版本（推荐）
+
+1. 访问 GitHub Releases 页面
+2. 下载最新版本的安装包（.exe / .deb / .dmg）
+3. 安装并运行阑山桌面
+
+### 方式 2：从源码构建
+
+如果你想调试宿主或了解内部机制：
+
+```powershell
+# 克隆仓库
+git clone https://github.com/your-org/LanMountainDesktop.git
+cd LanMountainDesktop
+
+# 还原依赖
+dotnet restore
+
+# 构建项目
+dotnet build LanMountainDesktop.slnx -c Debug
+
+# 运行宿主
+dotnet run --project LanMountainDesktop/LanMountainDesktop.csproj
+```
+
+---
+
+## 🔍 环境验证清单
+
+在继续之前，请确认以下检查项都已完成：
+
+| 检查项 | 验证命令 | 预期结果 |
+|-------|---------|---------|
+| ✅ .NET SDK 版本 | `dotnet --version` | 10.0.xxx |
+| ✅ 模板已安装 | `dotnet new list \| findstr lmd` | 显示 lmd-plugin |
+| ✅ IDE 可创建项目 | 在 IDE 中新建项目 | 能看到 C# 项目模板 |
+| ✅ 宿主可运行 | 双击 LanMountainDesktop.exe | 应用正常启动 |
+
+---
+
+## ⚠️ 常见问题
+
+### 问题 1：dotnet 命令找不到
+
+**现象：** 运行 `dotnet` 提示不是内部或外部命令
+
+**解决：**
+1. 确认 .NET SDK 已正确安装
+2. 重启终端或 IDE
+3. 检查环境变量 PATH 是否包含 `C:\Program Files\dotnet\`
+
+### 问题 2：模板安装失败
+
+**现象：** `dotnet new install` 报错或卡住
+
+**解决：**
+1. 检查网络连接（需要访问 nuget.org）
+2. 尝试指定版本号：
+   ```powershell
+   dotnet new install LanMountainDesktop.PluginTemplate::1.0.0
+   ```
+3. 清除模板缓存后重试：
+   ```powershell
+   dotnet new uninstall LanMountainDesktop.PluginTemplate
+   dotnet new install LanMountainDesktop.PluginTemplate
+   ```
+
+### 问题 3：SDK 版本不匹配
+
+**现象：** 构建时提示 SDK 版本不符合 global.json 要求
+
+**解决：**
+1. 检查项目根目录的 `global.json` 文件
+2. 安装对应版本的 .NET SDK
+3. 或使用以下命令使用已安装的版本：
+   ```powershell
+   dotnet new globaljson --sdk-version 10.0.100 --roll-forward latestFeature
+   ```
+
+---
+
+## 🎯 下一步
+
+环境准备完成！接下来：
+
+👉 **[02-三分钟创建第一个插件](02-三分钟创建第一个插件.md)** - 立即开始创建你的第一个插件！
+
+---
+
+## 📚 参考资源
+
+- [.NET 10 下载](https://dotnet.microsoft.com/download/dotnet/10.0)
+- [Visual Studio 2022](https://visualstudio.microsoft.com/vs/)
+- [JetBrains Rider](https://www.jetbrains.com/rider/)
+- [VS Code](https://code.visualstudio.com/)
+- [Avalonia UI 文档](https://docs.avaloniaui.net/)
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/01-快速开始/02-三分钟创建第一个插件.md

@@ -0,0 +1,236 @@
+# 02-三分钟创建第一个插件
+
+本指南将帮助你在三分钟内创建并运行你的第一个阑山桌面插件。让我们开始吧！
+
+---
+
+## 🎯 目标
+
+完成本指南后，你将：
+- ✅ 创建一个可运行的插件项目
+- ✅ 在宿主中成功加载插件
+- ✅ 在插件列表中看到你的插件
+
+---
+
+## ⚡ 步骤一：创建项目（30秒）
+
+打开终端，运行以下命令：
+
+```powershell
+# 创建插件项目
+dotnet new lmd-plugin -n MyFirstPlugin
+
+# 进入项目目录
+cd MyFirstPlugin
+```
+
+✅ **成功标志：** 命令执行后没有报错，且生成了 `MyFirstPlugin` 文件夹。
+
+---
+
+## 📝 步骤二：配置插件信息（30秒）
+
+打开 `plugin.json` 文件，修改以下字段：
+
+```json
+{
+  "id": "com.yourname.myfirstplugin",
+  "name": "我的第一个插件",
+  "description": "这是一个测试插件",
+  "author": "你的名字",
+  "version": "1.0.0",
+  "apiVersion": "4.0.1",
+  "entranceAssembly": "MyFirstPlugin.dll",
+  "sharedContracts": []
+}
+```
+
+⚠️ **重要提示：**
+- `id` 必须是唯一的，建议使用反向域名格式（如 `com.yourname.pluginname`）
+- `apiVersion` 必须与 SDK 版本匹配
+- 保存文件时使用 **UTF-8** 编码
+
+---
+
+## 🔨 步骤三：构建项目（30秒）
+
+在终端中运行：
+
+```powershell
+# 构建项目
+dotnet build
+```
+
+✅ **成功标志：** 看到类似以下的输出：
+```
+生成成功。
+    0 个警告
+    0 个错误
+```
+
+---
+
+## 📦 步骤四：找到插件包（15秒）
+
+构建完成后，插件包位于：
+
+```
+MyFirstPlugin/
+└── bin/
+    └── Debug/
+        └── net10.0/
+            └── MyFirstPlugin.laapp    <-- 这就是插件包！
+```
+
+⚠️ **什么是 .laapp 文件？**
+- `.laapp` 是阑山桌面的插件包格式
+- 本质上是一个 ZIP 压缩包，包含插件 DLL 和资源文件
+- 不要解压，直接安装即可
+
+---
+
+## 🚀 步骤五：安装到宿主（30秒）
+
+1. **启动阑山桌面**（如果尚未运行）
+
+2. **打开设置**：
+   - 右键点击桌面上的阑山桌面图标
+   - 选择「设置」
+
+3. **进入插件管理**：
+   - 在设置窗口左侧选择「插件」
+
+4. **安装本地插件**：
+   - 点击「安装本地插件」按钮
+   - 选择刚才生成的 `.laapp` 文件
+   - 点击「打开」
+
+5. **重启宿主**：
+   - 安装完成后，点击「重启」按钮
+   - 阑山桌面将重新启动
+
+---
+
+## ✅ 步骤六：验证安装（15秒）
+
+重启后，再次打开设置 → 插件：
+
+🎉 **成功标志：**
+- 在插件列表中看到「我的第一个插件」
+- 状态显示为「已启用」
+- 作者显示为你设置的名字
+
+![插件列表示意图](此处应有截图位置)
+
+---
+
+## 📂 生成的项目结构
+
+你的项目现在包含以下文件：
+
+```
+MyFirstPlugin/
+├── plugin.json              # 插件清单文件
+├── MyFirstPlugin.csproj     # 项目文件
+├── Plugin.cs                # 插件入口类
+├── README.md                # 项目说明
+└── Localization/            # 本地化文件夹
+    ├── zh-CN.json           # 中文资源
+    └── en-US.json           # 英文资源
+```
+
+---
+
+## 🔍 查看插件代码
+
+打开 `Plugin.cs`，你会看到：
+
+```csharp
+using LanMountainDesktop.PluginSdk;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+
+namespace MyFirstPlugin;
+
+[PluginEntrance]
+public sealed class Plugin : PluginBase
+{
+    public override void Initialize(HostBuilderContext context, IServiceCollection services)
+    {
+        // 插件初始化代码
+        // 在这里注册组件、设置页面等
+    }
+}
+```
+
+**关键点：**
+- `[PluginEntrance]` 特性标记入口类
+- 继承 `PluginBase` 基类
+- `Initialize` 方法是插件的初始化入口
+
+---
+
+## 🎉 恭喜！
+
+你已经成功创建并安装了第一个阑山桌面插件！
+
+虽然这个插件目前还没有任何功能，但你已经掌握了：
+- ✅ 使用模板创建项目
+- ✅ 配置插件信息
+- ✅ 构建插件包
+- ✅ 安装到宿主
+
+---
+
+## 🚦 常见问题
+
+### 问题 1：构建失败，提示找不到 SDK
+
+**现象：** 错误信息包含 "SDK not found"
+
+**解决：**
+1. 确认已安装 .NET 10 SDK：`dotnet --version`
+2. 检查 `global.json` 中的版本要求
+
+### 问题 2：宿主提示插件安装失败
+
+**现象：** 安装时弹出错误对话框
+
+**排查步骤：**
+1. 检查 `plugin.json` 是否为有效的 JSON 格式
+2. 确认 `id` 字段唯一且合法（只能包含字母、数字、点号）
+3. 确认 `apiVersion` 与 SDK 版本匹配
+
+### 问题 3：插件列表中不显示
+
+**现象：** 安装后重启，但列表中没有
+
+**排查步骤：**
+1. 确认已点击「重启」按钮
+2. 检查日志文件：`%LOCALAPPDATA%\LanMountainDesktop\logs\`
+3. 确认 `.laapp` 文件完整未损坏
+
+---
+
+## 🎯 下一步
+
+现在你的插件已经能运行了，接下来学习：
+
+👉 **[03-插件项目结构详解](03-插件项目结构详解.md)** - 深入理解每个文件的作用
+
+或者直接进入实战：
+
+👉 **[02-桌面组件系统](../02-核心概念与原理/02-桌面组件系统.md)** - 创建你的第一个桌面组件！
+
+---
+
+## 💡 小贴士
+
+- **快速重建**：修改代码后，只需运行 `dotnet build` 即可重新生成 `.laapp`
+- **自动安装**：可以在 IDE 中配置构建后自动复制到宿主插件目录
+- **日志调试**：使用 `ILogger` 记录日志，在 `%LOCALAPPDATA%\LanMountainDesktop\logs\` 查看
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/01-快速开始/03-插件项目结构详解.md

@@ -0,0 +1,350 @@
+# 03-插件项目结构详解
+
+了解插件项目的每个文件和文件夹的作用，是开发高质量插件的基础。本文将详细解析插件项目的完整结构。
+
+---
+
+## 📂 项目结构概览
+
+使用模板创建的插件项目结构如下：
+
+```
+MyPlugin/
+├── plugin.json                      # 插件清单（必需）
+├── MyPlugin.csproj                  # 项目文件（必需）
+├── Plugin.cs                        # 入口类（必需）
+├── README.md                        # 项目说明（推荐）
+├── .gitignore                       # Git忽略文件（可选）
+└── Localization/                    # 本地化文件夹（可选）
+    ├── zh-CN.json                   # 中文资源
+    └── en-US.json                   # 英文资源
+```
+
+---
+
+## 📋 plugin.json - 插件清单
+
+这是插件最重要的配置文件，定义了插件的元数据。
+
+### 完整示例
+
+```json
+{
+  "id": "com.example.myplugin",
+  "name": "我的插件",
+  "description": "这是一个示例插件",
+  "author": "作者名称",
+  "version": "1.0.0",
+  "apiVersion": "4.0.1",
+  "entranceAssembly": "MyPlugin.dll",
+  "sharedContracts": [],
+  "website": "https://example.com",
+  "icon": "icon.png",
+  "tags": ["工具", "实用"]
+}
+```
+
+### 字段详解
+
+| 字段 | 必需 | 说明 | 示例 |
+|-----|------|------|------|
+| `id` | ✅ | 唯一标识符，反向域名格式 | `com.yourname.plugin` |
+| `name` | ✅ | 显示名称 | `天气插件` |
+| `description` | ✅ | 简短描述 | `显示实时天气信息` |
+| `author` | ✅ | 作者名称 | `张三` |
+| `version` | ✅ | 版本号（语义化版本） | `1.0.0` |
+| `apiVersion` | ✅ | SDK API 版本 | `4.0.1` |
+| `entranceAssembly` | ✅ | 入口程序集文件名 | `MyPlugin.dll` |
+| `sharedContracts` | ✅ | 共享契约类型列表 | `[]` |
+| `website` | ❌ | 项目网站 | `https://github.com/...` |
+| `icon` | ❌ | 图标文件名 | `icon.png` |
+| `tags` | ❌ | 标签数组 | `["天气", "工具"]` |
+
+### 重要规则
+
+⚠️ **id 字段规则：**
+- 只能包含小写字母、数字、点号（`.`）
+- 必须全局唯一
+- 建议使用反向域名格式：`com.yourname.pluginname`
+- 一经发布不可更改
+
+⚠️ **version 字段规则：**
+- 使用语义化版本格式：`主版本.次版本.修订号`
+- 示例：`1.0.0`、`2.1.3-beta`
+
+⚠️ **apiVersion 字段规则：**
+- 必须与引用的 SDK 版本兼容
+- 当前最新版本：`4.0.1`
+- 不兼容时宿主将拒绝加载插件
+
+---
+
+## 🔧 .csproj - 项目文件
+
+定义了项目的构建配置和依赖项。
+
+### 完整示例
+
+```xml
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <LangVersion>latest</LangVersion>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="LanMountainDesktop.PluginSdk" Version="4.0.1" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <None Update="plugin.json">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+    </None>
+    <None Update="Localization\**\*.json">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+    </None>
+  </ItemGroup>
+
+</Project>
+```
+
+### 关键配置项
+
+| 配置项 | 说明 | 推荐值 |
+|-------|------|--------|
+| `TargetFramework` | 目标框架 | `net10.0` |
+| `LangVersion` | C# 语言版本 | `latest` |
+| `Nullable` | 可空引用类型 | `enable` |
+
+### SDK 引用
+
+```xml
+<PackageReference Include="LanMountainDesktop.PluginSdk" Version="4.0.1" />
+```
+
+⚠️ **版本必须匹配：**
+- SDK 版本必须与 `plugin.json` 中的 `apiVersion` 兼容
+- 建议使用最新稳定版
+
+### 资源文件配置
+
+确保 `plugin.json` 和本地化文件被正确复制到输出目录：
+
+```xml
+<ItemGroup>
+  <None Update="plugin.json">
+    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+  </None>
+  <None Update="Localization\**\*.json">
+    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+  </None>
+</ItemGroup>
+```
+
+---
+
+## 🚪 Plugin.cs - 入口类
+
+插件的入口点，负责初始化逻辑。
+
+### 基本结构
+
+```csharp
+using LanMountainDesktop.PluginSdk;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+
+namespace MyPlugin;
+
+[PluginEntrance]
+public sealed class Plugin : PluginBase
+{
+    public override void Initialize(HostBuilderContext context, IServiceCollection services)
+    {
+        // 在这里注册组件、设置页面、服务等
+        
+        // 示例：注册桌面组件
+        // services.AddPluginDesktopComponent<MyWidget>(...);
+        
+        // 示例：注册设置页面
+        // services.AddPluginSettingsSection(...);
+    }
+}
+```
+
+### 关键特性
+
+| 特性/类 | 说明 |
+|--------|------|
+| `[PluginEntrance]` | 标记插件入口类，必须有且仅有一个 |
+| `PluginBase` | 插件基类，提供基础功能和日志访问 |
+| `Initialize` | 初始化方法，宿主启动时调用 |
+
+### Initialize 方法参数
+
+```csharp
+public override void Initialize(HostBuilderContext context, IServiceCollection services)
+```
+
+| 参数 | 类型 | 说明 |
+|-----|------|------|
+| `context` | `HostBuilderContext` | 宿主构建上下文，可访问配置 |
+| `services` | `IServiceCollection` | 依赖注入服务集合，用于注册组件和服务 |
+
+---
+
+## 🌍 Localization - 本地化文件夹
+
+存放多语言资源文件，支持插件的国际化。
+
+### 文件夹结构
+
+```
+Localization/
+├── zh-CN.json          # 简体中文
+├── zh-TW.json          # 繁体中文
+├── en-US.json          # 英文（美国）
+├── ja-JP.json          # 日文
+└── ko-KR.json          # 韩文
+```
+
+### 资源文件格式
+
+```json
+{
+  "PluginName": "我的插件",
+  "Settings": {
+    "Title": "设置",
+    "RefreshInterval": "刷新间隔"
+  },
+  "Messages": {
+    "Loading": "加载中...",
+    "Error": "出错了：{0}"
+  }
+}
+```
+
+### 在代码中使用
+
+```csharp
+// 获取本地化字符串
+var localizer = serviceProvider.GetRequiredService<IStringLocalizer<MyPlugin>>();
+var pluginName = localizer["PluginName"];
+var message = localizer["Messages.Error", errorDetails];
+```
+
+### 支持的语言代码
+
+| 语言 | 代码 |
+|-----|------|
+| 简体中文 | `zh-CN` |
+| 繁体中文 | `zh-TW` |
+| 英文 | `en-US` |
+| 日文 | `ja-JP` |
+| 韩文 | `ko-KR` |
+
+---
+
+## 📦 构建输出结构
+
+运行 `dotnet build` 后，生成的输出结构：
+
+```
+bin/Debug/net10.0/
+├── MyPlugin.dll              # 插件程序集
+├── MyPlugin.pdb              # 调试符号
+├── plugin.json               # 插件清单（复制）
+├── Localization/             # 本地化文件夹（复制）
+│   └── zh-CN.json
+├── MyPlugin.laapp            # 插件包（由 SDK 自动生成）
+└── ...（依赖项 DLL）
+```
+
+### .laapp 包结构
+
+`.laapp` 文件本质是一个 ZIP 压缩包，包含：
+
+```
+MyPlugin.laapp
+├── plugin.json               # 清单文件
+├── MyPlugin.dll              # 主程序集
+├── Localization/             # 本地化资源
+└── ...（其他依赖 DLL）
+```
+
+---
+
+## 🔗 与其他 .NET 项目的区别
+
+| 特性 | 普通 .NET 应用 | 阑山桌面插件 |
+|-----|---------------|-------------|
+| 入口点 | `Program.cs` 的 `Main` | `Plugin.cs` 的 `Initialize` |
+| 运行方式 | 独立运行 | 由宿主加载运行 |
+| 依赖注入 | 自行配置 | 使用宿主提供的 `IServiceCollection` |
+| 输出格式 | `.exe` 或 `.dll` | `.laapp` 包 |
+| 资源访问 | 直接访问 | 通过 SDK API 访问宿主资源 |
+| 热重载 | 支持 | 不支持（需重启宿主） |
+
+---
+
+## 🎯 最佳实践
+
+### 项目组织建议
+
+```
+MyPlugin/
+├── plugin.json
+├── MyPlugin.csproj
+├── Plugin.cs                    # 入口类（保持简洁）
+├── README.md
+├── .gitignore
+├── Localization/                # 本地化资源
+├── Services/                    # 服务类文件夹
+│   ├── WeatherService.cs
+│   └── DataService.cs
+├── Views/                       # 视图文件夹
+│   ├── WeatherWidget.axaml
+│   ├── WeatherWidget.axaml.cs
+│   └── SettingsPage.axaml
+└── ViewModels/                  # 视图模型文件夹
+    ├── WeatherViewModel.cs
+    └── SettingsViewModel.cs
+```
+
+### 文件命名规范
+
+| 类型 | 命名约定 | 示例 |
+|-----|---------|------|
+| 入口类 | `Plugin` | `Plugin.cs` |
+| 组件视图 | `{Name}Widget` | `WeatherWidget.axaml` |
+| 设置页面 | `{Name}SettingsPage` | `WeatherSettingsPage.axaml` |
+| 服务类 | `{Name}Service` | `WeatherService.cs` |
+| 视图模型 | `{Name}ViewModel` | `WeatherViewModel.cs` |
+
+---
+
+## 📚 参考资源
+
+- [Plugin SDK 源码](../../LanMountainDesktop.PluginSdk/)
+- [插件模板](../../LanMountainDesktop.PluginTemplate/content/)
+- [02-桌面组件系统](../02-核心概念与原理/02-桌面组件系统.md)
+- [03-设置系统集成](../02-核心概念与原理/03-设置系统集成.md)
+
+---
+
+## 🎯 下一步
+
+理解了项目结构后，接下来学习：
+
+👉 **[04-调试运行指南](04-调试运行指南.md)** - 掌握调试技巧
+
+或者深入了解核心概念：
+
+👉 **[01-插件生命周期](../02-核心概念与原理/01-插件生命周期.md)** - 理解插件运行机制
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/01-快速开始/04-调试运行指南.md

@@ -0,0 +1,380 @@
+# 04-调试运行指南
+
+掌握插件调试技巧，能大幅提升开发效率。本文介绍阑山桌面插件的各种调试方法和常见问题排查。
+
+---
+
+## 🔄 调试方式概述
+
+阑山桌面插件有两种主要调试方式：
+
+| 方式 | 适用场景 | 优点 | 缺点 |
+|-----|---------|------|------|
+| **附加到进程** | 日常开发调试 | 不改变项目结构 | 每次需手动附加 |
+| **独立调试** | 深度调试、单元测试 | 启动即调试 | 配置较复杂 |
+
+---
+
+## 🎯 方式一：附加到进程（推荐）
+
+这是日常开发中最常用的调试方式。
+
+### 步骤
+
+1. **启动阑山桌面**
+   - 正常启动宿主应用（非调试模式）
+   - 确保你的插件已安装
+
+2. **在 IDE 中打开插件项目**
+   - 使用 Visual Studio / Rider / VS Code 打开项目
+
+3. **设置断点**
+   - 在你想要调试的代码行左侧点击，设置断点
+   - 常见断点位置：
+     - `Plugin.Initialize()` - 插件初始化
+     - 组件构造函数
+     - 设置页面加载方法
+
+4. **附加到进程**
+
+   **Visual Studio：**
+   - 菜单：`调试` → `附加到进程`
+   - 或快捷键：`Ctrl+Alt+P`
+   - 在列表中找到 `LanMountainDesktop.exe`
+   - 点击`附加`
+
+   **Rider：**
+   - 菜单：`Run` → `Attach to Process`
+   - 或快捷键：`Ctrl+Alt+F5`
+   - 选择 `LanMountainDesktop.exe`
+
+   **VS Code：**
+   - 按 `Ctrl+Shift+D` 打开调试面板
+   - 点击`创建 launch.json 文件`
+   - 选择 `.NET Core Attach`
+   - 选择 `LanMountainDesktop` 进程
+
+5. **触发调试**
+   - 在阑山桌面中操作，触发插件代码
+   - 例如：添加组件、打开设置页面等
+   - 程序会在断点处暂停
+
+### 附加配置（VS Code）
+
+创建 `.vscode/launch.json`：
+
+```json
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "附加到阑山桌面",
+      "type": "coreclr",
+      "request": "attach",
+      "processName": "LanMountainDesktop"
+    }
+  ]
+}
+```
+
+---
+
+## 🔧 方式二：独立调试
+
+适用于深度调试或单元测试。
+
+### 配置步骤
+
+1. **修改 .csproj 临时引用宿主**
+
+   ```xml
+   <ItemGroup>
+     <!-- 临时添加，仅用于调试 -->
+     <ProjectReference Include="..\LanMountainDesktop\LanMountainDesktop.csproj" />
+   </ItemGroup>
+   ```
+
+2. **创建调试启动配置**
+
+   **Visual Studio：**
+   - 右键项目 → `属性` → `调试`
+   - 启动外部程序：选择 `LanMountainDesktop.exe`
+   - 工作目录：设为宿主输出目录
+
+   **VS Code launch.json：**
+   ```json
+   {
+     "version": "0.2.0",
+     "configurations": [
+       {
+         "name": "启动阑山桌面(调试)",
+         "type": "coreclr",
+         "request": "launch",
+         "program": "${workspaceFolder}/../LanMountainDesktop/bin/Debug/net10.0/LanMountainDesktop.exe",
+         "args": [],
+         "cwd": "${workspaceFolder}/../LanMountainDesktop/bin/Debug/net10.0",
+         "stopAtEntry": false
+       }
+     ]
+   }
+   ```
+
+3. **启动调试**
+   - 按 `F5` 启动
+   - 宿主会以调试模式启动
+   - 插件代码中的断点会直接命中
+
+⚠️ **注意：** 发布插件前务必移除临时引用！
+
+---
+
+## 📝 日志调试
+
+当断点调试不方便时，日志是最有效的调试手段。
+
+### 使用 ILogger
+
+```csharp
+using Microsoft.Extensions.Logging;
+
+public class MyService
+{
+    private readonly ILogger<MyService> _logger;
+
+    public MyService(ILogger<MyService> logger)
+    {
+        _logger = logger;
+    }
+
+    public void DoWork()
+    {
+        _logger.LogInformation("开始执行任务");
+        
+        try
+        {
+            // 业务逻辑
+            _logger.LogDebug("处理数据: {Data}", data);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "任务执行失败");
+        }
+        
+        _logger.LogInformation("任务完成");
+    }
+}
+```
+
+### 日志级别
+
+| 级别 | 使用场景 |
+|-----|---------|
+| `LogTrace` | 最详细的跟踪信息 |
+| `LogDebug` | 调试信息 |
+| `LogInformation` | 一般信息 |
+| `LogWarning` | 警告信息 |
+| `LogError` | 错误信息 |
+| `LogCritical` | 严重错误 |
+
+### 查看日志文件
+
+日志文件位置：
+
+```
+Windows: %LOCALAPPDATA%\LanMountainDesktop\logs\
+Linux:   ~/.local/share/LanMountainDesktop/logs/
+macOS:   ~/Library/Application Support/LanMountainDesktop/logs/
+```
+
+日志文件命名格式：
+```
+log-20240413.txt
+log-20240413_001.txt
+```
+
+### 实时查看日志
+
+**Windows PowerShell：**
+```powershell
+Get-Content "$env:LOCALAPPDATA\LanMountainDesktop\logs\log-$(Get-Date -Format 'yyyyMMdd').txt" -Wait
+```
+
+**Linux/macOS：**
+```bash
+tail -f ~/.local/share/LanMountainDesktop/logs/log-$(date +%Y%m%d).txt
+```
+
+---
+
+## 🚫 热重载限制
+
+⚠️ **重要：** 阑山桌面插件**不支持**热重载（Hot Reload）
+
+### 原因
+
+插件运行在独立的 `AssemblyLoadContext` 中，.NET 不支持卸载已加载的程序集。因此：
+
+- 修改代码后必须重新构建
+- 必须重启宿主才能加载新版本
+- 无法使用 `dotnet watch`
+
+### 高效开发流程
+
+```
+修改代码 → dotnet build → 重启宿主 → 测试
+```
+
+**加速技巧：**
+
+1. **创建批处理脚本**（`rebuild-and-run.ps1`）：
+   ```powershell
+   dotnet build
+   Stop-Process -Name "LanMountainDesktop" -ErrorAction SilentlyContinue
+   Start-Process "C:\Path\To\LanMountainDesktop.exe"
+   ```
+
+2. **使用 Rider 的外部工具**：
+   - 配置构建后自动复制 `.laapp` 到插件目录
+
+---
+
+## 🐛 常见问题排查
+
+### 问题 1：断点不命中
+
+**可能原因：**
+- 插件未重新构建
+- PDB 符号文件未生成
+- 附加到了错误的进程
+
+**解决步骤：**
+1. 确认已重新构建：`dotnet build`
+2. 检查输出目录是否有 `.pdb` 文件
+3. 确认附加的是 `LanMountainDesktop.exe`（不是 `LanMountainDesktop.dll`）
+4. 尝试清理重建：
+   ```powershell
+   dotnet clean
+   dotnet build
+   ```
+
+### 问题 2：插件不加载
+
+**排查步骤：**
+
+1. **检查日志**
+   ```powershell
+   Get-Content "$env:LOCALAPPDATA\LanMountainDesktop\logs\log-$(Get-Date -Format 'yyyyMMdd').txt" | Select-String "MyPlugin"
+   ```
+
+2. **验证 plugin.json**
+   - JSON 格式是否有效
+   - `id` 是否合法（只含小写字母、数字、点号）
+   - `apiVersion` 是否与 SDK 版本匹配
+
+3. **检查 .laapp 包**
+   - 用压缩软件打开，确认文件完整
+   - 确认 `plugin.json` 和 DLL 存在
+
+### 问题 3：依赖项找不到
+
+**现象：** `FileNotFoundException` 或 `Could not load file or assembly`
+
+**解决：**
+1. 确保所有依赖项都复制到输出目录
+2. 在 `.csproj` 中添加：
+   ```xml
+   <PropertyGroup>
+     <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
+   </PropertyGroup>
+   ```
+
+### 问题 4：调试时宿主卡顿
+
+**原因：** 断点暂停导致 UI 线程阻塞
+
+**解决：**
+- 使用 `Debugger.Break()` 代替断点
+- 或使用日志代替断点调试
+
+---
+
+## 💡 调试技巧
+
+### 1. 条件断点
+
+当需要在特定条件下暂停时使用：
+
+**Visual Studio：**
+- 右键断点 → `条件`
+- 输入条件表达式，如：`count > 10`
+
+### 2. 日志点（Tracepoint）
+
+不暂停程序，只输出日志：
+
+**Visual Studio：**
+- 右键断点 → `操作`
+- 勾选 `将消息输出到输出窗口`
+- 输入消息模板：`变量值: {variableName}`
+
+### 3. 异常设置
+
+自动在抛出异常时中断：
+
+**Visual Studio：**
+- `调试` → `窗口` → `异常设置`
+- 勾选 `Common Language Runtime Exceptions`
+
+### 4. 立即窗口
+
+在调试时执行代码：
+
+**Visual Studio：**
+- 快捷键：`Ctrl+Alt+I`
+- 可查看变量值、调用方法
+
+---
+
+## 📊 性能调试
+
+### 使用 Diagnostic Tools
+
+**Visual Studio：**
+- 调试时自动显示 CPU 和内存使用情况
+- `调试` → `窗口` → `诊断工具`
+
+### 内存泄漏排查
+
+```csharp
+// 在可疑位置添加诊断代码
+GC.Collect();
+GC.WaitForPendingFinalizers();
+GC.Collect();
+var memory = GC.GetTotalMemory(true);
+Debug.WriteLine($"内存使用: {memory / 1024 / 1024} MB");
+```
+
+---
+
+## 🎯 下一步
+
+掌握了调试技巧后，接下来学习核心概念：
+
+👉 **[01-插件生命周期](../02-核心概念与原理/01-插件生命周期.md)** - 理解插件运行机制
+
+或者查看实战案例：
+
+👉 **[01-开发天气组件](../04-实战案例/01-开发天气组件.md)** - 完整开发流程
+
+---
+
+## 📚 参考资源
+
+- [PluginBase 源码](../../LanMountainDesktop.PluginSdk/PluginBase.cs)
+- [docs/DEVELOPMENT.md](../../docs/DEVELOPMENT.md)
+- [Visual Studio 调试文档](https://docs.microsoft.com/visualstudio/debugger/)
+- [Rider 调试文档](https://www.jetbrains.com/help/rider/Debugging.html)
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/02-核心概念与原理/01-插件生命周期.md

@@ -0,0 +1,398 @@
+# 01-插件生命周期
+
+理解插件的生命周期，是开发稳定可靠插件的基础。本文详细讲解插件从加载到卸载的完整过程。
+
+---
+
+## 🔄 生命周期概览
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                     阑山桌面启动                              │
+└───────────────────────┬─────────────────────────────────────┘
+                        │
+                        ▼
+┌─────────────────────────────────────────────────────────────┐
+│  1. 发现插件                                                 │
+│     - 扫描插件目录                                            │
+│     - 解析 plugin.json                                       │
+│     - 验证 API 版本兼容性                                      │
+└───────────────────────┬─────────────────────────────────────┘
+                        │
+                        ▼
+┌─────────────────────────────────────────────────────────────┐
+│  2. 加载插件                                                 │
+│     - 创建 AssemblyLoadContext                             │
+│     - 加载插件 DLL                                           │
+│     - 查找入口类（带 [PluginEntrance] 特性）                   │
+└───────────────────────┬─────────────────────────────────────┘
+                        │
+                        ▼
+┌─────────────────────────────────────────────────────────────┐
+│  3. 初始化（Initialize）                                      │
+│     - 调用 Plugin.Initialize()                               │
+│     - 注册组件、设置页面、服务                                  │
+│     - ⚠️ 此时 UI 尚未完全就绪                                  │
+└───────────────────────┬─────────────────────────────────────┘
+                        │
+                        ▼
+┌─────────────────────────────────────────────────────────────┐
+│  4. 运行中                                                   │
+│     - 组件被添加到桌面                                         │
+│     - 用户与组件交互                                          │
+│     - 设置页面被打开                                          │
+└───────────────────────┬─────────────────────────────────────┘
+                        │
+                        ▼
+┌─────────────────────────────────────────────────────────────┐
+│  5. 停用/卸载                                                │
+│     - 用户禁用插件                                            │
+│     - 或关闭阑山桌面                                          │
+│     - 释放资源（当前版本无显式卸载回调）                          │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 📋 各阶段详解
+
+### 阶段 1：发现插件
+
+**时机：** 阑山桌面启动时
+
+**过程：**
+1. 扫描 `%LOCALAPPDATA%\LanMountainDesktop\plugins\` 目录
+2. 读取每个 `.laapp` 包中的 `plugin.json`
+3. 验证 `apiVersion` 是否与宿主兼容
+4. 检查 `id` 是否唯一
+
+**可能失败的原因：**
+- `plugin.json` 格式错误
+- `apiVersion` 不兼容
+- `id` 与其他插件冲突
+
+---
+
+### 阶段 2：加载插件
+
+**时机：** 发现成功后
+
+**过程：**
+1. 创建独立的 `AssemblyLoadContext`
+2. 加载插件 DLL 及其依赖项
+3. 查找带有 `[PluginEntrance]` 特性的类
+4. 实例化插件入口类
+
+**代码示例：**
+```csharp
+[PluginEntrance]  // ← 这个特性标记入口类
+public sealed class Plugin : PluginBase
+{
+    // 插件实例在此阶段被创建
+}
+```
+
+⚠️ **重要：** 此阶段**不要**执行耗时操作，只应进行简单的字段初始化。
+
+---
+
+### 阶段 3：初始化（Initialize）
+
+**时机：** 插件加载完成后
+
+**这是插件开发中最重要的阶段！**
+
+#### 方法签名
+
+```csharp
+public override void Initialize(
+    HostBuilderContext context,      // 宿主构建上下文
+    IServiceCollection services)     // 服务注册集合
+```
+
+#### 可执行的操作
+
+✅ **可以做的：**
+- 注册桌面组件
+- 注册设置页面
+- 注册服务到依赖注入容器
+- 读取配置
+- 初始化资源
+
+❌ **不应该做的：**
+- 访问 UI 元素（UI 尚未就绪）
+- 执行耗时阻塞操作
+- 创建窗口或对话框
+
+#### 典型初始化代码
+
+```csharp
+public override void Initialize(HostBuilderContext context, IServiceCollection services)
+{
+    // 1. 注册服务
+    services.AddSingleton<IWeatherService, WeatherService>();
+    
+    // 2. 注册桌面组件
+    services.AddPluginDesktopComponent<WeatherWidget>(
+        new PluginDesktopComponentOptions
+        {
+            ComponentId = "MyPlugin.Weather",
+            DisplayName = "天气",
+            IconKey = "Weather",
+            Category = "工具",
+            MinWidthCells = 4,
+            MinHeightCells = 3
+        });
+    
+    // 3. 注册设置页面
+    services.AddPluginSettingsSection(
+        "myplugin-settings",
+        "天气设置",
+        section => section
+            .AddToggle("auto_refresh", "自动刷新", defaultValue: true)
+            .AddNumber("interval", "刷新间隔(分钟)", defaultValue: 30),
+        iconKey: "Settings");
+}
+```
+
+---
+
+### 阶段 4：运行中
+
+**时机：** 初始化完成后，直到插件被禁用或宿主关闭
+
+**特点：**
+- 组件可以被添加到桌面
+- 用户可以与组件交互
+- 设置页面可以被打开
+- 定时器可以运行
+
+#### 组件生命周期
+
+```
+用户添加组件
+     │
+     ▼
+┌─────────────────┐
+│ 创建组件实例     │ ← 调用构造函数
+│ (Dependency     │   注入 IServiceProvider
+│  Injection)     │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│ 组件初始化       │ ← 可在此时加载数据
+│ (Loaded事件)    │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│ 渲染显示        │ ← 用户看到组件
+└────────┬────────┘
+         │
+    ┌────┴────┐
+    ▼         ▼
+ 用户交互   定时更新
+    │         │
+    └────┬────┘
+         │
+         ▼
+┌─────────────────┐
+│ 组件移除        │ ← 用户删除组件
+│ (Unloaded事件)  │   或关闭宿主
+└─────────────────┘
+```
+
+---
+
+### 阶段 5：停用/卸载
+
+**时机：**
+- 用户在设置中禁用插件
+- 卸载插件
+- 关闭阑山桌面
+
+**当前限制：**
+- SDK v4 暂无显式的卸载回调方法
+- 资源释放依赖 .NET 垃圾回收
+- 建议：
+  - 使用 `IDisposable` 模式管理资源
+  - 在组件卸载事件中清理资源
+
+---
+
+## ⏱️ 启动时序图
+
+```
+阑山桌面          插件系统           你的插件
+    │                │                │
+    │── 启动 ───────►│                │
+    │                │                │
+    │                │── 发现插件 ───►│
+    │                │                │ (读取 plugin.json)
+    │                │◄───────────────│
+    │                │                │
+    │                │── 加载 DLL ───►│
+    │                │                │ (AssemblyLoadContext)
+    │                │◄───────────────│
+    │                │                │
+    │                │── 创建实例 ───►│
+    │                │                │ (调用构造函数)
+    │                │◄───────────────│
+    │                │                │
+    │                │── Initialize ─►│
+    │                │                │ (注册组件/服务)
+    │                │◄───────────────│
+    │                │                │
+    │◄───────────────│                │
+    │                │                │
+    │── UI就绪 ─────►│                │
+    │                │                │
+    │                │── 用户添加组件 ─►│
+    │                │                │ (创建组件实例)
+```
+
+---
+
+## 💡 最佳实践
+
+### 1. Initialize 方法保持轻量
+
+```csharp
+// ✅ 好的做法：快速注册
+public override void Initialize(HostBuilderContext context, IServiceCollection services)
+{
+    services.AddSingleton<IDataService, DataService>();
+    services.AddPluginDesktopComponent<MyWidget>(options);
+}
+
+// ❌ 避免：耗时操作
+public override void Initialize(HostBuilderContext context, IServiceCollection services)
+{
+    // 不要这样做！
+    var data = FetchDataFromInternet().Result;  // 阻塞！
+    services.AddSingleton(data);
+}
+```
+
+### 2. 延迟加载数据
+
+```csharp
+public class MyWidget : Border
+{
+    private readonly IDataService _dataService;
+    
+    public MyWidget(PluginDesktopComponentContext context)
+    {
+        _dataService = context.ServiceProvider.GetRequiredService<IDataService>();
+        
+        // 在 Loaded 事件中加载数据，而不是构造函数
+        Loaded += async (_, _) =>
+        {
+            await LoadDataAsync();
+        };
+    }
+    
+    private async Task LoadDataAsync()
+    {
+        var data = await _dataService.GetDataAsync();
+        // 更新 UI
+    }
+}
+```
+
+### 3. 正确处理资源释放
+
+```csharp
+public class MyWidget : Border, IDisposable
+{
+    private readonly Timer _timer;
+    private bool _disposed;
+    
+    public MyWidget()
+    {
+        _timer = new Timer(OnTimerTick, null, TimeSpan.Zero, TimeSpan.FromMinutes(1));
+        
+        // 在卸载时释放资源
+        Unloaded += (_, _) => Dispose();
+    }
+    
+    public void Dispose()
+    {
+        if (_disposed) return;
+        _disposed = true;
+        
+        _timer?.Dispose();
+    }
+}
+```
+
+### 4. 避免循环依赖
+
+```csharp
+// ❌ 避免：服务之间相互依赖
+public class ServiceA
+{
+    public ServiceA(ServiceB b) { }  // 循环依赖风险
+}
+
+public class ServiceB
+{
+    public ServiceB(ServiceA a) { }
+}
+
+// ✅ 好的做法：使用接口解耦
+public class ServiceA
+{
+    public ServiceA(IServiceB b) { }
+}
+```
+
+---
+
+## 🐛 常见问题
+
+### 问题 1：Initialize 中访问 UI 报错
+
+**现象：** `InvalidOperationException` 或空引用
+
+**原因：** Initialize 在 UI 就绪前调用
+
+**解决：** 延迟到组件创建后再访问 UI
+
+### 问题 2：服务注册顺序问题
+
+**现象：** 依赖注入找不到服务
+
+**原因：** 服务注册顺序不正确
+
+**解决：** 先注册服务，再注册依赖这些服务的组件
+
+### 问题 3：插件加载慢
+
+**现象：** 宿主启动变慢
+
+**原因：** Initialize 中执行耗时操作
+
+**解决：** 将耗时操作移到后台线程或延迟执行
+
+---
+
+## 📚 参考资源
+
+- [PluginBase 源码](../../LanMountainDesktop.PluginSdk/PluginBase.cs)
+- [IPlugin 接口](../../LanMountainDesktop.PluginSdk/IPlugin.cs)
+- [02-桌面组件系统](02-桌面组件系统.md)
+- [03-设置系统集成](03-设置系统集成.md)
+
+---
+
+## 🎯 下一步
+
+理解生命周期后，学习如何创建桌面组件：
+
+👉 **[02-桌面组件系统](02-桌面组件系统.md)** - 创建可视化组件
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/02-核心概念与原理/02-桌面组件系统.md

@@ -0,0 +1,393 @@
+# 02-桌面组件系统
+
+桌面组件（Desktop Component）是阑山桌面插件的核心功能。本文详细讲解组件系统的工作原理和开发方法。
+
+---
+
+## 🎯 什么是桌面组件
+
+桌面组件是显示在阑山桌面上的可视化元素，用户可以自由：
+- 添加/删除组件
+- 拖动调整位置
+- 调整大小
+- 配置属性
+
+**常见组件示例：**
+- 时钟组件 - 显示当前时间
+- 天气组件 - 显示天气信息
+- 日历组件 - 显示日期和日程
+- 系统监控 - 显示 CPU/内存使用率
+
+---
+
+## 📐 网格系统
+
+阑山桌面使用网格系统管理组件布局。
+
+### 网格概念
+
+```
+┌─────────────────────────────────────────┐
+│  ┌────┐ ┌────┐ ┌────┐ ┌────┐          │
+│  │ 2x2│ │ 2x2│ │ 2x2│ │ 2x2│          │
+│  │ 格 │ │ 格 │ │ 格 │ │ 格 │          │
+│  └────┘ └────┘ └────┘ └────┘          │
+│  ┌────┐ ┌────────┐ ┌────┐             │
+│  │ 2x2│ │  4x2   │ │ 2x2│             │
+│  │ 格 │ │  格    │ │ 格 │             │
+│  └────┘ └────────┘ └────┘             │
+│  ┌────────┐ ┌────────┐                │
+│  │  4x3   │ │  4x3   │                │
+│  │  格    │ │  格    │                │
+│  └────────┘ └────────┘                │
+└─────────────────────────────────────────┘
+
+每格大小：约 60-80 像素（根据 DPI 自动调整）
+```
+
+### 组件尺寸
+
+组件尺寸以**格数**为单位：
+
+| 属性 | 说明 | 示例 |
+|-----|------|------|
+| `MinWidthCells` | 最小宽度（格数） | 4 = 4格宽 |
+| `MinHeightCells` | 最小高度（格数） | 3 = 3格高 |
+
+**常见尺寸参考：**
+
+| 组件类型 | 推荐尺寸 | 实际像素（约） |
+|---------|---------|--------------|
+| 小图标 | 2x2 | 120x120 |
+| 天气卡片 | 4x3 | 240x180 |
+| 时钟 | 4x4 | 240x240 |
+| 日历 | 6x4 | 360x240 |
+| 宽面板 | 8x3 | 480x180 |
+
+---
+
+## 🏗️ 创建组件
+
+### 步骤 1：创建组件类
+
+组件是继承自 Avalonia 控件的类：
+
+```csharp
+using Avalonia.Controls;
+using LanMountainDesktop.PluginSdk;
+
+namespace MyPlugin;
+
+public class WeatherWidget : Border  // 继承自 Border 或其他控件
+{
+    public WeatherWidget(PluginDesktopComponentContext context)
+    {
+        // 组件初始化
+        InitializeComponent(context);
+    }
+    
+    private void InitializeComponent(PluginDesktopComponentContext context)
+    {
+        // 设置背景
+        Background = new SolidColorBrush(Colors.Transparent);
+        
+        // 设置圆角（使用宿主主题）
+        CornerRadius = context.Appearance.ResolveCornerRadius(
+            PluginCornerRadiusPreset.Component);
+        
+        // 创建内容
+        var textBlock = new TextBlock
+        {
+            Text = "天气组件",
+            HorizontalAlignment = HorizontalAlignment.Center,
+            VerticalAlignment = VerticalAlignment.Center
+        };
+        
+        Child = textBlock;
+    }
+}
+```
+
+### 步骤 2：注册组件
+
+在 `Plugin.Initialize` 中注册：
+
+```csharp
+public override void Initialize(HostBuilderContext context, IServiceCollection services)
+{
+    services.AddPluginDesktopComponent<WeatherWidget>(
+        new PluginDesktopComponentOptions
+        {
+            ComponentId = "MyPlugin.Weather",      // 唯一标识
+            DisplayName = "天气",                   // 显示名称
+            IconKey = "Weather",                    // 图标（Fluent 图标名）
+            Category = "工具",                      // 分类
+            MinWidthCells = 4,                      // 最小宽度（格）
+            MinHeightCells = 3,                     // 最小高度（格）
+            CornerRadiusPreset = PluginCornerRadiusPreset.Component  // 圆角预设
+        });
+}
+```
+
+### PluginDesktopComponentOptions 详解
+
+| 属性 | 必需 | 说明 | 示例 |
+|-----|------|------|------|
+| `ComponentId` | ✅ | 唯一标识符 | `"MyPlugin.Weather"` |
+| `DisplayName` | ✅ | 显示名称 | `"天气"` |
+| `IconKey` | ✅ | 图标键名 | `"Weather"`、`"Clock"` |
+| `Category` | ✅ | 分类 | `"工具"`、`"信息"` |
+| `MinWidthCells` | ✅ | 最小宽度（格） | `4` |
+| `MinHeightCells` | ✅ | 最小高度（格） | `3` |
+| `CornerRadiusPreset` | ❌ | 圆角预设 | `PluginCornerRadiusPreset.Component` |
+| `ResizeMode` | ❌ | 调整大小模式 | `PluginDesktopComponentResizeMode.Free` |
+
+### 常用 Fluent 图标
+
+| 图标键名 | 用途 |
+|---------|------|
+| `Weather` | 天气相关 |
+| `Clock` | 时钟、时间 |
+| `Calendar` | 日历、日期 |
+| `Settings` | 设置 |
+| `Home` | 主页 |
+| `Search` | 搜索 |
+| `Star` | 收藏 |
+| `Heart` | 喜欢 |
+| `Info` | 信息 |
+| `Warning` | 警告 |
+
+完整图标列表：[Fluent UI System Icons](https://github.com/microsoft/fluentui-system-icons)
+
+---
+
+## 🎨 组件外观
+
+### 圆角设置
+
+插件必须使用宿主提供的圆角系统，以保持视觉一致性：
+
+```csharp
+public WeatherWidget(PluginDesktopComponentContext context)
+{
+    // 获取组件标准圆角
+    var cornerRadius = context.Appearance.ResolveCornerRadius(
+        PluginCornerRadiusPreset.Component);
+    
+    CornerRadius = cornerRadius;
+}
+```
+
+**可用的圆角预设：**
+
+| 预设 | 用途 |
+|-----|------|
+| `Micro` | 微小元素 |
+| `Xs` | 小元素 |
+| `Sm` | 小卡片 |
+| `Md` | 普通按钮/卡片 |
+| `Lg` | 大面板 |
+| `Xl` | 强调容器 |
+| `Component` | **桌面组件标准** |
+| `Default` | 自适应 |
+
+### 背景与透明
+
+```csharp
+// 透明背景（推荐，让宿主壁纸透出）
+Background = new SolidColorBrush(Colors.Transparent);
+
+// 毛玻璃效果
+Background = new SolidColorBrush(Color.Parse("#40FFFFFF"));
+
+// 纯色背景
+Background = new SolidColorBrush(Color.Parse("#FF2D2D2D"));
+```
+
+### 响应主题变化
+
+```csharp
+public WeatherWidget(PluginDesktopComponentContext context)
+{
+    // 订阅主题变化
+    context.Appearance.AppearanceChanged += (_, _) =>
+    {
+        UpdateAppearance();
+    };
+    
+    UpdateAppearance();
+}
+
+private void UpdateAppearance()
+{
+    // 根据当前主题更新颜色
+    var isDark = Application.Current?.ActualThemeVariant == ThemeVariant.Dark;
+    
+    Foreground = new SolidColorBrush(isDark ? Colors.White : Colors.Black);
+}
+```
+
+---
+
+## 📏 尺寸与布局
+
+### 获取实际尺寸
+
+```csharp
+public WeatherWidget(PluginDesktopComponentContext context)
+{
+    // 订阅尺寸变化
+    SizeChanged += OnSizeChanged;
+}
+
+private void OnSizeChanged(object? sender, SizeChangedEventArgs e)
+{
+    // 获取当前实际尺寸（像素）
+    var width = Bounds.Width;
+    var height = Bounds.Height;
+    
+    // 根据尺寸调整内容
+    if (width < 200)
+    {
+        // 小尺寸模式
+        ShowCompactView();
+    }
+    else
+    {
+        // 完整模式
+        ShowFullView();
+    }
+}
+```
+
+### 自适应布局
+
+```csharp
+private void UpdateLayout()
+{
+    var width = Bounds.Width;
+    var height = Bounds.Height;
+    
+    // 根据宽高比调整布局
+    if (width > height * 2)
+    {
+        // 宽屏模式 - 水平排列
+        _layout.Orientation = Orientation.Horizontal;
+    }
+    else
+    {
+        // 正常模式 - 垂直排列
+        _layout.Orientation = Orientation.Vertical;
+    }
+}
+```
+
+---
+
+## 🔄 组件生命周期事件
+
+```csharp
+public WeatherWidget(PluginDesktopComponentContext context)
+{
+    // 组件加载完成（此时已添加到视觉树）
+    Loaded += OnLoaded;
+    
+    // 组件卸载（用户删除或关闭宿主）
+    Unloaded += OnUnloaded;
+    
+    // 尺寸变化
+    SizeChanged += OnSizeChanged;
+}
+
+private async void OnLoaded(object? sender, RoutedEventArgs e)
+{
+    // 加载数据
+    await LoadDataAsync();
+    
+    // 启动定时器
+    _timer = new Timer(OnTimerTick, null, TimeSpan.Zero, TimeSpan.FromMinutes(5));
+}
+
+private void OnUnloaded(object? sender, RoutedEventArgs e)
+{
+    // 清理资源
+    _timer?.Dispose();
+    _httpClient?.Dispose();
+}
+```
+
+---
+
+## 💾 组件设置持久化
+
+组件可以保存自己的设置：
+
+```csharp
+public class WeatherWidget : Border
+{
+    private readonly IComponentSettingsAccessor _settings;
+    
+    public WeatherWidget(PluginDesktopComponentContext context)
+    {
+        // 获取设置访问器
+        _settings = context.Settings;
+        
+        // 读取设置
+        var city = _settings.GetValue<string>("city", defaultValue: "北京");
+        var autoRefresh = _settings.GetValue<bool>("auto_refresh", defaultValue: true);
+        
+        // 保存设置
+        _settings.SetValue("city", "上海");
+    }
+}
+```
+
+---
+
+## 🐛 常见问题
+
+### 问题 1：组件不显示在库中
+
+**排查：**
+1. 确认已调用 `AddPluginDesktopComponent`
+2. 检查 `ComponentId` 是否唯一
+3. 确认组件类是 `public`
+
+### 问题 2：组件显示异常
+
+**排查：**
+1. 检查构造函数参数是否正确（需要 `PluginDesktopComponentContext`）
+2. 确认没有抛出未处理异常
+3. 查看日志文件
+
+### 问题 3：圆角不生效
+
+**原因：** 插件无法访问宿主 XAML 资源
+
+**解决：** 使用代码设置圆角（见上文）
+
+### 问题 4：尺寸不正确
+
+**排查：**
+1. 检查 `MinWidthCells` 和 `MinHeightCells` 设置
+2. 确认内容没有强制尺寸
+
+---
+
+## 📚 参考资源
+
+- [PluginDesktopComponentOptions 源码](../../LanMountainDesktop.PluginSdk/PluginDesktopComponentOptions.cs)
+- [04-外观与主题系统](04-外观与主题系统.md)
+- [01-开发天气组件](../04-实战案例/01-开发天气组件.md)
+
+---
+
+## 🎯 下一步
+
+学习如何添加设置页面：
+
+👉 **[03-设置系统集成](03-设置系统集成.md)** - 让用户配置你的组件
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/02-核心概念与原理/03-设置系统集成.md

@@ -0,0 +1,353 @@
+# 03-设置系统集成
+
+设置系统允许插件在阑山桌面的设置窗口中添加自己的配置页面，让用户可以自定义插件行为。
+
+---
+
+## 🎯 设置系统概述
+
+阑山桌面提供两种设置页面模式：
+
+| 模式 | 适用场景 | 复杂度 | 灵活性 |
+|-----|---------|--------|--------|
+| **声明式设置** | 简单的键值配置 | 低 | 中 |
+| **自定义设置页** | 复杂交互、自定义控件 | 中 | 高 |
+
+---
+
+## 📝 声明式设置
+
+通过链式 API 声明配置项，宿主自动生成设置页面。
+
+### 基本用法
+
+```csharp
+public override void Initialize(HostBuilderContext context, IServiceCollection services)
+{
+    services.AddPluginSettingsSection(
+        sectionId: "myplugin-settings",           // 设置节唯一标识
+        displayName: "我的插件设置",               // 显示名称
+        configure: section =>                     // 配置设置项
+        {
+            section
+                .AddToggle("enabled", "启用插件", defaultValue: true)
+                .AddText("api_key", "API密钥", defaultValue: "")
+                .AddNumber("interval", "刷新间隔(秒)", defaultValue: 60, minimum: 10, maximum: 3600)
+                .AddSelect("theme", "主题", new[]
+                {
+                    new SettingsOptionChoice("light", "浅色"),
+                    new SettingsOptionChoice("dark", "深色"),
+                    new SettingsOptionChoice("auto", "跟随系统")
+                }, defaultValue: "auto");
+        },
+        iconKey: "Settings");                      // 图标
+}
+```
+
+### 支持的设置类型
+
+| 方法 | 类型 | 用途 | 示例 |
+|-----|------|------|------|
+| `AddToggle` | 布尔 | 开关选项 | 启用/禁用 |
+| `AddText` | 字符串 | 文本输入 | API密钥、用户名 |
+| `AddNumber` | 数值 | 数字输入 | 刷新间隔、数量 |
+| `AddSelect` | 枚举 | 下拉选择 | 主题、语言 |
+| `AddPath` | 路径 | 文件/文件夹选择 | 保存路径 |
+| `AddList` | 列表 | 字符串列表 | 服务器地址列表 |
+
+### 各类型详解
+
+#### Toggle（开关）
+
+```csharp
+.AddToggle(
+    key: "auto_update",           // 设置键
+    displayName: "自动更新",      // 显示名称
+    defaultValue: true,           // 默认值
+    description: "启动时检查更新"   // 可选描述
+)
+```
+
+#### Text（文本）
+
+```csharp
+.AddText(
+    key: "api_key",
+    displayName: "API密钥",
+    defaultValue: "",
+    placeholder: "请输入API密钥",   // 占位符
+    isPassword: true               // 密码输入（掩码显示）
+)
+```
+
+#### Number（数值）
+
+```csharp
+.AddNumber(
+    key: "refresh_interval",
+    displayName: "刷新间隔",
+    defaultValue: 60,
+    minimum: 10,                  // 最小值
+    maximum: 3600,                // 最大值
+    increment: 10                 // 步进值
+)
+```
+
+#### Select（选择）
+
+```csharp
+.AddSelect(
+    key: "display_mode",
+    displayName: "显示模式",
+    choices: new[]
+    {
+        new SettingsOptionChoice("compact", "紧凑"),
+        new SettingsOptionChoice("normal", "标准"),
+        new SettingsOptionChoice("detailed", "详细")
+    },
+    defaultValue: "normal"
+)
+```
+
+#### Path（路径）
+
+```csharp
+.AddPath(
+    key: "save_location",
+    displayName: "保存位置",
+    defaultValue: "",
+    pathType: SettingsPathType.Folder,  // Folder 或 File
+    dialogTitle: "选择保存文件夹"
+)
+```
+
+---
+
+## 🎨 自定义设置页
+
+当声明式设置无法满足需求时，可以创建自定义设置页面。
+
+### 步骤 1：创建设置页类
+
+```csharp
+using LanMountainDesktop.PluginSdk;
+using FluentAvalonia.UI.Controls;
+
+namespace MyPlugin;
+
+public class MySettingsPage : SettingsPageBase
+{
+    private readonly IPluginSettingsService _settingsService;
+    
+    public MySettingsPage(IPluginSettingsService settingsService)
+    {
+        _settingsService = settingsService;
+        InitializeComponent();
+    }
+    
+    private void InitializeComponent()
+    {
+        // 创建页面内容
+        var panel = new StackPanel { Spacing = 16 };
+        
+        // 添加自定义控件
+        var expander = new SettingsExpander
+        {
+            Header = "高级设置",
+            Description = "配置插件的高级选项"
+        };
+        
+        var toggle = new ToggleSwitch
+        {
+            Content = "启用实验性功能"
+        };
+        
+        expander.Items.Add(toggle);
+        panel.Children.Add(expander);
+        
+        // 添加颜色选择器示例
+        var colorPicker = new ColorPicker
+        {
+            Header = "主题颜色"
+        };
+        panel.Children.Add(colorPicker);
+        
+        Content = panel;
+    }
+}
+```
+
+### 步骤 2：注册自定义设置页
+
+```csharp
+public override void Initialize(HostBuilderContext context, IServiceCollection services)
+{
+    services.AddPluginSettingsSection<MySettingsPage>(
+        sectionId: "myplugin-advanced",
+        displayName: "高级设置",
+        iconKey: "Settings");
+}
+```
+
+### 混合模式
+
+可以同时使用声明式设置和自定义视图：
+
+```csharp
+services.AddPluginSettingsSection(
+    sectionId: "myplugin-settings",
+    displayName: "插件设置",
+    configure: section => section
+        .SetCustomView<MyCustomSettingsPage>()  // 设置自定义视图
+        .AddToggle("enabled", "启用")            // 同时声明设置项
+        .AddText("api_key", "API密钥"),
+    iconKey: "Settings");
+```
+
+---
+
+## 💾 读取和保存设置
+
+### 在服务中读取设置
+
+```csharp
+public class WeatherService
+{
+    private readonly IPluginSettingsService _settings;
+    
+    public WeatherService(IPluginSettingsService settings)
+    {
+        _settings = settings;
+        
+        // 读取设置
+        var apiKey = _settings.GetValue<string>("api_key", "");
+        var autoRefresh = _settings.GetValue<bool>("auto_update", true);
+        var interval = _settings.GetValue<int>("refresh_interval", 60);
+        
+        // 监听设置变化
+        _settings.SettingsChanged += (sender, e) =>
+        {
+            if (e.Key == "refresh_interval")
+            {
+                UpdateTimerInterval(e.NewValue);
+            }
+        };
+    }
+}
+```
+
+### 在组件中读取设置
+
+```csharp
+public class WeatherWidget : Border
+{
+    public WeatherWidget(PluginDesktopComponentContext context)
+    {
+        // 通过 context 获取设置
+        var settings = context.Settings;
+        
+        var city = settings.GetValue<string>("city", "北京");
+        var unit = settings.GetValue<string>("temperature_unit", "celsius");
+        
+        // 监听设置变化
+        context.Settings.SettingsChanged += (_, e) =>
+        {
+            if (e.Key == "city")
+            {
+                RefreshWeather(e.NewValue);
+            }
+        };
+    }
+}
+```
+
+### 保存设置
+
+```csharp
+// 在设置页面中保存
+private void SaveButton_Click(object? sender, RoutedEventArgs e)
+{
+    _settingsService.SetValue("api_key", ApiKeyTextBox.Text);
+    _settingsService.SetValue("auto_update", AutoUpdateToggle.IsChecked ?? false);
+    
+    // 设置会自动持久化，无需手动保存文件
+}
+```
+
+---
+
+## 🔔 设置变更通知
+
+### 订阅变更事件
+
+```csharp
+public class MyService
+{
+    public MyService(IPluginSettingsService settings)
+    {
+        settings.SettingsChanged += OnSettingsChanged;
+    }
+    
+    private void OnSettingsChanged(object? sender, SettingsChangedEvent e)
+    {
+        Console.WriteLine($"设置变更: {e.Key}");
+        Console.WriteLine($"旧值: {e.OldValue}");
+        Console.WriteLine($"新值: {e.NewValue}");
+        
+        // 根据变更的键执行相应操作
+        switch (e.Key)
+        {
+            case "refresh_interval":
+                UpdateRefreshTimer((int)e.NewValue);
+                break;
+            case "theme":
+                ApplyTheme((string)e.NewValue);
+                break;
+        }
+    }
+}
+```
+
+---
+
+## 🐛 常见问题
+
+### 问题 1：设置不保存
+
+**排查：**
+1. 确认 `sectionId` 唯一且合法
+2. 检查设置键名是否正确
+3. 查看日志是否有权限错误
+
+### 问题 2：设置页面不显示
+
+**排查：**
+1. 确认已调用 `AddPluginSettingsSection`
+2. 检查 `sectionId` 是否唯一
+3. 确认设置页类是 `public`
+
+### 问题 3：设置变更通知不触发
+
+**原因：** 可能订阅的是不同实例
+
+**解决：** 确保使用注入的 `IPluginSettingsService`
+
+---
+
+## 📚 参考资源
+
+- [IPluginSettingsService 源码](../../LanMountainDesktop.PluginSdk/IPluginSettingsService.cs)
+- [SettingsPageBase 源码](../../LanMountainDesktop.PluginSdk/SettingsPageBase.cs)
+- [04-开发设置页面](../04-实战案例/04-开发设置页面.md)
+
+---
+
+## 🎯 下一步
+
+学习外观系统：
+
+👉 **[04-外观与主题系统](04-外观与主题系统.md)** - 适配宿主主题
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/02-核心概念与原理/04-外观与主题系统.md

@@ -0,0 +1,308 @@
+# 04-外观与主题系统
+
+阑山桌面支持暗色/浅色主题切换，插件需要适配宿主的视觉风格，保持界面一致性。
+
+---
+
+## 🎨 主题系统概述
+
+阑山桌面使用 Avalonia UI 的主题系统，支持：
+
+- **浅色主题** - 明亮背景，深色文字
+- **深色主题** - 深色背景，浅色文字
+- **跟随系统** - 自动匹配 Windows/macOS 主题
+
+---
+
+## 🌗 检测当前主题
+
+### 在组件中检测
+
+```csharp
+using Avalonia;
+using Avalonia.Styling;
+
+public class MyWidget : Border
+{
+    public MyWidget(PluginDesktopComponentContext context)
+    {
+        // 检测当前主题
+        var isDark = Application.Current?.ActualThemeVariant == ThemeVariant.Dark;
+        
+        // 根据主题设置颜色
+        UpdateTheme(isDark);
+        
+        // 监听主题变化
+        if (Application.Current != null)
+        {
+            Application.Current.ActualThemeVariantChanged += (_, _) =>
+            {
+                var newIsDark = Application.Current.ActualThemeVariant == ThemeVariant.Dark;
+                UpdateTheme(newIsDark);
+            };
+        }
+    }
+    
+    private void UpdateTheme(bool isDark)
+    {
+        Background = new SolidColorBrush(
+            isDark ? Color.Parse("#FF1E1E1E") : Color.Parse("#FFFFFFFF"));
+        
+        Foreground = new SolidColorBrush(
+            isDark ? Colors.White : Colors.Black);
+    }
+}
+```
+
+---
+
+## 📐 圆角系统
+
+插件必须使用宿主提供的圆角系统，确保与内置组件视觉一致。
+
+### 为什么插件不能使用 XAML 资源
+
+插件运行在独立的 `AssemblyLoadContext` 中，无法直接访问宿主的资源字典。因此 `{DynamicResource DesignCornerRadiusComponent}` 在插件 XAML 中无效。
+
+### 使用代码设置圆角
+
+```csharp
+public class MyWidget : Border
+{
+    public MyWidget(PluginDesktopComponentContext context)
+    {
+        // 方法 1：使用预设（推荐）
+        CornerRadius = context.Appearance.ResolveCornerRadius(
+            PluginCornerRadiusPreset.Component);
+        
+        // 方法 2：带最小/最大值限制
+        CornerRadius = context.Appearance.ResolveCornerRadius(
+            PluginCornerRadiusPreset.Component,
+            minimum: new CornerRadius(8),
+            maximum: new CornerRadius(24));
+        
+        // 方法 3：自定义基础值，应用全局缩放
+        CornerRadius = context.Appearance.ResolveScaledCornerRadius(
+            baseRadius: 16,
+            minimum: 8,
+            maximum: 32);
+    }
+}
+```
+
+### 圆角预设
+
+| 预设 | 默认值 | 用途 |
+|-----|-------|------|
+| `Micro` | 6px | 微小元素 |
+| `Xs` | 12px | 小元素、图标容器 |
+| `Sm` | 14px | 小卡片 |
+| `Md` | 20px | 普通按钮/卡片 |
+| `Lg` | 28px | 大面板 |
+| `Xl` | 32px | 强调容器 |
+| `Island` | 36px | 大型容器 |
+| `Component` | 18px | **桌面组件标准** |
+| `Default` | 自适应 | 根据尺寸自动计算 |
+
+### 内部元素圆角
+
+组件内部的卡片、按钮应使用更小的圆角：
+
+```csharp
+// 组件根容器 - 使用 Component 预设
+CornerRadius = context.ResolveCornerRadius(PluginCornerRadiusPreset.Component);
+
+// 内部卡片 - 使用 Md 预设
+var innerCard = new Border
+{
+    CornerRadius = context.ResolveCornerRadius(PluginCornerRadiusPreset.Md),
+    Background = new SolidColorBrush(Colors.LightGray)
+};
+
+// 按钮 - 使用 Sm 预设
+var button = new Button
+{
+    CornerRadius = context.ResolveCornerRadius(PluginCornerRadiusPreset.Sm)
+};
+```
+
+---
+
+## 🎨 颜色系统
+
+### 推荐的颜色策略
+
+```csharp
+// 透明背景（推荐）- 让宿主壁纸透出
+Background = new SolidColorBrush(Colors.Transparent);
+
+// 毛玻璃效果
+Background = new SolidColorBrush(Color.Parse(isDark ? "#40FFFFFF" : "#40000000"));
+
+// 卡片背景
+Background = new SolidColorBrush(Color.Parse(isDark ? "#FF2D2D2D" : "#FFFFFFFF"));
+
+// 强调色（使用系统强调色）
+var accentColor = Color.Parse("#FF0078D4"); // 阑山桌面主色调
+```
+
+### 文字颜色
+
+```csharp
+// 主要文字
+Foreground = new SolidColorBrush(isDark ? Colors.White : Colors.Black);
+
+// 次要文字
+Foreground = new SolidColorBrush(isDark ? Color.Parse("#FFCCCCCC") : Color.Parse("#FF666666"));
+
+// 禁用文字
+Foreground = new SolidColorBrush(isDark ? Color.Parse("#FF666666") : Color.Parse("#FF999999"));
+```
+
+---
+
+## 🔄 响应外观变化
+
+### 订阅外观变化事件
+
+```csharp
+public class MyWidget : Border
+{
+    public MyWidget(PluginDesktopComponentContext context)
+    {
+        // 订阅外观变化
+        context.Appearance.AppearanceChanged += (_, _) =>
+        {
+            UpdateAppearance();
+        };
+        
+        // 初始化
+        UpdateAppearance();
+    }
+    
+    private void UpdateAppearance()
+    {
+        // 重新应用圆角（用户可能调整了全局圆角设置）
+        var context = ...; // 获取 context
+        CornerRadius = context.Appearance.ResolveCornerRadius(
+            PluginCornerRadiusPreset.Component);
+        
+        // 更新主题颜色
+        var isDark = Application.Current?.ActualThemeVariant == ThemeVariant.Dark;
+        UpdateThemeColors(isDark);
+    }
+}
+```
+
+---
+
+## 🧩 使用 FluentAvalonia 控件
+
+推荐使用 FluentAvalonia 控件库，它们自动适配主题：
+
+```xml
+<Window xmlns:ui="using:FluentAvalonia.UI.Controls">
+    <ui:SettingsExpander Header="设置项">
+        <ui:SettingsExpander.IconSource>
+            <ui:FontIconSource Glyph="&#xE713;" />
+        </ui:SettingsExpander.IconSource>
+    </ui:SettingsExpander>
+</Window>
+```
+
+### 常用 FluentAvalonia 控件
+
+| 控件 | 用途 |
+|-----|------|
+| `SettingsExpander` | 设置项展开器 |
+| `SettingsCard` | 设置卡片 |
+| `ColorPicker` | 颜色选择器 |
+| `NumberBox` | 数字输入框 |
+| `ToggleSwitch` | 开关 |
+
+---
+
+## 💡 最佳实践
+
+### 1. 始终使用透明背景
+
+```csharp
+// ✅ 好的做法
+Background = new SolidColorBrush(Colors.Transparent);
+
+// ❌ 避免硬编码背景色
+Background = new SolidColorBrush(Colors.White);
+```
+
+### 2. 组件根容器必须使用 Component 圆角
+
+```csharp
+// ✅ 正确
+CornerRadius = context.ResolveCornerRadius(PluginCornerRadiusPreset.Component);
+
+// ❌ 错误 - 硬编码
+CornerRadius = new CornerRadius(18);
+```
+
+### 3. 响应主题变化
+
+```csharp
+// ✅ 订阅变化事件
+Application.Current.ActualThemeVariantChanged += OnThemeChanged;
+
+// ❌ 只在构造函数中设置一次
+```
+
+### 4. 使用语义化颜色
+
+```csharp
+// ✅ 根据用途选择颜色
+var primaryText = isDark ? Colors.White : Colors.Black;
+var secondaryText = isDark ? Color.Parse("#FFCCCCCC") : Color.Parse("#FF666666");
+
+// ❌ 避免随意使用颜色
+var textColor = Color.Parse("#FF123456");
+```
+
+---
+
+## 🐛 常见问题
+
+### 问题 1：圆角不生效
+
+**原因：** 在 XAML 中使用 `{DynamicResource}`
+
+**解决：** 在代码中设置圆角（见上文）
+
+### 问题 2：主题切换后颜色不对
+
+**原因：** 没有订阅主题变化事件
+
+**解决：** 添加 `ActualThemeVariantChanged` 事件处理
+
+### 问题 3：组件与内置组件风格不一致
+
+**排查：**
+1. 检查圆角是否使用 `PluginCornerRadiusPreset.Component`
+2. 检查背景是否透明
+3. 检查是否使用了 FluentAvalonia 控件
+
+---
+
+## 📚 参考资源
+
+- [CORNER_RADIUS_SPEC.md](../../docs/CORNER_RADIUS_SPEC.md)
+- [VISUAL_SPEC.md](../../docs/VISUAL_SPEC.md)
+- [FluentAvalonia 文档](https://github.com/amwx/FluentAvalonia)
+
+---
+
+## 🎯 下一步
+
+学习插件间通信：
+
+👉 **[05-插件间通信](05-插件间通信.md)** - 与其他插件协作
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/02-核心概念与原理/05-插件间通信.md

@@ -0,0 +1,375 @@
+# 05-插件间通信
+
+插件之间可以通过消息总线和服务导出进行通信，实现功能协作和数据共享。
+
+---
+
+## 🎯 通信方式概述
+
+| 方式 | 适用场景 | 方向 |
+|-----|---------|------|
+| **消息总线** | 事件通知、广播 | 多对多 |
+| **服务导出** | 功能共享、API 暴露 | 一对多 |
+| **共享契约** | 数据交换 | 双向 |
+
+---
+
+## 📢 消息总线
+
+使用 `IPluginMessageBus` 发布和订阅消息。
+
+### 发布消息
+
+```csharp
+public class WeatherService
+{
+    private readonly IPluginMessageBus _messageBus;
+    
+    public WeatherService(IPluginMessageBus messageBus)
+    {
+        _messageBus = messageBus;
+    }
+    
+    public async Task UpdateWeatherAsync()
+    {
+        var weather = await FetchWeatherAsync();
+        
+        // 发布天气更新消息
+        _messageBus.Publish(new WeatherUpdatedMessage
+        {
+            City = weather.City,
+            Temperature = weather.Temperature,
+            Condition = weather.Condition
+        });
+    }
+}
+
+// 定义消息
+public class WeatherUpdatedMessage
+{
+    public string City { get; set; } = "";
+    public double Temperature { get; set; }
+    public string Condition { get; set; } = "";
+}
+```
+
+### 订阅消息
+
+```csharp
+public class AnotherPluginService
+{
+    public AnotherPluginService(IPluginMessageBus messageBus)
+    {
+        // 订阅天气更新消息
+        messageBus.Subscribe<WeatherUpdatedMessage>(OnWeatherUpdated);
+    }
+    
+    private void OnWeatherUpdated(WeatherUpdatedMessage message)
+    {
+        Console.WriteLine($"收到天气更新: {message.City} {message.Temperature}°C");
+        
+        // 根据天气更新自己的状态
+        UpdateDisplay(message);
+    }
+}
+```
+
+### 取消订阅
+
+```csharp
+public class MyService : IDisposable
+{
+    private readonly IPluginMessageBus _messageBus;
+    private readonly Guid _subscriptionId;
+    
+    public MyService(IPluginMessageBus messageBus)
+    {
+        _messageBus = messageBus;
+        _subscriptionId = messageBus.Subscribe<WeatherUpdatedMessage>(OnWeatherUpdated);
+    }
+    
+    public void Dispose()
+    {
+        // 取消订阅，避免内存泄漏
+        _messageBus.Unsubscribe<WeatherUpdatedMessage>(_subscriptionId);
+    }
+}
+```
+
+---
+
+## 🔌 服务导出
+
+插件可以将服务导出，供其他插件使用。
+
+### 导出服务
+
+```csharp
+public override void Initialize(HostBuilderContext context, IServiceCollection services)
+{
+    // 注册服务
+    services.AddSingleton<IWeatherService, WeatherService>();
+    
+    // 导出服务供其他插件使用
+    services.AddPluginServiceExport<IWeatherService>(
+        serviceKey: "MyPlugin.WeatherService",
+        description: "提供天气查询服务");
+}
+
+// 定义服务接口
+public interface IWeatherService
+{
+    Task<WeatherInfo> GetCurrentWeatherAsync(string city);
+    Task<List<WeatherForecast>> GetForecastAsync(string city, int days);
+}
+
+// 实现服务
+public class WeatherService : IWeatherService
+{
+    public async Task<WeatherInfo> GetCurrentWeatherAsync(string city)
+    {
+        // 实现天气查询
+    }
+    
+    public async Task<List<WeatherForecast>> GetForecastAsync(string city, int days)
+    {
+        // 实现天气预报
+    }
+}
+```
+
+### 使用其他插件的服务
+
+```csharp
+public class MyWidget : Border
+{
+    public MyWidget(PluginDesktopComponentContext context)
+    {
+        // 获取其他插件导出的服务
+        var weatherService = context.ServiceProvider
+            .GetExportedService<IWeatherService>("MyPlugin.WeatherService");
+        
+        if (weatherService != null)
+        {
+            // 使用服务
+            LoadWeatherAsync(weatherService);
+        }
+    }
+    
+    private async void LoadWeatherAsync(IWeatherService weatherService)
+    {
+        var weather = await weatherService.GetCurrentWeatherAsync("北京");
+        UpdateUI(weather);
+    }
+}
+```
+
+### 服务导出选项
+
+```csharp
+services.AddPluginServiceExport<IWeatherService>(
+    serviceKey: "MyPlugin.WeatherService",
+    description: "提供天气查询服务",
+    version: "1.0.0",
+    isPublic: true);  // 是否公开给其他插件
+```
+
+---
+
+## 📦 共享契约
+
+通过 `sharedContracts` 在插件间共享类型定义。
+
+### 定义共享契约
+
+```csharp
+// 在共享类库项目中定义
+namespace MyPlugin.Shared;
+
+public interface IWeatherData
+{
+    string City { get; }
+    double Temperature { get; }
+    string Condition { get; }
+}
+
+public class WeatherData : IWeatherData
+{
+    public string City { get; set; } = "";
+    public double Temperature { get; set; }
+    public string Condition { get; set; } = "";
+}
+```
+
+### 在 plugin.json 中声明
+
+```json
+{
+  "id": "com.example.weather",
+  "name": "天气插件",
+  "sharedContracts": [
+    "MyPlugin.Shared.IWeatherData",
+    "MyPlugin.Shared.WeatherData"
+  ]
+}
+```
+
+### 使用共享类型
+
+```csharp
+// 插件 A 发布数据
+public class WeatherService
+{
+    public WeatherData GetWeather()
+    {
+        return new WeatherData
+        {
+            City = "北京",
+            Temperature = 25.5,
+            Condition = "晴"
+        };
+    }
+}
+
+// 插件 B 接收数据
+public class ConsumerService
+{
+    public void ProcessWeather(IWeatherData weather)
+    {
+        Console.WriteLine($"{weather.City}: {weather.Temperature}°C");
+    }
+}
+```
+
+---
+
+## 🔒 安全考虑
+
+### 服务导出安全
+
+```csharp
+// 只导出必要的接口，不暴露实现细节
+public interface IPublicApi
+{
+    Task<Data> GetDataAsync();
+}
+
+internal class InternalService : IPublicApi
+{
+    // 内部实现细节不暴露
+    private readonly SecretKey _key;
+    
+    public async Task<Data> GetDataAsync()
+    {
+        // 实现
+    }
+}
+```
+
+### 消息验证
+
+```csharp
+private void OnMessageReceived(MyMessage message)
+{
+    // 验证消息来源
+    if (message.SenderId != "TrustedPlugin")
+    {
+        return;  // 忽略不信任来源的消息
+    }
+    
+    // 处理消息
+}
+```
+
+---
+
+## 💡 最佳实践
+
+### 1. 使用接口定义服务契约
+
+```csharp
+// ✅ 好的做法 - 定义接口
+public interface IWeatherService { }
+
+// ❌ 避免 - 直接导出实现类
+services.AddPluginServiceExport<WeatherService>(...);
+```
+
+### 2. 处理服务不可用情况
+
+```csharp
+// ✅ 优雅处理服务缺失
+var service = context.ServiceProvider
+    .GetExportedService<IWeatherService>("key");
+
+if (service == null)
+{
+    // 显示提示或降级处理
+    ShowServiceUnavailableMessage();
+    return;
+}
+```
+
+### 3. 及时取消消息订阅
+
+```csharp
+// ✅ 在 Dispose 中取消订阅
+public void Dispose()
+{
+    _messageBus.Unsubscribe<MyMessage>(_subscriptionId);
+}
+```
+
+### 4. 版本兼容性
+
+```csharp
+// 在服务导出中包含版本信息
+services.AddPluginServiceExport<IWeatherService>(
+    serviceKey: "MyPlugin.WeatherService",
+    version: "2.0.0",  // 语义化版本
+    description: "天气服务 v2");
+```
+
+---
+
+## 🐛 常见问题
+
+### 问题 1：消息收不到
+
+**排查：**
+1. 确认消息类型完全一致（包括命名空间）
+2. 检查订阅是否在消息发布之前
+3. 确认没有取消订阅
+
+### 问题 2：服务找不到
+
+**排查：**
+1. 确认服务已导出（`AddPluginServiceExport`）
+2. 检查 `serviceKey` 是否正确
+3. 确认依赖的插件已安装并启用
+
+### 问题 3：类型转换错误
+
+**原因：** 共享契约类型不匹配
+
+**解决：** 确保所有插件使用相同版本的共享契约程序集
+
+---
+
+## 📚 参考资源
+
+- [IPluginMessageBus 源码](../../LanMountainDesktop.PluginSdk/IPluginMessageBus.cs)
+- [IPluginExportRegistry 源码](../../LanMountainDesktop.PluginSdk/IPluginExportRegistry.cs)
+- [Shared.Contracts](../../LanMountainDesktop.Shared.Contracts/)
+
+---
+
+## 🎯 下一步
+
+查看实战案例：
+
+👉 **[01-开发天气组件](../04-实战案例/01-开发天气组件.md)** - 完整插件开发流程
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/03-API实践指南/01-PluginBase详解.md

@@ -0,0 +1,307 @@
+# 01-PluginBase详解
+
+`PluginBase` 是插件的基类，提供基础功能和生命周期管理。本文详细讲解其用法和扩展点。
+
+---
+
+## 🎯 PluginBase 概述
+
+```csharp
+public abstract class PluginBase : IPlugin
+{
+    // 日志记录器
+    protected ILogger? Logger { get; }
+    
+    // 初始化方法（必须实现）
+    public abstract void Initialize(HostBuilderContext context, IServiceCollection services);
+}
+```
+
+---
+
+## 📝 基本用法
+
+### 最小实现
+
+```csharp
+using LanMountainDesktop.PluginSdk;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+
+namespace MyPlugin;
+
+[PluginEntrance]
+public sealed class Plugin : PluginBase
+{
+    public override void Initialize(HostBuilderContext context, IServiceCollection services)
+    {
+        // 插件初始化逻辑
+    }
+}
+```
+
+---
+
+## 🔧 Initialize 方法详解
+
+### 方法签名
+
+```csharp
+public abstract void Initialize(
+    HostBuilderContext context,      // 宿主构建上下文
+    IServiceCollection services      // 服务注册集合
+);
+```
+
+### 参数说明
+
+| 参数 | 类型 | 用途 |
+|-----|------|------|
+| `context` | `HostBuilderContext` | 访问宿主配置、环境信息 |
+| `services` | `IServiceCollection` | 注册服务、组件、设置页面 |
+
+### context 使用示例
+
+```csharp
+public override void Initialize(HostBuilderContext context, IServiceCollection services)
+{
+    // 访问配置
+    var configValue = context.Configuration["MySetting"];
+    
+    // 判断运行环境
+    var isDevelopment = context.HostingEnvironment.IsDevelopment();
+    
+    // 获取应用名称
+    var appName = context.HostingEnvironment.ApplicationName;
+}
+```
+
+---
+
+## 📝 日志记录
+
+### 使用 Logger 属性
+
+```csharp
+[PluginEntrance]
+public sealed class Plugin : PluginBase
+{
+    public override void Initialize(HostBuilderContext context, IServiceCollection services)
+    {
+        // 记录日志
+        Logger?.LogInformation("插件初始化开始");
+        
+        try
+        {
+            // 初始化逻辑
+            services.AddSingleton<IMyService, MyService>();
+            
+            Logger?.LogInformation("插件初始化完成");
+        }
+        catch (Exception ex)
+        {
+            Logger?.LogError(ex, "插件初始化失败");
+            throw;
+        }
+    }
+}
+```
+
+### 日志级别
+
+```csharp
+Logger?.LogTrace("详细跟踪信息");
+Logger?.LogDebug("调试信息");
+Logger?.LogInformation("一般信息");
+Logger?.LogWarning("警告信息");
+Logger?.LogError("错误信息");
+Logger?.LogCritical("严重错误");
+```
+
+---
+
+## 🔌 服务注册
+
+### 注册单例服务
+
+```csharp
+public override void Initialize(HostBuilderContext context, IServiceCollection services)
+{
+    // 单例 - 整个应用生命周期只有一个实例
+    services.AddSingleton<IWeatherService, WeatherService>();
+}
+```
+
+### 注册作用域服务
+
+```csharp
+public override void Initialize(HostBuilderContext context, IServiceCollection services)
+{
+    // 作用域 - 每个作用域一个实例
+    services.AddScoped<IDataContext, DataContext>();
+}
+```
+
+### 注册瞬态服务
+
+```csharp
+public override void Initialize(HostBuilderContext context, IServiceCollection services)
+{
+    // 瞬态 - 每次请求都创建新实例
+    services.AddTransient<IValidator, Validator>();
+}
+```
+
+### 带配置的服务注册
+
+```csharp
+public override void Initialize(HostBuilderContext context, IServiceCollection services)
+{
+    services.AddSingleton<IWeatherService>(provider =>
+    {
+        var httpClient = provider.GetRequiredService<HttpClient>();
+        var logger = provider.GetRequiredService<ILogger<WeatherService>>();
+        var apiKey = context.Configuration["WeatherApiKey"];
+        
+        return new WeatherService(httpClient, logger, apiKey);
+    });
+}
+```
+
+---
+
+## 🧩 完整示例
+
+```csharp
+using LanMountainDesktop.PluginSdk;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+using Microsoft.Extensions.Logging;
+
+namespace WeatherPlugin;
+
+[PluginEntrance]
+public sealed class Plugin : PluginBase
+{
+    public override void Initialize(HostBuilderContext context, IServiceCollection services)
+    {
+        Logger?.LogInformation("天气插件初始化开始");
+        
+        try
+        {
+            // 1. 注册 HTTP 客户端
+            services.AddHttpClient("weather", client =>
+            {
+                client.BaseAddress = new Uri("https://api.weather.com/");
+                client.Timeout = TimeSpan.FromSeconds(30);
+            });
+            
+            // 2. 注册服务
+            services.AddSingleton<IWeatherService, WeatherService>();
+            services.AddSingleton<ILocationService, LocationService>();
+            
+            // 3. 注册桌面组件
+            services.AddPluginDesktopComponent<WeatherWidget>(
+                new PluginDesktopComponentOptions
+                {
+                    ComponentId = "WeatherPlugin.Widget",
+                    DisplayName = "天气",
+                    IconKey = "Weather",
+                    Category = "信息",
+                    MinWidthCells = 4,
+                    MinHeightCells = 3
+                });
+            
+            // 4. 注册设置页面
+            services.AddPluginSettingsSection(
+                "weather-settings",
+                "天气设置",
+                section => section
+                    .AddText("api_key", "API密钥", isPassword: true)
+                    .AddText("default_city", "默认城市", defaultValue: "北京")
+                    .AddToggle("auto_refresh", "自动刷新", defaultValue: true)
+                    .AddNumber("refresh_interval", "刷新间隔(分钟)", 
+                        defaultValue: 30, minimum: 5, maximum: 120),
+                iconKey: "Settings");
+            
+            Logger?.LogInformation("天气插件初始化完成");
+        }
+        catch (Exception ex)
+        {
+            Logger?.LogError(ex, "天气插件初始化失败");
+            throw;
+        }
+    }
+}
+```
+
+---
+
+## 💡 最佳实践
+
+### 1. 使用 try-catch 包装初始化逻辑
+
+```csharp
+public override void Initialize(HostBuilderContext context, IServiceCollection services)
+{
+    try
+    {
+        // 初始化逻辑
+    }
+    catch (Exception ex)
+    {
+        Logger?.LogError(ex, "初始化失败");
+        throw;  // 重新抛出，让宿主知道初始化失败
+    }
+}
+```
+
+### 2. 按依赖顺序注册服务
+
+```csharp
+// ✅ 先注册被依赖的服务
+services.AddSingleton<IDataService, DataService>();
+
+// 再注册依赖它们的服务
+services.AddSingleton<IWeatherService, WeatherService>();  // 依赖 IDataService
+
+// 最后注册组件
+services.AddPluginDesktopComponent<WeatherWidget>(options);
+```
+
+### 3. 记录初始化过程
+
+```csharp
+public override void Initialize(HostBuilderContext context, IServiceCollection services)
+{
+    Logger?.LogInformation("开始初始化...");
+    
+    Logger?.LogDebug("注册服务...");
+    services.AddSingleton<IMyService, MyService>();
+    
+    Logger?.LogDebug("注册组件...");
+    services.AddPluginDesktopComponent<MyWidget>(options);
+    
+    Logger?.LogInformation("初始化完成");
+}
+```
+
+---
+
+## 📚 参考资源
+
+- [PluginBase 源码](../../LanMountainDesktop.PluginSdk/PluginBase.cs)
+- [IPlugin 接口](../../LanMountainDesktop.PluginSdk/IPlugin.cs)
+- [Microsoft.Extensions.DependencyInjection 文档](https://docs.microsoft.com/dotnet/api/microsoft.extensions.dependencyinjection)
+
+---
+
+## 🎯 下一步
+
+学习组件注册 API：
+
+👉 **[02-组件注册与配置](02-组件注册与配置.md)**
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/03-API实践指南/02-组件注册与配置.md

@@ -0,0 +1,182 @@
+# 02-组件注册与配置
+
+`AddPluginDesktopComponent` 是注册桌面组件的核心 API。本文详细讲解其用法和配置选项。
+
+---
+
+## 🎯 API 概览
+
+```csharp
+public static IServiceCollection AddPluginDesktopComponent<TComponent>(
+    this IServiceCollection services,
+    PluginDesktopComponentOptions options)
+    where TComponent : class, IControl
+```
+
+---
+
+## 📋 基本用法
+
+```csharp
+public override void Initialize(HostBuilderContext context, IServiceCollection services)
+{
+    services.AddPluginDesktopComponent<MyWidget>(
+        new PluginDesktopComponentOptions
+        {
+            ComponentId = "MyPlugin.MyWidget",
+            DisplayName = "我的组件",
+            IconKey = "Home",
+            Category = "工具",
+            MinWidthCells = 4,
+            MinHeightCells = 3
+        });
+}
+```
+
+---
+
+## 🔧 PluginDesktopComponentOptions
+
+### 完整属性列表
+
+| 属性 | 类型 | 必需 | 说明 |
+|-----|------|------|------|
+| `ComponentId` | `string` | ✅ | 唯一标识符 |
+| `DisplayName` | `string` | ✅ | 显示名称 |
+| `IconKey` | `string` | ✅ | 图标键名 |
+| `Category` | `string` | ✅ | 分类 |
+| `MinWidthCells` | `int` | ✅ | 最小宽度（格） |
+| `MinHeightCells` | `int` | ✅ | 最小高度（格） |
+| `CornerRadiusPreset` | `PluginCornerRadiusPreset` | ❌ | 圆角预设 |
+| `ResizeMode` | `PluginDesktopComponentResizeMode` | ❌ | 调整大小模式 |
+
+### ComponentId
+
+```csharp
+ComponentId = "MyPlugin.WeatherWidget"
+```
+
+- 必须唯一
+- 建议使用 `插件ID.组件名` 格式
+- 一经发布不可更改
+
+### DisplayName
+
+```csharp
+DisplayName = "天气"
+```
+
+- 显示在组件库中
+- 支持本地化（通过资源文件）
+
+### IconKey
+
+```csharp
+IconKey = "Weather"
+```
+
+使用 [Fluent UI System Icons](https://github.com/microsoft/fluentui-system-icons) 的图标名。
+
+### Category
+
+```csharp
+Category = "工具"
+```
+
+常用分类：
+- `工具` - 实用工具
+- `信息` - 信息展示
+- `娱乐` - 娱乐相关
+- `系统` - 系统监控
+
+### MinWidthCells / MinHeightCells
+
+```csharp
+MinWidthCells = 4,   // 4格宽，约240像素
+MinHeightCells = 3   // 3格高，约180像素
+```
+
+---
+
+## 🎨 圆角配置
+
+```csharp
+services.AddPluginDesktopComponent<MyWidget>(
+    new PluginDesktopComponentOptions
+    {
+        ComponentId = "MyPlugin.Widget",
+        DisplayName = "我的组件",
+        IconKey = "Home",
+        Category = "工具",
+        MinWidthCells = 4,
+        MinHeightCells = 3,
+        CornerRadiusPreset = PluginCornerRadiusPreset.Component
+    });
+```
+
+---
+
+## 📐 调整大小模式
+
+```csharp
+services.AddPluginDesktopComponent<MyWidget>(
+    new PluginDesktopComponentOptions
+    {
+        // ...
+        ResizeMode = PluginDesktopComponentResizeMode.Free
+    });
+```
+
+| 模式 | 说明 |
+|-----|------|
+| `Free` | 自由调整大小 |
+| `Fixed` | 固定大小 |
+| `AspectRatio` | 保持宽高比 |
+
+---
+
+## 🧩 完整示例
+
+```csharp
+public override void Initialize(HostBuilderContext context, IServiceCollection services)
+{
+    // 天气组件
+    services.AddPluginDesktopComponent<WeatherWidget>(
+        new PluginDesktopComponentOptions
+        {
+            ComponentId = "WeatherPlugin.Widget",
+            DisplayName = "天气",
+            IconKey = "Weather",
+            Category = "信息",
+            MinWidthCells = 4,
+            MinHeightCells = 3,
+            CornerRadiusPreset = PluginCornerRadiusPreset.Component,
+            ResizeMode = PluginDesktopComponentResizeMode.Free
+        });
+    
+    // 时钟组件
+    services.AddPluginDesktopComponent<ClockWidget>(
+        new PluginDesktopComponentOptions
+        {
+            ComponentId = "ClockPlugin.Widget",
+            DisplayName = "时钟",
+            IconKey = "Clock",
+            Category = "工具",
+            MinWidthCells = 4,
+            MinHeightCells = 4,
+            CornerRadiusPreset = PluginCornerRadiusPreset.Component,
+            ResizeMode = PluginDesktopComponentResizeMode.AspectRatio
+        });
+}
+```
+
+---
+
+## 📚 参考资源
+
+- [PluginDesktopComponentOptions 源码](../../LanMountainDesktop.PluginSdk/PluginDesktopComponentOptions.cs)
+- [02-桌面组件系统](../02-核心概念与原理/02-桌面组件系统.md)
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/03-API实践指南/03-设置API详解.md

@@ -0,0 +1,147 @@
+# 03-设置API详解
+
+设置 API 允许插件添加配置页面和持久化用户设置。
+
+---
+
+## 🎯 API 概览
+
+### 声明式设置
+
+```csharp
+services.AddPluginSettingsSection(
+    string sectionId,
+    string displayName,
+    Action<PluginSettingsSectionBuilder> configure,
+    string iconKey);
+```
+
+### 自定义设置页
+
+```csharp
+services.AddPluginSettingsSection<TPage>(
+    string sectionId,
+    string displayName,
+    string iconKey)
+    where TPage : SettingsPageBase;
+```
+
+---
+
+## 📋 声明式设置详解
+
+### 基本用法
+
+```csharp
+services.AddPluginSettingsSection(
+    "myplugin-settings",
+    "我的设置",
+    section => section
+        .AddToggle("enabled", "启用", defaultValue: true)
+        .AddText("name", "名称", defaultValue: ""),
+    iconKey: "Settings");
+```
+
+### 设置类型
+
+#### Toggle（开关）
+
+```csharp
+.AddToggle(
+    key: "auto_update",
+    displayName: "自动更新",
+    defaultValue: true,
+    description: "启动时检查更新")
+```
+
+#### Text（文本）
+
+```csharp
+.AddText(
+    key: "api_key",
+    displayName: "API密钥",
+    defaultValue: "",
+    placeholder: "请输入",
+    isPassword: false)
+```
+
+#### Number（数值）
+
+```csharp
+.AddNumber(
+    key: "interval",
+    displayName: "刷新间隔",
+    defaultValue: 60,
+    minimum: 10,
+    maximum: 3600,
+    increment: 10)
+```
+
+#### Select（选择）
+
+```csharp
+.AddSelect(
+    key: "theme",
+    displayName: "主题",
+    choices: new[]
+    {
+        new SettingsOptionChoice("light", "浅色"),
+        new SettingsOptionChoice("dark", "深色")
+    },
+    defaultValue: "light")
+```
+
+#### Path（路径）
+
+```csharp
+.AddPath(
+    key: "save_path",
+    displayName: "保存路径",
+    defaultValue: "",
+    pathType: SettingsPathType.Folder,
+    dialogTitle: "选择文件夹")
+```
+
+---
+
+## 🔧 读取和保存设置
+
+### 使用 IPluginSettingsService
+
+```csharp
+public class MyService
+{
+    private readonly IPluginSettingsService _settings;
+    
+    public MyService(IPluginSettingsService settings)
+    {
+        _settings = settings;
+        
+        // 读取
+        var value = _settings.GetValue<string>("key", "default");
+        
+        // 保存
+        _settings.SetValue("key", "new value");
+        
+        // 监听变化
+        _settings.SettingsChanged += (s, e) =>
+        {
+            if (e.Key == "key")
+            {
+                HandleChange(e.NewValue);
+            }
+        };
+    }
+}
+```
+
+---
+
+## 📚 参考资源
+
+- [IPluginSettingsService 源码](../../LanMountainDesktop.PluginSdk/IPluginSettingsService.cs)
+- [03-设置系统集成](../02-核心概念与原理/03-设置系统集成.md)
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/03-API实践指南/04-外观API详解.md

@@ -0,0 +1,106 @@
+# 04-外观API详解
+
+外观 API 提供圆角、主题等视觉相关的功能。
+
+---
+
+## 🎯 IPluginAppearanceContext
+
+```csharp
+public interface IPluginAppearanceContext
+{
+    // 获取圆角值
+    CornerRadius ResolveCornerRadius(PluginCornerRadiusPreset preset);
+    
+    // 获取带限制的圆角值
+    CornerRadius ResolveCornerRadius(
+        PluginCornerRadiusPreset preset,
+        CornerRadius? minimum,
+        CornerRadius? maximum);
+    
+    // 获取缩放后的圆角值
+    CornerRadius ResolveScaledCornerRadius(
+        double baseRadius,
+        double? minimum,
+        double? maximum);
+    
+    // 外观变化事件
+    event EventHandler? AppearanceChanged;
+}
+```
+
+---
+
+## 📐 圆角 API
+
+### 获取圆角值
+
+```csharp
+public MyWidget(PluginDesktopComponentContext context)
+{
+    // 使用预设
+    CornerRadius = context.Appearance.ResolveCornerRadius(
+        PluginCornerRadiusPreset.Component);
+}
+```
+
+### 带限制的圆角
+
+```csharp
+var radius = context.Appearance.ResolveCornerRadius(
+    PluginCornerRadiusPreset.Component,
+    minimum: new CornerRadius(8),
+    maximum: new CornerRadius(24));
+```
+
+### 缩放圆角
+
+```csharp
+var radius = context.Appearance.ResolveScaledCornerRadius(
+    baseRadius: 16,
+    minimum: 8,
+    maximum: 32);
+```
+
+---
+
+## 🎨 圆角预设
+
+| 预设 | 值 | 用途 |
+|-----|---|------|
+| Micro | 6px | 微小元素 |
+| Xs | 12px | 小元素 |
+| Sm | 14px | 小卡片 |
+| Md | 20px | 普通按钮 |
+| Lg | 28px | 大面板 |
+| Xl | 32px | 强调容器 |
+| Island | 36px | 大型容器 |
+| Component | 18px | 桌面组件 |
+| Default | 自适应 | 自动计算 |
+
+---
+
+## 🔄 响应外观变化
+
+```csharp
+public MyWidget(PluginDesktopComponentContext context)
+{
+    context.Appearance.AppearanceChanged += (_, _) =>
+    {
+        // 重新应用圆角
+        CornerRadius = context.Appearance.ResolveCornerRadius(
+            PluginCornerRadiusPreset.Component);
+    };
+}
+```
+
+---
+
+## 📚 参考资源
+
+- [IPluginAppearanceContext 源码](../../LanMountainDesktop.PluginSdk/IPluginAppearanceContext.cs)
+- [04-外观与主题系统](../02-核心概念与原理/04-外观与主题系统.md)
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/03-API实践指南/05-本地化支持.md

@@ -0,0 +1,73 @@
+# 05-本地化支持
+
+本地化 API 支持多语言资源管理。
+
+---
+
+## 🎯 资源文件
+
+### 文件位置
+
+```
+Localization/
+├── zh-CN.json    # 简体中文
+├── en-US.json    # 英文
+├── ja-JP.json    # 日文
+└── ko-KR.json    # 韩文
+```
+
+### 资源格式
+
+```json
+{
+  "PluginName": "我的插件",
+  "Settings": {
+    "Title": "设置",
+    "Save": "保存"
+  },
+  "Messages": {
+    "Hello": "你好，{0}!",
+    "Error": "错误：{0}"
+  }
+}
+```
+
+---
+
+## 📝 使用本地化
+
+### 注入 IStringLocalizer
+
+```csharp
+public class MyService
+{
+    private readonly IStringLocalizer<MyService> _localizer;
+    
+    public MyService(IStringLocalizer<MyService> localizer)
+    {
+        _localizer = localizer;
+    }
+    
+    public void DoWork()
+    {
+        // 简单字符串
+        var name = _localizer["PluginName"];
+        
+        // 带参数
+        var message = _localizer["Messages.Hello", "用户"];
+        
+        // 嵌套键
+        var title = _localizer["Settings.Title"];
+    }
+}
+```
+
+---
+
+## 📚 参考资源
+
+- [Microsoft.Extensions.Localization 文档](https://docs.microsoft.com/dotnet/api/microsoft.extensions.localization)
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/06-CI-CD与自动化/01-GitHub Actions入门.md

@@ -0,0 +1,215 @@
+# 01-GitHub Actions入门
+
+GitHub Actions 是自动化构建、测试和发布插件的强大工具。本文介绍如何为插件项目配置 CI/CD 流程。
+
+---
+
+## 🎯 什么是 GitHub Actions
+
+GitHub Actions 是 GitHub 提供的持续集成/持续部署（CI/CD）服务，可以：
+
+- ✅ 自动构建插件
+- ✅ 运行单元测试
+- ✅ 打包 .laapp 文件
+- ✅ 自动发布到 GitHub Releases
+
+---
+
+## 📁 工作流文件位置
+
+```
+.github/workflows/
+├── build.yml           # 构建工作流
+├── release.yml         # 发布工作流
+└── code-quality.yml    # 代码质量检查
+```
+
+---
+
+## 🚀 基础工作流示例
+
+### 最简单的构建工作流
+
+```yaml
+# .github/workflows/build.yml
+name: Build Plugin
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  build:
+    runs-on: windows-latest
+    
+    steps:
+      # 1. 检出代码
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      # 2. 设置 .NET
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '10.0.x'
+      
+      # 3. 还原依赖
+      - name: Restore
+        run: dotnet restore
+      
+      # 4. 构建
+      - name: Build
+        run: dotnet build --configuration Release --no-restore
+      
+      # 5. 上传构建产物
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: plugin-package
+          path: bin/Release/net10.0/*.laapp
+```
+
+---
+
+## 📋 工作流详解
+
+### 触发条件（on）
+
+```yaml
+on:
+  # 推送到指定分支时触发
+  push:
+    branches: [main, master, develop]
+    
+  # 创建 Pull Request 时触发
+  pull_request:
+    branches: [main, master]
+    
+  # 手动触发
+  workflow_dispatch:
+    
+  # 定时触发（每天凌晨2点）
+  schedule:
+    - cron: '0 2 * * *'
+    
+  # 创建标签时触发（用于发布）
+  push:
+    tags:
+      - 'v*'
+```
+
+### 运行环境（runs-on）
+
+```yaml
+jobs:
+  build:
+    runs-on: windows-latest    # Windows 环境
+    # 或
+    runs-on: ubuntu-latest     # Linux 环境
+    # 或
+    runs-on: macos-latest      # macOS 环境
+```
+
+### 矩阵构建（多平台）
+
+```yaml
+jobs:
+  build:
+    strategy:
+      matrix:
+        os: [windows-latest, ubuntu-latest, macos-latest]
+        dotnet: ['10.0.x']
+    
+    runs-on: ${{ matrix.os }}
+    
+    steps:
+      - uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{ matrix.dotnet }}
+```
+
+---
+
+## 🔧 常用 Actions
+
+### 检出代码
+
+```yaml
+- uses: actions/checkout@v4
+  with:
+    fetch-depth: 0    # 获取完整历史（用于生成版本号）
+```
+
+### 设置 .NET
+
+```yaml
+- uses: actions/setup-dotnet@v4
+  with:
+    dotnet-version: '10.0.x'
+```
+
+### 上传产物
+
+```yaml
+- uses: actions/upload-artifact@v4
+  with:
+    name: plugin-package
+    path: bin/Release/net10.0/*.laapp
+    retention-days: 30    # 保留30天
+```
+
+### 下载产物
+
+```yaml
+- uses: actions/download-artifact@v4
+  with:
+    name: plugin-package
+    path: ./artifacts
+```
+
+---
+
+## 💡 最佳实践
+
+### 1. 缓存依赖
+
+```yaml
+- uses: actions/cache@v4
+  with:
+    path: ~/.nuget/packages
+    key: ${{ runner.os }}-nuget-${{ hashFiles('**/*.csproj') }}
+    restore-keys: |
+      ${{ runner.os }}-nuget-
+```
+
+### 2. 使用语义化版本
+
+```yaml
+- name: Get Version
+  id: version
+  run: |
+    VERSION=$(echo ${GITHUB_REF#refs/tags/} | sed 's/^v//')
+    echo "VERSION=$VERSION" >> $GITHUB_OUTPUT
+```
+
+### 3. 条件执行
+
+```yaml
+- name: Deploy
+  if: github.ref == 'refs/heads/main'    # 只在 main 分支执行
+  run: echo "Deploying..."
+```
+
+---
+
+## 🎯 下一步
+
+学习自动打包配置：
+
+👉 **[02-配置自动构建](02-配置自动构建.md)**
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/06-CI-CD与自动化/02-配置自动构建.md

@@ -0,0 +1,130 @@
+# 02-配置自动构建
+
+配置 GitHub Actions 自动构建插件项目。
+
+---
+
+## 🎯 完整构建工作流
+
+```yaml
+# .github/workflows/build.yml
+name: Build
+
+on:
+  push:
+    branches: [main, master]
+    paths-ignore:
+      - '**.md'
+      - '.gitignore'
+  pull_request:
+    branches: [main, master]
+
+env:
+  DOTNET_VERSION: '10.0.x'
+  CONFIGURATION: 'Release'
+
+jobs:
+  build:
+    runs-on: windows-latest
+    
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{ env.DOTNET_VERSION }}
+      
+      - name: Cache NuGet
+        uses: actions/cache@v4
+        with:
+          path: ~/.nuget/packages
+          key: ${{ runner.os }}-nuget-${{ hashFiles('**/*.csproj') }}
+          restore-keys: |
+            ${{ runner.os }}-nuget-
+      
+      - name: Restore
+        run: dotnet restore
+      
+      - name: Build
+        run: dotnet build --configuration ${{ env.CONFIGURATION }} --no-restore
+      
+      - name: Test
+        run: dotnet test --no-build --verbosity normal
+      
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: plugin-${{ github.run_number }}
+          path: bin/${{ env.CONFIGURATION }}/net10.0/*.laapp
+```
+
+---
+
+## 🔧 关键配置说明
+
+### 路径过滤
+
+```yaml
+on:
+  push:
+    paths-ignore:
+      - '**.md'        # 忽略文档修改
+      - '.gitignore'   # 忽略 gitignore 修改
+      - 'docs/**'      # 忽略 docs 文件夹
+```
+
+### 环境变量
+
+```yaml
+env:
+  DOTNET_VERSION: '10.0.x'
+  CONFIGURATION: 'Release'
+  PLUGIN_NAME: 'MyPlugin'
+```
+
+### 构建步骤
+
+```yaml
+steps:
+  # 1. 检出
+  - uses: actions/checkout@v4
+  
+  # 2. 设置 .NET
+  - uses: actions/setup-dotnet@v4
+    with:
+      dotnet-version: ${{ env.DOTNET_VERSION }}
+  
+  # 3. 缓存
+  - uses: actions/cache@v4
+    with:
+      path: ~/.nuget/packages
+      key: nuget-${{ hashFiles('**/*.csproj') }}
+  
+  # 4. 还原
+  - run: dotnet restore
+  
+  # 5. 构建
+  - run: dotnet build -c ${{ env.CONFIGURATION }} --no-restore
+  
+  # 6. 测试
+  - run: dotnet test --no-build
+  
+  # 7. 上传
+  - uses: actions/upload-artifact@v4
+    with:
+      name: plugin
+      path: bin/Release/net10.0/*.laapp
+```
+
+---
+
+## 📚 参考资源
+
+- [GitHub Actions 文档](https://docs.github.com/actions)
+- [.NET CI/CD 指南](https://docs.microsoft.com/dotnet/devops/github-actions-overview)
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/06-CI-CD与自动化/03-自动打包与发布.md

@@ -0,0 +1,156 @@
+# 03-自动打包与发布
+
+配置 GitHub Actions 自动打包 .laapp 并发布到 GitHub Releases。
+
+---
+
+## 🎯 发布工作流
+
+```yaml
+# .github/workflows/release.yml
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+env:
+  DOTNET_VERSION: '10.0.x'
+
+jobs:
+  build-and-release:
+    runs-on: windows-latest
+    
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{ env.DOTNET_VERSION }}
+      
+      - name: Get Version
+        id: version
+        run: |
+          $version = $env:GITHUB_REF -replace 'refs/tags/v', ''
+          echo "VERSION=$version" >> $env:GITHUB_OUTPUT
+      
+      - name: Restore
+        run: dotnet restore
+      
+      - name: Build
+        run: dotnet build --configuration Release --no-restore
+      
+      - name: Package
+        run: |
+          $version = "${{ steps.version.outputs.VERSION }}"
+          Rename-Item -Path "bin/Release/net10.0/MyPlugin.laapp" -NewName "MyPlugin-$version.laapp"
+      
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: bin/Release/net10.0/*.laapp
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+
+---
+
+## 📋 发布流程
+
+### 1. 创建标签
+
+```bash
+# 创建版本标签
+git tag -a v1.0.0 -m "Release version 1.0.0"
+
+# 推送标签到 GitHub
+git push origin v1.0.0
+```
+
+### 2. 自动触发
+
+推送标签后，GitHub Actions 会自动：
+1. 检出代码
+2. 构建项目
+3. 打包 .laapp
+4. 创建 Release
+5. 上传产物
+
+### 3. 查看 Release
+
+在 GitHub 仓库页面 → Releases 查看自动创建的发布。
+
+---
+
+## 🔧 高级配置
+
+### 预发布版本
+
+```yaml
+- name: Create Release
+  uses: softprops/action-gh-release@v1
+  with:
+    files: bin/Release/net10.0/*.laapp
+    prerelease: ${{ contains(github.ref, 'beta') || contains(github.ref, 'alpha') }}
+```
+
+### 生成变更日志
+
+```yaml
+- name: Generate Changelog
+  id: changelog
+  uses: mikepenz/release-changelog-builder-action@v4
+  with:
+    configuration: .github/changelog-config.json
+  env:
+    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+- name: Create Release
+  uses: softprops/action-gh-release@v1
+  with:
+    body: ${{ steps.changelog.outputs.changelog }}
+    files: bin/Release/net10.0/*.laapp
+```
+
+---
+
+## 💡 最佳实践
+
+### 版本号管理
+
+```yaml
+- name: Update Version
+  run: |
+    $version = "${{ github.ref_name }}" -replace '^v', ''
+    $json = Get-Content plugin.json | ConvertFrom-Json
+    $json.version = $version
+    $json | ConvertTo-Json | Set-Content plugin.json
+```
+
+### 多文件发布
+
+```yaml
+- name: Create Release
+  uses: softprops/action-gh-release@v1
+  with:
+    files: |
+      bin/Release/net10.0/*.laapp
+      README.md
+      LICENSE
+```
+
+---
+
+## 🎯 下一步
+
+学习多平台构建：
+
+👉 **[04-多平台构建策略](04-多平台构建策略.md)**
+
+---
+
+*最后更新：2026年4月*

docs/Plugins develop/07-发布与运营/01-插件打包规范.md

@@ -0,0 +1,92 @@
+# 01-插件打包规范
+
+了解 .laapp 包的规范和结构，确保插件能正确安装和运行。
+
+---
+
+## 📦 .laapp 文件格式
+
+`.laapp` 是阑山桌面的插件包格式，本质上是一个 **ZIP 压缩包**。
+
+### 文件结构
+
+```
+MyPlugin.laapp
+├── plugin.json              # 插件清单（必需）
+├── MyPlugin.dll             # 主程序集（必需）
+├── Localization/            # 本地化文件夹
+│   ├── zh-CN.json
+│   └── en-US.json
+└── *.dll                    # 依赖项
+```
+
+---
+
+## 📋 plugin.json 规范
+
+### 必需字段
+
+```json
+{
+  "id": "com.example.myplugin",
+  "name": "我的插件",
+  "description": "插件描述",
+  "author": "作者名",
+  "version": "1.0.0",
+  "apiVersion": "4.0.1",
+  "entranceAssembly": "MyPlugin.dll",
+  "sharedContracts": []
+}
+```
+
+### 字段验证规则
+
+| 字段 | 规则 |
+|-----|------|
+| `id` | 小写字母、数字、点号，反向域名格式 |
+| `version` | 语义化版本（x.y.z） |
+| `apiVersion` | 必须与 SDK 版本兼容 |
+| `entranceAssembly` | 必须与 DLL 文件名一致 |
+
+---
+
+## 🔨 构建配置
+
+### .csproj 关键配置
+
+```xml
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+  </PropertyGroup>
+  
+  <ItemGroup>
+    <PackageReference Include="LanMountainDesktop.PluginSdk" Version="4.0.1" />
+  </ItemGroup>
+  
+  <!-- 确保资源文件复制到输出目录 -->
+  <ItemGroup>
+    <None Update="plugin.json">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+    </None>
+    <None Update="Localization\**\*.json">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+    </None>
+  </ItemGroup>
+</Project>
+```
+
+---
+
+## ✅ 打包检查清单
+
+- [ ] `plugin.json` 格式正确
+- [ ] `id` 全局唯一
+- [ ] `apiVersion` 与 SDK 版本匹配
+- [ ] DLL 文件名与 `entranceAssembly` 一致
+- [ ] 所有依赖项已包含
+- [ ] 本地化文件完整
+
+---
+
+*最后更新：2026年4月*