Oura Ring CLI 技能

描述

此工具允许通过命令行界面从 Oura Ring API（V2）获取健康和生物特征数据。使用此工具可回答有关用户睡眠、活动、准备度和生理统计数据的问题。

代码仓库：https://github.com/ruhrpotter/oura-cli

安装

1. 构建 CLI

cd ~
git clone https://github.com/ruhrpotter/oura-cli.git
cd oura-cli
go build -o oura ./cmd/oura

2. 创建 Oura OAuth 应用

1. 前往Oura 开发者门户
2. 创建一个新的应用
3. 将重定向 URI 设置为：http://localhost:8080/callback
4. 记下你的客户端 ID和客户端密钥

3. 身份验证

export OURA_CLIENT_ID="your_client_id"
export OURA_CLIENT_SECRET="your_client_secret"
./oura auth login

浏览器将打开以进行 OAuth 授权。令牌存储在~/.config/oura-cli/config.json中。

先决条件

CLI必须经过身份验证。如果命令因身份验证错误而失败，请通知用户运行./oura auth login。

语法

./oura get <category> [flags]

类别

• personal：用户个人资料（年龄、体重、身高、邮箱）。
• sleep：每日睡眠评分与效率。
• activity：每日活动评分、步数和运动量。
• readiness：指示恢复状况的每日准备度评分。
• heartrate：时间序列心率数据。
• workout：详细的训练课程。
• spo2：血氧饱和度水平。
• sleep-details：详细的睡眠课程，包括睡眠阶段图。
• sessions活动时段（例如：小憩、休息）。
• 睡眠时间：最佳就寝时间指导。
• 压力：每日压力水平。
• 恢复力：每日恢复力评分与恢复情况。
• 心血管年龄：心血管年龄估算。
• 最大摄氧量：最大摄氧量测量值。
• 戒指配置：戒指硬件配置（颜色、尺寸等）。
• 休息模式：休息模式时段。
• 标签：增强型标签（注释、生活方式选择）。

参数

• --start <YYYY-MM-DD>：对于大多数时间序列数据为必填项。范围的开始日期。
• --end <YYYY-MM-DD>：可选。范围的结束日期。如果省略，根据上下文可能默认为开始日期或返回单日数据。

代理指令

1. 日期解析：您必须将所有相对日期术语（例如“今天”、“昨天”、“上周”、“本月”）基于当前操作日期解析为YYYY-MM-DD字符串格式。
2. 日期范围：
   • 对于“今天”：将--start设置为今天的日期。
   • 对于“昨天”：将--start设置为昨天的日期。
   • 对于“过去7天”：将--start设置为7天前的日期，并将--end设置为今天。
3. 路径：假设二进制文件是当前工作目录中的./oura，除非用户另有指定。
4. 输出：命令行界面返回JSON数据。请解析JSON数据数组以生成自然语言回复。

示例

用户请求："我昨晚睡眠怎么样？"上下文：今天是2024年3月15日。"昨晚"通常指在今天早上结束的睡眠时段，或根据Oura的日期记录方式（Oura以睡眠结束的早晨为日期）指前一天的睡眠数据。推理：从14日夜间至15日凌晨的睡眠记录日期为2024-03-15。命令：

./oura get sleep --start 2024-03-15

用户请求："我今天的准备度分数是多少？"上下文：今天是2024年3月15日。命令：

./oura get readiness --start 2024-03-15

用户请求"显示我2024年1月第一周的心率。"指令:

./oura get heartrate --start 2024-01-01 --end 2024-01-07

用户请求: "我是谁？"指令:

./oura get personal