用途：为 Grammarly API 集成提供生产级实现模式，适用于 TypeScript 与 Python 项目，包括新建集成与重构现有 SDK 用法。
主要能力：类型化 API 客户端封装；基于 client_credentials 的 OAuth 令牌获取与过期前自动刷新；大文档文本分块（按段落切分，默认上限 90000 字符）；评分接口（/v2/scores）与 AI 检测接口（/v1/ai-detection）调用；Python 客户端示例（requests + dotenv）。
使用方式：客户端基址为 https://api.grammarly.com/ecosystem/api，先向 /v1/oauth/token 以 client_credentials 换取 access_token，再以 Bearer 令牌调用评分或 AI 检测接口。Python 侧通过环境变量 GRAMMARLY_CLIENT_ID、GRAMMARLY_CLIENT_SECRET 读取凭据。
前置条件：类型化客户端边界、由密钥管理器提供配置、目标地址允许列表，以及仅含虚构文本的测试夹具；需明确文本保留与遥测规则，未知授权或响应结构应失败关闭。
输出：生成客户端契约回执，包含 SDK 版本、环境、schema 版本、夹具结果、错误分类、脱敏遥测字段与回滚行为；不得记录输入文本、建议、凭据或用户标识。
错误处理：分别归类畸形响应、授权失败、配额响应与超时；无幂等键不得重试写操作，不得回退到更宽泛的令牌，也不得为诊断失败而记录被拒文本。
限制：资料未提供具体配额数值、价格、支持平台范围及完整接口清单，相关细节暂未提供。