用途：帮助 HubSpot 集成在生产流量下避免耗尽门户配额或被 429 限流。核心不变量是 HubSpot 限流按门户而非按应用隔离，同一门户下所有私有应用与 OAuth 应用共享每日与每 10 秒配额。
主要能力：识别并防止六类失败模式，包括每日配额耗尽、突发限制、忽略批量接口、忽略 Retry-After、混淆两类限制、Ops Hub Enterprise 限制门槛。提供读取限流响应头、令牌桶限流、Retry-After 严格退避、批量读取封装、按优先级熔断、启动时自动探测计划层级等实现思路，并给出错误对照表与 curl/Python 诊断示例。
使用方式：需 Node.js 18+ 或 Python 3.10+、私有应用或 OAuth 令牌，可选 SDK 与 Redis 队列。每次调用需 Authorization: Bearer {token}。按步骤先实现响应头读取、令牌桶、hubspotFetch，再按需实现批量封装、配额熔断和层级探测。批量接口最多 100 个 ID 一组。
适用场景：大规模 CRM 同步、多应用共享门户、批量读写联系人和公司等对象。
限制：限流机制与配额数值取决于实际门户计划；Ops Hub Enterprise 的持续 100 请求/秒为受限功能；每日配额恢复按 UTC 午夜；资料未提供具体价格、SDK 安装命令之外的完整配置。