中文与插件市场
This commit is contained in:
lincube
2026-03-10 12:14:49 +08:00
parent cdffaa16eb
commit 85f7a18cbc
24 changed files with 804 additions and 1443 deletions

View File

@@ -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