LanMontainDesktop

项目简介 / Project Overview

LanMontainDesktop 是一个基于 Avalonia 的桌面壳层应用原型，聚焦于网格化桌面布局、毛玻璃视觉、主题色系统与可扩展组件体系。
LanMontainDesktop is an Avalonia-based desktop shell prototype focused on grid layout, glass visuals, theme system, and extensible components.

主要功能 / Key Features

• 网格化桌面：顶部状态栏 + 底部任务栏（Dock 风格容器）。
  Grid-based desktop with top status bar and bottom taskbar (dock-like container).
• 设置中心：壁纸、网格、颜色、状态栏、地区（语言）选项。
  Settings center with wallpaper, grid, color, status bar, and region (language) tabs.
• 壁纸系统：支持图片与视频壁纸，并提供设置页预览。
  Wallpaper system supporting image/video wallpapers with in-settings preview.
• 主题系统：日夜模式、主题色、Monet 调色联动。
  Theme system with day/night mode, accent color, and Monet palette integration.
• 组件系统基础：内置组件注册 + 第三方扩展入口（JSON manifest）。
  Component system foundation with built-in registry and third-party JSON extension entry.

技术栈 / Tech Stack

• .NET 10 (net10.0)
• Avalonia 11
• FluentAvalonia + FluentIcons.Avalonia
• LibVLCSharp + VideoLAN.LibVLC.Windows（视频壁纸）

环境要求 / Prerequisites

• .NET SDK 10.0
• Windows（当前项目引用 VideoLAN.LibVLC.Windows，视频能力以 Windows 为主）
  Windows is the primary platform for current video capability due to VideoLAN.LibVLC.Windows.

快速启动 / Quick Start

dotnet restore
dotnet build LanMontainDesktop/LanMontainDesktop.csproj
dotnet run --project LanMontainDesktop/LanMontainDesktop.csproj

配置与持久化 / Configuration & Persistence

应用设置通过 AppSettingsSnapshot 持久化到本地：
App settings are persisted from AppSettingsSnapshot to local storage:

• 路径 / Path: %LOCALAPPDATA%\LanMontainDesktop\settings.json

核心字段（简表）/ Key fields (summary):

• GridShortSideCells: 网格短边格子数 / short-side grid cells
• IsNightMode: 日夜模式 / day-night mode
• ThemeColor: 主题色 / accent color
• WallpaperPath + WallpaperPlacement: 壁纸路径与显示模式 / wallpaper path and placement
• SettingsTabIndex: 设置页当前选项卡 / active settings tab index
• LanguageCode: 语言代码（zh-CN / en-US）
• TopStatusComponentIds: 顶部状态栏组件 ID 列表 / status bar component IDs
• PinnedTaskbarActions: 任务栏固定动作 / pinned taskbar actions

组件扩展入口 / Component Extension Entry

• 运行时会扫描：Extensions/Components/*.json（相对应用输出目录）
  Runtime scan target: Extensions/Components/*.json (relative to app output).
• 扩展加载器：JsonComponentExtensionProvider
• 详细契约与 schema 见：LanMontainDesktop/ComponentSystem/README.md

国际化 / Localization

• 语言资源文件：
  Localization files:
  • LanMontainDesktop/Localization/zh-CN.json
  • LanMontainDesktop/Localization/en-US.json
• 当前支持：简体中文、English

已知限制（快速版）/ Known Limitations

• 视频壁纸能力当前以 Windows 运行环境为主。
  Video wallpaper support is currently Windows-first.
• docs/VISUAL_SPEC.md 存在历史编码问题，本次未纳入修复范围。
  docs/VISUAL_SPEC.md has historical encoding issues and is not updated in this round.

许可证与贡献（占位）/ License & Contributing (Placeholder)

• License: TBD
• Contributing guide: TBD