# 阑山桌面 (LanMountainDesktop) 产品说明文档

**文档版本**: 1.0  
**最后更新**: 2026年3月20日  
**产品版本**: 1.0.0  
**插件 API 基线**: 3.0.0

---

## 一、产品定位

### 1.1 一句话介绍

**阑山桌面是一款可编排的桌面信息与交互空间，让用户能够自由定制个性化桌面，整合信息展示与效率工具于一体。**

### 1.2 核心定位

- **产品类型**: 跨平台桌面环境增强工具
- **技术架构**: 基于 Avalonia UI 的 .NET 跨平台桌面应用
- **支持平台**: Windows、Linux、macOS
- **开发语言**: C# (.NET 10)

---

## 二、目标用户群体

### 2.1 核心用户画像

| 用户群体 | 特征描述 | 核心需求 |
|---------|---------|---------|
| **学生群体** | 大学生、研究生、备考人员 | 课程表管理、自习环境监测、学习计时、每日诗词/单词 |
| **办公用户** | 白领、远程工作者、知识工作者 | 日历日程、天气信息、最近文档、资讯获取 |
| **效率爱好者** | 工具控、桌面美化爱好者 | 高度自定义、插件扩展、个性化布局 |
| **中文用户** | 以中文为母语的用户 | 完整的本地化体验、农历/节假日支持 |

### 2.2 用户场景分析

#### 场景一：学生学习桌面
> 小张是一名大学生，每天需要查看课程表、记录自习时间、查看天气决定穿衣。阑山桌面的课程表组件帮他管理课表，自习监测组件记录学习时长，天气组件提供实时天气信息，让他在学习时无需切换多个应用。

#### 场景二：办公效率桌面
> 李女士是一名产品经理，需要随时查看日程、关注行业资讯、快速访问最近文档。阑山桌面的日历组件展示日程安排，新闻组件聚合央广网/凤凰网资讯，最近文档组件一键打开工作文件，提升工作效率。

#### 场景三：个性化展示桌面
> 小王是一名桌面美化爱好者，喜欢打造独特的桌面环境。阑山桌面提供丰富的组件库和插件系统，支持自定义布局、主题色、壁纸，让他能够打造独一无二的个性化桌面。

---

## 三、使用场景

### 3.1 主要使用场景

| 场景 | 描述 | 核心组件 |
|-----|------|---------|
| **学习辅助** | 课程管理、自习监测、学习计时 | 课程表、自习环境监测、计时器、每日诗词/单词 |
| **信息聚合** | 一站式获取天气、新闻、日历信息 | 天气、新闻、日历、热搜 |
| **效率提升** | 快速访问文档、应用启动、工具使用 | 最近文档、应用启动台、汇率换算、浏览器 |
| **桌面美化** | 个性化桌面布局与视觉呈现 | 时钟、天气、每日名画、主题系统 |
| **音乐控制** | 桌面音乐播放控制 | 音乐控制组件 |

### 3.2 典型使用流程

```
1. 安装阑山桌面 → 2. 选择主题与壁纸 → 3. 添加桌面组件 → 4. 自定义布局
                                    ↓
                    5. 日常使用（查看信息、使用工具）
                                    ↓
                    6. 按需安装插件扩展功能
```

---

## 四、解决方案

### 4.1 产品架构

```
┌─────────────────────────────────────────────────────────────┐
│                      阑山桌面 (LanMountainDesktop)            │
├─────────────────────────────────────────────────────────────┤
│  用户界面层  │  桌面宿主  │  组件系统  │  插件系统  │  设置中心  │
├─────────────────────────────────────────────────────────────┤
│  跨平台运行时 (Avalonia UI + .NET 10)                        │
├─────────────────────────────────────────────────────────────┤
│  Windows  │  Linux  │  macOS                                │
└─────────────────────────────────────────────────────────────┘
```

### 4.2 核心功能模块

#### 4.2.1 桌面组件系统
阑山桌面提供丰富的内置组件，涵盖多个类别：

| 类别 | 组件列表 |
|-----|---------|
| **时钟类** | 桌面时钟、世界时钟、天气时钟、模拟时钟 |
| **天气类** | 天气组件、小时天气、多日天气、扩展天气 |
| **日历类** | 月历、农历、节假日日历 |
| **信息类** | 每日诗词、每日名画、每日单词、央广网新闻、凤凰网新闻、B站热搜、百度热搜 |
| **学习类** | 课程表、自习环境监测、录音、自习时段控制、历史数据 |
| **工具类** | 计时器、汇率换算、浏览器、最近文档、可移动存储、音乐控制 |
| **白板类** | 竖向小黑板、横向小黑板 |

#### 4.2.2 插件扩展系统
- **插件 API 基线**: 3.0.0
- **插件格式**: `.laapp` 插件包
- **插件市场**: 官方插件市场 (LanAirApp)
- **开发支持**: 完整的 PluginSdk 和开发文档

#### 4.2.3 主题与个性化
- **主题系统**: 支持日夜模式切换
- **主题色**: 支持 Monet 取色和自定义主题色
- **玻璃效果**: 多层级玻璃视觉效果
- **壁纸系统**: 支持图片壁纸和动态效果

#### 4.2.4 布局系统
- **网格化布局**: 支持多页桌面
- **自由拖拽**: 组件可自由摆放
- **尺寸自适应**: 组件支持多种尺寸规格

