WillQoder

Qoder 会话积分自控与刹车。

限定本次对话的积分消耗上限，agent 在执行过程中主动监控，接近上限时预警并停止。

工作原理

用户设定预算 → agent 工作中 → 每步后检查日志 → 80% 预警 → 98% 刹车

从 Qoder 会话日志 (.jsonl) 中读取真实的 message.usage.credits，按 message.id 去重，不含估算。

安装

1. 克隆仓库

git clone https://github.com/zukunftsholz/willqoder.git
# 记住克隆到的路径，后面要用

2. 安装 Skill

将 skill/ 目录复制到 Qoder 的 skills 目录：

# Windows (Git Bash)
cp -r skill/ ~/.qoder/skills/willqoder/

# macOS / Linux
cp -r skill/ ~/.qoder/skills/willqoder/

3. 配置脚本路径

编辑 ~/.qoder/skills/willqoder/SKILL.md，将 <WILLQODER_PATH> 替换为 qoder-credits.py 的实际绝对路径：

# 找到这行：
python "<WILLQODER_PATH>/qoder-credits.py" status --budget <用户设定的预算>

# 替换为（示例）：
python "/home/user/willqoder/qoder-credits.py" status --budget <用户设定的预算>

使用

在 Qoder 对话中输入 /willqoder 或提到「积分限制」「预算控制」即可触发。

Agent 会询问本次对话的积分上限，然后在工作中自动监控。

单独使用 CLI

不装 Skill 也可以直接用命令行查看积分：

# 查看当前会话积分消耗
python qoder-credits.py status

# 设定预算 50 积分
python qoder-credits.py status --budget 50

# 指定项目和会话
python qoder-credits.py status --project ~/.qoder/projects/C--my-project --budget 30

输出示例：

{
  "timestamp": "2026-09-17T05:30:00+00:00",
  "session_id": "abc123...",
  "credits_used": 3.034,
  "extra_billed_credits": 0.0,
  "total_requests": 54,
  "alert_level": 0,
  "credits_per_minute": 0.316,
  "credits_per_request": 0.056,
  "budget": 10.0,
  "budget_remaining": 6.966,
  "budget_usage_pct": 30.3,
  "warning_threshold": 8.0,
  "stop_threshold": 9.8
}

输出字段

字段	说明
credits_used	本次会话实际消耗积分
extra_billed_credits	额外计费积分（订阅计划外）
total_requests	有积分记录的请求数
alert_level	0=正常, 1=预警(≥80%), 2=停止(≥98%)
credits_per_minute	消耗速率
credits_per_request	每次请求平均消耗
budget_remaining	剩余预算
budget_usage_pct	已用百分比

要求

• Python 3.10+
• Qoder 会话日志（~/.qoder/projects/ 下的 .jsonl 文件）

License

MIT