mirror of
https://github.com/wwiinnddyy/LanMountainDesktop.git
synced 2026-06-20 23:54:26 +08:00
76 lines
3.6 KiB
Markdown
76 lines
3.6 KiB
Markdown
# 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
|
||
```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
|
||
|