LanMountainDesktop/docs/00-快速开始/02-快速安装.md

# 快速安装

本指南将帮助你快速安装和运行阑山桌面。

## 安装方式

### 方式一：使用安装包（推荐）

#### 下载安装包

访问 [GitHub Releases](https://github.com/HelloWRC/LanMountainDesktop/releases) 页面，下载最新版本的安装包：

- **Windows x64**: `LanMountainDesktop-Setup-{version}-x64.exe`

#### 运行安装程序

1. 双击下载的安装包
2. 按照安装向导提示完成安装
3. 安装完成后，启动器会自动运行

#### 首次启动 (OOBE)

首次启动时会显示欢迎页面：

1. **欢迎页** - 项目介绍和基本说明
2. **权限确认** - 了解应用所需的权限
3. **基础设置** - 选择主题、语言等
4. **完成** - 开始使用阑山桌面

### 方式二：便携版

#### 下载便携包

从 [GitHub Releases](https://github.com/HelloWRC/LanMountainDesktop/releases) 下载：

- **Windows x64**: `LanMountainDesktop-Portable-{version}-x64.zip`

#### 解压并运行

```powershell
# 解压到目标目录
Expand-Archive -Path LanMountainDesktop-Portable-1.0.0-x64.zip -DestinationPath C:\LanMountainDesktop

# 进入目录
cd C:\LanMountainDesktop

# 启动应用
.\LanMountainDesktop.Launcher.exe
```

#### 便携版特点

- ✅ 无需安装，解压即用
- ✅ 数据存储在程序目录
- ✅ 适合 U 盘或多机器同步使用
- ⚠️ 需要手动创建快捷方式
- ⚠️ 不会自动添加到开始菜单

## 目录结构

### 安装版目录结构

```
安装根目录/
├── LanMountainDesktop.Launcher.exe    # 启动器（唯一入口）
├── app-1.0.0/                          # 版本目录
│   ├── .current                        # 当前版本标记
│   ├── LanMountainDesktop.exe          # 主程序
│   ├── *.dll                           # 依赖库
│   └── ...
├── LanMountainDesktop.AirAppRuntime.exe # Air APP 运行时
├── .Launcher/                          # 启动器数据
│   ├── state/                          # OOBE 状态
│   └── update/                         # 更新缓存
└── unins000.exe                        # 卸载程序
```

### 用户数据目录

```
%LOCALAPPDATA%\LanMountainDesktop\
├── settings/                           # 设置文件
├── plugins/                            # 已安装插件
├── logs/                               # 日志文件
├── cache/                              # 缓存数据
└── telemetry/                          # 遥测数据（可选）
```

### 便携版目录结构

便携版的用户数据存储在程序目录的 `Data/` 文件夹下：

```
LanMountainDesktop/
├── LanMountainDesktop.Launcher.exe
├── app-1.0.0/
├── Data/                               # 便携数据目录
│   ├── settings/
│   ├── plugins/
│   ├── logs/
│   └── cache/
└── ...
```

## 启动选项

### 正常启动

```powershell
# 双击启动器
.\LanMountainDesktop.Launcher.exe

# 或从开始菜单启动
```

### 命令行选项

```powershell
# 显示版本信息
.\LanMountainDesktop.Launcher.exe --version

# 显示帮助信息
.\LanMountainDesktop.Launcher.exe --help

# 重置 OOBE 状态（重新显示欢迎页）
.\LanMountainDesktop.Launcher.exe --reset-oobe

# 启动到指定版本
.\LanMountainDesktop.Launcher.exe --version 1.0.0

# 安装插件（本地维护命令）
.\LanMountainDesktop.Launcher.exe plugin install path\to\plugin.laapp

# 应用插件更新队列（本地维护命令）
.\LanMountainDesktop.Launcher.exe plugin update
```

## 验证安装

### 检查应用状态

启动后，你应该看到：

1. **桌面组件** - 默认的时钟或其他组件显示在桌面上
2. **系统托盘图标** - 阑山桌面的托盘图标
3. **主窗口** - 可通过托盘图标打开

### 检查日志

如果遇到问题，可以查看日志：

```powershell
# 打开日志目录
explorer %LOCALAPPDATA%\LanMountainDesktop\logs

# 查看最新日志
Get-Content %LOCALAPPDATA%\LanMountainDesktop\logs\latest.log -Tail 50
```

### 检查版本信息

1. 右键点击托盘图标
2. 选择"关于"或"设置"
3. 查看版本号和构建信息

## 常见问题

### 安装失败

**问题**: 安装程序报错或无法完成安装

**解决方案**:
1. 确认 Windows 版本 ≥ Windows 10 1809
2. 以管理员身份运行安装程序
3. 关闭杀毒软件和防火墙
4. 检查磁盘空间是否充足（≥ 500MB）
5. 查看安装日志：`%TEMP%\LanMountainDesktop-Setup.log`

### 启动失败

**问题**: 双击启动器没有反应

**解决方案**:
1. 检查进程管理器是否已有实例运行
2. 查看日志文件：`%LOCALAPPDATA%\LanMountainDesktop\logs\latest.log`
3. 尝试以管理员身份运行
4. 检查是否有其他应用占用端口或资源

### OOBE 无法显示

**问题**: 首次启动没有显示欢迎页面

**解决方案**:
1. 删除 OOBE 状态文件：
   ```powershell
   Remove-Item -Path "$env:LOCALAPPDATA\LanMountainDesktop\.launcher\state\oobe-state.json" -Force
   ```
2. 重新启动应用

### 组件不显示

**问题**: 桌面上看不到任何组件

**解决方案**:
1. 右键点击桌面空白处
2. 选择"添加组件"
3. 选择一个组件添加到桌面
4. 检查组件是否被其他窗口遮挡
5. 确认桌面图层设置正确（设置 → 桌面 → 图层模式）

## 卸载应用

### 使用控制面板

1. 打开"设置" → "应用" → "已安装的应用"
2. 找到"LanMountainDesktop"
3. 点击"卸载"按钮
4. 按照向导完成卸载

### 使用卸载程序

```powershell
# 运行卸载程序
.\unins000.exe
```

### 清理残留数据

卸载后，用户数据不会自动删除。如需彻底清理：

```powershell
# 删除用户数据目录
Remove-Item -Path "$env:LOCALAPPDATA\LanMountainDesktop" -Recurse -Force

# 删除 Launcher 状态
Remove-Item -Path "$env:LOCALAPPDATA\LanMountainDesktop\.launcher" -Recurse -Force

# 删除缓存（如果存在）
Remove-Item -Path "$env:TEMP\LanMountainDesktop" -Recurse -Force -ErrorAction SilentlyContinue
```

## 更新应用

### 自动更新（推荐）

阑山桌面支持自动更新：

1. 应用会在后台检查更新
2. 发现新版本时会提示下载
3. 下载完成后重启应用自动安装
4. 支持增量更新，只下载变更文件

### 手动更新

如果需要手动更新：

1. 访问 [GitHub Releases](https://github.com/HelloWRC/LanMountainDesktop/releases)
2. 下载最新版本的安装包
3. 运行安装包，选择"覆盖安装"
4. 安装完成后启动新版本

### 更新频道

可以在设置中切换更新频道：

- **Stable（稳定版）**: 只接收正式发布的版本
- **Preview（预览版）**: 接收所有版本，包括预发布版本

```
设置 → 更新 → 更新频道 → 选择频道
```

## 下一步

- [开发环境配置](03-开发环境配置.md) - 配置开发环境
- [插件开发快速开始](../01-插件开发/01-快速开始/01-环境准备.md) - 开始开发插件
- [使用教程](04-基础使用.md) - 了解基本使用方法