SuperAPI AI 工具集

withings

数据与分析

查看项目

更新于 10-16 03:42

技能介绍

用途:当用户询问自己的 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;用户完成回调后重新运行 status,连接成功再继续。断开用 withings disconnect。不要打印令牌或凭据。字段名不确定时先运行 list-fields 再组合 query --fields;Withings 原生名(calories、distance、hr_average、weight)无效,会被翻译为带单位的 snake_case(如 energy_burned_kcal、distance_meters、hr_average_bpm、body_mass_kg)。用户未指定日期时默认最近 7 天;看长期趋势用 daily-metrics 加 --interval weekly,不要再在客户端做额外聚合。查询返回空数组时如实说明,不要编造数值。

限制:query 未覆盖的数据可用旧版直通命令作为逃生通道,返回原始 {ok, status, body} 信封,如 withings measures --meas-types <ID>、withings sleep、withings heart-list / heart-get、withings activity、withings sleep-summary、withings intraday、withings devices。当“读取测量与心脏数据”权限为 deny 或 ask 时,daily-metrics 结果会包在 {"withheld": {...}, "records": [...]} 中并移除身体指标,仅请求这些字段会以 data_class_excluded 失败;此时应说明是权限限制而非无数据。睡眠与锻炼结果不会被包裹。资料未提供收费、价格与平台信息。