用途:协调所有共享同一出口 IP 的 worker,统一管理 Ramp 请求预算,避免各进程独立重试导致滚动窗口超限。适用于客户端收到 429 或 504 的场景。
主要能力:实现一个低于官方上限的共享滚动窗口限流器,为交互或恢复流量预留容量;对 429、5xx 及安全的 504 使用带完全抖动的有界指数退避,限制尝试次数与总耗时;读请求可在预算内自由重试,写请求仅在端点支持幂等键且超时后完成对账时才重试;针对 504 缩小分页或查询范围,金丝雀式调整并发。
当前契约:Ramp 默认限制为每源 IP 每滚动 10 秒 200 次请求;429 表示暂停并退避,立即重试会加剧争用;超过 60 秒的请求以 504 终止,大读取应分页并减少工作单元;Ramp 建议指数退避,实际吞吐低于理论值,端点约束仍然适用。
使用方式:先盘点共享每个源 IP 的服务、任务、租户、端点与重试层,测量到达率、突发、延迟、429/504 及业务优先级;再实现共享限流器与重试矩阵。使用 Glob 定位代码与证据,Grep 查找端点、字段、权限、错误与过时假设,Read 检查最小必要文件,Write 仅用于经批准的新草稿、测试或配置,Edit 仅用于有已知回滚的有界变更。本地文件工具不授权 Ramp 操作,也不替代负责人批准。
限制与边界:平台负责人批准预算与重试策略,业务/财务负责人批准写入重放,Ramp 必须批准任何限额提升。生产访问与业务影响需明确批准前,应使用合成夹具或 Ramp 沙箱。未解决的供应商行为、权限或财务状态应视为停止条件。官方文档与 OpenAPI schema 需在实时请求前重新核对。输出包括共享出口清单、限流器设计、重试矩阵、幂等策略、基准、金丝雀结果、仪表盘及限额提升证据。