mirror of
https://github.com/wwiinnddyy/LanMountainDesktop.git
synced 2026-06-21 16:14:28 +08:00
0.5.9
中文与插件市场
This commit is contained in:
77
README.md
77
README.md
@@ -1,47 +1,48 @@
|
||||
# LanMountainDesktop
|
||||
# 阑山桌面(LanMountainDesktop)
|
||||
|
||||
> 你的桌面,不止一面。
|
||||
## 中文
|
||||
|
||||
`LanMountainDesktop` 是一个基于 Avalonia 的桌面壳层项目,目标不是“做一个启动器”,而是把桌面变成可编排的信息与交互空间。
|
||||
阑山桌面是一个基于 Avalonia 的桌面壳层项目。它不是单纯的启动器,而是一个可编排、可扩展、可长期演进的桌面信息空间。
|
||||
|
||||
> ⚠️ **注意**:该项目使用 Vibe Coding,介意勿用。
|
||||
## 项目定位
|
||||
- 以网格化布局组织桌面组件,支持多页桌面与组件自由摆放。
|
||||
- 提供顶部状态栏 + 底部任务栏的桌面框架,强调信息密度与可读性平衡。
|
||||
- 通过主题色、日夜模式、玻璃视觉与动画系统,形成统一的视觉语言。
|
||||
- 通过组件注册机制与 JSON 扩展入口,让桌面能力可持续扩展。
|
||||
### 核心目标
|
||||
|
||||
## 核心能力
|
||||
- 桌面组件系统:天气、时钟、计时器、课程表、日历、白板、音乐控制、学习环境等组件可组合使用。
|
||||
- 壁纸系统:支持图片与视频壁纸,并可在设置中实时预览。
|
||||
- 主题系统:支持日夜模式、主题色与调色联动(Monet 风格色板)。
|
||||
- 个性化设置:网格密度、状态栏间距、任务栏布局、语言与时区等可持久化配置。
|
||||
- 本地化:内置 `zh-CN` 与 `en-US` 资源。
|
||||
- 通过网格化布局管理桌面组件。
|
||||
- 提供状态栏、任务栏和多页桌面的统一外壳。
|
||||
- 通过主题、玻璃效果和动效塑造统一体验。
|
||||
- 通过组件系统和插件系统持续扩展能力。
|
||||
|
||||
## 工程结构
|
||||
- `LanMountainDesktop/`:桌面端主程序(Avalonia)。
|
||||
- `LanMountainDesktop.RecommendationBackend/`:推荐内容后端服务(ASP.NET Core Minimal API)。
|
||||
- `docs/`:视觉与圆角等规范文档。
|
||||
- `LanMountainDesktop/ComponentSystem/`:组件定义、注册、放置规则与扩展入口。
|
||||
### 当前工程结构
|
||||
|
||||
## 技术栈
|
||||
- .NET 10(`net10.0`)
|
||||
- Avalonia 11
|
||||
- FluentAvalonia + FluentIcons.Avalonia
|
||||
- LibVLCSharp(用于视频相关能力)
|
||||
- WebView.Avalonia(嵌入式网页组件能力)
|
||||
- `LanMountainDesktop/`:桌面主程序。
|
||||
- `LanMountainDesktop.RecommendationBackend/`:推荐内容后端。
|
||||
- `LanMountainDesktop/ComponentSystem/`:组件定义与注册系统。
|
||||
- `LanMountainDesktop/plugins/`:宿主侧插件加载、安装和设置集成。
|
||||
- `docs/`:视觉与设计规范。
|
||||
- `LanAirApp/`:插件开发资料镜像,权威版本以独立 `LanAirApp` 仓库为准。
|
||||
|
||||
## 扩展机制(摘要)
|
||||
- 组件系统通过 `ComponentRegistry` 合并内置组件与扩展组件。
|
||||
- 运行时会扫描 `Extensions/Components/*.json`(相对应用输出目录)加载第三方组件清单。
|
||||
- 扩展契约与字段说明见组件系统文档:`LanMountainDesktop/ComponentSystem/README.md`。
|
||||
### 生态关系
|
||||
|
||||
## 当前状态
|
||||
- 项目包含桌面端与推荐后端两个子项目,并在同一 solution 中维护。
|
||||
- 通用应用配置默认写入本地:`%LOCALAPPDATA%\LanMountainDesktop\settings.json`。
|
||||
- 启动台与桌面布局已拆分到独立文件:`%LOCALAPPDATA%\LanMountainDesktop\launcher-settings.json`、`%LOCALAPPDATA%\LanMountainDesktop\desktop-layout-settings.json`。
|
||||
- 组件配置统一写入:`%LOCALAPPDATA%\LanMountainDesktop\component-settings.json`;同类组件按实例 `componentId::placementId` 隔离存储,同时预留插件专属配置区。
|
||||
- 当前体验以 Windows 为主要目标平台。
|
||||
- 宿主程序只连接 `LanAirApp` 仓库中的官方市场索引。
|
||||
- 官方市场索引返回插件列表以及各插件项目根目录链接。
|
||||
- 插件项目根目录提供 `.laapp` 安装包和 `README.md`。
|
||||
|
||||
## 运行说明
|
||||
运行与环境准备已拆分到独立文档:[`run.md`](./run.md)
|
||||
### 当前状态
|
||||
|
||||
- Windows 是当前主要目标平台。
|
||||
- 已提供组件系统、插件系统、主题系统和设置系统。
|
||||
- 中文为主语言,英文为附加扩展语言。
|
||||
|
||||
### 运行说明
|
||||
|
||||
运行方法见 [run.md](./run.md)。
|
||||
|
||||
## English
|
||||
|
||||
LanMountainDesktop is an Avalonia-based desktop shell. It is designed as a composable and extensible desktop environment rather than a simple launcher.
|
||||
|
||||
### Main goals
|
||||
|
||||
- manage desktop widgets with a grid-based layout
|
||||
- provide a unified shell with status bar, taskbar, and multi-page desktop support
|
||||
- build a consistent experience through themes, glass effects, and motion
|
||||
- extend capabilities through the component and plugin systems
|
||||
|
||||
Reference in New Issue
Block a user