### 4.3 技术亮点

| 特性 | 说明 |
|-----|------|
| **跨平台** | 基于 Avalonia UI，支持 Windows/Linux/macOS |
| **现代化 UI** | Fluent Design + Material Design 融合 |
| **插件化架构** | 支持第三方插件扩展，API 基线 3.0.0 |
| **数据安全** | 本地 SQLite 存储，隐私数据不上传 |
| **性能优化** | 组件懒加载、资源按需加载 |
| **无障碍支持** | 对比度优化、语义化界面 |

---

## 五、解决的问题

### 5.1 用户痛点

| 痛点 | 阑山桌面解决方案 |
|-----|----------------|
| **信息分散** | 整合天气、日历、新闻等信息于桌面 |
| **桌面单调** | 丰富的组件和主题让桌面个性化 |
| **效率低下** | 常用工具和信息一触即达 |
| **学习管理难** | 课程表、自习监测专为学生设计 |
| **功能不足** | 插件系统支持无限扩展 |

### 5.2 竞品差异化

| 对比维度 | 传统桌面工具 | 阑山桌面 |
|---------|-------------|---------|
| **组件丰富度** | 有限组件 | 20+ 内置组件 + 插件扩展 |
| **定制化** | 固定布局 | 自由拖拽、网格化布局 |
| **跨平台** | 单一平台 | Windows/Linux/macOS |
| **插件生态** | 不支持 | 完整插件 SDK 和市场 |
| **本地化** | 一般 | 完整中文本地化 |

---

## 六、用户量与数据统计

### 6.1 数据收集说明

根据隐私政策，阑山桌面收集以下匿名数据用于统计：

- ✅ **应用启动事件**: 用于统计日活跃用户
- ✅ **设备标识符**: 匿名生成，用于区分用户（不含个人信息）
- ✅ **应用版本**: 用于统计版本分布
- ✅ **崩溃报告**: 用于提升应用稳定性（可选）
- ✅ **使用统计**: 用于功能优化（可选）

### 6.2 隐私承诺

- ❌ 不收集个人身份信息（姓名、邮箱、电话等）
- ❌ 不收集地理位置
- ❌ 不收集文件内容
- ❌ 不出售用户数据
- ❌ 不用于广告目的

### 6.3 当前状态

**当前版本**: 1.0.0  
**插件 API 基线**: 3.0.0  
**数据收集服务**: PostHog（用户分析）、Sentry（崩溃报告）

> **注**: 具体用户量数据需从 PostHog 后台获取，此处未展示具体数字。

---

## 七、产品开发进度

### 7.1 当前开发状态

| 模块 | 状态 | 说明 |
|-----|------|------|
| **核心桌面功能** | ✅ 已完成 | 网格布局、组件系统、主题系统 |
| **内置组件** | ✅ 已完成 | 20+ 组件已上线 |
| **插件系统** | ✅ 已完成 | API 3.0.0 已稳定 |
| **插件市场** | ✅ 已完成 | 官方市场已运营 |
| **多平台支持** | ✅ 已完成 | Windows/Linux/macOS |
| **自动更新** | ✅ 已完成 | 内置更新系统 |
| **应用启动台** | ✅ 已完成 | Windows 开始菜单集成 |

### 7.2 版本里程碑

| 版本 | 目标 | 状态 |
|-----|------|------|
| v1.0.0 | 核心功能完整、插件系统稳定 | ✅ 已发布 |
| v1.x.x | 组件扩展、性能优化 | 🔄 进行中 |
| v2.0.0 | 重大功能升级（规划中） | 📋 规划中 |

### 7.3 近期开发计划

根据 `.trae/specs` 中的规格文档，近期开发任务包括：

1. **设置页面 Fluent 重设计** - 提升设置界面体验
2. **课程表功能增强** - 增加更多课程管理功能
3. **视频壁纸功能移除** - 优化产品定位

### 7.4 生态建设

| 项目 | 状态 | 说明 |
|-----|------|------|
| **LanMountainDesktop** | ✅ 主仓库 | 桌面宿主、插件运行时 |
| **LanAirApp** | ✅ 独立仓库 | 插件市场、开发文档 |
| **SamplePlugin** | ✅ 独立仓库 | 权威示例插件 |
| **PluginSdk** | ✅ 已发布 | 插件开发 SDK |

---

## 八、产品优势总结

### 8.1 核心价值

1. **个性化桌面**: 自由定制组件布局，打造专属桌面空间
2. **信息聚合**: 一站式获取天气、日历、新闻等实用信息
3. **效率提升**: 常用工具触手可及，减少应用切换
4. **学习辅助**: 专为学生群体设计的课程表、自习监测功能
5. **无限扩展**: 插件系统支持功能无限扩展

### 8.2 技术保障

- 跨平台架构，一次开发多端运行
- 现代化 UI 框架，流畅的用户体验
- 严格的隐私保护，数据安全有保障
- 完善的插件生态，功能持续扩展

---

## 九、联系我们

- **GitHub**: https://github.com/wwiinnddyy/LanMountainDesktop
- **Issues**: https://github.com/wwiinnddyy/LanMountainDesktop/issues
- **插件市场**: LanAirApp 官方市场

---

**阑山桌面，让你的桌面更有温度。**