mirror of
https://github.com/wwiinnddyy/LanMountainDesktop.git
synced 2026-06-23 09:54:25 +08:00
feat.文档更新
This commit is contained in:
lincube
277
docs/00-快速开始/02-快速安装.md
Normal file
277
docs/00-快速开始/02-快速安装.md
Normal file
@@ -0,0 +1,277 @@
|
||||
# 快速安装
|
||||
|
||||
本指南将帮助你快速安装和运行阑山桌面。
|
||||
|
||||
## 安装方式
|
||||
|
||||
### 方式一：使用安装包（推荐）
|
||||
|
||||
#### 下载安装包
|
||||
|
||||
访问 [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) - 了解基本使用方法
|
||||
Reference in New Issue
Block a user