RTK (Rust Token Killer) 工具使用指南

工具简介

rtk-token-saver（RTK） 是一款轻量化 CLI 输出过滤工具，核心作用是过滤、压缩命令行冗余输出内容，大幅降低大模型（LLM）上下文 Token 消耗，适配 Claude Code 等AI编程工具使用场景，完美解决命令输出冗余导致的 Token 浪费问题。

工具基础信息

• 工具全称：RTK (Rust Token Killer)

• 安装路径 ：~/.headroom/bin/rtk.exe

• 环境要求：需将工具路径加入系统 PATH，可全局调用

• 工具类型：CLI 代理过滤工具

核心功能

作为前置 CLI 代理工具，可在命令输出内容传入 LLM 上下文之前，完成全自动过滤与压缩，精准清理无效内容、规整有效信息。

核心优势

• 极致省Token：常规场景减少 60%-90% Token 消耗，测试场景最高可节省 90%-99%，大幅降低使用成本

• 智能过滤冗余：自动清理进度条、边框符号、重复空行、无效日志等无意义输出内容

• 智能规整信息：按照文件、错误规则对报错、日志信息分类分组，内容更清晰，便于AI解析

• 全场景适配：原生支持主流开发工具与命令，兼容性极强

支持主流工具

全面覆盖日常开发高频 CLI 工具，包含但不限于：

• 版本控制：git

• Rust 开发：cargo

• 前端开发：tsc、lint、prettier、vitest、playwright

• 容器运维：docker、kubectl

高频常用命令

所有原生 CLI 命令，仅需前置 rtk 前缀即可启用过滤压缩功能，常用场景命令如下：

1. Rust 项目开发

rtk cargo build
rtk cargo check
rtk cargo clippy
rtk cargo test

2. 前端项目校验

rtk tsc
rtk lint
rtk prettier

3. 前端测试运行

rtk vitest
rtk playwright

4. Git 版本操作

rtk git status
rtk git diff
rtk git log

5. Docker 容器操作

rtk docker ps
rtk docker logs

使用效果与协同方案

RTK 可与 Headroom 工具形成双重压缩联动：

• RTK：负责前置过滤，清理 CLI 输出冗余垃圾内容

• Headroom：负责后置全局上下文压缩

双重机制叠加，最大化节省 LLM 上下文 Token，大幅提升 AI 编程响应速度、降低使用成本。

使用场景说明

针对 Claude Code 等AI编程工具使用场景，原生命令执行会产生大量冗余日志、进度输出，造成严重的 Token 浪费。

最佳实践 ：执行所有构建、测试、代码检查、Git、容器运维类 CLI 命令时，统一添加 rtk 前缀，全程无感使用，自动实现 Token 极致优化。

测试结果：

• ✅ rtk-tsc 函数正常工作
• ✅ TypeScript 编译通过（无错误）
• ✅ 命令被 RTK 跟踪

使用方法：

cd /e/tfbank/uatu

rtk-tsc # 运行 TypeScript 检查

rtk-tsc --watch # 监视模式

rtk-tsc --strict # 严格模式检查

查看 RTK 统计：

rtk gain # 查看总节省

rtk gain --history # 查看历史记录

补充说明

工具部署完成后会自动生成记忆文件，终端输出Memory file created successfully 即代表 RTK 记忆文件创建成功，工具可正常生效运行。

（注：部分内容可能由 AI 生成）