01

为什么 Lightroom 里看不到评分和旗标? Why don't I see ratings and flags in Lightroom?

SuperPicky 将评分写入照片的 EXIF/XMP 元数据中。如果照片已经导入 Lightroom,需要手动同步元数据: SuperPicky writes ratings to photo EXIF/XMP metadata. If photos are already imported in Lightroom, you need to manually sync metadata:

1 在 Lightroom 中选中需要同步的照片(或按 Cmd/Ctrl+A 全选) Select photos to sync in Lightroom (or press Cmd/Ctrl+A to select all)
2 菜单选择「元数据」→「从文件读取元数据」 Go to menu "Metadata" → "Read Metadata from Files"
3 确认对话框,Lightroom 将从文件读取最新的评分、旗标和标签信息 Confirm the dialog, Lightroom will read the latest ratings, flags and labels from files
💡 建议:在 Lightroom 偏好设置中开启「自动将更改写入 XMP」,这样元数据会自动双向同步。 Tip: Enable "Automatically write changes into XMP" in Lightroom Preferences for automatic two-way sync.
02

为什么飞鸟的绿色标签 / 精焦的红色标签不显示? Why aren't the green (BIF) / red (critical focus) labels showing?

SuperPicky 使用英文颜色名称(如 "Green"、"Red")写入标签。如果您的 Lightroom 使用不同的颜色标签集设置,标签可能无法正确显示。 SuperPicky uses English color names (e.g., "Green", "Red") for labels. If your Lightroom uses a different color label set, labels may not display correctly.

1 打开 Lightroom,选择菜单「元数据」→「颜色标签集」 Open Lightroom, go to menu "Metadata" → "Color Label Set"
2 选择「Lightroom 默认」或「Bridge 默认」 Select "Lightroom Default" or "Bridge Default"
3 如果使用中文版 Lightroom,可能需要选择「编辑...」,将绿色标签的文本改为 "Green",红色改为 "Red" If using localized Lightroom, you may need to select "Edit..." and change the green label text to "Green", red to "Red"
Green = 飞鸟照片 = BIF photo
Red = 精焦照片(对焦点在鸟头上) = Critical focus photo (focus point on bird head)
03

为什么看不到精选旗标(Pick Flag)? Why don't I see the Pick Flag?

精选旗标写入 XMP:Pick 字段。与评分一样,需要从文件读取元数据才能在 Lightroom 中显示: Pick flags are written to the XMP:Pick field. Like ratings, you need to read metadata from files to display them in Lightroom:

1 选中照片 →「元数据」→「从文件读取元数据」 Select photos → "Metadata" → "Read Metadata from Files"
📌 精选旗标仅授予 3 星照片中锐度和美学都排名前 25% 的交集,是最优秀的照片。 Pick flags are only given to 3-star photos that rank in the top 25% for BOTH sharpness and aesthetics - these are the best of the best.
04

为什么看不到排除旗标(Reject Flag)? Why don't I see the Reject Flag?

0 星照片会被标记为排除旗标(XMP:Pick = -1)。同样需要从文件读取元数据: 0-star photos are marked with a reject flag (XMP:Pick = -1). You also need to read metadata from files:

1 选中照片 →「元数据」→「从文件读取元数据」 Select photos → "Metadata" → "Read Metadata from Files"
🗑️ 在 Lightroom 中,您可以按 Cmd/Ctrl+Delete 删除所有带排除旗标的照片,快速清理 0 星废片。 In Lightroom, you can press Cmd/Ctrl+Delete to delete all rejected photos, quickly cleaning up 0-star rejects.
05

如何在 Lightroom 中按锐度或美学评分排序? How to sort by sharpness or aesthetics in Lightroom?

SuperPicky 将锐度和美学评分写入 XMP 的地理位置字段,可以在 Lightroom 中直接排序: SuperPicky writes sharpness and aesthetics scores to XMP location fields, which can be sorted directly in Lightroom:

