常见问题解答 (FAQ)

目录

• 安装与启动
• 照片导入与索引
• 照片浏览与显示
• 搜索功能
• AI 与人脸识别
• 相册管理
• 导出与分享
• 性能问题
• 软件激活
• Docker 部署
• 数据备份与恢复
• 其他问题

安装与启动

Q: 软件支持哪些操作系统？

支持 Windows 10+ / Windows Server 2012 R2+、macOS (Apple Silicon)、Ubuntu 24.04+。三个平台均提供桌面 GUI 版本，所有平台支持 Docker 部署。

Q: 系统最低配置是什么？

Q: 首次启动后该做什么？

参考 第一章：快速入门。基本流程：

1. 添加照片文件夹（菜单 → 添加文件夹）
2. 等待扫描索引完成
3. 浏览照片、探索功能

Q: 如何切换界面语言？

在窗口底部状态栏中，点击"语言"/"Language"旁的下拉选择框，可选择 中文 或 English。切换后即时生效，无需重启。

照片导入与索引

Q: 如何添加照片文件夹？

两种方式：

• 菜单添加：侧边栏 ≡ → 添加文件夹，选择文件夹
• 拖拽添加：从文件管理器拖拽文件夹到侧边栏区域（每次一个）

Q: 支持哪些图片格式？

完整列表见 附录。

Q: 为什么扫描速度很慢？

首次扫描大量照片是正常现象。扫描速度主要取决于每张照片需要运行的 AI 模型数量：

每张照片默认运行 5 个模型（按耗时排序）：

加速建议：

1. 仅用基础能力（最快）：设置 → AI 配置 → 选择「轻量」预设，或手动仅勾选基础能力。只跑 2 个模型，速度最快。
2. 按需开启：不需要人脸识别时关闭人脸，不需要语义搜索时关闭语义，不需要 OCR 时关闭文字。
3. GPU 加速：人脸（YuNet）和语义（SigLIP2）在 GPU 上运行比 CPU 快得多。设置 → AI 配置 → 推理设备选「显卡」。
4. 只勾选需要管理的格式（设置 → 扫描设置）
5. 设置合理的最小图片尺寸过滤
6. 大量照片建议分批添加
7. 使用 SSD 存储

注意：扫描后新增开启某项 AI 能力，已扫描的照片需要重新处理，会额外耗时。建议在首次添加文件夹前就配置好需要的 AI 能力。

Q: 索引过程中可以强制退出吗？

可以。软件会持久化记录每张照片的处理状态，已完成的索引不会丢失。下次启动时自动从中断处恢复，跳过已处理文件，仅处理剩余部分（参见「扫描卡住或失败了怎么办」）。

Q: 索引通常要花多长时间？

视照片数量和 AI 能力配置而定，以下为粗略参考（单张照片平均处理耗时）：

实际时间受 CPU 性能、GPU 型号、图片分辨率、OCR 文字量等因素影响。使用「轻量」预设（仅基础）最快。

Q: 扫描卡住或失败了怎么办？

1. 重启软件。已完成的索引不会丢失，软件会在启动时自动恢复，从中断处继续（默认启用「自动恢复索引」）
2. 检查文件夹是否有读取权限
3. 确认磁盘有足够空间
4. 尝试单独添加问题文件夹
5. 使用菜单 → 刷新索引手动触发恢复扫描

原理：软件会持久化记录每张照片的处理状态（已完成/未完成），重启后自动跳过已处理的文件，仅处理剩余部分。此功能由设置 → 索引设置 →「自动恢复索引」控制（默认开启）。

Q: 如何排除不需要的文件夹？

设置 → 扫描设置 → 忽略规则，支持三种规则：

Q: 可以同时管理多个文件夹吗？

可以。添加多个文件夹后，所有文件夹的照片统一在「全部照片」中浏览。

照片浏览与显示

Q: 照片无法显示怎么办？

1. 检查原文件是否能正常打开
2. 确认文件格式是否受支持
3. 清理缩略图缓存
4. 重新扫描文件夹

Q: 缩略图加载缓慢怎么办？

• 检查磁盘读写速度（建议 SSD）
• 在设置中清理缓存
• 调整缓存大小设置

Q: 如何预览照片？

• 双击照片进入全屏预览
• 右键 → 预览
• 选中照片后按回车键

Q: 预览模式下如何操作？

Q: 如何查看照片的 EXIF 信息？

在预览模式下，点击信息图标可查看：拍摄时间、相机型号、快门/光圈/ISO、GPS 坐标、分辨率等。

Q: 如何快速选择多张照片？

启用状态栏的图层图标可开启「跨页面选择」，在不同视图间保持选中状态。

搜索功能

Q: 软件支持哪些搜索方式？

搜索框左侧下拉选择器提供 6 种模式：

