安装
本指南说明如何安装 LWE，以及首次启动前需要准备什么。
使用前提
LWE 使用 Steam 创意工坊中的 Wallpaper Engine 内容。使用创意工坊相关功能前，请确认：
- 你的 Steam 账号拥有 Wallpaper Engine；
- Linux 桌面上已安装 Steam 客户端并已登录；
- Steam 中已安装 Wallpaper Engine；
- 当前桌面会话支持你要测试的运行路径。
目前已验证的桌面环境是 Wayland 会话配合 niri。其他合成器或桌面环境可能可用，但在完成验证前应视为未验证环境。
尚未安装 Steam 或下载壁纸时也可以打开 LWE。首次启动时内容库为空属于正常状态：请在 Steam 订阅 Wallpaper Engine 创意工坊项目，等待 Steam 下载完成后刷新内容库。在 X11 或没有 niri 的环境中仍可浏览内容库和创意工坊，壁纸播放需要受支持的桌面会话。
Arch Linux AUR
项目发布两个 AUR 包：
| 包名 | 渠道 | 适用场景 |
|---|---|---|
lwe | 稳定版 | 需要最新稳定版本。 |
lwe-git | 预发布/开发版 | 需要来自活跃开发分支的更新构建。 |
可使用 yay 等 AUR 助手安装稳定版：
yay -S lwe如果你明确需要预发布变更，可安装开发版：
yay -S lwe-gitGitHub Releases
稳定版和预发布版本会通过 GitHub Actions 发布 Linux 安装包。请在仓库 Releases 页面下载适合你发行版的包。
发布的构建产物包括：
.deb.rpm.AppImage
.deb 或 .rpm 文件请使用发行版常规包管理工具安装。AppImage 构建需要先添加可执行权限再启动。
chmod +x lwe_*.AppImage
./lwe_*.AppImage从源码构建
当你需要贡献代码或验证本地改动时，请使用该路径。
需要的工具：
- Node.js 24，与 CI 一致
- pnpm 11.1.3，由
package.json固定 - Rust 1.99.0，由
rust-toolchain.toml选择 - 当前发行版所需的 Tauri 2 构建依赖
最低支持的 Rust 版本另行声明在 Cargo.toml 中。桌面构建使用 .tauri-cli-version 指定的精确 Cargo Tauri CLI，共享安装脚本会核验或安装该版本。
安装 JavaScript 依赖：
pnpm install --frozen-lockfile
pnpm exec svelte-kit sync
./scripts/ensure-tauri-cli.sh
export PATH="$PWD/target/tauri-cli/bin:$PATH"运行前端检查：
pnpm check
pnpm test运行 Rust 检查：
cargo check --workspace使用 pnpm tauri:dev 启动本地桌面开发。活跃桌面应用路径是 src-tauri，前端位于 src；单独运行 pnpm dev 只会启动前端。包构建和验收检查见贡献指南。
安装后
继续阅读快速开始，配置 Steam Web API 密钥并应用第一张壁纸。