SuperAPI AI 工具集

grammarly-api-reliability

写作与研究

查看项目

更新于 10-15 23:26

技能介绍

用途:这是一个只读、仅处理元数据的决策辅助技能,用于对 Grammarly 异步任务(如 Writing Score)的脱敏回执做有界、带证据标注的分类,避免把服务商响应当作盲目重试的许可。它不调用 Grammarly、不上传文本、不检查响应体、不创建令牌、不重试请求。

主要能力:把一份严格 JSON 回执转换为分类结果。COMPLETED 为终态,不重试;PENDING 不是失败,只报告仍在等待,不臆造轮询间隔、超时、SLA、配额或新鲜度保证;FAILED 且 http_status 为 429 是唯一的状态相关重试类别,若提供 retry_after_seconds 数值则原样保留为等待指令,缺失时仅引用 Grammarly 文档中针对 429 的 2 秒基数指数退避指引,不臆造上限、抖动规则、配额或服务承诺;无 429 证据的失败归为 MANUAL_REVIEW;attempts 等于 max_attempts 的失败归为 ATTEMPT_CAP_REACHED,不给重试指引;attempts 大于 max_attempts 视为无效。上限由调用方策略提供,并非 Grammarly 限制,分析器不会更改上限或执行下一次尝试。

使用方式:需要 Python 3.10+,无需凭据、网络、Grammarly 账号、文档或响应体。运行内置脚本:python3 scripts/analyze_job_receipt.py receipt.json;cat receipt.json | python3 scripts/analyze_job_receipt.py -;python3 scripts/analyze_job_receipt.py --self-test。分析器只接受 references/receipt-schema.md 中记录的元数据模式,会递归拒绝与文档内容、正文、文本、请求头或令牌相关的键,包括隐藏在未知嵌套对象中的键;未知键、格式错误的值、不一致的 429 证据以及超过上限的尝试都会失败关闭。输出 JSON 仅包含接受的状态、尝试次数、上限、分类和简短的证据有界指引字符串,不回显提交的元数据,不编造 SLA、超时、配额、结果体或文档诊断。

适用场景与限制:适合在评估或设计异步集成时,用合成回执做安全分类与重试决策辅助。禁止粘贴文档文本、原始请求或响应体、HTTP 头、访问令牌、授权值或机密。脚本仅用标准库,无网络、写文件、子进程或删除行为;遇到不安全输入会报告校验错误而非尝试清洗。无效 JSON、被禁止的递归键、未知字段、不支持的状态、矛盾的 429 证据和上限违规均为错误,脚本以非零退出且不输出分类。实时认证与请求不在本技能范围内,需参考官方 OAuth 2.0 凭据文档。