用途:将 Codex 与 Gemini 的每周额度使用情况操作化,不只给静态建议,而是刷新配额快照并生成每周利用率记分卡,便于持续监控与分派工作。
主要能力:读取配额快照 config/ai-tools/agent-quota-latest.json、配额历史 ~/.agent-usage/weekly-log.jsonl、提供方活动日志 logs/orchestrator/{Codex,codex,hermes,gemini}/session_*.jsonl、会话审计 analysis/provider-session-ecosystem-audit.json,输出人类可读报告 docs/reports/provider-utilization-weekly.md 与 config/ai-tools/provider-utilization-weekly.json。优先使用真实周配额数据判断利用率;配额遥测缺失或仅为估算时,回退到活动相对近期峰值的方式。建议每 4 小时刷新一次。
使用方式:刷新配额与利用率产物:bash scripts/cron/provider-utilization-refresh.sh;查看仪表盘:uv run --no-project python scripts/ai/credit-utilization-tracker.py --dashboard;重装 cron:bash scripts/cron/setup-cron.sh --replace,并用 crontab -l | grep provider-utilization-refresh 检查;运行测试:uv run pytest tests/analysis/test_credit_utilization_tracker.py tests/cron/test_provider_utilization_refresh.py 与 uv run --no-project python scripts/cron/validate-schedule.py。刷新配额快照可先用 scripts/ai/assessment/query-quota.sh --refresh --log。
适用场景与规则:utilization_basis=quota 最强,可用于路由决策;activity_vs_recent_peak 只作方向性参考。Hermes 视为编排信号,不是付费提供方利用率目标。Codex 周配额可能不可用,不可用时应明确报告活动回退,不要用 pct_remaining 计算假用量;Gemini 当前遥测可能仅今日消息数与每日上限且来源为估算,数值较弱,应优先活动回退并标注局限。
限制与注意事项:会话日志缺少运行时 session_id 时,不要用 provider:file:tool:ts 之类逐条键统计,应回退到 session_YYYYMMDD.jsonl 文件身份,否则会严重高估会话数。合并快照时不要把缺失的数值配额字段当作零,否则可能误推 100% 利用率。日上限类提供方不能按周前加载计算。包生命周期需经 GitHub issue、计划、对抗式评审、用户批准、status:plan-approved 后才可分派实现。其余未提供信息暂未说明。