使用指南

1. 首次启动引导

首次打开应用会自动进入三步引导向导：

• 数据目录 — 选择照片数据的存储位置（缩略图、向量库、AI 模型），也可以从已有目录迁移数据
• GPU 加速 — 一键检测显卡是否支持 DirectML，开启后人脸检测速度提升 6.6 倍
• 完成 — 界面语言根据系统自动选择（中文/英文），所有 AI 模型已内置在安装包中

2. 添加照片文件夹

引导完成后，点击主页的"添加文件夹"按钮（或直接将文件夹拖入应用窗口），选择你存放照片的目录。应用会扫描文件夹中的所有图片（支持 JPG、PNG、RAW、HEIC、WebP、AVIF 等 27 种格式），生成缩略图并提取 EXIF 信息。

3. 导入进度

导入采用后台队列机制——拖入文件夹后立即返回，可以在扫描过程中正常使用应用。全局进度条（页面顶部）会显示当前导入和 AI 处理进度。

4. AI 索引

导入完成后会自动进行 AI 向量嵌入。如需手动控制，可在侧边栏 AI 索引进度区域操作。注意：AI 模型已内置在安装包中，首次使用无需下载。

主界面

• 照片网格：瀑布流布局，按日期分组显示
• 排序方式：日期（新→旧 / 旧→新）、文件名（A→Z / Z→A）、文件大小（大→小 / 小→大）
• 列宽调节：工具栏右侧滑块，范围 140-320px，偏好会自动记住
• 无限滚动：向下滚动自动加载更多照片

选择照片

照片详情面板

选中照片后按 I 键打开右侧详情面板，显示：基本信息和 EXIF 元数据（相机、镜头、焦距、光圈、快门、ISO、GPS）、标签管理（添加、删除、AI 建议标签）、文件路径。详情面板宽度可拖拽调整，偏好会自动记住。

快速预览

选中照片后按 Space 打开快速预览，支持：滚轮缩放（1x - 8x，到 fit 停止）、拖拽平移（缩放时）、+/-/0 键盘缩放、双击切换 1:1 / fit、方向键切换上一张/下一张。

灯箱

• 双击照片或按 Enter 打开全屏灯箱
• 无限轮播浏览
• 幻灯片放映（Space 切换播放/暂停，间隔 3/5/10 秒可选）
• 缩略图导航条
• 全屏模式

搜索栏位于主页顶部，支持三种搜索模式。按 Ctrl+K 可打开聚光灯搜索面板，跨照片/标签/相册/人物/导航全局搜索，支持拼音首字母匹配。

1. 语义搜索（文本搜图）

在搜索框输入自然语言描述，如"落日海滩"、"秋天的红叶"、"猫咪特写"。AI 会理解语义含义并返回匹配的照片。结果按相似度排序，左上角显示匹配度徽章。无结果时显示空状态引导和建议。

2. 以图搜图

将图片文件拖拽到搜索栏，或点击搜索栏右侧的图片按钮选择文件。AI 会找到视觉上最相似的照片。

3. EXIF 筛选

• 日期范围：输入 YYYY-MM-DD 格式的起止日期
• 相机型号：输入时自动提示已索引的相机型号
• ISO 范围：最小/最大值
• 光圈范围：最小/最大 f/值
• 焦距范围：最小/最大值

4. 文件名通配符搜索

搜索框支持按文件名通配符匹配，适合快速查找相机原始文件名、导出批次或命名模板生成的照片。

• `IMG_*.jpg`：匹配以 `IMG_` 开头的 JPG 文件
• `*2025*`：匹配文件名中包含 `2025` 的照片
• `DSC_00??.ARW`：匹配 `DSC_00` 后跟任意两位字符的 ARW 文件

搜索历史

搜索框聚焦时会显示最近搜索记录。点击"清除全部"可一键清空。

侧边栏文件夹树按真实目录层级展示已索引照片，父级文件夹会汇总子文件夹照片数量，删除、回收站和重新索引后数量会自动保持一致。

文件夹外观

常用文件夹可以设置颜色和图标徽标，方便在大目录中快速定位项目、客户、年份或主题文件夹。

• 在侧边栏右键目标文件夹
• 选择"文件夹外观"
• 选择颜色和图标后保存

什么是 AI 索引？

AI 索引用 CLIP 模型将照片转换为向量嵌入，使语义搜索和以图搜图成为可能。所有计算在你的电脑上完成，不上传任何数据。

三种状态

添加标签

有三种方式为照片添加标签：

• 侧边栏拖拽：将照片拖到侧边栏标签树上
• 详情面板：在右侧详情面板中搜索或创建标签
• AI 批量生成：点击侧边栏标签区域的"批量生成 AI 标签"，为所有照片自动生成标签

