资源库

概览

资源库是管理所有照片、视频和音频文件的中心界面。你可以在此浏览、搜索、筛选资源，进行批量操作，查看和编辑元数据，并通过全屏查看器欣赏资源。资源库同时支持堆叠管理（自动合并连拍、Live Photo 等关联资源）和物种识别等高级功能。

浏览资源库

资源库以缩略图网格的形式展示所有媒体文件。你可以通过页面顶部的排序下拉菜单选择按拍摄日期或添加时间排序。

布局模式

资源库提供两种布局模式：

• 自适应布局 — 缩略图以瓦片形式排列，每张图片根据自身宽高比自适应宽度，最大限度地利用屏幕空间。
• 网格布局 — 缩略图以等大的正方形均匀排列，形成规整的网格。

在页面顶部单击布局切换按钮可在两种模式间切换。网格模式下，你还可以调整每行显示的列数。布局偏好会自动保存，下次打开时沿用。你可以在设置 → 外观中进一步调整布局相关的默认值。

日期分组

资源按拍摄时间自动分为若干组：

• 今天 — 当天拍摄的资源
• 昨天 — 前一天拍摄的资源
• 本周 — 本周内拍摄的资源
• 本月 — 本月内拍摄的资源
• 更早 — 以上之外的资源按月分组合并，如"2026 年 6 月"

分组时间依据资源拍摄地所在时区计算，确保跨时区拍摄的资源归入正确的日期分组。

无限滚动

浏览资源库时，页面会随着向下滚动自动加载更多资源，无需手动翻页。

在极少数情况下（如网络不稳定），自动加载可能不可用——此时页面底部会出现"加载更多"按钮，点击即可手动继续加载。

扫描按钮

当你通过外部途径（如文件导入、相机连接）向工作库中添加了新文件后，单击页面顶部的扫描按钮可触发一次资源库扫描。扫描操作会检测新增文件并将其纳入资源库中。

搜索

搜索入口

单击页面右下角的 搜索按钮，输入框随即展开。输入关键词后，资源库将自动展示搜索结果。

搜索关键词会同步到浏览器地址栏——你可以复制当前链接分享给他人，对方打开后将看到相同的搜索结果。

搜索结果分层

搜索结果分为两个区域：

• 最佳匹配 — 显示最相关的搜索结果（通常不超过 9 条），按综合相关性排列在最前面。
• 结果 — 展示所有命中的资源，按拍摄时间从新到旧排列。

两个区域间有明确分隔，便于区分。

图像语义分析与降级行为

资源库默认使用图像语义分析——即使关键词与文件名不完全匹配，也能通过图片内容语义找到相关资源。图像语义分析与基于文件名、OCR 文字识别等多路检索融合，给出综合结果。管理员可在设置 → AI 中开启或关闭图像语义分析及其他 ML 功能。

当图像语义分析服务不可用或请求出错时，系统会进入降级模式：

• API 接口不变（始终为同一搜索端点），返回数据中 degraded 字段标记为 true。
• 如果其他检索通道（文件名、OCR、地点等）仍正常工作，搜索结果会正常返回，但缺少语义维度的匹配，相关性可能下降。
• 如果所有检索通道均无法工作，系统会回退到纯文件名的 SQL 模糊匹配搜索，此时"最佳匹配"区域将为空。

降级时，搜索结果区域顶部会显示提示横幅："语义搜索暂不可用，结果可能不完整。"

提示

降级状态由服务端自动判定，前端自动展示提示横幅，无需用户手动干预或重试。

筛选

单击页面顶部的筛选按钮可展开筛选面板。每个筛选维度有独立的启用开关，开启后调整条件即自动生效，无需手动确认。

筛选维度包括：

维度	说明
类型	筛选照片或视频，可单独或组合选择
RAW 文件	包含 / 排除 RAW 格式文件
评分	按星级筛选（5 星至 1 星），可选"未评分"
喜欢	仅显示已标记喜欢的资源，或排除已喜欢的资源
文件名	按文件名模糊匹配，支持"包含""等于""开头为""结尾为"四种匹配方式
日期范围	通过日期选择器设定起止时间，筛选该时间段内的资源
相机型号	从已检测到的相机列表中选取，支持搜索
镜头	从已检测到的镜头列表中选取
标签	按一个或多个标签筛选，使用与标签编辑相同的搜索选择器
位置	按地理包围盒筛选

位置筛选

位置筛选基于包围盒（Bounding Box）定义筛选区域，即用北、南、东、西四个坐标值划定一个矩形地理范围。

