应用遥测,插件市场
This commit is contained in:
lincube
2026-03-16 09:50:48 +08:00
parent 557b79e8c0
commit 6c9f6be1b1
13 changed files with 1321 additions and 105 deletions

View File

@@ -1,49 +1,47 @@
# 阑山桌面LanMountainDesktop
# 阑山桌面 / LanMountainDesktop
## 中文
阑山桌面是一个基于 Avalonia 的桌面壳层项目。它不是单纯的启动器,而是一个可编排、可扩展、可长期演进的桌面信息空间
`LanMontainDesktop` 是阑山桌面的宿主应用权威仓库,负责应用本体、宿主侧插件运行时,以及宿主侧 `PluginSdk` API 基线
### 核心目标
### 本仓库负责什么
- 通过网格化布局管理桌面组件。
- 提供状态栏、任务栏和多页桌面的统一外壳。
- 通过主题、玻璃效果和动效塑造统一体验。
- 通过组件系统和插件系统持续扩展能力。
- `LanMountainDesktop/`:桌面宿主应用
- `LanMountainDesktop.PluginSdk/`:宿主侧插件 API 真源
- `LanMountainDesktop/plugins/`:插件发现、安装、加载、市场接入
- `LanMountainDesktop.Tests/`:宿主与插件运行时测试
- `LanAirApp/`:仅用于联调的镜像副本,权威版本仍以独立 `LanAirApp` 仓库为准
### 当前工程结构
### 生态边界
- `LanMountainDesktop/`:桌面主程序。
- `LanMountainDesktop.RecommendationBackend/`:推荐内容后端。
- `LanMountainDesktop/ComponentSystem/`:组件定义与注册系统。
- `LanMountainDesktop/plugins/`:宿主侧插件加载、安装和设置集成。
- `docs/`:视觉与设计规范。
- `LanAirApp/`:插件开发资料镜像,权威版本以独立 `LanAirApp` 仓库为准。
- 应用本体:`LanMontainDesktop`
- 插件市场与开发资料:独立 `LanAirApp`
- 权威示例插件:独立 `LanMountainDesktop.SamplePlugin`
### 生态关系
### 当前插件 API 基线
- 宿主程序只连接 `LanAirApp` 仓库中的官方市场索引。
- 官方市场索引返回插件列表以及各插件项目根目录链接。
- 插件项目根目录提供 `.laapp` 安装包和 `README.md`
### 当前状态
- Windows 是当前主要目标平台。
- 已提供组件系统、插件系统、主题系统和设置系统。
- 中文为主语言,英文为附加扩展语言。
- 仓库主入口解决方案文件已切换为 `LanMountainDesktop.slnx`SDK 版本由根目录 `global.json` 锁定。
### 运行说明
运行方法见 [run.md](./run.md)。
- 宿主插件 API 基线:`3.0.0`
- `SampleClock` 共享契约:`2.0.0`
## English
LanMountainDesktop is an Avalonia-based desktop shell. It is designed as a composable and extensible desktop environment rather than a simple launcher.
`LanMontainDesktop` is the authoritative host repository for LanMountainDesktop. It owns the desktop application, the host-side plugin runtime, and the host-side `PluginSdk` API baseline.
### Main goals
### What this repository owns
- 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
- `LanMountainDesktop/`: the desktop host application
- `LanMountainDesktop.PluginSdk/`: the canonical host-side plugin API
- `LanMountainDesktop/plugins/`: plugin discovery, installation, loading, and market integration
- `LanMountainDesktop.Tests/`: host and plugin runtime tests
- `LanAirApp/`: a mirror kept for local workspace integration only; the standalone `LanAirApp` repository remains the source of truth
### Ecosystem boundaries
- Application host: `LanMontainDesktop`
- Plugin market and developer-facing materials: standalone `LanAirApp`
- Authoritative sample plugin: standalone `LanMountainDesktop.SamplePlugin`
### Current plugin API baseline
- Host plugin API baseline: `3.0.0`
- `SampleClock` shared contract: `2.0.0`