标签层级

支持父子标签层级结构。右键标签 → "创建子标签"可建立层级关系。

AI 标签建议

在详情面板中点击"分析建议标签"，AI 会分析照片内容并给出带置信度的标签建议。点击建议即可确认添加。已分析过的照片切换回来时建议会保留（无需重新分析）。

启动检测

• 打开人物页面（侧边栏底部导航）
• 点击"开始人脸检测"
• 等待扫描完成，进度每 2 秒更新

管理人物

重新聚类

如果自动分组不准确，点击"重新聚类"仅重新运行聚类算法（不重新扫描）。如需完全重来，点击"重新扫描"（清除所有数据后重新检测）。

普通相册

在相册页面点击"新建相册"，输入名称和描述创建。通过以下方式添加照片：选中照片 → 底部操作栏 → "添加到相册"、右键照片 → "添加到相册"、拖拽照片到侧边栏相册名上。

智能相册

智能相册根据规则自动匹配照片，无需手动添加。可用规则：日期范围、相机型号、镜头型号、标签、焦距、光圈、文件格式。

• 预设模板：最近 7 天 / 30 天、今年、去年今日
• 创建时实时预览匹配照片数量

打开仪表盘查看照片库的统计分析：

从大批量照片中快速筛选出最好的作品。适用于摄影后期选片、旅行照片精选等场景。

创建选片会话

• 名称：给会话起个名字，如"2025 樱花季精选"
• 模式：PK 模式（两两对比）或甄选模式（单张审查）
• PK 子模式：快速（最少 5 次比较）/ 标准（8 次）/ 精细（12 次）

PK 模式

• 滚轮缩放（以视口中心为基准，到 fit 停止），拖拽平移，双击切换 1:1 / fit
• 键盘缩放：+ 放大、- 缩小（到 fit 停止）、0 恢复 fit
• 同步缩放：缩放/平移一张时自动同步另一张（两张照片宽高比相近时可用）
• 键盘快捷键：← 选左、→ 选右、Space / ↓ 跳过、D 绘制、Ctrl+Z 撤销
• 点击不会重置缩放（防止误触失位，与 Windows 照片查看器行为一致）
• 叠加 EXIF 信息显示
• 疲劳提醒（每 100 组对比后提示休息，最多 2 次）
• 撤销上一步选择
• 系统使用 Elo 评分算法，经过多轮配对后生成最终排名

甄选模式

逐张审查照片，决定保留或淘汰。缩放：与 PK 模式相同（滚轮、双击、+/-/0 键）。键盘快捷键：→ 保留、← / ↓ / Space 淘汰、S 跳过相似、Ctrl+Z 撤销。

结果处理

• 排行榜：按评分/胜率排序
• 多选操作：批量添加到相册、导出、删除
• Top-N 导出：一键导出前 N 张最优照片
• 对比详情：查看每张照片的胜负记录和评分变化

打开重复照片页面，应用会自动扫描并分组展示。

三种匹配类型

保留策略

• 手动选择：逐组决定保留哪张
• 保留更大文件：自动建议删除文件较小的
• 保留更早创建：自动建议删除较新的

选中多张照片后，底部操作栏提供：

批量重命名模板

支持变量：{yyyy} {mm} {dd}（日期）、{camera}（相机型号）、{iso} {focal}（拍摄参数）、{index} {index:N}（序号）、{orig}（原始文件名）、{ext}（扩展名）。预设模板：日期_相机_序号、日期_序号、原始名_日期、日期_原始名。

导出 ZIP

按 Ctrl+Shift+E 或从操作栏进入。两种模式：原图（不压缩，直接打包）、压缩（可调节质量 10-100% 和最大宽度 640-3840px）。

分享页面

生成一个包含缩略图、EXIF 信息和标签的单文件 HTML 页面。上传到云存储后生成分享链接，接收方在浏览器中即可查看。

水印

在设置 → 水印设置中配置文字或图片水印，导出和格式转换时会自动添加。支持 9 个位置锚点、边距、透明度、字号调节。

支持的提供商

• WebDAV：兼容坚果云等 WebDAV 服务
• Amazon S3：兼容 AWS S3 及其他 S3 兼容存储

配置

• 进入设置 → 云同步配置
• 点击"添加配置"
• 填写连接信息，点击"测试"验证
• 保存

删除的照片会进入回收站，保留 30 天后自动永久删除。

外观

• 主题：深色 / 浅色 / 跟随系统
• 语言：中文 / English

索引

• 缩略图缓存：查看缓存大小和位置，可一键清除
• 无效索引清理：清理源文件已移动或删除的索引记录

