用途:为 Lucid 相关接口设计按端点区分的请求节奏、429 处理、背压与安全重试策略,适用于加固 REST 或连接器流量。
主要能力:把限流视为端点/API 专属且随时间变化,不采用整套固定每分钟请求数;区分读/写操作、调用方、主体与并发;在重试前使用有界队列、按操作并发、抖动与背压;仅重试有文档说明的瞬时失败,写操作需幂等或对账后才可重放;遵循服务端 Retry-After 等指引,否则采用保守上限退避;测试合成 429、响应前超时、部分批次、队列饱和、取消与恢复。
使用方式:用 Read、Glob、Grep 检查客户端与测试,用 WebFetch 获取当前端点/限流文档,仅用 Write 或 Edit 修改本地策略、代码、测试与记录。先枚举每个操作的方法、读写效果、调用方、主体、并发与重试安全性,再重新获取该操作的限流文档,只记录明确公布的值。对请求、成功/错误数、延迟、队列年龄及服务端限流/重试元数据做埋点。生产并发或重放策略变更需审批并以受监控金丝雀发布。
限制:限流不构成凭据池化或扩大权限的理由,需按已批准主体与租户划分流量,令牌不得进入指标与日志。未文档化的限流应标记为未知并设计自适应背压,不得编造数值;写操作超时含义不明时须先对账再重试;持续 429 应停止加压、安全排空并升级。输出包括操作矩阵、已文档化/未知限流、观测证据、队列/重试策略、测试、审批、金丝雀结果与剩余风险。