Time Atlas：首次设置与备份指南

适用于 2.1 版。正式地址：打开 Time Atlas。

先分清三种保存

日常只需确认顶部出现“云端已保存”，不用每天导出文件。 JSON 是额外的独立副本；删除记录也会同步删除，所以自动同步与独立文件备份的用途不同。

一、第一次设置

情况 A：已经在里面记过时间

1. 继续使用原来的入口：以前从主屏幕图标进入，现在也从那个图标进入；以前一直用 Safari，就先在原来的 Safari 页面操作。不要卸载、清除网站数据或另换浏览器。
2. 保持联网，关闭再重新打开 App，确认“设置”底部显示 TIME ATLAS / 2.1。如果刚更新时自动刷新一次，等待完成即可；更新不需要删除记录。
3. 查看顶部状态。如果已经显示“云端已保存”，首次连接已完成，直接跳到“日常使用”。
4. 如果显示“连接云存储”，回到本聊天，长按之前的“专属连接链接”，选择“复制链接”。注意复制的是完整链接，不是“专属连接链接”这几个字。
5. 返回你原来的 Time Atlas → 点底部“设置” → 展开“连接设备”。
6. 把完整链接粘贴进输入框 → 点“连接” → 在确认窗口点“连接此设备”。
7. 保持页面打开几秒。等顶部出现“云端已保存”，本机已有的活动和记录才算已确认保存到云端。也可以在“设置 → 自动云保存”查看状态。
8. 若链接提示已使用或已过期，不能再次使用它；告诉我“请给我一个新的 Time Atlas 设备连接链接”，我会通过你的 Cloudflare 账号重新签发。请勿把链接转发给别人。

情况 B：还没有正式开始记录

1. 用 iPhone Safari 打开正式地址，不使用无痕模式或聊天软件内置浏览器。
2. 点“分享”（方框向上箭头）→“添加到主屏幕”。部分 Safari 布局需先点页面菜单或“更多”，再点“分享”。
3. 如果出现“作为 Web App 打开”，开启后点“添加”。如果分享菜单没有“添加到主屏幕”，在“编辑操作”中添加它。
4. 回主屏幕，从新图标打开 Time Atlas。以后固定用这个入口。
5. 按上面情况 A 的第 4–7 步，在这个主屏幕 App 内完成连接。
6. 先添加一个测试活动，计时几秒后停止，确认报告中有记录，并等待顶部“云端已保存”。

Safari 和主屏幕 App 的本机数据及连接状态可能各自独立。在 Safari 连接成功，不代表主屏幕 App 也已连接；要在实际记录的入口完成连接。

参考：Apple：将网站添加为主屏幕 App。本次没有操作你的 iPhone，具体菜单位置可能随系统版本不同。

二、添加活动与预设颜色

1. 点底部“活动”。
2. 输入名称，例如“阅读”。
3. 点颜色按钮，展开预设面板。
4. 先选色系：默认、灰、棕、橙、黄、绿、蓝、紫、粉、红。
5. 再选浅色、标准、深色；一共 30 种组合，无需取色器。
6. 点“添加”。回到“计时”，点这个活动即可开始。
7. 已有活动想改颜色：在“活动”列表找到它 → 点该行“颜色” → 选预设 → 点“保存颜色”。计时卡片与统计图会使用这个颜色；改色不会删除历史记录。

默认使用白色界面；想用黑色时，到“设置 → 外观”选“深色”。

三、日常使用与自动保存

1. 在“计时”点活动开始；可以再点其他活动并行记录。停止其中一项不影响另一项。
2. 开始、停止、新增活动、改颜色或删除后，App 会自动尝试同步。大部分时间不需要点“立即同步”。
3. 顶部显示“云端已保存 · 时间”表示服务器已确认保存；显示“本机已保存”只表示本机保存。
4. 显示“离线”时仍可记录。恢复联网并打开 App，等待自动补传。iOS 不保证完全关闭 App 后还能后台上传。
5. 显示“待同步”时，先保留本机数据，检查网络；在“设置”点“立即同步”，稍候查看状态。不要为了解决同步问题而清除网站数据。
6. 报告支持日、月、年和自定义范围。自定义结束日期包含当天。并行时长分别累计；饼图按累计活动时长计算比例。

四、手动保存一份 JSON 文件（可选）

这一步是额外保险，尤其适合换设备前、批量删除前，或你想保留某一天的独立副本时；无需每天进行。

方法 1：使用“存储到‘文件’”