1. 文件信息：按文件名、EXIF、标签等搜索
2. 画面内容：AI 语义搜索（用文字描述找照片）
3. 模糊虚焦：快速筛选模糊照片
4. 有人/无人图片：按是否含人脸筛选
5. 1星 ~ 5星：按评分筛选

扩展按钮：图像搜索（以图搜图）、人脸搜索、文件夹限定搜索。

Q: 画面内容搜索怎么用？

1. 选择「画面内容」搜索类型
2. 输入主体描述，多个用逗号分隔，如 猫, 沙发, 室内
3. 按回车执行
4. 建议使用简洁明确的主体词

Q: 搜索结果不准确怎么办？

• 重建索引（设置 → 数据重建 → 重建索引）
• 使用更精确的搜索条件
• 调整相似度阈值（0~1，越高越严格）
• 人脸搜索使用正面、光线充足的照片

Q: 搜索无结果怎么办？

1. 确认照片已索引完成
2. 检查搜索类型是否正确
3. 降低相似度阈值重试
4. 重建索引后重试

Q: 如何以图搜图？

1. 点击搜索框右侧的图像搜索图标
2. 选择「全图相似」上传参考图片
3. 或用「局部相似」拖拽裁剪感兴趣区域（最多 5 张）
4. 调节阈值滑块控制匹配严格度

AI 与人脸识别

Q: AI 功能是否需要联网？

不需要。所有 AI 功能（人脸识别、语义搜索、OCR 等）均在本地运行，无需联网。

Q: 人脸检测不准确怎么办？

1. 调整人脸识别阈值（设置 → AI 配置，默认 0.2）
2. 确保照片中人脸清晰、正面、光照良好
3. 对识别错误的人脸手动重新分配
4. 重建人脸分组

Q: 同一个人被分成了多个人物怎么办？

使用合并人物功能：

1. 选择多个可能是同一人的人物
2. 使用合并功能
3. 确认后系统自动合并

Q: 如何给人物命名？

点击未命名的人物 → 输入人物名称 → 确认保存。

Q: 如何重新分配识别错误的人脸？

1. 预览模式下点击人脸框（可多选）
2. 右键选择「人脸重新分配」
3. 在弹出的对话框中选择目标人物

Q: 如何创建零样本分类？

1. AI 分组页面 → 添加类别
2. 输入类别名称和描述（建议英文描述）
3. 可用「默认分类」快速填入预设类别
4. 创建至少两个类别后点击「执行分类」

Q: 照片上的质量图标是什么意思？

质量图标显示照片的清晰度评分：

Q: 如何更改 AI 推理设备？

设置 → AI 配置 → 推理设备，可选：自动、处理器（CPU）、显卡（GPU）。

Q: 如何选择推理配置？

设置 → AI 配置 → 推理引擎设置，软件提供 4 个预设方案：

也可手动精细调整：

• 推理设备：自动 / CPU / GPU
• 处理模式：逐个（内存友好）/ 并行（速度快）/ 自动
• 能力开关：基础（必选）、人脸、文字(OCR)、语义

轻量预设仅跑 2 个模型，索引速度最快但缺少人脸/语义/OCR 功能。后续可按需逐步开启，已扫描照片会重新处理。

Q: 大型模型和小型模型有什么区别？

大型模型理解能力更强，但需额外下载约 1.5GB 文件。切换模型后需重建索引。可在设置 → AI 配置中选择。

相册管理

Q: 相册和文件夹有什么区别？

相册是虚拟的收藏夹——不复制或移动原始文件，同一张照片可以存在于多个相册中。从相册移除照片不会删除原文件。

Q: 如何创建相册？

• 进入相册页面 → 创建相册
• 或选中照片 → 右键 → 添加到相册 → 新建相册

Q: 什么是聚合设置？

为相册配置自动收集规则，系统将从多个维度（路径、OCR、日期、人脸、语义等）自动匹配符合条件的照片加入相册。设置后执行聚合即可。

Q: 如何将搜索结果保存为相册？

在搜索结果页中，使用「将当前搜索转为相册」功能，一键保存全部搜索结果。

导出与分享

Q: 支持哪些导出格式？

原始格式、JPEG、PNG、WebP、AVIF（详见 第九章：导出与分享）。

Q: 导出时如何控制质量？

• 质量范围：50% ~ 100%
• 网络分享建议 70%~80%
• 本地存档建议 90%~100%

Q: 如何创建在线分享？

1. 在相册页面右键相册 → 分享
2. 可设置访问密码保护
3. 复制链接发送给他人

Q: 分享功能是否需要一直运行软件？

是的，分享页面由软件服务端提供。桌面版关闭后分享链接将不可访问。Docker 部署可 7×24 在线。

性能问题

Q: 软件运行缓慢怎么优化？

