RedLine

⏱️ AI 用量实时监控与智能节流

实时监控 Claude/ChatGPT 用量,四层策略自动节流,避免触发 rate limit

收藏
4.9k
安装
1.1k
版本
0.2.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Redline 是一套面向 Claude.ai (Max/Pro) 和 OpenAI/ChatGPT/Codex (Plus/Pro) 用户的实时用量监控与自动节流系统。通过两条 CLI 脚本(claude-usageopenai-usage)获取官方 API 的实时用量数据,结合四色分级策略(GREEN/YELLOW/ORANGE/RED)动态调整 AI 代理的工作强度。

技术实现:

  • claude-usage:从 macOS Keychain 读取 Claude Code OAuth token,调用 Anthropic 用量 API
  • openai-usage:从 OpenClaw 认证配置读取 token,调用 OpenAI 用量 API
  • 支持 --json 输出供程序化集成

四级节流策略:

| 层级 | 剩余额度 | 行为模式 |
|------|---------|---------|
|  GREEN | >50% | 正常运营,全功能可用 |
| 🟡 YELLOW | 25-50% | 跳过子代理,推迟非紧急研究 |
| 🟠 ORANGE | 10-25% | 仅响应必要请求,禁止主动检查 |
| 🔴 RED | <10% | 仅处理关键任务,立即告警用户 |

显著优点

1. 预防性设计:在触及硬性限制前主动降级,避免服务中断
2. 双平台覆盖:同时支持 Anthropic 和 OpenAI 两大主流生态

3. 零侵入集成:通过 HEARTBEAT.md 心跳机制嵌入现有工作流,无需改造核心架构

4. 精细化数据:返回包含重置时间戳、多时间窗口利用率、额外额度等完整元数据

潜在局限

  • 平台锁定:Claude 脚本依赖 macOS Keychain,Linux/Windows 用户需手动适配
  • 认证依赖:需要预先配置 Claude Code 或 OpenClaw 的 OAuth 流程
  • 被动监控:仅读取用量而非真正拦截请求,极端并发下仍可能超限
  • 企业级缺失:无团队配额管理、无历史趋势分析、无自动扩容建议

适合人群

  • 重度 Claude Max/Pro 或 ChatGPT Plus/Pro 个人用户
  • 运行长时自动化任务(如代码审查、批量文档处理)的开发者
  • 对服务连续性敏感,不愿因 rate limit 中断工作流的效率追求者

常规风险

  • Token 泄露风险:脚本需要读取 OAuth token,需确保 Keychain/配置文件权限正确(建议 chmod 600
  • API 变更风险:官方用量 API 非公开文档化端点,存在随时变更或限流可能
  • 误节流风险:阈值设置偏保守可能导致过早降级,影响用户体验;偏激进则失去保护意义
  • 单点故障:若用量 API 暂时不可用,系统无法获取准确状态,需设计降级默认策略

RedLine 内容

手动下载zip · 4.5 kB
README.mdtext/markdown
请选择文件