快捷指令与 App Intents

可用 Intent

导出昨天的健康数据

无需参数的快捷指令。适合“只导出昨天的数据，不要再提示”的快速操作。使用与手动导出相同的引擎。 可选的配置文件参数（参见导出配置文件）。

导出指定日期的健康数据

接受一个日期参数。忽略具体时间。适用于日历驱动的自动化。 可选的配置文件参数。

导出指定日期范围的健康数据

接受开始日期和结束日期参数，包含首尾两天。适用于补录历史数据。 可选的配置文件参数。

导出最近 N 天的健康数据

接受天数参数（1–366），截止到昨天，默认为 7。适合“每周日导出最近 7 天数据”之类的自动化。 可选的配置文件参数。

获取指定日期的健康摘要

返回包含步数、活动消耗热量、睡眠和心率的结构化快照，不会向知识库写入任何内容。可在快捷指令中将这些值传递给其他 App。

获取上次导出状态

返回最近一次已记录导出的时间戳、成功状态、天数及失败原因。设备锁定时发起的请求会保持待处理状态，直到重试，因此待处理期间不会作为当前状态返回。

开启或关闭计划导出

接受一个布尔参数。可用于暂停计划（例如开启度假专注模式时），之后再恢复。

导出配置文件

可在 Health.md 的 iPhone 或 Android 版本中创建和管理已保存的导出配置文件。在 Apple 平台上，配置文件管理目前仅针对 iPhone 提供文档；不宣称在 iPad 或 macOS 上可用。

全部四个导出意图都接受可选的配置文件参数。存在配置文件时，留空会使用活动配置文件；在没有配置文件的旧版模式下，则使用应用当前的导出设置。传入已保存配置文件的名称后，无论应用当前显示什么，都会使用该配置文件冻结的配置（指标选择、格式和目标）运行。

提醒使用无参数快捷指令的用户。

在应用中创建第一个导出配置文件后，未设置配置文件的快捷指令将使用活动配置文件的已保存设置导出，而不是应用的实时设置。如果你依赖旧行为，请将快捷指令固定到特定配置文件（或保持零个配置文件）以保持明确。不再存在的配置文件名称会以清晰的错误失败，而不是导出错误的内容。

## 如何找到这些 Intent

在 iOS 或 macOS 上打开快捷指令 App。轻点 + 按钮创建快捷指令，然后搜索“Health.md”或上述任一 Intent 标题。它们位于健康类别下。

大多数 Intent 都设置了 openAppWhenRun = false，因此可在后台执行，不会启动 App，也不会闪现界面。它们可用于自动化、专注模式过滤器、“嘿 Siri”接力和操作按钮。

锁定时运行不会解锁 HealthKit。

iPhone 锁定时，Apple 会保护 HealthKit 数据，并在锁定约十分钟后撤销 App 的访问权限。允许锁定时运行可让快捷指令启动操作，但无法绕过 HealthKit 数据保护。快捷指令中的 Health.md App 内容权限也无法绕过此限制。

如果 HealthKit 不可用，Health.md 会保留请求的日期并标记为待处理，同时发送健康数据导出需要处理通知。解锁 iPhone 后，轻点通知或打开 Health.md 进行重试。iPhone 保持锁定时，无法保证完全无人值守的导出。

示例：每日导出并确认

1. 个人自动化 → 特定时间 → 选择您通常会使用已解锁 iPhone 的时间，例如上午 8:00。
2. 添加导出昨天的健康数据 Intent。
3. 添加获取上次导出状态 Intent。
4. 使用结果执行显示通知。

待处理状态说明：获取上次导出状态会读取最近一条已记录的导出历史。如果本次运行因 HealthKit 数据锁定而失败，在重试待处理请求前，它可能仍会显示上一次导出。对于待处理任务，应以 Health.md 自身的恢复通知为准。

示例：一次性补录历史数据

1. 创建快捷指令。
2. 添加导出指定日期范围的健康数据，将开始日期设为 2024-01-01，结束日期设为 2024-12-31。
3. 从快捷指令运行。它会逐日处理全年数据，每天写入一个文件。完整年份可能需要几分钟。

示例：度假期间暂停计划

1. 专注模式过滤器：开启度假专注模式时，运行开启或关闭计划导出，并将“已启用”设为 false。
2. 关闭专注模式时再次运行，并将“已启用”设为 true。

需要授权。

Intent 会沿用 App 内的 HealthKit 权限和知识库选择。如果尚未在此设备上至少打开并完成一次 App 设置，Intent 将失败并显示明确错误。

相关内容

来源计划导出——切换 Intent 对应的 App 内功能。 来源导出——日期范围 Intent 对应的 App 内功能。