1. 使用 SSD 存储
2. 关闭不使用的后台程序
3. 优化数据库（设置 → 系统设置 → 优化数据库）
4. 只勾选需要管理的图片格式
5. 设置合理的最小图片尺寸过滤
6. 清理不需要的缓存文件

Q: 内存使用过高怎么办？

• 减少同时处理的照片数量
• 调整 AI 配置中的处理模式
• 重启软件释放内存

Q: 数据库需要维护吗？

建议每月执行一次数据库优化（设置 → 系统设置 → 优化数据库），可压缩数据库、提升查询性能。

软件激活

Q: 桌面版如何激活？

桌面版仅支持离线激活：

1. 打开激活对话框（菜单 → 激活）
2. 复制请求码
3. 将请求码发送给供应商获取激活码
4. 粘贴激活码并验证
5. 重启软件生效

Q: App Store 版本需要激活吗？

不需要。Microsoft Store 版本免激活。

Q: Docker 版如何激活？

Docker 版支持在线激活：

1. 打开激活对话框
2. 输入激活码
3. 系统自动联网验证

Q: 如何查看激活状态？

菜单 → 帮助 → 关于，可查看当前激活状态和有效期。

Q: 软件可以离线使用吗？

桌面版完全可以离线使用。 所有 AI 功能（人脸识别、语义搜索、OCR 等）均在本地运行。激活也是离线方式（复制请求码 → 换取激活码 → 本地验证），整个流程无需联网。

Docker 版因需要在浏览器中访问，运行环境通常有网络，激活采用在线验证。

Q: 提供买断制版本吗？

提供买断制版本（永久授权）(即将发布)，授予当前大版本的永久使用权。需要注意：

• 买断制仅限当前大版本，不包含大版本升级
• 如需升级到新的大版本，需重新购买/续费
• 授权绑定到当前机器，换电脑需重新激活

Q: 我换了电脑怎么办？

1. 授权迁移：在新电脑上打开激活对话框，复制新的请求码，联系供应商获取新电脑的激活码
2. 数据迁移：将旧电脑的数据目录（设置 → 系统设置 → 打开数据目录）复制到新电脑对应位置，重新添加照片文件夹后即可恢复索引、人脸、相册等全部数据

照片原文件也需同步迁移到新电脑，或保持网络路径一致。

Docker 部署

Q: Docker 部署需要哪些环境？

需要安装 Docker 和 docker-compose。支持标准版（x86-64）和 ARM 版（树莓派、Apple Silicon）。

Q: 如何部署？

参考 第十四章：Docker 部署：

1. 拉取镜像：docker pull lightedium:latest
2. 创建数据目录和 docker-compose.yaml
3. 启动：docker-compose up -d
4. 访问：http://your-server-ip:10242

Q: Docker 版和桌面版功能有差异吗？

Q: 如何更新 Docker 镜像？

docker-compose pull
docker-compose up -d

Q: 如何备份 Docker 数据？

tar -czf backup.tar.gz ./data

备份数据目录即可，包含数据库和配置。

数据备份与恢复

Q: 需要备份哪些数据？

Q: 如何备份？

1. 设置 → 系统设置 → 打开数据目录
2. 复制整个数据目录到备份位置
3. 建议同时备份原始照片文件夹

Q: 如何恢复？

1. 重新安装软件
2. 将备份的数据目录覆盖到对应位置
3. 重新添加照片文件夹
4. 验证数据完整性

Q: 如何重置数据库？

设置 → 系统设置 → 重置数据库。谨慎操作，此操作将清空所有数据。

其他问题

Q: 删除照片后还能恢复吗？

Q: 如何查看日志文件？

菜单 → 设置 → 系统设置 → 打开日志文件，或菜单 → 帮助 → 打开日志文件。

Q: HEIC/HEIF 文件无法显示怎么办？

需安装 FFmpeg。在设置 → 系统设置中可下载/安装 FFmpeg。

Q: 如何更新软件？

• 桌面版：菜单 → 帮助 → 检查更新
• Docker 版：docker-compose pull && docker-compose up -d

Q: 快捷键有哪些？

完整列表见 附录。常用：

Q: 可以批量修改照片文件名吗？

可以。选中照片 → 右键 → 编辑 → 重命名，支持模板变量和正则表达式两种模式。详见 第八章：批量操作。

Q: 如何查找重复照片？

进入「重复」页面，提供两种检测模式：

• 精确匹配：基于文件哈希找到完全相同的副本
• 相似度匹配：基于图像特征找到视觉相似的图片

可以使用图片对比工具辅助判断。

更多详细信息请参阅 使用教程。如需进一步帮助，可通过菜单 → 帮助 → 关于 查看版本信息。

如仍无法解决问题，请即时联系供应商获取技术支持。