文档
TokenEconomizer 是 Claude Code、Codex、GitHub Copilot CLI 与 Pi 的插件，并对 opencode 提供实验性支持。下面按「日常使用」与「深入参考」分成十节，涵盖从安装、调参到架构原理与论文复现的全部细节。
插件会用一行字播报每一次动作；如果其中任何环节失败，你的会话会照常继续，就像没装这个插件一样。它的模型调用（提出事实的模型，以及写出重定向的裁判模型）经由你自己的智能体运行，使用同一个套餐或登录身份，其成本也被计入它的报告。它学到的东西留在你的机器上，位于 ~/.tokeneconomizer。
使用快速开始
五种智能体的安装、检查、更新、卸载、BYOK 配置，以及支持的版本范围。
使用日常命令全部 15 条命令详解：status、microskills、toolprune、config、repomap、repos 与 doctor。
使用设置九项核心设置、三档循环守卫预设阈值表、第四机制仓库地图（repomap）、rtk 协同与环境变量。
使用各智能体上的行为工具剪枝在每种智能体上排除什么、写到哪里，模型调用如何计费，以及卡住时如何停下。
使用故障排查与诊断te doctor 自检、te probe 真机探测、errors.log 常见报错修复，以及高频问题解答。
深入与参考架构与接口设计四大标准库抽象接口、六个生命周期钩子逐一拆解，以及插件与论文实验设置的 8 项对照。
深入与参考插件验证与状态隐私各智能体实测验证记录、Prompt Caching 保护机制、提示级 vs 会话级消融、仓库识别与隐私边界。
深入与参考复现论文实验SWE-Bench 与 Web-Bench 完整复现指南：Docker 镜像、5 步配置、实验组对照表与汇总对比脚本。
深入与参考仓库结构包的九个核心目录、离线测试与自包含插件构建方式。
深入与参考引用与许可论文 BibTeX 条目、三家署名研究机构与 Apache 2.0 许可证。
第一次读。 先按「快速开始」装好并在仓库里跑一次
status；之后日常基本只需要「日常命令」里的前几条。想了解底层钩子如何保护缓存、或者想在本地复现 SWE-Bench 实验，可进一步阅读「架构与接口设计」和「复现论文实验」。