支持与帮助 — 潜历

潜历的数据保存在你的设备中。更换设备或删除 App 前，请先导出 ZIP 备份，并确认文件已保存到可再次取得的位置。

1. 联系我们

潜历支持：support@redox.studio

反馈时请描述操作步骤、预期结果和实际结果，并提供 iPhone 型号、iOS 版本及潜历版本。App 版本可在“行程 → 右上角齿轮 → 设置 → 关于 → 版本”查看。截图可遮去不相关的个人信息；无需默认发送整份备份或原始照片。

2. 数据与备份

数据存在哪里？

行程、潜次、照片、待办、自定义模板和收藏保存在当前设备。潜历没有账号，也没有自己的 CloudKit 同步。跨设备使用 ZIP 备份与恢复，不会自动合并两台设备的后续修改。

如何导出 ZIP？

打开“行程”，点击右上角齿轮进入“设置”。
找到“存储与备份”，按需要保留“导出时带上照片”（默认开启）。
点击“导出 ZIP 备份”，等待生成，再在系统“文件”界面选择保存位置。
看到“备份已保存，可在「文件」App 中查看。”后，在“文件”中确认 qianli-backup-v3.zip 已存在。取消系统保存界面不算备份完成。

备份包含行程、潜次、笔记、待办、自定义待办模板、收藏、照片说明及可选照片。不包含出发地、证书等级、默认模板选择和全局提醒设置。ZIP 未加密，请妥善保管。

如果出现“部分照片未能导出”，可取消并检查照片，也可选择“继续导出已有内容”。后者保留缺失照片的说明，但不包含其图片文件。

如何恢复或换设备？

把备份保存到新设备可访问的位置，例如通过“文件”、AirDrop 或你使用的云盘转移。
在新设备的潜历中进入“行程 → 齿轮 → 设置 → 存储与备份”，点击“从 ZIP / JSON 恢复”。
选中潜历备份，阅读“恢复预览”中的新增、重复、缺图和未知目的地提示，再点击“确认恢复”。
完成后检查行程和照片；重新设置个人偏好，并按需开启各行程的“出发提醒”。

恢复按记录编号去重。已有行程的文字、潜次、待办及照片说明不会覆盖，仅补齐同一照片的缺失文件；收藏按目的地去重，自定义模板按编号去重。再次导入同一份备份不能用来覆盖另一台设备上的旧行程。

旧版潜历 ZIP 和 JSON 可以恢复；JSON 只能恢复记录和照片说明，图片需要包含照片的 ZIP。新恢复行程的提醒默认关闭。格式不兼容、文件损坏或记录冲突时，按页面提示处理；不要手动修改 ZIP 清单来绕过检查。

删除 App 前需要备份吗？

需要保留数据就先备份，并把文件放在不依赖潜历 App 容器的位置。iOS 的“删除 App”会删除本地数据；“卸载 App”保留文稿与数据，“从主屏幕移除”只是移除图标。设备备份由 Apple 或电脑管理，不能替代你确认 ZIP 可用这一步。

3. 通知

怎样开启出发提醒？

在“设置 → 通知”打开“通知”总开关，在“出发前提醒”选择 30／7／1 天前的节点及提醒时间；然后进入具体行程，打开“出发提醒”。单行程开关默认关闭。存在未来提醒时刻时，按系统提示允许通知。

为什么没有出现提醒？

检查 App 总开关、单行程开关，以及是否至少选中一个提醒节点。
查看行程“出发提醒”下方的状态。已过去的提醒时刻会跳过；当天或过近的行程可能没有可安排的提醒。
如果显示尚未获得权限，点击“打开系统通知设置”检查授权；也检查系统的专注模式、通知摘要和通知显示设置。
如果显示安排失败，点击“重试提醒”。ZIP 恢复的行程需要重新开启提醒。

提醒在本机安排，不依赖潜历远程 Push 服务器。是否即时展示还受 iOS 的通知设置影响。

怎样关闭提醒？

只关闭一趟旅行：进入该行程，关闭“出发提醒”。关闭全部：在潜历“设置 → 通知”关闭总开关，待发送提醒会取消，行程页的提醒区域隐藏。每趟行程原来的开关会保留，重新打开总开关后会按保留设置重新安排。

