📖 用户手册

Tome 不是日记 App，也不是笔记 App。它要解决的是降低「记录自己」的门槛——低到可以随时随地、想到就记，然后把散落的碎片汇聚成完整的人生轨迹。

1. 安装与启动

从 App Store 下载安装。Tome 支持 iPhone、Mac、iPad 和 Apple Watch。

• iPhone：主力记录端，全功能。
• Mac：深度书写 + 大屏浏览，三栏布局（侧栏 / 列表 / 详情）。
• iPad：回顾与整理，共享 iPhone 代码。
• Apple Watch：极速语音捕捉，抬腕即录。

首次启动无需登录或注册，数据完全属于你。

2. 核心概念：双重时间线

Tome 将「记录这件事」和「事情本身」解耦：

• 记录时间（createdAt）：系统自动写入，表示你什么时候做了这条记录，不可修改。
• 发生时间（occurredAt）：由你设定，表示这件事发生在什么时候——可以是今天、昨天，也可以是"1993 年左右"或"童年"。这是时间轴排序的主维度。

补录过去的回忆时，两者可以相差几十年、几千公里。发生时间支持 6 级精度：精确时间 → 某天 → 某月 → 某年 → 某年代 → 模糊时期（如"童年"）。

同样，发生地点也支持模糊：精确坐标 → POI 兴趣点 → 城市级 → 省/区域级 → 模糊描述（如"老家的院子"）。

3. 五种记录方式

点击底部 + 按钮，可选择新建：

• 语音记录 🎙️：打开即开始录音，零延迟。支持 iPhone、Mac 和 Apple Watch。录音完成后自动触发设备端转写（无需联网）。原始音频与转写文字同时保留。音频播放器支持拖动进度条。
• 文字记录 ✍️：打开即进入编辑器，键盘自动弹出。支持长篇正文，实时自动保存（停止编辑 600ms 后自动写入），无"保存"按钮。空记录退出时自动丢弃。
• 核对清单 ☑️：每行一个勾选项，点击即可切换选中（加删除线 + 变灰）。可随时新增项目。支持在文字模式和清单模式间切换。
• 图片记录 📸：拍摄新照片或从相册选择。单张全宽显示，多张以 2 列网格展示，点击进入全屏查看器（支持缩放与翻页）。
• 视频记录 🎬：拍摄或选择视频，内联播放器在记录中直接播放（16:9 比例）。

一条记录可以同时包含文字 + 图片 + 视频 + 音频多种附件。

4. 编辑器详解

进入编辑器后，你可以：

• 修改发生时间：点击顶部时间区域，进入时间编辑器，从 6 级精度中选择并设置锚点日期。
• 添加主题标签：点击"主题"按钮，选择已有主题或创建新主题。一条记录可绑定多个主题。已绑定的主题以 chips 形式横向滚动显示。
• 正文编辑：多行文本输入，随内容自动增高，placeholder 提示"正文"。
• 添加附件：点击底部 📷 按钮，可选择相机拍照 / 从相册选择图片 / 从相册选择视频。
• 切换格式：点击底部 Aa 按钮，在"正文"和"核对清单"模式间切换。

5. 语音转写

录音结束后，Tome 自动使用 Apple Speech 框架进行设备端转写（不联网，不上传音频）。

• 转写状态指示：等待中 → 进行中 → 完成 / 失败。
• 失败可手动重试，原始音频永远保留。
• 每次 App 进入前台时自动消费待转写队列。
• 录音格式：AAC 44.1kHz mono（高质量），Apple Watch 端为 AAC 16kHz mono。

Apple Watch 录音流程：Watch 录音 → 通过 WatchConnectivity 传文件到 iPhone → iPhone 创建记录并入转写队列。手表不做转写（省电，链路更稳）。

6. 时间线浏览

首页为时间线，按发生时间倒序排列：

• 两种视图：列表视图 / 画廊视图（2 列卡片网格），通过导航栏按钮切换。
• 置顶区域：已置顶的记录在独立"已置顶"section，其余按年份分组。
• 手势操作：右滑置顶 / 取消置顶，左滑删除（软删除，30 天保留期）。
• 下拉刷新：同步最新数据。
• Mac 三栏布局：左侧栏（全部记录 + 主题列表）、中间列表、右侧详情。支持拖放记录到主题。

7. 主题标签系统

用主题追踪一条思想线的演变：

• 创建 / 重命名 / 删除主题。
• 一条记录可绑定多个主题（多对多）。
• 点击主题查看该主题下所有记录。
• 支持层级主题（如"三观 > 自由"）。
• Mac 侧栏显示主题列表（含记录计数），支持拖放。

