RTK：面向 AI 编程代理的命令输出压缩工具

工具定位

RTK 是一个用 Rust 编写的单二进制工具，目标是在 AI 编程代理读取 shell 命令输出之前，对输出进行过滤和压缩，减少进入模型上下文的 bash 输出量。原文称其支持 100 多个命令，单命令开销低于 10ms。

工作方式

RTK 拦截 shell 命令，把输出替换为紧凑版本，再交给代理。原文给出的处理策略有四类：智能过滤（去掉注释、空白、样板内容）、分组（按目录聚合文件、按类型聚合错误）、截断（保留相关上下文、裁掉冗余）、去重（把重复日志行折叠为带计数的行）。

按命令举例：

• ls / tree：改用树形格式并附带文件计数；
• cat / read：优先给出签名和结构，而非完整正文；
• grep / rg：截断长行，按文件分组；
• git status / git diff / git log：紧凑统计、精简上下文、只保留哈希、作者和标题；
• cargo test、npm test、pytest、go test：只保留失败项，通过项折叠为计数；
• docker ps：只保留关键字段。

安装与初始化

原文给出的安装方式为 Homebrew、winget 和安装脚本。安装后需确认包正确：存在另一个同名 "rtk" 项目，可用 rtk --version 和 rtk gain 检查。随后用 rtk init 按目标工具初始化，例如 Claude Code / Copilot、Gemini CLI、Codex、Cursor、Windsurf、Cline 等，原文称支持 18 种 AI 编程工具。

需要注意：hook 只在 Bash 工具调用时触发，内置的 Read、Grep、Glob 工具不经过它，需改用 shell 命令或直接调用 rtk read 等子命令。

版本与许可

RTK 有三个下载项，两个 rtk 版本安装同名二进制，不能同时安装：完整版（Apache-2.0 + BUSL-1.1，含 hook、过滤器与压缩引擎）、rtk-oss（仅 Apache-2.0，无引擎）、rtk-proxy（BUSL-1.1，独立守护进程，用于压缩代理 API 流量）。原文称生产使用免费，但不允许把 RTK 或其衍生品作为商业产品或服务提供给第三方。

节省口径的边界

原文强调 RTK 减少的是代理读取的 bash 输出，不等同于账单按同比例下降：bash 输出只是输入 token 的一部分，输入 token 又只是总账单的一部分。报告中的 token 数按 bytes / 4 估算，原文称 RTK 不含分词器，因此百分比可靠而绝对 token 数只是近似值。