1. 在 Time Atlas 点“设置”→展开“导入 / 导出”。
2. 如果有“存储到‘文件’”按钮，点它。
3. 在系统分享菜单选择“存储到‘文件’”。
4. 选择 iCloud Drive 或“我的 iPhone”中的文件夹。想换手机后也能找到，建议选 iCloud Drive。
5. 可以新建 Time Atlas 备份 文件夹，再点“存储”。
6. 打开 iPhone“文件”App，进入刚才的位置，确认存在 time-atlas-日期.json。同一天保存多份时，可在文件名后加上时间。

这个按钮仅在浏览器支持系统文件分享时出现；如果没有，用方法 2。

方法 2：使用“导出 JSON”

1. 在“设置 → 导入 / 导出”点“导出 JSON”。
2. Safari 可能弹出下载确认，或显示文件预览；按实际界面选择“下载”，或点分享后“存储到‘文件’”。
3. 若下载完成，打开 Safari 下载列表，或到“文件 → 浏览 → 下载项”查找。具体文件夹取决于 Safari 的下载位置设置。
4. 把文件移动到你想长期保留的位置，例如 iCloud Drive / Time Atlas 备份。
5. 再用“文件”App 确认文件存在、大小大于 0。按钮显示已请求下载，并不等于你已经把文件存到想要的位置。

JSON 里是你的活动、时间记录和导出时间，没有 Cloudflare 账号令牌或设备连接凭证。它不是图片，也不是安装包；不要把私人备份上传到公开的网站部署区。文件中的记录是明文，请自行妥善保管。

五、换手机或记录不见了，怎样恢复

优先从云端恢复

1. 确认旧设备曾经显示“云端已保存”。没有同步成功的离线记录仍只在旧设备。
2. 在新手机安装主屏幕 App，并打开一次。
3. 向我申请一个新的设备连接链接。旧链接只能用一次，不能当作永久登录链接。
4. 在新 App 的“设置 → 连接设备”粘贴链接，确认连接。
5. 等云端数据恢复后，查看活动列表和报告中的历史日期。

从 JSON 文件恢复

1. 如果当前 App 还有记录，先导出一份当前 JSON，避免恢复错误文件后难以回退。
2. 点“设置 → 导入 / 导出 → 导入 JSON”。
3. 从“文件”中选此前保存的 .json 文件。
4. 查看预览中的活动数量、记录数量是否符合预期。
5. 确认后点“确认恢复”。这会替换本机记录；已连接云端时，恢复结果还会参与云端合并同步，另一设备独有的记录可能保留，所以它不是全账户的强制回滚按钮。
6. 检查报告日期和计时状态，等待“云端已保存”。

正在计时的记录会保留原开始时间。 例如文件保存时“学习”未停止，之后恢复它，会从原来的开始时间继续算到现在；请按实际情况停止。

六、误删、断网和常见疑问

删除是否只删手机上的？ 已连接时删除会同步到云端。独立的旧 JSON 不会跟着变化。云端保留最近 8 次版本，但 App 当前没有历史版本回退按钮；误删后可尽快告诉我，我可以检查是否还有可恢复版本，不能保证一直保留。

第一次连接和备份是同一件事吗？ 首次连接是给当前设备访问私人云存储的授权。完成后自动保存；JSON 导出则是你单独留一份文件。连接链接不包含历史记录，也不能代替 JSON 文件。

链接过期后，云端数据会消失吗？ 不会。链接过期只代表不能再用它连接新设备；已经保存的数据仍在云端。现有设备授权最长 180 天，浏览器提前清除数据也可能使授权消失；届时重新连接即可。

我现在能用 Siri 开始或停止吗？ 还不能。快捷指令可以打开网址，但仍需手动点活动开始或停止。

云端是不是 iCloud？ 不是。云端数据在你的 Cloudflare 私人数据库中；只有你通过“存储到‘文件’”选择 iCloud Drive 后，额外的 JSON 才在那里。

七、建议你现在做的一次验收

1. 在平时用的入口完成连接，看到“云端已保存”。
2. 添加“测试”，选一个预设颜色。
3. 同时开始“测试”和另一活动，几秒后分别停止。
4. 在“报告”查看当天时长与图表。
5. 可选：导出 JSON 到 iCloud Drive，用“文件”确认存在。

本版已经在 Chromium 浏览器中验证；没有进行 iPhone Safari 真机测试。若某个 Safari 菜单与你看到的不同，请以手机实际菜单为准。