中文与插件市场
This commit is contained in:
lincube
2026-03-10 12:14:49 +08:00
parent cdffaa16eb
commit 85f7a18cbc
24 changed files with 804 additions and 1443 deletions

63
run.md
View File

@@ -1,54 +1,55 @@
# LanMountainDesktop 运行指南
# 运行指南
本文档只负责“怎么跑起来”。项目介绍请看 [README.md](./README.md)。
## 中文
## 1. 环境准备
- 安装 .NET SDK 10`net10.0`)。
- 建议使用 Windows 运行桌面端(当前桌面体验以 Windows 为主)。
本文档只说明如何在本地运行阑山桌面。
## 2. 拉取依赖并构建
在仓库根目录执行:
### 环境准备
- 安装 .NET SDK 10。
- 桌面端建议在 Windows 上运行。
### 构建
```bash
dotnet restore
dotnet build LanMountainDesktop.sln -c Debug
```
## 3. 运行桌面端
### 运行桌面端
```bash
dotnet run --project LanMountainDesktop/LanMountainDesktop.csproj
```
## 4. 推荐能力说明
桌面端已内置推荐数据服务(每日诗词 / 每日名画),默认无需额外启动本地推荐后端。
### 常见问题
## 5. 常见问题
- 启动失败提示 SDK 版本不匹配:确认 `dotnet --info` 中已安装 .NET 10 SDK
- 桌面端视频相关能力异常:优先在 Windows 环境下验证
- 配置重置:删除 `%LOCALAPPDATA%\LanMountainDesktop\settings.json` 后重启应用。
- 如果提示 SDK 版本不匹配,先检查 `dotnet --info`
- 如果视频能力异常,优先在 Windows 环境验证
- 如果要重置配置,可删除 `%LOCALAPPDATA%\LanMountainDesktop\settings.json` 后重启
## 6. Linux 音频功能依赖
### Linux 音依赖
如果在 Linux 上使用录音机组件或自习监测组件,需要安装以下音频库:
如果在 Linux 上使用录音机或自习监测相关能力,需要安装音频库:
- Debian/Ubuntu`sudo apt install libportaudio2 libasound2`
- Fedora/RHEL`sudo dnf install portaudio-libs alsa-lib`
- Arch Linux`sudo pacman -S portaudio alsa-lib`
- Alpine Linux`sudo apk add portaudio alsa-lib`
## English
This guide explains how to run LanMountainDesktop locally.
### Build
### Debian/Ubuntu
```bash
sudo apt install libportaudio2 libasound2
dotnet restore
dotnet build LanMountainDesktop.sln -c Debug
```
### Fedora/RHEL
```bash
sudo dnf install portaudio-libs alsa-lib
```
### Run
### Arch Linux
```bash
sudo pacman -S portaudio alsa-lib
dotnet run --project LanMountainDesktop/LanMountainDesktop.csproj
```
### Alpine Linux
```bash
sudo apk add portaudio alsa-lib
```
> 注:如果未安装这些依赖,录音和自习监测功能将不可用,但应用其他功能可以正常运行。