LoopX 配额分配机制详解：should-run与spend-slot如何防止Token烧钱

LoopX 配额分配机制详解should-run与spend-slot如何防止Token烧钱【免费下载链接】loopxLong-horizon agent control plane for durable, governed work across Codex, Claude Code, and other harnesses.项目地址: https://gitcode.com/GitHub_Trending/lo/loopxLoopX 是一个面向 Codex、Claude Code 等 Agent 运行时的长程控制平面control plane它的配额分配机制quota allocation通过should-run前置守卫与spend-slot后置记账两道关卡帮新手和普通用户精确控制每个目标每天能烧多少 Agent 计算时间从根本上防止 Token 悄悄烧钱。为什么 AI Agent 会半夜烧钱让 Codex 或 Claude Code 挂着定时任务连续跑几个小时是很多用户的日常跑实验、爬数据、重构代码。问题在于——定时器只负责叫醒 Agent谁来决定叫醒之后该不该干正事如果每个小时的心跳都无脑执行一个完整回合一个0.5档的目标可能在一夜之间消耗远超预期的 Token。LoopX 的思路很直接把优先级和预算写进产品策略而不是靠改 cron 周期来隐式表达优先级。每个目标Goal配一个计算配额数字自动化在花费任何计算前先问 LoopX。计算配额给每个目标一个占空比在 LoopX 中配额指的是计算配额——它回答一个问题在可用的自动 Agent 时间里这个目标被允许消耗多少配额数字可以直接理解为占空比duty cycle配额值含义默认分钟槽位24h 窗口1.0全占空比每个健康检查点都参与1440 个槽位0.5半占空比约每天 12 小时720 个槽位0.330% 占空比约每天 7.2 小时432 个槽位0计算暂停目标可见但不再获得任何自动回合0记账单位是分钟槽位minute-slot默认slot_minutes1一个槽位代表一分钟自动计算预算。缺省allowed_slots window_hours × 60 / slot_minutes × compute所以一般只需设一个compute数字。特别注意0和单个 Agent 的monitor_only模式的区别quota.compute0暂停的是整个目标所有 Agent、所有车道而monitor_only只是把某个 Agent 限制为有界的只读轮询。用loopx configure-goal --quota-compute 0即可一键急停负值会被拒绝。should-run每次自动回合前的红绿灯quota should-run是心跳任务的目标级守卫。自动化拿到该干活了的调度提示后在真正花费计算前必须立即执行loopx --format json quota should-run --goal-id goal-id --runtime-profile codex_app_heartbeat它会返回一份紧凑的机器可读决策核心字段包括should_runtrue/false 的最终裁决stateeligible、throttled、waiting、operator_gate、focus_wait、paused、blocked_health七种产品状态之一reason人类可读的拦截原因scheduler_hint跨运行时的等待策略比如等待用户时按[30, 60]分钟渐进退避interaction_contract告诉执行器这一轮是交付、提问、观察还是静默关键行为只有eligible以及少数受限的安全旁路/自修复场景才返回should_runtrue。被门禁、等待证据、已节流、已暂停或健康阻塞的目标一律返回 false执行器按报告的原因跳过不产生任何 Token 消耗。配额在五层门禁中的位置是明确的——它排在健康门禁、操作员门禁、证据等待、焦点等待之后只在其他条件都满足的目标之间分配下一个自动回合。配额不是第二套权限系统而是调度器。spend-slot完成并验证后才记账一分钟quota spend-slot是记账助手。默认是dry-run只展示消费槽位前后的 should-run 决策对比不写任何东西加--execute才追加一条紧凑的quota_slot_spent运行时事件loopx quota spend-slot --goal-id goal-id --slots 1 --execute标准回合的记账协议非常克制花费前调用quota should-run确认should_runtrue执行有界的自动回合完成验证与状态写回用带delivery_outcome的refresh-state记录因果交付验证成功后追加恰好一条spend-slot --execute静默跳过、预检失败、纯 dry-run 预览、重复记账一律不消耗配额。事件里带有before/after对照例如从719/720槽位、eligible变为720/720、throttled——预算用尽后目标自动进入限流状态下一个心跳会被守卫拦下直到滚动窗口释放槽位。公开示例见examples/quota-slot-spend-event.example.json其中after.statethrottled、after.should_runfalse就是钱烧完了自动刹车的完整投影。防烧钱的实战清单给刚开始跑长程任务的用户的 5 条建议新目标先降档连接后先设--compute 0.5试跑一晚确认节奏合理再升到1.0急停用 0别删任务loopx configure-goal --quota-compute 0是 Goal 级硬暂停目标保持可见但不消耗任何自动回合等待中不烧钱轮询外部证据无变化时用loopx quota monitor-poll记录无消耗的存活检查不变化的监视轮询自动no-spend让调度退避跟着守卫走scheduler_hint会在等待用户时把 Codex App 心跳从 30 分钟退避到 60 分钟而不是继续高频空转多目标看quota plan共享控制器按compute从高到低给eligible目标排序直接拿到next_automatic_turn不用逐个翻聊天线程深入阅读与相关模块配额完整设计文档docs/quota-allocation.md状态机、门禁顺序、槽位事件契约的权威出处配额核心实现loopx/quota.pyquota_status、build_quota_plan、spend_quota_slot等入口守卫与记账的细粒度模块loopx/control_plane/quota/should_run.py、loopx/control_plane/quota/slot_accounting.py、loopx/control_plane/quota/spend_commit.pyCLI 命令注册loopx/cli_commands/quota.py仪表盘配额投影apps/presentation/dashboard/理解了 should-run 的前置拦截与 spend-slot 的后置记账你就掌握了 LoopX 控制 Token 成本的核心每一分钟槽位都必须在绿灯下启动、在验证后落账其余一切静默都不花钱。【免费下载链接】loopxLong-horizon agent control plane for durable, governed work across Codex, Claude Code, and other harnesses.项目地址: https://gitcode.com/GitHub_Trending/lo/loopx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考