用途:为调用 Grammarly API 处理文档时提供数据处理模式,主要解决大文档超出接口限制时的分块、评分聚合与流水线编排问题。API 单次最多接受 100,000 字符(4 MB),最少 30 词。
主要能力:一、文本分块,chunkText 函数按空行拆段并合并到约 90,000 字符上限内;二、跨块评分聚合,aggregateScores 对 overallScore、correctness、clarity、engagement、tone 取平均并四舍五入,返回 chunkCount;三、文件处理流水线,scoreFile 读取文件、分块、跳过不足 30 词的块后调用 grammarlyClient.score,再聚合结果。
使用方式:将上述 TS/JS 代码集成到调用 Grammarly 评分接口的服务中,逐块提交并汇总。前置条件包括:由数据负责人批准的文本分类、同意、留存与删除政策;使用全虚构文本的沙箱夹具、限定目标与可验证的清理方式;明确规定文本、建议与评分不得进入日志、指标、工单或分析,除非明确批准并最小化。
输出与错误处理:应返回处理回执,含来源分类、同意依据、目标位置、政策与转换版本、输入/接受/隔离数量、留存日期及删除或回滚引用,且不含文本、建议或标识符。对未知分类、缺少同意、不支持的目标、超限输入或删除验证失败应隔离处理;不得静默截断、转投备用提供商或在未经负责人批准下留存用于调试。
适用场景:需要批量评估长文档写作评分的数据管道。限制:具体计费、价格、平台细节与更完整的 API 参数在资料中暂未提供。