Oura Ring 命令行工具技能

概述

此工具可通过命令行界面从 Oura Ring API (V2) 获取健康与生物特征数据。用于查询用户的睡眠、活动、准备度和生理统计数据。

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

安装步骤

1. 构建命令行工具

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="你的客户端ID"
export OURA_CLIENT_SECRET="你的客户端密钥"
./oura auth login

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

前提条件

命令行工具必须已完成身份验证。如果命令因身份验证错误而失败，请通知用户运行 ./oura auth login。

语法

./oura get <类别> [标志]

数据类别

• personal：用户个人资料（年龄、体重、身高、邮箱）。
• sleep：每日睡眠评分与效率。
• activity：每日活动评分、步数与运动量。
• readiness：每日准备度评分，反映恢复状态。
• heartrate：时间序列心率数据。
• workout：详细锻炼记录。
• spo2：血氧饱和度水平。
• sleep-details：详细睡眠记录，包含睡眠阶段图。
• sessions：活动时段（如小睡、休息）。
• sleep-times：最佳就寝时间指导。
• stress：每日压力水平。
• resilience：每日恢复力评分与恢复状态。
• cv-age：心血管年龄估算。
• vo2-max：最大摄氧量测量值。
• ring-config：戒指硬件配置（颜色、尺寸等）。
• rest-mode：休息模式时段。
• tags：增强标签（备注、生活方式选择）。

参数说明

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

代理操作指南

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

使用示例

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

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

用户请求：“我今天的准备度评分是多少？”
上下文：今天是 2024-03-15。
命令：

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

用户请求：“显示我2024年1月第一周的心率数据。”
命令：

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

用户请求：“我的个人信息是什么？”
命令：

./oura get personal