DEV Community

韩

Posted on

Token-Savior 的 5 个隐藏用法:一个让 AI 编码成本降低 80% 的 MCP Server

你知道吗?GitHub 上有一个 971 Stars 的 MCP Server,能让 Claude Code 的 Token 消耗降低 80%,同时把代码完成率从 78.3% 提升到 97.9%。这不是理论数据——这是 96 个真实编码任务、Claude Opus 4.7 跑出来的实测结果。

但问题是:大多数开发者安装完 Token-Savior 之后,只用默认配置,根本没解锁它真正的能力。这个工具从安装到跑出 benchmark 成绩,全程不到 90 秒。

2026 年的 MCP 生态已经全面爆发,但大多数团队只把 MCP 当作"暴露工具"的协议——没有人意识到,MCP Server 其实也可以用来降低工具运行的成本。Token-Savior 彻底改变了这个局面。


隐藏用法 #1:设置一个环境变量,在 tsbench 上跑出 97.9% 得分

大多数人的用法: 安装 Token-Savior 后保持默认配置,默认配置够用,但无法解锁 benchmark 级别的性能。

隐藏技巧: 在第一次启动 Claude Code 之前,设置一个环境变量:

export TS_PROFILE=optimized
Enter fullscreen mode Exit fullscreen mode

就这样。一个环境变量。optimized 配置文件是维护者在 96 任务 tsbench 基准测试中使用的配置——它跳过了读端捕获沙箱(TS_CAPTURE_DISABLED=1),每次工具调用都会产生这个开销;同时激活完整的 compactor 注册表(34 个 compactors,覆盖 pytest、git、grep、find、cat、gh、kubectl、eslint 等)。

效果: 来自 tsbench README,96 个真实编码任务上的表现(Claude Opus 4.7,2026 年 5 月):

指标 原始 Claude Code TS_PROFILE=optimized
得分 141/180 (78.3%) 188/192 (97.9%)
单任务活跃 Token 17,221 3,395
单任务耗时 110.6 秒 18.9 秒

复现方法:

git clone https://github.com/Mibayy/tsbench && cd tsbench
python3 generate.py --seed 42
git tag v1
python3 breaking_changes.py
git tag v2
TS_PROFILE=tiny_plus TS_CAPTURE_DISABLED=1 python3 bench.py --tasks all --run B
Enter fullscreen mode Exit fullscreen mode

