Courier
English

使用指南

每个渠道怎么连,以及容易踩的坑。

什么时候会更新数据

iOS 不允许任何 App 在 iPhone 锁屏时读取健康数据。Courier 有三种方式补上:睡眠记录完成、你解锁手机之后;每天在后台一两次;每次打开 App 时。后台唤醒由系统安排,不保证准点,把 App 划掉后也不会触发。打开 Courier 一定会补上最近几天。

补齐范围与历史 Pro

默认补齐最近 7 天。Pro 可以在 目的地 › 健康权限与数据 里选 14 天或 30 天,并用“历史初始化”把更早的数据一次性送到目的地,按月分批进行。锁屏时会暂停,回到 App 后接着做。

免费版:本机文件夹之外可以连 1 个目的地。今天的数据要等今天结束后才会写出去,每次同步会补齐最近 7 个已结束的日期。

本机文件夹 免费

要准备什么

  • 不需要账号,也不用设置。

步骤

  1. 装好 Courier、允许读取健康数据后就会自动写入。
  2. 打开“文件”App › 我的 iPhone › Courier,里面的 health-daily.csv 就是你的数据,每天一行。
  3. 用 Numbers 或 Excel 打开即可。

注意事项

  • 删除 Courier 会把这个文件夹一起删掉。想长期保存,就再加一个“文件夹”目的地(比如 iCloud 云盘里的文件夹),或者定期把文件拷出来。
  • 不要改第一行的表头,否则会停止写入。可以在最右边加你自己的列,Courier 不会动它们。
  • 本机文件夹不占免费版的目的地名额。

文件夹(iCloud 云盘等) 免费

要准备什么

  • 想放在 iCloud 云盘:先在 设置 › Apple 账户 › iCloud › iCloud 云盘 里打开“同步此 iPhone”。

步骤

  1. 在 Courier 里打开 目的地 › 添加目的地 › 文件夹。
  2. 在系统的文件夹选择器里选一个文件夹(比如 iCloud 云盘里新建的“健康数据”),点“打开”。
  3. Courier 会在这个文件夹里写 health-daily.csv,每天一行。

注意事项

  • 占用免费版唯一的那个目的地名额(本机文件夹不算)。要换成别的目的地,先在这里断开。
  • 文件夹被移动、改名或删除后会写不进去,App 里会提示,点“重新选择文件夹”即可。
  • 不要改第一行的表头;自己的列加在最右边。
  • iCloud 同步到其他设备由系统安排,可能要等一会儿才出现。
  • Courier 只读写这个文件夹里的 health-daily.csv,不会动其他文件。断开也不会删除已经写好的文件。

导出 CSV 免费

要准备什么

  • 不需要。

步骤

  1. 在 Courier 里打开 目的地 › 导出 CSV。
  2. 选日期范围,导出后可以用 AirDrop、邮件或存到“文件”。

注意事项

  • 免费版可以导出最近 30 天,Pro 不限。
  • 只导出已经结束的日期,最晚到昨天。
  • 文件是 UTF-8 编码,用 Excel 打开中文不会乱码;没有数据的格子留空。

Google 表格 免费

要准备什么

  • 一个 Google 账号。

步骤

  1. 在 Courier 里打开 目的地 › 添加目的地 › Google 表格。
  2. 用 Google 登录并允许访问。Courier 会在你的云端硬盘里新建一张名为“Courier”的表格。
  3. 最近 7 个已经结束的日期会自动写入,每天一行;今天结束后再写今天。

注意事项

  • 占用免费版唯一的那个目的地名额。
  • 不要改第一行表头、不要删 Courier 建的列。你自己的列加在最右边,Courier 不会动。
  • “完整度”“更新时间”两列始终在 Courier 的列的最后;以后新开的指标会插在它们前面。
  • 同一天再次同步是覆盖那一行,不会重复。

Notion 免费

要准备什么

  • 一个 Notion 账号,以及一个新建的空数据库(整页数据库,不是嵌在别的页面里的)。
  • 建议在电脑上操作 Notion,再把密钥和链接传到手机。

步骤

  1. 在 Notion 里打开 设置 › 开发者工具 › 连接(Settings › Developer tools › Connections),点“+ 新建连接(New connection)”,名字可以叫 Courier,建好后复制它的密钥(API token)。
  2. 打开你的数据库,点页面右上角的 ••• › 连接(Connections),在搜索框里输入 Courier,把它加进来。
  3. 还是在页面右上角 ••• 里点“复制链接(Copy link)”,拿到数据库链接。
  4. 把密钥和链接传到手机(比如用备忘录),在 Courier 里打开 目的地 › 添加目的地 › Notion,粘贴后点“验证并保存”。
  5. 回到“今天”页点刷新。数据库里会出现最近 7 天,每天一行,日期在标题列,后面自动建好步数、睡眠等属性。

注意事项

  • “连接”列表里找不到刚建的 Courier:它不会直接列出来,要在搜索框里输入名字。要点的是页面右上角的 •••,不是表格视图旁边那个 •••。还是没有,就看左上角是不是建连接时的那个工作区,或者到上一级页面去添加连接。
  • 链接要是数据库本身的:数据库嵌在别的页面里时,先点数据库名字把它打开成整页,再复制链接。复制外层页面的链接会连不上。
  • 用新建的空数据库:已有属性和 Courier 的属性同名但类型不同会报错;已经存在的属性,Courier 也改不了它们的顺序。
  • 占用免费版唯一的那个目的地名额,连 Notion 之前先断开别的。
  • 密钥只粘贴到手机上的 Courier 里,它保存在 iPhone 的钥匙串中。用备忘录中转的话,用完删掉那条备忘录。

