什么时候会更新数据
iOS 不允许任何 App 在 iPhone 锁屏时读取健康数据。Courier 有三种方式补上:睡眠记录完成、你解锁手机之后;每天在后台一两次;每次打开 App 时。后台唤醒由系统安排,不保证准点,把 App 划掉后也不会触发。打开 Courier 一定会补上最近几天。
补齐范围与历史 Pro
默认补齐最近 7 天。Pro 可以在 目的地 › 健康权限与数据 里选 14 天或 30 天,并用“历史初始化”把更早的数据一次性送到目的地,按月分批进行。锁屏时会暂停,回到 App 后接着做。
免费版:本机文件夹之外可以连 1 个目的地。今天的数据要等今天结束后才会写出去,每次同步会补齐最近 7 个已结束的日期。
本机文件夹 免费
要准备什么
- 不需要账号,也不用设置。
步骤
- 装好 Courier、允许读取健康数据后就会自动写入。
- 打开“文件”App › 我的 iPhone › Courier,里面的
health-daily.csv就是你的数据,每天一行。 - 用 Numbers 或 Excel 打开即可。
注意事项
- 删除 Courier 会把这个文件夹一起删掉。想长期保存,就再加一个“文件夹”目的地(比如 iCloud 云盘里的文件夹),或者定期把文件拷出来。
- 不要改第一行的表头,否则会停止写入。可以在最右边加你自己的列,Courier 不会动它们。
- 本机文件夹不占免费版的目的地名额。
文件夹(iCloud 云盘等) 免费
要准备什么
- 想放在 iCloud 云盘:先在 设置 › Apple 账户 › iCloud › iCloud 云盘 里打开“同步此 iPhone”。
步骤
- 在 Courier 里打开 目的地 › 添加目的地 › 文件夹。
- 在系统的文件夹选择器里选一个文件夹(比如 iCloud 云盘里新建的“健康数据”),点“打开”。
- Courier 会在这个文件夹里写
health-daily.csv,每天一行。
注意事项
- 占用免费版唯一的那个目的地名额(本机文件夹不算)。要换成别的目的地,先在这里断开。
- 文件夹被移动、改名或删除后会写不进去,App 里会提示,点“重新选择文件夹”即可。
- 不要改第一行的表头;自己的列加在最右边。
- iCloud 同步到其他设备由系统安排,可能要等一会儿才出现。
- Courier 只读写这个文件夹里的
health-daily.csv,不会动其他文件。断开也不会删除已经写好的文件。
导出 CSV 免费
要准备什么
- 不需要。
步骤
- 在 Courier 里打开 目的地 › 导出 CSV。
- 选日期范围,导出后可以用 AirDrop、邮件或存到“文件”。
注意事项
- 免费版可以导出最近 30 天,Pro 不限。
- 只导出已经结束的日期,最晚到昨天。
- 文件是 UTF-8 编码,用 Excel 打开中文不会乱码;没有数据的格子留空。
Google 表格 免费
要准备什么
- 一个 Google 账号。
步骤
- 在 Courier 里打开 目的地 › 添加目的地 › Google 表格。
- 用 Google 登录并允许访问。Courier 会在你的云端硬盘里新建一张名为“Courier”的表格。
- 最近 7 个已经结束的日期会自动写入,每天一行;今天结束后再写今天。
注意事项
- 占用免费版唯一的那个目的地名额。
- 不要改第一行表头、不要删 Courier 建的列。你自己的列加在最右边,Courier 不会动。
- “完整度”“更新时间”两列始终在 Courier 的列的最后;以后新开的指标会插在它们前面。
- 同一天再次同步是覆盖那一行,不会重复。
Notion 免费
要准备什么
- 一个 Notion 账号,以及一个新建的空数据库(整页数据库,不是嵌在别的页面里的)。
- 建议在电脑上操作 Notion,再把密钥和链接传到手机。
步骤
- 在 Notion 里打开 设置 › 开发者工具 › 连接(Settings › Developer tools › Connections),点“+ 新建连接(New connection)”,名字可以叫 Courier,建好后复制它的密钥(API token)。
- 打开你的数据库,点页面右上角的 ••• › 连接(Connections),在搜索框里输入 Courier,把它加进来。
- 还是在页面右上角 ••• 里点“复制链接(Copy link)”,拿到数据库链接。
- 把密钥和链接传到手机(比如用备忘录),在 Courier 里打开 目的地 › 添加目的地 › Notion,粘贴后点“验证并保存”。
- 回到“今天”页点刷新。数据库里会出现最近 7 天,每天一行,日期在标题列,后面自动建好步数、睡眠等属性。
注意事项
- “连接”列表里找不到刚建的 Courier:它不会直接列出来,要在搜索框里输入名字。要点的是页面右上角的 •••,不是表格视图旁边那个 •••。还是没有,就看左上角是不是建连接时的那个工作区,或者到上一级页面去添加连接。
- 链接要是数据库本身的:数据库嵌在别的页面里时,先点数据库名字把它打开成整页,再复制链接。复制外层页面的链接会连不上。
- 用新建的空数据库:已有属性和 Courier 的属性同名但类型不同会报错;已经存在的属性,Courier 也改不了它们的顺序。
- 占用免费版唯一的那个目的地名额,连 Notion 之前先断开别的。
- 密钥只粘贴到手机上的 Courier 里,它保存在 iPhone 的钥匙串中。用备忘录中转的话,用完删掉那条备忘录。
飞书 / Lark 免费
要准备什么
- 一个飞书(或 Lark)账号,并且你能在开放平台创建应用。
- 建议在电脑上操作,再把 App ID、App Secret 和链接传到手机。
步骤
- 打开开放平台(飞书 open.feishu.cn,Lark open.larksuite.com),进入“开发者后台”,点“创建企业自建应用”,名字可以叫 Courier。
- 在应用的“凭证与基础信息”里找到 App ID 和 App Secret。
- 在“权限管理”里搜“多维表格”,开通“查看、评论、编辑和管理多维表格”。
- 在“版本管理与发布”里创建一个版本并发布(你是管理员就自己审批通过)。
- 在飞书云文档里新建一个空的多维表格。
- 在多维表格右上角 ••• › 更多 › 添加文档应用,搜索 Courier,权限选“可编辑”。
- 复制浏览器地址栏里的链接,形如
https://xxx.feishu.cn/base/……?table=tbl……。 - 在 Courier 里打开 目的地 › 添加目的地 › 飞书,区域选“飞书”或“Lark”,填 App ID、App Secret 和链接,点“验证并保存”。
- 回到“今天”页点刷新。表格里会出现最近 7 天,每天一行,日期在第一列。
注意事项
- “添加文档应用”藏在“更多”里,在 ••• 菜单的倒数第二项。
- 搜不到你的应用:检查应用已经发布、开通了多维表格权限、你在应用的可用范围里。改了权限要重新发布一个版本才生效。
- 多维表格要直接建在云文档里,不要建在知识库里。知识库里的链接没有
/base/,Courier 读不出来。 - 链接里必须有
table=。 - 权限要选“可编辑”,选“可阅读”写不进去。
- 占用免费版唯一的那个目的地名额。
- App Secret 只粘贴到手机上的 Courier 里,保存在钥匙串中。中转用的备忘录用完删掉。
Markdown 日记 免费
要准备什么
- 一个 Obsidian 库,放在 iCloud 云盘或“我的 iPhone”里都可以。
步骤
- 在 Courier 里打开 目的地 › 添加目的地 › Markdown 日记。
- 在文件夹选择器里选你的 Obsidian 库,或者库里专门放日记的子文件夹。
- Courier 每天写一个
YYYY-MM-DD.md,指标写在笔记开头的属性里。
注意事项
- 你自己的其他属性和笔记正文不会被改动;同一天再次同步只更新 Courier 管的属性。
- 如果选的文件夹里已经有同名的
YYYY-MM-DD.md(比如你的每日笔记就放在这里),Courier 只把属性合并进去,不会新建第二个。 - 占用免费版唯一的那个目的地名额。
快捷指令 Pro
要准备什么
- Pro。
步骤
- 打开“快捷指令”App,新建一个快捷指令,搜索 Courier。
- 添加“获取健康摘要”,它会返回昨天或最近 7 天的 JSON 文本。
- 把结果接到备忘录、提醒事项、Notion 或网络请求。也可以用“立即同步”让 Courier 马上补发一次。
注意事项
- 只在手机上运行,不联网;没有数据的指标不会出现在结果里。
- 没有 Pro 时动作会提示需要 Pro,不返回数据。
Webhook Pro
要准备什么
- Pro。
- 一个你自己的 https 接收地址。
步骤
- 在 Courier 里打开 目的地 › 添加目的地 › Webhook,填接收地址。
- 点“保存并生成签名密钥”,马上复制密钥,配到你的接收端。
- 可以点“发送测试”,Courier 会发一条标记为
is_test的假数据。 - 之后每个已经结束的日期会以 JSON 用 POST 发过去。
注意事项
- 密钥只显示一次。丢了可以重新生成,但旧密钥会立刻失效,接收端要一起换。
- 只支持 https 地址。
- 每个请求带
X-PDB-Signature: sha256=HMAC-SHA256(密钥, 原始请求体),接收端用同一个密钥验证;带稳定的X-PDB-Delivery,用来去重。 - 缺少某个键表示“没有采集”,
null表示“采集了但没有数据”。 - 发送失败会自动重试。
给 AI 用的文件 Pro
要准备什么
- Pro。
- 已经有一个文件夹目的地(本机文件夹,或添加的“文件夹”)。
步骤
- 在 Courier 的“目的地”里打开“给 AI 用的文件”。
- Courier 会在 CSV 旁边多写两个文件:
courier-data-dictionary.md(每列的含义和口径)和courier-summary.md(最近 7 天、30 天的摘要)。 - 把这两个文件和 CSV 一起交给任何 AI。
注意事项
- 只写文件,不联网,不会调用任何 AI。
- 关闭后已有的文件保留,不再更新。