Mac 同步

功能介绍

Mac 同步让 Mac 无需读取 HealthKit，即可生成导出文件。iPhone 仍是 Apple Health 数据的可信来源：它会采集所选的每日数据和精确设置快照，然后将该作业传输到 Mac。Mac 使用共享导出器规划路径、渲染所选格式，并将生成的文件写入您选择的目标文件夹。

iPhone采集 HealthKit 数据并生成有效设置的快照。 本地网络将带版本的作业传输到附近的 Mac 应用。 Mac渲染所选格式并将文件写入所选文件夹。 知识库Obsidian、iCloud Drive 或任意本地文件夹接收最终导出。

如何启用

1. 安装并打开 macOS 应用。
2. 在 Mac 上选择目标文件夹，授予 Health.md 写入权限。
3. 在 iPhone 上打开“同步”标签页，并启用 Mac 连接。
4. 返回 iPhone 的“导出”标签页，选择已连接的 Mac，配置导出，然后轻点“导出”。

传输内容

• 描述日期范围和有效设置的带版本导出请求
• iPhone 采集 HealthKit 数据时的进度和功能消息
• 经过校验和验证的限定大小帧，其中包含采集的每日数据，以及文件写入作业所需的精确设置快照
• 结构化的完成、部分完成、失败、拒绝或不可用结果

无需账户或远程健康数据云服务。附近同步使用加密的 Multipeer Connectivity；手动 IP/Tailscale 使用经过配对加密的 Network.framework 传输。两台设备必须能够互相连接，且 iPhone 始终是 HealthKit 读取端。

适用场景

仅限桌面的知识库

如果 Obsidian 知识库只存放在 Mac 上，这是将 iPhone HealthKit 数据导出为 Mac 文件的直接方式。

大规模历史数据回填

由 iPhone 负责读取 HealthKit 和配置导出，同时将最终文件保存在桌面磁盘上。

本地归档工作流

直接写入在 macOS 上备份、版本管理或建立索引的文件夹。

需要本地网络。

两台设备必须在附近，并获准使用本地网络。仅使用蜂窝网络的 iPhone 无法发现 Mac 目标位置。如果就绪状态显示“需在 Mac 上处理”，请重新打开 Mac 应用并重新选择目标文件夹。

Mac 同步与 Direct CLI 访问相互独立

Mac 同步会将 iPhone 与 Health.md Mac 应用配对，用于目标位置导出和加密的智能体上下文。Direct CLI 访问则通过独立的信任域，将 iPhone 与命令行安装配对。直连模式无需 Mac 应用即可导出原始数据或生成文件，但无法使用 Mac 上的加密查询索引或 MCP。

启用这一独立的 iPhone 设置前，请参阅直接连接 iPhone 的 CLI。

相关内容

桌面端macOS 应用 — 在 Mac 上导出、计划和查看历史记录。 工作流计划 — 自动执行定期导出。 独立信任直接连接 iPhone 的 CLI — 无需通过 Mac 应用路由作业，即可配对 CLI。 协议Mac–iPhone 连接参考 — 功能、请求、有界传输和结果。