核心用法
scalekit-auth 提供基于 Scalekit 云服务的集中式 OAuth 令牌生命周期管理。技能通过 Python SDK 与 Scalekit API 交互，实现以下能力：
1. 零本地存储：Access Token / Refresh Token 全部托管于 Scalekit 云端，本地仅保留 connection_name 映射
2. 自动刷新：SDK 内部处理 Token 过期检测与刷新，调用方始终拿到有效凭证
3. 多服务支持：覆盖 Gmail、Slack、GitHub、Notion、Salesforce 等 50+ OAuth 服务商
4. 动态授权：首次调用未授权服务时，生成 1 分钟有效期的授权链接，通过 Telegram/聊天窗口引导用户完成 OAuth 握手
使用流程：
- 在 Scalekit Dashboard 创建 Connection 并获取
connection_name - 本地配置
connections.json建立服务名到 Connection 的映射 - 代码中调用
get_token("service_name")获取 Bearer Token - 直接用于 API 请求或 Shell 脚本
显著优点
- 安全架构：Token 不落盘，避免本地配置文件泄露风险；支持
.env隔离敏感配置 - 运维极简：无需自行实现 OAuth 2.0 授权码流程、Token 刷新、错误重试逻辑
- 弹性扩展：新增服务只需 Dashboard 配置，无需代码变更
- 合规友好：Scalekit 作为第三方托管商，可协助满足 SOC2/GDPR 等审计要求
潜在局限
- 外部依赖：服务可用性完全依赖 Scalekit 平台，单点故障风险
- 网络延迟：每次
get_token需发起 HTTPS 请求，高频场景存在额外 RTT（官方 Roadmap 提及未来支持本地缓存） - 成本不透明：Scalekit 为商业 SaaS，超出免费额度后按连接数/请求量计费，需关注账单
- 锁定风险：Connection 配置与授权状态存储于 Scalekit，迁移需重新授权
适合人群
- 快速搭建需集成多 SaaS 服务的 AI Agent（邮件读取、Slack 通知、GitHub 操作等）
- 对 Token 安全有较高要求、不愿自行维护加密存储与刷新逻辑的开发者
- 团队已使用或愿意采用 Scalekit 作为身份基础设施的场景
常规风险
- 凭证泄露：
SCALEKIT_CLIENT_SECRET若提交至 Git 仓库，可能导致账户被盗用 - 授权链接拦截：1 分钟有效期的授权链接若被中间人截获，存在账户接管可能（需配合 HTTPS 与可信通道）
- Scope 过度授权：Dashboard 配置时若授予过大权限，Token 泄露后影响面扩大
- 服务终止：Scalekit 作为初创公司，长期存续性需纳入风险评估