README.zh-CN.md
June 2, 2026 · View on GitHub
English | Deutsch | Français | Español | Português | Русский | 简体中文 | 日本語 | 한국어
Lap 是一款开源、本地优先的照片管理器,旨在帮助您轻松浏览家庭相册、快速找回旧照片,并离线管理庞大的个人多媒体库。 它是云端照片服务的隐私替代方案:无强制上传、内置本地 AI 搜索、以文件夹为中心的工作流,且完全免费使用。
- 官方网站: https://julyx10.github.io/lap/
- 演示视频: https://youtu.be/RbKqNKhbVUs
- 隐私策略: PRIVACY.md
下载 Lap
打开 最新版本发布页面,下载匹配您系统的文件:
| 平台 | 安装包 | 备注 |
|---|---|---|
| macOS (Apple Silicon / Intel) | _aarch64.dmg / _x64.dmg | 已通过 Apple 公证 |
| Windows 10/11 (x64 / ARM64) | _x64_en-US.msi / _arm64_en-US.msi | 未签名 — 如果 SmartScreen 阻止下载,请点击仍要保留 |
| Linux (amd64 / arm64) | _amd64.deb / _arm64.deb | 适用于 Debian 系发行版(Ubuntu、Debian、Linux Mint 等) |
界面预览
为什么选择 Lap
- 无需云端:将您的媒体库保存在自己的硬盘上,无需上传到托管服务。
- 隐私优先:所有处理均在本地完成,确保您的照片始终处于您的控制之下。
- 完全免费:没有订阅计划或周期性费用。
- 以文件夹为中心:直接操作您现有的文件夹,无需冗长的导入步骤。
- 针对大库的高性能表现:针对超大规模媒体库(单库 100k+ 文件)进行了流畅浏览和管理优化。
功能特性
- 浏览与筛选:支持按日期、地点、相机、镜头、标签、收藏、评分以及人脸(测试版)进行筛选。
- 管理多个库:支持创建多个媒体库并快速切换。
- 查找重复项:自动发现重复文件并批量移动到废纸篓。
- 原地编辑:支持裁剪、旋转、翻转、缩放及基础图像调整。
- 同步文件夹:支持文件系统感知的同步操作和手动刷新。
- 本地 AI 搜索:提供以文搜图、以图搜图、人脸聚类及智能标签。
- 支持 50+ 语言搜索:可按需额外下载可选的多语言模型。
- 现代格式支持:支持 WebP、HEIC/HEIF/HIF、AVIF 和 JXL (JPEG XL)。
- 查看 RAW 照片:内置解码支持 20 多种主流相机的 RAW 格式(CR2, NEF, ARW, DNG 等)。
- 广泛的视频兼容性:支持 MP4, MOV, AVI, MKV 等 20 多种格式,并针对跨平台进行了优化。
卸载 Lap
Lap 直接使用您现有的照片文件夹。卸载 Lap 或删除其数据库和缓存文件,不会删除您的原始照片。
常规卸载只会移除应用程序。如需彻底删除 Lap,请先退出 Lap,卸载应用程序,然后按照对应平台的命令删除本地数据库、缩略图缓存和配置文件。
macOS
如果您通过 Homebrew 安装了 Lap:
brew uninstall --cask lap
如果您手动安装了 Lap,请退出 Lap,并将 Applications 文件夹中的 Lap.app 移到废纸篓。
删除所有 Lap 数据库、缓存和配置文件:
rm -rf "$HOME/Library/Application Support/com.julyx10.lap" \
"$HOME/Library/Caches/com.julyx10.lap" \
"$HOME/Library/WebKit/com.julyx10.lap"
rm -f "$HOME/Library/Preferences/com.julyx10.lap.plist"
Windows
打开 设置 > 应用 > 已安装的应用,找到 Lap 并选择 卸载。
然后打开 PowerShell,删除所有 Lap 数据库、缓存和配置文件:
Remove-Item -Recurse -Force -ErrorAction SilentlyContinue "$env:LOCALAPPDATA\com.julyx10.lap"
Remove-Item -Recurse -Force -ErrorAction SilentlyContinue "$env:APPDATA\com.julyx10.lap"
Linux
对于基于 Debian 的发行版,请卸载软件包:
sudo apt remove lap
然后删除所有 Lap 数据库、缓存和配置文件:
rm -rf "$HOME/.local/share/com.julyx10.lap" \
"$HOME/.cache/com.julyx10.lap" \
"$HOME/.config/com.julyx10.lap"
如果您在 Lap 设置中选择了自定义数据库存储目录,请在确认其中仅包含 Lap 数据库文件后,单独删除该目录。
源码编译
编译要求: Node.js 20+, pnpm, Rust stable.
# macOS 系统依赖
xcode-select --install
brew install nasm pkg-config autoconf automake libtool cmake
# Linux 系统依赖
# sudo apt install libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev \
# patchelf nasm clang pkg-config autoconf automake libtool cmake
# 克隆并编译
git clone --recursive https://github.com/julyx10/lap.git
cd lap
git submodule update --init --recursive
cargo install tauri-cli --version "^2.0.0" --locked
./scripts/download_models.sh # Windows: .\scripts\download_models.ps1
./scripts/download_ffmpeg_sidecar.sh # Windows: .\scripts\download_ffmpeg_sidecar.ps1
cd src-vite && pnpm install && cd ..
cargo tauri dev
支持格式
| 类型 | 格式清单 |
|---|---|
| 常规图片 | JPG/JPEG, PNG, GIF, BMP, TIFF, WebP, HEIC/HEIF/HIF, AVIF, JXL |
| RAW 照片 | CR2, CR3, CRW, NEF, NRW, ARW, SRF, SR2, RAF, RW2, ORF, PEF, DNG, SRW, RWL, MRW, 3FR, MOS, DCR, KDC, ERF, MEF, RAW, MDC |
| 视频 | MP4, MOV, M4V, MKV, AVI, FLV, TS/M2TS, WMV, WebM, 3GP/3G2, F4V, VOB, MPG/MPEG, ASF, DIVX 等。所有平台均支持 H.264 播放;在不支持原生播放时,系统会自动进行兼容性处理。macOS 原生支持 HEVC/H.265 和 VP9。 |
Linux 视频播放备注
在 Linux Mint/Ubuntu/Debian 上,请安装以下软件包以获得更好的视频播放支持:
sudo apt install gstreamer1.0-libav gstreamer1.0-plugins-good
技术架构
- 核心: Tauri + Rust
- 前端: Vue + Vite + Tailwind CSS
- 数据: SQLite
关键库
| 库 | 用途 |
|---|---|
| LibRaw | RAW 图像解码与缩略图提取 |
| libheif | HEIC/HEIF/HIF 图像解码与预览生成 |
| libjpeg-turbo | 快速 JPEG 解码与缩略图生成 |
| FFmpeg | 视频处理与缩略图生成 |
| Video.js | 跨平台视频播放界面 |
| ONNX Runtime | 本地 AI 模型推理引擎 |
| CLIP | 图文相似度搜索 |
| InsightFace | 人脸检测与识别 |
| Leaflet | 用于地理位置照片的交互式地图 |
| daisyUI | 界面 UI 组件库 |
开源协议
GPL-3.0-or-later。详情请参阅 LICENSE。