SuperAPI AI 工具集

withings

数据与分析

查看项目

更新于 10-16 07:24

技能介绍

用途:当用户询问自己的 Withings 数据时使用,包括身体指标(体重、BMI、体脂、血压、心率)、日常活动(步数、卡路里、距离、活跃时长)、睡眠会话(评分、阶段、时长、呼吸率)和锻炼会话(跑步、步行、骑行等)。

主要能力:三个子命令覆盖多数需求。withings status 查看连接状态;withings list-fields --category <CAT> 列出某分类字段(snake_case,单位写在名称中);withings query --category <CAT> --start-date <YYYY-MM-DD> [--end-date --interval --fields] 返回类型化记录,输出 JSON 数组。分类有 daily-metrics(活动与测量按日汇总,支持 --interval hourly|daily|weekly,默认 daily)、sleep(每次睡眠一行)、workout(每次锻炼一行)。

使用方式:调用前先运行 withings status;若为 not_connected,分享 Connect Withings,不要粘贴原始 URL;用户完成回调后重新检查状态,连接成功再继续。断开用 withings disconnect。不要打印令牌或凭据。字段名须用 snake_case 带单位形式(如 body_mass_kg、step_count、hr_average_bpm),不确定时先运行 list-fields。用户未指定日期时默认最近 7 天;看长期趋势用 --interval weekly,不要再对分桶结果做二次聚合。

限制:查询返回空数组时如实说明,不要编造数值。若某指标未被 list-fields 覆盖,可用旧版直通命令(如 measures --meas-types <ID>、heart-list)作为逃生通道。当“读取测量与心脏数据”权限为 deny 或 ask 时,daily-metrics 结果会包裹 withheld 标记并移除身体指标,仅请求这些字段会报 data_class_excluded;此时应说明权限限制,而非称“无读数”。睡眠与锻炼结果不会被包裹。完整命令矩阵与字段映射见 references/commands.md。