你可以通过两种方式设置：

1. 直接输入坐标 — 在筛选面板中分别填写北、南、东、西四个方向的经纬度数值（十进制，精确到小数点后六位）。
2. 在地图上选择 — 单击"在地图上选择"按钮打开地图弹窗，通过以下步骤生成包围盒：
   • 输入中心点经纬度和半径（公里），或点击"使用当前位置"自动填入设备定位。
   • 单击生成边界框，系统根据中心点 + 半径计算出包围盒，并在地图上以蓝色矩形预览。
   • 确定后点击"完成"返回筛选面板。

说明

半径仅在地图弹窗内用于计算包围盒，最终请求接口时只传递包围盒坐标，不包含半径信息。

标签筛选

开启标签维度后，会出现一个标签选择器——与全屏查看器信息面板中编辑标签使用的是同一个组件：顶部是搜索框，下方列出标签库中的标签。

• 在搜索框输入关键词可过滤标签列表。
• 单击某个标签将其勾选，即纳入筛选条件；已勾选的标签显示在列表顶部，再次单击取消勾选。
• 与标签编辑不同，筛选器只能从已有标签中选择，不能新建标签。

当勾选多个标签时，筛选采用交集（AND）语义——只返回同时含有全部所选标签的资源，而非含有任一标签的资源。

选择与批量操作

选择模式

单击页面顶部的选择按钮进入选择模式。此时每个缩略图左上角会出现选择框。

• 单击 — 选中单个资源，此前选中的自动取消。
• 按住 Ctrl（macOS 为 Cmd）并单击 — 切换某个资源的选中状态，不影响其他已选资源。
• 按住 Shift 并单击 — 从上一个选中的资源到当前单击的资源之间，选中连续范围内的所有资源。

再次单击选择按钮退出选择模式，所选状态将清空。

键盘快捷键

快捷键	功能
Ctrl / Cmd + 单击	切换单个资源的选中状态
Shift + 单击	选中连续范围内的资源
Ctrl / Cmd + A	全选当前已加载视图中的所有资源
Esc	取消所有选中，退出选择模式

批量操作

选中一个或多个资源后，页面顶部会显示选中数量，同时出现操作按钮。单击该按钮展开操作菜单：

操作	说明
评分	批量设置选中资源的星级（5 星至 1 星，或清除评分）
标记喜欢	批量标记为喜欢或取消喜欢
堆叠选中项	将选中的资源合并为一个手动堆叠
加入相册	弹出相册选择窗口，将资源添加到已有相册中
下载	选中资源 ≤ 10 个时逐个下载；超过 10 个时自动打包为 ZIP 文件后下载
删除	将选中资源移入回收站。操作前会弹出确认对话框

全屏查看器

在资源库中单击任意缩略图，即进入全屏查看器。查看器占据整个视口，顶部显示当前资源在视图中的位置（如"3 / 15"）。

导航

• 滑动 — 在触摸屏上左右滑动可快速切换到相邻资源。
• 键盘 — 使用键盘左右方向键切换资源。
• 滚动定位 — 若通过 URL 直接打开某个不在当前视图中的资源，查看器会自动加载更多页面直至定位到该资源，期间显示"正在定位…"提示。

关闭查看器后，资源库会停留在之前浏览的位置，避免重新翻找。

媒体播放

不同类型的媒体在全屏查看器中有不同的呈现方式：

媒体类型	表现
照片	以最佳显示比例展示大图。若为 Live Photo，图片上会出现 Live Photo 标记，悬停时可播放动态效果
视频	使用视频播放器渲染，提供播放/暂停、进度条、音量控制等标准控件
音频	显示音频封面占位图及基本元信息

信息面板

全屏查看器底部可展开信息面板，查看当前资源的详细元数据。不同媒体类型展示的信息有所差异：

照片 — 拍摄时间、文件名、评分、相机型号与镜头、ISO、曝光时间、曝光补偿、焦距、光圈值、描述（支持编辑）、GPS 坐标及位置名称、小地图、EXIF 提取入口。

视频 — 录制时间、文件名、评分、编码格式、分辨率、时长、码率、帧率、相机型号、GPS 坐标、描述（支持编辑）。

音频 — 上传时间、文件名、评分、标题/艺术家/专辑/流派/年份、编码格式、时长、码率、采样率、声道数、描述（支持编辑）。

其中评分和描述支持直接编辑，修改后即时保存。

标签

