用途：为 Grammarly 支持工单和故障排查收集诊断证据，将 API 连接状态、文本分析响应质量、认证状态和速率限制使用情况汇总为一个诊断归档包。适用于遇到持续性问题、准备提交支持工单或需要收集证据的场景。
主要能力：脚本会检查环境变量（如 GRAMMARLY_API_KEY、GRAMMARLY_CLIENT_ID 是否设置），通过 curl 向 https://api.grammarly.com/v1/check 发送带 Authorization: Bearer ${GRAMMARLY_API_KEY} 的 POST 请求探测 API 状态码，保存完整文本检查响应到 text-check.json，并请求 account 接口保存账户信息与速率限制头到 rate-headers.txt，最后打包为 debug-grammarly-时间戳.tar.gz。分析阶段用 tar 解包，通过 cat、jq '.alerts | length'、grep -i "ratelimit|retry" 等命令查看认证与 API 状态、建议数量、建议详情和限流信息。
常见问题对照：HTTP 401 需刷新 OAuth 令牌或重新生成 API 密钥；零建议需检查文本是否超过最少字数（30 词）及语言参数；高延迟（>5s）可减小文本负载或排查网络代理；429 限流可根据 Retry-After 实现请求排队并降低检查频率；Client ID 不匹配需核对 Developer Hub 注册信息。
前提与限制：需要事件 ID、有界收集窗口、经批准的受限目标和用于诊断的合成输入；必须有脱敏规则，在证据离开运行环境前移除文本、建议、令牌、请求头、账户数据和标识符。只应收集状态码、延迟区间、配额头、配置版本和合成探测的不透明关联 ID。脱敏检查未通过、目标未知或命令可能泄露生产密钥时必须停止收集。输出需生成包含事件 ID、收集窗口、执行检查、关联 ID、聚合指标、配置版本、目标、负责人和保留日期的清单，禁止包含源文本与凭据。