token-budget-estimator 是做什么的？
适用于 Codex 的预检代理 Token 预算估算技能与 CLI 工具。
概述
token-budget-estimator 能够帮助您在 AI 代理（如 Codex）启动任务之前，预先估算所需的 token 预算。这对于资源规划、成本控制和防止超出 API 限制非常有用。
功能
- 预检预算估算：在代理任务执行前提供 token 消耗预测。
- CLI 支持：提供命令行界面，方便集成到自动化流程中。
- 文件扫描：自动扫描项目目录，分析文件类型和数量。
- 可配置参数：支持设置 token 模型参数以适应不同的计费模型。
使用方法
作为 Codex 技能
在 Codex 的 SKILL.md 中引用此技能，或通过以下命令安装：
codex install skill YUK1207/token-budget-estimator
作为 CLI 工具
直接在终端中运行：
token-budget-estimator --path ./your-project
这将输出预算估算结果，例如：
项目路径: ./your-project
预估 Token 总数: 125,000
预估费用: $0.005
配置
您可以通过环境变量或配置文件自定义估算参数：
| 环境变量 | 说明 | 默认值 |
|---|---|---|
MODEL_COST_PER_TOKEN | 每 token 的成本 | 0.00000004 |
MAX_BUDGET_TOKENS | 最大预算 token 数 | 1000000 |
工作原理
- 扫描指定的项目目录。
- 统计所有代码文件（按扩展名分类）。
- 根据文件大小和平均 token 密度估算 token 数。
- 结合 API 定价模型计算预估费用。
- 输出结构化报告。
支持平台
- Codex
- 任何支持 CLI 的环境（如 CI/CD 流水线）
许可证
MIT