XMP:City 锐度值(000.00 - 999.99) Sharpness (000.00 - 999.99)
XMP:State 美学评分(00.00 - 10.00) Aesthetics (00.00 - 10.00)
XMP:Country 对焦状态(精焦/合焦/偏移/失焦) Focus status (Critical/Good/Soft/Out-of-Focus)
💡 在 Lightroom 图库模块中,点击「视图」→「排序」→「城市」可按锐度排序,选择「州/省」可按美学排序。 In Lightroom Library module, click "View" → "Sort" → "City" to sort by sharpness, or "State" to sort by aesthetics.
06

如何重置选片结果? How to reset selection results?

SuperPicky 提供完整的重置功能,可以恢复文件位置和清除元数据: SuperPicky provides a complete reset function to restore file locations and clear metadata:

1 打开 SuperPicky,选择之前处理过的目录 Open SuperPicky, select the previously processed directory
2 点击「重置」按钮 Click the "Reset" button
3 所有照片将移回原始目录,评分、旗标、标签等元数据将被清除 All photos will be moved back to the original directory, ratings, flags, labels and other metadata will be cleared
⚠️ 重置后需要在 Lightroom 中重新「从文件读取元数据」才能看到清除后的状态。 After reset, you need to "Read Metadata from Files" in Lightroom again to see the cleared state.
07 V4

V4.0.0 有什么新功能? What's new in V4.0.0?

V4.0.0 是一个重大更新,增加了多项强大功能: V4.0.0 is a major update with powerful new features:

SuperPicky V4 Interface
  • AI 鸟种识别 - 自动识别全球 11,000+ 鸟种,写入 IPTC 元数据 AI Bird ID - Automatically identify 11,000+ species, writes to IPTC metadata
  • Lightroom 插件 - 无需离开 Lightroom 即可识别鸟种 Lightroom Plugin - Identify birds without leaving Lightroom
  • eBird 集成 - 根据 GPS 位置过滤当地不可能出现的鸟种 eBird Integration - Filter impossible species based on GPS location
  • 鸟种分类目录 - 按识别的鸟种自动创建子目录整理照片 Species Folders - Auto-organize photos into species subdirectories
  • 系统托盘 - 支持后台运行,隐藏 Dock 图标 System Tray - Background mode with hidden Dock icon
  • 自动更新 - 启动时自动检查新版本 Auto Update - Check for updates on startup
  • CLI 工具 - 命令行版本支持完整功能和鸟类识别 CLI Tool - Full-featured command line interface with bird ID
💡 支持 macOS Apple Silicon (M1/M2/M3/M4) 和 Intel 处理器。 Supports macOS Apple Silicon (M1/M2/M3/M4) and Intel processors.
08 V4

如何安装和使用 Lightroom 插件? How to install and use the Lightroom plugin?

V4.0.0 安装时会自动部署 Lightroom Classic 插件。如果需要手动添加: V4.0.0 installer automatically deploys the Lightroom Classic plugin. To add manually:

Lightroom Plugin
1 打开 Lightroom Classic「文件」→「增效工具管理器」 Open Lightroom Classic "File" → "Plug-in Manager"
2 点击「添加」,选择 ~/Library/Application Support/Adobe/Lightroom/Modules/SuperBirdID.lrplugin Click "Add", navigate to ~/Library/Application Support/Adobe/Lightroom/Modules/SuperBirdID.lrplugin
3 确保 SuperPicky 应用正在运行,且「识鸟 API」开关已开启 Ensure SuperPicky app is running with "Bird ID API" enabled
4 选中照片,使用「图库」→「增效工具」→「慧眼选鸟 - 识别当前照片」 Select photos, use "Library" → "Plug-in Extras" → "SuperPicky - Identify Bird"
💡 识别结果会自动写入 Lightroom 的关键字、标题和简介字段,无需手动同步元数据。 Results are automatically written to Lightroom keywords, title and caption fields, no manual sync needed.
09 V4

如何使用命令行工具 (CLI)? How to use the Command Line Interface (CLI)?

