从第一张照片，到可靠的长期归档。

01 / 建立图库前

确认照片所在磁盘已连接且有足够空间，并保留一份独立备份。应用的图库数据库保存索引和标注；原照片仍是另一份需要保护的数据。为便于长期使用，尽量选择稳定的目录，避免使用会被自动清理的临时下载目录。

在照片页面选择“导入文件夹”，或把文件夹拖入应用。按面板提示完成扫描、缩略图和指纹处理，查看完成摘要；完成后可以选中本次照片进入 AI Lab。不要把任务开始理解为所有图片都已处理完成。

02 / 新增照片与恢复删除的记录

同一文件夹又加入了新照片时，重新拖入该文件夹，或在文件夹管理器中重新扫描。应用会检查新文件；它不是持续监控所有磁盘目录的后台同步服务。

此前只在软件内删除的照片，磁盘文件可能仍在；扫描遇到这些记录时，请按恢复提示作出选择。明确重新导入一个已排除的子目录，仅恢复该目录的范围，不应连带恢复同级其他已排除部分。取消恢复并不等于从磁盘删除照片。

如果数量不符合预期，先检查文件类型、扫描完成摘要、当前筛选及被排除的文件夹，再检查目录授权。不要反复删除图库记录来强制刷新，也不要清空数据库排错。

03 / 星级、筛选与连拍折叠

AI 结果只是辅助判断，你可以复核鸟种、添加标签和备注、调整评分。筛选条件会影响当前可见范围；检查照片数量时，也要检查搜索词、星级、鸟种和文件夹条件。

连拍折叠把一组照片以封面显示，并不意味着组内所有照片都拥有相同星级，也不意味着选择封面就一定选择了整组。执行导出、标注或删除前，检查选择范围提示；需要逐张核对时，可使用“展开可见连拍”查看组内照片。

04 / 导出完成后应该核对什么

先确认筛选结果和选中照片范围，再选择目标目录和组织方式。导出时保持源磁盘与目标磁盘连接，留出可用空间，等待完成摘要；如有失败，应先查看失败项并重试相应照片。

抽查目标目录中的文件能否打开，特别检查只有一张记录的鸟种。选择“以导出目录作为索引”会改变应用后续查找照片的位置；如果之后移动或清理该导出目录，可能出现无法读取。选择索引位置与是否保留独立备份是不同决定。

请在确认目标文件、数量及标注都符合预期后再整理旧目录。导出照片不是完整的应用数据备份；只有照片文件时，不应假定评分、标签、工坊作品和所有数据库信息都能完整恢复。

05 / “源文件已丢失”或无法预览

先在 Finder / 文件资源管理器中检查应用显示的实际路径。确认磁盘挂载、文件存在、文件名未改变，且云盘文件已下载到本地。再检查 BirdyBank 是否拥有该目录的访问权限。

文件在磁盘上而应用无法读取时，优先处理授权或路径问题；缩略图仍在也不能证明原文件仍可读。先记录错误提示和路径情况，保留数据库及原照片，不要直接删除记录、覆盖备份或清空缓存来尝试“恢复”。

如果问题出现在导出后，请同时保留源目录、导出目录和导出结果，说明最后选择的索引位置，以及失败照片是否属于连拍组。这样可以区分筛选、复制、路径和权限问题。

06 / Mac App Store 文件授权

MAS 版需要你在 macOS 原生选择器中选择文件或文件夹。授权可以用于后续访问，但磁盘重新挂载、目录移动、系统权限调整等情况仍可能要求重新选择。直接粘贴路径不能替代系统授予的访问权限。

需要重新授权时，选择照片实际所在的稳定父目录，并保持外置磁盘连接。撤销权限不删除原文件，也不会把原有标注清空；暂时无法读取的记录应等待权限恢复。不要为了排错随意扩大到整个磁盘的访问范围。

07 / 备份与恢复

至少分别保护原始媒体、图库数据库和不可重建的配套内容，例如派生裁剪图、鸟种封面、工坊保存作品。预览和缩略图可以重新生成，无法替代原照片。把备份放在同一块磁盘上，不能防止磁盘损坏造成的同时丢失。

使用系统备份时，先正常退出 BirdyBank，再备份应用数据和用户自定义存储目录，避免只复制正在使用中的 SQLite 主文件而遗漏待写入内容。恢复前保留当前数据的另一份副本，并使用与备份兼容的版本；不确定时先联系支持。

08 / 使用两个自带工坊

在工坊画廊中选择“宠物小鸟灵”浏览自己的鸟类图鉴，或选择“鸟影画布”编排照片、文字并导出作品。开始前检查权限面板；两个自带工坊都不请求互联网访问。

“结束授权”停止当前运行，“清除保存数据”删除工坊保存状态，二者不会互相替代。导出的作品由你在保存面板选择位置。MAS 首版不提供任意插件导入或编写；社区版中的第三方包应单独检查其权限和来源。

官网两个工坊详情地址用于介绍相应工具。支持 Universal Links 的签名 Mac 构建可据此打开画廊详情，仍需你主动打开并授权工坊；浏览器和系统设置可能让链接继续留在网页。也可以随时从应用内画廊打开。

09 / 发行渠道、更新与迁移

BirdyBank 已上架 Mac App Store，官网同时提供 Windows 与 macOS 社区版下载。社区版保留自行更新和在线通知，Mac App Store 版由 Apple 提供更新。两个 Mac 版本不支持并排安装。

迁移前先备份社区版数据库、应用数据及必要素材，并单独备份原文件。复制应用数据前请正常退出应用；仅复制运行中的 SQLite 主文件并不安全。在 macOS 社区版 1.2.2 中，打开“设置 → 数据库 → 创建迁移包”，等待校验成功。.birdymigration 包携带标注和必要素材，不搬动原照片或视频。

退出社区版，安装兼容的 Mac App Store 版（1.2.2 或以后保留格式 1 导入器的版本）。在目标版本尚未添加数据时，打开“设置 → 数据库 → 选择迁移包 → 重启并迁移”。目标图库必须为空；不要清空已有图库来强行导入，也不要手动将数据库复制到沙盒中。两端应用版本号不再要求一致，但仍会检查迁移包完整性、格式和数据库兼容性。

在文件夹管理器中重新授权原文件夹，核对媒体、鸟种、备注、评分、标签、裁剪及工坊保存内容，并退出重开一次以确认授权持续有效。验收完成前保留源数据和迁移包；失败时保留诊断信息和恢复文件，不要覆盖或删除。

10 / 关于轨迹面板的移除

1.2.0 的社区版和 MAS 版均移除轨迹面板、轨迹导入匹配、在线底图和地图下载。已有照片、标注、GPS 信息及历史轨迹数据不会因此被清空。鸟种百科中的静态分布示意不请求地图服务。

旧版生成的离线地图文件或缓存可能仍保留在原位置。它们不再由轨迹界面打开；需要清理历史文件时，请先确认其用途及备份情况，避免删除共享目录里的原照片或其他资料。

11 / 提交一个便于排查的问题

请发送邮件至 piperliu@foxmail.com，提供 BirdyBank 版本、社区版或 MAS 版、操作系统及芯片类型、具体操作顺序、预期结果、实际结果和错误码。涉及数量的问题，请提供筛选条件、选择范围及完成摘要。

可以提供已遮盖私人内容的截图或最小样例。请不要公开完整照片路径、精确定位、个人证件、访问令牌或整份图库。我们会根据问题再说明是否需要更多诊断材料；联系支持不要求你发送所有原照片。