TokenEconomizer

项目简介

TokenEconomizer 是一个面向编码代理的插件，利用同一仓库中先前会话的经验减少重复浪费。它不改变代理本身，而是学习仓库事实、裁剪未使用工具，并在某一轮次看似卡住时进行干预。它支持 Claude Code、Codex、GitHub Copilot CLI 和 Pi，并对若干其他代理提供实验性支持。

核心功能

• 微技能从跨会话重复出现的失败和定期模型审阅中学习仓库特定事实，在会话开始时注入已确认事实，并在后续会话与之矛盾时丢弃。工具裁剪会在一段时间和多个会话中持续未使用某些工具后，通过各代理自身的设置将其排除，并允许恢复被移除的工具。失败循环干预使用评判模型判断轮次是否卡住，默认每轮最多添加一次重定向，而是否停止轮次由用户决定。插件通过代理已有的上下文和设置工作，按缓存定价计算成本，并在报告中计入自身的模型调用成本。它支持 Claude Code、Codex、GitHub Copilot CLI 和 Pi，并为 opencode、Cursor

适用场景

• 减少在同一仓库中进行多次编码代理会话时反复发现仓库信息和命令拼写错误。降低代理持续加载未使用工具所带来的 token 与工具定义开销。检测并重定向重复相同失败的轮次，同时保留用户停止轮次的控制权。在受支持的代理与模型组合上评估 SWE-Bench、Web-Bench 和安全审计任务中的成本降低效果。

快速开始

• 克隆 TokenEconomizer 仓库，为所选代理添加本地市场，然后安装 tokeneconomizer 插件。在仓库中启动代理，按提示信任该文件夹，并运行对应代理的状态命令以确认插件正常工作。部分宿主在安装后或代理更新后需要进行一次性的工具目录刷新。之后照常工作；插件会用一行提示说明每次操作，相关命令可显示状态、已学习事实、已裁剪工具和设置。

部署与要求

• PATH 中需有 Python 3.10 或更新版本。需在任一受支持的编码代理中登录，可使用该代理支持的任何计划或登录方式；插件不需要自己的 API 密钥，也不处理凭据。学习到的状态保存在本机的 ~/.tokeneconomizer。Cursor Agent 与 Antigravity CLI 仅支持 macOS 和 Linux；Factory Droid 在 macOS 上测试。

采用前须知

• 许可证：Apache-2.0。在使用、修改或分发项目前，请确认其具体条款。