V4.0.0 提供完整的命令行工具,支持所有核心功能: V4.0.0 provides a full-featured CLI supporting all core functions:

# 处理照片目录
python superpicky_cli.py process ~/Photos/Birds

# 自定义阈值处理
python superpicky_cli.py process ~/Photos/Birds -s 600 -n 5.2

# 处理时自动识别鸟种
python superpicky_cli.py process ~/Photos/Birds --auto-identify

# 重置目录
python superpicky_cli.py reset ~/Photos/Birds

# 重新评星
python superpicky_cli.py restar ~/Photos/Birds -s 700 -n 5.5

# 识别单张照片的鸟类
python superpicky_cli.py identify ~/Photos/bird.jpg

# 识别并写入EXIF
python superpicky_cli.py identify bird.NEF --write-exif
💡 CLI 支持纯 JPG 文件夹的自动识别处理,适合批量处理大量照片。 CLI supports auto-identification for JPG-only folders, ideal for batch processing.
10 V4

如何使用系统托盘后台运行? How to use system tray for background mode?

V4.0.0 新增系统托盘功能,支持后台运行: V4.0.0 adds system tray support for background mode:

System Tray
1 点击主窗口右上角的「最小化到托盘」按钮 Click "Minimize to Tray" button at top-right of main window
2 应用会隐藏主窗口并在菜单栏显示图标 App hides main window and shows icon in menu bar
3 点击菜单栏图标可以显示窗口或退出应用 Click menu bar icon to show window or quit app
💡 后台运行时 Lightroom 插件仍可正常使用,无需保持主窗口打开。 Lightroom plugin works in background mode without main window open.
11 V4

如何按鸟种自动分类照片? How to auto-organize photos by species?

启用鸟种识别后,照片可按识别的鸟种自动分类到子目录: With bird ID enabled, photos can be auto-organized into species subdirectories:

Species Folders
1 在主界面勾选「启用鸟种识别」 Check "Enable Bird ID" in main interface
2 勾选「按鸟种分目录」选项 Check "Organize by Species" option
3 处理完成后,照片将按「中文名_英文名」格式创建子目录 After processing, photos are organized into "Chinese_English" named folders
📁 RAW+JPEG 配对文件会同时移动到对应的鸟种目录中。 RAW+JPEG pairs are moved together to the species folder.
12 V4

什么是 eBird 地区过滤? What is eBird region filtering?

eBird 是全球最大的鸟类观测数据库。SuperPicky 利用 eBird 数据过滤该地区不可能出现的鸟种: eBird is the world's largest bird observation database. SuperPicky uses eBird data to filter impossible species:

eBird Integration
  • GPS 自动检测 - 如果照片包含 GPS 信息,自动获取当地鸟种列表 GPS Auto-detect - Auto-fetches local species list if photo has GPS
  • 手动选择 - 可手动选择国家和省/州进行过滤 Manual Selection - Can manually select country and state for filtering
  • 提高准确率 - 过滤后识别准确率大幅提升 Improved Accuracy - Filtering significantly improves identification accuracy
🌍 建议始终开启 eBird 过滤,特别是在特定地区拍摄时。 Recommend always enabling eBird filter, especially when shooting in specific regions.
13

Photoshop 或 Bridge 可以使用吗? Can I use Photoshop or Bridge?

SuperPicky 的评分和元数据功能与 Adobe Bridge 和 Photoshop 完全兼容: SuperPicky's rating and metadata features are fully compatible with Adobe Bridge and Photoshop:

  • Bridge 完全支持 - 评分、标签、旗标在 Bridge 中都可以正常显示和排序 Full Bridge Support - Ratings, labels, flags display and sort correctly in Bridge
  • Photoshop 可读取 - 通过「文件」→「文件简介」可查看鸟种识别结果 Photoshop Readable - View bird ID results via "File" → "File Info"
  • 颜色标签兼容 - 建议使用「Bridge 默认」标签集以获得最佳兼容性 Label Compatible - Use "Bridge Default" label set for best compatibility
