核心用法
Perpetua 是一个托管式 OAuth 代理服务，允许用户通过单个 API Key 访问多个外部 OAuth 平台（Oura Ring、Google Calendar 等），无需自行处理复杂的 OAuth 授权流程和 Token 刷新。
典型调用模式：
GET https://www.perpetua.sh/api/proxy/:provider/:path Authorization: Bearer $PERPETUA_API_KEY
支持场景包括：
- Oura Ring 数据：睡眠评分、恢复度、HRV、活动量、运动记录
- Google Calendar：日程查询、日历列表、即将开始的会议
- 连接管理：查看连接状态、启动 OAuth 授权流程
显著优点
1. 极简集成：单一 API Key 替代多平台 OAuth 开发，大幅降低接入成本
2. Token 托管：自动处理 access_token 获取与刷新，开发者无需维护 Token 状态
3. 统一接口：所有外部服务通过一致的 REST 模式访问，降低学习曲线
4. 安全隔离：敏感凭据托管于 Perpetua 服务端，降低本地泄露风险
潜在局限
1. 供应商锁定：依赖 Perpetua.sh 托管服务的可用性与持续性
2. 网络单点：所有调用需经过 Perpetua 代理，引入额外延迟和故障点
3. 功能受限：仅支持文档列出的端点，无法调用提供商完整 API 能力
4. 数据隐私：健康数据（Oura）和日程信息需流经第三方服务器
适合人群
- 量化自我（Quantified Self）爱好者：快速整合睡眠、HRV 等健康数据
- 个人效率工具开发者：构建日程分析、健康洞察类应用
- 原型验证团队：快速 MVP 开发，避免 OAuth 基础设施投入
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 服务可用性 | 托管服务 5xx 错误将影响所有依赖功能 | 实现重试机制，关注服务状态 |
| 授权失效 | 用户撤销 OAuth 授权导致 403/404 | 提供重新授权引导流程 |
| API Key 泄露 | 单一 Key 泄露即暴露全部连接数据 | 使用 1Password 等密钥管理，避免硬编码 |
| 数据合规 | 健康数据跨境传输需符合 GDPR/ HIPAA | 评估数据驻留要求 |