信息面板中有一个独立的标签区块，以横向滚动列表展示当前资源的所有标签。标签有两种来源：

• 手动标签 — 由用户手动添加，可自由编辑。
• AI 标签 — 由 AI 自动生成（如零样本分类得出的 document、receipt 等）。AI 标签在标签行中只读展示：不会出现在编辑选择器里，也无法手动移除——它们由分类器管理，资源重新处理后会自动重建。

单击区块末尾的 按钮打开标签编辑器（一个搜索 + 勾选式弹层）：

• 已添加的手动标签显示在顶部并打勾，单击可取消勾选以移除该标签。
• 下方列出标签库中尚未添加的标签，单击即添加到当前资源。
• 在搜索框输入标签库中不存在的名字时，底部出现「Create new tag: "……"」一项，回车或单击即新建该标签并添加到当前资源。

提示

标签筛选与此处使用同一个选择器组件，因此添加、筛选标签的交互保持一致。区别在于筛选器不提供"新建标签"。详见筛选 → 标签筛选。

底部操作栏

全屏查看器底部有一个展开式操作按钮组（FAB），包含以下功能：

• 信息 — 切换信息面板的显示与隐藏
• 标记喜欢 — 切换资源的喜欢状态
• 导出 — 打开导出弹窗
• 删除 — 将资源移入回收站，操作前弹出确认对话框

导出弹窗

导出弹窗提供以下功能组：

快捷工具行（横向图标按钮）：

• 工作室 — 将当前资源发送到工作室进行编辑
• 加入相册 — 从列表中选择目标相册
• 下载原文件 — 下载资源的原始文件
• 在新标签页中查看原文件 — 在浏览器新标签中打开原始文件
• 重试处理 — 打开重试面板，可重新执行元数据提取、缩略图生成、转码、AI 语义嵌入等任务

格式导出： 支持将照片导出为 PNG、JPEG（80%）、WebP（80%）或 AVIF 四种预设格式。质量参数为固定预设值，不可自定义。选择格式后单击"导出"按钮即可下载转换后的文件。视频和音频资源不支持格式转换，但仍可下载原文件。

堆叠管理

堆叠是一组相关资源的集合，在资源库中以单张缩略图展示，右上角显示资源数量标记。

自动堆叠

系统会根据以下规则自动将相关资源归入同一堆叠：

堆叠类型	说明	状态
Live Photo	Apple 的 Live Photo（静态图片 + 运动短片）自动合并为一个堆叠	已实现
RAW + JPEG	同时保存的 RAW 和 JPEG 版本自动堆叠	已实现
连拍	短时间内连续拍摄的多张照片自动归为一组	开发中
编辑版本	原始资源及其经工作室编辑后生成的版本自动关联	开发中

交互操作

• 展开查看 — 单击缩略图上的堆叠数量标记，弹出堆叠内成员的滑动浏览视图，可逐一查看。
• 查看详情 — 在堆叠视图中可查看每个成员的标签（如"原始文件""JPEG 原始""编辑版本"），以及指定封面和当前选中项。
• 手动堆叠 — 选择多个资源后，通过批量操作的"堆叠选中项"功能可手动创建堆叠。

物种识别

对于包含野生动植物内容的照片，全屏查看器中可打开BioCLIP 物种识别（Field Guide） 面板。该功能会展示 AI 对照片中物种的预测结果。

面板内容包括：

• 预测列表 — 最多显示 3 个最可能的物种预测，每个预测附带置信度分数条。
• 物种信息 — 每个预测显示常用名、学名和展示名。
• 分类学信息 — 展开后可查看从界到种的完整分类学层级（界、门、纲、目、科、属、种）。
• 参考链接 — 每个预测提供指向 iNaturalist 的参考按钮，可查看外部资料。

Lumilio Agent

全屏查看器底部提供了 Lumilio Agent 的启动入口。单击后将在界面右侧打开 AI 助手面板，可针对当前查看的资源进行对话式操作（如询问拍摄信息、获取编辑建议等）。

Lumilio Agent 是一个独立功能，此处仅提及入口位置。管理员可在设置 → AI 中配置 Agent 的服务商和模型。详细用法请参见 Lumilio Agent 文档（）。

偏好设置

资源库的以下偏好会自动保存，跨会话沿用：

偏好	说明
布局模式	自适应布局或网格布局，可在设置 → 外观中调整默认值
网格列数	网格模式下每行显示的列数
排序方式	按拍摄日期或添加时间排序
筛选条件	当前生效的筛选条件（仅主资源库）