⚠️ 注意:Lightroom 插件仅适用于 Lightroom Classic,无法在 Bridge 或 Photoshop 中使用。但您仍可使用主程序处理照片后在 Bridge 中查看结果。 Note: The Lightroom plugin only works with Lightroom Classic. However, you can still process photos with the main app and view results in Bridge.
14 V4

首次运行为什么加载很慢? Why is the first launch slow?

V4.0.0 新增了 AI 鸟种识别功能,首次运行需要加载多个 AI 模型: V4.0.0 adds AI bird identification, which requires loading multiple AI models on first launch:

  • 首次启动 - 需要 10-30 秒加载所有 AI 模型到内存 First Launch - Takes 10-30 seconds to load all AI models into memory
  • 后续启动 - 模型已缓存,启动速度明显加快 Subsequent Launches - Models are cached, startup is much faster
  • 识别速度 - 模型加载后,单张照片识别仅需 1-2 秒 ID Speed - After loading, each photo takes only 1-2 seconds to identify
💡 建议:使用系统托盘功能让应用在后台运行,这样随时可以快速使用 Lightroom 插件。 Tip: Use system tray to keep the app running in background for instant Lightroom plugin access.
15 V4

AI 鸟种识别不准确怎么办? What if AI bird identification is inaccurate?

以下方法可以显著提高识别准确率: These methods can significantly improve identification accuracy:

1 开启 eBird 过滤 - 根据拍摄地点过滤掉当地不可能出现的鸟种,大幅提高准确率 Enable eBird Filter - Filter out species impossible at your location, greatly improving accuracy
2 选择正确的地区 - 确保照片有 GPS 信息,或手动选择正确的国家/省份 Select Correct Region - Ensure photos have GPS data, or manually select correct country/state
3 使用清晰照片 - 模糊、遮挡或距离过远的照片会降低识别准确率 Use Clear Photos - Blurry, obscured, or distant photos reduce accuracy
4 查看置信度 - 高置信度的结果更可靠,低置信度建议人工复核 Check Confidence - High confidence results are more reliable, low confidence needs manual review
🎯 AI 模型支持全球 11,000+ 鸟种,但相似物种(如不同地区的亚种)可能需要专业知识辅助判断。 AI model supports 11,000+ species worldwide, but similar species (like regional subspecies) may need expert knowledge.
16 V4

鸟种识别结果写入了哪些元数据? What metadata fields are written for bird ID?

鸟种识别结果会写入以下 IPTC/XMP 元数据字段: Bird identification results are written to these IPTC/XMP metadata fields:

Keywords 中文名、英文名、学名 (如:红嘴蓝鹊, Red-billed Blue Magpie, Urocissa erythroryncha) Chinese name, English name, Scientific name
Title 中文名 | 英文名 | 学名 Chinese Name | English Name | Scientific Name
Caption 鸟种简介描述(来自数据库) Species description (from database)
💡 这些元数据在 Lightroom、Bridge、Photoshop 中都可以搜索和筛选,方便后期管理鸟类照片库。 These metadata fields are searchable in Lightroom, Bridge, and Photoshop for easy bird photo library management.
17 V4

Windows 版本的 V4.0.0 发布了吗? Is Windows V4.0.0 available?

是的!V4.0.0 现已推出 Windows 测试版 (Beta),支持绝大多数新功能: Yes! V4.0.0 works on Windows (Beta) and supports most new features:

  • 核心功能支持 - 完整的 AI 鸟种识别、CLI 命令行工具均已支持 Core Features - Full AI Bird ID and CLI tool support
  • Lightroom 插件 - 暂不支持自动安装,需手动加载插件 Lightroom Plugin - Manual installation required (no auto-install yet)
  • 系统环境 - 需要 Windows 10/11 (x64) 系统 System Requirements - Requires Windows 10/11 (x64)
📢 由于是测试版,Windows 版本可能存在一些不稳定性。如遇问题请在 GitHub 提交 Issue 反馈。 As a Beta release, Windows version might have some instability. Please report issues on GitHub.