Leifi Lab (徕滤实验室) v3.2.0

徕滤实验室是一款致敬徕卡（Leica）美学的极简主义神经显影工作坊。它摒弃了传统的数学滤镜算法，转而采用基于大模型视觉理解的“光学重构”技术，为每一张照片注入胶片时代的灵魂。

核心演进：从滤镜到显影

在 v3.2.0 版本中，我们将显影引擎升级为前端工作台 + Vercel Functions 薄后端架构：

• 前端保留创作体验：React + Vite 继续负责上传、交互、预览、历史档案与本地图像压缩。
• 服务端托管模型密钥：Gemini 调用统一进入 /api/genai，浏览器不再直接持有 Google API Key。
• 光学数字孪生：利用 RAG（检索增强生成）技术，将半个世纪的光学百科、底片化学特性注入模型指令集。

核心特性

1. 双重显影协议

• AIGC 模式 (预计 15-25s)：追求灵感爆发的快速渲染。基于本地 RAG 知识库，快速赋予照片经典的胶片影调与氛围感。
• Agent 大师模式 (预计 45-90s)：深度显影协议。引擎会启动“思维链（CoT）”分析照片的微对比度与高光滚降，并实时联网搜索特定相机的光学缺陷与色彩特性，进行精确的像素级重构。

2. RAG 知识库 v8.0

内置高密度摄影美学语料库，涵盖：

• 光学物理：模拟德系镜头的“Leica Glow”晕化感与 T* 镀膜的通透感。
• 感光乳剂科学：还原 Kodak Tri-X 的云状颗粒与 CineStill 800T 的高光红晕（Halation）。
• 传感器工程：针对 M9 CCD 等经典传感器的非线性色彩溢出进行专项模拟。

3. 大师级预设集

• Leica M3 Rigid：人文黑白的巅峰，极致的微对比度。
• Leica M9 Steel Grey：CCD 时代的油画感，绯红色的厚重发色。
• Hasselblad 500C/M：中画幅的仪式感，平滑的高光滚降。
• CineStill 800T：霓虹夜景神器，电影胶片的暗部青调。

架构说明 (DDD)

项目严格遵循 领域驱动设计（Domain-Driven Design）：

• Domain (领域层)：定义显影会话（DevelopSession）与相机配置文件（CameraProfile）的核心逻辑。
• Application (应用层)：编排显影用例（DevelopPhotoUseCase），处理业务流转。
• Infrastructure (基础设施层)：前端负责图像预处理与 IndexedDB，本地 API 由 Vercel Function 负责 Gemini 适配与实时搜索工具。

技术栈

• 核心模型：Google Gemini 3 Pro (Image Preview)
• 前端框架：React 19 + TailwindCSS
• 存储方案：IndexedDB (自动缓存最近 20 张显影底片)
• 构建系统：Vite + TypeScript

使用须知

由于采用了高性能的 Gemini 3 Pro 引擎，本应用要求用户：

1. 服务器环境变量：在本地或 Vercel 中配置 GEMINI_API_KEY（兼容回退 GOOGLE_API_KEY / API_KEY）。
2. 高阶特性：大师模式会触发 googleSearch 工具，以获取最新的光学研究数据进行辅助显影。
3. 本地联调：只启动 vite 只能看前端界面；要调用真实显影引擎，请使用 npm run dev:full。

本地开发

1. 安装依赖：npm install
2. 创建本地环境文件：复制 .env.example 到 .env.local
3. 填入你的 Gemini key：GEMINI_API_KEY=...
4. 运行全栈联调：npm run dev:full
5. 仅调 UI 时可使用：npm run dev

部署说明

• 生产环境通过 api/genai.ts 执行 Gemini 请求，密钥只保存在服务端。
• vercel.json 已为 api/**/*.ts 配置 maxDuration，以承载大师模式的长请求。
• vercel dev 通过 devCommand 将 Vite 绑定到 Vercel 分配的 $PORT，本地全栈联调可直接使用。
• npm run dev:full 会在启动前加载本地 .env.local，确保本地接口测试能读到 GEMINI_API_KEY。
• Vercel 项目中请同步配置 GEMINI_API_KEY 到 Development / Preview / Production。

---

© 2026 徕滤 / AI 光学与艺术