0.3.4

README.md

@@ -1,75 +1,44 @@
 # 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.
+`LanMontainDesktop` 是一个基于 Avalonia 的桌面壳层项目，目标不是“做一个启动器”，而是把桌面变成可编排的信息与交互空间。
 
-## 技术栈 / Tech Stack
-- .NET 10 (`net10.0`)
+## 项目定位
+- 以网格化布局组织桌面组件，支持多页桌面与组件自由摆放。
+- 提供顶部状态栏 + 底部任务栏的桌面框架，强调信息密度与可读性平衡。
+- 通过主题色、日夜模式、玻璃视觉与动画系统，形成统一的视觉语言。
+- 通过组件注册机制与 JSON 扩展入口，让桌面能力可持续扩展。
+
+## 核心能力
+- 桌面组件系统：天气、时钟、计时器、课程表、日历、白板、音乐控制、学习环境等组件可组合使用。
+- 壁纸系统：支持图片与视频壁纸，并可在设置中实时预览。
+- 主题系统：支持日夜模式、主题色与调色联动（Monet 风格色板）。
+- 个性化设置：网格密度、状态栏间距、任务栏布局、语言与时区等可持久化配置。
+- 本地化：内置 `zh-CN` 与 `en-US` 资源。
+
+## 工程结构
+- `LanMontainDesktop/`：桌面端主程序（Avalonia）。
+- `LanMontainDesktop.RecommendationBackend/`：推荐内容后端服务（ASP.NET Core Minimal API）。
+- `docs/`：视觉与圆角等规范文档。
+- `LanMontainDesktop/ComponentSystem/`：组件定义、注册、放置规则与扩展入口。
+
+## 技术栈
+- .NET 10（`net10.0`）
 - Avalonia 11
 - FluentAvalonia + FluentIcons.Avalonia
-- LibVLCSharp + VideoLAN.LibVLC.Windows（视频壁纸）
+- LibVLCSharp（用于视频相关能力）
+- WebView.Avalonia（嵌入式网页组件能力）
 
-## 环境要求 / Prerequisites
-- .NET SDK `10.0`
-- Windows（当前项目引用 `VideoLAN.LibVLC.Windows`，视频能力以 Windows 为主）  
-  Windows is the primary platform for current video capability due to `VideoLAN.LibVLC.Windows`.
+## 扩展机制（摘要）
+- 组件系统通过 `ComponentRegistry` 合并内置组件与扩展组件。
+- 运行时会扫描 `Extensions/Components/*.json`（相对应用输出目录）加载第三方组件清单。
+- 扩展契约与字段说明见组件系统文档：`LanMontainDesktop/ComponentSystem/README.md`。
 
-## 快速启动 / Quick Start
-```bash
-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
+## 当前状态
+- 项目包含桌面端与推荐后端两个子项目，并在同一 solution 中维护。
+- 配置默认写入本地：`%LOCALAPPDATA%\LanMontainDesktop\settings.json`。
+- 当前体验以 Windows 为主要目标平台。
 
+## 运行说明
+运行与环境准备已拆分到独立文档：[`run.md`](./run.md)