数据目录

更改应用数据存储位置（数据库、缩略图、AI 模型等）。迁移时显示进度，迁移期间不要关闭应用。

GPU 加速

• 引导流程：首次启动向导第 2 步，一键检测 DirectML 兼容性并开启加速
• 按需检测：可在设置页面的 GPU 加速卡片中随时重新检测或切换开关
• 手动开关：设置 → GPU 加速，随时开启或关闭
• 仅人脸识别：目前 GPU 加速仅用于人脸检测，CLIP 嵌入及其他 AI 任务仍使用 CPU

水印

• 文字水印或图片水印
• 9 个位置锚点 + 拖拽定位
• 边距、透明度、字号/图片大小可调
• Canvas 实时预览

软件更新

应用在启动时自动检查 GitHub Releases 是否有新版本。有新版本时弹出 Toast 提示，包含"重启"按钮。也可在 设置 → 软件更新 手动检查。

• 自动检查：启动时静默检查，下载完成后弹出 Toast 通知，点击"重启"安装
• 下载进度：设置页面展示带动画的进度条和已用时间
• 手动下载：点击"手动下载"跳转 GitHub Releases 页面作为备选
• 重启安装：下载完成后点击"重启并安装"应用新版本

更新代理

• 代理地址格式：127.0.0.1:port（如 127.0.0.1:7890）
• 保存后即时生效，无需重启
• 点击"测试"验证连通性（显示延迟和下载速度）

关于

查看应用版本、许可证和开源依赖列表。连续点击 ✨ 图标 7 次触发彩蛋。

浏览

选择

操作

界面

选片

灯箱

搜索为什么没结果？

AI 索引可能尚未完成。检查侧边栏 AI 进度条状态——必须等到索引完成（或至少部分完成）后语义搜索才可用。

AI 模型下载失败？

AI 模型已内置在安装包中，首次使用无需下载。如果模型文件损坏或被误删，重新安装应用即可恢复。

照片文件被移动后会怎样？

应用不会跟踪文件的移动。如果照片被移动到其他位置，索引记录会标记为无效。在 设置 → 索引 → 清理无效索引记录 可以一键清理。

我的数据库/缩略图存在哪？

默认存储在应用数据目录。可以在 设置 → 数据目录 查看和更改位置，支持迁移到其他盘符。

人脸检测不准确？

可以尝试"重新聚类"来改善分组效果，或者手动合并/拆分人物。检测阈值固定为 0.55，这是一个平衡准确率和召回率的值。

人脸检测很慢怎么办？

开启 GPU 加速可以大幅提升人脸检测速度（最高 6.6 倍）。首次启动引导流程第 2 步可一键开启，或在 设置 → GPU 加速 中手动开启。如果显卡不支持 DirectML 会自动回退 CPU。

重复检测没发现重复？

重复检测依赖 pHash 感知哈希和 CLIP 视觉相似度比较，需要在 AI 索引完成后才能进行视觉重复检测。完全相同的文件在任何时候都可以检测。

回收站的照片能保存多久？

30 天。超过 30 天自动永久删除。

支持哪些图片格式？

JPG、JPEG、PNG、WebP、AVIF、HEIC、HEIF、TIFF、BMP、GIF、RAW（CR2/CR3/NEF/ARW/DNG/RAF/RW2/ORF 等），共 27 种格式。RAW 格式通过 exiftool 提取嵌入式 JPEG 进行预览。

AI 索引或人脸检测失败，提示"Worker 进程"错误？

此错误表示 AI 工作进程启动或初始化失败，通常由系统环境问题引起。AI 模型已内置在安装包中，并非问题的原因。

排查步骤： 1. 检查工作日志：打开 %APPDATA%\AI Image Manager\logs\ai-worker.log 查看具体错误。常见错误包括 onnxruntime-node 或 sharp 模块加载失败。 2. 安装 VC++ 运行时：AI 模型需要 Visual C++ 2015-2022 可再发行组件包。下载：https://aka.ms/vs/17/release/vc_redist.x64.exe 3. 检查杀毒软件：安全软件可能拦截 .dll / .node 文件。检查杀毒软件隔离日志，并将应用安装目录添加到排除列表。 4. 避免非 ASCII 路径：尝试将便携版解压到纯英文路径（如 D:\ai-image-manager\）。 5. 清理重装：卸载并删除残留目录（%LOCALAPPDATA%\ai-image-manager\ 和 %APPDATA%\AI Image Manager\），然后重新安装最新版本。 如果以上方法均无效，请在提交 GitHub Issue 时附上 ai-worker.log 文件内容。