SuperAPI AI 工具集

withings-health

通用与其它

查看项目

更新于 10-16 06:57

技能介绍

用途

该技能用于与用户的 Withings 账户交互,从 Withings 设备(智能体重秤、睡眠分析仪、活动追踪器等)检索综合健康指标。当用户询问体重或体重历史、身体成分(脂肪率、肌肉量、骨量、水分)、日常活动(步数、距离、消耗卡路里)或睡眠数据(时长、质量、深睡、REM),或提到 Withings 及相关设备(Body+、Sleep Analyzer、ScanWatch 等),或希望长期跟踪健康进展时,可使用此技能。

准备:创建 Withings 开发者应用

使用前需创建一个免费的 Withings 开发者应用以获取 API 凭据。

第一步:创建 Withings 开发者账户。前往 Withings 开发者门户,点击注册(Sign Up),如果已有 Withings 账户则直接登录,接受开发者服务条款。

第二步:创建应用。导航至 My Apps → Create an Application,填写应用详情:应用名称(如 "My ThinkFleet Health")、描述(用例简短说明)、联系邮箱、回调 URL:http://localhost:8080(OAuth 必需)、应用类型(选择 "Personal Use" 或合适类型),提交应用。

第三步:获取凭据。应用创建后,进入 My Apps 并选择该应用,可找到 Client ID(设置为 WITHINGS_CLIENT_ID 环境变量)和 Client Secret(设置为 WITHINGS_CLIENT_SECRET 环境变量)。

第四步:配置环境变量。添加到 ThinkFleet 环境:

export WITHINGS_CLIENT_ID="your_client_id_here" export WITHINGS_CLIENT_SECRET="your_client_secret_here"

或在技能目录中创建 .env 文件(该文件会被 git 忽略):

WITHINGS_CLIENT_ID=your_client_id_here WITHINGS_CLIENT_SECRET=your_client_secret_here

配置

该技能使用位于 {baseDir} 中的 wrapper.js 脚本。在任何数据检索之前,检查用户是否已认证。如果错误信息中出现 "No token found",引导用户完成首次认证流程。

可用命令

1. 认证

首次设置(生成 OAuth URL):

node {baseDir}/wrapper.js auth

用户访问该 URL 并获取授权码后:

node {baseDir}/wrapper.js auth YOUR_CODE_HERE

2. 获取体重

检索最新体重测量值:

node {baseDir}/wrapper.js weight

返回最近 5 条体重条目,JSON 格式。示例输出:

[ { "date": "2026-01-17T08:30:00.000Z", "weight": "75.40 kg" }, { "date": "2026-01-16T08:15:00.000Z", "weight": "75.65 kg" } ]

3. 获取身体成分

检索综合身体指标(脂肪、肌肉、骨骼、水分、BMI):

node {baseDir}/wrapper.js body

返回最近 5 条身体成分测量。示例输出:

[ { "date": "2026-01-17T08:30:00.000Z", "weight": "75.40 kg", "fat_percent": "18.5%", "fat_mass": "13.95 kg", "muscle_mass": "35.20 kg", "bone_mass": "3.10 kg", "hydration": "55.2%" } ]

4. 获取活动

检索每日活动数据(步数、距离、卡路里):

node {baseDir}/wrapper.js activity

可选指定天数(默认:7):

node {baseDir}/wrapper.js activity 30

示例输出:

[ { "date": "2026-01-17", "steps": 8542, "distance": "6.23 km", "calories": 2150, "active_calories": 450, "soft_activity": "45 min", "moderate_activity": "22 min", "intense_activity": "8 min" } ]

5. 获取睡眠

检索睡眠数据与质量:

node {baseDir}/wrapper.js sleep

可选指定天数(默认:7):

node {baseDir}/wrapper.js sleep 14

示例输出:

[ { "date": "2026-01-17", "start": "23:15", "end": "07:30", "duration": "8h 15min", "deep_sleep": "1h 45min", "light_sleep": "4h 30min", "rem_sleep": "1h 30min", "awake": "30min", "sleep_score": 82 } ]

错误处理

常见错误及解决方法:

错误 原因 解决方法
"No token found" 首次使用,未认证 运行 node wrapper.js auth 并按 OAuth 流程操作
"Failed to refresh token" 令牌过期且刷新失败 使用 node wrapper.js auth 重新认证
"API Error Status: 401" 凭据无效或过期 检查 CLIENT_ID 与 CLIENT_SECRET,重新认证
"API Error Status: 503" Withings API 暂时不可用 稍后重试
数据为空 请求时间段内无测量数据 用户需同步其 Withings 设备

注意事项

令牌过期时会自动刷新。使用的 Withings API 范围:user.metrics、user.activity。数据可用性取决于用户拥有的 Withings 设备。部分指标(如身体成分)需要兼容的智能体重秤。

限制

具体支持平台、收费方式与价格、运行环境要求等资料暂未提供。