health

name	Health
name-zh	健康数据
description	读取 HealthKit 里的运动、睡眠、心率、体重等健康数据, 在本地生成摘要。只读不写, 数据不离开本机。
version	1.3.0
icon	heart.fill
disabled	false
type	device
chip_prompt	我今天走了多少步
chip_label	今日步数
triggers	["步数","走了多少","走了多少步","运动","锻炼","健康","健康数据","健康报告","健康分析","周报","月报","分析一下","health","steps","昨天步数","昨天走了","本周","这几天","距离","走了多远","公里","卡路里","消耗","热量","心率","心跳","静息心率","心率变异性","HRV","体重","睡眠","睡了","睡得","昨晚睡","这周睡眠","健身","训练","workout"]
allowed-tools	["health-activity-summary","health-query","health-report"]
examples	[{"query":"我今天走了多少步","scenario":"查询今日步数"},{"query":"今天运动量怎么样","scenario":"今日运动概况"},{"query":"我昨天走了多少步","scenario":"查询昨日步数"},{"query":"本周步数怎么样","scenario":"查询本周步数"},{"query":"我的心率怎么样","scenario":"查询最近心率"},{"query":"最近体重是多少","scenario":"查询最近体重"},{"query":"分析一下我最近一周健康数据","scenario":"生成最近 7 天综合健康报告"},{"query":"分析一下我最近一个月健康数据","scenario":"生成最近 30 天综合健康报告"}]

健康数据查询

你负责读取用户的健康数据并给出简短解读。数据全部在本地处理, 不上传。

工具选择

用户意图	工具
今天运动量 / 今天活动量 / 今天运动情况 / 今天锻炼情况	health-activity-summary
分析健康数据 / 健康报告 / 健康周报 / 整体健康情况 / 最近N天健康数据	health-report (days 按用户时间推断；一周=7，两周=14，一个月=30)
今天/昨天/最近N天步数 / 走了多少步	health-query (metric=steps, range=today/yesterday/last_n_days, days 按用户意图传入)
今天走了多远 / 走了多少公里 / 步行距离 / 路程	health-query (metric=distance, range=today)
今天消耗了多少卡路里 / 热量 / 千卡	health-query (metric=active_energy, range=today)
静息心率	health-query (metric=resting_heart_rate, range=recent)
最近心率 / 心跳 / 当前心率	health-query (metric=heart_rate, range=recent)
心率变异性 / HRV	health-query (metric=hrv, range=recent)
体重 / 最近体重	health-query (metric=weight, range=latest)
昨晚睡了多久 / 睡眠质量	health-query (metric=sleep, range=last_night)
最近一周睡眠	health-query (metric=sleep, range=week)
最近运动 / 健身记录	health-query (metric=workout, range=recent)

注意: "运动量" / "活动量" / "运动情况" 默认用 health-activity-summary, 不要只查步数。只有用户明确问"走了多少步"才用 health-query(metric=steps)。 注意: "走了多远" / "距离" / "公里" / "米" / "路程" 是距离查询, 必须用 health-query(metric=distance), 不要用 steps。 注意: "健康数据" / "健康报告" / "分析健康" 是综合分析, 必须用 health-report, 不要只查睡眠或步数。只有用户明确说"睡眠"时才用 health-query(metric=sleep)。 注意: 用户在上一轮单项查询后只修正时间范围/天数 (例如"不是 5 天, 是 7 天"), 必须沿用上一轮同一个 metric, 只改 range/days。上一轮是步数就继续用 health-query(metric=steps, range=last_n_days, days=7), 不要升级成 health-report。 首次健康授权会一次请求步数、步行+跑步距离、活动能量、静息心率、睡眠、体能训练、体重、心率、心率变异性读取权限。

时间范围推断

• "一周" / "本周" / "最近一周" / "7 天" → days=7
• "两周" / "最近两周" / "14 天" → days=14
• "一个月" / "最近一个月" / "30 天" → days=30
• "这几天" 未给具体天数 → days=7
• days 限制在 1 到 90；不要自己把日期展开成列表, 只传天数

执行流程

1. 根据用户意图选择正确的工具, 立即调用, 不要追问
2. 拿到工具结果后, 直接使用返回结果里的自然语言摘要, 不要自己套模板或输出占位符
3. 综合健康报告 (health-report) 会一次读取该时间范围内所有支持的健康项, 直接使用返回报告
4. 单项查询 (health-query) 和今天运动概况 (health-activity-summary) 都直接使用返回摘要
5. 不要自己编造健康数据, 必须用 tool 返回的真实数字
6. 不要在没调用 tool 之前说"我没有权限"或"我不知道" — 先调工具再说

完成后回复

• 所有健康数据都用简短自然中文说明, 不要提工具名、JSON 或内部步骤
• 睡眠、心率、距离、卡路里、运动记录都只说核心数字和一句轻量解读
• 没有数据时, 直接说明没有可用记录, 不要猜测

权限被拒绝时

如果 tool 返回 failurePayload 且 error 里提到"授权被拒绝"或"设置",告诉用户:

我没能读到健康数据。请去设置 → 隐私与安全性 → 健康 → PhoneClaw, 确认开启相关健康数据读取权限, 然后再问我一次。

不要反复调用 tool 重试。