crPhotos Vibe 项目

crPhotos 简介

crPhotos 是一款基于 Chromium 内核开发的本地照片与视频浏览器，专为 Linux 桌面用户打造。它以瀑布流（masonry）时间线为核心视图，支持 GPU 硬件加速渲染、DRM 硬解和 AI 辅助标注功能，让用户无需依赖云服务即可在本地完成照片整理、浏览和收藏。

核心功能

瀑布流时间线

crPhotos 以年月为锚点，将本地照片和视频以自适应宽高比的瀑布流形式呈现。用户可在 2~6 列之间自由切换网格密度，缩略图根据拍摄日期自动分组，年月标题跟随滚动位置动态更新，始终显示当前可见区域的时间范围。

GPU 加速渲染

浏览器内核基于 Chromium 150.0.7871.91，配合 VA-API 硬件解码和 NVDEC 视频加速，相册打开和图片切换流畅无卡顿。即便是数万张 RAW 照片的大型图库，滚动和缩放操作也能保持稳定帧率。

DRM 硬解支持

内置 Widevine CDM 支持，可直接播放受 DRM 保护的视频内容而无需额外配置。对于摄影爱好者收藏的产品评测视频或纪录片素材，无需另行安装解码器。

AI 辅助标注

集成 AI 辅助功能，帮助用户快速识别照片中的物体、场景和人物标签。标注结果可一键收藏到 Starred 列表，便于后续按主题检索。

多文件夹管理与实时监控

支持同时添加多个本地文件夹为媒体库来源，新增照片后自动扫描并更新时间线，无需手动刷新。文件夹可在设置中随时增减，配置自动持久保存。

文件筛选与全文搜索

支持按媒体类型（照片/视频）、来源文件夹或收藏状态筛选视图，输入文件名即可快速定位目标文件。筛选菜单支持多选，可同时叠加多种过滤条件。

技术实现

crPhotos 的技术栈选择体现了对性能与兼容性的双重追求。底层基于 Chromium 项目，保证了与现代 Web 标准的完全兼容；通过集成 VA-API 和 NVDEC，实现了视频解码的 GPU 卸载；AI 辅助功能则由本地运行的轻量模型提供支持，照片数据始终保留在用户本地，无需上传至任何服务器。

媒体库的构建采用增量扫描策略：首次运行扫描全部文件夹并建立索引，之后通过文件系统监控（inotify）捕获新增、删除和修改事件，实时更新索引而无需全量重扫。缩略图缓存按月分组存储，同月份照片共享缓存文件，大幅降低磁盘占用。

快速上手

第一步：下载安装

访问 GitHub Releases 页面（https://github.com/libcr/crPhotos/releases），下载对应 Linux 发行版的 AppImage 或 deb 包，以默认配置完成安装。

第二步：配置媒体库

首次启动后进入 Settings → Library，点击 Add Folder 添加存放照片和视频的本地文件夹。可同时添加多个文件夹，并在设置中选择是否包含照片、视频或两者。

第三步：浏览与筛选

返回时间线视图后，使用右上角 Filter 菜单按媒体类型或收藏状态筛选。点击网格尺寸调节按钮，在 2~6 列之间切换，找到最适合当前屏幕密度的布局。

第四步：收藏与管理

点击缩略图右下角的收藏圈可将照片加入 Starred 列表。批量选择后，可将选中文件复制到剪贴板、移入回收站，或在详情面板中查看拍摄参数（分辨率、相机型号、镜头信息等）。

适用人群

• Linux 桌面用户：习惯在本地管理照片，不想依赖云服务的摄影师和影像爱好者
• 大图库用户：拥有数万张以上照片，需要流畅浏览体验的用户
• 注重隐私的用户：不希望照片元数据被上传至任何服务器，关注数据主权
• 技术爱好者：希望用开源工具替代商业软件，愿意参与功能改进和 Bug 反馈