数据来源: Token-Savior GitHub 971 Stars;tsbench 基准测试源码(https://github.com/Mibayy/tsbench)——2026 年 5 月验证。

隐藏用法 #2:Bash 输出压缩器,每周节省 20.4K Token

大多数人的用法: 让 Claude Code 输出原始的 Bash 结果——grep -r 返回 500 行,git status 打印完整 diff,find . 列出每个文件名不过滤。

隐藏技巧: Token-Savior 的 34 个 Bash 压缩器(compactors)会自动检测并压缩常见命令的输出,然后才送进 LLM 的上下文窗口。optimized 配置文件在每个 PreToolUse 事件(重写命令)和 PostToolUse 事件(压缩输出)上运行它们。

举例:一个 grep -rn "TODO" --include="*.py" 返回 300 行,被压缩成 5 行摘要——文件数、每个文件命中数、剥离公共前缀。一个 10KB 的 git diff 输出被压缩为变更行数和文件列表。

从 v4.3.0 发布说明看,7 天真实转录(1,130 条 Bash 输出)的节省:

  • 19.3% 匹配率(每 5 条命令中有 1 条有已知 compactor)
  • 匹配输出平均压缩比 68.9%
  • 每周节省约 20.4K Token(v4.2.0 约 12K Token/周)
# compactor 注册表 —— 就是一个 (command, output_pattern) → compaction_fn 的字典
# 来源:src/token_savior/compactors/
COMPACTORS = {
    "grep": {
        "pattern": r"grep -[rHn] (.+) --include=(.+)",
        "compact": compact_grep_output,  # 按文件分组命中,剥离公共前缀
    },
    "git": {
        "checkout": compact_git_checkout,
        "fetch": compact_git_fetch,
        "branch": compact_git_branch,
        "worktree list": compact_git_worktree_list,
        "stash list": compact_git_stash_list,
        "status": compact_git_status,
        "diff": compact_git_diff,
        "pr diff": compact_git_pr_diff,
        "pr view": compact_git_pr_view,
        "issue view": compact_git_issue_view,
        "repo view": compact_git_repo_view,
    },
    "find": compact_find_output,    # 按目录分组,截断头部/尾部
    "cat": compact_cat_output,     # 剥离大二进制,截断至 50 行
    "pytest": compact_pytest_output,  # 匹配 python3 -m pytest, uv run pytest 等
    "jest": compact_jest_output,
    "vitest": compact_vitest_output,
    "eslint": compact_eslint_output,
    "biome": compact_biome_output,
    "kubectl get": compact_kubectl_get,
}
Enter fullscreen mode Exit fullscreen mode

效果: 一个小时的 Claude Code 编程通常产生约 3-5K Token 的 Bash 输出。开启压缩器后,这降低到约 1-1.5K Token——LLM 仍然能看到做决策所需的语义内容。

数据来源: Token-Savior v4.3.0 发布说明(https://github.com/Mibayy/token-savior/releases/tag/v4.3.0)——7 天测试,1,130 条 Bash 输出,19.3% 匹配率,68.9% 平均压缩比,每周约 20.4K Token 节省。

隐藏用法 #3:ts discover — 找出哪些命令在消耗你的上下文预算

大多数人的用法: 连续几周使用 Claude Code,却不知道哪些 Bash 命令是最大的 Token 黑洞。没有内置视图显示"这个 git diff 命令花了你 8,000 Token"。

隐藏技巧: ts discover 命令扫描 Claude Code 的转录历史(~/.claude/projects/*/*.jsonl),识别哪些命令有已知的 compactor,哪些没有。未匹配的命令就是优化机会。

# 安装 ts CLI(非 MCP 代理用,如 Cursor、Aider、Continue)
pip install "token-savior-recall[cli]"

# 对转录历史运行 discover
ts discover ~/.claude/projects/my-project/*.jsonl

# 输出示例:
# 7天窗口内的 Compactor 覆盖率:
#   grep:      127 调用,94% 平均压缩率,✓ 已匹配
#   pytest:    43 调用,89% 平均压缩率,✓ 已匹配
#   git diff:  28 调用,76% 平均压缩率,✓ 已匹配
#   kubectl:   12 调用,91% 平均压缩率,✓ 已匹配
#   cargo:    0 调用,  --             ,✗ 无 COMPACTOR
#   webpack:  0 调用,  --             ,✗ 无 COMPACTOR
#   [未匹配] find: 34 调用,平均输出 4.2KB,考虑加入注册表
Enter fullscreen mode Exit fullscreen mode

仓库中的 bench_compactors_unmatched.py 脚本将未匹配命令分组,这样下一个 compactor 的目标就清晰可见。如果 find 是最大的未匹配命令,维护者就有了明确的添加信号。

效果: 跨 Claude Code 历史运行 ts discover 的团队一致发现:前 3 个未匹配命令占 Bash 输出 Token 消耗的 40-60%。为 find(输出完整目录树)添加单个 compactor 即可节省每日总 Token 消耗的 10-20%。

数据来源: Token-Savior README——ts discover + scripts/bench_compactors_unmatched.py 脚本文档;确认兼容 Claude Code 转录 JSONL 格式。


隐藏用法 #4:结构化代码导航——无需完整文件即可获取代码上下文

大多数人的用法: 让 Claude Code 读取整个 500 行文件,只为了找到 my_function 的定义。Claude 读完整个文件,在不需要的代码上花费 Token,经常迷失在相关部分在哪里开始。

隐藏技巧: Token-Savior 的结构化代码导航工具(ts getts search)只提取符号、函数签名和调用图关系——而不是完整的文件体。当 Claude 需要理解 my_function 时,它得到:

{
  "symbol": "my_function",
  "file": "src/utils/auth.py",
  "signature": "def my_function(user_id: str, token: str) -> AuthResult",
  "callees": ["verify_token", "hash_password", "create_session"],
  "callers": ["login_handler", "refresh_handler"],
  "imported_by": ["routes.py", "middleware.py"]
}
Enter fullscreen mode Exit fullscreen mode

不是 500 行实现细节。只是结构指纹。

效果: 在 tsbench 基准测试上,结构化导航通过跟踪哪些函数引用哪些其他函数来减少上下文开销——所以 Claude 永远不会在没有了解为什么相关的情况下读取文件。

数据来源: Token-Savior GitHub 971 Stars;README "structural code navigation" 功能描述;tsbench 基准测试方法论(https://github.com/Mibayy/tsbench)。


隐藏用法 #5:ts init --agent cursor 钩子——为非 Claude 的 MCP 代理而设

大多数人的用法: 只在 Claude Code 中使用 Token-Savior(主要目标),并认为它不能用于 Cursor、Windsurf 或 Continue。

隐藏技巧: ts CLI 通过 shell 钩子将 Token-Savior 的 compactor 功能暴露给任何代理。--agent 标志自动生成 Bash 配置文件:

# For Cursor
ts init --agent cursor

# For Windsurf
ts init --agent windsurf

# For Aider
ts init --agent aider

# For Continue
ts init --agent continue

# 输出:添加 shell 函数到 ~/.bashrc 或 ~/.zshrc
# 将代理的 Bash 调用通过 ts compact 包装
Enter fullscreen mode Exit fullscreen mode

CLI 守护进程模式(ts daemon start)每次调用约 145ms vs 冷启动 1.5s——所以即使 CLI 开销也最小。对于没有原生 MCP 支持的代理(如 Aider),这是让 Token-Savior 的 34 个 compactor 工作的唯一方法。

效果: Cursor 用户报告,仅 Bash 输出压缩(不使用 MCP 服务器模式)就减少了 30-50% 的 Token 消耗。--agent 标志自动处理配置——无需手动设置环境变量。

数据来源: Token-Savior README "Bonus: ts CLI for non-MCP agents" 章节;确认支持 Cursor、Windsurf、Aider、Continue 和通用脚本/CI。


总结

Token-Savior 是一个将任何 AI 编码代理变成更节省成本版本的 MCP Server。以下是今天涵盖的五个隐藏用法:

  1. TS_PROFILE=optimized — 一个环境变量解锁 benchmark 级 compactor 注册表。tsbench 上 97.9% vs 基线 78.3%,Token 成本降低 80%。
  2. 34 个 Bash 压缩器 — grep、git、pytest、find、cat、gh、kubectl、eslint 等的自动输出压缩。真实工作负载每周节省约 20.4K Token。
  3. ts discover — 扫描转录历史,找出哪些命令是最大的 Token 沉没成本,哪些 compactor 你已经缺失。
  4. 结构化代码导航ts get / ts search 给出函数的调用图,而不是读取其完整实现。上下文无膨胀。
  5. ts init --agent cursor — 通过 shell 钩子将 Token-Savior 接入 Cursor、Windsurf、Aider 或 Continue。相同 compactor,任何代理。

相关文章

如果你觉得有用,以下文章你可能也会喜欢:


你有 Token-Savior 的隐藏用法想要分享吗?在评论中告诉我——我很想听听什么对你有效。

Top comments (0)