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

快速安装

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

安装方式

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

下载安装包

访问 GitHub Releases 页面，下载最新版本的安装包：

• Windows x64: LanMountainDesktop-Setup-{version}-x64.exe

运行安装程序

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

首次启动 (OOBE)

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

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

方式二：便携版

下载便携包

从 GitHub Releases 下载：

• Windows x64: LanMountainDesktop-Portable-{version}-x64.zip

解压并运行

# 解压到目标目录
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/
└── ...

启动选项

正常启动

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

# 或从开始菜单启动

命令行选项

# 显示版本信息
.\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. 主窗口 - 可通过托盘图标打开

检查日志

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

# 打开日志目录
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 状态文件：

   Remove-Item -Path "$env:LOCALAPPDATA\LanMountainDesktop\.launcher\state\oobe-state.json" -Force
   

2. 重新启动应用

组件不显示

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

解决方案:

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

卸载应用

使用控制面板

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

使用卸载程序

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

清理残留数据

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

# 删除用户数据目录
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
2. 下载最新版本的安装包
3. 运行安装包，选择"覆盖安装"
4. 安装完成后启动新版本

更新频道

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

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

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

下一步

• 开发环境配置 - 配置开发环境
• 插件开发快速开始 - 开始开发插件
• 使用教程 - 了解基本使用方法