飞书 / Lark 免费

要准备什么

  • 一个飞书(或 Lark)账号,并且你能在开放平台创建应用。
  • 建议在电脑上操作,再把 App ID、App Secret 和链接传到手机。

步骤

  1. 打开开放平台(飞书 open.feishu.cn,Lark open.larksuite.com),进入“开发者后台”,点“创建企业自建应用”,名字可以叫 Courier。
  2. 在应用的“凭证与基础信息”里找到 App ID 和 App Secret。
  3. 在“权限管理”里搜“多维表格”,开通“查看、评论、编辑和管理多维表格”。
  4. 在“版本管理与发布”里创建一个版本并发布(你是管理员就自己审批通过)。
  5. 在飞书云文档里新建一个空的多维表格。
  6. 在多维表格右上角 ••• › 更多 › 添加文档应用,搜索 Courier,权限选“可编辑”。
  7. 复制浏览器地址栏里的链接,形如 https://xxx.feishu.cn/base/……?table=tbl……。
  8. 在 Courier 里打开 目的地 › 添加目的地 › 飞书,区域选“飞书”或“Lark”,填 App ID、App Secret 和链接,点“验证并保存”。
  9. 回到“今天”页点刷新。表格里会出现最近 7 天,每天一行,日期在第一列。

注意事项

  • “添加文档应用”藏在“更多”里,在 ••• 菜单的倒数第二项。
  • 搜不到你的应用:检查应用已经发布、开通了多维表格权限、你在应用的可用范围里。改了权限要重新发布一个版本才生效。
  • 多维表格要直接建在云文档里,不要建在知识库里。知识库里的链接没有 /base/,Courier 读不出来。
  • 链接里必须有 table=。
  • 权限要选“可编辑”,选“可阅读”写不进去。
  • 占用免费版唯一的那个目的地名额。
  • App Secret 只粘贴到手机上的 Courier 里,保存在钥匙串中。中转用的备忘录用完删掉。

Markdown 日记 免费

要准备什么

  • 一个 Obsidian 库,放在 iCloud 云盘或“我的 iPhone”里都可以。

步骤

  1. 在 Courier 里打开 目的地 › 添加目的地 › Markdown 日记。
  2. 在文件夹选择器里选你的 Obsidian 库,或者库里专门放日记的子文件夹。
  3. Courier 每天写一个 YYYY-MM-DD.md,指标写在笔记开头的属性里。

注意事项

  • 你自己的其他属性和笔记正文不会被改动;同一天再次同步只更新 Courier 管的属性。
  • 如果选的文件夹里已经有同名的 YYYY-MM-DD.md(比如你的每日笔记就放在这里),Courier 只把属性合并进去,不会新建第二个。
  • 占用免费版唯一的那个目的地名额。

快捷指令 Pro

要准备什么

  • Pro。

步骤

  1. 打开“快捷指令”App,新建一个快捷指令,搜索 Courier。
  2. 添加“获取健康摘要”,它会返回昨天或最近 7 天的 JSON 文本。
  3. 把结果接到备忘录、提醒事项、Notion 或网络请求。也可以用“立即同步”让 Courier 马上补发一次。

注意事项

  • 只在手机上运行,不联网;没有数据的指标不会出现在结果里。
  • 没有 Pro 时动作会提示需要 Pro,不返回数据。

Webhook Pro

要准备什么

  • Pro。
  • 一个你自己的 https 接收地址。

步骤

  1. 在 Courier 里打开 目的地 › 添加目的地 › Webhook,填接收地址。
  2. 点“保存并生成签名密钥”,马上复制密钥,配到你的接收端。
  3. 可以点“发送测试”,Courier 会发一条标记为 is_test 的假数据。
  4. 之后每个已经结束的日期会以 JSON 用 POST 发过去。

注意事项

  • 密钥只显示一次。丢了可以重新生成,但旧密钥会立刻失效,接收端要一起换。
  • 只支持 https 地址。
  • 每个请求带 X-PDB-Signature: sha256=HMAC-SHA256(密钥, 原始请求体),接收端用同一个密钥验证;带稳定的 X-PDB-Delivery,用来去重。
  • 缺少某个键表示“没有采集”,null 表示“采集了但没有数据”。
  • 发送失败会自动重试。

给 AI 用的文件 Pro

要准备什么

  • Pro。
  • 已经有一个文件夹目的地(本机文件夹,或添加的“文件夹”)。

步骤

  1. 在 Courier 的“目的地”里打开“给 AI 用的文件”。
  2. Courier 会在 CSV 旁边多写两个文件:courier-data-dictionary.md(每列的含义和口径)和 courier-summary.md(最近 7 天、30 天的摘要)。
  3. 把这两个文件和 CSV 一起交给任何 AI。

注意事项

  • 只写文件,不联网,不会调用任何 AI。
  • 关闭后已有的文件保留,不再更新。