浏览器里白嫖 Lightroom?LightCraft Web 版 5 分钟上手:egui 一套代码通吃桌面与网页
浏览器里白嫖 Lightroom?LightCraft Web 版 5 分钟上手:egui 一套代码通吃桌面与网页
打开浏览器、拖进一张 RAW、拉几个滑块、点一下导出——没有安装包、没有注册、没有订阅,这套本该跑在原生程序里的 Lightroom 式工作流,如今整段搬进了网页里。LightCraft 是一个用纯 Rust 从零"净室"重写 Adobe Lightroom 的开源照片管理与 RAW 冲印工具,它的 Web 版(apps/lightcraft-web)把桌面端的全部 UI 编译成 WebAssembly,用 WebGL2 直接画进 <canvas>。这篇文章带你从克隆仓库到跑起网页版,再深入 WebGL2 渲染、Worker 并行渲染与浏览器存储这三块核心实现,最后花 5 分钟把"导入、调色、导出"完整玩一遍。
5 分钟跑起来:从克隆到 http://127.0.0.1:8080/
先做一次性的环境准备,需要两个东西:wasm32-unknown-unknown 目标,以及和 Cargo.lock 中版本完全一致的 wasm-bindgen CLI:
rustup target add wasm32-unknown-unknown
cargo install wasm-bindgen-cli --version <Cargo.lock 中的版本> --locked
版本号不用手动查——cargo xtask web 会先校验 CLI 是否与 Cargo.lock 锁定的一致(xtask/src/web.rs 里的 check_bindgen 会打印出精确的安装命令),缺失或版本不符都会直接提示。
然后一条命令完成构建、打包、起服务:
cargo xtask web --serve # 构建并在 http://127.0.0.1:8080/ 提供服务
cargo xtask web --serve 9000 # 换端口
cargo xtask web --dev # 未优化构建(编译快、运行慢),适合开发调试
cargo xtask web 做的事情很集中:用 web profile 交叉编译 apps/lightcraft-web,跑 wasm-bindgen 打包进 target/web/(产出 index.html、worker.js、lightcraft_web.js 和 lightcraft_web_bg.wasm),如果本机装了 binaryen 的 wasm-opt 还会顺手做一轮 -O2 体积优化,最后用纯 Rust 给每个文件生成 gzip -9 与 brotli -11 预压缩副本,并打印出尺寸对比表。--serve 自带一个只用 std 实现的微型静态服务器,会按 Accept-Encoding 协商发送 .br/.gz 副本。
三个细节值得提前知道:
- 不能用
file://直接打开。渲染 worker 和 OPFS(Origin Private File System)都需要 HTTP(S) 源;localhost与127.0.0.1被视为安全源。任何能按application/wasm提供.wasm的静态服务器都可以。 - 开发服务器会给所有响应附上
Cross-Origin-Opener-Policy: same-origin、Cross-Origin-Embedder-Policy: require-corp、Cross-Origin-Resource-Policy: same-origin三个头(xtask/src/web.rs 中的ISOLATION_HEADERS)。这让页面进入 cross-origin isolated 状态,是未来 wasm-threads(SharedArrayBuffer)构建的前提;当前这套不共享内存的 Worker 设计即使没有这些头也能跑。 - URL 上有几个调试开关:
?store=idb强制走 IndexedDB、?store=memory完全不持久化、?workers=0让渲染退回主线程、?reset清空浏览器里存的整座图库(会二次确认)。
一套 egui UI,两份宿主:桌面 wgpu,网页 WebGL2
LightCraft 的架构是"引擎优先"的 Cargo workspace:geom、color、raster、raw、codecs、develop、pipeline、catalog、engine 逐层向上,最上面是一层可整体替换的 egui 前端 crates/ui-egui。UI 之下没有任何代码知道自己运行在桌面还是浏览器里——这就是"一套代码通吃"的根。
看两端的入口就能感受到复用程度。桌面版 apps/lightcraft/src/main.rs 创建 LightcraftApp,用 eframe 的 egui-wgpu 后端渲染(Metal / Vulkan / DX12,Windows 上默认只启用 DX12);浏览器版 apps/lightcraft-web/src/web.rs 做的是同样的事,只是换成了 eframe 的 glow 后端——glow 在 wasm 上翻译为 WebGL2 调用。Cargo.toml 里那句依赖说明了一切:
[target.'cfg(target_arch = "wasm32")'.dependencies]
eframe = { workspace = true, features = ["default_fonts", "glow"] }
两个宿主唯一分叉的地方是 Services——UI 与平台能力的接口(crates/ui-egui/src/lib.rs)。桌面版注入"打开系统文件对话框、写磁盘、在文件管理器中显示";Web 版注入"打开浏览器文件选择器、把导出文件变成浏览器下载、把整座图库打包成 zip 备份"(backup_library / restore_library 是 Web 独有的)。面板、滑块、快捷键、命令注册表全在 LightcraftApp 里,一份代码两个平台同时受益。
更关键的是渲染也不在主线程。浏览器版启动时最多拉起 hardwareConcurrency − 1(上限 4)个专用 Web Worker,每个 Worker 都是同一个 wasm 模块的第二实例(apps/lightcraft-web/src/workers.rs)。index.html 只编译一次模块,把编译好的 WebAssembly.Module post 给 worker.js,Worker 几毫秒内即可就绪:
const module = await WebAssembly.compileStreaming(fetch("./lightcraft_web_bg.wasm"));
globalThis.lightcraftModule = module;
await init({ module_or_path: module });
start();
任务以 JSON 跨边界传递(WireJob:照片来源、develop 设置、渲染请求),Worker 自己从存储里读原图、渲染、再把 RGBA 字节零拷贝 transfer 回来。这个设计刻意绕开了 wasm threads / SharedArrayBuffer——每个 Worker 各有一段独立内存,照片会回到上次解码过它的 Worker(affinity),放大的 loupe 还有 stage cache,拖滑块时只重算被改动的那一截管线。Worker 起不来?自动退回主线程每帧一个任务。
图库不占硬盘:OPFS 里的持久化库
网页版没有文件系统,于是整个图库搬进了浏览器的源私有文件系统(OPFS),主线程写不了时才退到 IndexedDB(apps/lightcraft-web/src/backend.rs)。布局和桌面完全同构:
library/catalog.snap+library/catalog.log:与桌面同一套崩溃安全的追加式日志 + 快照机制,外加presets.json、view.json、prefs.json、ui.json(面板布局);originals/<内容哈希>:每张导入照片的原始字节,目录表里用web/<hash>/<文件名>引用,这样解码器仍能看到扩展名;thumbs/<key>.jpg+thumbs/index.json:渲染好的缩略图磁盘缓存,预算 2 GB、LRU 修剪到 80%,与桌面一致。
因为浏览器存储是异步的、而目录 Store 是同步的,apps/lightcraft-web/src/files.rs 在内存里做了一层镜像:写操作立刻改镜像并标记 dirty,宿主在后台按"修改时间顺序"逐个 flush,每个文件原子替换,所以日志的恢复规则仍然成立——新的 catalog.snap 永远先于随后的 catalog.log 重置落盘。保存失败不会静默:目录会拒绝新写入、顶栏亮出未保存警告、每 2 秒重试一次,web.stats 里的 saveError 会说明原因。
两个"浏览器专属"的护身符值得一提:页面持有 Web Lock(navigator.locks),同一浏览器第二个标签页会看到"LightCraft is already open in another tab"而不是各自为政;File ▸ Back Up Library… 可以把目录 + 全部原图打包成 zip 下载,Restore Library from Backup… 校验每个条目的校验和后才切换图库并重载——毕竟实验性提示写得明明白白:图库只活在这个浏览器里,原图请自行留底。
适合先玩的三件事:导入、调色、导出
① 导入:拖进来就算入库
File ▸ Import Photos…(快捷键 ⌘⇧I)打开的是浏览器的文件选择器,也可以直接把文件拖进页面任意位置。字节先写入存储(写不进去就不入库,避免刷新后照片凭空消失),再交给与桌面完全相同的引擎解码路径 lightcraft_engine::files::{probe_bytes, load_bytes}(apps/lightcraft-web/src/store.rs):JPEG / PNG / TIFF / WebP,以及 DNG、CR2、ARW、NEF、RAF、RW2、PEF、ORF 等支持的 raw 格式。首次启动时库是空的,会先生成一批程序化演示照片(crates/engine/src/demo.rs),带真实的相机元数据、相册和几处预置调色,足够你立刻上手。
② 调色:和桌面版一模一样的非破坏性管线
每一个 develop 控件——曝光/对比度/高光/阴影、参数化色调曲线与 RGB 点曲线、8 段 Color Mixer、三向 Color Grading 色轮、遮罩、裁剪——在 Web 里都和桌面行为一致,因为它们就是同一个 crate。整条渲染管线跑在 32 位浮点的线性 Rec.2020 广色域里,滑块拖动期间 Worker 走 draft 渲染并复用 stage cache,松手才出全质量图。
想量化"顺不顺滑",打开 http://127.0.0.1:8080/?bench,页面会脚本化地走完一遍流程:等网格缩略图就绪 → 打开第一张进 Detail → 像真实拖拽一样连发 8 步 Exposure 调整,最后在控制台打出一行 JSON(apps/lightcraft-web/src/bench.rs):
lightcraft-bench {"first_frame_ms":…,"thumbs_done_ms":…,"slider_draft_ms":[…],"slider_draft_median_ms":…,"slider_job_ms":[…],"release_full_ms":…}
slider_draft_ms 是从 develop.set 命令发出到新 loupe 纹理就绪的完整时延,slider_job_ms 是其中纯管线的那部分。开发文档(docs/web.md)里还记录了体积优化的实测:全量打包(包含所有编解码器与 raw 解码器)的 wasm 约 13.5 MB,brotli 预压缩后只有约 3.1 MB 上线——这就是 4K 屏幕前拖动依然跟手的底气来源之一。顺手试一下 Y 看前后对比、Shift+Y 分屏,或者 \ 按住看原图。
③ 导出:渲染结果直接变成下载
Export…(快捷键 ⌘⇧E)走的是桌面版同一条 lightcraft_engine::export 路径:JPEG / PNG / TIFF / WebP、尺寸与命名模板、输出锐化、水印等选项齐全。差异只在最后一步——Web 版的 write 服务把文件转成 Blob、生成 object URL、模拟点击 <a download>,于是"写到哪"变成了"下载到哪"(apps/lightcraft-web/src/web.rs 的 download)。同时 await lightcraft.command("library.info", "{}") 这样的自动化入口也开着:任何引擎或 UI 命令都能从控制台按 id 调用并拿到 JSON 结果,web.stats 还能报告存储后端、Worker 存活数和渲染队列深度——官方无头 Chrome 的验收脚本就是靠它驱动的。
坦诚的边界
把整套桌面应用塞进浏览器,代价也写在 docs/web.md 的 "Not yet" 里:导出与自动调整仍跑在主线程(需要原图像素在主线程内存中,刚刷新后第一次执行可能报 "still loading");持久化是"晚一帧落盘"而非 fsync 前返回;AVIF 导出在浏览器里还没验证过(它是唯一可能不 wasm-safe 的编码器);预设文件导入导出尚未接入浏览器选择器;控制通道与 MCP 是桌面专用——它们需要 TCP socket。WebGPU 渲染、Safari/Firefox 的充分测试也都在路线图上(README.md 的状态表里 Web 一行写着"✅ · WebGPU, Safari/Firefox testing 🚧")。
但就"浏览器里白嫖 Lightroom"这件事而言,现在这套东西已经远超一个玩具:同构的 UI、Worker 并行的渲染、OPFS 上的持久化图库、可下载的导出——克隆、构建、打开浏览器,5 分钟你就能拥有一座不占硬盘、随开随走的私人暗房。


