Lap 是一个注重隐私的本地照片管理器，部署方式很灵活：普通用户可以直接下载安装包，开发者则可以从源码构建。

💻 方案一：安装预编译版本（推荐普通用户）

这是最快捷的方式。根据你的操作系统，在 Lap 的 Releases 页面 下载对应的文件即可。

平台 架构 包类型 备注
macOS Apple Silicon / Intel .dmg 已通过 Apple 公证，可直接安装
Windows x64 / ARM64 .msi 未签名，若被 SmartScreen 拦截，点击“仍要保留”即可
Linux x64 / ARM64 .deb / .AppImage .deb 适用于 Debian/Ubuntu 系；.AppImage 需赋予执行权限后运行

macOS 用户额外选择：如果安装了 Homebrew，可以使用以下命令安装：

1
2
brew tap julyx10/lap
brew install --cask lap

🛠️ 方案二：从源码构建（面向开发者）

如果你想体验最新特性或参与开发，可以从源码构建。

1. 环境准备

需要提前安装以下工具：

  • Node.js：20 或更高版本
  • pnpm：包管理器
  • Rust：稳定版工具链
  • Tauri CLI：通过 cargo install tauri-cli --version "^2.0.0" --locked 安装

各平台系统依赖：

  • macOS：运行 xcode-select --install，然后通过 Homebrew 安装 nasm、pkg-config、cmake 等工具。
  • Linux (Debian/Ubuntu)：安装 libwebkit2gtk-4.1-dev、libappindicator3-dev、librsvg2-dev、patchelf 等开发包。
  • Windows：需要安装 Microsoft C++ Build Tools。

2. 克隆仓库与下载依赖

1
2
3
4
5
6
7
8
9
10
11
12
13
# 克隆仓库并初始化子模块
git clone --recursive https://github.com/julyx10/lap.git
cd lap
git submodule update --init --recursive

# 下载 AI 模型和 FFmpeg（脚本会自动处理平台差异）
# macOS / Linux:
./scripts/download_models.sh
./scripts/download_ffmpeg_sidecar.sh

# Windows (PowerShell):
# .\scripts\download_models.ps1
# .\scripts\download_ffmpeg_sidecar.ps1

3. 构建与运行

1
2
3
4
5
6
7
8
# 安装前端依赖
cd src-vite && pnpm install && cd ..

# 以开发模式运行（用于调试）
cargo tauri dev

# 构建生产版本（生成安装包）
cargo tauri build

构建产物会生成在 src-tauri/target/release/bundle/ 目录下。

🔧 部署后故障排查

  • Linux 视频无法播放：Lap 依赖系统的 GStreamer 插件。若在 Ubuntu/Debian 上遇到问题，请安装 sudo apt install gstreamer1.0-libav gstreamer1.0-plugins-good。
  • 数据库与配置备份：Lap 的标签、收藏、智能相册等元数据存储在本地 SQLite 数据库中，不会写入原照片文件。建议定期在 设置 → 存储 中备份数据库，以防数据丢失。

希望这份教程能帮你顺利部署 Lap。如果你在具体某个步骤遇到问题，可以告诉我你的操作系统和错误提示，我再帮你进一步排查。