这个项目能做什么

TraceFrugal 是一个本地、单二进制的 Go 应用程序,旨在帮助开发者理解和优化 AI 编码工作流程中的令牌使用,特别针对 Claude Code 和 Codex。它提供了一个统一的仪表板,可视化工作流程消耗大量输入的原因,突出显示了大型工具结果、重复调用和上下文重用等问题。该工具允许用户尝试更小的上下文规则,跟踪每小时可见性,并测量答案满意度,如果更改没有产生预期结果,则可以撤销更改。 主要功能包括一个可选的 MCP 代理,用于存档大型只读结果并提供精确召回,在 24 小时后停止数据打包以保持效率。TraceFrugal 去重复制的响应,并显示过去七天的使用数据,每 30 秒刷新一次。它明确区分了用于 Claude Code 和 Codex 的本地日志导入,以及用于 API 应用程序开发者的 JSONL 跟踪工作流程。该工具包括一个成本/成功回归门控,以及自动评估器驱动的实验,以确保优化不会损害任务质量。 该应用程序注重隐私,不需要 API 密钥、遥测或运行时依赖。它强调诚实的边界,指出美元金额是基于标价的估计,并且如果丢失了缓存重用或任务质量下降,较低的令牌数量并不自动意味着节省。TraceFrugal 支持通过适配器使用各种提供商,并允许用户以 JSONL 格式导入自己的使用数据,确保提示和凭据保持本地。它适用于 CI 管道,可以在其中比较基线和候选运行,以检测成本或结果回归。