用途：按令牌实际观测到的预算与工作负载规划 ClickUp 流量，而非硬编码并发，并为共享该令牌的所有调用方保留余量。
主要能力：依据 X-RateLimit-Limit、Remaining 与 Unix Reset 头及 429 历史进行限流控制；按优先级分配预算；实现带抖动和最大重试时长的有界队列/令牌桶；遇 429 暂停至 reset，不扩散重试或换令牌绕过策略；用合成负载验证吞吐、公平性、队列时效与零丢失。
已知契约：限额按个人或 OAuth 令牌计，随 Workspace 套餐变化；公开限额为 Free Forever、Unlimited、Business 每分钟 100 次，Business Plus 1,000 次，Enterprise 10,000 次；429 响应含上述三个头，reset 为 Unix 时间戳；套餐值为上限而非目标吞吐。
使用方式：先用 Read、Glob、Grep 检查仓库、适配器、配置、测试与证据，仅用 WebFetch 查阅官方 ClickUp 文档，确认目标文件与 Workspace 边界后再用 Write 或 Edit。令牌经服务端受管密钥引用注入，放在 Authorization 中，校验授权的 Workspace ID，不打印令牌、OAuth 客户端密钥或 webhook 密钥。
适用场景：需要按套餐限额控制 ClickUp 请求并发、处理 429 重试、为交互流量保留余量的集成与自动化。
限制：不得在未获账户与服务负责人批准时升级套餐、增令牌以放大限额或挤占交互流量；头信息与假设套餐冲突时以观测到的授权头为准；reset 值异常时停止自动重试；队列超出时效 SLO 时需降低需求或走已批准的架构变更；检测到重试风暴时打开熔断并由单一调度器排空。