准备工作
完成以下准备后，再进入“添加存储目标”。第一次使用时，建议让 iPhone 或 iPad 与 NAS、Mac 或 Windows 电脑连接到同一个 Wi‑Fi，并优先使用 SMB。
PhotoHarbor 不要求你先把照片复制到电脑，也不要求把家中的 NAS 暴露到公网。App 只有在所选远端文件夹通过连接、写入、浏览和轻量读取检查后，才会把它保存为可用目标；本机照片也不会被自动删除。
开始前快速检查
先确认下面七项，可以减少第一次连接时的反复排查。
- 已准备一个专门存放照片和视频的远端文件夹。
- 远端剩余空间足够容纳本次归档内容。
- 知道服务器地址、端口、文件夹路径、用户名和密码，或已经准备好云盘账号。
- iPhone/iPad 能访问目标所在网络；异地连接时已经接入 VPN。
- 已允许 PhotoHarbor 访问需要归档的照片。
- 已确认“仅在 Wi‑Fi 网络下上传”是否符合当前需求。
- 在 PhotoHarbor 显示归档 proof 完成前，不手动删除本机原件。
先确定连接方式
选择存储方式
不同协议需要准备的信息不同。家庭 NAS 或电脑共享目录优先考虑 SMB；已有安全服务或需要异地访问时，再按实际环境选择 WebDAV、SFTP 或云盘。
家庭用户优先推荐
SMB
适合群晖、威联通、飞牛、Windows 共享文件夹和 Mac 文件共享。首次使用最容易配置，通常在同一局域网内使用。需要准备服务器 IP、共享文件夹、用户名和密码，默认端口为 445。
已有 WebDAV 服务
WebDAV
需要服务器地址、端口、文件夹路径、用户名和密码。服务器支持时应选择 HTTPS；HTTP WebDAV 不加密凭据和媒体内容，只应在完全可信的局域网中使用。
熟悉服务器管理
SFTP
需要开启 SSH/SFTP 服务，并准备服务器地址、端口、账号和远端绝对路径。可使用密码或私钥认证；私钥优先采用 Ed25519 或 ECDSA，当前不把 RSA 作为推荐方案。
不依赖家庭局域网
云盘
支持 Google Drive、Dropbox、OneDrive 和百度网盘。在 PhotoHarbor 内完成官方登录，再选择或新建归档文件夹，不需要手动填写 access token。Google Drive 只管理默认 PhotoHarbor 文件夹或用户明确选择授权的文件夹。
按设备完成共享与权限配置
准备 NAS 或电脑
下面的菜单名称可能因系统版本略有不同。每次只需展开你正在使用的平台；无论品牌如何，最终都要确保账号能在目标目录中创建、读取、重命名和删除文件。
群晖 SynologyDSM · SMB
- 登录 DSM，进入“控制面板 → 文件服务 → SMB”，开启 SMB 服务。
- 在“控制面板 → 共享文件夹”中新建或选择专用目录，例如
PhotoHarbor。 - 建议创建专用普通账号，并授予该目录读写权限；不要依赖 Guest 账号。
- 确认账号可以新建、读取、重命名和删除文件。
- 记录 NAS 的局域网 IP、共享文件夹名称、用户名和密码。
威联通 QNAPQTS · SMB
- 登录 QTS，进入“控制台 → 网络和文件服务 → Win/Mac/NFS/WebDAV → Microsoft 网络”，启用 SMB。
- 在“权限 → 共享文件夹”中新建或选择归档目录。
- 为 PhotoHarbor 使用的账号授予读写权限，并限制匿名访问。
- 记录 NAS IP、共享目录、账号和密码；SMB 默认端口为
445。 - 如果设置了主机访问限制，确认 iPhone 所在网段没有被拒绝。
飞牛 fnOSSMB / WebDAV / SFTP
- 进入“设置 → 文件共享协议”，开启 SMB；需要 SFTP 时进入“设置 → SSH”开启服务。
- 在“文件管理 → 我的文件 → 团队文件”中新建专用团队文件夹。
- 创建时允许该目录通过 SMB/WebDAV 等文件共享协议挂载。
- 为使用的账号授予“读写”权限，并确认该账号的文件共享可见范围包含此目录。
- 记录设备 IP、账号和目录原始路径。
macOS文件共享 · SMB
- 打开“系统设置 → 通用 → 共享 → 文件共享”。
- 点击文件共享旁的信息按钮，在“选项”中开启“使用 SMB 来共享文件和文件夹”。
- 勾选允许通过 SMB 登录的 Mac 用户。
- 将归档目录加入共享文件夹，并给予该用户“读与写”权限。
- 记录 Mac 的局域网 IP、共享文件夹名称、用户名和密码；归档期间避免 Mac 进入睡眠。
Windows 11网络文件共享 · SMB
- 将当前网络配置为“专用网络”，并开启网络发现和文件及打印机共享。
- 在文件资源管理器中右键目标文件夹，选择“显示更多选项 → 授予访问权限 → 特定用户”。
- 为专用账号授予读取和写入权限；不建议长期使用无密码或 Everyone 完全控制。
- 确认 Windows 防火墙允许专用网络中的文件共享。
- 记录电脑 IP、共享名称、Windows 用户名和密码；上传期间保持电脑开机。
与 App 表单逐项对应
准备连接信息
先把下面的信息记在手边。主机地址只填写 IP 或域名，不要把共享文件夹或目录路径拼在主机地址中。
| App 字段 | 应填写内容 | 示例 |
|---|---|---|
| 显示名称 | 只用于在 PhotoHarbor 中识别目标 | 家庭群晖 |
| 主机地址 | IP 或域名，不填写文件夹路径 | 192.168.1.20 |
| 端口 | SMB 常用 445、WebDAV 常用 443/80、SFTP 常用 22 | 445 |
| 文件夹路径 | 账号有读写权限的归档目录 | /PhotoHarbor |
| 用户名/密码 | NAS、Mac、Windows 或服务器账号 | 专用普通账号 |
| SMB 域 | 仅在工作组或域环境需要 | 留空或填写实际域 |
| SFTP 认证 | 密码或支持的私钥 | Ed25519/ECDSA |
| 云盘文件夹 | 授权后在 App 中选择 | 无需手工输入 ID |
“检查并保存”会做什么
通过完整的目标能力检查后才会保存
点击“检查并保存”后，PhotoHarbor 会检查是否能够连接、创建测试内容、提交或重命名文件、列出目录并执行轻量读取。测试成功后才保存目标，临时探测内容会尽力清理。页面必须显示“可用于归档”后，再进入下一步。
允许 App 读取所选内容并访问目标
授予系统权限
避免任务因网络策略暂停
检查网络与上传设置
“仅在 Wi‑Fi 网络下上传”默认开启。开启时，如果当前只有蜂窝网络，新建任务仍会创建，但会显示“等待 Wi‑Fi”，接入 Wi‑Fi 或有线网络后自动继续。浏览、预览、播放和删除校验不受这个开关影响。
- iPhone/iPad 与 NAS 或电脑处于同一 Wi‑Fi 或可互通的 VPN。
- 避免使用开启“客户端隔离”的访客 Wi‑Fi。
- NAS、电脑、外接硬盘和目标卷保持在线。
- 归档大视频时连接电源，并避免电脑自动睡眠。
- 云盘账号授权有效，目标文件夹仍存在且可写。
- 若允许蜂窝上传，在“设置”页关闭“仅在 Wi‑Fi 网络下上传”，并留意流量消耗。
确认可以安全开始第一次归档
完成归档前检查
- 目标页面显示“可用于归档”。
- 连接、写入、文件夹浏览和轻量预览检查均已通过。
- 远端目录有足够剩余空间。
- 当前账号拥有创建、读取、重命名和删除权限。
- 已确定本次任务使用的远端文件夹。
- 已理解冲突策略：重命名保留两份、跳过项不会获得 Safe Delete 资格、覆盖需要额外确认。
- 已确认 Wi‑Fi 上传偏好。
- 已理解“上传完成”不等于可以删除；必须等待最终归档 proof 完成，再进入 Safe Delete。
常见失败速查
连接检查没有通过时，先按错误类型排查，不要跳过检查直接开始归档。
- 目标不可达
- 检查 Wi‑Fi、VPN、服务器地址和端口。
- 认证失败
- 检查用户名、密码、SMB 域或 SFTP 私钥。
- 文件夹权限不足
- 换用可写目录，或补齐创建、重命名和删除权限。
- 远端空间不足
- 释放空间或选择其他目录。
- 无法浏览/轻量读取
- 重新运行连接检查；仍失败时改用其他协议或目标，避免进入不完整的 proof 链路。
添加存储目标
存储目标是 PhotoHarbor 用来归档照片和视频的远端位置。添加前请先完成“准备工作”，确认目标目录可以连接并具有读写权限。
基础版可以配置 1 个可写目标；完整版或完整试用期可以配置多个目标。达到数量上限时，App 会先显示升级提示，不会进入添加表单。
- 目标页面
- 点击“+”
- 选择协议或云盘
- 填写信息或授权
- 选择归档文件夹
- 检查并保存
- 等待媒体库准备
打开入口
进入添加页面
- 打开 PhotoHarbor，进入“目标”页面。
- 点击右上角“+”；当前还没有目标时，也可以点击空状态中的添加按钮。
- 输入可选的“显示名称”。它只用于在 App 中识别目标，留空时会自动生成。
- 如果基础版已经配置了一个目标，App 会说明目标数量已达到上限，并提供升级入口。
添加目标不会立即上传任何照片。只有后续创建归档任务并选择照片或视频后，上传才会开始。
确定连接方式
选择目标类型
家庭用户优先推荐
SMB
适合家庭 NAS、Windows 共享文件夹和 Mac 文件共享，通常在同一局域网或 VPN 中使用。
已有 WebDAV 服务
WebDAV
适合已部署 WebDAV 的服务器。服务器支持时应优先选择 HTTPS。
熟悉服务器管理
SFTP
适合已经开启 SSH/SFTP 的 NAS 或服务器，可使用密码或受支持的私钥认证。
无需家庭局域网
云盘
支持 Google Drive、Dropbox、OneDrive 和百度网盘，通过服务商官方页面完成授权。
地址、端口、路径和认证方式会随协议变化，不要直接沿用上一个协议的参数。
对应 App 表单
填写服务器信息
| 类型 | 必填内容 | 特殊设置 |
|---|---|---|
| SMB | 主机、共享文件夹、用户名、密码 | 端口通常为 445；工作组或域环境才填写“SMB 域” |
| WebDAV | HTTP/HTTPS、主机、端口、路径 | HTTPS 通常为 443，HTTP 通常为 80；HTTP 会显示未加密风险提示 |
| SFTP | 主机、端口、远端路径、用户名、认证信息 | 端口通常为 22；支持密码或私钥认证 |
| 云盘 | 官方账号授权、归档文件夹 | 不需要填写服务器密码、access token 或文件夹 ID |
- 主机地址只填写 IP 或域名，不要把归档文件夹路径写进主机字段。
- 路径必须指向当前账号有权创建、读取、重命名和删除内容的目录。
- WebDAV 允许匿名访问时可以不填凭据；一旦填写用户名或密码，两项应配套填写。
- SFTP 私钥支持 Ed25519 和 ECDSA P256/P384/P521。RSA、无法识别的私钥，以及加密但未填写口令的私钥不能使用。
- 密码和 OAuth 凭据保存在设备 Keychain 中，不会提交到 PhotoHarbor 官网。
服务商官方登录
完成云盘授权
选择云盘后，在 PhotoHarbor 内发起官方授权，再确认用于归档的文件夹。无需复制 access token，也无需手工输入 provider 文件夹 ID。
Google DrivePicker 文件夹授权
- 在 Google 官方授权页登录账号。
- 通过 Google Picker 选择允许 PhotoHarbor 管理的归档文件夹。
- PhotoHarbor 只管理 App 创建的默认文件夹或你明确授权的文件夹，不默认浏览整个“我的云端硬盘”。
- 切换 Google 账号后，必须重新授权并重新选择文件夹。
Dropbox授权后在 App 内选目录
- 完成 Dropbox 官方 OAuth 登录。
- 在 App 中浏览、新建或选择归档文件夹。
- 文件夹 ID 由 App 自动保存，不需要手工填写。
OneDrive个人与全球版 Microsoft 365
- 使用个人 Microsoft 账号或全球版 Microsoft 365 工作/学校账号登录。
- 当前暂不支持世纪互联账号。
- 授权后在 App 中浏览、新建或选择归档文件夹。
百度网盘授权、选目录与播放设置
- 完成百度官方授权，再选择归档文件夹。
- 授权失效时，按照 App 提示重新登录。
- 文件夹路径和内部标识由 App 管理，无需手工输入。
重新登录后，应再次确认归档文件夹，再运行“检查并保存”。
技术详情：授权范围和过期时间
App 可能显示 OAuth scopes 和 token 到期时间，供排查授权问题使用。普通用户不需要修改这些值；授权过期时按提示重新登录即可。
协议与账号差异
确认特殊设置
SMB 域
家庭 NAS 通常留空，仅工作组、Active Directory 或企业域环境需要填写。
WebDAV HTTP/HTTPS
优先使用 HTTPS；HTTP 只用于完全可信的局域网，因为凭据和媒体内容不会被传输层加密。
SFTP 认证方式
密码与私钥二选一；只有私钥本身已加密时才填写私钥口令。
云盘账号切换
切换后重新授权，并重新选择与新账号对应的归档文件夹。
百度转码视频播放只影响远端视频播放
- App 会显示百度账号会员状态。
- 超级会员默认自动开启；非超级会员或未知状态默认关闭。
- 用户可以手动覆盖，并通过“恢复默认”回到自动策略。
- 此开关不影响上传、归档 proof 或 Safe Delete 判断。
授权范围和 token 到期时间只用于查看与排障，不需要用户手工编辑。
保存前能力探测
检查并保存
- 1
连接与认证连接服务器，或验证云盘授权仍然有效。
- 2
创建探测内容在目标目录写入小型临时内容，不会读取或上传你的照片。
- 3
写入与提交检查创建、写入、提交或重命名能力。
- 4
浏览与轻量读取检查目录列表、范围读取和轻量预览能力。
- 5
清理并保存尽力清理探测内容，达到最低归档要求后才保存目标和 Keychain 凭据。
可用于归档
连接、写入和提交能力满足要求，可以进入下一步。
可用于归档，但部分能力受限
目标可以保存，但文件夹浏览或轻量预览可能受限。具体项目能否进入 Safe Delete，仍取决于归档任务最终 proof。
检查失败
目标不会保存。请按照提示修正地址、认证、目录权限、远端空间或协议。
极少数云盘或服务器可能短暂保留探测目录，但这不代表照片已经开始上传。
检查失败速查
先按错误类型修正，再重新运行“检查并保存”。
- 找不到服务器
- 检查 Wi‑Fi、VPN、地址和端口。
- 认证失败
- 检查账号、密码、SMB 域、OAuth 登录或私钥。
- 无法写入/提交
- 补齐创建、重命名和删除权限。
- 无法浏览
- 检查目录权限；若 App 显示降级可用，应理解浏览功能可能受限。
- 无法轻量读取
- 重试连接或更换协议；“已上传”不等于已获得 Safe Delete 资格。
- 云盘授权失效
- 重新登录并重新选择归档文件夹。
保存后的自动流程
确认建库状态
如果目标里已经有照片或视频
保存成功后，PhotoHarbor 会先扫描目标中已有的文件夹，记录可以浏览的照片和视频，再按浏览时最先会看到的内容准备缩略图。整个过程自动开始，不需要手动设置。
已有媒体不会等待全部缩略图生成完成后才显示。App 会先准备第一批常用内容；达到可以浏览的条件后，你就能进入媒体库，App 会继续在后台补齐其余缩略图。
- 扫描已有文件夹从所选归档目录开始，逐层查找其中的文件夹；系统目录、回收站和快照目录会按规则跳过。
- 识别照片和视频记录媒体所在文件夹和基本信息，目标详情中的目录数、媒体数会随着扫描逐步增加。
- 安排生成顺序不会一次性处理所有文件，而是把用户最可能先看到的目录和媒体排在前面。
- 准备首批缩略图优先准备根目录和一级文件夹的封面、首批可见媒体，以及每个文件夹的第一张代表图片。
- 先开放媒体库第一批内容准备好并达到可以浏览的条件后，即可进入媒体库，无需等待整个目标处理完。
- 后台继续补齐剩余照片和视频的缩略图继续在后台生成；你可以离开目标详情页，正常使用 App。
更快显示已有媒体
针对不同存储的缩略图优化
PhotoHarbor 会根据目标类型，优先使用存储服务已经准备好的小图，减少为显示媒体库而读取完整照片或视频。整个过程自动完成，无需手动设置。
Google Drive、Dropbox、OneDrive 和百度网盘
优先使用网盘已经准备好的小图；如果服务暂时没有提供，App 会自动改用通用方式生成浏览用缩略图。
群晖 NAS
识别到群晖设备后，优先读取设备已经生成的照片和视频小图；没有可用小图时自动改用通用方式。
威联通 NAS
识别到威联通设备后，优先读取设备文件服务中已有的小图，减少重复读取较大的远端原文件。
飞牛 NAS
对于已由飞牛相册管理的目录，优先使用飞牛相册准备的小图；其他目录仍会自动改用通用方式。
这些优化只影响媒体库的显示速度，不改变目标保存结果、照片和视频原件，也不改变后续的安全删除判断。
正在扫描文件夹
App 正在确认目录结构。此时目录数会先增加，媒体数量可能仍然较少。
正在发现媒体
App 已开始识别照片和视频，媒体数量会持续更新，不必停留在当前页面等待。
正在准备首批缩略图
正在处理最先用于目录封面和媒体库首屏的内容，完成后会优先开放浏览。
正在获取剩余缩略图
媒体库已经可以使用，后台继续补齐其余小图；网络速度和媒体数量会影响完成时间。
进度与控制
目标详情显示目录、媒体和缩略图进度，并提供暂停、继续、取消、重试或重新扫描。
哪些文件夹会被跳过
系统目录、回收站、快照或看起来异常的目录可能被跳过。可在“扫描排除项”查看原因，并按需选择“仍然扫描”或恢复默认。
缩略图从哪里来
PhotoHarbor 会先使用存储设备或云盘已经准备好的小图；如果没有，再从照片或视频中生成浏览用小图。这个过程不需要手动设置，也不会修改远端原文件。
为什么有时比较慢
文件夹很多、视频较大、网络较慢，或存储设备正在休眠时，扫描和生成缩略图会花更长时间。连接恢复后可以继续或重新扫描。
个别缩略图失败
原照片或视频仍保存在目标中，目标也仍然保存成功。可以稍后重试或重新扫描失败的部分。
已经有缓存时
App 会优先使用之前已经准备好的缩略图，减少重复读取远端文件并更快显示媒体库。
保存目标和自动建库都不会自动创建归档任务、上传本机照片或删除本机原件。
创建归档任务
归档任务决定把哪些 iPhone 或 iPad 照片和视频写入哪个存储目标、哪个远端文件夹，以及遇到同名文件时如何处理。目标、文件夹和冲突策略只对当前任务生效，不会修改已经保存的存储目标配置。
完成照片选择后，任务才会进入后台队列。创建任务、上传完成或看到媒体库缩略图，都不会自动删除本机原件；只有最终归档证明完成后，相关项目才可能进入 Safe Delete。
- 归档任务
- 新建上传
- 选择目标
- 选择或新建文件夹
- 设置同名文件策略
- 选择照片和视频
- 创建后台任务
第一次创建前检查
先确认下面七项，再开始第一次小批量归档。
- 存储目标仍显示可用于归档。
- NAS、电脑、云盘账号和目标磁盘当前在线。
- 远端目录有足够空间，并允许创建、读取、重命名和删除文件。
- PhotoHarbor 可以访问准备归档的照片。
- 已确认“仅在 Wi‑Fi 网络下上传”是否符合当前需求。
- 开启“优化 iPhone 储存空间”时，当前网络可以下载 iCloud 原件。
- 第一次建议先选择少量照片、视频和 Live Photo，完整走通归档证明后再创建大批量任务。
从归档任务或媒体库进入
开始新建上传
- 打开 PhotoHarbor，进入“归档任务”页面。
- 点击右上角“新建上传”；没有任务时也可以点击空状态中的“开始归档”。
- App 会先检查照片访问权限。若权限被拒绝，按提示打开系统设置并重新授权。
- 如果尚未配置可写目标，App 会提示先完成“添加存储目标”，不会直接打开照片选择器。
- 也可以在“媒体库”中的文件夹模式进入某个文件夹，点击“上传到这里”。这种入口会自动预选当前目标和文件夹，后续仍需选择冲突策略和照片。
PhotoHarbor 会先让你确定远端位置和同名文件处理方式，最后才打开系统照片选择器。
确定本次任务写入哪里
选择归档目标
完整版或完整试用期
可以从所有已配置的可写目标中选择。
基础版
每天可以归档 50 项，并只能从最早配置的一个可写目标创建任务。
试用期结束后
其他目标仍可用于浏览，但不能用于新建上传，除非解锁完整版。
不支持目录浏览
该目标不能完成归档文件夹选择。请重新检查目录权限或更换协议。
选择目标只决定当前任务写入哪里，不会改变目标保存时的根目录。
NAS 休眠、电脑关机、VPN 断开、云盘授权失效或权限变化都可能让目标暂时不可用。创建任务时会重新确认当前连接条件。
确认本次任务的具体目录
选择远端文件夹
- 点击目标后，从目标根目录开始浏览远端文件夹。
- 可以继续进入已有子文件夹，也可以直接选择当前目录。
- 当前账号允许创建目录时，可点击“新建文件夹”，输入名称后进入新目录。
- 页面底部会显示本次选择的相对路径；确认无误后点击“选择当前位置”。
- 从媒体库“上传到这里”进入时，当前浏览目录会自动成为本次任务文件夹。
不会修改目标根目录
任务文件夹始终位于已保存的目标根目录之内。
建议使用独立目录
可按年份、事件或项目整理，避免把大量文件直接写入 NAS 根目录。
任务期间保持路径稳定
归档和证明生成期间，不要在 NAS、电脑或云盘后台重命名、移动或删除该文件夹。
新建失败时
检查连接、文件夹名称、同名目录和账号的创建权限。
决定同名文件如何处理
设置同名文件策略
默认推荐
重命名重复文件
远端已有同名文件时，为新上传文件追加数字后缀，同时保留新旧文件。新文件会按照实际保存路径建立归档证明。
保留远端原文件
跳过重复文件
远端同名文件保持不变，本次项目不会提交为新的归档副本。被跳过的项目不会获得本次任务的归档证明，也不会进入 Safe Delete。
需要再次确认
覆盖重复文件
用本次上传替换远端同名文件，并在证明记录中保存覆盖策略。PhotoHarbor 不保证可以恢复被替换的旧文件。
它不会修改存储目标，也不会自动应用到下一次上传。不能确定时选择“重命名重复文件”。
使用系统照片选择器
选择照片和视频
- 确认冲突策略后，系统照片选择器才会打开。
- 可以选择普通照片、视频和 Live Photo。
- 点击取消或没有选择任何内容时，不会创建任务。
- 完成选择后，PhotoHarbor 会读取所选项目的资源信息并准备后台任务，不需要先手工复制到“文件”App。
理解任务进度
素材数与资源数可能不同
普通照片
通常对应一个主要图片资源。
视频
对应一个需要上传和验证的视频资源。
Live Photo
Live Photo 会把静态照片和动态视频作为一个成组素材处理，因此一项 Live Photo 通常产生两个资源。
任务卡中的项目数与资源进度可能不同，这是正常现象；Safe Delete 必须等待成组资源全部完成证明。
额度按照片选择器中的项目数量计算。完整试用期和完整版不受该每日额度限制；超过剩余额度时，可以减少选择数量后重新创建任务。
照片权限与 iCloud 原件首次大批归档前建议检查
- 完整照片访问最适合首次大批归档。
- 使用有限访问时，只能处理系统当前允许 PhotoHarbor 读取的项目；需要时到系统设置扩大授权范围。
- 开启“优化 iPhone 储存空间”后，部分原件可能只在 iCloud。归档大视频或大量 iCloud 原件时，应保持稳定网络、电量和足够本机临时空间。
- 无法取得原件或 Live Photo 成组资源不完整的项目会进入需要关注状态，不会伪装成归档成功。
照片选择完成后的系统处理
确认创建条件
- 确认目标确认所选存储目标仍然存在。
- 读取资源读取照片、视频和 Live Photo 的资源清单。
- 估算任务计算预计资源数量和总体积。
- 准备目录确认远端路径并准备所需文件夹。
- 重新连接在当前网络允许上传时连接目标。
- 进入队列创建任务记录并加入可处理资源。
- 保留阻断无法读取的项目会显示明确失败原因。
当前允许上传
目标连接成功后，任务进入“正在进行”。
等待 Wi‑Fi
仅在 Wi‑Fi 下上传且当前只有蜂窝网络时，任务仍会创建；接入 Wi‑Fi 或有线网络后自动继续。
连接或目录准备失败
App 会显示地址、认证、权限或空间错误，不会把尚未成立的任务显示为正常上传。
照片选择已经变化
照片被删除、授权范围变化或系统无法重新取得项目时，需要返回照片选择器重新选择。
任务记录会持久保存。系统允许时上传会继续，App 再次进入前台后也会接管未完成任务。大批量归档时建议设备接电，并避免强制退出 App。
读懂任务卡和下一步
查看任务创建结果
正在进行
资源已经进入上传和归档证明队列。
等待 Wi‑Fi
任务已创建，但上传策略正在等待允许的网络。
需要关注
部分资源遇到 iCloud 原件、权限、网络、认证、空间或远端读取问题。
已完成
队列已经结束；是否可以删除仍以最终 proof 和 Safe Delete 状态为准。
蓝色上传进度
蓝色进度表示按已上传字节计算的上传推进。
绿色证明进度
绿色进度表示已完成归档证明检查的收口进度。
资源终态数量
右侧数量表示已经进入终态的资源数，不等同于照片选择器中的素材数。
- “详情”可以查看每项照片、视频或 Live Photo 的体积、执行结果、proof 状态和冲突处理结果。
- 运行中的任务可以暂停；暂停后可以继续。
- 可恢复错误会显示“重试”，只重跑仍需处理的资源。
- 只有已暂停或已结束的任务可以从任务列表移除。
“删除任务”只会移除本机任务列表和相关本地执行记录，不会删除远端文件、既有证明历史或本机照片，也不能代替 Safe Delete。
常见失败速查
先按当前界面显示的问题处理，再重新创建或继续任务。
- 没有可选目标
- 先添加并检查一个可写存储目标。
- 目标没有出现
- 检查基础版目标限制、目标是否仍存在，以及当前目标是否可写。
- 不能浏览文件夹
- 重新运行目标检查，补齐目录浏览权限或更换协议。
- 新建文件夹失败
- 检查名称、同名目录、连接状态和创建权限。
- 无法访问照片
- 到系统设置更新完整或有限照片访问权限。
- 超过每日额度
- 减少本次选择数量，或升级完整版。
- iCloud 原件不可用
- 连接稳定网络，保证电量和临时空间后重试。
- 目标认证或写入失败
- 检查账号、密码、OAuth、VPN、目录权限和远端空间。
- 显示“等待 Wi‑Fi”
- 这不是创建失败；接入 Wi‑Fi，或在设置中关闭“仅在 Wi‑Fi 网络下上传”。
等待归档证明
归档 proof 是 PhotoHarbor 对远端副本完成当前归档证明策略后的结果。它不是上传进度的别名：上传完成”不等于“可以安全删除”。
任务可以在后台继续推进，但在 proof 完成前，请保留本机原件，也不要在 NAS、电脑或云盘中移动、重命名或删除本次任务的远端文件。
- 上传
- 上传回执
- 提交到最终路径
- 轻量预览检查
- 最终归档证明
- 可进入 Safe Delete
先理解什么是归档证明
proof 是远端副本的可用证明
它表示远端文件已经经过当前策略要求的大小、可读性与预览性检查。只有通过 proof 的资源才会被记录为后续 Safe Delete 的依据。
文件已经传到远端，不代表所有后续检查均已结束。请以任务详情里的 proof 状态为准，不要仅凭上传百分比删除本机照片。
查看任务正在经过的阶段
上传与上传回执
App 传输本机资源，并确认远端暂存内容的基本大小与可读状态。
提交到最终路径
暂存内容被移动或提交到本次任务选定的归档文件夹；同名文件策略在这一阶段生效。
轻量预览检查
App 读取少量远端内容，确认可以建立用于浏览的基础预览。
最终归档证明
完成远端大小与可读性验证后，写入 proof 记录；通过后才会继续判断 Safe Delete 资格。
理解任务卡上的进度
蓝色进度
表示按已上传字节计算的上传推进。大视频会在传输过程中持续变化。
绿色进度
表示已完成归档证明检查的收口进度；它通常会落后于蓝色上传进度。
x/x 资源数量
表示已进入终态的资源数量，不等同于照片选择器中的素材数量。一个 Live Photo 需要静态照片和动态视频都完成处理。
理解 proof 检查了什么
proof 会确认远端文件大小、可读性与当前可用的校验依据；它不默认等同于远端全文逐字节校验。这样可以在可靠性与大文件等待时间之间取得平衡。
技术说明：当前 proof 策略
支持的存储会优先使用服务商提供的校验和。其他目标会在本机临时文件可用时，对远端头部、中段和尾部做抽样读取；只有本机临时文件已不存在且保留了校验和时，才会回退为流式读取远端文件完成校验。
无论采用哪种依据，任务还需要通过轻量读取与预览检查。proof 的含义始终是“满足当前归档证明策略”，而不是默认承诺每个文件都已全文逐字节比对。
处理等待、阻断与失败
等待 Wi‑Fi 或已暂停
接入允许的网络后会继续；手动暂停的任务需要在任务页点击继续。
iCloud、权限或资源组问题
保持网络、电量与照片权限；Live Photo 的静态照片和动态视频必须都可取得，缺失的一侧不会伪装为成功。
认证、空间、网络或远端读取失败
检查目标在线状态、VPN、账号、空间和目录权限；可恢复错误使用“重试”只处理仍需收口的资源。
预览失败或跳过重复文件
预览失败会阻断 proof；被冲突策略跳过的项目不会进入 Safe Delete，应保留本机原件或改用重命名重新归档。
proof 完成后再决定是否释放空间
普通照片、视频以及 Live Photo 的全部必要资源均完成 proof 后，相关素材才可能出现在 Safe Delete。失败、跳过或远端已删除的项目不会获得资格。
安全删除
Safe Delete 是在你决定释放 iPhone 或 iPad 空间时使用的本机删除流程。它只处理本机照片库副本，不会删除 NAS、电脑或云盘中的远端原件。
请先查看候选和 proof，再决定是否发起删除。远端文件、归档任务和 proof 历史不会因为删除本机副本而被移除。
先从 Safe Delete 候选开始
打开 Safe Delete 后，页面会把可复核候选与被阻断项目分开显示。没有候选时，通常表示 proof 尚未完成、资源不完整，或本机照片已经不在照片库中。
即使项目符合资格，PhotoHarbor 也不会自动删除本机照片；每次删除仍需要你主动确认。
查看候选、proof 与阻断原因
可删除候选
显示本机素材、所属目标、proof 状态与预计可释放空间。打开详情可查看对应的远端路径和证明记录。
Live Photo 成组判断
Live Photo 的静态照片和动态视频都必须具备有效 proof；其中任意资源缺失、失败或已被标记远端删除，整组都不会进入候选。
阻断项目
proof 未完成、冲突时跳过、远端副本已删除、资源组不完整或照片权限状态变化时，会显示原因而不是允许删除。
“删除照片”默认复用已有 proof
点击“删除照片”时，App 默认复用已保存的 proof 来准备删除确认，不会为了开始确认而自动重新读取远端文件。这让你在 NAS 离线或不在家时，仍能基于已完成的归档证明进入复核。
需要更强确认时，再主动再次校验
如果你希望确认远端副本此刻仍然可读，请使用“再次校验”。它是额外复核，不是默认删除流程的隐含步骤。
按需主动再次校验远端
- 在 Safe Delete 中选择“再次校验”。
- App 重新连接目标并检查候选资源的远端可读性。
- 通过的项目进入本次删除确认；未通过的项目保留为阻断，不会被删除。
当候选来自多个目标时，能连接并通过检查的项目可以继续；认证失效、VPN 断开或远端读取失败的项目不会混入确认列表。
完成双确认后才删除本机副本
准备确认
App 汇总即将删除的项目数量与预计释放空间，并生成短时有效的确认状态。
再次确认
在确认对话框中核对内容后，才会向 iOS 照片库请求删除本机照片。
遇到变化则停止
确认过期、候选变化或 proof 失效时会阻断操作，需要重新回到候选列表确认。
理解删除后的结果与常见阻断
删除完成后，本机项目从系统照片库移除，PhotoHarbor 会记录删除历史与释放空间。iOS “最近删除”的保留和恢复规则由系统照片库决定，PhotoHarbor 不承诺可恢复期限。
不能删除时怎么办
- proof 未完成
- 返回归档任务，等待或重试失败资源。
- 远端副本已删除
- 该 proof 已不能作为删除依据；请重新归档并完成 proof。
- 再次校验失败
- 检查网络、VPN、认证和远端文件可读性，未通过项目不会被删除。
- 确认已过期或候选变化
- 重新打开候选并再次发起删除确认。
浏览与恢复
媒体库用于继续浏览、预览、分享或恢复远端照片和视频。它不会因为你打开、播放或看到缩略图而自动上传本机内容，也不会自动删除本机原件。
浏览体验会优先使用已准备的缩略图和缓存；缓存预览不能替代远端原件，也不能单独作为 Safe Delete 的依据。
先理解媒体库中的两类内容
已归档并有 proof 的项目
这些项目来自 PhotoHarbor 的归档记录。只要远端副本仍有效，相关 proof 可用于后续 Safe Delete 判断。
扫描发现的远端媒体
这些是 App 在目标中发现的已有文件，可以浏览、预览、分享或保存回 iPhone，但不因此获得 Safe Delete 资格。
按时间或文件夹浏览
时间线浏览
按年、月、日查看远端媒体，适合回顾拍摄时间与快速定位最近归档的内容。
文件夹浏览
从目标根目录进入目录，适合按项目、年份或 NAS 原有结构查看文件；进入具体目录后也可使用“上传到这里”。
建库仍在进行时
扫描和缩略图准备达到可浏览条件后即可先进入媒体库，剩余内容会在后台继续补齐，不需要一直停留在目标详情页。
正确理解缩略图、预览与原件
缩略图
用于快速展示网格和目录封面。App 会优先复用已准备的小图，必要时再从远端生成。
预览与播放
打开项目后会按需读取远端内容。网络慢、设备休眠或授权失效时可能需要等待、重试或重新连接。
个别缩略图失败
不直接代表原照片或视频损坏；可稍后重新打开预览、重新扫描或等待网络恢复后重试。
缓存用于加快再次浏览，不是另一份可用于 proof 或 Safe Delete 的远端备份。
把远端素材保存回 iPhone
- 打开照片、视频或 Live Photo 的预览页，选择“保存回 iPhone”。
- App 从远端准备所需资源，并请求系统照片库的添加权限。
- 保存完成后，新副本会出现在 iPhone 或 iPad 的照片库中；网络中断或权限被拒绝时不会显示为成功。
Live Photo 会成组恢复
保存 Live Photo 时，PhotoHarbor 会同时准备静态照片和动态视频，并作为一组写入系统照片库；其中一项不可用时会提示失败，不会伪装成完整 Live Photo。
谨慎删除远端文件或文件夹
它直接作用于 NAS、电脑共享目录或云盘中的原始文件，不能替代 Safe Delete，也不会删除本机照片。删除前必须确认目标、当前目录和所选项目。
如果删除的是已归档副本，相关远端 proof 将不再可用于 Safe Delete；本机照片会保留，但需要重新归档并完成 proof 后才能再次进入安全删除候选。正在使用该目录的可恢复归档任务也应先完成、暂停或移出该目录。
按需使用官方网页播放
实验性功能：打开云盘官方播放页面
当设置中已开启官方网页播放，并且对应目标是 Dropbox、Google Drive 或 OneDrive 时，视频预览页可提供打开服务商官方网页的入口。
该入口依赖你在 Safari 中已有的服务商登录状态，不会创建公开分享链接，也不保证服务商网页一定能够播放、预览或保持登录。它只用于辅助浏览，不参与上传、proof 或 Safe Delete 判断。
