Oura Ring（V1）

该技能提供了一个小型、公开可用的参考实现，用于从 Oura V2 API（/v2/usercollection/*）拉取 Readiness、Sleep 及 7 日 Readiness 趋势 数据。

快速参考

• CLI（原始数据）：

  • python3 skills/oura-ring/cli.py --format json --pretty readiness
  • python3 skills/oura-ring/cli.py --format json --pretty sleep
  • python3 skills/oura-ring/cli.py --format json --pretty trends
  • python3 skills/oura-ring/cli.py --format json --pretty resilience
  • python3 skills/oura-ring/cli.py --format json --pretty stress

• 晨间简报（格式化输出）：

  • ./skills/oura-ring/scripts/morning_brief.sh

功能特性

• 晨间 Readiness 简报：基于最新评分生成的可执行建议。
• 趋势分析：对过去 7 天内各项评分变化的深入洞察。
• 韧性追踪（Resilience Tracking）：实时映射压力管理能力。

配置步骤

1) 安装依赖（推荐使用 venv）

macOS / Homebrew 安装的 Python 常会阻止系统级的 pip install（参见 PEP 668），因此请使用虚拟环境：

python3 -m venv skills/oura-ring/.venv
source skills/oura-ring/.venv/bin/activate
python -m pip install -r skills/oura-ring/requirements.txt

2) 创建 .env 文件

创建 skills/oura-ring/.env：

cp skills/oura-ring/.env.example skills/oura-ring/.env
# 然后编辑 skills/oura-ring/.env

CLI 将读取以下环境变量：

• OURA_TOKEN（必需）
• OURA_BASE_URL（可选；默认为 https://api.ouraring.com/v2/usercollection）

获取 Oura Token（OAuth2 流程）

Oura V2 使用 OAuth2 Bearer Token。

1. 创建一个 Oura API 应用：
   • https://cloud.ouraring.com/oauth/applications
2. 设置重定向 URI（本地测试时可设为类似 http://localhost:8080/callback 的地址）。
3. 打开授权 URL（请将 CLIENT_ID、REDIRECT_URI 和 scope 替换为实际值）：

https://cloud.ouraring.com/oauth/authorize?response_type=code&client_id=CLIENT_ID&redirect_uri=REDIRECT_URI&scope=readiness%20sleep

4. 完成授权后，你将被重定向至所设的 Redirect URI，并附带一个 code=... 查询参数。
5. 使用该 code 换取 access token：

curl -X POST https://api.ouraring.com/oauth/token 
  -H 'Content-Type: application/x-www-form-urlencoded' 
  -d grant_type=authorization_code 
  -d client_id=CLIENT_ID 
  -d client_secret=CLIENT_SECRET 
  -d redirect_uri=REDIRECT_URI 
  -d code=AUTH_CODE

6. 将返回的 access_token 写入 skills/oura-ring/.env，格式为：OURA_TOKEN=...。

注意事项：

• Access token 可能过期；如有需要，请使用 refresh_token 进行刷新。
• 请勿提交你的 .env 文件。

使用方法

Readiness 数据

python3 skills/oura-ring/cli.py --env-file skills/oura-ring/.env --format json --pretty readiness

Sleep 数据

python3 skills/oura-ring/cli.py --env-file skills/oura-ring/.env --format json --pretty sleep

Trends（最近 7 天；分页返回）

python3 skills/oura-ring/cli.py --env-file skills/oura-ring/.env --format json --pretty trends

封装脚本：晨间 Readiness 简报

./skills/oura-ring/scripts/morning_brief.sh

自定义 .env 文件路径：

OURA_ENV_FILE=/path/to/.env ./skills/oura-ring/scripts/morning_brief.sh

启用模拟模式运行（无需 token）：

OURA_MOCK=1 ./skills/oura-ring/scripts/morning_brief.sh

验证（无需 token）

python3 skills/oura-ring/cli.py --mock readiness --format json
python3 skills/oura-ring/cli.py --mock sleep --format json
python3 skills/oura-ring/cli.py --mock trends --format json