用途:为受速率或成本限制的外部服务提供统一的配额跟踪与执行基础设施,跟踪累计 token 预算并强制限制。若只需按调用记录日志,应使用 usage-logging。
主要能力:采用三级阈值管理——健康(低于 80%,正常执行)、警告(80%–95%,告警并考虑批处理)、严重(高于 95%,推迟非紧急任务或改用备用服务)。配额类型包括每分钟请求数、每日请求数、每分钟 token 数、每日 token 数。
使用方式:从 leyline.quota_tracker 导入 QuotaTracker,初始化时指定服务名,调用 get_quota_status() 获取状态与警告;用 record_request(tokens=..., success=..., duration=...) 记录用量;执行前用 can_handle_task(estimated_tokens) 判断能否继续。其他插件可在 frontmatter 中声明 dependencies: [leyline:quota-management] 复用共享模式:初始化跟踪器、操作前检查配额、操作后记录用量、优雅处理阈值警告。
适用场景:构建限流 API 集成、需跨会话跟踪用量、希望在接近限制时优雅降级、操作前需要成本估算。
限制:不适用于未使用 leyline 基础设施模式的项目,也不适合无需服务架构的简单脚本。阈值策略与估算模式详见 modules/threshold-strategies.md 和 modules/estimation-patterns.md。退出标准:操作前检查配额状态、操作后记录用量、妥善处理阈值警告。