从 Health.md 开始。

现已推出 · 已签名的 Mac 辅助程序

从手机导出健康数据，通过已签名的 Mac 辅助程序连接本地智能体，或基于版本化契约进行构建。HealthKit 读取操作始终在 iPhone 本地完成，Health Connect 读取操作始终在 Android 本地完成。

$ "/Applications/Health.md.app/Contents/Helpers/healthmd" doctor

安装在其他位置？请从 Health.md Mac 版 → CLI 复制随附辅助程序的路径。

首次从 iPhone 导出 连接智能体 浏览契约

01 · 导出从 iPhone 开始授权 Apple Health、选择文件夹、预览输出，然后执行首次导出。 02 · 查询连接本地智能体通过已签名的 Mac MCP 辅助程序连接 Codex、Claude 或其他 stdio 客户端。 03 · 构建使用稳定契约集成架构、记录、证据、生成的测试样例和精确封装。

21个随附的 Mac MCP 工具

4种导出格式

v8Apple 公共导出架构

0次必需的 Health.md 云端中转

现已推出 · macOS

五分钟完成本地智能体快速入门

在 Mac 上打开 Health.md，然后在已配对的 iPhone 上打开 Health.md 并等待连接。随附的辅助程序会在不返回健康数值的情况下检查就绪状态、列出睡眠指标，并执行单日查询：

HMD="/Applications/Health.md.app/Contents/Helpers/healthmd"
"$HMD" doctor
"$HMD" metrics list --category Sleep
"$HMD" query --category Sleep --yesterday

就绪的 doctor 结果使用 healthmd.cli_doctor 架构，并会在设置未完成时提供后续操作。若使用 Codex 或 Claude，请继续阅读配置智能体，并将客户端指向单独的已签名 healthmd-mcp 辅助程序。

按目标选择

配置与连接

现已推出 · Mac配置 — 将 Codex、Claude 或其他 stdio 客户端连接到已签名的 MCP 辅助程序。 现已推出 · MacMCP 服务器与应用 — 探索 21 个随附工具、呈现私密可视化内容，并了解便携预览版。 现已推出 · MacHealth.md CLI — 安装随附的辅助程序、检查就绪状态、查询数据，并区分便携预览版。 架构智能体上下文 — 了解请求范围、本地信任、加密上下文、证据、保留策略和隐私。

日常操作

查询、提取与自动化

类型化查询查询指标、睡眠时段、锻炼、对比、覆盖情况和事实证据。 预览 · 便携 CLI直接访问手机——查看手动 IP 或 Tailscale 配对以及当前尚未完成资格验证的 iPhone/Android 兼容性矩阵。 源数据规范提取 — 获取选定的架构 v8 每日数据、来源记录、投影或 JSONL。 可靠运行持久作业 — 安全处理超时、结果未知、恢复、取消和部分结果。 底层接口环回 API — 使用精确的查询、证据、游标、刷新和持久作业路由。 模式集成方案 — 解析并验证 Health.md 输出，同时保持契约的严格性。

稳定接口

数据契约与结构

契约导航导出参考 — 浏览架构、指标、格式、记录和互操作性测试样例。 自动化API 与 CLI 契约 — 查看封装、路由、退出行为和生成的示例。 智能体结果查询与证据 — 类型化值、覆盖范围、缺失状态、操作和确定性标识。 架构 v8每日记录 — 了解公开来源文档及其归属规则。 词汇表指标注册表 — 使用稳定的跨平台指标 ID、类别、单位和配置元数据。 机器可读生成的构件 — 查看规范字段、测试样例、消息清单和 CLI 契约。

产品工作流

应用与导出

可靠的配置文件导出

• 选择摘要或共享的详细时间序列；规范无损归档仅限 Apple。
• 在 iPhone 或 Android 上将独立设置、目的地和计划保存为设备本地配置文件。
• 停止或取消只影响当前尝试：已完成日期会保留，未解决日期可重试，重复计划保持启用。

请从导出配置文件开始了解稳定 ID、自动化、目的地历史和安全失败。

可复用工作流导出配置文件——固定目标、格式、指标、计划和自动化 ID。 从这里开始 · iPhone首次导出 — 授权 Apple Health、选择文件夹、预览输出并验证写入的文件。 AndroidHealth Connect — 选择文档提供方文件夹并配置平台自动化。 文件导出 — 以 Markdown、CSV、JSON 或 Obsidian Bases 格式导出明确的日期范围。 结构格式自定义 — 控制单位、日期、frontmatter、文件名和写入行为。 后台计划导出——了解重复周期、恢复机制和平台时间限制。 自动化快捷指令与 App Intents — 通过 Apple 工作流触发导出、摘要和状态检查。

文档结构更新于 2026-08-31