8. 搜索与筛选

顶部搜索栏支持全文搜索（不区分大小写）。高级筛选支持多维度组合：

• 记录类型：语音 / 文字 / 清单 / 图片 / 视频（多选）
• 有照片：筛选含图片附件的记录
• 有地点：筛选有发生地或采集地的记录
• 已置顶：筛选置顶记录
• 时间范围：从某日到某日

9. 洞察（Insights）

Mac 端侧栏底部提供 Insights 视图，展示：

• 当前连续记录天数（从今天/昨天往回数）
• 历史最长连续天数
• 总记录数、活跃天数、总字数
• Top 5 常去的地点

10. 足迹地图

Mac 端提供地图视图，标注所有有坐标的记录。点击标注进入记录详情。坐标来源：发生地坐标 → 记录时采集地坐标。

11. iCloud 同步

Tome 使用你的私人 iCloud 账户同步数据（CloudKit 私有数据库），而非开发者的服务器：

• 所有数据存储在 iCloud.com.tipshot.self 容器中。
• iPhone / Mac / Watch / iPad 自动保持一致。
• 传输加密、端到端由 Apple 账号体系保护。
• Tome 自身没有任何服务器，不持有用户数据。
• 监听远程变更通知，同步后自动刷新 UI。

12. 数据导出

在设置中触发导出，同时产出两种格式：

• JSON（机器可读）：self-export.json，含所有记录、主题与元数据。结构稳定、有版本号，可再导入。媒体文件存放在同目录 media/ 下。
• Markdown（人类可读）：按发生时间组织，每年一个章节，每条记录包含类型图标、时间、地点、正文、附件引用和主题标签。即使没有任何软件也能直接阅读。

13. Apple Watch

Apple Watch 版 Tome 定位为极速语音捕捉器：

• 黑底界面，中央大红色圆形麦克风按钮。
• 点击进入录音：显示计时器（MM:SS）+ 波形动画 + 红色停止按钮。
• 过滤 < 1 秒的录音。
• 下方显示 iPhone 推送的最近记录列表（最近 10 条摘要）。
• 支持 Siri 快捷指令触发录音。

14. 设置

在设置中可配置：

• 记录地点：开启后记录时自动抓取设备位置，可全局关闭。默认开启。
• App 锁定：开启后离开 App 即锁定，回来需 Face ID / Touch ID / 密码解锁。默认关闭。
• 每日记录提醒：默认 21:00 发本地通知，时间可调。提醒内容："记一笔 — 花一分钟，记录此刻的想法。"
• 最近删除：可恢复或永久删除 30 天内软删除的记录。
• App 语言：跟随系统，可跳转系统设置为 Tome 单独设置语言。
• 数据导出：导出 JSON + Markdown 双格式。

15. 最近删除

删除的记录进入"最近删除"，保留 30 天后自动物理清除。在保留期内可随时恢复，也可手动永久删除（含确认对话框）。App 启动时自动清理过期记录。

16. Siri 快捷指令

支持 Siri 触发语音记录："Tome 记录"、"记录 Tome"、"Tome"——打开 App 并立即进入录音界面。iOS 和 Watch 端均支持。

17. 反思提示

新建记录时可选择"提示起笔"，从 15 条内置中文提示中随机抽取。提示类型涵盖感恩、心情、人际关系、观念变化、自我反思、童年回忆、身体感受、目标审视等，帮助克服"不知道写什么"。

18. 常见问题

Q：我的数据会被上传吗？
不会。数据只存于你的设备和私人 iCloud 账户中。Tome 没有任何服务器。

Q：换手机了，数据还在吗？
只要你使用同一个 Apple ID 并开启 iCloud，数据会自动同步到新设备。

Q：语音转写需要联网吗？
不需要。转写使用 Apple 的设备端语音识别，完全离线完成。

Q：如何补录过去的回忆？
新建记录后，点击顶部时间区域修改发生时间——支持精确到分钟，也支持模糊时间如"2020 年"、"1990 年代"或"童年"。

Q：删除的记录能恢复吗？
删除后进入"最近删除"，30 天内可随时恢复。超期后自动永久删除。

Q：导出的数据格式稳定吗？
JSON 格式带有版本号，结构稳定。即使几十年后，只要有 JSON 解析器就能读取。

19. 意见反馈

这个 App 由独立开发者维护，你的每一条使用意见、Bug 和功能建议都会被认真对待。欢迎随时联系 selfren@163.com。

反馈问题时附上 App 版本号（设置中可见）与系统版本，能更快定位问题。