4. 照片

如何添加，照片会上传吗？

进入行程详情的“照片”区域，点击“添加照片”，从系统选择器挑选。潜历只处理选中的照片，按系统交付的文件字节与格式在本地保存，不自行上传。iCloud Photos 中尚未下载的照片可能需要 Apple 系统服务联网取回。

删掉相册原图后，潜历里的照片还在吗？

成功导入并保存后会保留独立副本，删除系统相册原图不会同步删除潜历中的照片。反过来，点击潜历照片右上角“删除”并确认，也不会删除系统相册原图。

为什么导入失败或看起来不够清晰？

列表显示缩略图，可轻点查看大图。导入失败时检查图片是否可从系统相册打开、设备空间是否足够；若为云端照片，检查网络。可使用“重试未导入的照片”。单张文件上限为 32 MiB，最长边为 12,000 像素；RAW／ProRAW 等不支持的格式会拒绝导入，不会静默降低质量。

旧版本已经保存的压缩照片不会自动变回原图。新的照片保存系统提供的版本；App 不会主动清除其中的 EXIF／GPS 元数据，带照片备份也会保留相同文件，请在转交备份前留意。

如何保存或分享卡片？

从行程详情右上角分享入口进入，预览卡片后点击“保存图片”或“分享”。前者需要系统“添加照片”权限，后者打开系统分享面板。分享卡片是生成的图片，不是完整行程备份。

5. 行程与潜水记录

点击“行程”页加号添加行程，选择目的地、开始／结束日期、活动与待办模板。所有行程均可写笔记、处理待办、添加照片和“记一潜”，无需切换为“已去”。

为什么过去的行程没有计入潜水记录？

日期经过不代表实际潜过水。潜水记录只统计有已发生潜次的行程；在行程详情点击“记一潜”填写实际记录，新潜次不能保存未来日期。只有照片、笔记或待办的行程不计入潜水履历。

如何删除？

整趟行程：进入详情底部，点击“删除这段行程”并确认。关联潜次、待办和照片一起删除，提醒也会取消。
单条潜次或待办：在行程详情对应行上向左滑动，点击“删除”。
照片：点击照片右上角“删除”并确认。
自定义模板：在“设置 → 行程 → 待办模板”打开模板，选择“删除这个模板”。系统内置模板只读；修改或删除自定义模板不改变已有行程的待办快照。
收藏：打开目的地详情，再点右上角已选中的收藏按钮取消收藏。

App 没有回收站。删除前如需保留，请先备份；删除操作不会清除你已导出的 ZIP 或已保存到系统相册的分享图片。

6. 定位与外部地图

添加行程时，“距你最近的潜点”使用可选的定位权限，在本机按距离排序。拒绝定位后仍可手动搜索目的地。

在目的地详情的“地图查找”中，点击“查找当地潜店”或“查找当地住宿”，再选择地图服务。中国大陆目的地可选高德、百度或 Apple，其他目的地可选 Google 或 Apple；没有可用的原生地图入口时会打开网页。

潜历传递目的地名称和搜索词，不传递附近排序得到的当前位置，也不传递你的行程或照片。打开后由地图服务处理搜索和其自身的权限；潜历不维护潜店或酒店名单，不保证外部结果。跳转失败时可选择另一地图服务，或检查相应 App、浏览器与网络。

7. 常见问题

没有账号，怎么找回丢失的数据？

恢复意味着从你持有的 ZIP／JSON 备份重新导入，或由你使用可用的系统设备备份。Redox Studio 没有你的本地数据库副本，无法通过邮箱登录或服务器找回。没有可用备份时，无法保证恢复。

不联网还能用吗？

目的地目录、季节资料、筛选、行程及已导入的照片可离线使用。外部地图和资料链接、云端相册原图、云盘中的备份文件可能需要联网；App 不提供实时天气、海况或票务 API。

备份为什么没有带上所有设置？

ZIP 用于迁移记录，不包含个人偏好。恢复后请重新检查出发地、证书等级、默认模板和全局通知规则。自定义模板的内容会恢复，但默认选中哪个模板需要重新设置。

支持哪个系统版本？

当前潜历 1.0 的最低系统要求是 iOS 26.0。